JailsPlugin 🚔

Stop using outdated jail plugins that break inventories and require editing config files for hours.

JailsPlugin is a modern, highly optimized, and insanely safe jail system for Paper and Purpur servers (1.21+). It was built from scratch with one goal: give server admins absolute control while guaranteeing 100% player data safety.

Here is why your server needs this plugin right now.

🔥 The "Must-Have" Features

• 📦 100% Inventory Safety (No Item Loss): The biggest fear of any admin is a plugin wiping a player's items. When jailed, the entire inventory (armor, off-hand, and even cursor items) is instantly serialized to Base64 in prisoners.yml. If your server crashes or restarts while a player is jailed, their items are 100% secure and will be flawlessly returned upon release.
• 🗺️ Effortless Region Creation (No Config Editing): Forget about manually calculating coordinates and writing them in config.yml. Just stand in the game, type one command, and the jail is ready. The plugin automatically calculates the volume and saves everything safely.
• 🛡️ Unbreakable Isolation (Anti-Escape): Prisoners are completely locked down. They cannot break/place blocks, open chests, use items, enter vehicles, fly, or execute unauthorized commands. Every attempt is blocked and logged as a violation.
• ⏱️ Smart BossBar & Auto-Release: Prisoners see a beautiful, dynamic BossBar with their remaining time. When the clock hits zero, the plugin automatically releases them and restores their items. No admin intervention needed.
• 🌍 True Multiverse Support: Have a separate jail world? No problem. If the world isn't loaded on server startup, the plugin waits for it, detects the load event, and safely activates the jail region without errors.
• 🌐 10 Languages & Modern UI: Out of the box support for EN, RU, DE, ES, FR, IT, PL, TR, PT_BR, and ZH_CN. All messages use the modern Adventure API (MiniMessage) for stunning gradients, colors, and hex codes.
• ⚙️ Strict Violation System: If a prisoner tries to break a block or spam a forbidden command, they get a violation. Collect enough violations, and their sentence automatically extends or teleports them back to the center.

🛠️ How to Create a Jail (Takes 5 Seconds)

You do not need to touch any config files. Everything is done in-game.

1. Stand in the first corner of your future jail and type /jail reg <name> <x1> <y1> <z1> <x2> <y2> <z2>.
   (Example: /jail reg main 100 60 100 120 80 120)
2. Done! The region is calculated, saved, and ready to use.
3. (Optional) Teleport to the center of your region and type /jail center main to set the exact spawn point for prisoners.

🚀 Commands & Permissions

| Command | Description | Permission |
| :--- | :--- | :--- |
| /jail gui | Open the main management menu | jail.gui |
| /jail send <player> <region> <time> <reason> | Jail a player (e.g., 10m) | jail.send |
| /jail free <player> | Release a player from jail | jail.free |
| /jail reg <name> <x1> <y1> <z1> <x2> <y2> <z2> | Create a new jail region | jail.reg.create |
| /jail setspawn | Set the release point | jail.setspawn |
| /jail info <player> | View detailed prisoner info | jail.info |
| /jail reload | Reload configs and language files | jail.reload |

(Type /jail help in-game for the full list of commands)

⚙️ Compatibility & Requirements

• Server Software: Paper or Purpur (Spigot and Folia are NOT supported).
• Minecraft Versions: 1.21 – 1.21.11 (Tested on Paper 1.21.11).
• Java Version: Java 21 or higher is required.
• Dependencies: Works perfectly with Multiverse-Core (soft-depend).

🛠️ Installation Guide

1. Download the JailsPlugin-1.0.0.jar file.
2. Place the .jar file into your server's plugins/ folder.
3. Restart your server.
4. Use /jail gui or the commands to set up your first jail region.
5. (Optional) Customize the plugin in config.yml and choose your language in plugins/JailsPlugin/lang/.

Developed with passion and zero AI-generated code. Enjoy a lag-free and secure jail system!

📢 Support & Community

Need help with setup? Found a bug? Have a suggestion?

We have a dedicated support system for server admins:

• Telegram Channel (News & Updates): @blockkoda
• Support Bot (24/7 FAQ & Contact): @blockSupport_bot (coming soon!)

Feel free to reach out. I am always happy to help!