Changelog - Release 4.3.13

4.3.13

disable-throw region flag

• SetFlag listing EGG, SNOWBALL, ENDER_PEARL, EXPERIENCE_BOTTLE only (validated by ThrowableItemFlag); ProjectileLaunchEvent cancellation + disable-throw-blocked message ( messages-wgefp.yml ). Trident / wind charge remain on disable-completely. Toggle via config-wgefp.yml all-flags-control.disable-throw.

Build / runtime targets (Maven)

• Minecraft / Paper 26.1.2: compile against io.papermc.paper:paper-api pinned to 26.1.2.build.60-stable (matches Paper repo maven-metadata.xml release at time of update); bump this property when Paper ships newer 26.1.2.build.* builds. org.spigotmc:spigot-api removed — Paper supplies the Bukkit API (Paper project setup).
• javac --release 25 per Paper’s 26.1.x toolchain recommendation (same doc).
• plugin.yml: api-version: '1.21' so Paper / forks (e.g. Canvas) 1.21.x accept the jar at load time; declaring 26.1.2 causes Unsupported API version on those servers (Paper plugin.yml).
• Still bundled vs provided: WorldEdit 7.3.18, WorldGuard 7.0.15-SNAPSHOT, FAWE-Core 2.12.0, bstats 3.1.0, ConfigLib 4.8.0, Lombok 1.18.46, shade 3.6.2. paper-repo remains last in <repositories> to avoid probing EngineHub coords against Paper first.

Join location (Paper / Folia)

• When join-location is enabled and the server provides Paper's AsyncPlayerSpawnLocationEvent, register AsyncJoinLocationListener instead of deprecated Spigot PlayerSpawnLocationEvent, avoiding startup deprecation noise (aligned with PR #12).
• Plain Spigot (no async API): unchanged JoinLocationListener and existing deprecation console hint.
• JoinLocationPlayerJoinListener (PlayerJoinEvent, monitor): if join-location resolves at the player's spawn position and differs by block, teleport on the entity scheduler. Covers Folia (and similar cases) where async spawn handlers cannot reliably apply region queries before login (Issue #1); uses LocalPlayer for the query like JoinLocationListener.

WorldEdit flag + FastAsyncWorldEdit (FAWE)

