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

New Features

• Added inventory-craft flag - Block inventory crafting (2x2 grid) in regions
• Added Discord support link - Join our community: https://discord.gg/TCJAwsdqum

Breaking Changes

• Removed permit-completely flag - Use disable-completely instead (automatic migration included)
• Changed permit-workbenches CRAFT behavior - Now only blocks crafting table (3x3), not inventory crafting. Use deny-inventory-craft for inventory blocking.

Improvements

• Automatic message migration: permit-completely-blocked → disable-completely-blocked
• Automatic message key addition for new flags
• File-based region migration runs automatically on plugin load

Documentation

• Updated all documentation with new flags
• Added Discord community link
• Updated version compatibility tables

Note:

Existing permit-completely flags in region files will be automatically migrated to disable-completely on plugin load.

WorldGuard ExtraFlags Plus v4.3.7

🔨 New Flag: permit-workbenches

Block workbench usage and crafting in regions! Supports: ALL, clear, anvil, cartography, craft, ender, grindstone, loom, smithing, stonecutter.

Usage:

/rg flag spawn permit-workbenches ALL
/rg flag spawn permit-workbenches ALL,ender
/rg flag spawn permit-workbenches craft,anvil
/rg flag spawn permit-workbenches clear

Features:

• Blocks right-click on workbenches
• Blocks crafting table GUI and 2x2 inventory crafting
• Optional block placement blocking via config
• New config file: plugins/WorldGuard/config-wgefp.yml
• New message: permit-workbenches-blocked with {workbench} placeholder

🚫 New Flags: deny-item-drops & deny-item-pickup

Deny specific item drops and pickups in regions (works when WorldGuard's default flags are set to allow).

Usage:

/rg flag spawn deny-item-drops diamond,emerald
/rg flag spawn deny-item-pickup apple,bread

Features:

• Denies specific items from being dropped even if WorldGuard allows drops
• Denies specific items from being picked up even if WorldGuard allows pickups
• Works alongside WorldGuard's item-drop and item-pickup flags

🔧 Improvements

• Messages file renamed: messages.yml → messages-wgefp.yml (avoids conflicts)
• Fixed logic: explicit workbench types now take precedence over ALL keyword

📊 Stats

• Total Flags: 37 (was 34)
• Minecraft: 1.20 – 1.21.10
• WorldGuard: 7.0.13+
• Folia: ✅ Fully supported

🔄 Migration

• Rename plugins/WorldGuard/messages.yml to messages-wgefp.yml if you have custom messages
• New config-wgefp.yml will be auto-created

Bug Fixes Fixed Riptide Enchantment Blocking Fixed: permit-completely flag now fully blocks Riptide enchantment on tridents Prevents Riptide boost, spinning animation, and all movement effects Blocks right-click interactions before Riptide can activate Rotation locking prevents spinning animation if event somehow fires No longer requires enchantment removal (safer approach) ✨ New Features Block Placement & Breaking Control Added 4 new flags for fine-grained block control:

allow-block-place - Whitelist specific blocks that can be placed deny-block-place - Blacklist specific blocks from being placed allow-block-break - Whitelist specific blocks that can be broken deny-block-break - Blacklist specific blocks from being broken Usage Examples:

/rg flag spawn allow-block-place STONE,COBBLESTONE,GRASS_BLOCK /rg flag spawn deny-block-place TNT,LAVA_BUCKET /rg flag spawn allow-block-break STONE,COBBLESTONE /rg flag spawn deny-block-break BEDROCK,SPAWNER

🎉 Version 4.3.5 Release 🔄 Update Checker

Automatically checks for updates from Spigot, GitHub, and Modrinth Uses semantic version comparison for accurate update detection Shows formatted update notifications in console Runs automatically after server startup

🏪 Villager Trade Flag New villager-trade flag to control villager trading in regions Set to deny to prevent players from trading with villagers Fully Folia-compatible

🚫 Disable Collision Flag New disable-collision flag to disable player collision in regions Players can pass through each other when enabled Uses scoreboard teams for reliable collision control Fully Folia-compatible

📝 PlaceholderAPI Chat Integration Chat prefix and suffix now support PlaceholderAPI placeholders Automatically processes placeholders if PlaceholderAPI is installed Works seamlessly without PlaceholderAPI (graceful fallback) Example: /rg flag spawn chat-prefix "&7[%vault_rank%] "

🪓 Trident Support Added TRIDENT to permit-completely flag Now supports: MACE, FIREWORK_ROCKET, WIND_CHARGE, TOTEM_OF_UNDYING, TRIDENT Blocks all trident usage (throwing, melee, interactions)

📋 Technical Details All new features are fully Folia-compatible Update checker uses semantic version comparison PlaceholderAPI integration uses reflection (soft dependency) Collision system uses Bukkit scoreboard teams API

Details: github