Main Configuration (config.yml)

The config.yml file is the main configuration file for BuildersWand that controls all aspects of the plugin's behavior, permissions, performance, and integrations.

File Location

If you installed Jails-

plugins/Jails/config.yml

If you bought JailsPlus-

plugins/JailsPlus/config.yml

Plugin Settings

Prefix

prefix: "&7[&eJailsPlus&7]"

Purpose: Defines the label/tag that appears before all plugin messages.

Color: Customize your prefix’s colors by changing the chat code (for example, change &7 for any other code you like). Only Minecraft’s chat color codes are supported. Visit Minecraft Color Codes for the full list of chat color codes.

Language

language: "en"

Purpose: Sets the language for all plugin messages
Supported: en (English), de (German), es (Spanish), fr (French), ru (Russian), pt (Portuguese), pl (Polish).
Default: en (English)

Update

check-updates: true 
notify-up-to-date: false

check-updates : Enables checking for new plugin versions and notifies if an update is available.

notify-up-to-date : Shows a console message every-time on startup if the plugin is already up to date.

General Settings

Broadcasts

general:
    broadcast-on-jail: true 
    broadcast-on-escape: true 
    broadcast-on-unjail: true

broadcast-on-jail : Whether to send a message that can be seen by everyone when a player is jailed

broadcast-on-escape : Whether to send a message that can be seen by everyone when a player escapes jail (Jails+)

broadcast-on-unjail : Whether to send a message that can be seen by everyone when a player is released from jail

Note: These broadcast messages can be edited in the respective language file (en.yml, es.yml etc.) located in \lang folder

Unjail Location (Jails+)

general:
    default-unjail-location: WORLD_SPAWN

Purpose: Controls where the player will be teleported after being released from jail

Values: WORLD_SPAWN and ORIGINAL_LOCATION

WORLD_SPAWN - Teleports the freed prisoner to world spawn or where players typically spawn after joining the server for the first time.
ORIGINAL_LOCATION - Teleports the freed prisoner to their original location or the location where they were before being jailed.

Flag Preview (Jails+)

general:
    wand-tool: "Material.GOLDEN_HOE"
    preview-particle: FLAME

wand-tool -

Purpose: Controls which item to be used for previewing flags

Value: Any valid item to the server's respective version.

preview-particle -

Purpose: Controls which particle type to be used when previewing any flag.
Value: Any valid particle type to the server's respective version. To see the list of particle types, visit this website.

Bail System (Jails+)

general:
    bail_command: "eco take %target% %amount%"
    refund_command: "eco give %target% %amount%"

Purpose: This is the command that will be run when a player bails someone out of jail.

bail_command : This is the command that will be run when a player bails someone out of jail

refund_command This is the command that will be run when something goes wrong when someone tries to bail someone out of jail

Placeholders:

%target% - This will be replaced by the player on whom the command will be run
%amount% - This will be replaced by the amount of money the player had put in the command

Setup: In order to set up the bail system properly, you need to edit the commands respective to the plugin which you are using, which has economy support.

Note: Do not remove the placeholders; put them in the respective order of the command. For example, if the command in Minecraft is - /take <player_name> <amount_of_money>, Edit the config to be - "take %target% %amount%". Additionally, the command must also have console support.

Jail Settings

Inventory Settings (Jails+)

jail-settings:
  keep-inventory: false 
  jail-items: 
    - item: BAKED_POTATO
      amount: 32
    - item: WATER_BUCKET
      amount: 1
    - item: BREAD
      amount: 16

keep-inventory - Whether players can keep their items when jailed, or will they be given a set of items (jail-items)

jail-items - Items given to jailed players when keep-inventory value is set to false. Keep this empty if you don't want to give anything to prisoners, or to add more items. Just follow the format and set the appropriate item with an amount (any number is allowed). For example-

jail-settings:
    jail-items:
        - item: STEAK
          amount: 128

Escape Handling

