Skip to content

Release 1.4.0

alexisleder edited this page Nov 8, 2026 · 1 revision

LederProtections v1.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.

Highlights

  • Opt-in public protection profiles and the /warps directory.
  • Safe public visits with warmup, cooldown, cancellation, and destination validation.
  • Bukkit TextDisplay holograms 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 LederAPI artifact for addon developers.
  • Additional validation, resource limits, and targeted cleanup for safer production use.

Public directory and profiles

  • Added public protection profiles with:
    • PRIVATE, PUBLIC_OPEN, and PUBLIC_CLOSED visibility;
    • custom titles and descriptions;
    • configurable categories;
    • whitelist-restricted visual icons;
    • welcome messages;
    • custom safe visit points;
    • per-protection hologram state.
  • Added /warps, with /pwarps and /protectionwarps aliases.
  • 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.

Holograms

  • Added Bukkit TextDisplay holograms with configurable content, height, view distance, line width, colors, and native protection variables.
  • Added a global holograms.enabled switch.
  • Added holograms.default-enabled for protections that use the DEFAULT state.
  • Added per-protection DEFAULT, ENABLED, and DISABLED states.
  • 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.

Environmental policies

  • Added inheritable DEFAULT, ALLOW, and DENY policies 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.

PlaceholderAPI

  • 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.

Public API and addon integrations

  • Added LederProtectionsApi#canOpenContainer for sell-wand and inventory addons that must validate access before changing protected contents.
  • Added canBreakBlock, canPlaceBlock, and canInteractWithBlock checks 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 /p addon 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 LederAPI project.
  • 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.

Quality of life

  • 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 reload now 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.

Personalization

  • 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.

Architecture and maintainability

  • 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.

Security and hardening

  • 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.

Performance and optimization

  • 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

  • Fixed directory.favorite.yes and directory.favorite.no being parsed as YAML boolean keys during upgrades.
  • Removed visible raw material names such as GRASS_BLOCK, SPAWNER, and WHEAT from the public icon selector.
  • Updated the default Spanish hologram heading from BLOQUE DE PROTECCION to PROTECCIÓN.
  • Updated the English fallback heading from PROTECTION BLOCK to PROTECTION.

Compatibility

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

Upgrade notes

  1. Stop the server and create a backup.
  2. Replace the previous LederProtections jar.
  3. Keep the existing config.yml, stones.yml, and language files.
  4. Start the server and allow the backup-aware updater to add missing 1.4.0 keys.
  5. Confirm /lep version reports 1.4.0 and run /lep check.
  6. Publish one test protection and verify /warps, one hologram, and every environmental policy used by the server.
  7. 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.

Areas for future improvement

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.

Recommended release validation

  1. Run a clean build of LederAPI and publish it to Maven Local.
  2. Run a clean LederProtections build against that artifact.
  3. Test first startup and an upgrade using copies of existing configuration and protection data.
  4. Exercise public visits, cancellation rules, favorites, search, holograms, and environmental boundaries.
  5. Test the API from a small addon and verify denied container access before inventory mutation.
  6. Review /lep info, /lep status, /lep check, and server logs before production rollout.

Modrinth metadata

  • 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

Clone this wiki locally