• WorldEditFlagHandler now intercepts FAWE batch extent APIs (setBlocks, replaceBlocks, coordinate setBlock, setBiome) in addition to per-block setBlock, so worldedit DENY is much harder to bypass under FAWE (addresses Issue #7–style gaps).
• Compile against FastAsyncWorldEdit-Core provided (Modrinth Maven); WorldGuard’s transitive WorldEdit jars are excluded on the Spigot module so the patched AbstractDelegateExtent API matches runtime FAWE/WorldEdit.
• Optional permissions: worldguardextraflagsplus.worldedit.bypass, worldguardextraflagsplus.worldedit.silent-deny.
• New message key worldedit-denied in messages-wgefp.yml / PluginMessages (reload to customize).

Disabled flags in config-wgefp.yml (handler null-safety)

• When all-flags-control turns off fly or give-effects, WorldGuard does not register those session handlers — Session#getHandler returns null. PlayerListener, EntityPotionEffectEventListener, and RemoveEffectPacketListener now check Config.isFlagEnabled and null handlers before use (fixes Issue #9 NPE on e.g. PlayerChangedWorldEvent).

fly after PLUGIN teleports (portals)

• After PlayerTeleportEvent (monitor), re-query fly at the destination and call FlyFlagHandler#refreshFlyFromApplicableSet, so flight matches regions when session move hooks do not run (e.g. Issue #8 portal plugins).

command-on-entry / console-command-on-entry

• initialize(LocalPlayer, …) added so commands run when the session starts already inside a region with the flag (previously only onCrossBoundary fired, so login/spawn inside the region did nothing). console-command-on-entry also aligns isEmpty checks with command-on-entry.
• Command strings: strip a leading / only when present — YAML pasted without / no longer turns say hi into ay hi. command-on-exit / console-command-on-exit use the same helper; skip blank lines after processing.

disable-completely — Vanilla spears (1.21.11+)

• Block spear items: tier materials (WOODEN_SPEAR, STONE_SPEAR, COPPER_SPEAR, IRON_SPEAR, GOLDEN_SPEAR, DIAMOND_SPEAR, NETHERITE_SPEAR) and the SPEAR shorthand (all tiers).
• Riptide interaction blocking extended to spears as well as tridents when the item is disabled in the region.
• Spear Lunge (packet STAB, including Lunge enchant use) is only reliably blocked when PacketEvents or ProtocolLib is installed; without either, Lunge may bypass Bukkit-only checks.

Packet-level blocking (optional plugins)

• disable-completely registers PacketEvents listeners when the PacketEvents plugin is present (primary): cancels relevant serverbound packets including spear Lunge via digging action STAB, plus use/interact/placement paths as implemented.
• ProtocolLib is supported as a fallback when PacketEvents is not used or hook registration fails.

Safe startup without PacketEvents / ProtocolLib

• Main plugin class avoids hard references to PacketEvents and ProtocolLib APIs; registration uses reflection so the jar loads cleanly when optional dependencies are absent (provided / softdepend).
• PacketEvents API entry uses com.github.retrooper.packetevents.PacketEvents (correct package); avoids bogus io.github.retrooper... lookups that broke hook registration at runtime.
• ProtocolLibHelper (give-effects) registers its listener via reflection only so the helper class does not require ProtocolLib on the classpath at load time.

New flag: chambered-enderpearl (experimental)

• Experimental. State flag to mitigate chambered ender pearl style bypasses: tracks pearls thrown outside flagged regions and removes them when the shooter enters a region where the flag denies the behavior (handler + session integration; configurable via config-wgefp.yml flag toggle like other flags). Behavior and defaults may change in future releases.

Update log: https://github.com/tins-dev/WorldGuardExtraFlagsPlus/releases/tag/v.4.3.11

Disable Collision Flag - Major Refactor

Implementation Changes

• Minecraft teams: Now uses Minecraft's native scoreboard team system (the only reliable method for entity-to-entity collision)
• Hybrid team-based approach:
  • If a player is the only member of their team, the plugin temporarily modifies that team's collision rule
  • If a player is in a team with multiple members, creates a per-player team (WGC_<hash>) to avoid affecting others
  • If a player has no team, adds them to a per-player team with collision disabled

TAB Plugin Integration

• Full API integration: Added TAB plugin support with API integration
• Priority handling: TAB integration takes priority over direct team manipulation when TAB is installed
• Conflict prevention: Uses TAB's API to set collision rules, preventing TAB from overwriting collision settings
• Automatic fallback: If TAB is not available, automatically falls back to direct team manipulation

Without TAB (Normal Usage)

• Direct team manipulation: Uses Bukkit's Scoreboard API to directly modify team collision rules
• Team restoration: Properly restores original team collision rules when players leave regions
• Per-player teams: Creates temporary per-player teams when needed to avoid conflicts with shared teams
• Cleanup on disable: Properly cleans up all teams and restores original settings when plugin disables

Warnings and Compatibility

• Load-time warning: Displays a warning on plugin load about potential conflicts with team-using plugins
• Known plugin detection: Warns about potential conflicts with couple known plugin names
• TAB support indication: Shows supported plugins

Documentation Updates

• Updated documentation: Comprehensive documentation file updated with TAB integration details
• Troubleshooting guide: Added troubleshooting information for team conflicts

Fixed

• Fixed command-on-entry and command-on-exit flags causing thread check errors on Folia servers by using entity scheduler instead of global scheduler for player command dispatch
• Fixed disable-collision flag causing player disconnections on Paper servers by properly handling IllegalStateException when removing players from teams
• Fixed disable-collision flag on Folia servers - feature is now automatically disabled if team creation is not supported (prevents errors and warnings)

Added

• Added support for %player% and {player} placeholders in command-on-entry, command-on-exit, console-command-on-entry, and console-command-on-exit flags (in addition to existing %username% and {username} placeholders)
• Added EssentialsX godmode integration - the godmode flag now also disables EssentialsX godmode when entering regions with godmode disabled (EssentialsX is now a soft dependency)

Changed

• Migrated configuration management to ConfigLib library for improved maintainability, automatic comment preservation, and better error handling
• Updated API version to 1.21 - plugin now officially supports Paper 1.21.10+, Spigot 1.21.x, and Folia 1.21.x