server-icon.png: Những yêu cầu chính xác và API quản lý không ai dùng
64x64, PNG, nằm ở thư mục gốc của máy chủ — chỉ cần sai một trong ba điều kiện này là biểu tượng sẽ không hiển thị. Kèm theo đó là API quản lý JSON-RPC đã thay thế việc đọc thông tin từ console.
Biểu tượng máy chủ là một tính năng nhỏ nhưng khó tính nhất trong Minecraft, bởi vì mọi lỗi đều trông giống nhau: không có biểu tượng, không có thông báo lỗi.
Ba yêu cầu, tất cả đều bắt buộc
- Chính xác 64×64 pixel. Không phải 63, không phải 128. Máy chủ không tự động thay đổi kích thước.
- Định dạng PNG. Phải là PNG thật, không phải JPG đổi tên.
- Tên là
server-icon.png, nằm ở thư mục gốc của máy chủ — cạnhserver.properties, không phải bên trong thư mục thế giới.
Chỉ cần sai một trong các điều kiện trên, máy chủ vẫn khởi động bình thường và hiển thị biểu tượng mặc định. Không có gì được ghi lại ở cấp độ mặc định.
Những điều khác cũng có thể gây lỗi
- PNG xen kẽ (Interlaced PNG). Một số trình chỉnh sửa lưu mặc định ở chế độ xen kẽ; trình đọc của Minecraft từ chối nó. Hãy xuất lại ở chế độ không xen kẽ.
- Độ sâu màu 16-bit. Lưu dưới dạng 8-bit mỗi kênh.
- Hồ sơ màu (Colour profiles). Hồ sơ ICC nhúng đôi khi làm trình phân tích gặp lỗi. Hãy loại bỏ siêu dữ liệu khi xuất.
- Độ trong suốt vẫn ổn và hiển thị chính xác trong danh sách máy chủ.
Máy khách lưu vào bộ nhớ đệm
Một khi máy khách đã thấy máy chủ của bạn, nó sẽ giữ biểu tượng đó. Thay đồ biểu tượng phía máy chủ sẽ không cập nhật các mục hiện có — người chơi phải xóa và thêm lại máy chủ, hoặc đợi bộ nhớ đệm hết hạn. Việc kiểm tra thay đổi biểu tượng từ máy khách của chính bạn sẽ khiến bạn nghĩ rằng nó không hoạt động, trong khi thực tế là có.
API quản lý
Các phiên bản máy chủ gần đây cung cấp một giao diện quản lý JSON-RPC, đây là phương pháp thay thế được chấp thuận cho việc phân tích đầu ra console hoặc gắn thêm plugin.
Bật nó trong server.properties:
management-server-enabled=true
management-server-host=localhost
management-server-port=25585Sau đó giao tiếp JSON-RPC qua cổng đó:
{ "jsonrpc": "2.0", "id": 1, "method": "minecraft:players" }Các phương thức bao gồm danh sách người chơi, trạng thái máy chủ, danh sách cho phép và cấm, gamerules, cài đặt, và một cặp lưu/dừng. Mỗi phương thức trả về JSON có cấu trúc thay vì một dòng văn bản mà bạn phải dùng regex.
Gắn nó vào localhost
Mặc định là localhost và nó nên giữ nguyên như vậy. Giao diện không được thiết kế để đối mặt với internet — bất cứ thứ gì tiếp cận nó đều có thể dừng máy chủ của bạn. Hãy để nó thông qua một đường hầm SSH hoặc một proxy ngược với xác thực nếu bạn cần truy cập từ xa, tuyệt đối không thay đổi máy chủ thành 0.0.0.0.
Tại sao điều này quan trọng
Các bảng điều khiển, bot Discord và trình giám sát thời gian hoạt động trước đây thường hoạt động bằng cách đọc nhật ký console hoặc sử dụng RCON, cả hai đều dễ bị lỗi. Một API có kiểu dữ liệu có nghĩa là tiện ích đếm số người chơi sẽ không bị hỏng khi định dạng dòng nhật ký thay đổi.
Chuyển đổi bất kỳ hình ảnh nào thành server-icon.png tuân thủ và duyệt các phương thức JSON-RPC trong Công cụ Biểu tượng Máy chủ & API.