Cara Setup Geyser dan Floodgate: Buka Server Java untuk Pemain HP

Ada satu kenyataan yang menentukan besar-kecilnya server Minecraft di Indonesia: mayoritas pemain di sini main di HP, alias Minecraft Bedrock. Sementara itu, kebanyakan server (apalagi yang pakai plugin) berbasis Java. Kalau servermu Java murni, kamu menutup pintu untuk sebagian besar calon pemainmu.

Geyser dan Floodgate membuka pintu itu. Dengan keduanya, pemain HP bisa masuk ke server Java kamu memakai akun mereka sendiri, tanpa perlu beli Java. Panduan ini membahas pemasangannya dari nol, baik untuk satu server maupun untuk network ber-proxy.

Apa itu Geyser dan Floodgate

Keduanya gratis dan open-source, buatan tim GeyserMC, dan punya tugas yang berbeda:

• Geyser adalah jembatan yang menerjemahkan protokol Bedrock ke Java secara real-time. Tanpa Geyser, pemain Bedrock sama sekali tidak bisa connect ke server Java.
• Floodgate mengurus autentikasi. Tanpa Floodgate, Geyser tetap jalan, tapi pemain Bedrock tetap diwajibkan punya akun Java, dan hampir tidak ada pemain HP yang punya. Dengan Floodgate, mereka cukup memakai akun Microsoft Bedrock mereka sendiri.

Singkatnya: Geyser membuat koneksinya mungkin, Floodgate membuat pemain HP bisa masuk tanpa akun Java. Kamu butuh keduanya.

Sebelum mulai

• Server Java yang sudah jalan, entah satu server Paper atau network Velocity.
• Akses ke port UDP. Bedrock memakai port 19132 lewat protokol UDP. Pastikan kamu bisa membuka port UDP di firewall atau panel hosting. Sebagian hosting mengharuskan kamu meminta port UDP tambahan ke support.
• Download dari sumber resmi saja. Ambil Geyser dan Floodgate hanya dari geysermc.org. Sama seperti plugin lain, file dari sumber tidak jelas bisa berbahaya.

Pilih cara pasang yang tepat

Ini bagian yang paling sering salah, dan menentukan langkah berikutnya. Tempat memasang Geyser tergantung struktur servermu:

• Kalau cuma satu server Paper: pasang Geyser-Spigot dan Floodgate sebagai plugin biasa di folder plugins server itu.
• Kalau pakai network Velocity: pasang Geyser-Velocity dan Floodgate hanya di proxy, bukan di tiap backend. Memasang Geyser di backend saat sudah ada proxy justru menimbulkan konflik.

Pegang aturan ini: Geyser dipasang di titik terdepan yang menerima koneksi pemain. Di server tunggal, itu server itu sendiri. Di network, itu proxy.

Langkah 1: Pasang plugin

Server tunggal: masukkan Geyser-Spigot.jar dan floodgate-spigot.jar ke folder plugins, lalu restart server. File konfigurasi dibuat otomatis saat pertama jalan.

Network Velocity: masukkan Geyser-Velocity.jar dan floodgate-velocity.jar ke folder plugins proxy, lalu restart proxy.

Langkah 2: Sambungkan Geyser ke Floodgate

Buka config.yml milik Geyser, lalu atur dua hal penting:

bedrock:
  # Alamat dan port yang didengarkan untuk pemain Bedrock. Biarkan default.
  address: 0.0.0.0
  port: 19132

remote:
  # "floodgate" inilah yang membuat pemain HP tidak perlu akun Java.
  auth-type: floodgate

Untuk mode plugin (server tunggal maupun Geyser-Velocity), Geyser sudah otomatis tahu server tujuannya, jadi kamu biasanya tidak perlu mengubah alamat remote. Yang wajib kamu pastikan adalah auth-type: floodgate. Restart lagi setelah diubah.

Satu catatan: dengan Floodgate, servermu tetap bisa berjalan di online-mode yang aman. Floodgate yang mengurus verifikasi pemain Bedrock, jadi kamu tidak perlu mematikan online mode hanya demi pemain HP.

Langkah 3 (khusus network): samakan key.pem

Langkah ini hanya berlaku kalau kamu pakai proxy dan ingin memasang Floodgate juga di server backend (misalnya supaya skin Bedrock tampil sempurna atau plugin lain bisa membaca data Floodgate).

