whitelist.json 和 ops.json 保存“名称/UUID”对。online-mode=false 的服务器上 UUID 是确定的(“OfflinePlayer:名称”的 MD5),可在此离线计算;在线服务器的 UUID 来自 Mojang,而本工具不进行任何网络请求,因此需要您自行提供。
如何使用该工具
选择要生成的文件:whitelist.json 或 ops.json。
每行一名玩家:“名称”(启用选项时自动计算离线 UUID)或“名称 UUID”。
生成 ops.json 时设置管理员等级(1–4),并修正列出的错误。
停止服务器,替换服务器根目录中的文件后重启(或使用 /whitelist reload)。
如何获取玩家的官方 UUID
最简单的办法是让服务器代劳:online-mode=true 时,/whitelist add 名称 和 /op 名称 会把官方 UUID 写入文件。否则可从服务器日志(登录时的“UUID of player … is …”行)或任意 UUID 查询服务获取,并粘贴到名称之后。官方 UUID 由 Mojang 分配,无法计算。
[
{ "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5", "name": "Notch" }
]常见问题
- 为什么离线 UUID 与官方 UUID 不同?
- online-mode=false 时服务器仅根据名称推导 UUID。世界和背包数据都绑定该 UUID:切换 online-mode 会改变玩家身份,数据也随之不同。
- 管理员等级是什么意思?
- 1 到 4 决定可用命令(4 为全部权限,包括 /stop)。/op 使用 op-permission-level(默认 4),这里可逐个玩家设置等级。bypassesPlayerLimit 允许服务器满员时仍可加入。

