Платно Плагин hStaffWork | hPvP, PAPI, LuckPerms, LiteBans, и много чего ещё поддерживается! v2.1

hStaffWork объединяет основные инструменты администрации в одном плагине. Сотрудники входят в рабочий режим, для них применяются настроенные ограничения команд, они проводят проверки и наблюдают за игроками, а сервер сохраняет время смен, баны, муты, жалобы и историю действий.

Плагин работает с настроенными группами LuckPerms, поддерживает защищённый вход через TOTP 2FA, предоставляет готовую веб-панель и хранит данные в SQLite или MySQL.

ОСНОВНЫЕ ВОЗМОЖНОСТИ

• Режим работы персонала с учётом смен и времени
• Отдельные ограничения команд во время работы и вне её для каждой группы
• Статистика банов и мутов, топ сотрудников и подробные карточки
• Полноценные проверки игроков с таймером, ограничениями, чатом и историей
• Управляемый spectator-режим для скрытого наблюдения через /spec
• Система жалоб с приоритетами, объединением и настраиваемым GUI
• TOTP 2FA для входа в рабочий режим и веб-панель
• Встроенный Web-интерфейс со статистикой и историями наказаний
• Гибкие Actions, MiniMessage, PlaceholderAPI и подтверждение опасных команд
• SQLite и MySQL с асинхронной работой SQL
• Восстановление проверок и spectator-состояния после перезапуска
• Публичный Bukkit Services API для интеграции с другими плагинами

РАБОЧИЙ РЕЖИМ И LUCKPERMS

hStaffWork определяет сотрудника по основной или унаследованной группе LuckPerms, указанной в groups.yml. Для каждой группы можно настроить:

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

Смена начинается командой /sw work и заканчивается через /sw unwork. Плагин сохраняет число сессий и реальное время, проведённое с включённым рабочим статусом. При выходе с сервера смена автоматически завершается, а активный /spec безопасно отключается.

АНАЛИТИКА ПЕРСОНАЛА

Статистика учитывает только настроенные команды банов и мутов, выполненные сотрудником в рабочем режиме. Шаблоны команд задаются в config.yml, поэтому систему можно адаптировать под используемый плагин наказаний.

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

СИСТЕМА ПРОВЕРОК

Модуль /check создаёт отдельную управляемую сессию между модератором и проверяемым игроком.

• заморозка движения и настраиваемые ограничения взаимодействий;
• блокировка телепортации и посторонних команд;
• отдельный чат модератора и проверяемого;
• ActionBar и BossBar с оставшимся временем;
• настраиваемые точки начала проверки и возврат на исходное место;
• готовые причины и сроки наказаний;
• признание игрока через /check confession;
• пауза и продолжение таймера, добавление времени;
• передача активной проверки другому модератору;
• карточка текущей проверки и журнал последних действий;
• сохранение активной сессии для восстановления после перезапуска;
• автоматические Actions при выходе игрока или окончании времени.

Наказания выполняются через настраиваемые Console Actions — вы сами задаёте команды своего ban-плагина и формулировки причин.

НАБЛЮДЕНИЕ ЧЕРЕЗ /SPEC

Обычный игрок может отправить запрос помощи командой или ключевым словом в чате. Работающий модератор получает кликабельное уведомление и начинает наблюдение.

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

ЖАЛОБЫ И GUI МОДЕРАЦИИ

Игроки отправляют жалобы через /report, а персонал обрабатывает их в меню /reports.

• задержка между жалобами и лимит активных обращений;
• защита от жалобы на себя и повторных обращений на одну цель;
• готовые причины и дополнительное GUI выбора причины;
• объединение жалоб на одного игрока в одну карточку;
• динамический приоритет по числу отправителей, возрасту и прошлым ложным жалобам;
• уведомления при достижении заданного количества обращений;
• закрепление принятой жалобы за одним модератором;
• действия из GUI: принять, телепортироваться, начать /spec, подтвердить или отклонить;
• автоматическое закрытие жалоб после наказания через /check;
• полностью настраиваемые предметы, слоты, названия, lore и Actions кликов.

TOTP 2FA И WEB-ПАНЕЛЬ

Опциональная двухфакторная авторизация защищает вход в рабочий режим и личную веб-сессию. Поддерживаются Google Authenticator, Authy, 2FAS и другие TOTP-приложения.

