GriefPrevention GUI Addon 4.11.2

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.

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

✅ Status: Release Candidate
🧪 Includes major internal changes — please report any issues!

🆕 New Features

• Tiny Text Config:

  • Introduced new section in language.yml:

    
    

  • tiny_text:
      enabled: true
      convert_gui_title: true

    
    

    


    
    

  • Allows finer control over where tiny text is applied (e.g., disable it for GUI titles).

    
    

  • Deprecated: enable_auto_text_conversion_to_tiny_text — support will be dropped soon.

    
    

• Mob Heads Configuration:

  • Added new file: mobheads.yml

    
    

  • Includes pre-filled decorative heads.

    
    

  • Used in the No Mob Spawn Type flag's GUI for mob selection.

    
    

🛠️ Fixes

• Fixed GUI head textures not loading correctly (previously defaulted to STONE).

  
  

• Fixed placeholders not working in the Action Bar Message flag.

  
  

• Fixed NullPointerException when unclaiming admin claims.

  
  

• Fixed console spam when teleporting between worlds while balloon effect is active.

  
  

⚙️ Improvements & Changes

• Player Data System Rework:

  • Completely restructured how player data is loaded and cached.

    
    

  • Improves performance, especially on large servers during startup.

    
    

  • ⚠️ Some features may behave differently — testing and feedback are encouraged!

    
    

🛠️ Fixes

• 🧱 Visualizer Initialization Error
  Fixed an IllegalArgumentException that could occur during region visualizer initialization under certain conditions.

  
  

• 💥 Server Crash on /untrust
  Resolved a critical issue where using the /untrust command could cause the server to crash.
  This was due to an internal bug in placeholder handling introduced in the previous update.

  
  

⚠️ Important Changes

❌ Dropped Spigot Support

The plugin no longer supports Spigot due to delays and compatibility issues with essential libraries like Adventure.
➡️ Please use Paper, Purpur, or other API-compatible forks.

🟢 Minecraft 1.21.7 Support

Added full compatibility for Minecraft 1.21.7.

🌟 New Features

📱 GeyserMC + Floodgate Support

Initial support for Bedrock players using GeyserMC and Floodgate.

Enable in config.yml:

New bedrock_supported GUI item option:

Disable explicitly if needed:

✅ Some GUI items have already been updated for Bedrock compatibility.

⚠️ Limitations:

• 
  
• 
  

  Hex color codes are not supported for Bedrock

  
  
• 
  

  Claim visualization not yet functional for Bedrock clients

  
  
• 
  

  All &7 colors are auto-converted to &8 for visibility

  
  

🧪 Safe to test — you can disable it anytime, and Bedrock players will return to classic chest GUIs.

🔔 Improved Version Messaging

Improved console messages when using an older pre-release and a newer version is available.

🛠️ Fixes

• 
  
• 
  

  🛑 SkinRestorer Missing Handling
  Fixed a critical issue causing startup loop if SkinRestorer was not installed, even when disabled in config.

  
  
• 
  

  🧱 Region Handling Errors
  Resolved errors caused by uninitialized region systems.

  
  
• 
  

  🧩 GUI Formatting on Missing Claim ID
  GUIs opened without a claim ID (e.g., /claiminfo) will now display properly based on the player's current claim.

  
  
• 
  

  📄 GUI Pagination Fix
  Resolved an issue where GUI page navigation failed.

  
  
• 
  

  🧩 Placeholder Parsing
  Fixed improper placeholder handling in EnterActionbar and EnterMessage for custom flags (not GPFlags).

  
  
• 
  

  🗺️ Claim Visualization Cleanup
  Claim visuals now despawn correctly when chunks unload mid-animation.

  
  
• 
  

  📋 GUI Filter Formatting
  Corrected GUI formatting issues in filtered menus.

  
  

⚙️ Improvements

🎨 Hex Color Support for Visualizations

Now supports hex color customization:

Add vibrancy and clarity to your claim visuals 🎨

📑 FlagDefaults.yml Enhancements

Improved loading of default values for Grief Prevention GUI flags from FlagDefaults.yml.

⚠️ Does not apply to GPFlags.
🔄 Changes require a server restart (live reload planned in future).

🚀 Faster Player Data Loading

Player data now loads faster, boosting server performance.

🧩 Internal Placeholder Rework

Internal placeholders now handled natively, reducing dependency on PlaceholderAPI and increasing speed + stability.

🔤 Tiny Text Support

Consistent tiny text formatting now works across placeholders and GUI elements.

🧼 Code Cleanup

Significant internal refactoring and cleanup:

• 
  
• 
  

  ✅ Smaller file size

  
  
• 
  

  ✅ Better performance

  
  
• 
  

  ✅ Easier maintainability

  
  

📢 Developer Note

