Skip to content

Protection Stones

Alexisleder edited this page Jul 8, 2026 · 1 revision

Protection Stones

Protection stones are the core of LederProtections.

Players create protections by placing configured protection stones in the world. Each stone type can have its own radius, material, price, upgrade path, display name and permission.


What is a Protection Stone?

A protection stone is a configured block that creates a protected area when placed.

Example:

A player places an x16 protection stone.
LederProtections creates a protected region around that block.
The player becomes the owner of the protection.

Protections are backed by WorldGuard regions, while LederProtections handles GUI management, roles, rules, upgrades and additional protection checks.


Default Protection Sizes

LederProtections includes multiple default protection sizes.

Size Description
x4 Small starter protection.
x8 Small protection.
x16 Medium protection.
x32 Large protection.
x64 Very large protection.

These sizes can be customized in stones.yml.


Stones Configuration File

Protection stones are configured in:

plugins/LederProtections/stones.yml

This file controls:

  • stone IDs;
  • materials;
  • radius;
  • display names;
  • lore;
  • prices;
  • upgrade paths;
  • permissions;
  • shop visibility;
  • upgrade availability.

Example Stone Configuration

A protection stone entry may include options similar to:

stones:
  x16:
    radius: 16
    material: IRON_BLOCK
    price: 5000.0
    permission: "lederprotections.stone.16"
    shop:
      enabled: true
    upgrade:
      enabled: true
      next: "x32"

The exact structure may depend on your generated stones.yml.


Common Stone Options

Option Description
radius Protection radius created by this stone.
material Minecraft block/item material used as the protection stone.
price Shop price or base economy value.
permission Permission required to use this protection stone.
shop.enabled Controls whether the stone appears in the shop.
upgrade.enabled Controls whether this stone can be upgraded.
upgrade.next Next stone type in the upgrade path.

Radius Behavior

The radius defines how far the protection extends from the placed stone.

Example:

Radius General meaning
4 Protects a small area around the stone.
8 Protects a larger area around the stone.
16 Protects a medium area.
32 Protects a large area.
64 Protects a very large area.

The exact protected area depends on the plugin configuration and region behavior.


Protection Height

Depending on configuration, protections may use full vertical height or a limited vertical range.

Mode Description
Full height The protection covers the configured radius across the full world height.
Limited height The protection covers the configured radius with a limited vertical range.

Full-height protection is useful for survival servers where players want to protect underground and above-ground builds.


Stone Materials

Each protection stone uses a Minecraft material.

Example materials:

Stone size Example material
x4 Coal block or coal-related block.
x8 Copper-related block.
x16 Iron block or iron-related block.
x32 Gold block or gold-related block.
x64 Emerald block or emerald-related block.

You can customize materials in stones.yml.

Make sure the material name is a valid Bukkit material name for your Minecraft version.


Stone Permissions

Each stone can require a permission.

Example permissions:

Permission Description
lederprotections.stone.4 Allows using x4 protection stones.
lederprotections.stone.8 Allows using x8 protection stones.
lederprotections.stone.16 Allows using x16 protection stones.
lederprotections.stone.32 Allows using x32 protection stones.
lederprotections.stone.64 Allows using x64 protection stones.

This allows server owners to limit larger protection stones to specific ranks.

Example:

Default players:
- x4
- x8
- x16

VIP players:
- x32
- x64

Giving Protection Stones

Administrators can give protection stones with:

/lep give <player> <radius> <amount>

Example:

/lep give Steve 16 1

This gives Steve one protection stone with radius 16, if that radius exists in stones.yml.


Creating a Protection

To create a protection:

  1. Get a valid protection stone.
  2. Place it in the world.
  3. LederProtections checks if the area is valid.
  4. If the area does not overlap another protection, a new protection is created.
  5. The player becomes the owner.
  6. The protection appears in /p.

Overlap Protection

LederProtections can prevent protections from overlapping.

Example option:

protections:
  prevent-overlap: true

When enabled, players cannot place a protection stone if the new area would overlap another protected region.


Breaking Protection Stones

Depending on configuration, breaking a protection stone can remove the protection.

Common behavior:

Behavior Description
Remove protection The WorldGuard region is removed when the stone is broken.
Return stone The protection stone is returned to the player.
Keep protection The protection remains depending on configuration.

Example options:

protections:
  remove-region-when-stone-breaks: true
  return-stone-when-broken: true

Upgrades

Protection stones can be upgraded if upgrade paths are configured.

Example upgrade path:

x4 -> x8 -> x16 -> x32 -> x64

When a protection is upgraded:

  1. LederProtections checks the next stone type.
  2. It checks if the new area is valid.
  3. It checks if the new area overlaps another protection.
  4. It checks economy cost if required.
  5. It updates the protection size.
  6. It updates the physical protection stone if configured.

Upgrade Cost

If Vault and an economy plugin are installed, upgrades can have a cost.

A common setup is to charge the difference between the current stone value and the next stone value.

Example:

Current stone Current value Next stone Next value Upgrade cost
x16 5000 x32 12000 7000
x32 12000 x64 30000 18000

This keeps upgrades fair because players only pay the difference.


Shop Integration

Protection stones can appear in the protection shop if enabled.

Example:

shop:
  enabled: true

Each stone can usually define whether it should appear in the shop.

Shop purchases may require:

  • Vault;
  • an economy plugin;
  • player permission;
  • enough inventory space.

If the player's inventory is full, LederProtections should block the purchase safely.


Protection Ownership

When a player places a protection stone, they become the owner of that protection.

The owner can usually:

  • rename the protection;
  • manage members;
  • manage co-owners;
  • configure rules;
  • upgrade the protection;
  • set teleport points;
  • remove the protection.

Some actions depend on configuration and permissions.


Invalid Placement

A protection stone may fail to create a protection if:

Reason Description
Overlap The new protection overlaps another protection.
No permission The player cannot use that stone size.
Limit reached The player has reached their protection limit.
Invalid world Protections are disabled in that world.
WorldGuard issue WorldGuard or WorldEdit is not loaded correctly.

When placement fails, LederProtections should notify the player with a configurable message.


Recommended Stone Setup

For a balanced survival server:

Rank Suggested access
Default x4, x8, x16
VIP x32
Premium x64
Staff Admin tools, not necessarily bypass

This is only an example. Server owners can configure stone sizes and prices based on their economy and gameplay style.


Best Practices

Recommended practices:

  • Keep small stones affordable.
  • Make large stones more expensive.
  • Use permissions for larger protections.
  • Keep overlap prevention enabled.
  • Test upgrade paths before release.
  • Test shop purchases with full inventory.
  • Test stone placement near existing protections.
  • Keep stones.yml backed up before major changes.

Common Issues

The stone does not create a protection

Check that:

  • the material is configured correctly;
  • the radius exists in stones.yml;
  • the player has permission;
  • the area does not overlap another protection;
  • WorldGuard and WorldEdit are working.

The stone cannot be bought

Check that:

  • the shop is enabled;
  • the stone is enabled in the shop;
  • Vault is installed if economy is used;
  • an economy plugin is installed;
  • the player has enough money;
  • the player has inventory space.

The protection cannot be upgraded

Check that:

  • the current stone has an upgrade path;
  • the next stone exists;
  • the player has permission;
  • the player has enough money if required;
  • the larger area does not overlap another protection.

Recommended Next Pages

Clone this wiki locally