Скачать Плагин BetterNickBlocker | Запрети заходить игрокам с определённым никнеймом 1.0-SNAPSHOT в Майнкрафт
BetterNickBlocker | Запрети заходить игрокам с определённым никнеймом 1.0-SNAPSHOT

Плагин BetterNickBlocker | Запрети заходить игрокам с определённым никнеймом 1.0-SNAPSHOT 1.0 snapshot


Для версий
  1. 1.12.+
  2. 1.13.+
  3. 1.14.+
  4. 1.15.+
BetterNickBlocker — небольшой серверный плагин, который проверяет ник игрока во время входа на сервер. Его задача — сравнить имя с настроенным списком перед подключением. Если имя содержит фрагмент из списка запретов, подключение прерывается с указанной в настройках причиной. На этой странице хранится сборка 1.0-SNAPSHOT.

На странице доступен один файл BetterNickBlocker.jar размером 3 100 байт. Перед установкой важно понимать границы проверки: структура файла и его настройки изучены без запуска Minecraft-сервера, поэтому работу на конкретном ядре и версии игры нужно проверять самостоятельно на отдельной копии сервера.



Что делает BetterNickBlocker​


BetterNickBlocker работает как простой плагин блокировки ников Minecraft. При попытке подключения он получает имя игрока, читает список blocked из файла config.yml и ищет в нике запрещённые фрагменты.

Например, владелец сервера может добавить в список нежелательную приписку, название постороннего проекта или другое сочетание символов, которое не должно встречаться в именах игроков. Если такой фрагмент найден, игрок отключается с причиной, заданной в настройке reason.

Плагин проверяет именно фрагменты, а не только полное совпадение ника. Поэтому слишком короткое или распространённое сочетание может случайно затронуть обычные имена. После изменения списка обязательно проведите тест и убедитесь, что запрет ников на сервере Minecraft не мешает входу разрешённых игроков.

Уведомление о попытке входа​


Пользователь с правом BetterNickBlocker.notify может получить уведомление, когда плагин обнаружит запрещённый фрагмент в нике. Текст такого сообщения находится в параметре messages.notify.

Это позволяет администратору увидеть факт срабатывания проверки, не просматривая вручную все подключения. Получателем уведомления должен быть только тот игрок или сотрудник, которому действительно выдано соответствующее право.

Обход проверки для выбранных пользователей​


Право BetterNickBlocker.bypass разрешает пройти проверку даже при наличии запрещённого фрагмента в нике. Оно может понадобиться только для контролируемого теста или для заранее выбранной учётной записи.

Не выдавайте обход всем игрокам и не добавляйте его в общую группу по умолчанию. Иначе блокировщик никнеймов Bukkit будет загружен, но его основная проверка потеряет смысл для пользователей с этим разрешением.



Подтверждённые сведения о файле​


Внутри BetterNickBlocker.jar находится файл plugin.yml со следующими данными:

  • имя плагина: BetterNickBlocker;
  • версия: 1.0-SNAPSHOT;
  • главный класс: BetterNickBlocker.Main.

В plugin.yml не объявлены команды, автор, сайт, зависимости и параметр api-version. Поэтому для настройки не нужно искать неизвестные команды BetterNickBlocker: подтверждённая конфигурация выполняется через config.yml и права доступа.

Статическая проверка скомпилированных классов подтверждает обработчик входа игрока, чтение списка blocked, поиск запрещённых фрагментов, отключение с настраиваемой причиной, уведомление по праву BetterNickBlocker.notify и обход по праву BetterNickBlocker.bypass.

SHA-256 файла:

d604b04cb4a4d198c1cd1da14ba62b96e42a24548003fd7e84a5d0abf59d59e7

Контрольная сумма помогает сравнить скачанный файл с копией, которая хранится на странице. Совпадение SHA-256 не подтверждает совместимость с вашим сервером и не заменяет пробный запуск.

Что означает версия 1.0-SNAPSHOT​


Обозначение 1.0-SNAPSHOT указывает на сборку с меткой SNAPSHOT. Само название версии не доказывает, что плагин обязательно работает плохо, но такую сборку нельзя устанавливать на основной сервер без предварительной проверки.

