Jail-Reloaded

Jail Management, Prisoner Protection & Configurable Escape Gameplay

Jail-Reloaded is a maintained fork of graywolf336's original Jail plugin, updated for Spigot and Paper servers running Minecraft 1.19–26.3. Give your staff a configurable alternative to kicks and bans: create jails and individual cells, assign temporary or indefinite sentences, manage prisoner behavior, and return stored belongings when players are released.

Build a secure detention system or an escape-focused roleplay prison. Configure movement restrictions, block and item interactions, chat muting, inmate clothing, property chests, sentence payments, and player votes to suit your server. Familiar commands, guided creation, permission-filtered help, and documented configuration make day-to-day administration easier.

Originally By: graywolf336
Fork maintained by Rismr1 | ImagineCraft Plugins. Jail-Reloaded is free and will never be sold. Original project credit, the repository's original license, and contributor attribution are preserved.

Explore Jail-Reloaded

Version Support · Features · Commands and Permissions · Installation · Dependencies · Support · Original Author and Project Credits

---

Version Support

Languages: English • Finnish • German • Spanish • French • Italian • Japanese • Korean • Dutch • Polish • Brazilian Portuguese • Russian • Swedish • Ukrainian • Simplified Chinese • Traditional Chinese • Hong Kong Traditional Chinese

Jail-Reloaded Release Support

---

Features — v1.0.0

Jails and Cells

• Create multiple named jails with defined cuboid regions.
• Maintain jails across multiple worlds.
• Create individually named cells within a jail.
• Use guided in-game creation with a selection wand.
• Set jail/cell arrival positions and a jail release location through the creation process.
• Assign a prisoner to a specific jail and cell, or automatically select an available cell.
• Use a configured default jail or nearest-jail selection.
• List jails and cells, inspect occupancy, and check prisoner information.
• Transfer individual prisoners between jails or cells, or transfer all prisoners from one jail to another.
• Teleport staff or a specified player to a jail's arrival/release location with permission-controlled commands.
• Stop an unfinished creation session and confirm supported destructive management actions.

Sentences and Release

• Jail online players and queue jailings for offline players, subject to configuration.
• Control whether players who have never joined may be jailed.
• Assign timed or indefinite sentences with a configurable default duration.
• Use readable durations such as 30s, 5m, 1h, and 2d.
• Add, remove, set, or inspect remaining sentence time.
• Choose whether established sentences continue counting down while a prisoner is offline.
• Complete pending offline jailings when the player next joins.
• Release prisoners when their timed sentence expires, or release them manually.
• Support force-release administration for prisoner records requiring intervention.
• Record the jailer and reason for each jailing.
• Choose the prisoner's jail game mode and optionally restore their previous game mode on release.
• Release players at a configured jail exit or optionally return them to their saved pre-jail location.
• Run configured console commands after jailing and normal release, with player, UUID, and reason placeholders.

Prisoner Protections

• Movement protection returns attempted escapes to the jail/cell arrival point.
• Block breaking and placement protections with configurable material whitelists.
• Command restrictions with a configurable command whitelist.
• Configurable block-interaction and held-item blacklists.
• Wildcard '*' rules cover all runtime materials, including materials introduced by newer server versions.
• Item-use restrictions cover both hands and supported interactions in the air, on blocks, and on entities.
• Crop-trampling protection.
• Separate configurable sentence penalties for prohibited movement, block breaking, block placement, commands, crop trampling, block interactions, and item interactions.
• Set a penalty to 0 to keep the protection active without adding sentence time.
• Automatically mute newly jailed players, or toggle an individual prisoner's chat mute.
• Configure whether prisoners receive normal chat messages.
• Configure minimum and maximum prisoner hunger levels.
• Exclude prisoners from the sleeper count used to skip night.
• Configure AFK kicking for inactive prisoners, or disable it.
• Protect jail-region blocks against explosions and enderman block movement.

Default behavior: New installations use strict interaction rules and zero additional sentence penalties. Existing installations retain their saved settings. Review the supplied configuration to choose the rules appropriate for your server.

Inventory and Property Chests

