> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/general/placeholderapi.md).

# PlaceholderAPI

Requires **PlaceholderAPI**. Identifier: `edprison` — all placeholders are `%edprison_<params>%`. Unknown parameters return `Inexistent Placeholder`.

{% hint style="info" %}
**Nesting:** bracket placeholders are resolved first, so you can feed one placeholder into another: `%edprison_notation_{edprison_currency_tokens}%`. Placeholders return `Loading...` while a player's data is still being loaded, and only resolve for online players.
{% endhint %}

## Math & formatting

## `%edprison_notation_<number>%`

Applies the configured notation to a number.

## `%edprison_singlenotation_<number>%`

Applies single-number notation to a number (`1.234.567`).

## `%edprison_abbreviatednotation_<number>%`

Applies abbreviated notation to a number (`1.23M`).

## `%edprison_random_<min>|<max>%`

Generates a random between min and max.

## `%edprison_randomwithdecimals_<decimals>_<min>|<max>%`

Generates a random between min and max with decimals (you select the amount of decimals).

## `%edprison_round_<number>%`

Rounds a number to the nearest value, for example 0.4 will give 0 and 0.8 will give 1.

## `%edprison_roundbottom_<number>%`

Rounds a number to the bottom value (floor), for example 0.4 will give 0 and 0.8 will give aswell 0.

## `%edprison_roundupper_<number>%`

Rounds a number to the upper value (ceil), for example 0.4 will give 1 and 0.8 will give aswell 1.

## `%edprison_calc_<formula>%`

Calculates a math formula. For example: %edprison\_calc\_100\*100% will return 10000.

## Economy, levels & pickaxe

## `%edprison_currency_<currency>%`

Gets the amount of that currency.

## `%edprison_economy_<economy>%`

Gets the amount of that economy, it can be a currency or a level.

## `%edprison_all_economies%`

Gets a comma-separated list of all economies.

## `%edprison_level_<level>%`

Gets the level amount of that level type.

## `%edprison_costoflevels_<level>_<amount>%`

Gets the cost of X levels of that level type.

## `%edprison_blockslefttolevel_<level>%`

Gets the currency still needed to level of that level type.

## `%edprison_barlevel_<level>%`

Gets bar progress of that level (configured under `levels.<level>.bar`).

## `%edprison_percentlevel_<level>%`

Gets percent progress of that level.

## `%edprison_pickaxe_item%`

Gets the player's pickaxe as a serialized ItemStack (for `itemstack:` GUI items).

## Enchantments

## `%edprison_enchant_level_<enchant>%`

Gets the level of that enchant.

## `%edprison_enchant_maxlevel_<enchant>%`

Gets the max level of that enchant.

## `%edprison_enchant_currency_<enchant>%`

Gets the currency that enchant costs.

## `%edprison_enchant_total%`

Gets the number of enchants the player owns (level > 0).

## `%edprison_enchant_activationchance_<enchant>%`

Gets the activation chance of that enchant.

## `%edprison_enchant_activationchancefromlevel_<enchant>_<level>%`

Gets the activation chance of that enchant on that level.

## `%edprison_enchant_maxaffordable_<enchant>%`

Gets the max affordable levels of an enchant.

## `%edprison_enchant_upgrade_cost_<levels>_<enchant>%`

Gets the cost of that levels of that enchant.

## `%edprison_enchant_refund_return_<levels>_<enchant>%`

Gets the return amount that will give the refund of that levels of that enchant.

## `%edprison_all_enchants%`

Gets a comma-separated list of active enchants.

## Gangs

## `%edprison_gang%`

Gets the player gang (or the `placeholders.no-gang` text from config.yml).

## `%edprison_gang_points%`

Gets the points of the player's gang.

## `%edprison_gang_points_<gang>%`

Gets the points of a gang.

## `%edprison_gang_members_<gang>%`

Gets the members of a gang, formatted through config (`chat.members`).

## `%edprison_gang_members_size_<gang>%`

Gets the amount of members a gang has.

## `%edprison_gang_maxmembers%`

Gets the gang max members.

## `%edprison_gang_name_<player>%`

Gets the gang name of a player (`---` if none).

## `%edprison_gang_contributions_<gang>%`

Gets the gang contributions of a gang. The formatted message of config (`chat.contributions`).

## Auction house

## `%edprison_auction_items%`

Gets all the auction items, useful for doing a paginated gui menu of the items.

## `%edprison_auction_youritems%`

Gets all the auction items of the player (including expired ones).

## `%edprison_auction_listings%`

Gets the number of listings the player has.

## `%edprison_auction_item_<ItemID>%`

Gets an item of the auction house (serialized ItemStack, for `itemstack:`).

## `%edprison_auction_seller_<ItemID>%`

Gets the seller of that item.

## `%edprison_auction_currency_<ItemID>%`

Gets the currency of that item.

## `%edprison_auction_amount_<ItemID>%`

Gets the amount of currency to pay for that item.

## `%edprison_auction_expired_<ItemID>%`

Returns true or false if an auction item has expired.

## `%edprison_auction_whenexpires_<ItemID>%`

Gets the time until that item expires.

## Robots & autosell

## `%edprison_robots%`

Gets the player robots (also refreshes their income).

## `%edprison_robot_material_<Robot>%`

Gets the material of the robot.

## `%edprison_robot_name_<Robot>%`

Gets the name of the robot.

## `%edprison_robot_lore_<Robot>%`

Gets the lore of the robot.

## `%edprison_robot_custommodeldata_<Robot>%`

Gets the custom model data of the robot.

## `%edprison_robot_currency_<currency>%`

Gets the amount of currency a player has to withdraw.

## `%edprison_autosell_summary_<currency>%`

Gets the amount of currency a player has in autosell summary.

## Variables & misc

## `%edprison_variable_static_<variable>%`

Gets the value of that static variable.

## `%edprison_variable_changeable_<variable>%`

Gets the value of that changeable variable.

## `%edprison_hasperm_<permission>%`

Returns true/false if the player has that permission.

## `%edprison_onlineplayers%`

Gets all online players.

## `%edprison_placeholderof_<player>_<{placeholder}>%`

Gets the placeholder of a player.

## `%edprison_blockmaterialat_world,x,y,z%`

Gets the block material at that position.