Отсутствие api-version также требует внимания. На некоторых серверных ядрах плагин может загрузиться с предупреждением, а на других возможна ошибка, связанная с используемым API или устройством конкретной версии сервера. Точный результат можно узнать только при запуске на вашей тестовой сборке.

Какие версии указаны в карточке​


Карточка ресурса помечает Minecraft 1.12+, 1.13+, 1.14+ и 1.15+. Эти отметки не равны подтверждённой проверке запуска.

Выполнен разбор структуры JAR, файлов plugin.yml и config.yml, а также строк скомпилированных классов. Фактический запуск сервера на перечисленных версиях не проводился. BetterNickBlocker нельзя заранее считать совместимым со всеми Bukkit-, Spigot- или Paper-серверами.



Как установить BetterNickBlocker​


Установку лучше проводить вместе со взрослым или администратором, который умеет работать с файлами сервера. Не экспериментируйте на основном проекте, где уже играют люди.

  1. Создайте резервную копию. Сохраните папку сервера, миры, настройки, список плагинов и другие важные данные. Проверьте, что копия находится отдельно от изменяемой сборки.
  2. Подготовьте тестовый сервер. Используйте копию с тем же ядром и близкими настройками. Во время установки сервер должен быть полностью остановлен.
  3. Скачайте BetterNickBlocker. На странице хранится единственный файл BetterNickBlocker.jar размером 3 100 байт. При необходимости сравните его SHA-256 с указанной выше суммой.
  4. Поместите JAR в папку plugins. Не распаковывайте архив и не переносите внутрь папки отдельные классы или файлы.
  5. Запустите тестовый сервер. Следите за консолью и журналом запуска. Плагин должен попытаться загрузиться и создать свою папку с конфигурацией.
  6. Снова полностью остановите сервер. Не редактируйте конфигурацию во время первого запуска.
  7. Откройте config.yml. Замените демонстрационные фрагменты в blocked собственным списком, настройте причину отключения и текст уведомления.
  8. Найдите placeholder @YOURSERVER. Замените его названием своего проекта или нейтральным текстом. Не оставляйте служебную заготовку в сообщении для игроков.
  9. Запустите сервер повторно. Проверьте консоль на ошибки загрузки и чтения YAML.
  10. Проведите тест двумя аккаунтами. Один аккаунт используется для наблюдения и проверки уведомлений, второй — для контролируемой попытки входа с тестовым фрагментом.

Не передавайте незнакомым людям пароли, данные тестовых аккаунтов, полный адрес закрытого сервера или другие сведения для доступа. Для проверки не требуется сообщать кому-либо свои учётные данные.



Как настроить BetterNickBlocker config.yml​


Файл BetterNickBlocker config.yml содержит список проверяемых фрагментов, тексты сообщений и названия прав. Редактируйте только существующие параметры. Не добавляйте вымышленные поля в надежде включить команды или другие функции.

Перед изменением сохраните исходный config.yml под другим именем или скопируйте всю папку плагина. Тогда при ошибке можно будет быстро сравнить настройки или вернуть рабочий вариант.

Настройка blocked​


blocked — это список запрещённых фрагментов, которые плагин ищет в нике подключающегося игрока.

В исходной конфигурации находятся только примеры. Их нужно удалить или заменить собственными значениями. Если оставить демонстрационный список без проверки, плагин может блокировать не те имена, которые требуются вашему серверу.

При составлении списка соблюдайте простые правила:

  • добавляйте только понятные и действительно нужные фрагменты;
  • не используйте слишком короткие сочетания без тестирования;
  • проверяйте, не встречается ли фрагмент внутри обычных никнеймов;
  • после каждого крупного изменения повторяйте вход с разрешённым и запрещённым именем;
  • не публикуйте реальные никнеймы игроков в открытом обсуждении без необходимости.

Если плагин пропускает имя, сначала сравните написание тестового фрагмента со значением в blocked. Не делайте вывод о регистре букв или других правилах сравнения без отдельной проверки на своём сервере.

Настройка reason​


reason — причина отключения, которую увидит игрок, если его ник содержит значение из blocked и у него нет права обхода.

Сообщение должно быть коротким и понятным. Объясните, что вход отклонён из-за имени, и предложите использовать ник без запрещённого фрагмента. Не добавляйте угрозы, оскорбления или обещания автоматической разблокировки.

