GriefPrevention3D v18.4.12 — Fabric (experimental beta)

Wiki: https://github.com/castledking/GriefPrevention3D/wiki

Roadmap: platforms/fabric-common/ROADMAP.md

Still a beta, dedicated-server-only build. Back up GriefPreventionData before updating. Requires Fabric API; LuckPerms is optional but recommended.

Overview

Fabric finally has subdivisions. /subdivideclaims cuts a claim into pieces, /3dsubdivideclaims cuts it into pieces with exact heights, and both can be resized and trusted like on Paper. Everything a claim touches under water or in the air also got better: the claim tool now looks for the corner you aim at instead of whatever block the view happens to reach, so a corner sticking out of the sea is a corner you can click.

The same GriefPrevention3D.jar still runs on Fabric 1.21.2 through 1.21.11 and 26.1 through 26.3 and as a Spigot/Paper plugin.

Subdivisions

Command	What it does
/subdivideclaims (/claim mode 2d)	The shovel draws subdivisions that reach from the claim's floor to the sky, as on Paper
/3dsubdivideclaims (/claim mode 3d)	The shovel draws subdivisions whose top and bottom you pick
/basicclaims (/claim mode basic)	Back to whole claims
/restrictsubclaim	Stops a subdivision inheriting its parent's trust, or lets it again

• Permissions griefprevention.subdivideclaims and griefprevention.3dsubdivideclaims both default to true, as on Paper.
• Take the golden shovel into a claim you manage, right-click where the subdivision starts, right-click again where it ends. A 2D subdivision fills the height of its claim; a 3D one uses the heights you clicked, exactly.
• Subdivisions may be any size, including one block, and must fit inside their parent without touching each other. Overlaps are refused with Paper's messages and a conflict zone.
• Subdivisions can be resized by clicking their corner and dragged to the opposite corner, and they carry their own trust: /trust, /trustlist and the rest work on them as on Paper.
• Sneaking with the shovel at a corner in subdivision mode subdivides there; without sneaking it still resizes the claim whose corner it is, exactly as on Paper.
• Nested subdivisions (a subdivision inside a subdivision) are not offered yet, as on Paper without AllowNestedSubClaims. /restrictsubclaim is in this release, so trust inheritance is on the player to manage.

Corner clicks, under water and everywhere else

Both the stick and the shovel work from up to 100 blocks away. On a faraway click the tool follows the player's view, and while doing so it now also looks for the corner of a claim they are aiming at:

• A 3D claim's corner is a single block, so the corner is the block the click lands on, whatever it is made of.
• A claim without heights of its own — a parent claim, a 2D subdivision — has a corner that runs its whole height, so whichever block of that corner the view passes is the one clicked. The corner under water is as good as any other.

This is what Paper already does, and it fixes the two ways a far corner used to fail:

• Aim at a corner and get nothing: the corner is air, water or a gap, so the click reached nothing at all.
• Aim at a corner and get the seabed: the click landed a block or two away, outside the claim, so a new claim started instead of the corner being selected for a resize.

The corner only takes the click when it is what the player is closest to along their view — within two blocks of it, and within a forgiving 1.2 blocks of the corner itself — so ordinary clicks are untouched. A half-finished claim or subdivision never snaps, keeping its second corner exactly where it was clicked.

Visualization

• Fake blocks can be hit: left-clicking one of the blocks a visualization shows sends back the real block and drops it from the display, as breaking it always did.
• 3D claims two blocks thick or thinner no longer draw the extra vertical corner markers.

Config

New config.yml key, added to existing files on startup and reread by /gpreload, matching the Paper plugin:

GriefPrevention:
  Claims:
    Allow3DSubdivisions: true

Turn it off and /3dsubdivideclaims answers that 3D subdivisions are disabled here, while /subdivideclaims keeps working.

Upgrade notes

• Claims and player data keep the same GriefPreventionData format as Paper; nothing to migrate. Subdivisions made on Paper in a claim you copy over are resized, trusted and abandoned as usual here.
• Allow3DSubdivisions defaults to true, so 3D subdivision mode is open from this release on.
• Clicks near a corner now pick that corner, at any range, instead of the block behind it. That is what Paper has always done within reach; it is only new because the range is no longer limited to what the player touches.

Not on Fabric yet

Shaped claims and shaped subdivisions (/shapedclaims, /shapedsubdivideclaims), merging claims, /trapped, /siege, /extendclaim, restore nature, buying or selling claim blocks, /claim alerts and charging fees. The roadmap lists the protections still to come.