PendingWhitelist — контроль заявок на вход в Minecraft
Вайтлист — штука полезная, но у неё есть один досадный минус: отказ происходит молча. Игрок постучался, получил «вас нет в списке» и ушёл. А вы даже не знаете, что кто-то пытался зайти. Именно эту слепую зону закрывает PendingWhitelist — небольшой плагин, который ведёт учёт всех отклонённых попыток входа и превращает их в удобный список для администрации.
Если вам нужен PendingWhitelist для Minecraft, чтобы наконец видеть, кто рвётся на сервер, — это дополнение работает поверх штатной системы вайтлиста и не ломает её. Обычный whitelist.json продолжает жить своей жизнью, а плагин просто фиксирует отказы в отдельном файле.
Как это работает на практике
Игрок стучится на сервер при включённом вайтлисте. Сервер его отклоняет, как и раньше. PendingWhitelist в этот момент записывает попытку: имя, UUID, количество попыток, время первой и последней попытки. Дальше персонал открывает /wl или /wl pl и видит список ожидающих. Игрока можно добавить в вайтлист прямо из GUI или командой /wl add <player>.
Для Bedrock-игроков, если установлен Floodgate, есть отдельное управление через /wlb add <player>. Bedrock-ники в интерфейсе показываются раньше Java-игроков — мелочь, но приятная, когда разгребаешь заявки пачками.
Интерфейс и уведомления
GUI «Add Players» устроен логично: сначала ожидающие, потом онлайн, потом те, кто уже заходил раньше. Левый клик — добавить одного, Shift-клик — добавить всех на странице. Во вкладке вайтлиста всё наоборот: левый клик убирает игрока, Shift-клик снимает всех со страницы.
Персонал с правом pendingwhitelist.admin получает уведомление, когда не-вайтлистного игрока отклонили. В уведомлении есть кликабельные действия — можно разобраться с заявкой прямо из чата. Есть и настраиваемый кулдаун, чтобы один настойчивый игрок не заспамил весь персонал.
Команды и конфигурация
/wl— открыть админ-панель/wl add— GUI добавления игроков/wl add <player...>— добавить игроков в вайтлист/wl list [page]— список игроков в вайтлисте/wl remove— GUI удаления/wl pl [page]— список ожидающих/wl rpl <player...>— убрать из ожидающих/wlb add <player...>— добавить Bedrock-игроков/wl on | off— включить или выключить вайтлист/wl reload— перезагрузить конфиг/wl version— проверить новую стабильную версию
В конфиге настраиваются отладочный лог, размер страницы в чате, уведомления о попытках входа, кулдаун уведомлений и автоматическая очистка старых заявок. После правок — /wl reload, и всё подхватится без рестарта.
Хранение и совместимость
Заявки лежат локально в plugins/PendingWhitelist/pending.json, отдельная база данных не нужна. Штатный вайтлист по-прежнему ведёт Paper в whitelist.json. Требуется Paper или Purpur, Minecraft 1.20.1+ и Java 21+. Опционально — Floodgate для Bedrock и SkinsRestorer для скинов в offline-режиме.
Кстати, если не хочется возиться с ручной установкой, лаунчер foxygame.net ставит PendingWhitelist в один клик и сам подтягивает свежую сборку под вашу версию Minecraft, так что конфиг и JAR всегда совпадают. Для тех, кто держит сервер на нескольких версиях, это заметно экономит время.
Как установить
Установка простая и не требует танцев с бубном:
- Остановите сервер.
- Положите JAR PendingWhitelist в папку plugins.
- Запустите сервер.
- При необходимости отредактируйте
plugins/PendingWhitelist/config.yml. - Выполните
/wlи проверьте панель.
Если хотите скачать PendingWhitelist заранее и разложить по серверам, убедитесь, что версия плагина совпадает с версией ядра — на 1.20.1 и новее проблем не будет. Плагин использует bStats для анонимной статистики, но её можно отключить через глобальный конфиг bStats.
Итог
PendingWhitelist не пытается заменить вайтлист — он делает его умнее. Вместо тихих отказов вы получаете журнал попыток, GUI для разбора заявок, уведомления с кликабельными действиями и поддержку Bedrock-игроков через Floodgate. Для серверов, где вайтлист включён постоянно, это маленькое, но очень практичное дополнение, которое закрывает давнюю слепую зону администрации.