Download File

# GriefPrevention3D v17.4.3 **Wiki:** https://github.com/castledking/GriefPrevention3D/wiki ## Highlights - **Unified command hardening** — Fixed several standalone command edge cases and permission checks. - **PlaceholderAPI support** — Added a small optional GP3D PlaceholderAPI expansion. - **More claim protections** — Added protections for animal mounting, entity unleashing, hanging entities, and weaving cobwebs. - **QuickShop-Hikari compatibility** — Restore-nature now preserves QuickShop shop signs. - **Claim expiration exemption** — Players with the griefprevention.dontexpire permission are now skipped by inactive-claim cleanup when Vault is installed. ## Unified Commands The unified command handler now handles standalone aliases more carefully: - Explicit empty `standalone:` lists in `alias.yml` now disable standalone aliases for that subcommand instead of falling back to enum defaults. - Standalone no-argument commands now reject extra arguments instead of forwarding unexpected input. - Standalone commands can now use custom tab completion where needed. - Unified subcommands now check their configured permission before execution. - `/shapedclaims`, `/claim mode shaped`, `/3dsubdivideclaims`, and `/claim mode 3d` now consistently enforce their dedicated permissions. Affected files: `CommandAliasConfiguration.java`, `UnifiedCommandHandler.java`, `UnifiedClaimCommand.java`, `UnifiedAdminClaimCommand.java`, `GriefPrevention.java`, `plugin.yml`. ## PlaceholderAPI Added optional PlaceholderAPI integration with identifier `gp3d`. New placeholders: - `%gp3d_in_subdivision%` — `true` when the player is inside any subdivision. - `%gp3d_in_3d_subdivision%` — `true` when the player is inside a 3D subdivision. PlaceholderAPI is a soft dependency. The expansion registers automatically when PlaceholderAPI is installed. Affected files: `pom.xml`, `plugin.yml`, `PlaceholderAPIExpansion.java`, `GriefPrevention.java`. ## Protection Fixes ### Animal mounting requires access trust Players now need Access trust to mount claimed rideable animals. `/ignoreclaims` still bypasses this for administrators. Affected file: `PlayerEventHandler.java`. ### Entity unleashing requires container trust When theft prevention is enabled, players now need Container trust to unleash entities inside claims. `/ignoreclaims` still bypasses this for administrators. Affected file: `PlayerEventHandler.java`. ### Hanging entity protection Item frames, paintings, and other hanging entities are now protected from additional edge cases: - physics breaks caused by projectiles or nearby updates while the supporting block still exists - direct non-player damage - player/projectile damage without Build permission - explosion damage events Affected file: `EntityEventHandler.java`. ### Weaving cobwebs no longer trip block-change protection The Weaving potion effect can now create cobwebs from living-entity deaths without being caught by unrelated entity block-change protections. Affected file: `EntityEventHandler.java`. ## QuickShop-Hikari Compatibility Restore-nature now detects QuickShop shop signs by their persistent data key and preserves both: - the shop sign itself - the block supporting the shop sign This prevents GP3D restore-nature operations from silently removing QuickShop shop signs through direct block restoration. Affected files: `BlockSnapshot.java`, `RestoreNatureProcessingTask.java`. ## Claim Expiration Bypass If Vault is installed, claim expiration now honors: - `griefprevention.dontexpire` Players with that permission are skipped by the inactive-claim cleanup task. Affected files: `CleanupUnusedClaimPreTask.java`, `plugin.yml`. ## Migration No data migration required. New optional integrations: - Install PlaceholderAPI to use the new `%gp3d_*%` placeholders. - Install Vault plus a permissions provider to use `griefprevention.dontexpire`. New permissions from v17.4.2 remain default-true: - `griefprevention.shapedclaims` - `griefprevention.3dsubdivideclaims`