Repository navigation
Installation
This page explains how to install LederProtections on a Bukkit-compatible Minecraft server.
| Requirement | Version / status |
|---|---|
| Minecraft |
1.21.x or 26.1-26.3
|
| Java | Java 21 for Minecraft 1.21.x; Java 25 for Minecraft 26.1+ |
| Server | Spigot, Paper, Purpur, or Pufferfish build compatible with the selected Minecraft version |
| WorldEdit | Required; use a build matching the server version |
| WorldGuard | Required; use a build matching the server version |
Paper is recommended when a stable build exists. Folia is not currently supported.
- Stop the server.
- Confirm the Java version with
java -version. - Install matching Bukkit builds of WorldEdit and WorldGuard.
- Place
LederProtections-1.4.1.jarin the server'spluginsdirectory. - Optionally install Vault, an economy plugin, and PlaceholderAPI.
- Start the server and check the console for dependency or configuration errors.
- Run
/lep version,/lep info,/lep hooks, and/lep check.
The release jar includes the bStats library; no separate bStats plugin jar is
needed. Metrics are opt-out through the shared plugins/bStats/config.yml.
Do not use /reload. Restart the server after installing, removing, or replacing plugin jars.
- Give yourself a protection stone.
- Place it and confirm that the protection and WorldGuard region are created.
- Open
/pand verify the protection appears. - Test the border preview and the rules used by the server.
- Publish one temporary test protection and verify
/warpsand its hologram. - Join with a non-administrator account and confirm it receives no unintended access.
- Stop the server and create a tested backup.
- Replace the old LederProtections jar.
- Keep the existing configuration, language, and protection-data files.
- Start the server and allow the backup-aware updater to add missing keys.
- Run
/lep versionand/lep check. - Repeat the basic test before reopening a production server.
The update checker only reports updates; it never downloads or installs them.
Check that:
- Java matches the Minecraft generation: Java 21 for 1.21.x or Java 25 for 26.1+;
- WorldEdit and WorldGuard are installed and match the server version;
- there is only one LederProtections jar;
- the complete startup error is reviewed before changing configuration.
Install the Bukkit versions of both WorldEdit and WorldGuard. Start the server again and resolve their startup errors first; LederProtections cannot initialize its region backend until both dependencies load correctly.
Vault is only a bridge. Install Vault plus a compatible economy provider, enable the relevant LederProtections options, and verify /lep hooks.
Install PlaceholderAPI, restart the server, verify /lep hooks, and check the placeholder name against PlaceholderAPI.