# Placeholders

## Placeholders

<table data-full-width="true"><thead><tr><th>Placeholder</th><th>Description</th></tr></thead><tbody><tr><td><code>%zessentials_armor_name_&#x3C;armor slot>%</code></td><td>Returns the name of the player’s armor, without the color</td></tr><tr><td><code>%zessentials_can_repair_all%</code></td><td>Returns true if the player can repair all of their items</td></tr><tr><td><code>%zessentials_center_&#x3C;first text>_&#x3C;second text>_&#x3C;text length>%</code></td><td>Transforms two placeholders to add space between them. This allows to create texts that will have the same space between the name of the player and his score for example.</td></tr><tr><td><code>%zessentials_count_repair_all%</code></td><td>Returns the number of items that the player can repair</td></tr><tr><td><code>%zessentials_economy_baltop_amount_&#x3C;economy name>_&#x3C;position>%</code></td><td>Returns the player's economy amount for the given economy and position</td></tr><tr><td><code>%zessentials_economy_baltop_formatted_amount_&#x3C;economy name>_&#x3C;position>%</code></td><td>Returns the player's economy formatted amount for the given economy and position</td></tr><tr><td><code>%zessentials_economy_baltop_name_&#x3C;economy name>_&#x3C;position>%</code></td><td>Returns the player's name for the given economy and position</td></tr><tr><td><code>%zessentials_economy_baltop_uuid_&#x3C;economy name>_&#x3C;position>%</code></td><td>Returns the player's uuid for the given economy and position</td></tr><tr><td><code>%zessentials_home_count%</code></td><td>Returns the number of homes</td></tr><tr><td><code>%zessentials_home_delete%</code></td><td>Returns the name of the home that the player wants to delete</td></tr><tr><td><code>%zessentials_home_exist_&#x3C;home name>%</code></td><td>Returns true if home exists, otherwise false</td></tr><tr><td><code>%zessentials_home_max%</code></td><td>Returns the number of max homes</td></tr><tr><td><code>%zessentials_iteminhand_amount%</code></td><td>Returns the amount of items in the main hand</td></tr><tr><td><code>%zessentials_iteminhand_custommodeldata%</code></td><td>Returns the custom model data of the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_displayname%</code></td><td>Returns the display name of the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_durability%</code></td><td>Returns the amount of durability left of the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_enchantmentlevel_&#x3C;enchantment>%</code></td><td>Returns the level of a specific enchantment on the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_enchantments%</code></td><td>Returns the enchantments of the item in hand with their level</td></tr><tr><td><code>%zessentials_iteminhand_fire_resistant%</code></td><td>Returns true if the item in hand is fire resistant</td></tr><tr><td><code>%zessentials_iteminhand_glint%</code></td><td>Returns true if the item in hand has the glint enchantment</td></tr><tr><td><code>%zessentials_iteminhand_hasenchantment_&#x3C;enchantment>%</code></td><td>Returns true if the item in hand has at least one enchantment</td></tr><tr><td><code>%zessentials_iteminhand_hasitemflag_&#x3C;item flag>%</code></td><td>Returns true if the item in hand has a specific itemflag</td></tr><tr><td><code>%zessentials_iteminhand_hide_tooltip%</code></td><td>Returns true if the item in hand has its tooltip hidden</td></tr><tr><td><code>%zessentials_iteminhand_hide_unbreakable%</code></td><td>Returns true if the tooltip unbreakable of the item in hand is hidden</td></tr><tr><td><code>%zessentials_iteminhand_itemflags%</code></td><td>Returns the itemflags of the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_lore%</code></td><td>Returns the lore of the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_maxdurability%</code></td><td>Returns the maximum durability of the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_maxstacksize%</code></td><td>Returns the max stack size of the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_rarity%</code></td><td>Returns the rarity of the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_realname%</code></td><td>Returns the formatted material name of the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_repaircost%</code></td><td>Returns the repair cost of the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_type%</code></td><td>Returns the material name of the item in hand</td></tr><tr><td><code>%zessentials_iteminhand_unbreakable%</code></td><td>Returns true if the item in hand is unbreakable</td></tr><tr><td><code>%zessentials_last_random_number_&#x3C;player name>%</code></td><td>Returns the last random number generated for the player within the last hour</td></tr><tr><td><code>%zessentials_last_random_player%</code></td><td>Returns the last random player name online</td></tr><tr><td><code>%zessentials_progressbar_&#x3C;current>_&#x3C;max>_&#x3C;size>_&#x3C;symbol>_&#x3C;completedColor>_&#x3C;notCompletedColor>%</code></td><td>Allows to transform two numbers into a progressbar, you can use placeholders</td></tr><tr><td><code>%zessentials_random_number_&#x3C;from>_&#x3C;to>%</code></td><td>Returns a random number between the two given arguments</td></tr><tr><td><code>%zessentials_random_player%</code></td><td>Returns a random player name online</td></tr><tr><td><code>%zessentials_random_word%</code></td><td>Generate a random word for the player, a word can only be generated once, you must delete the list of words generated with the command/ess clear-random-word</td></tr><tr><td><code>%zessentials_replace_&#x3C;placeholder>%</code></td><td>Replace the value of one placeholder with another</td></tr><tr><td><code>%zessentials_server_name%</code></td><td>Returns the server name</td></tr><tr><td><code>%zessentials_server_uptime%</code></td><td>Returns the server update in format day, hour, minutes and seconds</td></tr><tr><td><code>%zessentials_server_uptime_in_second%</code></td><td>Returns the server update in second</td></tr><tr><td><code>%zessentials_user_balance_&#x3C;economy>%</code></td><td>Returns the number for a given economy</td></tr><tr><td><code>%zessentials_user_biome%</code></td><td>Returns the biome of the player</td></tr><tr><td><code>%zessentials_user_block_x%</code></td><td>Returns the block x coordinate of the player</td></tr><tr><td><code>%zessentials_user_block_y%</code></td><td>Returns the block y coordinate of the player</td></tr><tr><td><code>%zessentials_user_block_z%</code></td><td>Returns the block z coordinate of the player</td></tr><tr><td><code>%zessentials_user_cooldown_formatted_&#x3C;cooldown key>%</code></td><td>Returns the remaining formatted time for the cooldown</td></tr><tr><td><code>%zessentials_user_cooldown_second_&#x3C;cooldown key>%</code></td><td>Returns the remaining time in seconds for the cooldown</td></tr><tr><td><code>%zessentials_user_current_session_playtime%</code></td><td>Returns the player’s playing time of the current session</td></tr><tr><td><code>%zessentials_user_current_session_playtime_formatted%</code></td><td>Returns the player’s playing time of the current session formatted</td></tr><tr><td><code>%zessentials_user_fly_seconds%</code></td><td>Returns the number of seconds for temporary fly</td></tr><tr><td><code>%zessentials_user_formatted_balance_&#x3C;economy>%</code></td><td>Returns the formatted number for a given economy</td></tr><tr><td><code>%zessentials_user_has_discord_linked%</code></td><td>Returns true if the player has a discord linked</td></tr><tr><td><code>%zessentials_user_has_kit_&#x3C;kit name>%</code></td><td>Returns true or false if the player has the kit</td></tr><tr><td><code>%zessentials_user_is_cooldown_&#x3C;cooldown key>%</code></td><td>Returns true if the key is a cooldown</td></tr><tr><td><code>%zessentials_user_is_god%</code></td><td>Returns the true if user is in god mode</td></tr><tr><td><code>%zessentials_user_is_mute%</code></td><td>Returns true if the player's is mute</td></tr><tr><td><code>%zessentials_user_kit_is_available_&#x3C;kit name>%</code></td><td>Returns true if the player can get the kit</td></tr><tr><td><code>%zessentials_user_kit_time_until_available_&#x3C;kit name>%</code></td><td>Returns the time before the player can use the kit again</td></tr><tr><td><code>%zessentials_user_mailbox_items%</code></td><td>Returns the number of items in the mailbox</td></tr><tr><td><code>%zessentials_user_mute_formatted%</code></td><td>Returns the remaining formatted time for the mute</td></tr><tr><td><code>%zessentials_user_mute_seconds%</code></td><td>Returns the remaining time in seconds for the mute</td></tr><tr><td><code>%zessentials_user_option_&#x3C;option name>%</code></td><td>Returns the value for an option</td></tr><tr><td><code>%zessentials_user_playtime%</code></td><td>Returns the player’s playing time</td></tr><tr><td><code>%zessentials_user_playtime_formatted%</code></td><td>Returns the player’s playing time formatted</td></tr><tr><td><code>%zessentials_user_position_&#x3C;economy name>%</code></td><td>Returns the player's position in baltop for a given economy</td></tr><tr><td><code>%zessentials_user_target_is_ban%</code></td><td>Returns true if the target player is banned, otherwise false</td></tr><tr><td><code>%zessentials_user_target_is_mute%</code></td><td>Returns true if the target player is muted, otherwise false</td></tr><tr><td><code>%zessentials_user_target_pay_amount%</code></td><td>Returns the number formatted for the /pay command</td></tr><tr><td><code>%zessentials_user_target_player_name%</code></td><td>Returns the name of the target player</td></tr><tr><td><code>%zessentials_user_world%</code></td><td>Returns the name of the world the player is currently in</td></tr><tr><td><code>%zessentials_user_worldedit_option_bossbar%</code></td><td>Returns true or false is the bossbar option is active</td></tr><tr><td><code>%zessentials_user_worldedit_option_inventory%</code></td><td>Returns true or false is the inventory option is active</td></tr><tr><td><code>%zessentials_user_x%</code></td><td>Returns the x coordinate of the player</td></tr><tr><td><code>%zessentials_user_y%</code></td><td>Returns the y coordinate of the player</td></tr><tr><td><code>%zessentials_user_z%</code></td><td>Returns the z coordinate of the player</td></tr><tr><td><code>%zessentials_vote_amount%</code></td><td>Returns the player vote amount</td></tr><tr><td><code>%zessentials_vote_site_cooldown_&#x3C;site>%</code></td><td>Returns the time remaining before voting</td></tr><tr><td><code>%zessentials_voteparty_amount%</code></td><td>Returns the progress of the vote party</td></tr><tr><td><code>%zessentials_voteparty_objective%</code></td><td>Returns the objective of the vote party</td></tr></tbody></table>

