CustomHud v4 Changelog

v4.1 Changelog

• Section offsets now support expressions
  • Example: ==Section:TopLeft, x + 5, x + 3==
  • Don't ask why your hud's position would change on your x coords... but.
  • For real though, it's intended use are values created with get/set variables
• Added Event Variables!
  • {on_join} - Is true for the first frame after joining a world
  • {on_load} - Is true for the first frame after the profile is (re)loaded
  • List var on_chat_message / on_chat_msg
    • Contains chat message received between last frame and now.
    • Same child vars as chat_messages
• New icon variable: {crosshair:<texture_path>}
  • Acts just like {icon:<texture_path>}, but renders how the crosshair renders
• Variables related to the freezing (staying in powdered snow):
  • {is_frozen} , {is_freezing} , {frozen_per} / {frozen_percentage} , {frozen_ticks}
• Is on fire: {on_fire}
• Attack Cooldown: {attack_cooldown}
• Added child variables for items related to cooldowns:
  • {i:cooldown} , {i:max_cooldown} , {i:cooling_down} , {i:cooldown_percentage} / {i:cooldown_per}
• Facing variables:
  • Added variables that display 8 directions instead of 4: {facing8} and {facing8_short}
    • north, northeast, east, southeast, south, southwest, west, northwest
  • {facing} and {facing_short} are now alias of {facing4} and {facing4_short}
• Velocity Variables have been overhauled
  • {velocity} is now an alias of {velocity_xyz}
  • You can now have any combination of XYZ (Ex: {velocity_x} and {velocity_xy})
  • Adding _kph to the end still works (Ex: {velocity_x_kph})
  • You can now also end it with _mph for miles per hour! (Ex: {velocity_x_mph})
  • You can now set a "smoothing" value from 0-19
    • A value below 0 will act as 0, and a value above 19 will act as 19. This also supports expressions!
    • Ex: {velocity_xz[4]}. This will compare the positions between now and 5 ticks ago to calculate the velocity)
    • Before, to make it more readable, it only updated every 5th render tick. However it's been a common request for it to update every tick. In v4, -freq# / -v# was added, which limits how fast a variable updates on the hud. Despite this sounding like it would be a good substitute for the old system, it is not, as it loses the "smoothing" that updating the actual change in distance would have

• Resource / Datapack Related
  • Pack formats are now 'major.minor' instead of a single number. The following changes reflect that:
  • {rp_version} / {resource_pack_version} are now string variables. Ex: 88.0
  • {dp_version} / {datapack_version} are also now string variables
  • Added {rp_major} / {rp_major_version} / {resource_pack_major_version}
  • Added {rp_minor} / {rp_minor_version} / {resource_pack_minor_version}
  • Added {dp_major} / {dp_major_version} / {datapack_major_version}
  • Added {dp_minor} / {dp_minor_version} / {datapack_minor_version}
  • Similar change to the resource pack and datapack list variables:
    • {p:version} has been replaced with {p:min} / {p:min_version} and {p:max} / {p:max_version}
    • Added: {p:min_major} / {p:min_version_major} and {p:max_major} / {p:max_version_major}

New Config Screen

• Unlimited Profiles
• Each profile has a name, keybind to switch to it, and the ability to bind its toggles
• Ability to reorder profiles
• Decide which profiles are used when using the cycle profiles keybind
• Buttons to go to the docs and discord

New Language Features