jail-settings:
    punish-on-escape: true
    escape-punishment: KILL    
    ban-duration: "1d"

punish-on-escape : Whether a player should get punished or not if they escape jail. If set to false, it will only show alerts.

escape-punishment : Which type of punishment will the escaping prisoner face.

Available types of punishments: KILL, TELEPORT_BACK, BAN, or UNJAIL

ban-duration : The ban duration if the config option escape-punishment is set to BAN . For example - (10s/10m/10h/10d)

Note: You must set flags for these to function. See commands page for more info

Skin Behaviour (Jails+)

jail-settings:
    change-skin: true 
    skin-username: ShortMute954

change-skin : Whether the player's skin is changed when they get jailed or not. (SkinRestorer plugin needs to be installed for this work)

skin-username : Whose skin to use when a player gets jailed (Default: ShortMute954)

Chat Role

jail-settings:
    enable-jailed-role: true 
    jailed-role: "&7[&cJailed&7]&r"

enabled-jailed-role : Whether players will have a "Jailed" text next to their name when they send anything in chat

jailed-role : The text to show next to a player's name when they're jailed

Output of this

[Jailed] Notch: Bro please forgive me, unjail me bro.

Note: To change the color of the role/label text, visit this website to know which color to choose.

Handcuff-settings

handcuff-settings:
    slow-movement: true            
    blindness: true                
    disable-items: true            
    disable-block-place: true      
    disable-block-break: true      
    disable-pvp: true              
    handcuff-speed: 0.05           
    broadcast-on-handcuff: true

slow-movement : Whether to make handcuffed players slower

blindness : Whether to make handcuffed players blind

disable-items : Whether to prevent handcuffed players from using items or not

disable-block-place : Whether to prevent handcuffed players from placing blocks or not

disable-block-break : Whether to prevent handcuffed players from breaking blocks or not

disable-pvp : Whether to prevent handcuffed players from attacking or not

handcuff-speed : The handcuffed player's movement speed (Default 0.05)

broadcast-on-handcuff : Whether to send a message that can be seen by all players when a player is handcuffed or not

Warning: Do not set the handcuff-speed higher than 0.1 which is the default speed. Anything higher than that is speed boost, and anything lower than that is slowness.

Blocked Commands

blocked-commands:
  - "tpa"
  - "home"
  - "spawn"
  - "team"
  - "rtp"
  - "tpr"
  - "warp"

blocked-commands : Under this, following the format, the word wrapped in a strip after ' - ' is the command that is blocked

Note: Unlimited commands can be blocked. To add a blocked command, just follow the format and put the command wrapped in a string (" ") after ' - '. For example:

blocked-commands:
    - "msg"

This will block the "msg" command, so whenever a prisoner tries using the command "msg", it will say "You cannot use this command while jailed!" or similar.

Jail Restrictions

jail-restrictions:
  block-break: false    
  block-place: false  
  attack: false         
  vehicle-ride: false   
  entity-ride: false    
  block-mount: false    
  items: false          
  ender-pearl: false    
  allow-movement: true  
  allow-chat: false

Purpose: Configuration containing what prisoners can or can't do

block-break : Whether the prisoner can break blocks or not

block-place : Whether the prisoner can place blocks or not

attack : Whether the prisoner can attack or not

vehicle-ride : Whether the prisoner can ride vehicles (boat, minecart, etc.) or not

entity-ride : Whether the player can ride entities (animals with saddles and players (to ride players, you need GSit plugin)) or not

block-mount : Whether the prisoner can mount on blocks (players can mount on blocks using GSit plugin) or not

items : Whether the prisoner can use items or not

ender-pearl : Whether the prisoner can pearl or not

allow-movement : Whether the prisoner is allowed to move or not

allow-chat : Whether the prisoner is allowed to use chat or not

Note: Here, false means no and true means yes

PreviousConfiguration Overview NextDiscord Integration (discord.yml)

Last updated 1 month ago