## Special Placeholders

### Center

This placeholder allows you to add space between two texts to align them. The result will look like this:

<figure><img src="https://3650476264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfAyz09ASs8veyxsflZ9y%2Fuploads%2F8ARnPrDcpJDrMbOpmByG%2Fholo2.png?alt=media&#x26;token=f01137de-9bd8-42a4-a466-35b997d5ebc5" alt="" width="295"><figcaption></figcaption></figure>

The placeholder will generate dots (`.`) between the player’s nickname and their argument.

{% hint style="danger" %}
**Attention:** The syntax of this placeholder is different from the others. Please follow the explanations carefully!
{% endhint %}

To understand how the placeholder works, let’s use the hologram example:

`%zessentials_center_{zessentials_economy_baltop_name_money_1}&7_{zessentials_economy_baltop_formatted_amount_money_1}_120%`

This placeholder consists of three elements: the <mark style="color:red;">initial text</mark>, the <mark style="color:red;">ending text</mark>, and the <mark style="color:red;">total text size</mark>. The placeholder will fill the remaining space to achieve the desired size.

Each element must be separated by an underscore (`_`).

You can use other placeholders within this structure. They must be enclosed in `{` and `}`. For example, `{zessentials_economy_baltop_name_money_1}` will become `%zessentials_economy_baltop_name_money_1%`.
