? Language / Язык
English
## JailsSystem: Prison Labor & Escape
JailsSystem: Prison Labor & Escape is a complete prison system for Minecraft Paper 1.21 servers.
Serve your sentence, work to reduce it, and plan daring escapes on your server.
---
---
> **⚠️ Important:** This plugin was developed primarily for the **Russian-speaking community**.
> **However, English is set as the default language!** The English version may contain some untranslated Russian strings.
### ? How to switch to fully translated Russian
1. Open `plugins/Jails/config.yml`
2. Find the line: `language: en`
3. Change it to: `language: ru`
4. Save the file and restart the server (**or run `/jails reload`**)
> **ℹ️ Note:** If the translation file is not created automatically, restart the server completely with the language already set to `ru` in the config — the plugin will then generate the required language file.
> ? The plugin automatically creates `lang_en.yml` and `lang_ru.yml` files.
> You can edit them to customize or complete the translation yourself.
---
### Prison System
Everything begins with imprisonment. The player receives a prisoner outfit, is put into ADVENTURE mode, and sent to a cell. Time passes in real time, and being AFK slows down sentence progress.
Main prison mechanics
- **Cells:** Created using `/cell create` at your location
- **Sentence time:** Runs in real time, shown with `/jtime`
- **AFK mode:** Time slows down while inactive (configurable)
- **Prison board:** Auto-updating list displayed on signs
---
### Jobs to Reduce Sentence
The plugin offers 4 types of jobs, each with unique mechanics and rewards.
Job types
**1. Bricks**
- Carry a "Wall Piece" between chests
- Slowness effect while carrying
- Reward: sentence reduction + chance to find a lockpick
**2. Laundry**
- Take dirty clothes and load them into the washing machine
- Visual washing timer
- Reward: sentence reduction + chance to get a guard armor piece
**3. Kitchen**
- Get ingredients based on a recipe
- Cook within a limited time
- Reward: sentence reduction + SWcoin (prison currency)
**4. Library**
- Take a book from the distribution section
- Find the correct category shelf
- Reward: sentence reduction + chance to get a map fragment
---
### SWcoin — Prison Currency
Earn SWcoin from jobs and spend it on the black market.
- Material, name, and description are configurable
- Given every N completed jobs
- Required to buy a ferry ticket
---
### Lockpicking
A reaction-based mini-game for opening iron doors.
How lockpicking works
- Use a lockpick (chance from brick job)
- A bar with a moving marker appears
- Press SHIFT when it's in the green zone
- Speed increases each round
- Lockpick durability decreases and it can break
---
### Black Market & NPC Trader
A secret area where you can buy a ferry ticket.
How the black market works
- Zone is set using two corners in config
- Trader is spawned using `/jailtools`
- Opens villager GUI with items
- Sells ferry ticket for SWcoin
---
### Black Market Map
Collect 9 map fragments in the library and craft a map that leads to the black market.
---
### Escape
A multi-step process that requires preparation.
Escape steps
1. **Find a lockpick** — from brick job
2. **Break the door** — reaction mini-game
3. **Get full guard armor** — from laundry
4. **Earn SWcoin** — from kitchen
5. **Buy ferry ticket** — from black market trader
6. **Reach escape zone** — configurable
7. **Use ticket on escape sign** — teleport to freedom
---
### Alert System
When a player escapes, guards receive location updates every few seconds.
---
### Prison Board
Create an information board using `/jailboard`.
- Automatically lists prisoners
- Shows online/offline status and remaining time
- Updates every 2 minutes
---
### Commands
Player commands
| Command | Description |
|--------|------------|
| `/jtime` | Show remaining time |
| `/jailstatus` | Prisoner list |
| `/jails workinfo` | Job info |
| `/jails escapeinfo` | Escape info |
| `/buypassport` | Buy ticket |
Admin commands
| Command | Description |
|--------|------------|
| `/jail ` | Jail a player |
| `/unjail ` | Release player |
| `/jtime add/remove/set ` | Change time |
| `/cell create/delete/rename` | Manage cells |
| `/jailtools` | Open job items menu |
| `/jailboard create/confirm/cancel` | Create board |
| `/jails reload` | Reload config |
---
### Full Config Customization
Almost everything can be configured in `config.yml`:
- Enable/disable mechanics
- Time reduction values
- Drop chances
- Black market prices
- Library categories and book names
- Kitchen recipes
- Escape & black market zones (coordinates)
> **All text messages** are stored in `lang_ru.yml` and `lang_en.yml` files.
> You can edit them to customize colors and phrases without touching the code.
---
### Requirements
- **Paper 1.21+**
- **Java 17+**
---
### Installation
1. Download `JailsSystem.jar`
2. Put it into `/plugins`
3. Restart the server
4. Create cells: `/cell create `
5. Edit `config.yml` if needed
6. Done!
---
Русский
## JailsSystem: Тюремные работы и побеги
JailsSystem: Prison Labor & Escape — это полноценная тюремная система для серверов Minecraft Paper 1.21.
Отбывай срок, работай, чтобы сократить его, и устраивай побеги на своём сервере.
---
---
> **⚠️ Важно:** Плагин разработан в первую очередь для **русскоязычного сообщества**.
> **Однако по умолчанию включена английская версия!** В английской версии могут встречаться непереведённые русские строки.
### ? Как переключиться на полностью переведённый русский язык
1. Откройте `plugins/Jails/config.yml`
2. Найдите строку: `language: en`
3. Измените её на: `language: ru`
4. Сохраните файл и перезапустите сервер (**или выполните команду `/jails reload`**)
> **ℹ️ Примечание:** Если файл с переводом не создался автоматически, перезапустите сервер полностью с уже изменённым языком в конфиге — плагин сам сгенерирует нужный файл локализации.
> ? Плагин автоматически создаёт файлы `lang_en.yml` и `lang_ru.yml`.
> Вы можете отредактировать их, чтобы самостоятельно дополнить или изменить перевод.
---
### Тюремная система
Всё начинается с посадки в тюрьму. Игрок получает робу заключённого, режим ADVENTURE и отправляется в камеру. Время идёт в реальном режиме, а AFK замедляет срок.
Основные механики тюрьмы
- **Камеры:** Создаются командой `/cell create` на месте
- **Время заключения:** Тикает в реальном времени, отображается через `/jtime`
- **AFK-режим:** При бездействии время идёт медленнее (настраивается)
- **Табло заключённых:** Автоматически обновляемый список на табличках
---
### Работы для сокращения срока
Плагин предлагает 4 вида работ, каждый со своими механиками и наградами.
Виды работ
**1. Кирпичи**
- Переносите «Кусок стены» из одного сундука в другой
- Эффект замедления во время переноски
- Награда: сокращение времени + шанс найти отмычку
**2. Прачечная**
- Заберите грязную одежду, загрузите в стиральную машинку
- Визуальный таймер стирки
- Награда: сокращение времени + шанс получить часть брони надзирателя
**3. Кухня**
- Получите ингредиенты по рецепту
- Приготовьте блюдо за ограниченное время
- Награда: сокращение времени + SWcoin (тюремная валюта)
**4. Библиотека**
- Возьмите книгу из раздела выдачи
- Найдите полку с правильной категорией
- Награда: сокращение времени + шанс получить обрывок карты
---
### SWcoin — тюремная валюта
Зарабатывайте SWcoin на работах и тратьте на чёрном рынке.
- **Материал, название и описание** настраиваются в конфиге
- Выдаётся за каждые N выполненных работ
- Нужен для покупки билета на паром
---
### Взлом замков
Мини-игра на реакцию для открытия железных дверей.
Как работает взлом
- Используйте отмычку (шанс найти при работе с кирпичами)
- На экране появляется полоска с движущимся маркером
- Нажмите SHIFT, когда маркер в зелёной зоне
- С каждым раундом скорость увеличивается
- Отмычка теряет прочность и может сломаться
---
### Чёрный рынок и NPC-торговец
Секретная зона на карте, где можно купить билет на паром.
Как работает чёрный рынок
- Зона настраивается двумя углами в конфиге
- Торговец призывается яйцом из меню `/jailtools`
- Открывается GUI жителя с товарами
- Продаётся билет на паром за SWcoin
---
### Карта чёрного рынка
Соберите 9 обрывков карты в библиотеке и скрафтите карту, которая приведёт вас к чёрному рынку.
---
### Побег
Многоэтапный процесс, требующий подготовки.
Этапы побега
1. **Найдите отмычку** — выпадает при работе с кирпичами
2. **Взломайте дверь** — мини-игра на реакцию
3. **Соберите полный комплект брони надзирателя** — выпадает в прачечной
4. **Накопите SWcoin** — зарабатывайте на кухне
5. **Купите билет на паром** — у торговца на чёрном рынке
6. **Доберитесь до зоны побега** — настраивается в конфиге
7. **Используйте билет на паром по табличке для побега** — телепорт на свободу!
---
### Система оповещения
Когда игрок сбегает, охрана получает сообщения о его местоположении (каждые N секунд).
---
### Табло заключённых
Создайте информационное табло из обычных табличек командой `/jailboard`.
- Автоматическое заполнение списком заключённых
- Отображение статуса (онлайн/оффлайн) и оставшегося времени
- Обновляется каждые 2 минуты
---
### Команды
Команды для игроков
| Команда | Описание |
|---------|----------|
| `/jtime` | Показать оставшееся время |
| `/jailstatus` | Список заключённых |
| `/jails workinfo` | Информация о работах |
| `/jails escapeinfo` | Информация о побеге |
| `/buypassport` | Купить билет |
Административные команды
| Команда | Описание |
|---------|----------|
| `/jail ` | Посадить в тюрьму |
| `/unjail ` | Освободить |
| `/jtime add/remove/set ` | Изменить время |
| `/cell create/delete/rename` | Управление камерами |
| `/jailtools` | Открыть меню выдачи рабочих блоков |
| `/jailboard create/confirm/cancel` | Создание табло |
| `/jails reload` | Перезагрузка конфига |
---
### Полная настройка через конфиг
Почти всё настраивается в `config.yml`:
- Включение/отключение любой механики
- Время сокращения за работы
- Шансы выпадения предметов
- Цены на чёрном рынке
- Категории и названия книг в библиотеке
- Рецепты на кухне
- Зоны побега и чёрного рынка (координатами)
> **Все текстовые сообщения** хранятся в файлах `lang_ru.yml` и `lang_en.yml`.
> Вы можете редактировать их для изменения цветов и фраз без вмешательства в код.
---
### Требования
- **Paper 1.21+**
- **Java 17+**
---
### Установка
1. Скачайте `JailsSystem.jar`
2. Переместите в папку `/plugins`
3. Перезапустите сервер
4. Настройте камеры: `/cell create `
5. При необходимости отредактируйте `config.yml`
6. Готово!
---
暂无评论，抢个沙发吧~