• Optionally confiscate inventory when a player is jailed and return stored belongings on release.
• Preserve inventory slots, armor, and offhand contents in the saved property snapshot.
• Preserve supported item metadata, including lore, damage, custom model data, books, and persistent custom data.
• Optionally discard configured blacklisted materials instead of storing them.
• Associate a double chest with a cell, including trapped chests.
• Keep stored property available in prisoner data when no property chest is assigned.
• Protect both halves of registered property chests against unauthorized access, destruction, and automated item transfers.
• Restrict chest access to the assigned prisoner when openChest is enabled; vacant cells and other players remain protected, including against operator access.
• Show stored property as protected previews while movement protection is enabled.
• Preserve remaining property through jail/cell transfers, reloads, and restarts.
• Restore the original inventory slots when no property has been reclaimed; after reclamation, preserve already-carried items and return only the remaining saved property.
• Drop release overflow at the player's location when their inventory has no space.

Item compatibility: Paper uses native item-data serialization where available, with a Bukkit metadata fallback on other supported implementations. Legacy stored snapshots remain readable. Native snapshots require compatible native-byte support; moving newer stored items to older Minecraft versions is not supported.

Escape Gameplay and Property Reclamation

Use jailing.during.moveProtection: false to allow escape gameplay and unlock supported prisoner equipment/property actions.

• Allow prisoners to leave the defined jail region instead of returning them automatically.
• Allow prisoners to remove or replace their issued jail clothing.
• When openChest is enabled, let the assigned prisoner reclaim property directly from their own chest into available inventory storage slots.
• Click or shift-click to reclaim a stack; right-click to reclaim one item.
• Leave items safely stored when the player's inventory is full.
• Update saved property as items are reclaimed so release does not return them twice.
• Preserve reclamation state through reloads, restarts, transfers, and later changes to movement protection.
• Continue blocking chest deposits, dragging, hotbar/offhand swaps, and hopper transfers.

Other configured restrictions still apply. Review block/item blacklists and command rules when designing an escape prison. Allowing a player to leave the region does not itself clear their sentence; use normal release or your own command/API integration to complete an escape scenario.

Inmate Uniforms

• Issue a configurable unbreakable jail uniform when a player is jailed.
• Choose armor materials and RGB colors for leather armor.
• Store original equipment before issuing jail clothing.
• Lock uniforms while movement protection is enabled, including protection against inventory movement, drops, armor swaps, and armor-stand interactions.
• Restore required uniforms after respawning or rejoining in protected mode.
• Allow removable/replacement equipment in escape mode without forcing the uniform back on after transfers, reloads, respawns, or rejoining.
• Re-equip the uniform when movement protection is re-enabled, preserving replacement armor in inventory or dropping overflow.
• Prevent issued uniform pieces from being consumed as jail-payment items.
• Remove tagged jail gear on release.

Cell Signs and Scoreboards

• Display prisoner information on registered cell signs.
• Customize up to four sign lines with color codes and placeholders for the player, UUID, reason, jailer, remaining minutes, readable sentence time, and AFK time.
• Display a configurable sentence-time sidebar with a custom title and time label.
• Refresh registered signs on startup, reload, and chunk load.
• Protect registered signs from player edits and item interactions.
• Automatically wax registered cell signs on server versions exposing native waxing support.
• Clean, refresh, update, or verify signs through staff commands.

Handcuffs and Jail Sticks

• Handcuff a player at their current location to restrict movement and teleporting.
• Remove handcuffs with a staff command.
• Enable hit-to-jail tools through /jail stick and the configured jail-stick materials.
• Configure each jail stick's material, sentence duration, destination jail, and reason.
• Optionally require a target to be below a configured health threshold before a stick can jail them.
• Control jail-stick access per material and configure who may be jailed by sticks.

Sentence Payments

• Let players view their jail bill and pay to reduce a timed sentence or buy release.
• Allow a player to contribute a payment toward another prisoner's sentence.
• Configure the price per remaining minute and a separate flat price for indefinite sentences.
• Use physical item payments without Vault.
• Use money payments with Vault and a compatible economy provider.
• Disable timed-sentence or indefinite-sentence payments by setting the corresponding price to 0.
• Enable or disable the jail-payment system in configuration.

Player Jail Votes

• Allow permitted players to start a vote to jail an online player.
• Accept yes/no votes with one vote per participant for a given target.
• Configure the vote duration and minimum number of yes votes.
• Require more yes votes than no votes for a successful result.
• Configure the sentence and reason applied by a successful vote.
• Control vote access, vote-start permissions, and target immunity.
• Enable or disable jail voting in configuration.

Administration and Customization

