GriefPrevention GUI Addon 4.14.1

Important Note: Please regenerate or delete your FlagOptions.yml to apply the cleaned flag structure and load all GPFlags properly.

 Bug Fixes & Improvements

• Fixed Missing Trusted Claims in Menus
  Fixed an issue where claims you were trusted in wouldn't appear in /claimlist or the claim menu after a server restart until the claim owner logged in or you visited the claim. All claims where you are trusted will now always show up in your menu immediately upon joining, even if the owner is offline!
• Fixed Crash on GriefPrevention 3D (19.0.0+)
  Fixed a NoSuchFieldError: Class me.ryanhamshire.GriefPrevention.Claim does not have member field 'ArrayList managers' crash that occurred when running /claim, opening menus, or loading trusted claims on servers running GP3D 19.0.0+. All manager checks, permission grants/revokes, and subdivision inheritance now dynamically adapt to both modern GP3D and standard GriefPrevention setups.
• Fixed GPFlags Loading into FlagOptions.yml
  Fixed an issue where GPFlags were not registering or saving to FlagOptions.yml. External flags now automatically load right after built-in flags, default to disabled, and are fully togglable. Also cleaned up corrupted config sections like applied_updates.
• Fixed Respawn Location Placeholder
  Fixed %griefprevgui_getbyid_flags_value_RespawnLocation_{claimid}% showing raw placeholder text. It now properly resolves and formats the location into readable coordinates (world: X, Y, Z) or None if unset.

 Release Highlights

• Minecraft 26.2 & 26.3 Support: Fully updated and tested against the latest platform builds.
• Massive Memory & Performance Overhaul: Introduced dynamic, on-demand claim loading and lazy flag allocation, slashing idle RAM usage by up to 95% on large servers.
• Public Claim Warps (/cwarp, /claimw): Direct teleportation to public claims by name or ID with smart tab-completion.
• Custom User & Trust Groups (Experimental): Group players together (e.g., Builders, Friends) and trust entire groups in a single click.
• Multi-Backend Database Storage (Experimental): Added optional support for SQLite, MySQL, MariaDB, and PostgreSQL.
• Jukebox Flag Revamp: Redesigned music system supporting Vanilla discs, custom .nbs audio, and ItemsAdder/Nexo tracks.

 Features & Enhancements

 Public Claim Warps

• Direct Teleportation: Teleport directly to public claims using /cwarp <name|id> or /claimw <name|id> (e.g., /cwarp Market, /claimspw 7983). Running the command without arguments opens the warp GUI.
• Command Aliases: Added /cwarp, /claimw, /claimwarp, /claimspw, and /claim warp <name|id>.
• Smart Name Matching: Automatically strips color codes, gradients, and formatting; matches names case-insensitively with space and underscore normalization.
• Clean Autocomplete: Tab-completion now cleanly suggests claim names (hiding raw IDs for named claims) and shows IDs only for unnamed claims.

User & Trust Groups (Experimental)

• Group Management (/claim groups): Create, customize, and manage custom player groups directly through an interactive GUI.
• Group Trusting (/claim grouptrust): Grant claim permissions to an entire group simultaneously, or use @groupName syntax in trust commands.
• Real-Time Synchronization: Seamlessly synchronizes underlying GriefPrevention permissions as members join or leave groups.
• Can be toggled via experimental.features.trust_groups in config.yml.

Multi-Backend Database Storage (Experimental)

• Added multi-database support: YAML (default flatfile), SQLite, MySQL, MariaDB, and PostgreSQL.
• Non-Destructive: Existing YAML data is preserved when testing database backends.
• Configurable under the automatically generated experimental.storage section in config.yml.

 Per-Role Messaging & Claim Flags

• Role-Based Enter/Exit Messages: Enter/Exit and ActionBar flags can now display distinct messages per permission role (Owner, Manager, Trust, Container, Access, Public, and Global).
• Universal Formatting: Customize prefix and suffix formats universally for transition messages in language.yml.
• New Role Placeholders:
  • %griefprevgui_getbyid_flags_rolemsg_{flagname}{claimid}<role>%
  • %griefprevgui_getbyid_flags_roleactive_{flagname}{claimid}<role>%
• Guestbook Flag System: The Guestbook is now an integrated, toggleable claim flag. Access it via the main claim menu or /claim guestbook. Message deletion is restricted strictly to the message author, claim Owner, and claim Managers.
• Jukebox Flag Revamp: Brand-new management GUI supporting Vanilla music discs, custom .nbs files, and ItemsAdder/Nexo custom music tracks. Configurable via flagsettings.yml.
• Flag Bypass Permissions: Staff can bypass claim restrictions (e.g., NoEnter) using granular permissions such as gpgui.bypass.<flag> or bypass.<flag> without needing full /ignoreclaims powers.

 Safety & Boundary Enhancements

• Claim Border Visualization: Automatically visualizes boundaries when entering or exiting a claim with smooth transition timing (options.claim_visualization.on_enter_exit in config.yml).
• NoEnter Flag Overhaul: Trapped players are now safely moved to water surfaces or the highest safe Y level. Nether falls now safely redirect to world spawn or the relative Nether roof Y level.
• Bulk Claim Transfers: Added /transferclaim <user> all and /transferallclaim <user> to transfer all claims owned by a player in one step.
• Persistent /slowfall: Player slow-fall toggles now persist across server restarts and reconnections.
• Purchase Limits: Added economy.claim_blocks_max_bonus in config.yml to enforce a hard cap on claim block purchases.

 Diagnostics & System Tools

• Modular Diagnostics: Overhauled /claim debug all into isolated modules (Core, GUI, Placeholders, PlayerData, Storage, Sync, and UserGroups) with automated cleanup and execution timing.
• Safe Admin Commands: Added double-confirmation prompts to /claim debug and /claimlist all to prevent accidental server lag spikes.
• Console Link Logging: Raw mclo.gs links now output directly to latest.log for easy copying.

 Performance & Optimizations

• Dynamic Region Loading: Servers no longer load every claim into memory at startup. Only Admin Claims and Public Warps are loaded on boot; player claims load asynchronously on join or entry.
• Automatic Inactive Unloading: Unvisited claims automatically unload from memory after 30 minutes of inactivity, drastically reducing server RAM usage.
• Lazy Flag Memory Optimization: Flags are instantiated on-demand rather than eagerly creating 81 objects per claim.
• Memory Leak Mitigations: Resolved static collection references and ensured repeating background tasks cancel immediately upon claim unloading.

 Data Integrity & Bug Fixes

• YAML Self-Healing: Added automatic recovery and .bak backups for malformed claim files during boot.
• Config Corruption Prevention: Eliminated recursive save loops in claim flag handlers.
• Fixed %griefprevgui_standing_<property>% Placeholders: Resolved an issue where placeholders returned null inside Enter, Exit, and ActionBar messages.
• Fixed Trust Commands: Fixed /trust public and /untrust public execution issues.
• Fixed Flight Exploit: Patched an exploit where reconnecting allowed players to restore up to 75% of their timed claim flight.
• Fixed Persistent Audio: Stopped Jukebox songs from looping indefinitely when players left a claim or disabled the flag.
• Fixed Daylight Toggles: Resolved an issue where claim time overrides only triggered at the border edge rather than inside the claim.
• Fixed 3D Claim Height Checks: Corrected Y-level detection for 3D claims.
• Fixed Unsafe Teleports: Corrected warp locations placing players inside blocks or hazardous areas.
• Fixed Menu Permissions: Resolved an issue in ClaimMenu_EN.yml where trusted players were displayed the untrusted layout.
• Fixed Reload Flags: Fixed FlagDefaults not applying after /claim reload or with external GPFlags.
• Fixed Startup & Parsing Errors: Resolved SnakeYAML indentation errors and MineDown small-caps formatting breaking clickable chat links.
• Fixed Shutdown Exceptions: Resolved IllegalPluginAccessException errors during server reloads and restarts.

 Configuration & Update Notes

• GUI File Updates Required: Due to new menu buttons and layout reorganizations (Guestbook, Groups, Warps), you must regenerateor manually update the following files:
  • ClaimMenu_EN.yml
  • ClaimInfo_EN.yml
  • TrustList_EN.yml
• Automatic Configuration Additions: The new sections for options.claim_visualization, economy.claim_blocks_max_bonus, and experimental.* will automatically inject into your existing config.yml on first boot.

 Key Highlights

• Massive Performance Boost: File saving is now fully asynchronous, removing main-thread lag spikes.
• Independent Claim Banners: Banners have been overhauled and moved out of the flags system. Banners are now completely standalone!
• 1.26.1+ Ready: Fully compatible with the latest Minecraft versions and GPFlags releases.

 New Features & Improvements

• Standalone Claim Banners:
  • Banners are no longer experimental and are handled independently of the flag system.
  • Added the /claim setbanner command.
  • Banners can now be used directly as a GUI material via material: ClaimBanner.
• Slow Falling Toggle: Added the /claim toggleslowfalling command to toggle the slow-falling effect when claim fly is deactivated (enabled by default, requires no permissions).
• Advanced GUI Customization: Added support for the item_model attribute in GUI configs (perfect for custom items/textures via Nexo).
• Reset GUI Filters: Added a config option to automatically reset GUI filters to default when opening the GUI via command.
• New Public Claim Placeholder: Added %griefprevgui_getbyid_ispublic_[claimid]% to check if a claim is set to public.

 Optimizations & Lag Reduction

• Asynchronous File Saving: File saving has been overhauled to run asynchronously via the scheduler, preventing main-thread lag during auto-saves.
• General Async Enhancements: Heavy operational tasks have been offloaded to async threads.
• Async Timed Flight Processing: Bulk timed flight commands are now processed in batches asynchronously with real-time progress feedback.
• Memory Leak Resolves: Fixed leaks inside the message cooldown system and the /claim reload timer task.

 Command & Logic Tweaks

• Safe Teleportation Logic: Improved safety logic for claim teleportation, claim warps, and the claim entry flag.
• Console Execution: The /claim command can now be executed directly from the server console.
• Console-Safe Timed Flight Target: Added /claim timedflight <set|add|get> allonline to target only online players, eliminating potential server crashes when targeting offline players.
• Upgraded Claim Chunk GUI: The claim chunk system has been improved, and the chunk GUI configuration file format has been upgraded to version 1.6.

 Bug Fixes

• Auto-Save Crash: Fixed a NullPointerException crash in the auto-save system.
• Pet Untaming: Fixed pets untaming themselves when executing /unclaimall.
• Timed Flight Inflation: Fixed flight durations doubling on server restarts.
• Placeholder Colors: Fixed color codes being applied incorrectly inside placeholders.
• Bedrock Support: Fixed Bedrock GUI title formatting, resolved invisible buttons, and added fly/slow-falling safety checks on Bedrock disconnect/rejoin.
• GPFlags Integrations: Fixed a NullPointerException preventing players from enabling/disabling GPFlags correctly.

 Changes & Removals

• Fly Command Aliases: Removed /fly aliases from claim fly to avoid conflicts with other fly plugins. Please use /claimfly or /claim fly.
• ChangeBiome Flag: Temporarily removed due to upstream changes in GPFlags (a custom implementation is planned for a future update).

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.