GriefPrevention GUI Addon v4.12

New Features​

Folia Support​

Added support for the Folia server platform. All core systems — including claim teleportation, ClaimFly, timed flight, and economy transactions — have been tested and adapted for Folia's regionized threading model.

Chunk Claiming Interface (Experimental)​

Introducing /claim chunk — a fully interactive 3D map GUI for managing your land.

• 3D Map Aesthetics: The map uses custom base64-textured heads (Grass for your claims, Stone for wilderness, Gold for trusted) to create a premium topographic feel.
• Player Avatar Pin: The exact chunk you are currently standing in displays your actual Minecraft face, acting as a "You Are Here" pin.
• Topographic Lore: Hover over any chunk to see its exact coordinates and real-time Biome type.
• Map Zoom & Bulk Claiming: Use the [+] and [-] buttons to zoom your map scale out. Zooming out bundles multiple chunks into a single slot (e.g., a 2x2 or 3x3 grid) so you can click to claim massive territories all at once.
• Rapid Management: Left-Click to claim, Right-Click to extend, and Middle-Click to instantly abandon a chunk directly from the map.
• Strict Permissions: Only the Owner can abandon via the GUI. Only Owners and Managers can trigger Extend Mode.
• Translatable Messages: Three new language.yml keys ensure every GUI element remains translatable: Chunk_claim_abandon_success, Chunk_claim_abandon_owner_only, Chunk_claim_resize_owner_manager_only.

Interactive Guestbooks (Experimental)​

Visitors can click the Writable Book in the Claim Info GUI to sign a claim's guestbook via an Anvil prompt. Owners can review all signatures in a paginated menu and Shift-Click to delete them.

Advanced Claim Templates (Experimental)​

Take a snapshot of your claim's flags and permissions to save as a reusable "Template". Publish templates globally for others to use (e.g., "Safe Farm", "PvP Arena"). Added --template="name" support to /claim create <radius> to instantly apply a saved configuration upon claim creation.

Custom Claim Banners (Experimental)​

Visually upgrade your claim's icon in /claim list by designing a custom Banner flag pattern from within the Claim Settings menu.

Claim Jukebox — Ambient Sound Flag (Experimental)​

An internal flag that lets you set a specific music disc or ambient environment sound to play client-side for anyone who walks into the claim.

NoVehicleType Flag​

A new flag to control vehicle movement into claims. Prevents specified vehicles (Boats, Minecarts, Rideable mobs, etc.) from entering a claim.

Timed Flight — Mass Command​

Added a command to give timed flight to all players at once.

/claim timedflight add all 1h10m10s

Expanded /claim disableflag​

The /claim disableflag command now works with all flags.
/claim disableflag <claimid|here|all> <flagname>

Using all will disable the specified flag in all claims across the server. Requires permission: gpgui.admin.

Admin Claim List​

/adminclaimslist now directly opens the Admin Claim List GUI.

Console Command Support​

Commands can now be properly executed directly via the server console.

Debug & Testing Tools​

Added in-game simulated plugin tests for internal diagnostics.
/claim debug test
/claim debug diagnose
/claim debug all

Caution: Do NOT run these commands on live production servers. These are intended for development and controlled testing environments only.

Click to expand...

Improvements​

Manager Flag Permission Inheritance​

Added a new option allowing claim managers to inherit flag permissions from the claim owner. This allows managers to activate or use flags even if they do not personally have the required permission, as long as the claim owner has it.

YAML:

ManagerInheritance:

  FlagActivatePermission: false

  FlagUsagePermission: false

ClaimFly Handling​

• Improved ClaimFly behavior when teleporting — flight is now disabled immediately upon teleporting out of a claim instead of waiting for movement.
• Fixed ClaimFly behavior when moving between subdivisions and parent claims with flight enabled. Flight will no longer toggle off and back on unnecessarily.
• Fully synchronized the ClaimFly flag logic with thread-safe concurrency and FoliaLib integration.

Bedrock GUI​

Generally improved and refined the Bedrock GUI system for a smoother player experience.

Economy​

• Added new config option: economy.string_type: "Example Economy Type" — used to display a custom economy type name in chat.
• claim_block_price in config.yml now supports large (long) values.

Unnecessary Warnings Removed​

The FlagDefaults: Failed to enable the flag <flagname>: this flag is already active error message has been removed. This situation is now handled silently, as it simply indicates the player has already enabled the flag with custom values.

Plugin Size​

Reduced overall plugin file size.

Experimental Features Toggle​

Added a new experimental.features section in config.yml to safely toggle all new experimental systems.

Compatibility​

• Added backward compatibility with GriefPrevention 16.18.5.
• Fixed issues with GriefPrevention-3D for both 3D and 2D subdivisions. Subdivisions now load correctly, and all related commands function as expected.

Fixes​

• Subdivisions: Fixed GriefPrevention-3D subdivision loading for both 2D and 3D modes.
• Trust List: Fixed an issue where invalid players (from corrupted data or online/offline mode changes) caused problems in the trust list.
• /claim disableflag: Fixed the command requiring an unnecessary argument to function.
• NoMobAIType: Fixed an issue where mobs without AI would not be affected by gravity or player attacks. Now only pathfinding and attack AI are removed.
• Claim Teleport: Fixed /claim tp not working correctly on Folia.
• Folia Stability: Fixed IllegalStateException errors on Folia, including when purchasing claim blocks via Placeholder economy.
• Economy — NullPointerException: Fixed a NullPointerException when loading economy.
• Placeholder Economy: Fixed placeholder-based economy not functioning correctly. Commands now execute correctly with or without a leading / prefix.
• Memory Leak: Fixed a memory leak issue.
• Timed ClaimFly: Fixed timed flight duration not decreasing correctly on Folia.
• Time Formatting: Fixed a bug where timed messages (like ClaimFly) displayed total hours (e.g., "97 hours") instead of properly converting them into Days and Hours.
• GUI Placeholders: Fixed an issue where placeholder material was not set correctly when used with GUI argument placeholders (e.g., {claimid}).
• Flag Defaults: Fixed {claimid} placeholder in Flag Defaults only being translated once during setup. It is now properly translated dynamically upon loading.
• Claim Block Calculations: Fixed bonus claim blocks being completely ignored when calculating a player's total blocks.
• Purchase Limit: Fixed the max purchase limit incorrectly checking accrued blocks instead of bonus blocks. Also fixed setting the limit to 0 (unlimited) causing transactions to fail.
• Selling Initial Blocks: Players can now freely sell accrued and bonus blocks, but initial blocks remain protected and cannot be sold.
• Chunk Map Zoom: Fixed zooming out in the chunk claim map causing placeholders (like {id}) and interactions to break. The GUI now dynamically scans grouped chunk areas to select the most appropriate primary claim.
• NullPointerException Spam: Added a possible fix for widespread NullPointerException console spam.

Note: Features marked as Experimental can be toggled via the experimental.features section in config.yml. Please report any issues

Click to expand...

Fixed several minor issues from the previous update. This is not a critical fix, but updating is recommended.

Fixed A Critical issue from 4.11

Version 4.11​

⚠ Requires GriefPrevention 16.18.6 +
Older GriefPrevention versions are not supported.

Click to expand...

New Features​

⏱ Timed Flight Management​

Added a new command to manage and inspect remaining timed flight.

Commands

/claim timedflight
/claim timedflight get <player>
/claim timedflight add <player> <time>
/claim timedflight set <player> <time>

Time format

• h = hours
• m = minutes
• s = seconds
  Example:

/claim timedflight add Player 2h30m

Purchasable Claim Flags​

• Claim flags can now be purchased via the Claim Upgrade GUI
• Configurable per flag in flagoptions.yml
• By default, flags are purchased per claim

Global Purchase Mode

• Optional setting to purchase flags once per player
• Enable in config.yml
• No repurchase needed for each claim

Economy Support

• ITEM
• VAULT
• PLACEHOLDER
  (Uses the same system as claim block purchases)

New Flags​

• AllowTNTExplosions
  Allows TNT to break blocks inside claims
  (Creeper block damage remains disabled)
• NoUntrustedHopperDrop
  Prevents untrusted players from dropping items directly onto hoppers
• NoMobAIType
  Removes AI from mobs that spawn inside a claim
  (Does not affect mobs that walk in from outside)

🛠 Revert Mob AI Command​

Restore AI to mobs affected by NoMobAIType.

/claim revertai [scope] [mobType]

Scopes

• here (default)
• world
• <claimID>

Permissions

• gpgui.admin

🛡 Permissions​

• gpgui.bypass.timedflight
  Allows bypassing timed flight restrictions

Improvements​

• Improved ClaimFly stability and behavior
• Improved null-safety across multiple systems

Fixes​

• Fixed multiple NullPointerExceptions (GUI, Bedrock commands, subdivisions)
• Fixed ConcurrentModificationException during claim fly handling
• Fixed placeholder resolution in enter messages
• Fixed timed flight overflow errors
  • Invalid or corrupted flight times now reset to 0
• Updated internals to match GriefPrevention 16.18.6 changes

This release focuses on stability, claim & subdivision correctness, temporary flight reliability, and expanded compatibility, including GriefPrevention-3D and Minecraft 1.21.11 support.

New​

GriefPrevention-3D Support​

• Added full support for GriefPrevention-3D
  https://github.com/castledking/GriefPrevention3D/
• Fixed trust handling in 3D subdivisions
• Fixed claim visualizer behavior in 3D claims
  → Visualizer now correctly respects the subdivision’s Y-level

Minecraft Version Support​

• Added support for Minecraft 1.21.11

Fixes​

Claim & Command Fixes​

• Fixed /claimlist all errors and stability issues
  → Command and GUI now work reliably
• Fixed NullPointerException when unclaiming subdivisions
• Fixed claim not being found in edge cases involving subdivisions
• Fixed error where /claim with an invalid subcommand (e.g. /claim viewq) was incorrectly parsed as a player name
• Fixed claim biome placeholder parsing errors
• Fixed inability to trust players in subdivisions

Player & Trust System Fixes​

• Fixed rare cases where trust did not apply correctly in subdivisions
• Fixed trust inconsistencies when using GriefPrevention-3D
• Fixed errors allowing invalid trust resolution

Flight System Fixes​

• Fixed temporary flight not disabling correctly in some cases
• Fixed temp-fly duration being multiplied instead of added
• Temporary flight time is now calculated accurately and consistently

Bedrock Compatibility​

• Fixed errors when opening GUIs as Bedrock players
• Fixed NullPointerException related to Bedrock GUI handling

Gameplay & Misc Fixes​

• Fixed Zombie Villagers not curing inside claims
• Fixed incorrect placeholder values in NoMobSpawnsType_EN.yml
• Fixed various placeholder resolution issues across the plugin

Tweaks & Improvements​

• NoMobSpawnsType_EN.yml now stays open after updates, making configuration edits smoother
• General internal cleanup and improved stability across claim logic

This update focuses heavily on stability, trust system improvements, claim management fixes, and QoL enhancements.
Many long-standing issues have been resolved, and new features give claim owners more control than ever.

New Features​

Public Claim Access​

You can now make a claim fully public:

/trust public

Everyone can build in the claim.
Revert to private:

/untrust public

✔ Only players who have joined the server before can be trusted
✔ Prevents trusting random/invalid usernames
✔ Fixes previous public claim bugs

Timed Trust System (Early Test Phase)​

Grant temporary access to a player for a custom duration:

/gptrust set Player [claimid|here] [permission] 48h10m

Supported formats:

• h = hours
• m = minutes
• s = seconds

Example: 48h10m → 2 days, 10 minutes
(GUI support coming later — command works now)

Claim List Sorting Option​

A new config option allows you to set the default region-type sorting mode for the /claimlist GUI.

Changes & Improvements​

Balloon Effect Removed​

Completely removed from the plugin.
Players now receive:

• Slow Falling
• Light particles
  A cleaner and more stable experience.

Internal Cleanup & Optimization​

• Removed internal PlayerRegionEnterEvent
• Added centralized scheduler → fewer repeated tasks, better performance
• /transferclaim logic fully reworked:
  • Correct executor-based permission checks
  • Proper /ignoreclaims behavior
  • More reliable and predictable transfers

Fixes​

General Fixes​

• Fixed /claimlist all not functioning properly
• Fixed /claimlist all GUI filter
• Fixed Invalid UUID from %...getbyid_permission...% placeholders
• Fixed multiple /transferclaim errors
• Fixed NullPointerException when claim owner was null
• Fixed NullPointerException in PlayerMoveEvent
• Fixed errors relating to old or inactive claims being unclaimable
  (Untested; please report any remaining issues)