🧪 This version includes major internal reworks and introduces Bedrock support as a stable feature.
While thoroughly tested, edge cases may still exist — please report bugs or feedback.

🆕 New Features

🎭 SkinRestorer Integration
Enhanced support for the SkinRestorer plugin:

• Skins are now displayed in the trust list menu and add player menus.

  
  

• If an offline-mode (cracked) player joins using a premium username, the plugin will use SkinRestorer to generate and display the correct skin.

  
  

• 💾 Skin Caching has been implemented to eliminate lag when loading player lists in GUIs.

  
  

• 🔧 This feature is disabled by default. To enable it, set the following in your config.yml:

  
  

  gui:
    player_list_format:
      # If enabled, the player list will use SkinsRestorer to get player skins.
      # If disabled, it will use the default Bukkit skin system.
      skin_restorer: true
  

  
  

• ℹ️ If SkinRestorer is installed on a proxy (e.g., BungeeCord/Velocity) and misconfigured, support will be automatically disabled to prevent issues.
  ➤ To fix this, follow the official guide:
  https://skinsrestorer.net/docs/troubleshooting/proxy-mode

  
  

🪂 Toggle-Based Claim Fly System

• Players must manually toggle flight using /claim fly or /claimfly when entering a claim with flight enabled.

  
  

• 🛠️ Enable this feature in your FlagSettings.yml:

  
  

  fly:
    requirePlayerToggleFlight: true
  

  
  

🌐 New Language Support for Claim Fly System
Added customizable messages:

• message.player_flight_toggled_on

  
  

• message.player_flight_toggled_off

  
  

• message.This_feature_disabled

  
  

• message.Claim_flag_fly_toggle_required

  
  

📋 Advanced Claim Listing

• /claimlist all — View all claims on the server. (Requires permission: griefprev.gui.claims.all)

  
  

• /claimlist <player> — View claims owned by a specific player. (Requires permission: griefprev.gui.claims.other)

  
  

🧱 New Visualizer Permission

• Added permission: gpgui.visualization.atplayer

  
  

  
  

  Allows spawning the region visualizer at the player’s current location.

  
  

  
  

🔄 Changes

🎨 Default Visualizer Style Updated

• Changed the default region visualizer to wall style, now 3 blocks tall for better visibility.

  
  

🧩 Placeholder Logic Overhaul

• %griefprevgui_isclaimed% and %griefprevgui_claimedby% now check the block the player is standing in.

  
  

• ➕ Added new placeholders:

  • %griefprevgui_isclaimed_lookingat% — Checks if the block the player is looking at is claimed.

    
    

  • %griefprevgui_claimedby_lookingat% — Returns the owner of the block the player is looking at.

    
    

⚙️ Improvements

🚀 Performance Optimization

• Improved internal caching systems for faster GUI loading and flag checks.

  
  

🛠️ Fixes

🎯 GUI Priority Fix

• Fixed an issue where the wrong GUI item was selected in the "this_claim_*" section due to incorrect priority.

  
  

🛑 GUI Stability

• Fixed a rare NullPointerException that could occur when closing a GUI.

  
  

🆕 New Features

• 📋 Advanced Claim Listing

  • Use /claimlist all to view all claims on the server.

    
    

    
    

    Requires permission: griefprev.gui.claims.all

    
    

    
    

  • Use /claimlist <playername> to view claims owned by a specific player.

    
    

    
    

    Requires permission: griefprev.gui.claims.other

    
    

    
    

⚙️ Improvements

• 🚀 Performance Optimization
  Improved internal caching for faster and more efficient performance, especially during flag checks and claim interactions.

  
  

• 🧱 Subdivision Support Enhancements

  • The owner_only: true option in FlagOptions.yml now works correctly with subdivisions, hiding flags from non-owners.

    
    

• 🎨 Model Data Support for Flags
  You can now define custom model data for flag items via flagoptions.yml, allowing for more visual flexibility and custom design.

  
  

🧪 Experimental

• 🐲 Fix for Flag Bypass via Custom Mounting (MythicMobs / ModelEngine / McPets)
  Added experimental support for plugins like MythicMobs, ModelEngine, and McPets that allow custom entity mounting and movement.

  
  

  
  

  These plugins often bypass PlayerMoveEvent and VehicleMoveEvent, leading to potential flag bypasses (e.g. NoEnter).
  This update adds a workaround to better detect and prevent unauthorized movement.
  ⚠️ This is an experimental feature — please report any issues or edge cases you encounter. 

  
  

  
  

🆕 New Features

• 🧱 Model Data Support for Flags
  You can now assign custom model data to flag items via flagoptions.yml, allowing for more advanced and visually distinct GUI designs.

  
  

🔄 Improvements

