База знаний / Ванильные файлы сервера

🛠️ Настройка сервера

Ванильные файлы сервера

Помимо server.properties ванильный Minecraft держит в корне несколько служебных файлов: EULA, операторы, whitelist и баны. Это данные сервера, обычно изменяемые уже командами, а не руками.

Править JSON на работающем сервере рискованно − процесс может перезаписать файл. Надёжнее: остановить сервер, изменить, запустить; либо менять через команды и reload, где он есть.

eula.txt

Согласие с EULA Minecraft. Без eula=true сервер не стартует.

eula=true

Пошагово: как принять EULA.

ops.json

Список операторов. В ванили это простая система прав и возможность обойти лимит слотов. Управляйте командами op / deop − как выдать оператора.

Поля записи:

  • uuid − UUID игрока (с дефисами);
  • name − ник;
  • level − уровень OP от 1 до 4 (см. ниже);
  • bypassesPlayerLimit − true/false; может ли зайти при полном max-players.
# ops.json (пример)
[
    {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "PlayerName",
    "level": 4,
    "bypassesPlayerLimit": false
    }
]

Уровни прав:

  • 1 − обход защиты спавна, к дополнительным командам доступа нет;
  • 2 − читы мира: /give, /gamemode, /tp, командные блоки и другие команды;
  • 3 − модерация: /kick, /ban, /op, /deop, управление whitelist и другие;
  • 4 − полный доступ, включая /stop.

Команда /op ставит всем один и тот же уровень из op-permission-level в server.properties (часто 4). Разные уровни у разных людей можно настроить ручной правкой файла или через плагин прав (LuckPerms и т.п.).

whitelist.json

Кого пускать при включённом whitelist. Сам переключатель − white-list=true в server.properties (и опционально enforce-whitelist).

  • uuid − UUID игрока;
  • name − ник на момент добавления.
# whitelist.json (пример)
[
    {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "PlayerName"
    }
]

Добавляйте через whitelist add. После ручной правки файла на запущенном сервере выполните whitelist reload.

banned-players.json

Баны по аккаунту (UUID). Поля типичной записи:

  • uuid, name;
  • created − когда выдан бан;
  • source − кто/что забанило;
  • expires − срок или forever;
  • reason − причина.
# banned-players.json (пример)
[
    {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "PlayerName",
    "created": "2026-09-09 12:00:00 +0300",
    "expires": "forever",
    "reason": "Banned by an operator.",
    "source": "ServerConsole"
    }
]

Команды: ban / pardon. Подробнее: как забанить / разбанить игроков.

banned-ips.json

Баны по IP. Поля похожи, вместо UUID − ip (IPv4/IPv6).

# banned-ips.json (пример)
[
  {
    "ip": "192.168.1.100",
    "created": "2026-09-09 12:00:00 +0300",
    "source": "(Unknown)",
    "expires": "forever",
    "reason": "Banned by an operator."
  }
]

Команды: ban-ip / pardon-ip.

Бан по IP грубее бана аккаунта: заденет всех с этого адреса (NAT, семья, VPN). Используйте осознанно.

Что не стоит править руками без нужды

  • JSON банов и OP − легко сломать синтаксис или получить рассинхрон с онлайном.
  • UUID всегда в формате с дефисами (8-4-4-4-12).
  • На публичном сервере права и баны удобнее вести плагинами, а ванильные файлы оставить на запас.

Связанные конфиги

Полная документация

Описание структур файлов: Vanilla data files − PaperMC Docs.