🛡 Claim System Fixes​

• Normal claims no longer incorrectly tagged as public
• Public claim logic fully stabilized
• Claim parser now correctly identifies the claim the player is standing in
  • Prevents the this_claim_trusted section from showing incorrectly

Player Fixes

• New players now initialize correctly
• Trusting nonexistent or invalid players is now blocked

Additional Information​

A Spigot-only build (supports 1.21.9 and 1.21.10, with Adventure removed)
is available exclusively on Discord after purchase verification.

Compatibility​

• Added support for Minecraft 1.21.9 and 1.21.10.
  Ensures full functionality and stability on the latest Minecraft versions.

New Features​

• Claim Ban (Blacklist) Behavior
  When a player is banned (blacklisted) from a claim, they are now automatically untrusted.
  This ensures banning fully removes both trust and access in one seamless action.
• Formatted Claim Block Placeholders
  Added two new placeholders for displaying formatted claim block values:
  • %griefprevgui_remainingblocks_formatted%
  • %griefprevgui_claimblocks_formatted%
    These shorten large numbers for readability (up to billions):
  1,000 → 1k
  1,800 → 1.8k
  1,000,000 → 1M
  2,500,000,000 → 2.5B
  
  Works across scoreboards, GUIs, and messages.
• New Flight Restriction Options
  Added configurable flight behavior in flagsettings.yml:
  fly:
  ownerOnlyFlight: false
  managerOwnerOnlyFlight: false
  
  • ownerOnlyFlight: Only the claim owner can fly inside the claim.
  • managerOwnerOnlyFlight: Only the owner and managers can fly.
    Added new messages in language.yml to inform players when flight is restricted due to claim ownership.
• New Flag: NoMCPetSkill
  Disables MCPets pet skills within claims where this flag is active.
  (Only takes effect if MCPets is installed.)

Fixes & Improvements​

• Fixed: ClassNotFoundException when unclaiming a claim.
• Fixed: Flag usage permission checks not functioning properly.
• Fixed: Flight restriction message spam when players without permission moved inside a claim — the message now displays only once.
• Fixed: /gpguireload now works without requiring arguments — simply run /gpguireload to reload the plugin.
• Fixed: Flags malfunction caused by missing MCPets plugin when introducing NoMCPetSkill.
  The plugin now correctly detects MCPets and functions normally without it.
• Fixed: NoMCPetSkill flag not properly disabling pet skills — now fully functional.

New Features​

• New Flag: Prevent auto portal creation when switching worlds via portals.
  • Stops Minecraft from automatically creating linked portals (e.g., Nether → Overworld) which could interfere with regions.
  • Future update planned to allow redirecting portal coordinates instead of blocking creation.
  • Not fully tested — please report any issues.
• Claim Name Flag: Added a character limit for claim names.
  • Configurable in FlagSettings.yml.
  • Default: 30 characters.

Changes​

• /transferclaim command has been reworked and is now handled by Grief Prevention GUI (overrides GriefPrevention’s default).
  • Usage:
    /transferclaim <player> [claimid]
    
    • [claimid] is optional — defaults to the claim at the executor’s location.
    • Admin claim transfers require /ignoreclaims.
  • Permission: griefprevgui.command.transfer
  • Not fully tested — please report any issues.

Fixes​

• Fixed: ClaimFly flag not disabling properly when players used Elytra to leave a claim. Flight and gliding are now consistently disabled on exit.
• Fixed: noMobSpawnType flag incorrectly blocking all mobs instead of just selected types.
• Fixed: /claimlist incorrectly requiring permission to view personal claims.
• Fixed: Chat input mode for editing flags (e.g., Enter Message) now properly intercepts input instead of showing it publicly in chat.
• Fixed: Error java.lang.IllegalArgumentException: name cannot be empty.
• Fixed: Issues with /unclaim.
• Improved: Compatibility with SkinsRestorer — added username validation and safer exception handling to reduce DataRequestException spam when invalid usernames are used.

This release focuses on new flag functionality, command improvements, and bug fixes for more reliable claim management.