Minecraft sunucuları genellikle Java Edition veya Bedrock Edition için ayrı ayrı çalışır. Ancak oyuncular artık iki farklı sürümden de aynı sunucuya katılmak istiyor. Bu noktada devreye GeyserMC giriyor. Geyser, Bedrock oyuncularının Java sunucularına katılmasını sağlayan açık kaynaklı bir proxy eklentisidir.

Bu rehberde, GeyserMC'nin ne olduğunu, hangi sistemlerde nasıl kurulduğunu ve nasıl yapılandırıldığını adım adım ve teknik detaylarla açıklıyoruz. Ayrıca yaygın hatalar ve çözümleriyle birlikte.

GeyserMC Nedir? Ne İşe Yarar?

Geyser bir Minecraft proxy yazılımıdır.
Bedrock oyuncularının (mobil, konsol, Windows 10) bir Java sunucusuna bağlanmasına olanak tanır.
Java sunucusuna müdahale etmeden çalışır. Yani server.jar dosyanız değişmez.

Kurulum Türleri

GeyserMC'yi şu şekillerde kurabilirsiniz:

Standalone (Bağımsız) Mod: Proxy gibi çalışır. Java sunucudan ayrı çalışır.
Plugin Modu: Spigot, PaperMC veya BungeeCord sistemlerine eklenti olarak entegre edilir.

⚙️ Sistem Gereksinimleri

Java 17+ (Geyser artık Java 17 istemektedir)
Açık 19132 UDP portu (Bedrock bağlantıları için)
Linux sunucular için screen veya tmux (Standalone kullanımda önerilir)

️ 1. Spigot/PaperMC Sunucusuna GeyserMC Plugin Kurulumu

https://geysermc.org/download adresinden Geyser-Spigot.jar dosyasını indirin.
plugins klasörüne atın
Sunucuyu başlatın. Otomatik olarak plugins/Geyser-Spigot/config.yml oluşur
Aşağıdaki ayarları kontrol edin:

bedrock:
  port: 19132
  address: 0.0.0.0
remote:
  address: 127.0.0.1
  port: 25565
  auth-type: floodgate

auth-type: floodgate kullanacaksanız Floodgate eklentisini de kurmanız gerekir (aşağıda açıklanmıştır)

2. Floodgate Nedir? Geyser ile Nasıl Kullanılır?

Floodgate, Bedrock oyuncularının premium Java hesabı olmadan sunucuya giriş yapmasını sağlar.

https://geysermc.org/download adresinden Floodgate.jar dosyasını da indirin
plugins klasörüne atın
Geyser config.yml içindeki auth-type ayarını floodgate yapın
Floodgate config.yml içinde UUID ve name seçeneklerini düzenleyin

3. Standalone GeyserMC Kurulumu (Proxy Modu)

Geyser Standalone .jar dosyasını indirin
Terminalde çalıştırın:

java -jar geyser-standalone.jar

Oluşan config.yml dosyasında ayarları yapın:

bedrock:
  address: 0.0.0.0
  port: 19132
remote:
  address: java.sunucu.ip
  port: 25565
  auth-type: online

Port 19132’nin UDP olarak açık olduğundan emin olun

Sık Karşılaşılan Hatalar ve Çözümleri

Bedrock kullanıcı giremiyor ➜ Port 19132 UDP açık mı? Firewall kontrol edin
Username already taken ➜ auth-type floodgate ama Floodgate yoksa bu hata olur
Join failed ➜ Minecraft sürümleri uyumsuz olabilir. Geyser sürümü güncel mi?

Performans ve Uyumluluk Notları

Bedrock ile Java arasında ufak görsel farklar olabilir (skin, hareket, inventar)
GeyserMC performansı yüksek CPU istemez, ama UDP trafiği kontrolü iyi yapılmalı
Proxy sunucuda IP forwarding (Bungee/Paper) açıksa dikkatli yapılandırma gerekir

Sonuç

GeyserMC, Minecraft sunucunuzu çok daha erişilebilir hale getirir. Mobil, konsol ve PC oyuncularını tek bir çatı altında toplayarak oyuncu sayınızı artırmanızı sağlar. Özellikle topluluk sunucuları ve minigame serverlar için oldukça avantajlıdır.

Doğru kurulum ve konfigürasyon ile düşük kaynakla yüksek etkileşimli bir sistem oluşturabilirsiniz.