Skip to content

Installation

alexisleder edited this page Sep 27, 2026 · 6 revisions

Installation

This page explains how to install LederProtections on a Bukkit-compatible Minecraft server.

Requirements

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.

Install

  1. Stop the server.
  2. Confirm the Java version with java -version.
  3. Install matching Bukkit builds of WorldEdit and WorldGuard.
  4. Place LederProtections-1.4.1.jar in the server's plugins directory.
  5. Optionally install Vault, an economy plugin, and PlaceholderAPI.
  6. Start the server and check the console for dependency or configuration errors.
  7. 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.

Basic test

  1. Give yourself a protection stone.
  2. Place it and confirm that the protection and WorldGuard region are created.
  3. Open /p and verify the protection appears.
  4. Test the border preview and the rules used by the server.
  5. Publish one temporary test protection and verify /warps and its hologram.
  6. Join with a non-administrator account and confirm it receives no unintended access.

Updating

  1. Stop the server and create a tested backup.
  2. Replace the old LederProtections jar.
  3. Keep the existing configuration, language, and protection-data files.
  4. Start the server and allow the backup-aware updater to add missing keys.
  5. Run /lep version and /lep check.
  6. Repeat the basic test before reopening a production server.

The update checker only reports updates; it never downloads or installs them.

Common problems

The plugin does not load

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.

WorldGuard connection failed

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.

Economy features do not work

Vault is only a bridge. Install Vault plus a compatible economy provider, enable the relevant LederProtections options, and verify /lep hooks.

Placeholders do not work

Install PlaceholderAPI, restart the server, verify /lep hooks, and check the placeholder name against PlaceholderAPI.

Next pages

Clone this wiki locally