IDoTheBlacklist

IDoTheBlacklist — это серверный мод для Minecraft, который значительно повышает безопасность вашего сервера за счёт интеграции с централизованной API системой чёрных списков. Мод автоматически проверяет каждого подключающегося игрока по базе данных проблемных пользователей и блокирует их вход при обнаружении в списке запрещённых лиц. Данная разработка является частью экосистемы инструментов IDoTheBot и IDoTheAPI, предназначенной для поддержания порядка и безопасности в сообществах Minecraft и связанных Discord серверах.

Система работы с чёрным списком

Чёрный список служит важнейшим инструментом для создания комфортной и безопасной игровой среды во всех сообществах, связанных с IDoTheBot. Вот как организована эта система:

• Централизованное API: Все данные базы запрещённых пользователей хранятся и управляются через единый API-эндпоинт. Это гарантирует, что все подключенные сервера получают самую актуальную информацию в реальном времени.
• Интеграция с IDoTheAPI: Система IDoTheAPI управляет обновлением чёрного списка. Уполномоченные пользователи могут добавлять или удалять записи из базы с помощью специальных команд в Discord сервере.
• Взаимодействие с Minecraft: Мод IDoTheBlacklist получает данные этого списка и моментально блокирует вход любому игроку, чьи данные обнаруживаются в этой базе.

Прозрачность и коллективное управление

Ключевой особенностью системы IDoTheBlacklist является принцип полной прозрачности и совместного администрирования:

• Открытый исходный код: Поскольку код проекта открыт, любой желающий может изучить механизмы работы системы банов, что способствует постоянному совершенствованию сообществом.
• Уполномоченные пользователи: Конкретные пользователи Discord получают права на изменение чёрного списка. При этом сам список этих пользователей является открытым для всеобщего обозрения, обеспечивая подотчётность действий.
• Сообщество контроля: Любые изменения в функционале мода, особенно касающиеся системы банов, должны проходить обязательное рассмотрение и одобрение @IDoTheHax в Discord, прежде чем будут внедрены. Это гарантирует соответствие всех нововведений стандартам сообщества.

Возможности

• Автоматическая проверка: При подключении каждого игрока автоматически проводится сверка с централизованной базой запрещённых пользователей.
• Система сетевого управления банами: Использование внешнего API позволяет создать единую систему банов, действующую на всех подключенных серверах.
• Оповещение операторов: Администраторы сервера получают уведомления о результатах проверки и принятых действиях.
• Настройки конфигурации: Безопасное хранение API-ключа для доступа к системе чёрных списков.
• Кастомные сообщения: Для заблокированных игроков отображается понятное сообщение с причиной бана и временными отметками.
• Система логов: Записывает все операции проверок, ответы API и ошибки для последующего анализа.

Установка и настройка

Необходимые требования

• Minecraft сервер на Fabric
• Установленный Fabric Loader
• Полученный API-ключ от сервера IDoTheHax в Discord

Процесс установки

1. Скачивание мода: Загрузите последнюю версию IDoTheBlacklist из доступных источников распространения (GitHub Releases или другие репозитории).
2. Размещение файла: Поместите скачанный файл .jar в папку mods вашего сервера Minecraft.
   • При отсутствии папки mods создайте её в директории с файлом minecraft_server.jar.
3. Запуск сервера: Запустите ваш Minecraft сервер. Fabric Loader автоматически загрузит установленные моды, включая IDoTheBlacklist.

Использование

Настройка API-ключа

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

1. Вход с правами оператора: Присоединитесь к серверу Minecraft с правами оператора (уровень доступа 4 для выполнения команд /setapikey).
2. Ввод команды: Используйте команду /setapikey с указанием вашего API-ключа:

   /setapikey <ваш_api_ключ>

   • Замените <ваш_api_ключ> на ключ, полученный от сервера IDoTheHax в Discord.
3. Подтверждение: Система отобразит сообщение об успешной настройке API-ключа.
   • Ключ сохраняется в файле config/idotheblacklist.json на сервере.

Проверки чёрного списка

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

Настройки конфигурации

Файл конфигурации IDoTheBlacklist расположен по адресу config/idotheblacklist.json.

Параметры idotheblacklist.json

• api_key: Ваш API-ключ, полученный от сервера IDoTheHax в Discord. Настраивается через команду /setapikey или ручным редактированием файла. Сохраняйте этот ключ в строжайшем секрете!

Решение проблем

API-ключ не установлен

• При отсутствии настроенного API-ключа мод пропускает проверки и позволяет игрокам подключиться.
• Операторы получают предупреждение о необходимости настройки ключа API.
• Решение: установите API-ключ командой /setapikey согласно инструкциям раздела Использование.

Ошибки подключения к API

• При возникновении проблем с соединением к внешнему API мод прекращает проверку и разрешает подключение игрокам.
• Операторы оповещаются о сбое проверки чёрного списка.
• Решение: проверьте логи сервера для детальной информации об ошибке. Убедитесь, что сервер имеет доступ в интернет и может соединиться с API-эндпоинтом.

Невалидный API-ключ

• Если система API отклоняет запрос из-за ошибочного ключа, проверки не проводятся, а игроки могут подключаться беспрепятственно.
• Операторам отправляется сообщение о недействительности API-ключа.
• Решение: убедитесь, что ключ создан правильно через Discord интерфейс и корректно введён командой /setapikey.

Игрок из чёрного списка подсоединяется

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

Решение технических вопросов

Для получения помощи, консультаций или сообщений о возникающих ошибках обращайтесь на сервер IDoTheHax в Discord.