WorldGuard ExtraFlags Plus

Build & runtime

• Version 4.4.0 — feature and stability release after Folia/performance audit.
• Java 21 bytecode (--release 21) for broader Paper 1.21.x / 26.1–26.3 server compatibility.
• Paper API compile target: 26.1.2.build.67-stable; plugin.yml remains api-version: '1.21'.
• FoliaLib shading hardened: explicit shade includes + post-package check that WrappedBukkitTask and SpigotImplementation exist in the jar (fixes NoClassDefFoundError breaking command-on-entry and all schedulers on Paper 26.x).

Command flags

• Shared CommandFlagHandlerSupport for entry/exit player and console command flags.
• Entry commands dispatch only from entered regions with correct last-set tracking; exit commands run for all removed command sets.
• Player commands use runAtEntity; console commands use runNextTick.
• Scheduler self-test on enable logs SEVERE if FoliaLib is broken.

Config & startup (#14, #13)

• logging.verbose-startup-logs (default false) — quiet console on large servers.
• Config.initialize() in onLoad() before flag registration — disabled flags (e.g. glide) are not registered; reduces “plugin not installed” unknown-flag warnings.
• Chunk-unload tickets: one summary line per world; collision init only when flag enabled.

Give-effects (#15)

• PotionEffectFlag accepts night_vision, minecraft:night_vision, legacy names, and normalized spacing.

Keep-inventory & combat log

• keep-inventory-settings.combat-log-restore (default true) — DeluxeCombat soft integration: snapshot inventory on combat-log quit inside keep-inventory regions, restore on next join.
• Death handler priority HIGHEST so other plugins are less likely to clear drops after keep-inventory applies.

Block flags

• allow-block-place-settings.require-membership / allow-block-break-settings.require-membership — allow lists apply only to region members/owners (e.g. member-only sign placement).

New flag: hide-players (experimental)

• Opt-in via all-flags-control.hide-players: true, then /rg flag <region> hide-players true.
• Hides players from others while inside the region (hub/lobby optimization via Bukkit hidePlayer).

Join-location

• Improved Paper/Folia/Canvas detection — prefers AsyncPlayerSpawnLocationEvent over deprecated PlayerSpawnLocationEvent on modern servers.

Folia / performance audit fixes

• Collision apply on join/world-change via runAtEntity (not global runNextTick).
• Chambered ender pearl listener rewrite (thread-safety, scheduler).
• Player count limit uses world-scoped player scan.
• Chunk-unload batched async chunk tickets.
• Join-location fallback uses teleportAsync.
• Fly/godmode quit cache cleanup; entry-level placeholder cache eviction; onDisable task cancel.

Config documentation

• Inline comments for give-effects syntax, worldedit __global__ usage, glide disable behavior, hide-players setup.