85 lines
4.6 KiB
Markdown
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` для настройки:
|
||
- Дистанции для команд
|
||
- Скорости движения в наручниках
|
||
- Сообщений
|
||
- Параметров тюрьмы
|