Hướng dẫn khắc phục lỗi NetherNet và Terracotta trên Geyser

Nếu Minecraft Bedrock báo NetherNet, Terracotta hoặc Door khi vào máy chủ Java qua Geyser, hãy bấm Hiển thị chi tiết (Show details) và tìm dòng `InitialConnection`. Mã ở dòng này giúp xác định nên kiểm tra phiên bản Geyser, địa chỉ máy chủ hay cổng kết nối.

Trên PIKAMC, chủ máy chủ Paper có thể cài hoặc cập nhật Geyser và Floodgate tại Nâng cao → PC PE chơi chung. Với cấu hình NetherNet dùng tính năng thiết lập kết nối tích hợp của Geyser, hãy cấp cho Bedrock một cổng phụ hỗ trợ cả TCP và UDP. Người chơi Bedrock vào bằng IP máy chủ PIKAMC và cổng PE đã lưu, còn người chơi Java tiếp tục dùng cổng chính.

Các mã lỗi NetherNet, Terracotta và Door có nghĩa gì?

Minecraft Bedrock 26.60 chuyển sang NetherNet để kết nối máy chủ. Trong cấu hình Geyser dùng tính năng thiết lập kết nối tích hợp, game liên hệ máy chủ qua TCP để thiết lập phiên kết nối (signaling), sau đó truyền dữ liệu chơi qua **UDP**. Vì vậy, máy chủ có thể hiện trong danh sách nhưng vẫn bị hết thời gian chờ khi người chơi bấm vào. [Thông báo NetherNet của GeyserMC]· [Tài liệu mở cổng Geyser]

