GriefPrevention GUI Addon 4.14.1

📚 GitBook Wiki • ⌨️ Commands & Placeholders • 📊 Live bStats • 💬 Discord Support

🌟 GriefPrevention GUI Addon — The Ultimate Minecraft Land Claim GUI!

Transform standard GriefPrevention into a modern, command-free land claiming experience. Built for Paper, Purpur, and Folia survival servers, this addon replaces clunky chat commands with an intuitive GriefPrevention GUI menu, native Bedrock Edition support (Geyser/Floodgate), built-in custom claim flags, player claim teleportation, and animated 3D claim border visualizers using BlockDisplays.

Whether you run a classic SMP, Skyblock, or Lifesteal network, give your players effortless claim management while unlocking new economy money-sinks and reducing admin workload.

🎮 Why Server Owners Switch to GriefPrevention GUI Addon:

1. 🖥️ Command-Free Claim Management: Automatically intercepts standard GriefPrevention commands (/claim, /trust, /claimlist) and opens sleek, customizable chest GUIs instead. (Original command behaviour can be toggled in the config!)
2. 🌍 Seamless Java & Bedrock Crossplay: Full compatibility with Geyser and Floodgate, allowing Bedrock Edition players to navigate claim menus, trust lists, and flags smoothly without command headaches.
3. 🚀 3D BlockDisplay Claim Visualizers: Ditch outdated block updates—render customizable, animated 3D claim boundaries using modern Minecraft BlockDisplays.
4. 🎯 Built-In Custom Flags & GPFlags GUI: Manage claim rules directly from an interactive GriefPrevention Flags GUI. Includes built-in custom flags (Timed Claim Flight, NoEnter, Build/Mine toggles, BlueMap claim rendering) plus full integration with GPFlags.

🔧 Requirements & Compatibility

1. Supported Server Software: Paper, Purpur, and Folia (Note: Legacy Spigot is not supported).
2. Supported Minecraft Versions: 1.17 – 1.21.x & 26.1 – 26.3+
3. Required Dependencies: GriefPrevention & PlaceholderAPI
4. Optional Soft Dependencies:
   
   
   1. Geyser & Floodgate: Enables native Bedrock Edition GUI support.
   2. Vault / Economy: Enables buying/selling claim blocks and paid claim teleports/warps.
   3. GPFlags: Integrates GriefPrevention Flags directly into the GUI.
   4. LuckPerms: Advanced permission control for custom flags and cooldowns.
   5. BlueMap: Adds a toggleable custom flag for players to show or hide their claims on your web map.
   6. SkinsRestorer: Renders accurate player head skins inside the Trust GUI (including offline/cracked servers).
   7. MythicMobs & ModelEngine: Ensures custom mounts and entities respect claim entry flags (NoEnter).
   
   

1. ✨ Zero Command Memorization: Players simply type /claim to create claims, view land stats, manage subdivisions, transfer ownership, or safely teleport home.
2. 🚩 Standalone Custom Flag Engine: Over 30 built-in flags work right out of the box—including Timed Claim Flight, NoEnter Whitelist/Blacklist, Role-Based Enter/Exit Chat & ActionBars, Player Time/Weather, and Mob/Vehicle Filters—plus optional GPFlags integration.
3. 💎 Flexible Multi-Economy Shop: Sell and buy back claim blocks (or charge for claim teleports) using Vault, Physical Items (Diamonds, Emeralds), or PlaceholderAPI Currencies (e.g. PlayerPoints via %placeholder%).
4. 🛡️ Smarter Trust & Invite Controls: Choose instant trust or Invite Mode (players must accept claim invitations before joining), plus configurable Manager Modification Cooldowns to prevent insider griefing.
5. 🎨 100% Customizable Menus & Themes: Includes Default, Nature, and Clean themes, CustomModelData support for resource packs, Anvil search inputs, priority slot layering, and custom user-defined YAML GUIs.

[SPOILER="🚩 Click to View All 30+ Built-In Custom Claim Flags"]
Every flag below is built directly into GriefPrevention GUI Addon (no extra flag plugin required!) and can be toggled, reordered, permission-gated, or customized in flag/FlagOptions.yml & flag/FlagSettings.yml:

[LIST=1]ClaimFly — Enable flight inside claims (supports permanent flight or Timed Flight balances!)NoEnter — Block outsiders from entering, with dedicated Whitelist & Blacklist player GUIsEnterMessage & ExitMessage — Custom chat greetings/farewells with role-specific message configsEnterActionbar & ExitActionbar — Smooth ActionBar titles when entering or leaving a claimNotifyEnter & NotifyExit — Alert claim owners/managers when visitors cross boundariesClaimWarp — Publish a safe community warp spot to the public /cwarp browserClaimName, ClaimDescription & ClaimIcon — Customize how the claim appears across all menusNoMobSpawnsType — Dedicated GUI to block specific mob entities or allow specific spawn reasonsNoMobAIType — Dedicated GUI to freeze AI for selected mob types inside claimsNoVehicleType — Dedicated GUI to restrict boats, minecarts, or specific vehiclesPlayerTime & PlayerWeather — Lock personal visual time (day/sunset/night) and weather inside a claimNoElytra — Prevent Elytra gliding/boosting inside protected areasNoLeafDecay — Preserve custom trees and foliage builds from decayingNoPlayerCropTrample & NoMobCropTrample — Protect farmland from players and mobsNoUntrustedHopperDrop — Stop untrusted players from dropping items into collection hoppersAllowTNTExplosions — Optional TNT block damage toggle while keeping Creeper griefing blockedNoAutoPortal — Prevent unwanted Nether portal linking/creation inside claimsProtectedPets & NoMCPetSkill — Protect tamed pets and restrict MCPets combat skillsRespawnLocation — Set a custom respawn point inside the claimClaimMapFlag — Render claim territories on BlueMap / Dynmap web mapsChangeBiome / KeepInventory / PVP — Pre-built custom flag templates & seamless GPFlags hook support!
[/LIST]
[/SPOILER]