После редактирования проверьте, что текст полностью отображается на экране отключения и не содержит оставшийся placeholder @YOURSERVER.

Настройка messages.notify​


messages.notify задаёт текст уведомления о попытке входа с запрещённым фрагментом. Его получают пользователи, которым выдано право уведомления.

Сообщение должно помогать администратору понять, что проверка сработала. Не добавляйте в него пароли, адреса панелей управления или другие закрытые данные. Если в исходной строке есть @YOURSERVER, замените этот placeholder перед использованием.

Настройка perms.notify​


perms.notify хранит название права, которое используется для получения уведомлений. Подтверждённое право — BetterNickBlocker.notify.

Выдавайте его только администраторам или модераторам, которым нужно видеть попытки входа. Если уведомление не появляется, проверьте точное написание права, его регистр и группу, к которой относится тестовый аккаунт.

Настройка perms.bypass​


perms.bypass хранит название права для обхода проверки. Подтверждённый узел — BetterNickBlocker.bypass.

Аккаунт с этим правом не должен использоваться для первого теста блокировки, иначе вход может пройти и создастся впечатление, что список blocked не работает. Сначала проверяйте запрет без обхода, а затем отдельно выдавайте BetterNickBlocker.bypass тому же тестовому пользователю.



Безопасный тест запрета ников​


Проверять настройку нужно на копии сервера. Для сценария достаточно двух собственных тестовых аккаунтов, доступ к которым не передаётся другим людям.

Первый аккаунт: наблюдение​


Первому аккаунту выдайте право BetterNickBlocker.notify, но не выдавайте BetterNickBlocker.bypass. Подключитесь к тестовому серверу и оставьте этот аккаунт в игре, чтобы увидеть уведомление.

Убедитесь, что выбранный способ управления правами действительно применил нужный узел. BetterNickBlocker не объявляет собственных команд, поэтому выдача разрешений зависит от уже используемой на сервере системы прав.

Второй аккаунт: проверка блокировки​


Добавьте в blocked заранее выбранный тестовый фрагмент, который входит в ник второго аккаунта и не затрагивает имя первого. Полностью перезапустите тестовый сервер после сохранения конфигурации.

Попробуйте подключиться вторым аккаунтом. Ожидаемый результат состоит из двух отдельных событий:

  • второй аккаунт отключается и видит текст из reason;
  • первый аккаунт получает сообщение из messages.notify.

После этого временно выдайте второму аккаунту право BetterNickBlocker.bypass и повторите вход. Такой тест позволяет отдельно проверить обход. Закончив проверку, уберите временное право и тестовый фрагмент, если они больше не нужны.

Затем попробуйте подключиться с обычным ником, который не содержит запрещённого сочетания. Это важно для проверки ложных срабатываний.



Что делать, если BetterNickBlocker не работает​


Плагин не появился после запуска​


Сначала полностью остановите сервер и проверьте, что BetterNickBlocker.jar лежит непосредственно в папке plugins, а не в архиве или дополнительной вложенной папке.

После запуска изучите консоль с самого начала. Найдите строки с названием BetterNickBlocker, главным классом BetterNickBlocker.Main или сообщением об ошибке загрузки. Не скрывайте первые строки исключения при обращении к своему администратору: именно там обычно находится причина остановки загрузки.

Также сравните размер и SHA-256 файла с данными на странице. Если они отличаются, вернитесь к сохранённой копии или повторно получите файл со страницы ресурса.

Если сервер сообщает о несовместимом API, отсутствующем классе или другой ошибке запуска, не пытайтесь исправлять скомпилированный JAR вручную. Верните резервную копию и считайте эту сборку непроверенной для выбранного ядра.

Сервер сообщает об ошибке config.yml​


Ошибка YAML часто появляется после случайного изменения структуры файла. Сравните проблемный вариант с сохранённой исходной конфигурацией.

Проверьте:

  • сохранены ли названия blocked, reason, messages.notify, perms.notify и perms.bypass;
  • не удалены ли нужные двоеточия;
  • не нарушены ли отступы у вложенных параметров;
  • не превратился ли список blocked в одну случайную строку;
  • не добавлены ли неизвестные поля или лишние символы;
  • сохранён ли файл как обычный текст.

