RulesPlugin - принятие правил через GUI

RulesPlugin - это легковесный плагин для сервера Minecraft на Paper, который показывает ваши правила в аккуратном графическом меню и требует от игроков их принять, прежде чем они начнут играть.

Создан для владельцев серверов, которым нужен настраиваемый экран с правилами, отслеживание принятия, перезагрузка конфига и защита от багов - без написания собственной системы с нуля.

Последнее обновление

v1.3.2 - Compatibility Update - фокус на поддержку Minecraft 26.2.x и более безопасный запуск на серверах с GeyserMC или Floodgate.

• Добавлена отдельная сборка под Minecraft 26.2.x
• Пассивное обнаружение GeyserMC и Floodgate
• softdepend - RulesPlugin загружается после Geyser/Floodgate, если они установлены

Возможности

• Полная настройка через config.yml
• Неограниченное количество правил с автоматической пагинацией GUI
• Свои заголовки, описания, наказания и иконки для каждого правила
• Настраиваемая кнопка принятия с иконкой и текстом
• Кнопки переключения страниц
• Блокировка действий игрока до принятия правил
• Отслеживание принявших в data.yml
• Опциональный лог принятий в acceptance-log.yml
• Логи с пагинацией по версиям правил
• Версионирование: увеличивай rules-version, чтобы заставить игроков заново принять обновлённые правила
• Команда перезагрузки с валидацией YAML
• Принудительное открытие GUI для одного игрока или всех онлайн
• Поддержка прав доступа для админских команд
• Tab completion для команд RulesPlugin
• Проверка обновлений
• Защита от утечки и дублирования предметов из GUI

Команды

Команда	Описание	Право
/rules	Открыть GUI правил. Если уже принял - только просмотр	rulespl.rules
/rules reload	Перезагрузить и проверить конфиг	rulespl.reload
/rules logs	Показать недавние принятия	rulespl.seelogs
/rules logs v<версия> [страница]	Показать принятия конкретной версии с пагинацией	rulespl.seelogs
/rules show <игрок>	Принудительно открыть GUI для игрока	rulespl.show
/rules show everyone	Открыть GUI для всех онлайн	rulespl.show

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

rules-version: 1
gui-title: "Server Rules"

accept-button:
  name: "§aНажми сюда, чтобы принять правила"
  item: EMERALD_BLOCK

previous-page:
  name: "§a< Предыдущая страница"
  item: ARROW

next-page:
  name: "§aСледующая страница >"
  item: ARROW

accepted-message: "§aВы приняли правила сервера!"
error-message: "§cВы должны принять правила, прежде чем что-либо делать!"
rules-updated-message: "§cПравила обновлены. Пожалуйста, прочтите и примите их заново."
update-check-failed-message: "§e[RulesPlugin] Не удалось связаться с API обновлений. Офлайн-серверы могут игнорировать это - плагин продолжит работать."

rules:
  - title: "§e1. Будьте вежливы"
    description: "§7Относитесь ко всем игрокам с уважением."
    punishment: "§cНаказание: мут на 1 час"
    item: PAPER

  - title: "§e2. Запрещены читы"
    description: "§7Моды и хаки запрещены."
    punishment: "§cНаказание: перманентный бан"
    item: BARRIER

Используйте стандартные названия материалов Bukkit для иконок: STICKY_PISTON, DIAMOND_SWORD, PAPER, EMERALD_BLOCK.

Полное руководство по настройке: RulesPlugin Config

Установка

1. Скачайте подходящий .jar для вашей версии Minecraft с Modrinth.
2. Поместите его в папку /plugins вашего сервера.
3. Запустите или перезапустите сервер.
4. Отредактируйте config.yml под свои правила, сообщения и иконки.
5. Выполните /rules reload после изменений.

Скачать: Modrinth

Совместимость

RulesPlugin сейчас предлагает отдельные сборки для:

• Minecraft 1.21.x
• Minecraft 26.1.x
• Minecraft 26.2.x

Плагин собран на Spigot API, избегает Paper-only вызовов там, где ожидается совместимость со Spigot.

Также заявлена пассивная совместимость с GeyserMC и Floodgate. Если Geyser-Spigot или floodgate установлены, RulesPlugin загружается после них и логирует статус совместимости.

Безопасность

Предметы в GUI помечаются внутренними тегами плагина. Если из-за десинка, лага, взаимодействия в креативе, перетаскивания или крайних случаев с слотами крафта предмет покидает меню, RulesPlugin detects тег и автоматически удаляет его.

Защита работает как во время событий инвентаря, так и через периодическую очистку для всех онлайн-игроков.

Зачем это нужно

Любой сервер Minecraft с правилами рано или поздно сталкивается с проблемой: как донести их до игроков и заставить прочитать? Плагин RulesPlugin решает это элегантно - красивое GUI, обязательное принятие, возможность версионирования. Больше не надо писать свои скрипты или надеяться, что игроки заглянут на сайт. Если вы администрируете сервер - это must-have для цивилизованного онбординга новичков.

Скачайте плагин Rules Plugin с Modrinth и настройте правила под свой сервер Minecraft.