Bedrock oyuncularını Java sunucuna al: Geyser + Floodgate kurulumu (Paper, Velocity)

Geyser ve Floodgate ne yapar

Geyser iki sürüm arasında çeviri yapar. Sunucuna karşı bir Java istemcisi gibi davranır, böylece redstone, farmlar ve eklentiler Java oyuncularındakiyle birebir aynı çalışır. Floodgate ise Bedrock oyuncularının Java hesabı yerine Xbox hesaplarıyla giriş yapmasını sağlar.

Başlamadan önce: Java ve sürümler

• Geyser, çalıştığı makinede Java 21 veya daha yenisine ihtiyaç duyar.
• Sunucun en yeni Java sürümünü kabul etmeli, çünkü Geyser böyle bir istemciyi taklit eder. Eski sunucular ViaVersion ister.
• Geyser-Spigot, 1.20.5 ve üstündeki Paper ve Spigot’ta çalışır. Daha eski sunucular bir proxy, Geyser Standalone veya ViaProxy gerektirir.
• Yalnızca güncel Bedrock sürümleri desteklenir (Ekim 2026: Bedrock 26.30 – 26.52, Java 26.2). Bedrock kendini güncellediği için Geyser’ı güncel tut.

Geyser ve Floodgate’i platformuna göre resmî GeyserMC indirme sayfasından indir.

Tek bir Paper veya Spigot sunucusunda kurulum

1. Geyser-Spigot.jar ve Floodgate-Spigot.jar dosyalarını plugins klasörüne koy.
2. Sunucuyu yeniden başlat. Geyser plugins/Geyser-Spigot/config.yml dosyasını, Floodgate ise config.yml ve bir key.pem içeren plugins/floodgate/ klasörünü oluşturur.
3. Geyser config’ini aç ve bedrock bölümüne bak. port, Bedrock oyuncularının yazacağı porttur.
4. Kimlik doğrulama türünü floodgate yap ve tekrar yeniden başlat.

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false

java:
  auth-type: floodgate

Eski Geyser config’lerinde ikinci bölümün adı remote, yani ayar remote.auth-type olur. Güncel sürümler, Floodgate aynı sunucuda çalışıyorsa ona kendiliğinden geçer; ayarı yine de yazmanın zararı yok.

Tek bir sunucuda key.pem dosyasını hiçbir yere kopyalama. Geyser onu Floodgate’ten okur; Geyser klasöründe kalan bir kopya giriş hatalarına yol açar.

Bedrock portunu UDP için aç

Java TCP, Bedrock ise UDP kullanır. Bozuk kurulumların çoğu burada takılır.

• Hosting paneli: ek bir port ekle (birçok host buna allocation der) ve onu bedrock.port olarak gir. Bazı hostlar Bedrock’un Java ile aynı portu kullanmasını şart koşar ya da her açılışta Java portunu değiştirir; orada clone-remote-port: true, Geyser’ın Java portunu kullanmasını sağlar. Geyser kurulum sayfasında birçok host için talimat var.
• Pterodactyl: portu Network sekmesinde sunucuya ata.
• Kendi makinen veya VPS: portu güvenlik duvarında, evdeysen modemde de UDP için aç. OVH ve Oracle Cloud kendi güvenlik duvarlarında da UDP’yi engeller.

sudo ufw allow 19132/udp
sudo ufw reload

Sesli sohbet eklentileri veya query, portu Geyser ile paylaşamaz. Port açıldıktan sonra konsolda geyser connectiontest <ip> <port> çalıştır; portu kontrol eder ve çözüm önerir.

Velocity veya BungeeCord ağında kurulum

Bir ağda Bedrock oyuncuları, tıpkı Java oyuncuları gibi proxy’ye bağlanır. Bu yüzden Geyser yalnızca proxy’de çalışır.

