Placeholders

Placeholders (PlaceholderAPI)

GriefPrevention3D provides its own PlaceholderAPI expansion with identifier gp3d. These placeholders can be used in any plugin that supports PlaceholderAPI (chat plugins, scoreboards, holograms, TAB, etc.).

In addition, GriefPrevention's official PlaceholderAPI expansion can be installed from the PlaceholderAPI eCloud to provide claim block and owner placeholders.

Installation

GriefPrevention3D placeholders

No setup is required. GriefPrevention3D automatically registers its PlaceholderAPI expansion on startup.

• Expansion ID: gp3d
• Persists: Yes

Additional GriefPrevention placeholders

Install the official GriefPrevention PlaceholderAPI expansion:

/papi ecloud download GriefPrevention
/papi reload

• Expansion ID: griefprevention

---

GriefPrevention3D Placeholders

Available Placeholders

Placeholder	Description	Example Output
%gp3d_in_subdivision%	Whether the player is inside a subdivision (child claim)	true / false
%gp3d_in_3d_subdivision%	Whether the player is inside a 3D subdivision	true / false
%gp3d_is_trusted%	Whether the player has any trust level in the current claim	true / false
%gp3d_trust_level%	The player's trust level in the current claim (localized)	Owner, Manager, Builder, Container, Access, Untrusted, Unclaimed

Trust Level Values

The %gp3d_trust_level% placeholder returns a localized string based on the player's trust in the current claim.

Trust Level	Description
Owner	Player owns the claim
Manager	Player has Manage trust (can manage claim settings and trust others)
Builder	Player has Build trust (can build and break blocks)
Container	Player has Container trust (can access containers)
Access	Player has Access trust (can use doors, buttons, and enter the claim)
Neighbor	Player has Neighbor trust (can create claims nearby)
Untrusted	Player is inside a claim but has no trust
Unclaimed	Player is not standing inside a claim

---

GriefPrevention Placeholders

These placeholders are provided by PlaceholderAPI's GriefPrevention expansion.

Claim Statistics

Placeholder	Description	Example Output
%griefprevention_claims%	Number of claims the player owns	5
%griefprevention_claims_formatted%	Formatted claim count	5
%griefprevention_bonusclaims%	Player's bonus claim blocks	1000
%griefprevention_bonusclaims_formatted%	Formatted bonus claim blocks	1,000
%griefprevention_accruedclaims%	Player's accrued claim blocks	2500
%griefprevention_accruedclaims_formatted%	Formatted accrued claim blocks	2,500
%griefprevention_remainingclaims%	Remaining claim blocks available to the player	3200
%griefprevention_remainingclaims_formatted%	Formatted remaining claim blocks	3,200

Current Claim Information

Placeholder	Description	Example Output
%griefprevention_currentclaim_ownername%	Owner of the claim the player is currently standing in	Steve
%griefprevention_currentclaim_ownername_color%	Owner name with Minecraft colors applied	§aSteve

---

Usage Examples

Chat Plugins

Example (EssentialsChat, ChatControl, etc.):

Format: "{prefix} <player> %gp3d_trust_level%"

Result:

[Member] <Steve> Builder

---

Holograms

Example (HolographicDisplays):

Line 1: "&bCurrent Claim Status"
Line 2: "&eTrust: &f%gp3d_trust_level%"
Line 3: "&eClaim Blocks: &f%griefprevention_remainingclaims_formatted%"
Line 4: "&eOwner: &f%griefprevention_currentclaim_ownername%"
Line 5: "&eIn Subdivision: &f%gp3d_in_subdivision%"
Line 6: "&eIn 3D Subdivision: &f%gp3d_in_3d_subdivision%"

---

Scoreboards

Example:

Title: "&6Claim Info"
Line 1: "&eTrust: &f%gp3d_trust_level%"
Line 2: "&eClaim Blocks: &f%griefprevention_remainingclaims_formatted%"
Line 3: "&eOwner: &f%griefprevention_currentclaim_ownername%"
Line 4: "&eSub: &f%gp3d_in_subdivision%"
Line 5: "&e3D Sub: &f%gp3d_in_3d_subdivision%"

---

Localization

The trust level strings returned by %gp3d_trust_level% are fully localizable through messages.yml:

Messages:
  PlaceholderTrustLevelUnclaimed: "Unclaimed"
  PlaceholderTrustLevelOwner: "Owner"
  PlaceholderTrustLevelManager: "Manager"
  PlaceholderTrustLevelBuilder: "Builder"
  PlaceholderTrustLevelContainer: "Container"
  PlaceholderTrustLevelAccess: "Access"
  PlaceholderTrustLevelNeighbor: "Neighbor"
  PlaceholderTrustLevelUntrusted: "Untrusted"

---

Notes

• GriefPrevention3D automatically registers its PlaceholderAPI expansion.
• %gp3d_trust_level% uses localized strings from messages.yml.
• Player-specific placeholders require the target player to be online.
• GriefPrevention3D uses persist() = true, allowing placeholders to remain available across PlaceholderAPI reloads.
• Both gp3d and griefprevention placeholders can be used together in any PlaceholderAPI-compatible plugin.