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

85 lines
4.6 KiB
Markdown

# 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
```bash
# Дать право полицейским
/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
```
## Сборка
```bash
./gradlew build
```
Собранный JAR будет в `build/libs/`
## Установка
1. Скопируйте JAR в папку `plugins/` вашего сервера
2. Убедитесь что установлен LuckPerms
3. Перезапустите сервер
4. Настройте `config.yml` по необходимости
5. Установите точку тюрьмы: `/setjail`
## Конфигурация
Смотрите `config.yml` для настройки:
- Дистанции для команд
- Скорости движения в наручниках
- Сообщений
- Параметров тюрьмы