Skip to content
托管 · 服务器配置

ops.json、banned-players.json 及其他列表

服务器服务用 JSON 文件:管理员、封禁、白名单和昵称缓存——它们包含什么,以及何时需要手动编辑。

更新于 2026年8月13日

服务器将玩家列表以 JSON 文件的形式存储在根目录中。它们通常通过命令管理,但有时直接打开文件会更快。

文件内容
ops.json管理员、权限等级、bypassesPlayerLimit
whitelist.json白名单
banned-players.json按昵称和 UUID 封禁
banned-ips.json按 IP 封禁
usercache.json昵称 → UUID 映射缓存

ops.json 示例

[
  {
    "uuid": "8a1b...",
    "name": "Steve",
    "level": 4,
    "bypassesPlayerLimit": true
  }
]

编辑规则

  • 仅在服务器停止时操作。 运行中的服务器会将列表保存在内存中,并在关闭时覆盖文件——您的修改将会丢失。
  • 格式非常严格:多一个逗号就会破坏整个文件,服务器启动时管理员列表将为空。
  • UUID 必须与昵称匹配。在正版服务器上,UUID 是固定的;在昵称登录的服务器上,UUID 由昵称计算得出——当您更改 online-mode 时,所有列表实际上都会失效。

更改 online-mode

这是“所有管理员和领地都消失了”的最常见原因:玩家 UUID 发生变化,旧条目不再对应任何人。详情请参阅昵称登录。

插件

权限和封禁插件会单独存储自己的数据(文件或 MySQL),并忽略原版列表——LuckPerms、封禁与禁言。

Minecraft 托管您离线时服务器仍在运行创建服务器