• первая привязка через одноразовую QR-ссылку или секретный ключ;
• настраиваемое время жизни Minecraft- и Web-сессий;
• лимит неверных кодов и временная блокировка;
• маскирование шестизначного кода при вводе команды;
• административный сброс привязки, отзыв сессий и просмотр статуса;
• шифрованное хранение TOTP-секретов;
• CSRF-защита, cookies с безопасными атрибутами и ограничение частоты Web-запросов.

В комплект входит готовый редактируемый Web-интерфейс:

• общие показатели банов, мутов и времени работы;
• рейтинг сотрудников по выбранному периоду;
• карточки модераторов с разбивкой статистики;
• последние наказания и постраничная история;
• вход в личную сессию через TOTP;
• JSON API и backend настраиваемых наград для собственной интеграции.

Веб-сервер по умолчанию слушает только 127.0.0.1 и самостоятельно не завершает TLS. Для публичного доступа оставьте локальную привязку и разместите его за HTTPS reverse proxy. HTML, CSS, JavaScript, название сервера, IP и ссылки на социальные сети можно заменить под свой проект.

ГИБКАЯ НАСТРОЙКА

Сообщения и реакции построены на системе Actions. Доступны:

• форматирование MiniMessage, HEX-цвета, hover и click events;
• подстановка PlaceholderAPI в поддерживаемых Actions;
• встроенные переменные игрока, сотрудника, проверки, жалобы и статистики;
• отдельные файлы для основных сообщений, групп, проверок, /spec, жалоб, 2FA и Web;
• индивидуальное подтверждение опасных подкоманд повторным вводом;
• включение и настройка основных модулей без редактирования JAR.

ХРАНЕНИЕ И API

Аналитика, жалобы, 2FA и Web-награды используют четыре независимых хранилища. Каждое можно отдельно подключить к SQLite или MySQL. SQL-задачи отправляются в отдельные фоновые очереди, а пулами соединений управляет HikariCP.

Для разработчиков регистрируется StaffApi через Bukkit Services Manager. API позволяет получить обычный и расширенный топ за день, неделю или всё время, а также отображаемую роль сотрудника.

КОМАНДЫ

Управление плагином

Рабочий режим и статистика

Проверки игроков
/revise — алиас команды /check.

Наблюдение и жалобы

ПРАВА


Все перечисленные права по умолчанию доступны операторам сервера.

Доступ к базовым командам /sw определяется настроенной staff-группой LuckPerms. Чтобы обычные игроки могли отправлять жалобы или запросы /spec, выдайте им hstaffwork.report.send и hstaffwork.spec.send.

ТРЕБОВАНИЯ

• Paper 1.21.x или совместимое Paper-ядро
• Java 21 или новее
• LuckPerms — обязательно
• PlaceholderAPI — обязательно
• Vault + Economy provider — опционально, только для Vault Actions
• hPvP — опциональная интеграция spectator-режима

Плагин использует Paper API для обработки чата и стандартный Bukkit scheduler, поэтому обычный Spigot/CraftBukkit и Folia не поддерживаются.

УСТАНОВКА И ПЕРВЫЙ ЗАПУСК

1. Установите Paper 1.21.x, LuckPerms и PlaceholderAPI.
2. Поместите hStaffWork-2.1.jar в папку plugins и запустите сервер.
3. Замените примерные группы в groups.yml на реальные группы вашего персонала.
4. Проверьте шаблоны ban/mute-команд в config.yml.
5. Настройте координаты проверок и Console Actions наказаний в check.yml под свой мир и ban-плагин.
6. Выдайте права на жалобы, /spec и инструменты модерации.
7. Замените примерные ники в ignoredPlayers и adminPlayers.
8. До первого включения 2FA и создания привязок замените encryptionKey в 2fa.yml. Последующая смена ключа потребует сбросить и заново привязать существующие TOTP-секреты.
9. До включения Web-панели задайте свой settings.publicUrl в web/web.yml, оставьте settings.host: 127.0.0.1 и settings.secureCookie: true, затем настройте HTTPS reverse proxy и замените примерное оформление, IP и ссылки.

/hstaffwork reload перечитывает основные конфиги, настройки и GUI жалоб, а также web/web.yml с перезапуском встроенного Web-сервера. Полный перезапуск нужен после изменений в storage/*.yml, web/rewards.yml, настройках шифрования/TOTP, после добавления Vault/Economy или hPvP, а также при изменении включения, приоритета или ignoreCancelled обработчиков проверок и /spec.

При обновлении с hStaffWork 2.0 сохраните резервную копию и заново создайте либо вручную перенесите check.yml. В версии 2.1 изменилась структура настроек заморозки, взаимодействий и телепортации.