LightStaff (Лайтстафф)

Плагин для серверов Майнкрафт на Paper и Folia, который даёт модераторам режим проверки игроков. В нём есть скрытность, заморозка, осмотр инвентаря, телепортация и журнал действий; при выходе плагин возвращает сохранённые инвентарь, броню, предмет во второй руке, опыт, режим игры и полёт.

Возможности

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

Команды

• /lightstaff, /ls, /staffmode, /sm — включить или выключить режим модератора.
• /lightstaff reload — перезагрузить настройки, инструменты и сообщения.
• /lightstaff status [player] — показать состояние режима, скрытности, заморозки и сессии.
• /lightstaff recover <player> — восстановить сохранённую сессию.
• /vanish [player] — включить или выключить скрытность.
• /freeze <player> [reason], /freeze on <player> [reason], /freeze off <player>, /unfreeze <player> — управлять заморозкой.
• /stafftp <player> — телепортироваться к игроку в сети.
• /staffwhitelist — переключить режим обхода белого списка модераторов.

Права

• lightstaff.use — режим модератора; lightstaff.reload — перезагрузка; lightstaff.recover — восстановление сессий; lightstaff.status — просмотр состояния.
• lightstaff.vanish, lightstaff.vanish.others, lightstaff.see — скрытность, скрытие других и просмотр скрытых модераторов.
• lightstaff.freeze, lightstaff.freeze.staff, lightstaff.inspect, lightstaff.inspect.staff — заморозка и осмотр инвентарей, включая модераторов.
• lightstaff.fly, lightstaff.push, lightstaff.stafftp — полёт, отталкивание и телепортация.
• lightstaff.whitelist.toggle, lightstaff.whitelist.bypass, lightstaff.combat.bypass — белый список и вход в режим при боевой метке.
• lightstaff.creative — поведение режима в творческом режиме; lightstaff.alerts — уведомления о входе и выходе модераторов.
• lightstaff.admin и lightstaff.* — полный доступ.

Настройка

• config.yml — поведение плагина, хранилище, проверка боя, заморозка, белый список и журнал.
• tools.yml — включение инструментов, слоты, права, материалы, задержки, названия, описания и звуки.
• messages.yml — префикс, сообщения и подписи панели действий.
• Для хранилища доступны sqlite, json, mysql и mariadb. При json данные сессий и состояний модерации записываются в plugins/LightStaff/data/sessions.json и plugins/LightStaff/data/moderation_states.json.
• Параметр combat.block_lightstaff_entry управляет запретом входа в режим при боевой метке, а combat.bypass_permission задаёт право обхода.

Требования

Нужны Java 17 или новее и сервер Paper либо Folia. PlaceholderAPI необязателен; для проверки боевой метки можно использовать CombatLogX, PvPManager, DeluxeCombat, CombatPlus или другой плагин, передающий состояние через метаданные либо PlaceholderAPI.