Plugin Minecraft Geyser-Spigot

🔌 Giới thiệu về Geyser-Spigot

Geyser-Spigot là bản build nền tảng Spigot/Paper của Geyser: một bộ chuyển đổi giao thức cho phép client Minecraft: Bedrock Edition kết nối tới server Java Edition bằng cách chạy Geyser như một plugin phía máy chủ. Nó chạy bên trong các file JAR tương thích với Spigot và cung cấp một Bedrock listener để chuyển lưu lượng giao thức Bedrock sang lưu lượng giao thức Java cho server chính.

🎯 Mục đích

Cung cấp khả năng crossplay để chủ server có thể chấp nhận người chơi Bedrock trên server Java mà không cần một tiến trình proxy riêng. Điều này giải quyết vấn đề cốt lõi là không tương thích giao thức giữa Bedrock và Java.

⚙️ Tính năng

• Chạy như một plugin Spigot/Paper (đặt JAR vào plugins/ và khởi động lại).
• Chuyển lưu lượng giao thức Bedrock sang giao thức Java để client Bedrock có thể vào các server Java.
• Tạo cấu hình theo từng server (thư mục plugin và file config được tạo trong plugins/Geyser-Spigot).
• Được khuyến nghị chính thức đi cùng Floodgate để xác thực Bedrock khi bạn muốn người chơi Bedrock tham gia mà không cần xác thực bằng tài khoản Java.
• Được hỗ trợ và duy trì như một phần của dự án GeyserMC (mã nguồn có sẵn trong kho lưu trữ của dự án).

🧩 Dành cho ai

• Chủ server muốn crossplay Java/Bedrock trên cùng một backend Spigot hoặc Paper.
• Các server Survival, SMP và cộng đồng từ nhỏ đến lớn cần hỗ trợ client Bedrock.
• Quản trị viên thích chạy Geyser như một plugin thay vì một proxy standalone riêng.

🏗️ Ví dụ sử dụng

• Cho phép người chơi trên di động và console (Bedrock) vào server Java Spigot/Paper mà không cần chạy một server proxy riêng.
• Chạy một server SMP công khai chấp nhận cả client Java và Bedrock trong khi giữ toàn bộ logic game trên cùng một backend.

⚙️ Cài đặt

📥 Thiết lập

• Tải JAR chính thức của Geyser-Spigot cho nền tảng Spigot/Paper.
• Đặt file Geyser-Spigot.jar vào thư mục plugins/ của server.
• Khởi động hoặc khởi động lại server và kiểm tra log để xác nhận plugin đã được bật và đã tạo thư mục của nó.

📦 Phụ thuộc

• Floodgate (tùy chọn): được khuyến nghị khi bạn muốn người chơi Bedrock xác thực/tham gia mà không cần xác thực bằng tài khoản Java; Floodgate được xem là thành phần đi kèm phổ biến của Geyser.

🧾 Cấu hình

• Geyser-Spigot tạo một thư mục cấu hình trong plugins/Geyser-Spigot và một file config chính nơi listener, cài đặt server Java từ xa và các tùy chọn khác được thiết lập. Chỉnh các file đó khi cần và khởi động lại server để áp dụng thay đổi.

🧠 Ghi chú kỹ thuật

• Nền tảng server được xác nhận hỗ trợ: Spigot và Paper.
• Được ghi nhận là hỗ trợ các phiên bản server hiện đại từ 1.16.5 trở lên khi dùng như plugin Spigot/Paper.
• Mã nguồn và việc theo dõi issue được duy trì trong kho lưu trữ dự án GeyserMC trong kho nguồn của dự án.
• Phát hành theo MIT License.

🤝 Khi plugin này hữu ích

Nếu bạn cần chấp nhận người chơi Bedrock trên một server Java Spigot/Paper hiện có mà không chạy tiến trình proxy riêng, Geyser-Spigot cung cấp một lớp chuyển đổi giao thức phía máy chủ được duy trì, giữ kết nối Bedrock trên cùng backend với người chơi Java.