• Paginated chat help with separate player/admin views, clickable navigation, and permission-filtered entries.
• Tab completion for supported commands, jail names, cells, and player selections.
• Configurable jail broadcasts with permission-controlled recipients.
• Stored jailing history with /jail record when profile logging is enabled.
• Configurable console audit logging for completed actions and an optional debug mode.
• SQLite storage by default, external MySQL/MariaDB, or YAML flatfile storage.
• Storage migration handling when changing configured storage; back up data before switching engines.
• Support for large serialized inventory records in MySQL through upgraded inventory columns.
• Support for the 17 languages listed above, with configurable locale selection and editable messages.
• Traditional & color codes in supported configurable text, signs, and scoreboard labels.
• Documented configuration settings with refreshed comments and preserved saved values on startup/reload.
• Reload configuration without duplicating recurring tasks; malformed configuration is rejected without replacing the active settings.
• Regenerate a deleted configuration file with its header and setting descriptions.
• No obsolete upstream update-check notifications or background updater queries.

API Integration

Connect other server plugins through the retained Jail developer API and Bukkit events.

• Access jail and prisoner managers, jail sticks, handcuffs, and jail votes through JailsAPI.
• Query jails, cells, and prisoner state through the provided managers.
• Integrate jailing, transfers, release, and sentence-time behavior through the existing API.
• Listen for supported jailing, jail-stick, transfer, release, death, and timer events.
• Use supported cancellable pre-action events to participate in jail workflows.
• Parse the plugin's supported duration strings through the API.

---

Commands and Permissions

Notation: <argument> is required; [argument] is optional. Feature settings and any applicable prisoner restrictions still apply. The in-game /jail help menu shows commands available to the sender.

Player Commands

Admin Commands

Additional Permissions

Property chests: Registered property chests have their own assigned-prisoner checks. Operator status or a general chest-access permission does not bypass these protections.

Permission defaults and complete command declarations are listed in the plugin's plugin.yml.

---

Installation

1. Use a supported Spigot or Paper server and its required Java runtime.
2. Stop the server and place JailReloaded-1.0.0.jar in the server's plugins folder. Install only one Jail/Jail-Reloaded implementation.
3. Start the server to generate plugins/JailReloaded/config.yml, locale files, and default SQLite storage.
4. Review the configuration, especially movement protection, inventory storage, uniforms, interaction rules, sentence payments, and permissions.
5. Use /jail create <name> and follow the selection-wand instructions. Add cells with /jail createcell <jail> [cellname] when needed.
6. Configure optional integrations, run /jail reload after supported configuration changes, and test jailing/release with spare items before opening the system to players.

Upgrading or migrating: Back up the full plugin folder, prisoner/property data, and any external database before updating or changing storage engines. Preserve existing settings deliberately; new default values do not overwrite an existing configuration. Do not assume an older upstream plugins/Jail folder is automatically the same as this fork's plugins/JailReloaded folder.

Java: The plugin uses Java 17 bytecode. Newer Minecraft servers can require a newer Java runtime; follow your server's requirements. Folia is not supported.

Configuration Highlights

---

Dependencies

The core jail system requires no additional plugins.

WorldEdit and Multiverse-Core remain declared as optional soft dependencies; neither is required for the guided jail/cell creation workflow. A client resource pack is not required.

---

Support

• Discord: ImagineCraft Plugins support server

For support, include your Jail-Reloaded version, server software/version, Java version, relevant configuration, and a clear description of the problem. Remove database passwords and other credentials before sharing files or logs.

QQ: 中文支持 · QQ 交流群

无法访问 Discord，或需要中文帮助？欢迎加入 ImagineCraft 插件 QQ 交流群，咨询插件使用、配置及问题反馈。

QQ群号：101849876 · 群内联系人：AFK·落子无悔

---

Original Author and Project Credits

Originally By: graywolf336

Jail-Reloaded continues the original Jail project created and maintained by graywolf336, together with its original contributors. The original plugin, its design, and its existing functionality remain credited to that project. ImagineCraft Plugins maintains this fork for modern server compatibility, fixes, and user-requested updates.

• Original CurseForge page: Jail by graywolf336
• Original GitHub repository: graywolf336/Jail
• New maintained fork: Rismr1/Jail-Reloaded

Fork maintained by: Rismr1 | ImagineCraft Plugins.

Original contributors: Thank you to everyone who contributed code, translations, testing, documentation, and support to the original Jail project. See the original repository's contributors for its project history.

License and attribution: The fork retains the original repository's GNU GPL v2 LICENSE and includes an attribution NOTICE. See the fork repository for the license and notice distributed with Jail-Reloaded. This fork is free, will never be sold, and preserves credit to the original project.

Want to contribute? Join the Discord support server and post in Plugin Discussion. Bug reports, translation contributions, and feature suggestions are welcome.