JailsSystem: Prison Labor & Escape

🌍 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 <player> <minutes> <cell> <reason>	Jail a player
/unjail <player>	Release player
/jtime add/remove/set <player> <seconds>	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 <name>
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. Готово!

---