Документация

Руководства и Гайды

Научитесь настраивать KellyMaster пошагово с нашими детальными руководствами.

1
Легко
5 мин

Базовая Установка

Научитесь устанавливать KellyMaster на ваш Minecraft сервер.

  1. 1 Скачайте файл KellyMaster.jar из нашего официального Discord.
  2. 2 Полностью остановите ваш Minecraft сервер перед установкой.
  3. 3 Поместите файл KellyMaster.jar в папку /plugins вашего сервера.
  4. 4 Запустите сервер. Плагин автоматически создаст файлы config.yml, whitelist.yml и messages.yml.
  5. 5 Остановите сервер снова для редактирования файлов конфигурации.
  6. 6 Настройте config.yml с вашими предпочтениями безопасности.
  7. 7 Настройте whitelist.yml с авторизованными операторами и их методами верификации.
  8. 8 Запустите сервер снова. KellyMaster будет активен и защищать ваш сервер.
2
Средне
10 мин

Настройка config.yml

Полное руководство по настройке всех опций файла config.yml.

  1. 1 Откройте файл plugins/KellyMaster/config.yml текстовым редактором.
  2. 2 В секции settings настройте язык (lang: en/es/ru/zh) для внешних уведомлений.
  3. 3 Настройте verification-timeout (время в секундах, рекомендуется: 60-120).
  4. 4 Настройте code-length (длина кода, рекомендуется: 6-8 символов).
  5. 5 Включите deop-on-disconnect: true для автоматического удаления OP при отключении.
  6. 6 В секции security настройте unauthorized-action (BAN/KICK/DEOP).
  7. 7 В blocked-commands добавьте команды для блокировки.
  8. 8 Сохраните файл и перезапустите сервер.
3
Средне
8 мин

Настройка whitelist.yml

Как добавить авторизованных операторов и настроить методы верификации.

  1. 1 Откройте файл plugins/KellyMaster/whitelist.yml текстовым редактором.
  2. 2 В секции setup-verification определите метод для каждого оператора.
  3. 3 В authorized-operators добавьте каждого оператора с идентификатором.
  4. 4 Для Discord ID: Включите Режим разработчика > ПКМ на профиле > Копировать ID.
  5. 5 Для Telegram Chat ID: Напишите @userinfobot в Telegram.
  6. 6 Вы можете иметь несколько операторов с разными методами верификации.
  7. 7 Игроки не в списке будут считаться неавторизованными.
  8. 8 Сохраните файл и перезапустите сервер.
4
Сложно
15 мин

Настройка Discord Bot

Настройте Discord бота для получения кодов верификации через DM.

  1. 1 Перейдите на Discord Developer Portal и войдите.
  2. 2 Нажмите New Application и дайте имя (например: KellyMaster Bot).
  3. 3 Перейдите в секцию Bot и нажмите Add Bot.
  4. 4 Нажмите Reset Token и скопируйте токен. НИКОГДА не делитесь этим токеном.
  5. 5 Включите Message Content Intent в Privileged Gateway Intents.
  6. 6 Перейдите в OAuth2 > URL Generator, выберите bot и права Send Messages.
  7. 7 Скопируйте URL и откройте в браузере для приглашения бота.
  8. 8 В whitelist.yml вставьте токен в discord.bot-token.
  9. 9 В setup-verification добавьте операторов с форматом: ИмяИгрока:Discord.
  10. 10 В authorized-operators добавьте: ИмяИгрока:ВАШ_DISCORD_ID.
  11. 11 Перезапустите сервер Minecraft.
5
Сложно
12 мин

Настройка Telegram Bot

Настройте Telegram как метод верификации через BotFather.

  1. 1 Откройте Telegram и найдите @BotFather.
  2. 2 Отправьте команду /newbot для создания нового бота.
  3. 3 Следуйте инструкциям: имя и уникальный username.
  4. 4 BotFather даст вам HTTP API токен. Скопируйте его.
  5. 5 В whitelist.yml вставьте токен в telegram.bot-token.
  6. 6 Найдите вашего бота в Telegram и отправьте /start.
  7. 7 Для Chat ID напишите @userinfobot или @RawDataBot.
  8. 8 В setup-verification добавьте: ИмяИгрока:Telegram.
  9. 9 В authorized-operators добавьте: ИмяИгрока:ВАШ_CHAT_ID.
  10. 10 Перезапустите сервер Minecraft.
6
Сложно
12 мин

Настройка Email SMTP

Используйте Gmail или другой SMTP сервер для отправки кодов.

  1. 1 Перейдите в настройки аккаунта Google: myaccount.google.com.
  2. 2 Перейдите в Безопасность и включите Двухэтапную аутентификацию.
  3. 3 В Двухэтапной аутентификации найдите Пароли приложений.
  4. 4 Создайте новый пароль приложения с именем KellyMaster.
  5. 5 Google сгенерирует 16-символьный пароль. Скопируйте его.
  6. 6 В config.yml настройте секцию email: enabled: true, smtp.host: smtp.gmail.com.
  7. 7 В smtp.user укажите ваш Gmail, в smtp.password - пароль приложения.
  8. 8 В whitelist.yml добавьте: ИмяИгрока:Gmail.
  9. 9 В authorized-operators добавьте: ИмяИгрока:ваш@gmail.com.
  10. 10 Перезапустите сервер.
7
Легко
5 мин

Настройка Discord Webhook

Получайте оповещения безопасности в канале Discord.

  1. 1 В Discord перейдите на сервер для получения оповещений.
  2. 2 ПКМ на канале > Редактировать канал.
  3. 3 Перейдите в Интеграции > Webhooks > Новый Webhook.
  4. 4 Дайте имя webhook (например: KellyMaster Alerts).
  5. 5 Нажмите Копировать URL Webhook.
  6. 6 В config.yml вставьте URL в webhook.url и включите webhook.enabled: true.
  7. 7 Настройте желаемые уведомления.
  8. 8 Перезапустите сервер.
8
Легко
5 мин

Интеграция с LuckPerms

Защитите опасные права с автоматической интеграцией LuckPerms.

  1. 1 Убедитесь что LuckPerms установлен на вашем сервере.
  2. 2 KellyMaster автоматически обнаружит LuckPerms при запуске.
  3. 3 Интеграция мониторит назначение опасных прав: *, essentials.*, luckperms.*.
  4. 4 Неавторизованные игроки с этими правами будут забанены.
  5. 5 Для просмотра событий проверьте логи сервера.
  6. 6 Дополнительная настройка не требуется.
Примеры

Примеры Конфигурации

config.yml 

# Общая Конфигурация
settings:
  lang: ru
  debug: false
  verification-timeout: 60
  code-length: 8
  deop-on-disconnect: true
  max-verification-attempts: 3

# Конфигурация Безопасности
security:
  unauthorized-action: BAN
  allow-non-whitelist-op: false
  log-ip-addresses: true

# Discord Webhook
webhook:
  enabled: true
  url: "https://discord.com/api/webhooks/..."
  notify-blocked-commands: true
  include-geolocation: true

whitelist.yml 

# Конфигурация Discord Bot
discord:
  enabled: true
  bot-token: "MTIzNDU2Nzg5..."

# Методы Верификации
setup-verification:
  - "SrCodex:Discord"
  - "Admin:Gmail"
  - "Moderador:Telegram"

# Авторизованные Операторы
authorized-operators:
  - "SrCodex:123456789012345678"
  - "Admin:admin@example.com"
  - "Moderador:987654321"
FAQ

Часто Задаваемые Вопросы

KellyMaster совместим со всеми версиями от 1.8 до 1.21.x. Работает со Spigot, Paper, Purpur.

Они не обязательны. Это опциональные зависимости с дополнительными функциями.

Оператор будет отключен от сервера и потеряет OP привилегии до правильной верификации.

Да, каждый оператор может иметь свой метод верификации в whitelist.yml.

Включите режим разработчика: Настройки > Расширенные. Затем ПКМ на профиле > Копировать ID.

Незначительно. KellyMaster оптимизирован для минимального влияния. Верификации асинхронны.

Да, работает с online-mode=false. Рекомендуем дополнительный плагин аутентификации.

Без ограничений. Добавляйте сколько нужно в whitelist.yml.

Нужна Помощь?

Присоединяйтесь к нашему Discord серверу для получения поддержки.

Получить Поддержку в Discord
KellyMaster KellyMaster