ops.json, banned-players.json и другие списки

Служебные json-файлы сервера: операторы, баны, белый список и кэш ников — что в них лежит и когда их правят руками.

Обновлено 13 августа 2026 г.

Сервер хранит списки игроков в 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 постоянный, на пиратском вычисляется из ника — при смене online-mode все списки фактически перестают совпадать.

Смена online-mode

Это самая частая причина «пропали все операторы и приваты»: UUID игроков меняются, и старые записи больше ни к кому не относятся. Подробно — Пиратский вход.

Плагины

Плагины прав и банов хранят данные у себя (файлы или MySQL) и ванильные списки игнорируют — LuckPerms, Баны и муты.