Генератор whitelist.json для сервера Minecraft

Создайте whitelist.json или список команд /whitelist add по списку никнеймов. Поддержка offline-режима с точным расчётом UUID по алгоритму сервера.

Игроки

Рекомендуемый способ: команды

Для online-режима сервер сам находит правильный UUID через Mojang — используйте команды, это надёжнее ручного JSON.

/whitelist add

      

whitelist.json

whitelist.json

      

Где держать сервер

Мы сравнили хостинги Minecraft по единственной величине, которая есть у всех и значит одно и то же, — цене за гигабайт памяти. Разброс большой: от 69 до 248 ₽ за гигабайт при одинаковых по сути тарифах.

Сравнение хостингов · сколько памяти нужно вашей сборке

whitelist.json Minecraft — как устроен и как заполнить

Как пользоваться

  1. Введите ники игроков — по одному на строку.
  2. Выберите режим сервера — online-mode (лицензионный, стандартный) или offline-mode («крякнутый»).
  3. Для online-режима используйте команды /whitelist add — сервер сам получит правильный UUID от Mojang в момент выполнения.
  4. Для offline-режима скачайте готовый whitelist.json — UUID уже рассчитан тем же алгоритмом, что использует сам сервер.

Почему для online-режима лучше команды, а не готовый JSON

У каждого лицензионного аккаунта Mojang/Microsoft есть постоянный UUID, который сайт не может узнать без обращения к серверам Mojang в момент выполнения (в этом браузерном инструменте такого обращения нет). Команда /whitelist add ник, выполненная на самом сервере, всегда получает верный актуальный UUID напрямую. Если очень нужен готовый JSON с реальными UUID — сначала дайте игрокам зайти на сервер без вайтлиста хотя бы раз, тогда их UUID появится в файле usercache.json, откуда его можно скопировать.

Как считается offline UUID

Для offline-режима сервер вычисляет UUID версии 3 из MD5-хэша строки OfflinePlayer:<ник> — это детерминированный алгоритм, дающий всегда одинаковый результат для одного ника. Именно так его считает и сам сервер Minecraft (Bukkit/Spigot/Paper/Vanilla), поэтому расчёт в этом инструменте точно совпадёт с тем, что сервер сгенерирует сам.

Частые вопросы

Что делать, если игрок сменил ник?

В online-режиме UUID привязан к аккаунту и не меняется при смене ника — достаточно обновить запись командой /whitelist add новый_ник. В offline-режиме смена ника создаёт полностью новый UUID, и старые данные игрока (инвентарь, прогресс) окажутся привязаны к другому идентификатору.

Нужно ли перезапускать сервер после редактирования whitelist.json вручную?

Нет, достаточно выполнить команду /whitelist reload, чтобы сервер перечитал файл без полного перезапуска.

Что если whitelist.json заполнен неправильно?

Игроки не смогут подключиться с ошибкой доступа. Проверьте, что JSON синтаксически корректен (нет лишних запятых) и что UUID соответствуют режиму сервера (online/offline).