Geyser ve Floodgate ile Bedrock Oyuncularını Java Sunucuya Bağlama

Geyser kurulumu, telefondan, tabletten veya konsoldan oynayan Bedrock oyuncularının Java Edition sunucunuza girebilmesini sağlayan tek pratik yöntemdir. Geyser sunucunuza bir eklenti olarak kurulur, 19132/UDP portunu dinler ve Bedrock istemcisinin konuştuğu protokolü Java protokolüne çevirir. Yanına Floodgate’i de kurarsanız Bedrock oyuncuları Java Edition satın almadan, kendi Xbox hesaplarıyla girebilir.

18 Ağustos 2026 itibarıyla güncel sürümler Geyser 2.11.1 (build #1225) ve Floodgate 2.2.5 (build #140). İkisi de aynı ekip tarafından geliştiriliyor, eşzamanlı güncelleniyor ve Minecraft 26.2 “Chaos Cubed” sunucularında sorunsuz çalışıyor. Bu sayfada sıfırdan kurulumu, port ayarlarını, hesap eşleştirmeyi, proxy’li sunucu ağlarında dikkat edilecek noktaları ve en sık karşılaşılan hataların birebir metinleriyle çözümlerini bulacaksınız.

Geyser ve Floodgate Nedir, Aralarındaki Fark Ne?#

İki eklenti birbirini tamamlar ama işleri farklıdır. Karıştırmamak için ikisini ayrı ayrı tanımlayalım.

Geyser: protokol köprüsü#

Geyser bir protokol çeviricisidir (protocol translator). Bedrock istemcisi RakNet üzerinden UDP konuşur ve paket yapısı Java’dan tamamen farklıdır. Geyser bu paketleri karşılar, Java sunucusunun anlayacağı biçime çevirir, sunucudan gelen cevabı da geri çevirip Bedrock istemcisine yollar. Yani sunucunuz aslında hâlâ saf bir Java sunucusudur; Bedrock oyuncusu Geyser sayesinde kendini Java oyuncusu gibi tanıtır.

Floodgate: kimlik doğrulama köprüsü#

Floodgate ise kimlik doğrulama (authentication) tarafını halleder. Geyser tek başına kurulduğunda Bedrock oyuncusundan geçerli bir Java Edition hesabı ister; oyuncu telefondan bağlanmaya çalışırken bir tarayıcı doğrulaması yapmak ve gerçekten satın alınmış bir Java hesabına sahip olmak zorunda kalır. Floodgate bu adımı ortadan kaldırır: oyuncunun Xbox Live kimliğini kabul eder ve sunucuya “bu oyuncu doğrulanmıştır” bilgisini iletir.

Pratikte neredeyse hiç kimse Geyser’i tek başına kurmaz. Amacınız “telefondan oynayan arkadaşlarım da girsin” ise ikisini birlikte kurun. Java ve Bedrock sürümleri arasındaki temel farkları merak ediyorsanız Java Edition mı Bedrock Edition mı karşılaştırmamız iyi bir başlangıç.

Kurulumdan Önce Gerekenler#

Geyser bir Bukkit/Spigot/Paper eklentisi olarak, ya da Fabric ve NeoForge’da mod olarak çalışır. Vanilla server.jar üzerinde eklenti desteği olmadığı için Geyser doğrudan kurulamaz; önce Paper gibi bir sunucu çekirdeğine geçmeniz gerekir.

Sunucu yazılımı

Paper, Purpur, Spigot (eklenti olarak) veya Fabric / NeoForge (mod olarak). Kurulumu için Paper sunucu kurulumu sayfasına bakın.

Java sürümü

Minecraft 26.1 ve sonrası Java 25 ister. Hangi sürümde ne gerektiğini Java sürümü rehberinde tablo halinde bulabilirsiniz.

Java portu

25565/TCP — normal Java oyuncuları buradan girer.

Bedrock portu

19132/UDP — Geyser burayı dinler, güvenlik duvarında açılmalıdır.

RAM

Bedrock oyuncusu bekleyen bir sunucuda 8 GB alt sınırdır; 10 oyuncunun üstünde 12 GB rahat ettirir.

Geyser ve Floodgate’i İndirme#

Geyser’in GitHub üzerinde klasik bir “Releases” sayfası yoktur. Dağıtım tamamen GeyserMC’nin kendi derleme (build) API’si üzerinden yapılır ve her yapı ayrı bir numara alır. Bu yüzden internette bulduğunuz eski bir jar’ı değil, her zaman resmî indirme sayfasındaki güncel yapıyı kullanın.

Hangi jar dosyasını indireceksiniz?#

Geyser’in derleme API’si yedi ayrı jar sunar: Geyser-Spigot.jar, Geyser-BungeeCord.jar, Geyser-Velocity.jar, Geyser-Fabric.jar, Geyser-NeoForge.jar, Geyser-Standalone.jar ve Geyser-ViaProxy.jar. Paper ve Purpur kullananlar Spigot yapısını indirir — Paper, Spigot eklentilerini çalıştırır.

Floodgate tarafında ise derleme API’si yalnızca üç jar verir: floodgate-spigot.jar, floodgate-bungee.jar ve floodgate-velocity.jar. Fabric ve NeoForge sürümleri (floodgate-fabric.jar, floodgate-neoforge.jar) derleme API’sinde bulunmaz, Modrinth üzerinden dağıtılır. Modlu bir sunucu kuruyorsanız bu ayrımı bilmeniz zaman kazandırır.

Otomatik kurulum betiği yazıyorsanız veya panel entegrasyonu yapıyorsanız sabit dosya adı yerine API adresini kullanın; bu adres her zaman en güncel yapıyı verir:

# Güncel sürümü ve build numarasını sorgulama
curl -s https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest

# Spigot/Paper jar’ını doğrudan indirme (her zaman en son build)
wget -O plugins/Geyser-Spigot.jar \
  https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot

Geyser Kurulumu: Adım Adım#

1. Sunucuyu durdurun#

   Konsola stop yazın ve sunucunun tamamen kapanmasını bekleyin. Çalışan sunucuya jar atmak eklentinin yarım yüklenmesine yol açabilir.

2. Jar dosyalarını plugins klasörüne kopyalayın#

   Geyser-Spigot.jar ve floodgate-spigot.jar dosyalarını sunucunun plugins klasörüne atın. Web panel kullanıyorsanız panelin dosya yöneticisinden yüklemeniz yeterlidir.

   sunucu/
    ├── paper-26.2-112.jar
    ├── server.properties
    └── plugins/
         ├── Geyser-Spigot.jar
         └── floodgate-spigot.jar

3. Sunucuyu bir kez başlatıp kapatın#

   İlk açılışta Geyser plugins/Geyser-Spigot/config.yml dosyasını, Floodgate ise plugins/floodgate/config.yml ve key.pem dosyalarını üretir. Konsolda kırmızı satır görürseniz devam etmeden önce nedenini çözün.

4. Geyser yapılandırmasını düzenleyin#

   plugins/Geyser-Spigot/config.yml dosyasını açın ve iki bölümü kontrol edin.

   # plugins/Geyser-Spigot/config.yml
   bedrock:
     address: 0.0.0.0
     port: 19132
     clone-remote-port: false
   remote:
     address: 127.0.0.1
     port: 25565
     auth-type: floodgate

5. 19132/UDP portunu açın#

   Güvenlik duvarında UDP kuralı oluşturmadan hiçbir Bedrock oyuncusu sunucuyu göremez. Komutlar bir alt bölümde.

6. Sunucuyu başlatın ve telefondan test edin#

   Konsolda Geyser’in başladığını gördükten sonra bir Bedrock istemcisiyle sunucu IP’nizi ve 19132 portunu girerek bağlanmayı deneyin.

config.yml anahtarları ne işe yarar?#

bedrock.address Geyser’in hangi ağ arayüzünü dinleyeceğini belirler; 0.0.0.0 “tüm arayüzler” demektir ve normal kurulumda değiştirilmemelidir. bedrock.port Bedrock oyuncularının bağlanacağı porttur. clone-remote-port değerini true yaparsanız Geyser, Bedrock portu olarak Java sunucusunun portunu (yani 25565’i) kullanır — bunu yalnızca özel bir sebebiniz varsa açın.

remote bölümü Geyser’in bağlanacağı Java sunucusunu tarif eder. Eklenti olarak kurduğunuzda Geyser zaten sunucunun içindedir ve bu değerleri kendisi çözer; remote.address ve remote.port asıl olarak Geyser Standalone kurulumunda anlam taşır. Ama auth-type her kurulumda önemlidir.

Floodgate Kurulumu ve auth-type Ayarı#

Floodgate’in çalışması tek bir satıra bağlıdır: Geyser yapılandırmasındaki auth-type değeri floodgate olmalıdır. GeyserMC’nin resmî belgesi de bunu birebir “Change auth-type in Geyser’s config to floodgate” diye yazar. Bu satırı değiştirmezseniz Floodgate jar’ı yüklenir, log’da hata da vermez, ama Bedrock oyuncuları hâlâ Java hesabı sorulan ekranla karşılaşır.

Floodgate’in kendi yapılandırması plugins/floodgate/config.yml dosyasındadır. Varsayılan içeriği şöyledir:

# plugins/floodgate/config.yml
key-file-name: key.pem
username-prefix: "."
replace-spaces: true
player-link:
  enabled: true
  require-link: false
  enable-own-linking: false
  allowed: true
  link-code-timeout: 300
  type: sqlite
  enable-global-linking: true
config-version: 3

username-prefix, Bedrock oyuncularının adının başına eklenen karakterdir; varsayılanı noktadır ve sunucuda .OyuncuAdi biçiminde görünürler. Bu önek, aynı ismi kullanan Java ve Bedrock oyuncularının çakışmasını önler. replace-spaces ise Xbox kullanıcı adlarındaki boşlukları alt çizgiye çevirir — Java tarafı oyuncu adında boşluk kabul etmediği için bu ayar açık kalmalıdır.

19132/UDP Portunu Açma#

Bu bölüm kurulumun en sık atlanan adımıdır. Bedrock protokolü RakNet üzerinden UDP kullanır; 19132’yi TCP olarak açmak hiçbir işe yaramaz. Kural yazarken protokolün UDP olduğundan emin olun.

Linux (UFW)#

sudo ufw allow 19132/udp
sudo ufw reload
sudo ufw status

Windows (PowerShell, yönetici olarak)#

New-NetFirewallRule -DisplayName "Minecraft Bedrock (Geyser)" `
  -Direction Inbound -Protocol UDP -LocalPort 19132 -Action Allow

Ev bağlantısında sunucu çalıştırıyorsanız modem üzerinde de aynı portu UDP olarak yönlendirmeniz gerekir. Linux tarafındaki güvenlik duvarı ayrıntıları için UFW ile port açma, Windows tarafı için Windows Güvenlik Duvarında port açma sayfalarına göz atın.

Hesap Eşleştirme (Player Link) ve key.pem Yönetimi#

Floodgate kurulduğunda plugins/floodgate/key.pem adında bir anahtar dosyası üretilir. Bu dosya, Geyser ile Floodgate arasındaki güven ilişkisini kurar: Geyser bir Bedrock oyuncusunun doğrulandığını bu anahtarla imzalanmış veriyle bildirir. GeyserMC’nin belgesindeki uyarı gayet nettir — bu anahtarı kimseyle paylaşmayın. Anahtarı ele geçiren biri sunucunuza istediği isimle “doğrulanmış Bedrock oyuncusu” olarak girebilir.

Java ve Bedrock hesabını birleştirme#

player-link bölümü, bir oyuncunun hem Java hem Bedrock hesabıyla aynı karakteri kullanmasını sağlar. Eşleştirme yapıldığında oyuncu telefondan girdiğinde de bilgisayardan girdiğinde de aynı envanter, aynı yetki ve aynı bakiyeyle oynar.

• enabled: true — eşleştirme sistemi açıktır.
• require-link: false — eşleştirme zorunlu değildir; true yaparsanız yalnızca hesabını eşleştirmiş Bedrock oyuncuları girebilir.
• enable-own-linking: false — oyuncuların kendi başlarına eşleştirme yapmasını kapatır. Oyuncularınız kendi hesaplarını bağlasın istiyorsanız bunu true yapın.
• link-code-timeout: 300 — üretilen eşleştirme kodunun geçerlilik süresi, saniye cinsinden (5 dakika).
• type: sqlite — eşleştirme verisinin saklandığı veritabanı. Tek sunucuda SQLite yeterlidir; sunucu ağında ortak bir veritabanı tercih edilir.

Eşleştirme komutlarının güncel sözdizimi Floodgate’in kendi belgesinde tutulur ve sürümden sürüme değişebilir; oyuncularınıza yönlendireceğiniz adımları resmî Floodgate belgesinden doğrulayın.

BungeeCord ve Velocity Ağlarında Kurulum#

Birden fazla sunucuyu bir proxy arkasında topladıysanız kurulum mantığı değişir. Bu senaryoda Geyser ve Floodgate yalnızca proxy’ye kurulur; arka uç (backend) sunuculara Geyser jar’ı atılmaz. Ancak arka uç sunucuların Floodgate oyuncularını tanıyabilmesi için bir istisna vardır.

1. Proxy’ye jar’ları kurun#

   Geyser-BungeeCord.jar veya Geyser-Velocity.jar ile ilgili Floodgate jar’ını proxy’nin plugins klasörüne atın ve bir kez başlatıp kapatın.

2. key.pem dosyasını arka uçlara kopyalayın#

   Proxy’de üretilen plugins/floodgate/key.pem dosyasını her arka uç sunucunun plugins/floodgate/ klasörüne kopyalayın. Anahtar eşleşmezse arka uç sunucu Bedrock oyuncusunu tanımaz.

   # Proxy makinesinden arka uç sunucuya kopyalama örneği
   scp /opt/proxy/plugins/floodgate/key.pem \
       root@10.0.0.12:/opt/survival/plugins/floodgate/key.pem

3. auth-type değerini proxy’de ayarlayın#

   Geyser yapılandırmasındaki auth-type: floodgate satırı proxy’deki dosyada olmalıdır.

Proxy kurulumunun kendisini henüz yapmadıysanız BungeeCord ve Velocity ile sunucu ağı kurulumu sayfası tüm adımları içeriyor.

Geyser Komutları ve İzin Düğümleri#

Geyser’in komut seti sadedir ve tümü /geyser öneki altındadır. En çok işinize yarayacak olanı /geyser dump: destek istemeden önce bu komutu çalıştırıp çıktısını paylaşmak, sorunun çözülme süresini belirgin biçimde kısaltır.

Bedrock Oyuncularında Çalışmayan Özellikler#

Geyser bir protokol çeviricisidir ve iki oyunun farklı olduğu her noktada bir sınır çizilir. Aşağıdakiler hata değil, protokol farkından kaynaklanan ve düzeltilemeyen kısıtlardır. Sunucunuzu tasarlarken bunları hesaba katın.

Envanterde sol/sağ tık ayrımının olmaması özellikle GUI tabanlı menü eklentileri için önemlidir. Sağ tıkla farklı bir işlem yapan bir mağaza menüsü kurduysanız Bedrock oyuncuları o işleve erişemez. Menü tasarımınızı tek tıkla çalışacak biçimde planlayın, yoksa oyuncularınızın yarısı menüyü kullanamaz.

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

Address already in use: bind#

java.net.BindException: Address already in use: bind

19132 portunu başka bir uygulama tutuyor demektir. En yaygın sebep aynı makinede çalışan bir Bedrock Dedicated Server veya ikinci bir Geyser örneğidir. Portu kimin tuttuğunu bulun ve o servisi durdurun; ya da Geyser yapılandırmasında bedrock.port değerini 19133 gibi boş bir porta alıp güvenlik duvarında yeni portu açın.

# Windows: 19132 portunu kim tutuyor?
Get-NetUDPEndpoint -LocalPort 19132 | Select-Object OwningProcess

# Linux: 19132/UDP portunu kim tutuyor?
sudo ss -lunp | grep 19132

class file version hatası#

has been compiled by a more recent version of the Java Runtime (class file version 65.0)

Sunucunun çalıştığı Java sürümü, jar’ın derlendiği sürümden eskidir. Class file numaralarının karşılıkları şöyledir: 69.0 = Java 25, 65.0 = Java 21, 61.0 = Java 17, 52.0 = Java 8. Yukarıdaki mesaj Java 21 ile derlenmiş bir jar’ı daha eski bir çalışma zamanında açtığınızı söyler. Zaten Minecraft 26.2 Java 25 istediği için doğru çözüm Java 25 LTS’e geçmektir; ayrıntılar Java sürüm hatası sayfasında.

Unable to connect to world#

Unable to connect to world

Bedrock istemcisi sunucuyu buluyor ama bağlanamıyor. Ters proxy (reverse proxy) kullanmıyorsanız Geyser yapılandırmasında advanced.java.use-haproxy-protocol değerinin false olduğundan emin olun. Bu ayar açıkken Geyser, önünde HAProxy varmış gibi davranır ve doğrudan gelen bağlantıları reddeder.

“Locating Server” ekranında takılma#

Bedrock istemcisi sunucu ararken takılıyor ve konsolda hiçbir hata yoksa sorun neredeyse her zaman ağdadır: 19132 portu UDP olarak açılmamıştır, ya modemde yönlendirme yoktur ya da barındırıcının güvenlik duvarı UDP trafiğini süzmektedir. Önce sunucu makinesinden yerel testi yapın, sonra dışarıdan deneyin.

Donanım ve Performans Önerileri#

Geyser her Bedrock oyuncusu için paket çevirisi yapar. Bu iş ana tick döngüsünün dışında yürüse de CPU ve bellek tüketir; ayrıca Bedrock istemcileri Java istemcilerinden daha fazla chunk isteme eğilimindedir. Bu yüzden Geyser kurulu bir sunucuda donanımı biraz geniş tutmak gerekir.

İşlemci seçiminde çekirdek sayısı değil saat hızı belirleyicidir; Minecraft’ın ana tick döngüsü tek çekirdekte çalışır. Bu nedenle yüksek frekanslı Ryzen 9 işlemciler, çok çekirdekli ama düşük frekanslı sunucu işlemcilerine göre gözle görülür fark yaratır. Disk tarafında NVMe SSD şarttır: Bedrock oyuncularının chunk istekleri disk I/O gecikmesini doğrudan ping olarak hissettirir.

Bedrock oyuncularının çoğu mobil bağlantı kullanır ve view-distance değerini yüksek tutmak onlarda daha fazla soruna yol açar. server.properties içindeki görüş mesafesi ayarlarını 8–10 aralığında tutmak hem sunucuyu hem mobil oyuncuları rahatlatır; ayrıntılı liste server.properties ayarları sayfamızda.

Kurulum Sonrası Kontrol Listesi#

Her şey doğru yapıldıysa aşağıdaki maddelerin tamamı sağlanmış olmalı. Bir tanesi eksikse Bedrock oyuncuları büyük ihtimalle bağlanamaz.

• Sunucu Paper, Purpur, Spigot, Fabric veya NeoForge üzerinde çalışıyor (vanilla değil).
• plugins klasöründe hem Geyser hem Floodgate jar’ı var.
• Geyser yapılandırmasında auth-type: floodgate yazıyor.
• 19132 portu güvenlik duvarında UDP olarak açık.
• plugins/floodgate/key.pem dosyası mevcut ve kimseyle paylaşılmamış.
• Proxy varsa Geyser yalnız proxy’de, key.pem ise tüm arka uçlarda.
• Konsolda /geyser version komutu sürümü sorunsuz basıyor.

Özetle#

Geyser ve Floodgate ikilisi, Java sunucunuzu tek bir eklenti çiftiyle Bedrock oyuncularına açar. Geyser protokolü çevirir ve 19132/UDP portunu dinler, Floodgate ise Java hesabı zorunluluğunu kaldırır. Güncel sürümler Geyser 2.11.1 ve Floodgate 2.2.5’tir; ikisi de Minecraft 26.2 ile uyumludur.

Kurulumda tökezlenen üç nokta hep aynıdır: auth-type değerinin floodgate yapılmaması, 19132 portunun UDP yerine TCP açılması ve proxy kurulumunda key.pem dosyasının arka uç sunuculara kopyalanmaması. Bu üçünü doğru yaparsanız geri kalan kurulum on dakikalık iştir. Sunucunuzu sıfırdan kuruyorsanız plugin kurulumu ve Bedrock sunucu kurulumu sayfalarını da okumanızı öneririz.