Repository navigation
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.
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.
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.
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.
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.
| 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. |
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.
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.
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.
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
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.
To create a protection:
- Get a valid protection stone.
- Place it in the world.
- LederProtections checks if the area is valid.
- If the area does not overlap another protection, a new protection is created.
- The player becomes the owner.
- The protection appears in
/p.
LederProtections can prevent protections from overlapping.
Example option:
protections:
prevent-overlap: trueWhen enabled, players cannot place a protection stone if the new area would overlap another protected region.
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: trueProtection stones can be upgraded if upgrade paths are configured.
Example upgrade path:
x4 -> x8 -> x16 -> x32 -> x64
When a protection is upgraded:
- LederProtections checks the next stone type.
- It checks if the new area is valid.
- It checks if the new area overlaps another protection.
- It checks economy cost if required.
- It updates the protection size.
- It updates the physical protection stone if configured.
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.
Protection stones can appear in the protection shop if enabled.
Example:
shop:
enabled: trueEach 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.
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.
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.
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.
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.ymlbacked up before major changes.
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.
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.
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.