GPExpansion v1.1.11

Puts claims on the vanilla locator bar as bowtie markers, visible only to the owner and trusted players. Adds /claim color, per-claim waypoint publishing gated by a permission limit, a bundled resource pack, and ResourcePackManager integration.

Breaking Changes

• Requires Paper 1.21.11 or newer. The API target moved from paper-api 1.20.6 to 26.2; the waypoint feature is built on the locator bar system introduced across 1.21.6–1.21.11.
• ClaimMetadata gained two components. The record is now ClaimMetadata(Claim, String name, String description, Material icon, String waypointColor). Any external code constructing it directly needs updating; ClaimMetadataService accessors are unaffected.

New Features

Claim Waypoints

• Claims appear on the locator bar as bowtie markers, scoped per viewer — the owner, players with trust on the claim, and everyone for published claims
• No entities are involved. Positions come from GP3D's in-memory claim data, so a claim keeps rendering regardless of whether its terrain is loaded — no armor stands, no chunk tickets, nothing written to region files
• Two delivery modes via claim-waypoints.crowbar-only:
  • true (default) — claim data is sent to CrowBar clients over a plugin channel, and they render it themselves
  • false — vanilla ClientboundTrackedWaypointPackets are additionally sent to each eligible player, so unmodified clients see claims on the vanilla locator bar too, at any distance and in unloaded chunks. Per-viewer visibility is exact because the server chooses each packet's recipient.
• The vanilla packet path resolves server internals reflectively against Paper's Mojang-mapped runtime; if resolution fails on a future version it logs once and degrades to CrowBar-only delivery instead of breaking
• Refreshes on claim create, delete, resize, transfer, trust change, rename, recolour, publish, spawn move, world change, and player join/quit — no polling. Each refresh diffs against what every viewer was already sent, so packets only go out for actual changes.

/claim color <color|reset> [claimId]

• Sets a claim's waypoint colour to one of Minecraft's 16 named colours, or reset for the default
• Permissions: griefprevention.claim.color, plus .other and .anywhere following the /claim name convention
• Stored in claimdata.yml under claims.<id>.color and exposed through ClaimMetadataService#getWaypointColor

Waypoint Publishing (Shift-Click)

• Shift-Click the global toggle in the claim's Global Settings GUI to publish that claim's waypoint to every player, or withdraw it
• Deliberately separate from the left-click listing toggle, so listing a claim globally never reveals its location as a side effect
• Gated by griefprevention.claim.waypoint.create.<amount> — the highest numeric node the player holds sets how many claims they may publish, matching how sign limits work. create.* (or griefprevention.admin) grants unlimited, shown as ∞ — a wildcard satisfies hasPermission without ever appearing as a concrete numbered node, so it is checked explicitly.
• Admins can adjust a player's limit directly with /gpx max waypoints <add|take|set> <player> <amount>, alongside the existing sell/rent/mailbox/globals limits; an admin-set value takes precedence over permission-derived limits
• The lore line only appears for players holding a limit above zero, and shows a used/limit counter
• Withdrawing is always permitted even at or over the limit, so a lowered permission never strands a player with claims they cannot retract

Resource Pack + ResourcePackManager

• Ships resourcepack.zip, extracted to the plugin data folder on enable
• Raises near_distance on minecraft:bowtie so claim markers stay full-size bowties instead of shrinking to a plain dot past 64 blocks. Sprite selection happens entirely on the client, so a resource pack is the only way to change this for unmodified clients — no server command or API call can reach that decision.
• ResourcePackManager is used automatically when installed, so the pack is merged into the server's combined pack rather than competing with other plugins' packs
• Without RSPM, the pack is sent on join from claim-waypoints.resource-pack.url — defaulting to a hosted copy on mc-packs.net with its SHA-1 pre-filled, so it works out of the box; replace both values to host your own
• Direct sends skip players whose client registered the CrowBar channel, so CrowBar users are never prompted for a pack that changes nothing they can see
• Only loaded when crowbar-only is false; CrowBar clients pin the sprite themselves and never need the pack

/gpx waypoints

• Diagnostic listing every claim visible to you — anchor, distance, colour, published state, and whether it was actually sent as a vanilla waypoint packet — plus the delivery mode, packet bridge health, and the locatorBar game rule
• Reports each condition the plugin applies before a claim reaches a locator bar, so a missing bowtie can be attributed rather than guessed at

API

• ClaimMetadataService#getWaypointColor(Claim) / getWaypointColor(String claimId) — returns a lowercase Adventure colour name, or empty for the default
• ClaimColorChangedEvent — fired when a claim's waypoint colour changes
• ClaimPublicWaypointChangedEvent — fired when a claim's waypoint is published to or withdrawn from all players
• Both extend ClaimValueChangedEvent<T> alongside the existing event hierarchy

Configuration

New claim-waypoints section:

claim-waypoints:
  enabled: true
  crowbar-only: true
  transmit-range: 60000000
  include-subdivisions: false
  include-admin-claims: false
  resource-pack:
    url: "https://download.mc-packs.net/pack/543f6d77112d5dde401dfc6a89a5c00714598033.zip"
    sha1: "543f6d77112d5dde401dfc6a89a5c00714598033"

• transmit-range is evaluated when waypoints refresh (join, world change, claim/trust changes), not continuously as players move
• include-subdivisions is off by default because it multiplies the waypoint count for little benefit.

Permissions

• griefprevention.claim.color — use /claim color (also .other, .anywhere)
• griefprevention.claim.waypoint.create.<amount> — publish up to <amount> claim waypoints to all players
• griefprevention.claim.waypoint.create.* — publish unlimited claim waypoints
• griefprevention.claim.waypoint.admin — see admin claims on the locator bar, with include-admin-claims enabled

Notes

• Claims in a different world from the viewer are filtered out, since a bearing-based bar cannot represent them
• Marker entities from pre-release builds that used armor stands are swept on startup
• The locatorBar game rule is respected: no vanilla packets are sent to players in a world where it is disabled