• Added List Variable Support

  • {<list>} alone will just show how many there are
    • Example: {effects} → 3 (assuming the player has 3 status effects)
  • Separators all you to set text to be put between entries, but not at the end
  • Filters allow you to filter the entries before looping
  • Inline Syntax

    • Syntax: {<list>, "stuff here"}
    • Example: {effects, "{index} - {icon} {name}\n"}
    • With Filter: {effects, "{e:name}", e:level > 2}
    • With Separator: {effects, "{e:name}", ", "}
    • With Both: {effects, "{e:name}", ", ", e:level > 2}
  • Multiline Syntax

    • Syntax: =for:<list>= ends with =endfor=
    • With Filter: =for: effects, e:level > 2=
    • Separator: everything after the =separator= will be the separator
    • Example: {effects, "{index} - {icon} {name}\n"}
  • Each list will have a set of child variables that only work within the list
    • Available to all lists:
      • {i} / {index} , {raw} , {size}
      • {exit} (exits the list prematurely), {continue} (skips to the next iteration)
    • The e: and likewise can be changed with the -pre:<prefix> list flag.
      • Ex: {effects -pre:eff, "{eff:name}"}
• Added a lot of operators to conditionals (now called expressions)

  • Equals (= / ==) are no longer case-sensitive
  • Math Operators: + , - , * , / , % (modulus), and ^ (exponential)
    • Ex: {{x > (8+2 *2, "X is greater than 10"}}
  • Ternary Operator: condition ? valueA ; valueB
    • Ex: {setsleep_time, raining ? 12542 ; 12010}
  • Not (!) Operator
    • Ex: {{ !raining, "not raining","raining"}}
  • has Operator
    • Checks to see if a string has a string in it
      • Ex: {{item:main:name has "wool", "This has wool in the name"}}
    • Or checks to see if a list contains an entry
      • Example: {{items has "Stone", "I have Stone"}}
      • Can use child var to test for a specific value
        • <list>.<child> has <value>
        • Ex: {{all_items.count has 64, "I have at least 1 full stack"}}
  • Functions (all trig uses degrees)
    • Ex: {set:test, sin(30+60)}
    • Functions added:
      • round , ceil , floor
      • sqrt , abs
      • sin , cos , tan , csc , sec , cot
      • asin , acos , atan , acsc , asec , acot
      • log / log10 , log2 , log_e / ln , log_e1p / ln1p
  • If no value (??) Operator

    • Sometimes a variable doesn't have a usable number value. For example, {target_block_x} when not looking at a block. It can't use 0 or -1 as those are valid coordinates. So it instead gives the value of NaN (Not a Number).
    • When you do math with NaN value, the result will always be NaN
    • The ?? allows you to give a "default" value
    • Example:
      • Sharpness: {$ item:main:enchant:sharpness:lvl + 10}
      • If the item doesn't have sharpness it'll show as "Sharpness: -", but what if we wanted to treat not having the enchantment as having it at level 0
      • Sharpness: {$ (item:main:enchant:sharpness:lvl ?? 0) + 10}
  • Math symbol aliases for operators. For the lols, not really useful

    • And: ⋀ , ∧
    • Or: ⋁ , ∨
    • Sqrt: √(<expression>)
    • Has:∋ , ∍ , ∌ (list ∋ element), and ∈ , ∊ , ∉ (element ∈ list)
• Expanded Profile Section with max Width and Text Align

  • Width
    • Width can now be set to max or -2. The background for every line will be as wide as the longest line
    • The default behavior can now be written as fit or -1
  • Text Align
    • ==Section:TopLeft,0,0,false,fit,<align>==
    • left , right , center
• Ability to disable vanilla hud elements (like hotbar or effects)

  • ==Disable: <VanillaHudElements>==
  • Elements:
    • health , hunger , armor , air, (status_bars for all 4 + horse_health)
    • hotbar, item_tooltip , xp , (lower for both and everything in status_bars)
    • horse_health , horse_jump (horse for both)
    • chat , scoreboard , bossbar , subtitles , effects / status_effects
    • titles , actionbar
• Ability to set the color based on the number value of a variable

  • Putting & in-front of any variable will now use its number value for color
    • Ex: &{target_block_color}
    • Various variables have been added to take advantage of this
    • Word colors like {red} are now proper variables and can be used in expressions
    • Can use expressions, Ex: &{target_block_color * -1}
• Text Variables: These can have their own color/formatting. Like if the player's name is red, it'll show it in red

   A lot of these already existed, but were stripped of their formatting

  • {name} / {display_name}
  • {ten} / {target_entity_name}
  • {lhn} / {last_hit_name}
  • {hen} / {hooked_entity_name}
  • {ven} / {vehicle_name} / {vehicle_entity_name}
  • {vha} / {horse_armor} / {vehicle_horse_armor}
  • {team} , {team_name}
  • {record_name}
  • {title} / {title_msg}
  • {subtitle} / {subtitle_msg}
  • {actionbar} / {actionbar_msg}
  • All the list's child var marked as such

  
  
• Identifier variables allows easier comparison and colorization of ids

  • When compared, if the id has minecraft as the namespace and you leave out the namespace, it'll still return true
    • Example: {{target_block_id = "stone", "Is Stone", "Not Stone"}} now works
  • There are two new variable flag for Identifier variables: -ns / -namespace and -path
    • Example: &8{target_block_id -ns}:&2{target_block_id -path} looks like minecraft:stone

  
   A lot of these already existed, but now work like above

  • {tei} / {target_entity_id}
  • {lhi} / {last_hit_id}
  • {hei} / {hooked_entity_id}
  • {vei} / {vehicle_id} / {vehicle_entity_id}
  • {dimension_id} , {biome_id}
  • {music_id} , {record_id}
  • All the list's child var marked as such

New Colors and Formatting

• Added Bedrock color code/names

  • #DDD605 → &g , &{minecoin_gold} , &{minecoin}
  • #E3D4D1 → &h , &{material_quartz} , &{quartz}
  • #CECACA → &i , &{material_iron} , &{iron}
  • #443A3B → &j , &{material_netherite} , &{netherite}
  • #971607 → &zm , &{material_redstone} , &{redstone}
  • #B4684D → &zn , &{material_copper} , &{copper}
  • #DEB12D → &p , &{material_gold} , &{mgold}
  • #47A036 → &q , &{material_emerald} , &{emerald}
  • #2CBAA8 → &s , &{material_diamond} , &{diamond}
  • #21497B → &t , &{material_lapis} , &{lapis}
  • #9A5CC6 → &u , &{material_amethyst} , &{amethyst}
• Word versions of formatting now exists
  • &{bold} , &{italics} , &{underline} , &{obfuscated}
  • &{strike} / &{strikethrough} , &{reset}

New Variable Flags

• -r<degrees> / -rotate<degrees>: Rotates Icons
  • Ex: {item:main:icon -r45} will rotate the icon 45 degrees
• -zf# / -zerofill#: Pad the left with zeros when needed
  • Ex: {x -zf3} (5 would be 005)
• -v# / -freq# / -frequency#
  • Sets how often the variable updates in seconds. Doesn't work on lists
  • Ex: -v2 , -v0.5 , -v1/20
• For Identifier Variables
  • -ns / -namespace: Only shows the namespace
  • -path: Only shows the path
• -sub / -subscript: Numbers are replaced with their subscript counterpart
• -sup / -superscript: Numbers are replaced with their subscript counterpart
• Flags that changes the number's base

  • -hex: Numbers are shown in hexadecimal
  • -oct: Numbers are shown in octal
  • -bin: Numbers are shown in binary
  • -base#: Numbers are show in the base specified, up to 36
    • Ex: {x -base7}
• -rn / -roman: Displays the number in Roman Numerals
   

New Theming

Reminder that the local variant has 1 less = on both sides

• ==NiceScale: <(+/-) GUI Scale>==
  • Sets the scale of the CustomHud hud to as if it was a specific gui scale.
    This avoids weirdness that can happen when using ==Scale: <scale>==
  • ==NiceScale: 2== will render as if the GUI Scale in Minecraft's settings was set to 2.
  • ==NiceScale: +1== with your GUI Scale set to 3, the profile will render as if it was set to 4.
• ==HudScale: <(+/-) GUI Scale>==
  • Same as NiceScale, but for minecraft's vanilla hud (hotbar, scoreboard, bossbar, etc)

• ==Padding: <top>, <bottom>, <left>, <right>==
  • Default: 2,1,2,2
  • Can also be written as ==Padding: <verticle>, <horizontal>== or ==Padding: <all>==
  • Sets how much padding is around the text. 0 all around will be just big enough to fit the text and its shadow
• ==PersistentFormatting: <true|false>==
  • Default: false
  • If true, color codes (like &a or &{green}) won't reset formatting (like bold)
• ==ItemIconSize: <line|full>==
  • Default: line
  • If line, item icons will be scaled to fit the line (like all other icons). If full, it'll render at full size
• ==LeftChart: <chart>== and ==RightChart: <chart>==
  • Default: None
  • Charts: Profiler, Fps, Tick, Ping, PacketSize, None
• ==WhenHudHidden: <Show|ShowIfScreen|Hide>== (global only)
  • Default: ShowIfScreen
  • Determines if the profile should show ehn the hud is hidden via F1
  • You can use {hud_hidden} in a conditional to limit what info is shown when the hud is hidden

• ==IgnoreBlankLines: <true|false>==
  • Default: false
  • Blank lines in the profile file are ignored. If true and you want to add blank lines, use \n
• ==IgnoreLeadingSpace: <true|false>==
  • Default: false
  • Removes leading spaces on lines. This is useful for nested if/fors
• ==ConvertLineBreaks: <true|false>==

  • If true it treats line breaks in the profile file as NewLines in the hud
  • If false, only \n in the profiles will add NewLines to the hud
  • This means that you can also change theming part way through a line.
  • Quirks when using =BackgroundColor:<color>= part way through a line
    • If the section's width is set to fit (default), it won't apply until after the next NewLine
    • If the section's width is set to max or a specific amount, it'll apply to the entire line
  • In a future release, there will be a local version of this
• Default: true (same behavior as before)

New List Variables

List variables will be shown without the {} around them, as they are intended to be used in the syntax laid out in Language Features

The e: and likewise can be changed with the -pre:<prefix> list flag.
Example: {effects -pre:eff, "{eff:icon}"}

You can reverse the list using the -r / -reverse list flag.
Example: {effects -r, "{eff:icon}"}

New Variables

• {is_pressed:<keybind>} Ex: {is_pressed:forward}
• {toggle:<name>} Ex: {toggle:test}
  • Set the keybind for the toggle in the new config screen.
• {toggle:<name>:last_pressed} Milliseconds since it was last pressed
• {gliding} Flying using an elytra
• {perspective} F5 Camera perspective (first, front, back)
• {hud_hidden} If the hud is hidden via F1
• {slime_chunk:<seed>}
  • You should still use {slime_chunk} in singleplayer
• {difficulty} - Peaceful/easy/normal/hard
• {player_head} - The player's face
• Selected hotbar slot: {hotbar_slot} (1-9) and {hotbar_index} (0-8)
• Shows the amount of a specific item you have as a icon: {itemcount_icon:<item_id>}
• {score} The total amount of xp points you have gained since last death (what you see when you die)
• Target Block and Target Fluid:
  • {target_block_color} / {target_color} / {tbc} (Map Color)
  • {target_fluid_color} / {tfc}
  • {target_block_icon} / {target_icon} / {tbicon}
  • {target_fluid_icon} / {tficon}
  • {target_block_luminance} / {target_luminance} / {tbl}
• Information about the entity you last hit

  • {last_hit} / {lh} (Pig, Player)
  • {last_hit_id} / {lhi} (minecraft:pig, minecraft:player)
  • {last_hit_name} / {lhn} (Pig, Notch)
  • {last_hit_uuid} / {lhu} (b354c639-b534-48fa-b4c3-48192dba8dd3)
  • {last_hit_distance} / {lhd} (Distance between you and the entity at the time you hit)
  • {last_hit_ago} / {lha} Seconds since last hit
• Information about the entity you are riding

  • {ve} / {vehicle} (Pig, Player)
  • {vei} / {vehicle_id} (minecraft:pig, minecraft:player)
  • {ven} / {vehicle_name} (Pig, Notch, (Pig with a nametag 'Pet') Pet)
  • {veu} / {vehicle_uuid} (b354c639-b534-48fa-b4c3-48192dba8dd3)
  • {veh} / {vehicle_health} , {vea} / {vehicle_armor} , {vemh} / {vehicle_max_health}
  • {vhj} / {horse_jump} , {vha} / {horse_armor} (name of the armor)
• Information about the villager you are looking at

  • {tvb} / {target_villager_biome}
  • {tvlw} / {target_villager_level_word} , {tvl} / {target_villager_level}
  • {tve} / {target_villager_xp} , {tven} / {target_villager_xp_needed}
  • {tveb} / {target_villager_xp_bar}
  • Don't forget about the List Var target_villager_offers , tvo !
• How much redstone power a block is receiving

  • Total:{target_block_power}, {target_power}, {tbp}
  • Total Strong:{target_block_strong_power}, {target_strong_power}, {tbsp}
  • {target_block_power_north}, {target_power_north}, {tbpn}
  • {target_block_power_south}, {target_power_south}, {tbps}
  • {target_block_power_east}, {target_power_east}, {tbpe}
  • {target_block_power_west}, {target_power_west}, {tbpw}
  • {target_block_power_up}, {target_power_up}, {tbpu}
  • {target_block_power_down}, {target_power_down}, {tbpd}
  • {target_block_strong_power_north}, {target_strong_power_north}, {tbspn}
  • {target_block_strong_power_south}, {target_strong_power_south}, {tbsps}
  • {target_block_strong_power_east}, {target_strong_power_east}, {tbspe}
  • {target_block_strong_power_west}, {target_strong_power_west}, {tbspw}
  • {target_block_strong_power_up}, {target_strong_power_up}, {tbspu}
  • {target_block_strong_power_down}, {target_strong_power_down}, {tbspd}
• Added Hooked Entity yaw/pitch
  • {hedy} / {hooked_entity_direction_yaw}
  • {hedp} / {hooked_entity_direction_pitch}
• Added {unix_time} (milliseconds since epoch)
• Added plural variants to time variables
  • People, including myself, kept adding an s to the end, so why not allow it
  • {seconds} , {minutes} , {hours} , {hours12} , {hours24}
• Added individual real time variables, mainly useful for expressions

  • {real_time:<format>} is still recommend for showing time on the hud
  • {real_year} , {real_month} , {real_day}
  • {real_day_of_week} / {real_dow} , {real_day_of_year} / {real_doy}
  • {real_hour} / {real_hour12} , {real_hour24}
  • {real_minute} , {real_second} , {real_ms}
  • {real_am} , {real_pm}
• Added Profile Variables
  • {profile_name} , {profile_errors} , {profile_keybind} , {profile_in_cycle}
• Added World-Related Variables
  • {world_height} , {min_y} / {world_min_y} , {max_y} / {world_max_y}
  • {coord_scale} / {world_coord_scale}
• Title and Actionbar Variables
  • {title_msg} / {title} , {subtitle_msg} / {subtitle} (not to be confused with audio subtitles)
  • {actionbar_msg} / {actionbar}
  • {title_remaining} , {actionbar_remaining}
• Player's Current Team
  • {pteam:<method>} / {player_team:<method>}
  • Existing {team} (no method) now alias of {pteam} (no method) and {player_team} (no method)
  • Methods:

    • name , id
    • color (see new color feature)
    • friendly_fire , friendly_invis , collision
    • name_tag_visibility / name_tag , death_msg_visibility / death_msg
    • List Var members with child {m:member} (members include offline players)
    • List Var online_players / players (See players child vars)
• More methods for {item:<slot>:<method>}

  • armor_slot (which armor slot the item can go in)
  • inv_count , inv_count_icon
  • unbreakable , repair_cost
  • List attributes / attrs (See Item Attribute Modifiers child vars)
  • List can_destroy and can_place_on
    • Children {c:name} , {c:id} , {c:icon}
  • List tags with children {t:name} and {t:id}
  • List Var items (items stored in stuff like Shulker Boxes). Same child vars as items.
  • List Var items_compact (items stored in stuff like Shulker Boxes, compacted). Same child vars as items.
  • enchant:<id>:<method>
    • Ex: item:main:enchant:sharpness:full
      • Methods:
        • name , id
        • level / lvl (like IV)
        • max_level / max_lvl (max level the enchantment can be)
        • full (like Sharpness IV)
        • num / number (0 indexed)
        • max_num , max_number (0 indexed)
        • rarity
  • 1.20.4 Only:
    • hide_flags
    • List info_shown and info_hidden with child {ii:info}
• Get a block's property: {target_block_property:<property>:<method>} / {tbprop:<property>:<method>}

  • Methods:
    • {p:name} , {p:value} , {p:type} , {p:full_type}
• Attribute Variables
  • Yours: {attribute:<attr>:<method>}
  • Target Entity:

    • {target_entity_attribute:<attr>:<method>}
    • {target_entity_attr:<attr>:<method>}
    • {tea:<attr>:<method>}
  • Hooked Entity:

    • {hooked_entity_attribute:<attr>:<method>}
    • {hooked_entity_attr:<attr>:<method>}
    • {hea:<attr>:<method>}
  • Methods:

    • name , id
    • value , base_value , default_value
    • tracked (if the server sends it to the client)
    • modifiers (a list variable, see the attribute modifiers)
• Player Info {player:<player>:<method>}

  • Methods:
    • name / display_name , username
    • id / uuid
    • latency , list_score
    • gamemode , survival , creative , adventure , spectator
    • head (icon)
    • team , team:<team method>} (see Team Info{team::<team>:<method>})
    • name , id
    • color (see new color feature)
    • friendly_fire , see_friendly_invis , collision
    • name_tag_visibility / name_tag , death_msg_visibility / death_msg
    • List members with child {member} (members include offline players)
    • List online_players / players (See players child vars)