Floodgate membuat file bernama key.pem di folder konfigurasinya. Aturannya:

• File key.pem di setiap backend harus sama persis dengan yang ada di proxy. Salin key.pem dari proxy ke folder config Floodgate tiap backend.
• Kalau key.pem berbeda antar server, pemain Bedrock akan gagal masuk.

Perlakukan key.pem seperti forwarding.secret pada Velocity: jangan pernah membagikannya ke siapa pun. Kunci inilah yang mengizinkan akun Bedrock melewati autentikasi Java. Kalau bocor, orang bisa menyamar menjadi pemain mana pun di servermu.

Langkah 4: Buka port 19132 UDP

Inilah penyebab nomor satu keluhan "pemain HP tidak bisa connect". Bedrock memakai UDP, dan port-nya harus dibuka terpisah dari port Java.

Contoh dengan UFW di Ubuntu:

sudo ufw allow 19132/udp

Beberapa hal yang sering terlewat:

• Port 19132 UDP berbeda dari 25565 TCP milik Java. Keduanya harus terbuka.
• Di sebagian panel hosting, kamu perlu meminta alokasi port UDP tambahan ke support, bukan sekadar membukanya sendiri.

Langkah 5: Uji dari HP

Buka Minecraft Bedrock di HP atau Windows, lalu tambahkan server:

• Alamat (server address): IP atau domain server kamu.
• Port: 19132.

Kalau berhasil, kamu masuk dengan nama Bedrock kamu, biasanya dengan awalan titik (.) di depan. Pemain Java tetap connect seperti biasa ke port 25565. Sekarang kedua dunia bermain di server yang sama.

Soal awalan titik dan pemain Bedrock

• Floodgate menambahkan awalan . di depan username pemain Bedrock (misalnya .NamaKamu) supaya tidak bentrok dengan nama pemain Java. Awalan ini bisa diubah lewat opsi username-prefix di config Floodgate, tapi default titik sudah aman dan jelas.
• Pemain Bedrock akan melihat sebagian menu dalam bentuk form khas Bedrock. Mayoritas plugin tetap jalan normal; hanya beberapa fitur Java yang sangat spesifik yang mungkin terasa beda.
• Skin Bedrock umumnya tetap tampil berkat Floodgate.

Account linking: satu akun untuk dua edisi

Secara default, pemain Java dan pemain Bedrock dianggap akun yang berbeda. Kalau seorang pemain ingin main di servermu dari Java maupun HP dengan data yang sama (inventory, progress, dan seterusnya), mereka bisa menautkan kedua akunnya.

Caranya lewat global linking GeyserMC: pemain menjalankan perintah /linkaccount di dalam server, lalu mengikuti langkah singkat di link.geysermc.org untuk menautkan akun Java dan Bedrock mereka. Setelah tertaut, keduanya diperlakukan sebagai pemain yang sama. Ini opsional, tapi enak untuk pemain yang berpindah-pindah perangkat.

Masalah umum dan solusinya

Pemain HP tidak bisa connect sama sekali. Hampir selalu karena port 19132 UDP belum terbuka. Cek firewall VPS dan panel hosting kamu.

Pemain Bedrock ditolak atau dimintai akun Java. auth-type belum di-set ke floodgate, atau plugin Floodgate belum terpasang dengan benar.

Pemain Bedrock masuk lalu langsung ter-kick di network. File key.pem antara proxy dan backend tidak sama. Salin ulang dari proxy ke semua backend.

Error soal Geyser dobel di network. Kamu memasang Geyser di backend padahal sudah ada di proxy. Hapus Geyser dari backend; cukup di proxy saja.

Pemain HP versi baru tidak bisa masuk. Geyser dan Floodgate harus mengikuti update Minecraft Bedrock. Pastikan kamu memakai versi terbaru keduanya. Perintah geyser connectiontest bisa membantu mendiagnosa koneksi.

Langkah selanjutnya

Server Java kamu sekarang terbuka untuk jutaan pemain HP di Indonesia, dan itu salah satu cara tercepat membuat server cepat ramai. Beberapa langkah lanjutan:

• Daftarkan servermu di MSID dan tonjolkan bahwa server mendukung pemain HP. Ini nilai jual besar di daftar server Minecraft Indonesia.
• Baca cara menambah pemain server untuk strategi pertumbuhan lainnya.

Selamat membuka servermu untuk semua pemain!