Skip to content

Protection‐Stones

Alexisleder edited this page May 29, 2026 · 1 revision

Protection Stones

Protection stones are the core feature of LederProtections.

Players place a special item in the world to create a protected region.


Default Stone Types

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

Basic Stone Configuration

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: 3

Display Name

display-name: "&f&lLeder&b&lProtections &8| &7Piedra &ax4"

This is the item name shown to players.


Material

material: COAL_ORE

The material is the physical block used as the protection stone.

Use valid Bukkit/Paper material names.


Radius

radius-x: 4
radius-y: 4
radius-z: 4

The 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

permission: "lederprotections.stone.4"

Players need this permission to use the stone.


Maximum Protections

max-protections: 3

This controls how many protections of this type a player can have.

Use:

max-protections: -1

for unlimited.


Economy

economy:
  price: 5000
  shop-enabled: true

price controls the shop price.

shop-enabled controls whether the stone appears in the shop.

Vault is required for paid stones.


Upgrades

upgrade:
  enabled: true
  next: "8"

This means this stone can be upgraded to type 8.

Example upgrade chain:

4 → 8 → 16 → 32 → 64

Lore

Lore supports placeholders:

lore:
  - "&7Protection size: &a{size_x}x{size_z}"
  - "&7Price: &a{price}"
  - "&7Upgrade: &b{next_upgrade}"

Available Placeholders

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

Security

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.


Recommended Design

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

Important Notes

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.

Clone this wiki locally