⚠️ This is an unofficial fork of Jail Logic by n3mmuss.

The original project appears inactive, so this fork exists to keep the mod usable on newer Minecraft versions, with some optional improvements.

The original project’s source code is released under the CC0 license.
This fork is redistributed under the MIT License to clearly define attribution and contribution terms for future maintenance.

If the original author releases updates for the versions this fork targets and includes the fixes provided here, this fork will no longer be updated.

Please do not report issues to the original developer. Report them here instead.

---

Jail Mod (Fabric)

The Jail Mod is a server-side mod that allows you to imprison players in a virtual prison, preventing them from interacting with the world until they are released. It is perfect for Minecraft servers where you want to impose temporary penalties or temporarily limit the movement of certain players.

---

Key Features

• Temporary Imprisonment: You can imprison a player for a specific amount of time, blocking interactions with blocks, entities, and objects, such as buckets of lava or water.

• Automatic or Manual Release: The player is automatically released after the set time, or an admin can release them manually.
• Imprisonment Reason: When you imprison a player, you can specify a reason that will be communicated to the player.
  
• Command to know the remaining time: Imprisoned players can check the time remaining until their release.
  
• Discord Webhook (optional): Sends jail and unjail events to a Discord webhook. If BanHammer is installed and Jail Mod webhook is empty, Jail Mod reuses BanHammer's webhook automatically.
• BanHammer-style Discord templates: Supports config/jailmod/discord-messages.json in BanHammer-like format with auto patching for new fields.

How to use:

1. Build a prison (a closed structure).

2. Set the coordinates where you want the prisoner to spawn with the command /jail set x y z  (example /jail set 0 60 0)

3. Reload the configuration using /jail reload .

4. Send someone to jail with /jail playerexample 120 Griefing.

5. If you don't want to wait for the prison time you set in seconds (example 120 seconds), you can release the player early with the command /unjail playerexample

Requirements

• Minecraft 1.21 or later
• Fabric API

Installation

1. Place the mod's .jar file in the mods folder of the Minecraft server.
2. Start the server to generate configuration files.

Available Commands

1. /jail player time reason

• Description: Jails a player for a specified time in seconds, specifying the reason.
• Who can use it: Only admins or server operators.
• Syntax:  /jail player_name time_in_seconds reason
• Example: /jail Steve 300 GriefingThis command jails the player Steve for 300 seconds (5 minutes) with the reason "Griefing".

2. /unjail player

• Description: Manually releases a player from jail before the time expires.
• Who can use it: Only admins or server operators.
• Syntax: /unjail player_name
• Example: /unjail Steve
  This command will manually release Steve from jail.

3. /jail info

• Description: Allows incarcerated players to see the time remaining until release and the reason for their incarceration.
• Who can use it: Only jailed players.
• Example: /jail infoThis command will return a message similar to: "You are in jail for another 200 seconds. Reason: Griefing."

4. /jail reload

• Description: Reloads configuration, language messages, and discord-messages.json without restarting the server.
• Who can use it: Only admins or server operators.
• Example: /jail reloadThis command reloads the mod's configuration, useful if the config files have been modified.

5. /jail set

• Description: Sets the coordinates where jailed players will spawn. This is where players will appear when they are sent to jail.
• Who can use it: Only admins or server operators.
• Syntax: /jail set x y z
• Example: /jail set 0 60 0
  This command sets the jail spawn location to coordinates (0, 60, 0).

Interactions blocked during jail

When a player is jailed, they cannot do the following:

• Use blocks, such as doors, levers, or buttons.
• Interact with entities, such as villagers or animals.
• Use lava or water buckets.
• Break or place blocks.

Automatic release

• Players will be automatically released from jail when the set time is up.
• While jailed, players can check the remaining time using the /jail info command.

Configuration file

config/jailmod/config.json

This file is automatically generated and updated, it allows you to configure the jail's location and the player's release location and more. Here are the options you can find:

• admin_roles: Comma-separated list of roles or tags that grant /jail access. e.g. "op,admin,moderator"
• use_previous_position: If set to true, players will be released in the position they were in before being jailed. If set to false, they will be released in a specific position.
• return_to_last_location: If true, released players will be teleported back to the exact spot where they were jailed.
• release_position: The fallback coordinates for releasing players if no other location (spawn/last) is used, active if use_previous_position is set to false or if return_to_last_location is set to false.
• jail_position: The coordinates where players are held while in jail with coordinates x, y, z.
• discord_webhook_url: Optional Discord webhook used for jail/un-jail embeds. Leave empty to auto-use BanHammer's webhook when BanHammer is installed and has a webhook url set (read from config/banhammer/config.json).
• use_banhammer_webhook: If true and discord_webhook_url is empty, JailMod may reuse BanHammer's webhook URL.

Example configuration:

{
  "_config_guide": "JailMod Configuration Guide: \n- admin_roles: Comma-separated list of roles or tags that grant /jail access. Use \u0027op\u0027 to include server operators.\n- use_previous_position: If true, released players will be teleported to their original spawn point (if return_to_last_location is false or unavailable).\n- return_to_last_location: If true, released players will be teleported back to the exact spot where they were jailed.\n- jail_position: The coordinates where players are held while in jail.\n- release_position: The fallback coordinates for releasing players if no other location (spawn/last) is used.",
  "admin_roles": "op",
  "use_previous_position": true,
  "return_to_last_location": true,
  "discord_webhook_url": "",
  "use_banhammer_webhook": true,
  "release_position": {
    "x": 100,
    "y": 65,
    "z": 100
  },
  "jail_position": {
    "x": 20,
    "y": 64,
    "z": 142
  }
}

config/jailmod/discord-messages.json

This file controls Discord webhook message templates in a BanHammer-style format and is auto-generated/auto-patched.

• sendJailMessage: Enables jail webhook notifications.
• jailMessage: Template for jail events.
• sendUnjailMessage and unjailMessage: Template for manual unjail events.
• sendAutoUnjailMessage and autoUnjailMessage: Template for auto unjail events.

/jail reload reloads this file too.

config/jailmod/language.txt

This file contains the messages that are displayed in-game, customizable to match the tone or style of the server. If the file does not exist, it is automatically generated with default messages. Here are some of the messages you can modify:

• jail_player: Message the player receives when they are jailed. Use the variables {time} for the duration and {reason} for the reason.
  Example: "You have been jailed for {time} seconds! Reason: {reason}"
• jail_broadcast: Message broadcast to all players on the server when a player is jailed.
  Example: "{player} has been jailed for {time} seconds. Reason: {reason}"
• unjail_player_manual: Message the player receives when they are manually released from jail.
  Example: "You have been manually released from jail!"
• unjail_broadcast_manual: Message broadcast to all players on the server when a player is manually released from jail.
  Example: "{player} has been manually released from jail!"
• unjail_player_auto: Message the player receives when they are automatically released from jail after the time expires.
  Example: "You have been released after serving your sentence."
• unjail_broadcast_auto: Message broadcast to all players on the server when a player is automatically released from jail after the time expires.
  Example: "{player} has been released after serving their sentence."
• block_interaction_denied: Message informing the player that they cannot interact with blocks while in jail.
  Example: "You cannot interact with blocks while in jail!"
• entity_interaction_denied: Message informing the player that they cannot interact with entities while in jail.
  Example: "You cannot interact with entities while in jail!"
• bucket_use_denied: Message informing the player that they cannot use lava or water buckets while in jail.
  Example: "You cannot use lava or water buckets while in jail!"
• item_use_denied: Message informing the player that they cannot use items while in jail.
  Example: "You cannot use items while in jail!"
• block_break_denied: Message informing the player that they cannot break blocks while in jail.
  Example: "You cannot break blocks while in jail!"
• jail_info_message: Message that shows the remaining time and the reason for the jail sentence when the player uses the /jail info command.
  Example: "You are in jail for another {time} seconds. Reason: {reason}."
• not_in_jail_message: Message shown if a player is not in jail and tries to use /jail info.
  Example: "You are not in jail!"

Default language.txt example:

    jail_player=You have been jailed for {time} seconds! Reason: {reason}
    jail_broadcast={player} has been jailed for {time} seconds. Reason: {reason}
    unjail_player_manual=You have been manually released from jail!
    unjail_broadcast_manual={player} has been manually released from jail!
    unjail_player_auto=You have been released after serving your sentence.
    unjail_broadcast_auto={player} has been released after serving their sentence.
    block_interaction_denied=You cannot interact with blocks while in jail!
    entity_interaction_denied=You cannot interact with entities while in jail!
    bucket_use_denied=You cannot use lava or water buckets while in jail!
    item_use_denied=You cannot use items while in jail!
    block_break_denied=You cannot break blocks while in jail!
    jail_info_message=You are in jail for another {time} seconds. Reason: {reason}.
    not_in_jail_message=You are not in jail!

Usage Tips

Use the /jail reload command after changing configuration or language messages to apply the changes without having to restart the server. Always specify a clear reason for the jailing, so the player knows why they were jailed.

Usage Examples

Set Jail spawn position:

/jail set 0 60 0

Jailing a player for an unfair action:

/jail Alex 600 Offending another player

This jails Alex for 10 minutes with the reason "Offending another player".

Checking jail time:

/jail info

A jailed player can use this command to check how much time they have left.