Placeholders are dynamic values that get replaced with actual content when they are used. In FancyMenu, placeholders allow you to insert dynamic content into various elements like text, buttons, and loading requirements. Think of them as variables that get evaluated and replaced with their actual values when your layouts are displayed.
Placeholders in FancyMenu use a JSON-like syntax:
{"placeholder":"placeholder_id","values":{"value_name":"value"}}
For example, to display the player's name:
{"placeholder":"playername"}
One of the most powerful features of FancyMenu's placeholder system is the ability to nest placeholders within other placeholders. This means you can use the output of one placeholder as an input for another.
Example of nested placeholders:
{"placeholder":"calc","values":{"decimal":"true","expression":"{"placeholder":"maxram"} / 1024"}}
This example takes the maximum RAM value and divides it by 1024 to convert it from MB to GB.
Nested placeholders in FancyMenu do NOT GET ESCAPED like regular JSON. Nested placeholders look the same as not-nested placeholders.
This is wrong:{"placeholder":"calc","values":{"expression":"{\"placeholder\":\"getvariable\",\"values\":{\"name\":\"fadeDelayTimer\"}} - 1"}}
This is right:{"placeholder":"calc","values":{"expression":"{"placeholder":"getvariable","values":{"name":"fadeDelayTimer"}} - 1"}}
Most elements that have text inputs support placeholders. You can see if a text input supports placeholders when editing it. If the full-screen text editor opens when editing the text, it supports placeholders.
To find a list of all placeholders, just click on the Placeholders button in the top-right corner of the text editor.
There is a search bar at the top of the placeholders list that lets you search for placeholders.
Clicking on a placeholder in the placeholder list will paste it to the text content.
playername
)Returns the current player's username.
{"placeholder":"playername"}
Example output: Steve
playeruuid
)Returns the player's unique identifier.
{"placeholder":"playeruuid"}
Example output: c8cde7fe-7ced-11eb-9439-0242ac130002
mcversion
)Returns the current Minecraft version.
{"placeholder":"mcversion"}
Example output: 1.19.2
loaderver
)Returns the version of the mod loader (Forge/Fabric).
{"placeholder":"loaderver"}
Example output: 43.2.0
loadername
)Returns the name of the mod loader.
{"placeholder":"loadername"}
Example output: Forge
modversion
)Returns the version of a specific mod.
{"placeholder":"modversion","values":{"modid":"fancymenu"}}
Example output: 2.14.9
totalmods
)Returns the total number of mods installed.
{"placeholder":"totalmods"}
Example output: 45
loadedmods
)Returns the number of currently loaded mods.
{"placeholder":"loadedmods"}
Example output: 43
world_load_progress
)Returns the current world loading progress as a percentage.
{"placeholder":"world_load_progress"}
Example output: 75
minecraft_option_value
)Returns the value of a Minecraft option.
{"placeholder":"minecraft_option_value","values":{"name":"fov"}}
Example output: 70
last_world_server
)Returns information about the last world or server accessed.
{"placeholder":"last_world_server","values":{"type":"both","full_world_path":"true"}}
Parameters:
type
: Determines what type of information to return
"both"
: Returns the last accessed world or server (default)"server"
: Only returns if the last accessed was a server"world"
: Only returns if the last accessed was a worldfull_world_path
: Controls how world paths are displayed
"true"
: Returns the full world path (default)"false"
: Returns only the world name without path (does not affect servers)Examples:
mc.hypixel.net
saves/New World
New World
guiwidth
)Returns the current screen width.
{"placeholder":"guiwidth"}
Example output: 1920
guiheight
)Returns the current screen height.
{"placeholder":"guiheight"}
Example output: 1080
screenid
)Returns the identifier of the current screen.
{"placeholder":"screenid"}
Example output: title_screen
elementwidth
)Returns the width of a specific element.
{"placeholder":"elementwidth","values":{"id":"my_button"}}
Example output: 200
elementheight
)Returns the height of a specific element.
{"placeholder":"elementheight","values":{"id":"my_button"}}
Example output: 20
elementposx
)Returns the X position of a specific element.
{"placeholder":"elementposx","values":{"id":"my_button"}}
Example output: 150
elementposy
)Returns the Y position of a specific element.
{"placeholder":"elementposy","values":{"id":"my_button"}}
Example output: 100
mouseposx
)Returns the current X position of the mouse.
{"placeholder":"mouseposx"}
Example output: 960
mouseposy
)Returns the current Y position of the mouse.
{"placeholder":"mouseposy"}
Example output: 540
guiscale
)Returns the current GUI scale.
{"placeholder":"guiscale"}
Example output: 2
vanillabuttonlabel
)Returns the label/text of a vanilla widget/button.
{"placeholder":"vanillabuttonlabel","values":{"locator":"some.menu.identifier:505280"}}
Example output: Options...
current_player_health
)Returns the player's current health points.
{"placeholder":"current_player_health"}
Example output: 20.0
max_player_health
)Returns the player's maximum health points.
{"placeholder":"max_player_health"}
Example output: 20.0
current_player_health_percent
)Returns the player's health as a percentage.
{"placeholder":"current_player_health_percent"}
Example output: 100
current_player_absorption_health
)Returns the player's absorption health points (golden hearts).
{"placeholder":"current_player_absorption_health"}
Example output: 4.0
max_player_absorption_health
)Returns the maximum absorption health.
{"placeholder":"max_player_absorption_health"}
Example output: 4.0
current_player_absorption_health_percentage
)Returns the player's absorption health as a percentage.
{"placeholder":"current_player_absorption_health_percentage"}
Example output: 100
current_player_hunger
)Returns the player's current hunger level.
{"placeholder":"current_player_hunger"}
Example output: 20
max_player_hunger
)Returns the maximum hunger level.
{"placeholder":"max_player_hunger"}
Example output: 20
current_player_hunger_percentage
)Returns the player's hunger as a percentage.
{"placeholder":"current_player_hunger_percentage"}
Example output: 100
current_player_armor
)Returns the player's current armor value.
{"placeholder":"current_player_armor"}
Example output: 20
max_player_armor
)Returns the maximum armor value.
{"placeholder":"max_player_armor"}
Example output: 20
current_player_armor_percentage
)Returns the player's armor as a percentage.
{"placeholder":"current_player_armor_percentage"}
Example output: 100
current_player_oxygen
)Returns the player's current oxygen level (air bubbles).
{"placeholder":"current_player_oxygen"}
Example output: 300
max_player_oxygen
)Returns the maximum oxygen level.
{"placeholder":"max_player_oxygen"}
Example output: 300
current_player_oxygen_percentage
)Returns the player's oxygen level as a percentage.
{"placeholder":"current_player_oxygen_percentage"}
Example output: 100
current_player_level
)Returns the player's current experience level.
{"placeholder":"current_player_level"}
Example output: 30
current_player_exp
)Returns the player's total experience points.
{"placeholder":"current_player_exp"}
Example output: 1250
current_player_exp_progress
)Returns the player's experience progress to the next level as a percentage.
{"placeholder":"current_player_exp_progress"}
Example output: 75
player_attack_strength
)Returns the player's attack cooldown as a percentage.
{"placeholder":"player_attack_strength"}
Example output: 100
player_gamemode
)Returns the player's current game mode.
{"placeholder":"player_gamemode"}
Example output: survival
player_view_direction
)Returns the direction the player is facing.
{"placeholder":"player_view_direction"}
Example output: north
player_x_coordinate
)Returns the player's X position in the world.
{"placeholder":"player_x_coordinate"}
Example output: 125
player_y_coordinate
)Returns the player's Y position in the world.
{"placeholder":"player_y_coordinate"}
Example output: 64
player_z_coordinate
)Returns the player's Z position in the world.
{"placeholder":"player_z_coordinate"}
Example output: -250
player_has_tag
)Returns true if a specific player has a specific tag.
{"placeholder":"player_has_tag","values":{"player_name":"Steve","tag":"special_player"}}
Example output: true
or false
player_tags_list
)Returns all tags that a specific player has.
{"placeholder":"player_tags_list","values":{"player_name":"Steve","separator":", "}}
Example output: special_player, vip, admin
current_mount_health
)Returns the current health of the entity the player is riding.
{"placeholder":"current_mount_health"}
Example output: 30.0
max_mount_health
)Returns the maximum health of the entity the player is riding.
{"placeholder":"max_mount_health"}
Example output: 30.0
current_mount_health_percentage
)Returns the mount's health as a percentage.
{"placeholder":"current_mount_health_percentage"}
Example output: 100
current_mount_jump_meter
)Returns the mount's jump power meter value.
{"placeholder":"current_mount_jump_meter"}
Example output: 75
current_boss_health
)Returns the health of the active boss.
{"placeholder":"current_boss_health"}
Example output: 150.0
boss_name
)Returns the name of the active boss.
{"placeholder":"boss_name","values":{"boss_index":"0","as_json":"false"}}
Example output: Ender Dragon
boss_count
)Returns the number of active bosses.
{"placeholder":"boss_count"}
Example output: 1
effects_count
)Returns the number of active potion effects.
{"placeholder":"effects_count"}
Example output: 3
active_effect
)Returns information about a specific active effect.
{"placeholder":"active_effect","values":{"effect_index":"0"}}
Example output: minecraft:speed
active_hotbar_slot
)Returns the currently selected hotbar slot (0-8).
{"placeholder":"active_hotbar_slot"}
Example output: 4
slot_item
)Returns information about an item in a specific inventory slot.
{"placeholder":"slot_item","values":{"slot":"0"}}
Example output: minecraft:diamond_sword
gametime
)Returns the current in-game time.
{"placeholder":"gametime"}
Example output: 18000
world_day_time
)Returns the current world day time.
{"placeholder":"world_day_time"}
Example output: 13000
world_daytime_hour
)Returns the hour component of world time (00-23).
{"placeholder":"world_daytime_hour"}
Example output: 12
world_daytime_minute
)Returns the minute component of world time (00-59).
{"placeholder":"world_daytime_minute"}
Example output: 30
world_difficulty
)Returns the current world difficulty.
{"placeholder":"world_difficulty"}
Example output: normal
current_title
)Returns the currently displayed title text.
{"placeholder":"current_title","values":{"is_subtitle":"false","as_json":"false"}}
Example output: Game Over!
current_server_ip
)Returns the IP of the connected server.
{"placeholder":"current_server_ip"}
Example output: mc.hypixel.net
world_players_list
)Returns a list of all players currently in the world.
{"placeholder":"world_players_list","values":{"separator":", "}}
Example output: Steve, Alex, Notch
servermotd
)Returns the Message of the Day of a server.
{"placeholder":"servermotd","values":{"ip":"mc.hypixel.net","line":"1"}}
Example output: Welcome to Hypixel!
serverping
)Returns the ping to a server in milliseconds.
{"placeholder":"serverping","values":{"ip":"mc.hypixel.net"}}
Example output: 54
serverplayercount
)Returns the player count of a server.
{"placeholder":"serverplayercount","values":{"ip":"mc.hypixel.net"}}
Example output: 25000/30000
serverstatus
)Returns the online/offline status of a server.
{"placeholder":"serverstatus","values":{"ip":"mc.hypixel.net"}}
Example output: §aOnline
or §cOffline
serverversion
)Returns the Minecraft version of a server.
{"placeholder":"serverversion","values":{"ip":"mc.hypixel.net"}}
Example output: 1.19.2
realtimeyear
)Returns the current year.
{"placeholder":"realtimeyear"}
Example output: 2024
realtimemonth
)Returns the current month (01-12).
{"placeholder":"realtimemonth"}
Example output: 01
realtimeday
)Returns the current day of the month (01-31).
{"placeholder":"realtimeday"}
Example output: 27
realtimehour
)Returns the current hour (00-23).
{"placeholder":"realtimehour"}
Example output: 14
realtimeminute
)Returns the current minute (00-59).
{"placeholder":"realtimeminute"}
Example output: 30
realtimesecond
)Returns the current second (00-59).
{"placeholder":"realtimesecond"}
Example output: 45
unix_time
)Returns the current Unix timestamp in milliseconds.
{"placeholder":"unix_time"}
Example output: 1716552478123
cpuinfo
)Returns information about the CPU.
{"placeholder":"cpuinfo"}
Example output: Intel(R) Core(TM) i7-10700K CPU @ 3.80GHz
jvmcpu
)Returns the JVM's CPU usage as a percentage.
{"placeholder":"jvmcpu"}
Example output: 25.5
oscpu
)Returns the OS CPU usage as a percentage.
{"placeholder":"oscpu"}
Example output: 42.8
gpuinfo
)Returns information about the GPU.
{"placeholder":"gpuinfo"}
Example output: NVIDIA GeForce RTX 3080
javaver
)Returns the Java version.
{"placeholder":"javaver"}
Example output: 17.0.2
jvmname
)Returns the name of the Java Virtual Machine.
{"placeholder":"jvmname"}
Example output: OpenJDK 64-Bit Server VM
glver
)Returns the OpenGL version.
{"placeholder":"glver"}
Example output: 4.6.0 NVIDIA 516.94
osname
)Returns the operating system name.
{"placeholder":"osname"}
Example output: Windows 10
fps
)Returns the current frames per second.
{"placeholder":"fps"}
Example output: 120
usedram
)Returns the amount of RAM currently in use (MB).
{"placeholder":"usedram"}
Example output: 4096
maxram
)Returns the maximum allocated RAM (MB).
{"placeholder":"maxram"}
Example output: 8192
percentram
)Returns the percentage of RAM currently in use.
{"placeholder":"percentram"}
Example output: 50
audio_element_volume
)Returns the volume of an audio element.
{"placeholder":"audio_element_volume","values":{"element_identifier":"background_music"}}
Example output: 0.5
audio_element_current_track
)Returns the track name of an audio element.
{"placeholder":"audio_element_current_track","values":{"element_identifier":"background_music","display_name_mappings":"track1.ogg=>Cool Track Name"}}
Example output: Cool Track Name
audio_duration
)Returns the total duration of an audio track in MM:SS format.
{"placeholder":"audio_duration","values":{"element_identifier":"background_music"}}
Example output: 03:45
audio_element_playtime
)Returns the current playtime of an audio track.
{"placeholder":"audio_element_playtime","values":{"element_identifier":"background_music"}}
Example output: 01:30
audio_playing_state
)Returns whether an audio element is playing (true/false).
{"placeholder":"audio_playing_state","values":{"element_identifier":"background_music"}}
Example output: true
video_element_vol
)Returns the volume level of a video element (0.0 to 1.0).
{"placeholder":"video_element_vol","values":{"element_identifier":"my_video_element"}}
Example output: 0.5
video_element_duration
)Returns the total duration of a video element in seconds.
{"placeholder":"video_element_duration","values":{"element_identifier":"my_video_element"}}
Example output: 120.5
video_element_playtime
)Returns the current playback time (progress) of a video element in seconds.
{"placeholder":"video_element_playtime","values":{"element_identifier":"my_video_element"}}
Example output: 45.2
video_element_paused_state
)Returns whether a video element is paused (true/false).
{"placeholder":"video_element_paused_state","values":{"element_identifier":"my_video_element"}}
Example output: false
video_background_vol
)Returns the volume level of a video menu background (0.0 to 1.0).
{"placeholder":"video_background_vol","values":{"background_identifier":"main_menu_video"}}
Example output: 0.7
video_background_duration
)Returns the total duration of a video menu background in seconds.
{"placeholder":"video_background_duration","values":{"background_identifier":"main_menu_video"}}
Example output: 180.0
video_background_playtime
)Returns the current playback time (progress) of a video menu background in seconds.
{"placeholder":"video_background_playtime","values":{"background_identifier":"main_menu_video"}}
Example output: 60.5
video_background_paused_state
)Returns whether a video menu background is paused (true/false).
{"placeholder":"video_background_paused_state","values":{"background_identifier":"main_menu_video"}}
Example output: true
calc
)The calculator placeholder is a powerful tool that allows you to perform mathematical calculations within your layouts. It supports a wide range of mathematical operations and can work with both decimal and integer numbers.
{"placeholder":"calc","values":{"decimal":"true/false","expression":"your_expression"}}
The calculator has two main parameters:
decimal
: Determines whether the result should include decimal places (true
) or be rounded to integers (false
)expression
: The mathematical expression to evaluateThe calculator supports these mathematical operations:
+
(addition), -
(subtraction), *
(multiplication), /
(division)( )
for grouping operations^
for exponentssqrt()
sin()
, cos()
, tan()
pi
, e
abs()
log()
, ln()
random_number
)Generates a random number within a specified range.
{"placeholder":"random_number","values":{"min":"1","max":"100"}}
Example output: 42
maxnum
)Returns the larger of two numbers.
{"placeholder":"maxnum","values":{"first":"10","second":"20"}}
Example output: 20
minnum
)Returns the smaller of two numbers.
{"placeholder":"minnum","values":{"first":"10","second":"20"}}
Example output: 10
absolute_number
)Returns the absolute value of a number.
{"placeholder":"absolute_number","values":{"number":"-10.5"}}
Example output: 10.5
negate_number
)Returns the negated value of a number.
{"placeholder":"negate_number","values":{"number":"10.5"}}
Example output: -10.5
math_pi
)Returns the value of π.
{"placeholder":"math_pi"}
Example output: 3.141592653589793
math_sin
)Returns the sine of an angle.
{"placeholder":"math_sin","values":{"angle":"45"}}
Example output: 0.7071067811865476
math_cos
)Returns the cosine of an angle.
{"placeholder":"math_cos","values":{"angle":"45"}}
Example output: 0.7071067811865476
math_tan
)Returns the tangent of an angle.
{"placeholder":"math_tan","values":{"angle":"45"}}
Example output: 1.0
math_floor
)Rounds a number down to the nearest integer.
{"placeholder":"math_floor","values":{"num":"3.14"}}
Example output: 3
math_ceil
)Rounds a number up to the nearest integer.
{"placeholder":"math_ceil","values":{"num":"3.14"}}
Example output: 4
math_round
)Rounds a number to the nearest integer.
{"placeholder":"math_round","values":{"num":"3.14"}}
Example output: 3
math_sign
)Returns the sign of a number (1 for positive, -1 for negative, 0 for zero).
{"placeholder":"math_sign","values":{"num":"-3.14"}}
Example output: -1
math_sinh
)Returns the hyperbolic sine of an angle.
{"placeholder":"math_sinh","values":{"angle":"1"}}
Example output: 1.1752011936438014
math_cosh
)Returns the hyperbolic cosine of an angle.
{"placeholder":"math_cosh","values":{"angle":"1"}}
Example output: 1.5430806348152437
math_tanh
)Returns the hyperbolic tangent of an angle.
{"placeholder":"math_tanh","values":{"angle":"1"}}
Example output: 0.7615941559557649
split_text
)Splits text using a specified delimiter.
{"placeholder":"split_text","values":{"input":"hello,world","regex":",","max_parts":"2","split_index":"1"}}
Example output: world
trim_text
)Removes leading and trailing whitespace.
{"placeholder":"trim_text","values":{"text":" hello world "}}
Example output: hello world
crop_text
)Removes characters from the start and end of text.
{"placeholder":"crop_text","values":{"text":"hello world","remove_from_start":"1","remove_from_end":"1"}}
Example output: ello worl
stringify
)Stringifies a text by escaping all syntax characters.
{"placeholder":"stringify","values":{"text":"text with {special} \"characters\""}}
Example output: text with \{special\} \"characters\"
local
)Retrieves localized text for a key.
{"placeholder":"local","values":{"key":"menu.singleplayer"}}
Example output: Singleplayer
webtext
)Retrieves text content from a web URL.
{"placeholder":"webtext","values":{"link":"http://somewebsite.com/textfile.txt"}}
Example output: Text content from the URL
randomtext
)Returns a random line from a text file, URL, or direct plain text. The text changes at specified intervals.
{"placeholder":"randomtext","values":{"source":"/config/fancymenu/assets/<file_name.txt>","interval":"10"}}
Parameters:
source
: The source of the text lines (replaces the old path
parameter)
/config/fancymenu/assets/quotes.txt
https://example.com/quotes.txt
Line 1\nLine 2\nLine 3
interval
: Time in seconds between text changesThe placeholder now supports three source types:
{"placeholder":"randomtext","values":{"source":"/config/fancymenu/assets/quotes.txt","interval":"10"}}
{"placeholder":"randomtext","values":{"source":"https://example.com/quotes.txt","interval":"10"}}
\n
{"placeholder":"randomtext","values":{"source":"First line\nSecond line\nThird line","interval":"5"}}
Note: Old placeholders using path
instead of source
will continue to work.
json
)Parses JSON data from a file, URL, or direct JSON content and extracts values using JSON path expressions.
{"placeholder":"json","values":{"source":"path_or_link_or_json_content","json_path":"$.some.json.path"}}
Parameters:
source
: The source of the JSON data
/config/fancymenu/assets/data.json
https://api.example.com/data.json
{"name":"Steve","level":42}
json_path
: The JSON path expression to extract dataThe placeholder now supports three source types:
{"placeholder":"json","values":{"source":"/config/fancymenu/assets/playerdata.json","json_path":"$.player.name"}}
{"placeholder":"json","values":{"source":"https://api.minecraft.com/server/status","json_path":"$.online"}}
{"placeholder":"json","values":{"source":"{"name":"Steve","score":42,"rank":"Diamond"}","json_path":"$.rank"}}
Example JSON paths:
$.name
- Gets the "name" field from root$.player.level
- Gets nested "level" field inside "player"$.items[0].id
- Gets the "id" of the first item in an array$.scores.*
- Gets all values from the "scores" objectabsolute_path
)Returns the absolute path of a file.
{"placeholder":"absolute_path","values":{"short_path":"relative/path/to/file.txt"}}
Example output: C:/Users/Username/AppData/Roaming/.minecraft/relative/path/to/file.txt
text_character_count
)Returns the number of characters in the given text.
{"placeholder":"text_character_count","values":{"text":"Hello World!"}}
Example output: 12
text_width
)Returns the width in pixels of the given text when rendered.
{"placeholder":"text_width","values":{"text":"Hello World!"}}
Example output: 66
uppercase_text
)Converts the input text to all uppercase letters.
{"placeholder":"uppercase_text","values":{"text":"Hello World"}}
Example output: HELLO WORLD
lowercase_text
)Converts the input text to all lowercase letters.
{"placeholder":"lowercase_text","values":{"text":"Hello World"}}
Example output: hello world
file_text
)Returns text lines from a file or URL. Can return all lines or just the last X lines.
{"placeholder":"file_text","values":{"path_or_url":"/config/fancymenu/assets/some_file.txt","mode":"all","separator":"\n","last_lines":"1"}}
Parameters:
path_or_url
: File path or URL to read frommode
: Either "all"
(returns all lines) or "last"
(returns only the last X lines)separator
: Text to join lines with (default: "\n"
)last_lines
: Number of lines to return when mode is "last"
(default: "1"
)Example output: Depends on file content
clipboard_content
)Returns the current text content stored in the system's clipboard.
{"placeholder":"clipboard_content"}
Example output: Whatever text is currently in the clipboard
replace_text
)Replaces text in a string using literal text or regular expressions.
{"placeholder":"replace_text","values":{"text":"Hello World! This is a test.","search":"World","replacement":"FancyMenu","use_regex":"false","replace_all":"true"}}
Parameters:
text
: The input text to processsearch
: The text or regex pattern to search forreplacement
: The replacement textuse_regex
: Whether to use regex ("true"
) or literal matching ("false"
)replace_all
: Replace all occurrences ("true"
) or just the first ("false"
)Example output: Hello FancyMenu! This is a test.
switch_case
)Performs a switch-case operation based on a value.
{"placeholder":"switch_case","values":{"value":"1","cases":"1:first case,2:second case,3:third case","default":"default case"}}
Example output: first case
(if value is 1)
getvariable
)Retrieves the value of a previously stored variable.
{"placeholder":"getvariable","values":{"name":"some_variable"}}
Example output: Depends on the stored value
nbt_data_get
)Retrieves NBT data from entities and blocks (similar to the /data get
command).
{"placeholder":"nbt_data_get","values":{"source_type":"entity","entity_selector":"@s","nbt_path":"foodLevel","scale":"1.0","return_type":"value"}}
Parameters:
source_type
: Either "entity"
or "block"
entity_selector
: Entity selector like @s
, @p
, @e
, or UUID/name (for entities)block_pos
: Block position in format "x y z"
(for blocks)nbt_path
: The NBT path to retrievescale
: Optional scaling factor for numeric values (default: "1.0"
)return_type
: How to return the data:
"value"
: Default, returns the value (with optional scaling for numbers)"string"
: Returns the actual NBT data as string"snbt"
: Returns as SNBT (formatted NBT)"json"
: Returns as JSON-formatted component (for compound tags)Example output: 20
(for food level)
player_team
)Returns the current team of the given player.
{"placeholder":"player_team","values":{"player_name":"Steve"}}
Example output: red_team
scoreboard_score
)Returns the score value of a player for a specific objective.
{"placeholder":"scoreboard_score","values":{"player":"Steve","objective":"kills"}}
Example output: 42
scoreboard_objectives_list
)Returns a list of all objectives in the scoreboard.
{"placeholder":"scoreboard_objectives_list","values":{"separator":", "}}
Example output: kills, deaths, points
scoreboard_tracked_players
)Returns a list of all players tracked by the scoreboard.
{"placeholder":"scoreboard_tracked_players","values":{"separator":", "}}
Example output: Steve, Alex, Notch
scoreboard_display_slot
)Returns the objective displayed in a specific slot (sidebar, list, etc.).
{"placeholder":"scoreboard_display_slot","values":{"slot":"sidebar"}}
Possible slots: sidebar
, list
, belowName
Example output: points
scoreboard_has_score
)Checks if a player has a score for a specific objective (true/false).
{"placeholder":"scoreboard_has_score","values":{"player":"Steve","objective":"kills"}}
Example output: true
scoreboard_objective_display_name
)Returns the display name of an objective (supports JSON format).
{"placeholder":"scoreboard_objective_display_name","values":{"objective":"kills","as_json":"false"}}
Example output: Player Kills
scoreboard_objective_criteria
)Returns the criteria type of an objective (dummy, trigger, etc.).
{"placeholder":"scoreboard_objective_criteria","values":{"objective":"kills"}}
Example output: playerKillCount
scoreboard_objective_render_type
)Returns how an objective is rendered (integer or hearts).
{"placeholder":"scoreboard_objective_render_type","values":{"objective":"health"}}
Example output: hearts
scoreboard_player_scores_list
)Returns a formatted list of all scores for a specific player.
{"placeholder":"scoreboard_player_scores_list","values":{"player":"Steve","format":"%objective%: %score%","separator":", "}}
Parameters:
player
: The player nameformat
: Format string using %objective%
and %score%
placeholdersseparator
: Text to join scores withExample output: kills: 42, deaths: 5, points: 100
scoreboard_objective_count
)Returns the total number of objectives in the scoreboard.
{"placeholder":"scoreboard_objective_count"}
Example output: 3
Used RAM: {"placeholder":"usedram"}MB / {"placeholder":"maxram"}MB ({"placeholder":"percentram"}%)
{"placeholder":"realtimehour"}:{"placeholder":"realtimeminute"}:{"placeholder":"realtimesecond"}
OS: {"placeholder":"osname"}
CPU: {"placeholder":"cpuinfo"}
GPU: {"placeholder":"gpuinfo"}
Java: {"placeholder":"javaver"}
Health: {"placeholder":"current_player_health"} / {"placeholder":"max_player_health"} ({"placeholder":"current_player_health_percent"}%)
Armor: {"placeholder":"current_player_armor"} / {"placeholder":"max_player_armor"}
XP Level: {"placeholder":"current_player_level"}
{"placeholder":"calc","values":{"decimal":"true","expression":"({"placeholder":"usedram"} / {"placeholder":"maxram"}) * 100"}}
X: {"placeholder":"math_round","values":{"num":"{"placeholder":"player_x_coordinate"}"}}
Y: {"placeholder":"math_round","values":{"num":"{"placeholder":"player_y_coordinate"}"}}
Z: {"placeholder":"math_round","values":{"num":"{"placeholder":"player_z_coordinate"}"}}
Cache Expensive Operations: Some placeholders (like those that read system information) can be resource-intensive. Consider using variables to store their values if you need to use them multiple times.
Use Appropriate Decimal Settings: When working with calculations, use the decimal
parameter appropriately. Set it to false
when you need integers and true
when you need precise decimal values.
Handle Missing Values: Always consider what should happen if a placeholder returns no value. You might want to provide default values in such cases.
Test Performance: When using many placeholders or complex nested structures, test the performance impact, especially on lower-end systems.
Use Advanced Sizing/Positioning: For dynamic UI elements, combine placeholders with advanced sizing and positioning to create responsive layouts.
Combine with Variables: Use placeholders together with variables for even more dynamic content that can be updated through actions.
If a placeholder's value isn't updating as expected, check:
When nesting placeholders:
If you notice performance issues: