X Prison Armors is designed specifically for
Prison servers , offering an elegant and expandable way to create
armor tiers that reward players with
currency multipliers based on the gear they equip.
Features
Fully Customizable Armor Tiers
Create
unlimited armor tiers with their own:
Multipliers (Tokens / Gems / Money / any !)
Custom names
Lore
Materials
Enchants
Custom model data
Permissions per tier
MiniMessage support
MiniMessage Support
From gradients to bold formats — use modern formatting for:
Item names
Lore
Titles
Chat messages
Toggleable in config.yml
️Soulbound Support
Optionally lock armor to players so it
cannot be dropped, traded, or moved when soulbound mode is enabled.
Armor Auto-Giving on Join
Automatically grant players their armor if they have the required permission. Perfect for rank-based progression!
Custom Sound Effects
Customize feedback sounds for:
Clicks
Success
Info
Errors
Clean, Modular Configuration
All settings are separated into:
config.yml → Global settings & behavior
armors.yml → All armor tiers & stats
messages.yml → All messages
Lightweight & Efficient
Built with performance in mind
Clean code, no lag
Optional bStats metrics
Trusted and known author of multiple successful resources
⚙️ Configuration Overview
config.yml
Spoiler: config.yml
Code (YAML):
use-minimessage
: true
# Enables using of minimessage in titles / texts / messages
enable-debug
: false
# Enables extra debug logging (useful for developers)
enable-metrics
: false
# Enables bStats plugin metrics (anonymous usage data)
soulbound
: false
# Should armors be soulbound?
give-armor-on-join
: true
# Should armors be given to players on join when they have required permissions?
main-command
: - xarmors
- armors
- xprisonarmors
# Main command aliases
sounds :
click
: UI_BUTTON_CLICK
success
: ENTITY_PLAYER_LEVELUP
info
: BLOCK_NOTE_BLOCK_PLING
error
: BLOCK_NOTE_BLOCK_BASS
# Sound effects used by various plugin features for feedback.
armors.yml
Spoiler: armors.yml
Code (YAML):
tiers :
common :
multipliers :
tokens
: 1.05
gems
: 1.05
money
: 1.05
permission
:
"xprisonarmor.common"
helmet :
material
: LEATHER_HELMET
display-name
:
"<gray><bold>Common Helmet</bold></gray>"
lore
: -
"<dark_gray>A simple helmet for new miners.</dark_gray>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.05x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.05x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.05x</bold></green>"
enchants :
PROTECTION
: 5
chestplate :
material
: LEATHER_CHESTPLATE
display-name
:
"<gray><bold>Common Chestplate</bold></gray>"
lore
: -
"<dark_gray>Light and dependable for beginners.</dark_gray>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.05x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.05x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.05x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
leggings :
material
: LEATHER_LEGGINGS
display-name
:
"<gray><bold>Common Leggings</bold></gray>"
lore
: -
"<dark_gray>Reliable and suitable for early mining.</dark_gray>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.05x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.05x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.05x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
boots :
material
: LEATHER_BOOTS
display-name
:
"<gray><bold>Common Boots</bold></gray>"
lore
: -
"<dark_gray>Soft but sturdy; perfect for newcomers.</dark_gray>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.05x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.05x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.05x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
rare :
multipliers :
tokens
: 1.15
gems
: 1.15
money
: 1.15
permission
:
"xprisonarmor.rare"
helmet :
material
: IRON_HELMET
display-name
:
"<gradient:#6dd6ff:#3aaed8><bold>Rare Helmet</bold></gradient>"
lore
: -
"<gray>Shining with enhanced magical energy.</gray>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.15x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.15x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.15x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
chestplate :
material
: IRON_CHESTPLATE
display-name
:
"<gradient:#6dd6ff:#3aaed8><bold>Rare Chestplate</bold></gradient>"
lore
: -
"<gray>Forged from refined rare alloys.</gray>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.15x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.15x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.15x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
leggings :
material
: IRON_LEGGINGS
display-name
:
"<gradient:#6dd6ff:#3aaed8><bold>Rare Leggings</bold></gradient>"
lore
: -
"<gray>Enhanced with energetic materials.</gray>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.15x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.15x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.15x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
boots :
material
: IRON_BOOTS
display-name
:
"<gradient:#6dd6ff:#3aaed8><bold>Rare Boots</bold></gradient>"
lore
: -
"<gray>Swift and strengthened for growing adventurers.</gray>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.15x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.15x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.15x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
legendary :
multipliers :
tokens
: 1.25
gems
: 1.25
money
: 1.25
permission
:
"xprisonarmor.legendary"
helmet :
material
: DIAMOND_HELMET
display-name
:
"<gradient:#ffea00:#ff9f00><bold>Legendary Helmet</bold></gradient>"
lore
: -
"<gold>Forged by ancient master smiths.</gold>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.25x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.25x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.25x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
chestplate :
material
: DIAMOND_CHESTPLATE
display-name
:
"<gradient:#ffea00:#ff9f00><bold>Legendary Chestplate</bold></gradient>"
lore
: -
"<gold>Pulses with ancient golden power.</gold>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.25x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.25x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.25x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
leggings :
material
: DIAMOND_LEGGINGS
display-name
:
"<gradient:#ffea00:#ff9f00><bold>Legendary Leggings</bold></gradient>"
lore
: -
"<gold>Said to withstand any strike.</gold>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.25x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.25x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.25x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
boots :
material
: DIAMOND_BOOTS
display-name
:
"<gradient:#ffea00:#ff9f00><bold>Legendary Boots</bold></gradient>"
lore
: -
"<gold>Walk with the force of legends.</gold>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.25x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.25x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.25x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
mythical :
multipliers :
tokens
: 1.50
gems
: 1.50
money
: 1.50
permission
:
"xprisonarmor.mythical"
helmet :
material
: NETHERITE_HELMET
display-name
:
"<gradient:#d17bff:#9b00ff><bold>Mythical Helmet</bold></gradient>"
lore
: -
"<dark_purple>Whispers of voidborn power surround it.</dark_purple>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.5x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.5x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.5x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
chestplate :
material
: NETHERITE_CHESTPLATE
display-name
:
"<gradient:#d17bff:#9b00ff><bold>Mythical Chestplate</bold></gradient>"
lore
: -
"<dark_purple>Pulses with cosmic, unstable force.</dark_purple>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.5x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.5x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.5x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
leggings :
material
: NETHERITE_LEGGINGS
display-name
:
"<gradient:#d17bff:#9b00ff><bold>Mythical Leggings</bold></gradient>"
lore
: -
"<dark_purple>Forged from abyssal void essence.</dark_purple>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.5x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.5x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.5x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
boots :
material
: NETHERITE_BOOTS
display-name
:
"<gradient:#d17bff:#9b00ff><bold>Mythical Boots</bold></gradient>"
lore
: -
"<dark_purple>Each step radiates arcane power.</dark_purple>"
-
" "
-
"<gray>Boosts:</gray>"
-
"<yellow>⛃ Tokens boost:</yellow> <green><bold>1.5x</bold></green>"
-
"<green> Gems boost:</green> <green><bold>1.5x</bold></green>"
-
"<gold>$ Money boost:</gold> <green><bold>1.5x</bold></green>"
custom-model-data
: 0
enchants :
PROTECTION
: 5
messages.yml
Spoiler: messages.yml
Code (YAML):
messages :
no-perm
: <red>⛔ <bold><gradient:
#FFD700:#FFA500>PRISON ARMORS</gradient></bold>
» <white>You don't have permission!
player-not-online
: <yellow>⚠ <bold><gradient:
#FFD700:#FFA500>PRISON ARMORS</gradient></bold>
» <white>That player is not online.
armor-tier-received
: <yellow>⚠ <bold><gradient:
#FFD700:#FFA500>PRISON ARMORS</gradient></bold>
» <green>You have received a tier <bold>
%tier%</bold> armor!
armor-tier-given
: <yellow>⚠ <bold><gradient:
#FFD700:#FFA500>PRISON ARMORS</gradient></bold>
» <green>You have given a tier <bold>
%tier%</bold> armor to <bold>%player%</bold>!
no-armor-tier
: <yellow>⚠ <bold><gradient:
#FFD700:#FFA500>PRISON ARMORS</gradient></bold>
» <red>That armor tier does not exist!
invalid-slot
: <yellow>⚠ <bold><gradient:
#FFD700:#FFA500>PRISON ARMORS</gradient></bold>
» <red>Invalid slot name!
armor-tier-piece-given
: <yellow>⚠ <bold><gradient:
#FFD700:#FFA500>PRISON ARMORS</gradient></bold>
» <green>You have given a <bold>
%tier% %slot%</bold> to <bold>%player%</bold>!
armor-tier-pice-received
: <yellow>⚠ <bold><gradient:
#FFD700:#FFA500>PRISON ARMORS</gradient></bold>
» <green>You have received <bold>
%tier% %slot%</bold>!
soulbound-cannot-drop
: <yellow>⚠ <bold><gradient:
#FFD700:#FFA500>PRISON ARMORS</gradient></bold>
» <red>This item is <bold>SOULBOUND</bold>!
titles
:
{
}
♾️ Unlimited Custom Tiers
You can add
as many tiers as you want — with
any multipliers, names, enchants, colors, materials, and permissions.
Commands
Command
Description [] - Required input <> - Optional input
/xarmors give [player] [tier] <helmet/chestplate/leggings/boots>
Gives a player specific armor tier / tier piece
/xarmors reload
/xarmors help
Show plugin command usages
Permissions
Permission
Use xprisonarmor .
common - Grants the Common tier armor
xprisonarmor .
rare - Grants the Rare tier armor
xprisonarmor .
legendary - Grants the Legendary tier armor
xprisonarmor .
mythical - Grants the Mythical tier armor
Your own custom tiers automatically inherit permissions you define in armors.yml.
️ Installation
Drop the plugin and its dependencies into /plugins
Start your server to generate configs
Edit armors.yml & config.yml as you desire
Reload or restart your server
Done!
Supports versions:
1.13 – 1.21+
Why Choose X Prison Armors?
Made specifically for Prison servers
Add progression without bloat
Gives players meaningful goals
Fully configurable
Supports any custom currencies
Works with any economy system that provides external currency events
Perfect for:
Rank-progression systems
Donor kits
Seasonal passes
Mining servers needing multiplier gear
Official Plugin Compatibility: Spigot/Paper
1.13.X-1.21.X © 2025 X PRISON ARMORS | www.drawethree.dev