使用指南
输入玩家名,每行一个或用逗号分隔。选择离线模式(使用 OfflinePlayer UUID)或在线模式(通过 Mojang API 解析正版 UUID)。点击“生成”按钮,然后复制或下载生成的 whitelist.json。将 whitelist.json 放入服务器根目录(与 server.jar 同级),重启服务器即可生效。
在线UUID和离线UUID不可互换
在线模式的Java服务器使用Mojang服务返回的UUID来识别付费账户。离线模式的服务器会基于名称生成不同的UUID,因此即使用户名看起来正确,将离线白名单复制到在线服务器也可能失败。请将UUID方式与服务器认证模式匹配,如果模式更改,请重新生成文件。
安装文件而不丢失现有玩家
在替换whitelist.json之前,请停止服务器或使用其白名单命令。如果服务器已包含已批准的玩家,请合并这些条目,而不是盲目覆盖文件。保持有效的JSON,每个条目具有唯一的名称和UUID,然后启动服务器,如果您的服务器软件支持,请运行/whitelist reload。在编辑生产服务器之前请备份。
常见问题
如何使用 whitelist.json 生成器?
输入玩家名,选择离线或在线 UUID 模式,然后点击生成。复制或下载生成的 whitelist.json,放入服务器文件夹即可。
离线模式和在线模式有什么区别?
离线模式使用 OfflinePlayer: 前缀生成 UUID,适用于原版离线服务器。在线模式会查询 Mojang API 获取玩家的真实 UUID,这是在线模式服务器所必需的。
whitelist.json 应该放在哪里?
将 whitelist.json 放在服务器根目录(与 server.jar 同级),然后重启服务器。