• 🗺️ Full Region Visualization Overhaul
  Visualization has been revamped:

  • Previously shown as lines on corners, regions are now fully visualized, making boundaries clearer and more immersive.

    
    

🛠️ Fixes

• 🎯 Visualization Alignment Fix
  Corrected an off-by-one block issue where the region display was slightly misaligned.

  
  

• ⚙️ General Region Visualization Fixes
  Addressed various bugs and inconsistencies in how regions were being visualized.

  
  

🆕 New Features

• ✈️ Timed Flight Command Permission
  Added permission **gpgui.timedflight** required to use the /claim timedflight command.

  
  

  
  

  Make sure to grant this permission to the appropriate roles/groups!

  
  

  
  

Fixed java.lang.NoClassDefFoundError error

🚀 Compatibility

• 🧪 Added Support for Minecraft 1.21.5
  The plugin now supports Minecraft 1.21.5. Please report any version-specific issues!

  
  

🆕 New Features

• 🗺️ New Flag: ClaimMapFlag
  Adds experimental support for Dynmap and BlueMap.

  
  

  
  

  This flag is in early stages and will be refined in future updates. Please report any issues!

  
  

  
  

• ⚙️ New Config Option: show_only_trusted_and_owned_claims_when_sorted_as_all
  Allows you to hide public claims when the claim list is sorted by "All".

  
  

• 🔄 Editable Reload Message
  You can now customize the plugin's successful reload message.

  
  

🛠️ Fixes

🧩 Placeholder System

• ✅ Re-added support for %gpextension...% placeholders.
  Placeholders starting with %gpextension now function as expected.

  
  

🧱 Claim Management

• ❗ Fixed a bug where trying to unclaim an admin claim would cause an error.

  
  

• 🛑 Fixed an issue where players could mine/build outside a claim while standing inside it, even with only_allow_building_in_claimed_areas and only_allow_mining_in_claimed_areas enabled.

  
  

• 📛 Improved error message when a claim with the specified claimid is not found.

  
  

• 📍 Using here outside of a claim when updating a flag now shows a proper warning.

  
  

🖱️ GUI Behavior

• 🔧 Fixed an ArrayIndexOutOfBoundsException caused by setting GUI items to AIR.

  
  

• 🧼 Prevented AIR items from overwriting GUI elements like claim flags or list entries.

  
  

• 🔁 Fixed errors when configuring menu controls.

  
  

📋 Claim List Sorting

• 📌 Fixed an issue where sorting by permission would freeze after reaching public claims.

  
  

• 🛠️ Fixes related to the new show_only_trusted_and_owned_claims_when_sorted_as_all option.

  
  

🚫 Startup Errors

• 🧨 Fixed NullPointerException and NoClassDefFoundError on startup when GPFlags is not installed. 

  
  

🛠️ Fixes

• 
  
• 
  

  Fixed an issue where default files still use old GPExtension placeholders instead of the new griefprevgui format.

  
  

📘 New!

• 
  
• 
  

  🧠 Official Wiki Launched!
  A brand new GitBook wiki is now available with guides and main features.
  More content will be added soon!
  👉 https://toonystank.gitbook.io/grief-prevention-gui-addon  

  
  

Version 4.6 - Major Update & Plugin Rename

🚨 Breaking Change Notice
This version is not backwards compatible with older versions.

To update safely:

• Rename your GPExtension folder (inside the plugins directory) to GriefPrevGUI before updating.

  
  

• If you have already updated and a new GriefPrevGUI folder was created, delete it and rename your existing GPExtension folder instead.

  
  

✨ Changes & Improvements

• Plugin Renamed:
  The plugin has been renamed from GPExtension to GriefPrevGUI.
  Internally, it still uses the name GPExtension for backwards compatibility with older versions and placeholders.

  
  

• Modernized Plugin Look:
  Updated the plugin prefix and GUI titles for a cleaner, more modern aesthetic.

  
  

• Improved Plugin Load Without GPFlags:
  Fixed an issue where the plugin would fail to load correctly if GPFlags was not installed.

  
  

• ClaimList Stability Fixes:
  Resolved a NullPointerException and fixed issues where some claims would not show up in the claim list.

  
  

• Custom NoMobSpawnsType Flag:
  Introduced a new NoMobSpawnsType custom flag, replacing the GPFlags version.

  • If you're already using GPFlags' NoMobSpawnsType, your data will be migrated automatically.

    
    

  • A brand-new GUI interface allows selecting specific mobs to block from spawning.

    
    

  • It supports filtering by spawn reasons (e.g., natural, spawner).

    
    

  • GUI type can be changed using the filter toggle at the top. 

    
    

Fixed issue where NoMobSpawnsType flag fails to load, Corrected issue where the NoMobSpawnsType flag fails to load, resulting in claims not being displayed in the GUI