> For the complete documentation index, see [llms.txt](https://toonystank.gitbook.io/grief-prevention-gui-addon-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://toonystank.gitbook.io/grief-prevention-gui-addon-wiki/placeholders.md). # Placeholders All placeholders can be used with either the **`%griefprevgui_...%`** or **`%gpextension_...%`** prefix. ## 🟢 Global Player Data Statistics regarding the player viewing the placeholder. | Placeholder | Description | | ------------------------------------------ | ------------------------------------------------------------------ | | `%griefprevgui_claimblocks%` | Total accrued claim blocks. | | `%griefprevgui_claimblocks_formatted%` | Total claim blocks formatted (e.g., 1.5k). | | `%griefprevgui_remainingblocks%` | Remaining available claim blocks. | | `%griefprevgui_remainingblocks_formatted%` | Remaining blocks formatted. | | `%griefprevgui_claimcount%` | Number of claims owned by the player. | | `%griefprevgui_trustcount%` | Number of claims the player is trusted in. | | `%griefprevgui_managercount%` | Number of claims the player has manager permissions in. | | `%griefprevgui_flighttime%` | Remaining flight time. | | `%griefprevgui_isholding_createwand%` | Returns `true` if holding the claim creation tool (Golden Shovel). | ## 🌍 World & Economy General server and economy information. | Placeholder | Description | | ----------------------------------------------- | ----------------------------------------------------------------- | | `%griefprevgui_online_online%` | Total count of players online. | | `%griefprevgui_online_player%` | Viewer's player name. | | `%griefprevgui_online_playeruuid%` | Viewer's UUID. | | `%griefprevgui_otherplayer_uuid_%` | Get the UUID of a specific player name. | | `%griefprevgui_otherplayer_displayname_%` | Get the display name of a specific player name. | | `%griefprevgui_warpsize%` | Total number of claims on the server that have a public warp set. | | `%griefprevgui_price_purchase_%` | Calculate the cost to **buy** `` claim blocks. | | `%griefprevgui_price_sell_%` | Calculate the return to **sell** `` claim blocks. | | `%griefprevgui_areaprice_%` | Calculate the cost for a claim of a specific area size. | | `%griefprevgui_isenabled_economy%` | Returns `true` if economy integration is enabled. | | `%griefprevgui_isenabled_teleport%` | Returns `true` if teleportation features are enabled. | | `%griefprevgui_isenabled_warp%` | Returns `true` if warp features are enabled. | ## 🔍 Location Checks Check if specific locations are claimed. | Placeholder | Description | | -------------------------------------- | -------------------------------------------------------- | | `%griefprevgui_isclaimed_lookingat%` | `true` if the block the player is looking at is claimed. | | `%griefprevgui_isclaimed___%` | `true` if the specific coordinates are claimed. | | `%griefprevgui_claimedby_lookingat%` | Name of the owner of the claim being looked at. | | `%griefprevgui_claimedby___%` | Name of the owner at the specific coordinates. | ## 📍 "Standing In" Context These placeholders return data strictly about the claim the player is **currently standing inside**. | Placeholder | Description | | ---------------------------------------------- | ---------------------------------------------------------------------------------- | | `%griefprevgui_standing_id%` | The numerical ID of the claim. | | `%griefprevgui_standing_owner%` | The name of the claim owner. | | `%griefprevgui_standing_size%` | The total area size (blocks). | | `%griefprevgui_standing_permission%` | The viewer's permission level in this claim (e.g., Access, Trust, Manager, Owner). | | `%griefprevgui_standing_flag_list%` | A list of all active flags in this claim. | | `%griefprevgui_standing_flag_isactive_%` | `true` if the specific `` is active here. | ## 🆔 Specific Claim Data (Get By ID) Retrieve information about any claim by its ID. > **Note:** You can replace `` with **`here`** to automatically target the claim the player is standing in. ### Basic Information | Placeholder | Description | | ---------------------------------------------- | ---------------------------------------------------- | | `%griefprevgui_getbyid_owner_%` | Name of the claim owner. | | `%griefprevgui_getbyid_claimname_%` | The custom name of the claim. | | `%griefprevgui_getbyid_claimdescription_%` | The description of the claim. | | `%griefprevgui_getbyid_claimicon_%` | The icon material of the claim (e.g., GRASS\_BLOCK). | | `%griefprevgui_getbyid_location_%` | Formatted center location of the claim. | | `%griefprevgui_getbyid_size_%` | Total area size. | | `%griefprevgui_getbyid_biome_%` | The biome at the center of the claim. | | `%griefprevgui_getbyid_expiretime_%` | Date/Time when the claim will expire. | | `%griefprevgui_getbyid_isexist_%` | `true` if a claim with this ID exists. | | `%griefprevgui_getbyid_isin_%` | `true` if the viewer is currently inside this claim. | | `%griefprevgui_getbyid_warplocation_%` | The formatted location of the claim's warp. | | `%griefprevgui_getbyid_issubdiv_%` | `true` if this claim is a subdivision. | | `%griefprevgui_getbyid_subsize_%` | The number of subdivisions inside this claim. | | `%griefprevgui_getbyid_centerblock_%` | Returns the material of the center block. | ### Permissions & Trust | Placeholder | Description | | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `%griefprevgui_getbyid_istrusted_%` | `true` if the viewer is trusted in this claim. | | `%griefprevgui_getbyid_isbuild_%` | `true` if the viewer has build permission. | | `%griefprevgui_getbyid_trustsize_%` | Total number of trusted players. | | `%griefprevgui_getbyid_trustlist__%` |

Formatted list of trusted players.
Types: manager, trusted, inventory, access.

| | `%griefprevgui_getbyid_trust__%` | Get the **Name** of the trusted player at ``. | | `%griefprevgui_getbyid_trustuuid__%` | Get the **UUID** of the trusted player at ``. | | `%griefprevgui_getbyid_permission__%` | Get the permission level of a specific UUID. | | `%griefprevgui_getbyid_permissionname__%` | Get the permission level of a specific Name. | | `%griefprevgui_getbyid_editaccess__%` | `true` if the viewer is allowed to edit the permissions of ``. | | `%griefprevgui_getbyid_canremovepermission__%` | `true` if the viewer is allowed to remove `` from the claim. | ### Flags | Placeholder | Description | | ------------------------------------------------------------ | -------------------------------------------- | | `%griefprevgui_getbyid_flags_isactive__%` | `true`/`false` if the flag is active. | | `%griefprevgui_getbyid_flags_isactiveformatted__%` | "Enabled"/"Disabled" (formatted). | | `%griefprevgui_getbyid_flags_parma__%` | Returns the flag's specific value parameter. | | `%griefprevgui_getbyid_flags_listflags_%` | Returns a list of all active flags. | ### Bans & Entry Control | Placeholder | Description | | ------------------------------------------------------------- | --------------------------------------------- | | `%griefprevgui_getbyid_blocked_size_%` | Number of blocked players. | | `%griefprevgui_getbyid_blocked_players_%` | List of blocked player names. | | `%griefprevgui_getbyid_blocked_contains__%` | `true` if the specific player is blocked. | | `%griefprevgui_getbyid_blocked_get__%` | Get the blocked player name at ``. | | `%griefprevgui_getbyid_claimentry__whitelistsize%` | Number of whitelisted players (NoEnter). | | `%griefprevgui_getbyid_claimentry__whitelistedplayers%` | List of whitelisted players. | | `%griefprevgui_getbyid_claimentry__iswhitelisted_%` | `true` if the specific player is whitelisted. | | `%griefprevgui_getbyid_claimentry__blocklistsize%` | Number of blacklisted players (NoEnter). | | `%griefprevgui_getbyid_claimentry__blacklistedplayers%` | List of blacklisted players. | | `%griefprevgui_getbyid_claimentry__isblacklisted_%` | `true` if the specific player is blacklisted. | | `%griefprevgui_getbyid_claimentry__isblockedforeveryone%` | `true` if the claim is closed to everyone. | ### Mob Spawning | Placeholder | Description | | ------------------------------------------------------------------------- | ---------------------------------------- | | `%griefprevgui_getbyid_nomobspawnstype_allowedspawnreasons_%` | List of allowed spawn reasons. | | `%griefprevgui_getbyid_nomobspawnstype_disallowedentities_%` | List of disallowed entity types. | | `%griefprevgui_getbyid_nomobspawnstype_disallowedentity__%` | `true` if the entity type is disallowed. | | `%griefprevgui_getbyid_nomobspawnstype_allowedspawnreason__%` | `true` if the spawn reason is allowed. | ### Utility | Placeholder | Description | | ------------------------------------------------ | -------------------------------------------------------------------- | | `%griefprevgui_getbyid_isinvited_%` | `true` if the viewer has a pending invite to this claim. | | `%griefprevgui_getbyid_invitor_%` | Name of the person who invited the viewer. | | `%griefprevgui_getbyid_centerblocklist_%` | Returns the center block icon of the Nth claim in the viewer's list. | | `%griefprevgui_getclaimid_%` | Returns the Claim ID of the Nth claim in the viewer's trust list. |