Configuration

Configuration

GriefPrevention3D configuration lives in plugins/GriefPreventionData/:

• config.yml — primary plugin configuration.
• messages.yml — all user-facing strings. Edit to localize or reword.
• alias.yml — unified /claim / /aclaim command surface and standalone aliases.

Reload after edits with /gpreload.

GP3D-Specific Toggles

These are the options you most likely need to know about as a GP3D admin. They live in config.yml under the GriefPrevention: root.

Claims.AllowShapedClaims

GriefPrevention:
  Claims:
    AllowShapedClaims: false

Master switch for orthogonal polygon parent claims.

• false (default): /shapedclaims, /shapedclaim, and /claim mode shaped are hidden/disabled. The plugin behaves like rectangle-only GP.
• true: shaped-mode commands are available and players can create orthogonal polygon top-level claims.

See Key Features › Shaped Claims.

Claims.AllowNestedSubClaims

GriefPrevention:
  Claims:
    AllowNestedSubClaims: false

• false (default): subdivisions may only exist inside top-level claims (upstream behavior).
• true: subdivisions may be created inside other subdivisions.

Claims.UseClaimSelectSessions

GriefPrevention:
  Claims:
    UseClaimSelectSessions: true
    UseClaimSelectedMessages: false

Controls what happens when a player right-clicks an existing claim corner with the claim tool.

• UseClaimSelectSessions: true (default): the selected claim can be targeted by commands such as /claim abandon while waiting for the second resize click.
• UseClaimSelectSessions: false: the shovel can still resize normally, but commands use the claim the player is standing in instead of the selected corner claim.
• UseClaimSelectedMessages: false (default): players see the normal ResizeStart message.
• UseClaimSelectedMessages: true: players see the fuller ClaimSelected, ClaimSelectedTopLevel, or SubdivisionSelected guidance.

VisualizationGlow

GriefPrevention:
  VisualizationGlow: false

• false (default): classic fake-block border visualization.
• true: claim borders glow (Minecraft 1.19.3+ required; ignored on older clients/servers).

Claims.MinimumDistance

GriefPrevention:
  Claims:
    MinimumDistance: 0

Enforces a minimum distance in blocks between top-level claims to prevent claim spam and overcrowding.

• 0 (default): disabled — no minimum distance check.
• When set to a positive integer (e.g. 10), players cannot create a claim within that many blocks of another player's claim boundary.
• Claim creation is blocked with a denial message identifying the nearby claim owner and the configured distance.
• The conflicting claim's boundary is visualized as a CONFLICT_ZONE (visible from afar, especially with VisualizationGlow: true).

Claims.PvPToggle

GriefPrevention:
  Claims:
    PvPToggle:
      Claim:
        Enabled: false
        Price: 0.0
      Subdivision:
        Enabled: false
        Price: 0.0
        DefaultState: INHERIT

Configures per-claim PvP toggling with optional Vault economy integration.

• Claim.Enabled: Whether players can toggle PvP in top-level claims (default: false)
• Claim.Price: Cost to toggle PvP in top-level claims (requires Vault, default: 0.0)
• Subdivision.Enabled: Whether players can toggle PvP in subdivisions (default: false)
• Subdivision.Price: Cost to toggle PvP in subdivisions (requires Vault, default: 0.0)
• Subdivision.DefaultState: How new subdivisions inherit PvP state — INHERIT (from parent claim) or DEFAULT (uses the subdivision's own setting)

See Key Features › Per-Claim PvP Toggle for usage details.

Bypassing minimum distance with neighbor trust:

Specific players can be granted neighbor trust to bypass the distance check:

• /claim trust <player> neighbor — grants neighbor trust on the claim you're standing in (or all your claims if standing outside).
• /neighbortrust <player> (alias: /distancetrust <player>) — standalone command for the same purpose.
• /claim untrust <player> — revokes manually-granted neighbor trust.
• /claim distance toggle — while standing in your own claim (or with manager permission), toggles allowAllNeighbors for that claim. When enabled, ALL players can bypass minimum distance checks for that claim. Permission: griefprevention.toggleclaimdistance.
• /claim distance check — shows the configured minimum distance and lists all nearby claims within range, each visualized with a conflict zone boundary. Permission: griefprevention.checkclaimdistance.

Auto-granted neighbor trust:

When MinimumDistance is set, existing claims that are already too close to each other automatically have their owners added as neighbors to each other's claims. This trust is automatically removed when a claim is abandoned (and no other claims from that owner remain nearby). Auto-granted trust cannot be removed via /untrust.

Trustlist display:

/trustlist shows neighbor-trusted players with a &d> (light purple) prefix, and the legend at the bottom includes "Neighbor" when neighbors exist.

Relevant permissions:

Permission	Default	Description
griefprevention.neighbortrust	child of griefprevention.claims	Allows use of /neighbortrust and /distancetrust.
griefprevention.checkclaimdistance	child of griefprevention.claims	Allows use of /claim distance check.
griefprevention.toggleclaimdistance	child of griefprevention.claims	Allows use of /claim distance toggle.

All of the above are children of griefprevention.claims, so existing servers with griefprevention.claims: true (the default) continue to work without changes.

Alias File (alias.yml)

Located at plugins/GriefPreventionData/alias.yml. The important top-level knobs:

enabled: true       # master switch for the alias system
standalone: true    # when false, only /claim and /aclaim are registered

• enabled: false disables the alias system entirely. All commands fall back to their internal English names.
• standalone: false keeps /claim and /aclaim but removes the per-command standalone aliases (/trust, /abandonclaim, etc.). Useful when another plugin owns those command names.

Each subcommand block under commands.claim.subcommands (and commands.aclaim.subcommands) controls:

• Whether the subcommand is enabled.
• What names / aliases it responds to.
• Its permission node.
• Tab-completion argument types.

The file itself carries extensive inline documentation; read it directly for the full schema.

Upstream Options

All upstream GriefPrevention config options still work. If you are migrating from upstream GP, start there — the values you already have will keep doing what they did before. See Migration for the things that changed.