Repository navigation
Release 1.4.0
Public protection profiles, a player-facing warp directory, Bukkit-native holograms, environmental controls, a broader PlaceholderAPI integration, and a standalone public developer API.
This release lets server communities publish selected protections as safe destinations without granting visitors build or management access. Existing protections remain private until their visibility is changed.
- Opt-in public protection profiles and the
/warpsdirectory. - Safe public visits with warmup, cooldown, cancellation, and destination validation.
- Bukkit
TextDisplayholograms that can be controlled globally and per protection. - Native environmental policies for hostile spawning, explosions, and fire.
- A substantially expanded and async-safe PlaceholderAPI integration.
- A standalone, versioned
LederAPIartifact for addon developers. - Additional validation, resource limits, and targeted cleanup for safer production use.
- Added public protection profiles with:
-
PRIVATE,PUBLIC_OPEN, andPUBLIC_CLOSEDvisibility; - custom titles and descriptions;
- configurable categories;
- whitelist-restricted visual icons;
- welcome messages;
- custom safe visit points;
- per-protection hologram state.
-
- Added
/warps, with/pwarpsand/protectionwarpsaliases. - Added a paginated directory with search, category filtering, favorites, visit counters, and featured, popular, recent, and alphabetical sorting.
- Added administrator controls for featuring or hiding directory entries.
- Added visit warmups, cooldowns, movement and damage cancellation, cross-world control, and safe-destination validation.
- Kept public discovery separate from protection authorization: publishing never grants build, container, member, or management permissions.
- Added Bukkit
TextDisplayholograms with configurable content, height, view distance, line width, colors, and native protection variables. - Added a global
holograms.enabledswitch. - Added
holograms.default-enabledfor protections that use theDEFAULTstate. - Added per-protection
DEFAULT,ENABLED, andDISABLEDstates. - Added validation and safe limits for hologram lines, text length, dimensions, and viewing range.
- Holograms use persistent data identification and synchronize with loaded chunks without a per-tick world scan.
- Cleanup is targeted to the protection stone chunk instead of searching every entity in every world.
- Added inheritable
DEFAULT,ALLOW, andDENYpolicies for:- hostile mob spawning;
- TNT explosions;
- creeper explosions;
- other environmental explosions;
- fire spread and environmental ignition.
- Environmental decisions are handled natively by LederProtections.
- Protection-boundary barriers remain enforced independently, so disabling an internal environmental decision does not permit effects to cross from outside or between different protections.
- Expanded placeholder coverage for:
- plugin and API versions;
- protection totals and feature state;
- optional hook state;
- player owner, co-owner, member, accessible, blocked, and administrator counts;
- global and per-type limits and remaining capacity;
- current protection identity, name, type, owner, role, world, coordinates, bounds, dimensions, area, and volume;
- current member counts and role booleans;
- public profile metadata, visibility, category, favorites, and visits;
- hologram effective state.
- Internal expansion registration is persistent and reload-safe.
- Unknown placeholders return
null, as expected by PlaceholderAPI. - Async consumers use bounded main-thread resolution, short-lived caches, stale-value fallback, deduplicated work, a maximum cache size, and a maximum in-flight request count.
- Shared role-count data avoids repeating the same repository work for related placeholders.
- Added configurable cache duration and async timeout settings.
- Added
LederProtectionsApi#canOpenContainerfor sell-wand and inventory addons that must validate access before changing protected contents. - Added
canBreakBlock,canPlaceBlock, andcanInteractWithBlockchecks for broader integrations. - Invalid, unloaded, or unavailable locations fail closed, and API checks do not force chunk loads.
- Retained immutable protection, bounds, role, and teleport snapshots; safe-location searches; lifecycle events; and
/paddon command extensions from API 1.0. - Command-extension ownership, names, permissions, and tab-completion results are validated and bounded.
- Moved the public contract into the standalone
LederAPIproject. - Published coordinates:
com.alexisleder:lederprotections-api:1.0.0. - The private plugin repository now keeps only the internal implementation and registry implementation; consumers compile against the public contract.
- Added player-friendly search, filters, sorting, favorites, visit counters, and pagination to public destinations.
- Removed raw Bukkit material identifiers from public icon selector titles while preserving status lore, PDC identity, and whitelist validation.
- Existing protections stay private by default, preventing accidental publication during an upgrade.
-
/lep reloadnow refreshes optional compatibility hooks, the public directory, holograms, and the internal PlaceholderAPI expansion. - Missing configuration and language keys are merged through the existing backup-aware updater without replacing administrator customizations.
- Added more complete diagnostics through placeholders and existing information commands.
- Public directory categories, allowed icons, profile title, description, welcome message, visibility, featured state, and visit point are configurable.
- Public visit warmup, cooldown, cancellation behavior, cross-world access, and safety checks are configurable.
- Holograms support configurable global state, default state, text lines, height, view distance, line width, colors, and per-protection overrides.
- Environmental defaults can be customized globally and overridden per protection.
- Existing stone types, rule defaults, limits, GUI text, messages, and Spanish/English language files remain configurable.
- Separated the stable public API contract from the closed-source plugin implementation.
- The API is provided through Bukkit's
ServicesManager, avoiding direct access to private plugin classes. - The standalone API build produces the main jar, source jar, Javadocs, and Maven publication metadata under an Apache 2.0 license.
- Protection snapshots exposed to addons remain immutable.
- Mutation events are coalesced and delivered after repository and spatial-index state is coherent.
- Directory, hologram, compatibility, and placeholder responsibilities remain isolated in dedicated services.
- Configuration continues to be divided by purpose and upgraded through safe missing-key merges.
- Native YAML imports are limited to 16 MiB and 50,000 protections per import.
- Imported identifiers, roles, text, bounds, stone locations, and world-height ranges are validated before being accepted.
- Control characters and excessive text lengths are rejected.
- Update-check responses are limited to 1 MiB.
- Placeholder caches and pending async requests are bounded.
- Addon tab completions are bounded and validated.
- Audit file appends are serialized to avoid concurrent write corruption.
- Public API location checks fail closed and avoid loading chunks as a side effect.
- Holograms do not require a per-tick world or entity scan.
- Hologram removal targets the relevant loaded chunk.
- Placeholder lookups reuse short-lived cached values, deduplicate pending main-thread work, and share role counts.
- Repository-backed mutation events are coalesced within the same server cycle.
- Public destination and safety checks reuse existing indexes and bounded safe-location logic.
- Fixed
directory.favorite.yesanddirectory.favorite.nobeing parsed as YAML boolean keys during upgrades. - Removed visible raw material names such as
GRASS_BLOCK,SPAWNER, andWHEATfrom the public icon selector. - Updated the default Spanish hologram heading from
BLOQUE DE PROTECCIONtoPROTECCIÓN. - Updated the English fallback heading from
PROTECTION BLOCKtoPROTECTION.
| Target | Status |
|---|---|
| Minecraft 1.21.x | Supported; Java 21 |
| Minecraft 26.1-26.3 | Supported API target; Java 25 |
| Spigot 1.21.x | Supported; default compile target is Spigot API 1.21.1 |
| Spigot 26.x | Compiled successfully against Spigot API 26.3 |
| Paper 1.21.x | Supported and recommended |
| Paper 26.x | Supported API target when a stable build exists |
| Purpur/Pufferfish | Supported when the fork and required dependencies support the selected version |
| Folia | Not supported yet |
The plugin source compiles against public Spigot/Bukkit APIs and does not require Paper-only, Adventure, CraftBukkit, or NMS classes at runtime. Holograms use the Bukkit/Spigot TextDisplay API. The compatibility matrix passes with Spigot API 1.21.1, WorldGuard 7.0.14, WorldEdit 7.3.14, and Java 21; it also passes with Spigot API 26.3, WorldGuard 7.0.19, WorldEdit 7.4.5, and Java 25.
The normal release jar remains Java 21 bytecode so it can run on both Java 21 and newer Java runtimes. Minecraft 26.1+ servers and their matching current WorldEdit/WorldGuard releases require Java 25. A staging-server smoke test is still recommended for every production server and fork.
Required dependencies:
- WorldGuard
- WorldEdit
Optional dependencies:
- Vault
- PlaceholderAPI
- LuckPerms and the compatibility integrations listed in
plugin.yml
- Stop the server and create a backup.
- Replace the previous LederProtections jar.
- Keep the existing
config.yml,stones.yml, and language files. - Start the server and allow the backup-aware updater to add missing 1.4.0 keys.
- Confirm
/lep versionreports1.4.0and run/lep check. - Publish one test protection and verify
/warps, one hologram, and every environmental policy used by the server. - Confirm a visitor does not receive additional build, container, or management access.
No manual protection-data migration is required. Existing customized values and customized holograms.lines lists are preserved. Existing protections remain private by default.
These items are not part of the 1.4.0 feature promise:
- Add automated runtime regression tests on real Spigot, Paper, Purpur, and Pufferfish servers in addition to compile verification.
- Add Folia-compatible scheduling after a full audit of region-thread ownership.
- Publish LederAPI to a public Maven repository with CI releases, signed artifacts, API compatibility checks, and automated Javadocs.
- Add deeper optional integrations for hooks that currently provide detection or limited compatibility only.
- Add configurable placeholder output styles for booleans and empty values.
- Add profiling and timing diagnostics for very large protection networks.
- Expand automated import, teleport, directory, and hologram integration tests.
- Continue improving GUI theming and server-owner control without exposing unsafe free-form materials or actions.
- Run a clean build of
LederAPIand publish it to Maven Local. - Run a clean LederProtections build against that artifact.
- Test first startup and an upgrade using copies of existing configuration and protection data.
- Exercise public visits, cancellation rules, favorites, search, holograms, and environmental boundaries.
- Test the API from a small addon and verify denied container access before inventory mutation.
- Review
/lep info,/lep status,/lep check, and server logs before production rollout.
- Version number:
1.4.0 - Version title:
LederProtections 1.4.0 — Public Warps & Environment Controls - Release channel:
release - Supported game versions:
1.21.x,26.1,26.2,26.3 - Loaders:
bukkit,paper,purpur,spigot - Environment:
server_only