# GriefPrevention3D v18.0.3
**Wiki:** [GriefPrevention3D Wiki](https://github.com/castledking/GriefPrevention3D/wiki)
## Highlights
- **Public visualization API surface** — Ported the boundary-visualization extension points from the `feature/gpapiaddon-workspace` branch so addons can drive their own claim visuals without reflection.
- **Improved 3D claim raytrace logic** — Fixed a regression where the second click of a 3D subclaim resize could snap back to an existing claim corner, causing the resize to no-op or collapse the claim into a 1-block sliver.
- **New claim-selection sessions** — Selecting a claim with the modification tool can now keep that claim as the implicit target for follow-up commands (`/trust`, `/abandonclaim`, etc.) until the visualization clears.
- **Configurable selected-claim messaging** — Optional alternate selection messages so addons can present richer "claim selected" UX without overriding `ResizeStart`.
## Visualization API
The `com.griefprevention.visualization` and `com.griefprevention.events` packages are now part of the supported public API. Addons can:
- Listen for `BoundaryVisualizationEvent` to mutate the boundary set, swap the `VisualizationProvider`, or short-circuit drawing entirely.
- Implement `VisualizationProvider` / `VisualizationStyle` to render claims using their own block palettes, particle effects, glow displays, or packet pipelines.
- Call `BoundaryVisualization.visualizeClaim(...)`, `visualizeArea(...)`, and `visualizeNearbyClaims(...)` directly to trigger the same visuals GP uses internally.
- Reuse the built-in `FakeBlockVisualization`, `LegacyFakeBlockVisualization` (1.8.8), `AntiCheatCompatVisualization`, and `GlowingVisualization` (1.19.3+) implementations.
See `Public Api.txt` for the full surface and code examples.
## Bugfixes
### Claim Tools
- Fixed `ClaimToolDispatcher.handleModificationTool` running the 3D-corner snap raycast unconditionally on the second click of a resize. The snap is now gated by `ClaimToolInteractionState.shouldAttempt3DCornerSelection`, mirroring the `PlayerEventHandler` path.
- This resolves the report where dragging a 3D subclaim corner down through transparent blocks (e.g. leaves) did nothing, or occasionally collapsed the claim to a 1-block-thin layer.
- Fetches `PlayerData` once before the corner raycast so the gate reflects the actual resize/subdivide state.
## New Config Options
Two new options under `GriefPrevention.Claims` in `config.yml`:
| Key | Default | Effect |
| --- | --- | --- |
| `UseClaimSelectSessions` | `true` | When you start resizing a claim with the modification tool, that claim becomes the implicit target for subsequent commands until the visualization reverts. |
| `UseClaimSelectedMessages` | `false` | When `true` (and sessions are enabled), replaces the legacy `ResizeStart` instruction with the contextual `ClaimSelected` / `ClaimSelectedTopLevel` / `SubdivisionSelected` messages. |
Existing servers will pick up the defaults on first load and have the keys persisted to `config.yml` automatically.
## Compatibility
| Category | Support |
| ------------------ | ------------- |
| Minecraft Versions | 1.8.8 -> 26.1.x |
| Minimum Java | Java 11 |
| Bukkit API Target | 1.13 |
## Migration
No data migration is required.
Existing claims, configs, and player data remain compatible. If you want the new selection behavior off, set:
```yaml
GriefPrevention:
Claims:
UseClaimSelectSessions: false
UseClaimSelectedMessages: false
```
## Pairing
Pairs with **GPExpansion v1.1.1** for claim block accrual profile controls. Visualization addons targeting the new public surface should depend on `GriefPrevention3D >= 18.0.3`.
Optional dependencies
QuickShop-Hikari
Any compatible version
PlaceholderAPI
Any compatible version
VaultUnlocked
Any compatible version
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }
