GriefPrevention GUI Addon v4.13

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.

Includes major internal changes — please report any issues!

Click to expand...

New Features​

• Tiny Text Config:
  • Introduced new section in language.yml:
  • YAML:

    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:

YAML:

gui:
  bedrockGuiSupport:
    enable: true
    color_replace: '&7'

New bedrock_supported GUI item option:

YAML:

goback:
  material: OAK_DOOR
  display_name: '&7⟰ &aGo Back'
  slot: 45
  bedrock_supported: true

Disable explicitly if needed:

YAML:

claiminfo:
  material: MAP
  display_name: '&7Info &7(&aView&7)'
  slot: 49
  bedrock_supported: false

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 auto-convert to '&8' for visibility

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

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) now correctly display based on the player's current claim.

GUI Pagination Fix
Fixed an issue where GUI page navigation failed.

Placeholder Parsing
Corrected 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
Fixed GUI formatting issues in filtered menus.

Improvements

Hex Color Support for Visualizations
Customize claim visualization colors using hex codes:

YAML:

claim_visualization:
  enable: true
  disable_gp_visualization: true
  default_display_block: GRAY_STAINED_GLASS
  color: '#FF4646'             # Main claims
  color_sub_claim: '#50C878'   # Subdivisions

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 coming soon).

Faster Player Data Loading
Significantly improved performance by optimizing how player data is loaded.

Internal Placeholder Rework
Plugin now handles its own placeholders without PlaceholderAPI, improving speed and reducing dependency.

Tiny Text Support
You can now use tiny formatting consistently in placeholders and GUI elements.

Code Cleanup
Huge internal refactor:

• Smaller plugin file
• Better performance
• Easier maintenance

Developer Note

This version includes major internal changes and marks Bedrock GUI support as stable.
Please report bugs or issues you encounter

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, update your config.yml with:
  
  YAML:

  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, 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 with:
  
  YAML:

  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:
  Code:

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

    Click to expand...

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

    Requires permission: griefprev.gui.claims.other

    Click to expand...

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.

  Click to expand...

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 Visualisation Fixes
  Addressed various bugs and inconsistencies in how regions were being visualised.

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!

  Click to expand...