При сомнении верните исходный config.yml, измените только один параметр и снова запустите тестовый сервер. Так легче найти конкретную строку, после которой появилась ошибка.

Запрещённый ник проходит проверку​


Убедитесь, что тестовый фрагмент действительно находится в blocked, а сервер был полностью перезапущен после изменения файла.

Проверьте, не выдано ли тестовому аккаунту право BetterNickBlocker.bypass напрямую, через группу или через более широкое разрешение вашей системы прав. Для первого теста обход должен отсутствовать.

Если конфигурация читается без ошибок, но результат остаётся непонятным, создайте минимальный список из одного контролируемого фрагмента и повторите проверку на отдельном аккаунте.

Обычные игроки блокируются случайно​


Причина обычно находится в слишком широком значении blocked. Посмотрите, какая часть обычного ника совпала с запрещённым фрагментом.

Удалите или уточните спорное значение, перезапустите тестовый сервер и снова проверьте несколько разрешённых имён. Не переносите изменённый список на основной сервер, пока ложные срабатывания не исключены в тестовой среде.

Уведомление не приходит​


Проверьте параметр perms.notify и точное право BetterNickBlocker.notify. Убедитесь, что аккаунт уже находится на сервере во время тестовой попытки входа.

Если право выдаётся через отдельный плагин управления разрешениями, проверьте нужную группу, контекст сервера и сохранение изменений. BetterNickBlocker только проверяет указанное право и не управляет группами самостоятельно.

Обход не срабатывает​


Сравните значение perms.bypass с узлом BetterNickBlocker.bypass. Проверьте регистр букв и убедитесь, что разрешение выдано именно тестовому аккаунту.

Сначала подтвердите, что без обхода пользователь действительно отключается. Затем добавьте право и повторите тот же вход. Такое разделение помогает не перепутать ошибку списка blocked с ошибкой настройки разрешений.



Как удалить плагин и выполнить откат​


Если BetterNickBlocker не загрузился, вызвал ошибку или не подходит выбранной версии сервера, вернитесь к состоянию до установки.

  1. Полностью остановите тестовый сервер.
  2. Сохраните копию текущих журналов, если они нужны для разбора ошибки.
  3. Убедитесь, что исходная резервная копия сервера доступна и не повреждена.
  4. Удалите BetterNickBlocker.jar из папки plugins.
  5. Удалите созданную папку BetterNickBlocker только после сохранения её резервной копии.
  6. Верните прежние настройки сервера или восстановите подготовленную копию.
  7. Запустите сервер и проверьте консоль, вход игроков и работу остальных плагинов.

Не удаляйте JAR и папку во время работающего сервера. Не используйте основной сервер как место для экспериментов с конфигурацией, правами или неподтверждённой совместимостью.



Что важно проверить перед использованием​


BetterNickBlocker подтверждён как небольшой обработчик входа с перечнем запрещённых фрагментов, настраиваемой причиной отключения, уведомлением и правом обхода. Файл не объявляет команд, сайта, автора, зависимостей или api-version.

Карточка указывает Minecraft 1.12+, 1.13+, 1.14+ и 1.15+, но реальный запуск на этих версиях в рамках проверки не выполнялся. Поэтому перед тем как использовать или скачать BetterNickBlocker для действующего проекта, подготовьте резервную копию, установите BetterNickBlocker.jar на тестовый сервер, замените примеры в blocked, исправьте @YOURSERVER и проверьте блокировку двумя собственными аккаунтами.

Все изменения ребёнку следует проводить вместе со взрослым или администратором сервера. Никнеймы, пароли, адрес закрытого сервера и доступ к панели управления нельзя сообщать незнакомым людям.
Автор
McDawn
Скачивания
63
Показов
479
Первый выпуск
Обновление

Оценки

0.00 звёзд 0 оценок

Другие ресурсы пользователя McDawn

Похожие ресурсы (Если ресурс не уникален, он будет удален после публикации)

AntiNetherRoof - запрети забираться выше бедрока в аду IskanderBro
Этот плагин не позволяет игрокам в аду выбраться на вверх бедрока.
254
2,320