• Team Info {team:<team>:<method>}

  • Methods:
    • name , id
    • color (see new color feature)
    • friendly_fire , see_friendly_invis , collision
    • name_tag_visibility / name_tag , death_msg_visibility / death_msg
    • List members with child {member} (members include offline players)
    • List online_players / players (See players child vars)
• Scoreboard Objective Info {objective:<objective_id>:<method>}:

  • Methods
    • name , id
    • criteria / criterion (Singleplayer only)
    • display_slot
    • List scores (See child variable section above)
    • List online_scores (See child variable section above)
• Scoreboard Score {score:<player>:<objective_id>}
  • Gets the score the player has for that objective
• Bossbar Info {bossbar:<name|uuid|id>:<method>}

  • id singleplayer only, and only ones made by commands
  • Methods:
    • name , uuid
    • id (Singpleplayer only),
    • percent / per / value
    • darken_sky , dragon_music , thickens_fog
    • style , color , text_color
    • enabled / visible (Singleplayer only)
    • icon
    • List players (See players child vars)
      • A list of players that can see the bossbar, Singleplayer only
• Have Mod {mod_loaded:<modid>}
• Mod Info {mod:<modid>:<method>}

  • Methods:
    • name , id , version , hash
    • summary , desc / description
    • icon
    • If the mod is a library mod, client mod, etc
      • library, client, deprecated, patchwork, from_modpack, minecraft
    • List authors with child var {ma:author}
    • List contributors with child var {mc:contributor}
    • List credits with child var {mc:credit}
    • List licenses with child var {ml:license}
    • List children. See mods child vars
    • List parent. See mods child vars
    • List badges. See m:badges child vars
    • parent:<method> Same methods as this
• Resource Pack / Datapack Variables
  • {resource_pack:<id>:<method>}
  • {data_pack:<id>:<method>} / {datapack:<id>:<method>}
  • Methods:

    • name , id , version
    • desc / description
    • compatible , always_enabled , pinned
    • icon
  • RP Version: {rp_version} / {resource_pack_version}
  • DP Version: {dp_version} / {data_pack_version} / {datapack_version}
• Progress Bar {bar:<style>, <value>, <max_value>}

  • {bar, <value>, <max_value>}
  • {bar:<style>, <value>, <max_value>}
  • {bar, <value>, <max_value>, <flags>}
  • Replace bar with nb_bar to remove the bar's background. Great for stacking
  • Styles:

    • xp / experience , jump / horse
    • villager / villager_green , villager_white
    • pink , red , blue , green , yellow , purple , white
    • 6 , 10 , 12 , 20 (notches)
    • pink6 , red12, etc
  • Example:
    • {bar:red20, y + 64, 384}
• Timer Variable {timer[<end>, <interval>]}

  • {timer[<end>, <interval>]}
  • {timer[<end>]} (interval = 1)
  • Interval is in seconds
  • end and interval allows expressions
  • Example:
    • {timer[100, 1/health]}
    • Counts to 100. counts faster if you have less health
• {$<expression>} allows you to display the results of calculations on the hud
  • <expression> is the same type as used in conditionals
  • To change the precision: {$<precision>,<expression>}
  • Examples:
    • {$ bx * 10} ⮕ 50 (if player's x coord is 5)
    • {$2, bx * 10} ⮕ 50.00 (if player's x coord is 5)
• Get/Set Values
  • {set:<names>, <expression>}
    • <expression> is the same type as used in conditionals and {$<expression>}
    • Runs the expression on set
  • {set:<name>, "stuff here"}
    • "stuff here" the same as {{<condition>, "stuff here if true"}}
    • Example: {set:item_name, "{item:main:name}"}
  • {get:<name>}
• Macros
  • {setmacro:<name>, <expression>}
    • <expression> is the same type as used in conditionals and {$<expression>}
    • Runs the expression on get, not set
  • {setmacro:<name>, "stuff here"}
    • "stuff here" the same as {{<condition>, "stuff here if true"}}
    • Example: {setmacro:coords, "&c{x} &a{y} &b{z}"}
  • {getmacro:<name>}
• {window_focused} : If the minecraft window is focused or in the background
• {refresh_profiler_timings} (also available as a keybind)
  • Refreshes timings from the profiler. Don't run often, or it'll flicker
• Profiler Timing (a specific one) {profiler_timing:<path>:<method>}

  • Methods:
    • name , path , color
    • per_of_parent / percent_of_parent
    • per_of_total / percent_of_total
    • List entries (sub-entries). See profiler_timings for child vars
    • parent:<method> Same methods as this
• F3 Parity:
  • Client/Server Chunk Variables

    • {ccw1} / {client_chunks_w1} / {client_chunks_cached}
    • {ccw2} / {client_chunks_w2} / {client_chunks_loaded}
    • {cce1} / {client_chunks_e1} / {client_entities_loaded}
    • {cce2} / {client_chunks_e2} / {client_entities_cached_sections}
    • {cce3} / {client_chunks_e3} / {client_entities_ticking_chunks}
    • {scw1} / {server_chunks_w1} / {server_chunks_loaded}
    • {sce1} / {server_chunks_e1} / {server_entities_registered}
    • {sce2} / {server_chunks_e2} / {server_entities_loaded}
    • {sce3} / {server_chunks_e3} / {server_entities_cached_sections}
    • {sce4} / {server_chunks_e4} / {server_entities_managed}
    • {sce5} / {server_chunks_e5} / {server_entities_tracked}
    • {sce6} / {server_chunks_e6} / {server_entities_loading}
    • {sce7} / {server_chunks_e7} / {server_entities_unloading}
  • Tick related stuff

    • Minecraft added the ability to change and freeze the tick rate in a recent version
    • {ms_per_tick} , {max_tps}
    • {is_tick_sprinting} / {tick_sprinting} (Singleplayer only for some reason)
    • {is_tick_frozen} / {tick_frozen}
    • {is_tick_stepping} / {tick_stepping}
  • {gpu_vendor} , {gl_version} , {gpu_driver}
  • {memory_allocation_rate}
  • Fabric's {active_renderer}
• Math constants:
  • {e} , {pi} / {π} , {tau} / {τ} , {phi} / {φ} / {golden_ratio}

Variable Changes

• {itemcount:<item_id>} now works with item tags (like #stone) number variable flags
• {tps} and {ms_ticks} / {ticks_ms} are now estimated when on servers!!!
• {ms_ticks} no longer bottoms out at 50ms in singleplayer
• Improvements to {space:#}
  • You can use the expression {space:x + 5}
  • You can now get the same with has elements would, like
    • {space:"Name: {name}"}
• Old record variables now show data for the closest playing record instead of the newest
  • {record_name} , {record_id}, etc
• {gpu} now shows the same way as it does in F3
  • This is less desirable for NVIDIA gpus, but it was broken for AMD's
• Texture Icons
  • {icon:<path>} / {icon:<path> <flags>}
    • Path can now end in .png. You don't need it, but it'll work now
  • Changes to icons with u,v,w,h
    • No longer broken (and now will have proper docs because of this)
    • Old: {icon:<path>,<u>,<v>,<w>,<h> <flags>}
    • New: {icon:<path> <flags>, <u>, <v>, <w>, <h>, <width>, <height>}
    • New: {icon:<path> <flags>, <u>, <v>, <w>, <h>, <height>}
      • All parts are optional
      • Examples:
        • {icon:<path>, 0, 0} (w,h,width,height are default)
        • {icon:<path>, 0, 0, 16, 16, 20} (width is default)
    • Parts:
      • width: how wide the icon renders
      • height: how tall the icon renders
      • 

Other Changes

• Profiles will reload on resource reload
• If the error screen is opened via the keybind, there's now a button that go to profiles (new config screen)
• Better error resiliency. If an unexpected exception is thrown while reading profiles, it is now caught and properly put into the errors screen
• CustomHud now have their own profiler entries

New Registry System

• Breaks old addon mods (the non-existent ones)
• CustomHudRegistry.registerElement("name", (flags, context) -> <ELEMENT>)
  • Pass flags into elements that take flags, and wrap string variables in Flags.wrap(<ELEMENT>, flags)
  • context.enabled now has .set("name") and .set("name", value)
• CustomHudRegistry.registerParser("id", (str, context) -> <ELEMENT>)
• CustomHudRegistry.registerList("name", "default prefix", () -> <LIST>, <ATTRIBUTER>)
• CustomHudRegistry.registerList("name", "default prefix", () -> <LIST>, <ATTRIBUTER>, <ENABLED>)
• Also unregister() and has() for all 3 kinds of registries
• CustomHudRegistry.registerComplexData(function) now takes a Consumer<Enabled> instead of a Runnable
  • If you did context.enable.set("name") when registering the element, do enabled.get("name") here

Fixes

• If lines only contains conditionals (and now set/setmacro) that produces nothing, the lines are properly skipped again
• Built-in-fonts now work again (also fixes enchanting table text)
• No longer crashes when default font is replaced with a tff font
• Removed sodium/iris variables so the mod no longer breaks when they make breaking changes
  • These will return as addon mods
• Fixes to icons and rich item icons
• No longer crashes when using BooleanSupplierElement before minecraft's options are loaded
• Fixed text positioning when line spacing is 0
• { var_name} (whitespace before the name) now works
• Fixed sections' x-offset being doubly applied
• Numbers larger than 2147483647 without precision (aka whole numbers) now show correctly