Lasă jucătorii Bedrock să intre pe serverul tău Java: configurarea Geyser + Floodgate (Paper, Velocity)

Ce fac Geyser și Floodgate

Geyser traduce între cele două ediții. Față de serverul tău se comportă ca un client Java, așa că redstone-ul, fermele și pluginurile merg exact ca pentru jucătorii Java. Floodgate le permite jucătorilor Bedrock să se autentifice cu contul Xbox în loc de un cont Java.

Înainte să începi: Java și versiuni

• Geyser are nevoie de Java 21 sau mai nou pe mașina pe care rulează.
• Serverul tău trebuie să accepte cea mai nouă versiune Java, pentru că Geyser imită un astfel de client. Serverele mai vechi au nevoie de ViaVersion.
• Geyser-Spigot rulează pe Paper și Spigot de la 1.20.5 în sus. Serverele mai vechi au nevoie de un proxy, de Geyser Standalone sau de ViaProxy.
• Sunt suportate doar versiunile Bedrock actuale (octombrie 2026: Bedrock 26.30 până la 26.52, Java 26.2). Ține Geyser la zi, pentru că Bedrock se actualizează singur.

Descarcă Geyser și Floodgate pentru platforma ta de pe pagina oficială de descărcare GeyserMC.

Configurare pe un singur server Paper sau Spigot

1. Pune Geyser-Spigot.jar și Floodgate-Spigot.jar în folderul plugins.
2. Repornește serverul. Geyser creează plugins/Geyser-Spigot/config.yml, iar Floodgate creează plugins/floodgate/ cu config.yml și un key.pem.
3. Deschide configul Geyser și verifică secțiunea bedrock. port e ce vor scrie jucătorii Bedrock.
4. Setează tipul de autentificare la floodgate și repornește din nou.

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

java:
  auth-type: floodgate

Configurile Geyser mai vechi numesc a doua secțiune remote, deci setarea e remote.auth-type. Versiunile actuale trec singure pe Floodgate când acesta rulează pe același server; dacă o setezi, nu strică nimic.

Pe un singur server nu copia key.pem nicăieri. Geyser îl citește de la Floodgate, iar o copie rămasă în folderul Geyser provoacă erori la autentificare.

Deschide portul Bedrock pentru UDP

Java folosește TCP, Bedrock folosește UDP. Aici cad cele mai multe configurări stricate.

• Panou de hosting: adaugă un port suplimentar (multe hostinguri îi spun allocation) și introdu-l ca bedrock.port. Unele hostinguri cer ca Bedrock să folosească același port ca Java sau schimbă portul Java la fiecare pornire; acolo clone-remote-port: true face ca Geyser să folosească portul Java. Pagina de configurare Geyser are instrucțiuni pentru multe hostinguri.
• Pterodactyl: alocă portul serverului în fila Network.
• Mașină proprie sau VPS: deschide portul pentru UDP în firewall și, acasă, în router. OVH și Oracle Cloud blochează UDP și în firewallul lor propriu.

sudo ufw allow 19132/udp
sudo ufw reload

Pluginurile de voice chat sau query nu pot împărți portul cu Geyser. După ce portul e deschis, rulează geyser connectiontest <ip> <port> în consolă; verifică portul și sugerează soluții.

Configurare pe un network Velocity sau BungeeCord

Într-un network, jucătorii Bedrock se conectează la proxy la fel ca jucătorii Java. De aceea Geyser rulează doar pe proxy.

1. Instalează Geyser și Floodgate pentru proxyul tău (Velocity sau BungeeCord) și repornește proxyul.
2. Setează bedrock.port și tipul de autentificare floodgate în configul Geyser de pe proxy și deschide portul pentru UDP, cum e descris mai sus.
3. Instalează Floodgate-Spigot pe fiecare backend. E necesar pentru pluginurile care folosesc API-ul Floodgate și îmbunătățește skinurile.
4. Configurează forwardingul: pe BungeeCord setează ip_forward: true în config.yml și bungeecord: true în spigot.yml al fiecărui backend; pe Velocity configurează forwardingul informațiilor despre jucători cum e descris în documentația Velocity.
5. În configul Floodgate de pe proxy, setează send-floodgate-data: true.
6. Copiază key.pem din folderul Floodgate al proxyului în folderul Floodgate al fiecărui server backend, apoi repornește backendurile și proxyul.

send-floodgate-data: true

Ține key.pem secret: lasă conturi să treacă de autentificarea Java. Încarcă-l prin FTP în modul binar, altfel primești erori Tag mismatch.

Numele Bedrock: prefixul cu punct

Floodgate pune un prefix în fața fiecărui nume Bedrock, ca să nu se poată suprapune niciodată cu un nume Java. Implicit e un punct, așa că gamertagul Xbox Steve devine .Steve pe serverul tău. Spațiile din gamertaguri sunt înlocuite cu _.

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

• În comenzi folosește numele complet, cu prefix. Dacă o comandă nu-l acceptă, pune numele între ghilimele: /tp ".Steve".
• Pentru whitelist folosește fwhitelist add Steve. Acolo prefixul nu e necesar.
• Dacă LuckPerms are probleme cu numele Bedrock, setează allow-invalid-usernames: true în configul lui.

GeyserMC recomandă să păstrezi prefixul. Jucătorii Bedrock votează tot cu acest nume: pe BestMCServerList introduc .Steve, numele pe care îl vede pluginul tău de recompense de vot.

Conturi legate și skinuri (opțional)

Global Linking e activat implicit în Floodgate. Jucătorii care au ambele ediții intră pe link.geysermc.org cu ambele conturi și scriu /linkaccount. După aceea joacă cu inventarul și locația din Java de pe oricare dispozitiv, așa că ar trebui să-și mute mai întâi itemele de pe Bedrock. O bază de date locală pentru legături necesită o extensie Floodgate în plus.

Floodgate convertește și încarcă skinurile Bedrock, ca jucătorii Java să le vadă. Asta trece printr-o coadă și poate dura o vreme.

Erori frecvente și soluții

Unele lucruri nu pot fi traduse: clicul stânga și dreapta în inventare arată la fel, comenzile fără Brigadier nu au completare cu tab, linkurile din chat nu se pot apăsa. Testează meniurile cu un dispozitiv Bedrock real. Pluginurile pot afișa formulare native Bedrock prin API-ul Floodgate, care are nevoie de Floodgate pe serverul lor.

Arată ambele adrese pe BestMCServerList

Jucătorii Bedrock se conectează cu adresa ta plus portul Bedrock, de exemplu play.example.net și 19132. BestMCServerList arată separat adresa Java și adresa Bedrock pe fiecare pagină de server, fiecare cu un buton de copiere.

1. Deschide Adaugă serverul tău și introdu adresa Java.
2. Bifează Jucătorii Bedrock sunt acceptați.
3. Introdu portul Bedrock din bedrock.port. Lasă IP-ul Bedrock gol dacă e același cu adresa Java.

Crossplay-ul e un avantaj real pentru un server nou. Vezi cum aduci jucători pe un server nou pentru restul planului.