🪧Placeholders

Placeholders

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

Special Placeholders

Center

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

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

Attention: The syntax of this placeholder is different from the others. Please follow the explanations carefully!

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 initial text, the ending text, and the total text size. 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%.