OrdaVK Manager
OrdaVK Manager — это VK-система управления Minecraft-сервером, которая превращает обычные беседы VK в полноценную staff-панель: управление администрацией, помощь игрокам, аудит опасных действий и логирование событий сервера.

Это не просто бот для сообщений.
Это VK-native control panel для Minecraft-сервера.
OrdaVK Manager — это не просто мост между Minecraft и VK. Это система управления сервером, staff-командой и поддержкой игроков прямо через VK.

Что умеет OrdaVK Manager
Управление сервером из VK

• !online — кто онлайн
• !status — статус сервера
• !check <ник> — информация об игроке
• !kick <ник> <причина>
• !mute <ник> <время> <причина>
• !ban <ник> [время] <причина>
• !cmd <команда> — безопасный мост команд в консоль
  

Управление staff-командой

• !admins
• !admin info <vk_id>
• !admin add <vk_id> <ник> <роль>
• !admin set <vk_id> <роль>
• !admin remove <vk_id>
  

Поддержка игроков через VK

• /helpop <вопрос> — игрок создаёт обращение
• /report <игрок> <причина> — отправка жалобы
• !list — список обращений
• !info <id> — подробности тикета
• !r <id> <ответ> — ответ игроку из VK
• !close <id> — закрытие обращения
  

Умная доставка ответов

• если игрок онлайн — ответ приходит сразу
• если игрок оффлайн — ответ сохраняется и приходит при следующем входе
  

Логи и аудит

• вход/выход игроков
• наказания
• опасные команды
• действия с администраторами
• события LuckPerms
• всё это летит в отдельную VK-беседу логов
  

Чем этот плагин отличается
Обычно интеграция Minecraft с VK — это просто пересылка сообщений или запуск пары команд.

OrdaVK Manager идёт дальше и объединяет в одном плагине:

• staff management
• support desk
• audit system
• governance
• command bridge
• event relay
  

То есть это уже не просто “бот для VK”, а единая система управления сервером через VK.

Система ролей
Поддерживаются роли:

• helper
• moder
• admin
• staff
• chief

Иерархия:

helper < moder < admin < staff < chief

Логика ролей

• helper — помощь игрокам, тикеты, базовая информация
• moder — наказания
• admin — управление helper и moder
• staff — управление helper, moder, admin
• chief — полный контроль
  

Структура бесед VK
Плагин работает с несколькими беседами:

• manage — беседа управления
• events — беседа логов
• support — беседа поддержки
• ignore — игнорируемая беседа

Это позволяет разделить:

• staff-команды
• события сервера
• обращения игроков

Установка

1. Положите OrdaVK Manager.jar в папку plugins
2. Запустите сервер один раз
3. Откройте plugins/OrdaVK/config.yml
4. Укажите:
   
   • VK token
     
     
   • group id
     
     
   • peer id бесед
     
5. Настройте admins.yml
6. Перезапустите сервер
   

Важные замечания по настройке
group-id
Указывается только числом, без club
Правильно:

group-id: 81273108

Неправильно:

group-id: club81273108

chats.id
Используются peer_id бесед VK.

admins.yml
Первый администратор добавляется вручную, например:

admins:
"1103524939":
mcNick: "pommesshooter"
role: "CHIEF"
createdAt: 0
updatedAt: 0

Примеры использования
Управление из VK

!online
!status
!check Steve
!kick Steve flood
!mute Steve 30m мат
!ban Steve 7d cheats
!ban Steve grief

Управление администраторами

!admins
!admin info 1103524939
!admin add 123456789 Steve helper
!admin set 123456789 moder
!admin remove 123456789

Поддержка игроков
Игрок в игре:

/helpop как приватить
/report Steve чит

Ответ staff из VK:

!list
!info 27
!r 27 Чтобы приватить, выдели 2 точки и используй /rg claim дом
!close 27

Для кого этот плагин
OrdaVK Manager особенно подойдёт, если у вас:

• англо-, казахо-, русскоязычное комьюнити
• staff-команда сидит во VK
• нужен контроль наказаний и действий администрации
• нужна поддержка игроков без постоянного входа в игру
• нужен отдельный audit/log канал
  

Текущий статус
Плагин ориентирован на:

• Paper 1.20.4
• совместимую работу на 1.20+
• без NMS и жёсткой привязки к одной версии ядра
  

Планы развития
В будущих версиях можно расширить:

• bootstrap первого администратора
• reload без полного рестарта сервера
• staff analytics
• шаблоны ответов
• routing тикетов по отделам
• кнопки и меню VK
• расширенный dangerous command audit
  

Поддержка проекта
Если плагин оказался полезным и ты хочешь поддержать развитие OrdaVK Manager — можешь закинуть на печеньку Visa: 4400430316173688

Даже маленькая поддержка приятна и помогает дальше развивать плагин, чинить баги и добавлять новые фишки.