[SPOILER="🖥️ Click to View All 25+ Included GUI Menus"]

1. Main Dashboard (ClaimMenu.yml): Central hub for standing claim status, claim list, warps, and block shop.
2. Claim Control Panel (ClaimInfo.yml): Inspect location/biome, open flags, subdivisions, trust list, banner, and safe teleport.
3. Smart Claim Browser (ClaimList.yml): Filter by permission (Own, Manager, Trusted, Container, Public), distance, size, flags, or subdivisions.
4. Flag & Upgrade Browser (ClaimUpgrade.yml): Paginated flag control panel with dynamic status placeholders.
5. Trust List & Online/Offline Player Picker (TrustList.yml, PlayerList.yml): Visual player head management.
6. 4-Tier Permission Editor (ClaimPermissions.yml): Grant Manager, Build Trust, Inventory/Container, or Access roles.
7. Claim Invites Menu (ClaimInvites.yml): View, accept, decline, or revoke pending trust invitations.
8. Multi-Economy Block Store (ClaimBlock.yml, ClaimBlockSelector.yml): Preset bundles (+100 to +3,200) & custom selector.
9. Public Warp Browser (WarpList.yml): Visit community shops and showcases with hazard-checked safe teleportation.
10. Material Icon Picker (IconSelector.yml): Searchable Minecraft material browser with category filters.
11. Entry Whitelist & Blacklist (Whitelist.yml, BlackList.yml): Manage NoEnter access lists visually.
12. Entity & Vehicle Sub-Menus (NoMobSpawnsType.yml, NoMobAIType.yml, NoVehicleType.yml): Per-entity toggle grids.
13. Expiring Claims & Safety Confirmations: ExpiringClaimList, ClaimDelete, ClaimDeleteAll, ClaimLeave, ClaimLeaveAll, and ClaimKick.

[/SPOILER]

[SPOILER="⌨️ Click to View Commands, Permissions & 60+ Placeholders"]
Core Player & Admin Commands (Aliases: /claim, /gpclaim, /claimui)

1. /claim — Open the main GriefPrevention GUI dashboard
2. /claim list (/claimlist) — Browse & sort all owned and trusted claims
3. /claim info [claimID] (/claiminfo) — Open detailed settings for a claim
4. /claim create [radius] — Create a claim via GUI or without a golden shovel (configurable)
5. /claim tp & /claim warp (/cwarp) — Safe teleport & public warps
6. /claim fly (/claimfly) — Toggle flight inside eligible claims
7. /claim trust / /claim invites / /claim kickout / /claim ban
8. /claim claimblocks / /claim purchase / /claim sell / /claim transferblock
9. /claim timedflight [time] — Manage timed claim flight (gpgui.timedflight)
10. /claim reload — Hot-reload configurations, themes, and GUIs (gpgui.admin)

Popular PlaceholderAPI Placeholders (%griefprevgui_%)

1. %griefprevgui_claimblocks% / %griefprevgui_remainingblocks% / %griefprevgui_claimcount%
2. %griefprevgui_flighttime% — Player's remaining timed flight duration
3. %griefprevgui_standing_id% / %griefprevgui_standing_owner% / %griefprevgui_standing_permission%
4. %griefprevgui_isclaimed_lookingat% & %griefprevgui_claimedby_lookingat%
5. %griefprevgui_getbyid__% — 60+ total placeholders documented on our GitBook Wiki!

[/SPOILER]

[SPOILER="❓ Click to View Quick Setup & FAQ"]
1. How do I install GriefPrevention GUI Addon?
Drop GriefPrevGUI.jar into your Paper/Folia plugins/ folder alongside GriefPrevention and PlaceholderAPI, then restart your server. All GUI & theme files generate automatically!

2. Does it replace DeluxeMenus?
Yes! Older v1–v3 releases used DeluxeMenus, whereas v4.x is a 100% standalone Java plugin with its own high-speed GUI engine, custom flags, 3D BlockDisplay visualizer, and native Bedrock form engine.

3. Do I need GPFlags for the flags to work?
No! Over 30 flags (ClaimFly, NoEnter, Enter/Exit messages, Mob/Vehicle filters, PlayerTime/Weather, etc.) are built directly into this plugin. If you already use GPFlags, we hook into it automatically as well.

4. Does it work with Geyser & Floodgate (Bedrock players)?
Yes! When Floodgate/Geyser is detected, Bedrock players automatically see clean native Bedrock Forms instead of Java chest inventories.
[/SPOILER]



📚 Documentation & Support

1. Official Wiki: Grief Prevention GUI Addon Wiki
2. Placeholders: Full PlaceholderAPI List
3. Custom Flags: Built-in Flag List
4. Discord Support: Official Discord Support Server — open a ticket for fast assistance!

📜 Terms of Service

1. Active Version Support: Official support and bug fixes are provided exclusively for the latest release of the plugin running on up-to-date dependencies.
2. Support Before Reviewing: Running into a configuration issue or bug? Please open a ticket in our Discord server before leaving a review so we can get it sorted out for you quickly!