1. Proxy’n (Velocity veya BungeeCord) için Geyser ve Floodgate’i kur ve proxy’yi yeniden başlat.
2. Proxy’deki Geyser config’inde bedrock.port ve floodgate kimlik doğrulama türünü ayarla, portu yukarıda anlatıldığı gibi UDP için aç.
3. Her backend’e Floodgate-Spigot kur. Floodgate API’sini kullanan eklentiler için gereklidir ve skin’leri iyileştirir.
4. Yönlendirmeyi (forwarding) ayarla: BungeeCord’da config.yml içinde ip_forward: true, her backend’in spigot.yml dosyasında bungeecord: true; Velocity’de oyuncu bilgisi yönlendirmesini Velocity dokümantasyonundaki gibi kur.
5. Proxy’deki Floodgate config’inde send-floodgate-data: true ayarla.
6. key.pem dosyasını proxy’nin Floodgate klasöründen her backend sunucunun Floodgate klasörüne kopyala, ardından backend’leri ve proxy’yi yeniden başlat.

send-floodgate-data: true

key.pem dosyasını gizli tut: hesapların Java kimlik doğrulamasını atlamasını sağlar. FTP ile binary modda yükle, yoksa Tag mismatch hataları alırsın.

Bedrock isimleri: nokta prefix’i

Floodgate her Bedrock isminin önüne bir prefix koyar ki hiçbir zaman bir Java ismiyle çakışmasın. Varsayılan bir noktadır, yani Xbox gamertag’i Steve sunucunda .Steve olur. Gamertag’lerdeki boşluklar _ ile değiştirilir.

username-prefix: "."
replace-spaces: true

• Komutlarda prefix’li tam ismi kullan. Bir komut kabul etmiyorsa ismi tırnak içine al: /tp ".Steve".
• Whitelist için fwhitelist add Steve kullan. Orada prefix gerekmez.
• LuckPerms Bedrock isimleriyle sorun yaşarsa config’inde allow-invalid-usernames: true ayarla.

GeyserMC prefix’i korumanı öneriyor. Bedrock oyuncuları da bu isimle oy verir: BestMCServerList’te .Steve girerler, oy ödülü eklentinin gördüğü isim de budur.

Bağlı hesaplar ve skin’ler (isteğe bağlı)

Global Linking Floodgate’te varsayılan olarak açıktır. İki sürüme de sahip oyuncular iki hesapla da link.geysermc.org sunucusuna girip /linkaccount yazar. Bundan sonra iki cihazdan da Java envanterleri ve konumlarıyla oynarlar, o yüzden önce Bedrock eşyalarını taşımaları gerekir. Yerel bir bağlantı veritabanı için ek bir Floodgate uzantısı gerekir.

Floodgate, Java oyuncuları görebilsin diye Bedrock skin’lerini dönüştürüp yükler. Bu bir kuyrukla çalışır ve biraz zaman alabilir.

Sık görülen hatalar ve çözümleri

Bazı şeyler çevrilemez: envanterlerde sol ve sağ tık aynı görünür, Brigadier kullanmayan komutlarda tab tamamlama olmaz, sohbet linkleri tıklanamaz. Menüleri gerçek bir Bedrock cihazıyla test et. Eklentiler Floodgate API’si üzerinden yerel Bedrock formları gösterebilir; bunun için kendi sunucularında Floodgate gerekir.

İki adresi de BestMCServerList’te göster

Bedrock oyuncuları adresin ve Bedrock portuyla bağlanır, örneğin play.example.net ve 19132. BestMCServerList her sunucu sayfasında Java ve Bedrock adresini ayrı ayrı, her birini kopyalama butonuyla gösterir.

1. Sunucunu ekle sayfasını aç ve Java adresini gir.
2. Bedrock oyuncuları destekleniyor kutusunu işaretle.
3. bedrock.port değerindeki Bedrock portunu gir. Bedrock IP’si Java adresiyle aynıysa boş bırak.

Crossplay yeni bir sunucu için gerçek bir avantaj. Planın geri kalanı için yeni bir sunucuya nasıl oyuncu bulunur rehberine bak.