Download File

# GriefPrevention3D v17.4.4 **Wiki:** https://github.com/castledking/GriefPrevention3D/wiki ## Highlights - **3D admin claims** — New `Admin3D` shovel mode creates free, height-bounded administrative claims. Includes `/3dadminclaims` command and `/aclaim mode admin3d` subcommand. - **Verbose piston feedback** — When a piston is broken by a claim boundary, the nearest player with build permission now receives a message explaining where and why, with a conflict-zone visualization of the blocking claim. - **Trapped command fixes** — `handleTrappedCommand` brought to parity with the inline handler: correct check ordering, proper GPFlags destination forwarding, nether/end guard, and silent pending-rescue suppression. - **New command aliases** — Added `/3dsc`, `/sc3d`, `/subdivide3d`, `/3dsubdivide`, `/adminclaim3d`, `/adminclaims3d`, and others to match the tau fork's alias set. ## 3D Admin Claims A new `Admin3D` shovel mode lets administrators create free, height-limited claims using exact Y coordinates (not the usual ground-extension offset). ### Commands | Command | Aliases | Description | |---------|---------|-------------| | `/3dadminclaims` | `adminclaim3d`, `adminclaims3d`, `3dadminclaim` | Switch shovel to 3D admin claim mode | | `/aclaim mode admin3d` | — | Same via unified command | Requires the `griefprevention.adminclaims` permission. ### Behavior - Claims created in `Admin3D` mode use the clicked Y coordinates directly as the vertical bounds — no ground-extension offset is applied. - Free to create (no claim blocks consumed) and owner ID is null, making them standard admin claims. - Minimum size and claim block checks are bypassed, identical to regular `Admin` mode. Affected files: `ShovelMode.java`, `Messages.java`, `GriefPrevention.java`, `UnifiedAdminClaimCommand.java`, `Alias.java`, `PlayerEventHandler.java`, `plugin.yml`. ## Verbose Piston Feedback Previously, when a piston was broken by a claim boundary in precise mode, the player who placed it received no feedback — only the claim owner on the other side was notified via `ClaimBoundaryViolationTracker`. GP3D now also notifies the **piston owner side**: the nearest online player with build permission in the piston's claim (or within 32 blocks if the piston is outside any claim) receives: - A warning message: *"The piston at x, y, z exploded because it couldn't enter the claim at [location]"* - A `CONFLICT_ZONE` boundary visualization of the claim that blocked the push The existing `ClaimBoundaryViolationTracker` dedup/burst notifications to the invaded claim's owner are preserved unchanged. Affected file: `BlockEventHandler.java`, `Messages.java`. ## Trapped Command Fix `handleTrappedCommand` (used by the unified `/claim` command handler) had several divergences from the inline `onCommand` implementation: - **Wrong pending message** — sent `RescueAbortedMoved` when `/trapped` was already pending; it now silently returns (consistent with tau and the inline handler). - **Lost GPFlags destination** — `SaveTrappedPlayerEvent` was fired but its destination was discarded; the destination is now forwarded to `PlayerRescueTask`. - **Missing nether/end guard** — rescue is now blocked in the nether and end when no external destination is provided. - **Check order** — `pendingTrapped` is now checked before the claim/permission checks, matching the upstream order. - **Spurious event cancellation check** — `SaveTrappedPlayerEvent` is not cancellable; the dead `isCancelled()` branch was removed. Affected file: `GriefPrevention.java`. ## New Aliases Added missing aliases to match the tau fork's command set: | Command | New aliases added | |---------|------------------| | `3dsubdivideclaims` | `3dsc`, `sc3d`, `subdivide3d`, `3dsubdivide` | | `adminclaims` | `aclaims` | | `3dadminclaims` *(new)* | `adminclaim3d`, `adminclaims3d`, `3dadminclaim` | | `/aclaim mode` standalone | `3dadminclaims` | Affected files: `plugin.yml`, `Alias.java`. ## Migration No data migration required. The new `3dadminclaims` command and its aliases are registered automatically on server start. No config changes are needed. New permission used (inherits existing `griefprevention.adminclaims` node — no new node required): - `griefprevention.adminclaims` — now also gates `/3dadminclaims` and `/aclaim mode admin3d`.