Repository navigation
Changelog
See the complete 1.5.0 English/Spanish release notes.
- Customizable layouts for all 22 menus, optional heads and external-pack presentation.
- Simpler protection/public menus and paginated role rules without the Source line.
- New
/p home <name or ID>and immediate movement-based entry/exit notices. - Interactive inspection, stale-context checks and safer confirmation sessions.
- Bounded LRU icon caching and reduced repeated GUI work.
- Configuration cleanup with backed-up gui-style migration to menus.yml.
- No integrated resource pack or automatic pack delivery.
Complete English/Spanish changelog · Compatibility
GUI and hologram presentation improvements.
- Updated the project version to
1.4.1. - Replaced repeated icons in the protection menu with more distinct materials.
- Added optional Minecraft skin textures for directory categories, with configured material icons as fallback.
- Removed the large default background panel behind protection holograms while retaining text shadows.
- Changed the default hologram lines to show a welcome, protection name, owner (
{owner}), description, world and stone coordinates. - Made
{user}identify the player viewing the hologram and{owner}identify the protection owner. Holograms containing{user}are rendered as private per-viewer TextDisplays. - Added event-driven proximity reconciliation on block movement, join, respawn and chunk load; displays are cleaned up on exit and quit without periodic scans or forced chunk loads.
- Documented all native hologram variables in
config.yml, including the distinct{owner}and{user}meanings; PlaceholderAPI expansions in private holograms use the viewer's context and refresh without per-tick polling. - Existing custom hologram lines are preserved; replace
{user}with{owner}when an old line intended to display the protection owner. - Documented legacy
&colors and formatting for hologram lines. - Added a
head-texturecategory option. It accepts only a 64-character texture hash fromtextures.minecraft.net; blank keeps the category material. - Integrated bStats using plugin ID
34348for aggregate server and version statistics. LederProtections adds no custom charts or player/protection data. - Relocated bStats classes into LederProtections' namespace to avoid conflicts with other plugins.
See Minecraft-Heads for a browsable head catalogue. LederProtections does not query this site at runtime.
Public protection directory, holograms, and native environmental policies.
See the complete 1.4.0 release notes for behavior, customization, security, upgrade guidance, and future improvement areas.
- Added opt-in public protection profiles with configurable titles, descriptions, categories, icons, welcome messages, visit points, and visibility.
- Added the
/warpspublic directory with search, category filtering, sorting, favorites, visit counters, and pagination. - Added configurable public-visit warmups, cooldowns, movement/damage cancellation, cross-world control, and safe destination validation.
- Added administrator controls for featured and hidden directory entries.
- Added Bukkit
TextDisplayholograms with configurable lines, placeholders, range, height, and per-protection state. - Added inheritable per-protection environmental policies for hostile spawning, TNT, creepers, other explosions, and fire spread.
- Added
LederProtectionsApi#canOpenContainerso sell-wand and inventory addons can enforce the same container rules before mutating contents. - Added
canBreakBlock,canPlaceBlock, andcanInteractWithBlockpublic API checks for broader plugin integration. - Added complete public-directory, hologram, role, bounds, limit, and compatibility placeholders.
- Moved the public API source into the standalone
LederAPIproject and versioned artifactcom.alexisleder:lederprotections-api:1.0.0.
- Environmental explosion and fire decisions now use LederProtections policies while protection-boundary barriers remain enforced independently.
- Existing bundled configuration and language files receive missing 1.4.0 keys through the safe merge and backup system.
- Existing protections remain private by default until their public profile is explicitly changed.
-
/lep reloadnow refreshes optional compatibility hooks and safely replaces the internal PlaceholderAPI expansion. - Placeholder requests from asynchronous consumers now use bounded main-thread resolution, short-lived caches and deduplicated work.
- Native imports, update responses, addon tab completions and audit writes now enforce defensive limits.
- Fixed
directory.favorite.yesanddirectory.favorite.nobeing parsed as YAML boolean keys during upgrades. - Removed raw material identifiers from public icon selector item titles while retaining lore, PDC identification, and whitelist validation.
- Updated the default hologram heading to
PROTECCIÓNin Spanish andPROTECTIONin the English fallback.
- No manual protection-data migration is required.
- Existing administrator customizations are preserved; missing keys are added without replacing entire YAML files.
- Customized
holograms.lineslists are not overwritten. - The public API contract remains version
1.0.
- Public destinations now include search, categories, sorting, favorites, visit counters, and pagination.
- Protection publication is opt-in; existing protections stay private after upgrading.
- Public icon names are player-friendly and no longer expose raw Bukkit material identifiers.
-
/lep reloadapplies compatibility, directory, hologram, and PlaceholderAPI changes without requiring a complete server restart. - New configuration and language keys use the backup-aware merge system and preserve customized values.
- Server owners can configure public categories, allowed icons, visit behavior, directory rules, and safe-teleport controls.
- Players can customize public titles, descriptions, welcome messages, visibility, visit points, and hologram state within configured limits.
- Holograms support global, default, and per-protection state plus configurable lines, height, view distance, line width, and colors.
- Environmental defaults can be inherited or overridden per protection.
- The public API contract now lives in the standalone
LederAPIproject while private implementations remain in LederProtections. - Addons obtain the API through Bukkit's
ServicesManagerand consume immutable snapshots instead of private classes. - Directory, hologram, compatibility, and placeholder responsibilities are isolated in dedicated services.
- Holograms avoid per-tick world scans and use targeted loaded-chunk cleanup.
- Placeholder work is cached, deduplicated, bounded, and safely transferred to the primary thread when required.
- Protection mutation events are coalesced so consumers observe coherent repository and spatial-index state.
- The default release continues to compile against Spigot API 1.21.1 and Java 21 for the widest 1.21.x compatibility.
- The same sources also compile against Spigot API 26.3, WorldGuard 7.0.19, and WorldEdit 7.4.5 using Java 25.
- The plugin does not require Paper-only, Adventure, CraftBukkit, or NMS classes at runtime.
- Bukkit/Spigot
TextDisplayis used for holograms. - Spigot, Paper, Purpur, and Pufferfish 1.21.x and compatible 26.x builds are supported targets; Paper remains recommended when a stable build exists.
- Java 21 is required for 1.21.x; Minecraft 26.1+ and its current WorldGuard/WorldEdit builds require Java 25.
- Folia is not supported yet.
The following are roadmap candidates, not 1.4.0 promises:
- Automated runtime regression tests on real Spigot, Paper, Purpur, and Pufferfish servers.
- A complete Folia scheduler and region-thread audit.
- Public Maven hosting, CI releases, signed API artifacts, and binary compatibility checks.
- Deeper optional integrations for hooks that currently provide detection or limited compatibility.
- Configurable PlaceholderAPI boolean and empty-value output styles.
- Additional timings, profiling, and large-network integration tests.
Public addon API release.
- Added the versioned
LederProtectionsApiservice, obtainable through Bukkit'sServicesManager. - Added immutable protection, bounds, and teleport-home snapshots with stable protection IDs.
- Added stored and effective role queries, member-feature checks, and addon-setting management checks.
- Added bounded safe-location searches that reuse the protection teleport safety policy and support an interior margin.
- Added snapshot-based safe-location searches for landing after a protection is removed.
- Added non-cancelable create, change, and removal lifecycle events with change categories.
- Added a formal registry for addon subcommands under
/p, including permissions, tab completion, reserved-name validation, and automatic cleanup when the addon is disabled. - Added developer integration documentation in
docs/API.md. - Added a dedicated API jar and Maven Local publication configuration under
com.alexisleder:lederprotections-api:1.0.
- Protection mutations in one server cycle are coalesced before lifecycle events are published, preventing transient import rollback states from leaking to addons.
- Coalesced removal events retain the last record actually deleted, so snapshot-based safety uses the correct final bounds and home.
- Lifecycle events are published on the next main-thread cycle so the repository and spatial index are coherent when listeners receive them.
- Public effective roles now reserve
ADMINforlederprotections.admin; rule-engine bypass permissions never grant addon membership. -
BLOCKEDnow has explicit precedence in member-feature checks, including over the global administrator permission. - Stored-role resolution also gives
BLOCKEDprecedence over accidentally overlapping owner, co-owner, or member entries.
- The public API contract version is
1.0; it is intentionally independent from the plugin version1.3.0. - No protection-data or configuration migration is required.
- Existing security listeners and rules are unchanged.
Protection-boundary and automation security hotfixes.
- Added
container-openas an independent rule for dispensers, droppers, hoppers, furnaces, brewing stands, crafters, and other functional containers. - Added persistent origin tracking for falling blocks and dispenser projectiles without resident projectile maps.
- Added authoritative dispenser projectile checks for impacts, entity damage, fire, explosions, splash potions, and lingering potion clouds.
- Purely environmental block formation is allowed inside protections while entity-caused formation is validated separately.
-
pressure-plate-usenow also documents and controls tripwire and redstone ore for backward-compatible configuration keys. - New installations deny visitor physical-trigger use by default. Existing configured values remain preserved during updates.
- Redstone boundary checks now compare direct power per face and retain legitimate internal power when internal and external signals coexist.
- Ender chests are governed by
chest-open; other functional containers usecontainer-open.
- Fixed natural snow, ice, fluid generators, concrete hardening, snow golems, and authorized Frost Walker being blocked by the environmental listener.
- Fixed automatic bone meal and moss growth crossing from outside or between different protections.
- Fixed pressure plates, farmland trampling, turtle eggs, tripwire, and redstone ore bypassing physical-interaction rules.
- Fixed exterior pressure plates and foreign redstone sources activating protected mechanisms.
- Fixed visitors opening dispensers, droppers, hoppers, furnaces, and similar containers without a dedicated rule.
- Fixed Endermen, falling blocks, villagers, sheep, and other entity block changes not enforcing protection boundaries consistently.
- Fixed dispenser projectiles relying only on a short trajectory prediction and allowing distant secondary effects.
- Fixed protected dispensers firing when their only direct power source belonged to the exterior or another protection.
- Fixed duplicate entity-interaction message cooldown entries remaining after players disconnected.
- No protection-data migration is required.
- Missing
container-openkeys and translations are merged automatically without overwriting customized values. - Existing
pressure-plate-usevalues are intentionally preserved; administrators upgrading from an older config should review that rule for visitors.
Entity protection rules and safer configuration updates.
- Added
entity-interactto control interactions with villagers, animals, and other living entities inside protections. - Added
entity-damageto protect villagers, golems, mobs, and other non-animal living entities from unauthorized player damage. - Added automatic bundled configuration updates for
config.yml,stones.yml,lang/es.yml, andlang/en.yml. - Added backup and default-snapshot handling so new config keys can be merged without overwriting user customizations.
- Existing
animal-damage, PvP, and decorative entity rules remain separate to preserve existing behavior. -
/lep reloadnow applies safe bundled config/language updates before reloading registries.
- Fixed villagers and other non-animal living entities not having dedicated native protection rules.
- Fixed duplicated denied-action chat messages when right-clicking protected entities such as villagers.
- No protection data migration is required.
- Existing user config values are preserved. Missing bundled keys are added automatically on startup or
/lep reload. - Server owners should still back up before updating and test on a staging server when possible.
First stable release.
- Promoted the plugin version from
1.0.0-beta.8to1.0.0. - Cleaned
/lep versionso it only shows the plugin core version and update checker status. - Kept detailed runtime diagnostics in
/lep infoand/lep status.
- This release includes the beta.8 dispenser projectile boundary fix.
- Public documentation updates remain pending for the final documentation pass.
Security and protection-boundary fix.
- Blocked dispenser/dropper projectiles from damaging entities across protection borders.
- Prevented arrows and similar projectiles from being used as protected-area turrets from inside to outside.
- Prevented arrows and similar projectiles from being used to damage entities inside protections from outside.
- Projectiles fired by machines are still allowed when both source and target are inside the same protection, or when both are outside protections.
Release polish and startup diagnostics.
- Improved update checker startup logging when the installed version is already up to date.
- Improved update checker startup logging when the installed version is newer than the current Modrinth release.
- Replaced deprecated PvP knockback event handling with a short PlayerVelocityEvent-based cancellation window.
- The update checker still only notifies; it does not download or install updates automatically.
- The PvP change keeps blocked hits from applying knockback while avoiding Paper's deprecated event warning.
Update checker integration and release polish.
- Added a lightweight update checker with the official Modrinth source built in.
- Added async version checks against the public Modrinth project versions endpoint.
- Added admin join notifications for newer versions.
- Added
lederprotections.updatepermission. - Added Spanish and English update notification messages.
- The checker does not download or install anything automatically.
- The public update source is built into the plugin; config only controls whether startup checks and admin join notices are enabled.
- Update notices redirect admins to the public Modrinth page.
Quality-of-life, admin browser and player notification update.
- Added filters and sorting to the
/lep adminprotection browser. - Added creation date display in the admin protection browser.
- Added permission-based protection limits for server ranks.
- Added action bar notices when entering or leaving protections.
- Added per-player preferences to enable or disable entry/exit notices.
- Polished Spanish and English chat messages to be shorter and clearer.
- Improved localization for admin browser filters and sorting labels.
- Improved
/pplayer menu usability with a notification preference button. - Improved admin protection browsing with clearer filter and sort feedback.
- Fixed missing Spanish notification preference messages.
- Fixed the admin browser player-head button so it shows the viewer skin.
- Fixed leftover documentation and support-template cleanup before release.
- Spigot 1.21.x
- Paper 1.21.x
- Purpur 1.21.x
- Pufferfish 1.21.x
- Java 21
- WorldGuard
- WorldEdit
- Vault
- PlaceholderAPI
- Paper is recommended for production servers.
- Folia is not supported yet.
- Older Minecraft versions before 1.21 are not officially supported.
- This is still a beta release. Testing on a staging server is recommended before production usage.
Production hardening and admin tools update.
- Added
/lep admin, a dedicated admin GUI to browse all server protections. - Added
lederprotections.admin.protectionspermission. - Added owner, location, type, size and member information to the admin protection browser.
- Added safer persistence handling for protection updates.
- Added better protection data recovery behavior through safer save handling.
-
/pnow only shows protections where the player has a normal relationship, such as owner, co-owner or member. - Admins no longer see every server protection in the normal player menu.
- Global protection browsing is now separated into
/lep admin. - Improved command permission handling.
- Improved optional protection ID behavior in commands.
- Improved economy transaction safety for shop purchases, upgrades and teleport costs.
- Fixed shop purchases with full inventory. The player is no longer charged and the item is no longer dropped on the ground.
- Fixed PvP denial behavior to prevent unwanted knockback.
- Reduced PvP denial message spam.
- Improved protection update handling so commands and GUIs no longer show success if saving fails.
- Improved consistency between protection data, lookup index and WorldGuard updates.
- Spigot 1.21.x
- Paper 1.21.x
- Purpur 1.21.x
- Pufferfish 1.21.x
- Java 21
- WorldGuard
- WorldEdit
- Vault
- PlaceholderAPI
- Paper is recommended for production servers.
- Folia is not supported yet.
- Older Minecraft versions before 1.21 are not officially supported.
- This is still a beta release. Testing on a staging server is recommended before production usage.
Compatibility update for Minecraft 1.21.x servers.
- Added tested support for Spigot 1.21.x.
- Confirmed compatibility with Paper 1.21.x.
- Confirmed compatibility with Purpur 1.21.x.
- Confirmed compatibility with Pufferfish 1.21.x.
- Added
/lep info,/lep statusand/lep versiondiagnostic commands. - Added runtime platform detection.
- Migrated the visual layer to Bukkit/Spigot-compatible APIs.
- Removed mandatory Paper/Adventure runtime requirements from messages, GUIs and items.
- Updated compatibility target from Paper-only to Spigot/Paper/Purpur/Pufferfish 1.21.x.
- Paper became recommended instead of required.
- Fixed startup failure on Spigot caused by missing Adventure classes.
- Improved GUI protection against shift-click, drag, hotbar swap, double click and ghost items.
- Improved inventory synchronization when closing GUIs quickly on Spigot.
Initial public beta release.
- Protection stones.
- Configurable protection sizes.
- WorldGuard region integration.
- WorldEdit dependency support.
- Protection creation by placing stones.
- Protection removal when breaking stones.
- Configurable return of protection stones.
- Configurable protection shop.
- Vault economy support.
- Teleport system.
- Teleport warmup.
- Teleport movement cancellation.
- Protection border preview.
- GUI-based protection management.
- Protection list GUI.
- Protection management GUI.
- Members GUI.
- Co-owner support.
- Visitor rules.
- Blocked player support.
- Role-based protection rules.
- Protection upgrades.
- PlaceholderAPI support.
- English language file.
- Spanish language file.
- Configuration validation.
- Anti-exploit protections.
- Protection diagnostics.
- Repair commands.
- Debug logging options.
- Java 21
- Minecraft 1.21.x
- WorldGuard
- WorldEdit
- Vault
- PlaceholderAPI