Guides / Server & Performance

server-icon.png：精确要求与无人问津的管理API

64x64，PNG，位于服务器根目录——三者中任何一项出错，图标都会悄无声息地消失。此外，还有取代屏幕抓取控制台的JSON-RPC管理API。

2026-06-14

服务器图标是Minecraft中最不容出错的小功能，因为所有的失败模式都表现一致：没有图标，也没有错误提示。

三项强制要求

1. 精确的64×64像素。 不能是63，也不能是128。服务器不会自动调整大小。
2. PNG格式。 必须是真正的PNG，而不是重命名的JPG。
3. 命名为server-icon.png，位于服务器根目录——与server.properties并列，而不是在世界文件夹内。

只要其中一项出错，服务器就会正常启动并显示默认图标。在默认日志级别下，不会有任何记录。

其他可能导致其失效的原因

• 隔行扫描PNG (Interlaced PNG)。 某些编辑器默认保存为隔行扫描格式；Minecraft的读取器会拒绝这种格式。请重新导出为非隔行扫描格式。
• 16位颜色深度。 请保存为每通道8位。
• 颜色配置文件。 嵌入的ICC配置文件有时会干扰解析器。导出时请剥离元数据。
• 透明度正常，并在服务器列表中正确渲染。

客户端会缓存图标

一旦客户端看到您的服务器，它就会缓存图标。在服务器端更改图标不会更新现有条目——玩家必须删除并重新添加服务器，或者等待缓存过期。从您自己的客户端测试图标更改时，可能会让您误以为没有成功，但实际上已经成功了。

管理API

最近的服务器版本公开了一个 JSON-RPC 管理接口，这是官方认可的替代解析控制台输出或附加插件的方法。

在server.properties中启用它：

management-server-enabled=true
management-server-host=localhost
management-server-port=25585

然后通过该端口进行JSON-RPC通信：

{ "jsonrpc": "2.0", "id": 1, "method": "minecraft:players" }

这些方法涵盖了玩家列表、服务器状态、白名单和封禁列表、游戏规则、设置以及保存/停止操作。每个方法都返回结构化的JSON，而不是您需要使用正则表达式解析的文本行。

绑定到localhost

默认是localhost，并且应该保持不变。该接口不打算面向互联网——任何能够访问它的人都可以停止您的服务器。如果您需要远程访问，请通过SSH隧道或带有身份验证的反向代理来暴露它，切勿将主机更改为0.0.0.0。

为什么它很重要

仪表盘、Discord机器人和正常运行时间监控器历来通过读取控制台日志或使用RCON来工作，但这两种方式都很脆弱。类型化的API意味着当日志行格式发生变化时，玩家数量小部件不会崩溃。

将任何图像转换为符合要求的server-icon.png，并在服务器图标与API工具中浏览JSON-RPC方法。

服务器图标与 API 工具 →