Các nguyên nhân trong bảng là điểm bắt đầu để chẩn đoán. Riêng mã `122` từng xuất hiện trên một số bản Geyser cũ chạy trong môi trường Alpine Linux. [Báo cáo lỗi Geyser #6807]

Cách sửa lỗi Terracotta trên máy chủ Geyser

1. Cài hoặc cập nhật Geyser và Floodgate

Trong panel PIKAMC, mở máy chủ Minecraft Java (Paper) rồi vào Nâng cao → PC PE chơi chung. Trong thẻ Geyser + Floodgate, bấm Cài đặt nếu chưa cài hoặc Cập nhật nếu đang dùng bản cũ. Chờ panel xử lý xong.

Build 1273 là mốc Geyser bắt đầu hỗ trợ Bedrock 26.60. Hãy dùng bản Geyser tương thích với phiên bản Bedrock thực tế của người chơi. Floodgate cho phép người chơi Bedrock tham gia mà không cần sở hữu thêm Minecraft Java Edition. [Phiên bản Geyser hỗ trợ] · [Tài liệu Floodgate]

2. Chọn cổng PE riêng trên PIKAMC

1. Mở mục Mạng và tìm một cổng phụ đã được cấp có thể nhận kết nối qua cả TCP và UDP. Nếu chưa có cổng phù hợp, hãy liên hệ hỗ trợ PIKAMC qua panel.

2. Quay lại PC PE chơi chung và tắt Dùng chung cổng với bản Java (PC).

3. Nhập cổng phụ vào ô Cổng PE. Chọn chế độ Khuyên dùng*trong mục Cách đăng nhập PE để sử dụng Floodgate.

4. Bấm Lưu cấu hình.

Không dùng cổng chính của Java để cấu hình Geyser. Paper đang dùng TCP trên cổng chính. NetherNet cũng cần TCP để thiết lập kết nối, nên nếu dùng chung số cổng, tính năng thiết lập kết nối tích hợp của Geyser có thể không khởi động. Cổng riêng cho phép người chơi Bedrock kết nối trực tiếp bằng IP máy chủ và cổng PE. 

 3. Kiểm tra cấu hình NetherNet nếu máy chủ từng cài Geyser thủ công

Trên Paper, mở `plugins/Geyser-Spigot/config.yml` và kiểm tra mục `bedrock`. Ví dụ dưới đây dùng cổng `25026`. Hãy thay bằng cổng phụ thực tế được cấp cho máy chủ và cập nhật các khóa tương ứng trong mục `bedrock` hiện có.

bedrock:
  port: 25026
  transport: nethernet
  clone-remote-port: false
  signaling:
    mode: builtin

Từ build 1280, chế độ chỉ dùng RakNet đã bị loại bỏ và cấu hình cũ `transport: raknet` được chuyển sang NetherNet. Nếu dùng chế độ `both` trên bản hỗ trợ tùy chọn này, RakNet và NetherNet cần hai cổng UDP riêng. Với cấu hình PIKAMC trong bài, dùng `nethernet`. [Thay đổi cấu hình ở build 1280] · [Tài liệu thiết lập Geyser]

4. Khởi động lại và thử kết nối từ Bedrock

Quay về Bảng điều khiển → Khởi động lại. Nếu máy chủ đang tắt, bấm Chạy, Mở Console và tìm dòng tương tự ví dụ sau.

[Geyser-Spigot] Built-in signaling started on http://0.0.0.0:25026

Dòng này xác nhận phần thiết lập kết nối tích hợp đã khởi động. Để kiểm tra kết nối từ bên ngoài, mở Minecraft Bedrock và vào Chơi → Máy chủ → Thêm máy chủ. Nhập IP máy chủ PIKAMC vào ô địa chỉ và cổng PE đã lưu trong Geyser vào ô cổng. Nếu đã lưu máy chủ từ trước, hãy sửa lại cổng trong mục đó. [Hướng dẫn kiểm tra NetherNet]

Cách sửa lỗi Door `InitialConnection-83`

Nếu máy chủ hiện trong danh sách Bedrock nhưng vào game bị hết thời gian chờ, hãy kiểm tra **UDP trên cùng cổng PE**. TCP có thể đã hoạt động đủ để game tìm thấy máy chủ, trong khi dữ liệu chơi qua UDP vẫn bị chặn.

Nếu cổng đã hỗ trợ cả hai giao thức nhưng mã `83` vẫn xuất hiện, gửi log Geyser cho hỗ trợ PIKAMC để kiểm tra đường kết nối và địa chỉ công khai. Khi xác định Geyser đang thông báo sai địa chỉ do NAT, có thể đặt `advertise-addresses` trong phần `signaling` hiện có rồi khởi động lại. Địa chỉ dưới đây chỉ dùng minh họa. [Tài liệu cấu hình NetherNet của GeyserMC]

bedrock:
  signaling:
    advertise-addresses:
      - "203.0.113.10"

Một số build cũ có thể gợi ý quay về RakNet khi thư viện WebRTC không tải được. Với người chơi Bedrock 26.60, hãy xử lý lỗi thư viện để NetherNet khởi động được. [Thay đổi ở build 1280] · [Báo cáo lỗi thư viện #6852]

Kết quả thử nghiệm trong bài gốc

Bài gốc ghi nhận năm tình huống thử nghiệm ngày **01/11/2026** với Paper 26.3, Geyser-Spigot 2.12.1 và trình khách thử nghiệm NetherNet dựa trên `gophertunnel`.

Câu hỏi thường gặp

Tôi là người chơi. Cần gửi gì khi báo lỗi?

Kiểm tra lại IP, cổng PE và phiên bản Minecraft Bedrock. Nếu vẫn không vào được, gửi chủ máy chủ ảnh đầy đủ màn hình Hiển thị chi tiết, loại thiết bị, phiên bản game và giờ vừa thử kết nối. Nếu biết người chơi khác có vào được hay không, hãy gửi kèm để chủ máy chủ dễ khoanh vùng lỗi.

Vì sao máy chủ không hiện trong mục Trò chơi LAN trên Bedrock 26.60?

Đã có báo cáo về trường hợp Geyser không xuất hiện trong mục Trò chơi LAN, trong khi kết nối trực tiếp vẫn hoạt động. Với máy chủ PIKAMC, hãy vào tab Máy chủ và thêm thủ công bằng IP máy chủ và cổng PE của Geyser. [Báo cáo Geyser #6853]

Vì sao người chơi dùng Bedrock bản cũ không vào được?

Mỗi bản Geyser hỗ trợ một phạm vi phiên bản Minecraft nhất định. Khi cập nhật Geyser để hỗ trợ Bedrock 26.60, một số phiên bản cũ như 26.30 có thể không còn tương thích. Đối chiếu phiên bản game với danh sách hỗ trợ trước khi thử lại. [Phiên bản Geyser hỗ trợ]

Vì sao Bedrock hỏi có tin cậy máy chủ không?

Bedrock có thể hiện lời nhắc này ở lần kết nối đầu nếu Geyser dùng HTTP để thiết lập phiên kết nối. Nếu muốn dùng HTTPS, hãy dùng chứng chỉ hợp lệ cho tên miền mà người chơi nhập và cấu hình HTTPS cho phần thiết lập kết nối tích hợp của Geyser. [Hướng dẫn HTTPS của GeyserMC]