MCTOOLBOX
MC ToolboxMC TOOLBOX

服务器和文件

whitelist.json 生成器

构建一个 Java 版 whitelist.json 数组,包含玩家名称和 UUID。为在线模式解析 Mojang 档案,或生成官方的 OfflinePlayer UUID。

玩家

在 server.properties 中启用 white-list=true,将 whitelist.json 放在服务器根目录,然后重启或运行 /whitelist reload。

已生成 whitelist.json

[
  {
    "name": "Steve",
    "uuid": "5627dd98-e6be-3c21-b8a8-e92344183641"
  },
  {
    "name": "Alex",
    "uuid": "36532b5e-c442-3dbb-a24c-c7e55d0f979a"
  },
  {
    "name": "Notch",
    "uuid": "b50ad385-829d-3141-a216-7e7d7539ba7f"
  }
]

使用指南

输入玩家名,每行一个或用逗号分隔。选择离线模式(使用 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 同级),然后重启服务器。