Repository navigation
Protection‐Stones
Protection stones are the core feature of LederProtections.
Players place a special item in the world to create a protected region.
Default types:
| Type | Radius |
|---|---|
4 |
4 blocks |
8 |
8 blocks |
16 |
16 blocks |
32 |
32 blocks |
64 |
64 blocks |
These are configured in:
plugins/LederProtections/stones.yml
Example:
4:
display-name: "&f&lLeder&b&lProtections &8| &7Piedra &ax4"
material: COAL_ORE
radius-x: 4
radius-y: 4
radius-z: 4
permission: "lederprotections.stone.4"
max-protections: 3display-name: "&f&lLeder&b&lProtections &8| &7Piedra &ax4"This is the item name shown to players.
material: COAL_OREThe material is the physical block used as the protection stone.
Use valid Bukkit/Paper material names.
radius-x: 4
radius-y: 4
radius-z: 4The radius controls the size of the protection.
If full-height protection is enabled in config.yml, vertical radius may be replaced by full world height.
permission: "lederprotections.stone.4"Players need this permission to use the stone.
max-protections: 3This controls how many protections of this type a player can have.
Use:
max-protections: -1for unlimited.
economy:
price: 5000
shop-enabled: trueprice controls the shop price.
shop-enabled controls whether the stone appears in the shop.
Vault is required for paid stones.
upgrade:
enabled: true
next: "8"This means this stone can be upgraded to type 8.
Example upgrade chain:
4 → 8 → 16 → 32 → 64
Lore supports placeholders:
lore:
- "&7Protection size: &a{size_x}x{size_z}"
- "&7Price: &a{price}"
- "&7Upgrade: &b{next_upgrade}"Stone lore supports:
| Placeholder | Description |
|---|---|
{id} |
Stone type ID |
{radius_x} |
X radius |
{radius_y} |
Y radius |
{radius_z} |
Z radius |
{size_x} |
Full X size |
{size_y} |
Full Y size |
{size_z} |
Full Z size |
{height} |
Height |
{area} |
Area |
{material} |
Material name |
{price} |
Price |
{shop_enabled} |
Shop status |
{upgrade_enabled} |
Upgrade status |
{next_upgrade} |
Next upgrade |
{upgrade_cost} |
Upgrade cost |
Protection stones are validated using PersistentDataContainer.
This means players cannot create fake protection stones just by renaming an item or copying lore.
LederProtections does not trust item names or lore for validation.
For a balanced survival server:
| Type | Suggested Usage |
|---|---|
| x4 | Starter players |
| x8 | Small bases |
| x16 | Normal bases |
| x32 | Advanced players |
| x64 | Large bases or premium ranks |
Changing stone IDs after players already created protections is not recommended.
If you change materials, old placed stones may no longer match the expected material for repair checks.