jail-plugin/README.md
Илья Глазунов 2625155037
Some checks failed
Build and Release / build (push) Failing after 3s
initial commit
2025-12-22 20:29:34 +03:00

4.6 KiB
Raw Permalink Blame History

JailPlugin - PaperMC 1.21.11 РП Плагин

Простой плагин для РП серверов Minecraft с функциями наручников, тюрьмы и конвоирования.

История создания

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

Но возник вопрос: как усмирить нарушителя? Без наручников он просто убежит. Без возможности вести его за собой — суд превращается в хаос.

Я перерыл кучу плагинов в поисках нужного функционала, но ничего адекватного так и не нашёл — либо заброшенные проекты, либо переусложнённые комбайны с тонной лишнего. Поэтому решил: напишу сам — простой, лёгкий и с тем функционалом, который реально нужен для РП. А потом подумал: если я столкнулся с этой проблемой, наверняка кто-то ещё ищет такое решение. Так что выкладываю в открытый доступ — пользуйтесь на здоровье! Так появился JailPlugin для PaperMC 1.21.11 — минималистичный, но функциональный плагин для ролевых серверов Minecraft.

Функции

  • Наручники (Cuff) - Надевайте наручники на игроков, ограничивая их действия
  • Тюрьма (Jail) - Сажайте нарушителей в тюрьму на определённое время
  • Конвоирование (Lead) - Ведите игроков в наручниках за собой

Зависимости

  • PaperMC 1.21.11+
  • LuckPerms

Команды

Команда Описание Право
/cuff <игрок> Надеть наручники jailplugin.cuff
/uncuff <игрок> Снять наручники jailplugin.uncuff
/jail <игрок> <время> [причина] Посадить в тюрьму jailplugin.jail
/unjail <игрок> Выпустить из тюрьмы jailplugin.unjail
/setjail Установить точку тюрьмы jailplugin.setjail
/lead <игрок> Вести игрока в наручниках jailplugin.lead
/unlead <игрок> Отпустить ведомого игрока jailplugin.unlead

Права (LuckPerms)

  • jailplugin.cuff - Надевать наручники
  • jailplugin.uncuff - Снимать наручники
  • jailplugin.jail - Сажать в тюрьму
  • jailplugin.unjail - Выпускать из тюрьмы
  • jailplugin.setjail - Устанавливать точку тюрьмы
  • jailplugin.lead - Конвоировать игроков
  • jailplugin.unlead - Отпускать ведомых
  • jailplugin.admin - Все права плагина

Настройка прав в LuckPerms

# Дать право полицейским
/lp group police permission set jailplugin.cuff true
/lp group police permission set jailplugin.uncuff true
/lp group police permission set jailplugin.lead true
/lp group police permission set jailplugin.unlead true

# Дать все права администраторам
/lp group admin permission set jailplugin.admin true

Сборка

./gradlew build

Собранный JAR будет в build/libs/

Установка

  1. Скопируйте JAR в папку plugins/ вашего сервера
  2. Убедитесь что установлен LuckPerms
  3. Перезапустите сервер
  4. Настройте config.yml по необходимости
  5. Установите точку тюрьмы: /setjail

Конфигурация

Смотрите config.yml для настройки:

  • Дистанции для команд
  • Скорости движения в наручниках
  • Сообщений
  • Параметров тюрьмы