Placeholders Replacements

Velocitab supports placeholder replacements, which allow you to replace a placeholder with a different value. This is useful for things like changing the text of a date placeholder to a localized version, changing the text of a biome placeholder to a color or you can use a vanish placeholder to show a player's vanish status if the placeholder returns just a boolean (true/false).

Configuring

Placeholder replacements are configured in the placeholder_replacements section of the every Tab Group. You can specify a list of replacements for a placeholder, and the replacements will be applied in the order they are listed.

The replacements are specified as a list of objects with two properties: placeholder and replacement. placeholder is the placeholder to replace, and replacement is the replacement text.

Example section

placeholder_replacements:
  '%current_date_weekday_en-US%':
    - placeholder: Monday
      replacement: <red>Monday</red>
    - placeholder: Tuesday
      replacement: <gold>Tuesday</gold>
    - placeholder: Else
      replacement: <green>Other day</green>
  '%player_world_type%':
    - placeholder: Overworld
      replacement: '<aqua>Overworld</aqua>'
    - placeholder: Nether
      replacement: '<red>Nether</red>'
    - placeholder: End
      replacement: '<yellow>End</yellow>'
  '%player_biome%':
    - placeholder: PLAINS
      replacement: <red>Plains</red>
    - placeholder: DESERT
      replacement: <yellow>Desert</yellow>
    - placeholder: RIVER
      replacement: <aqua>River</aqua>

Specified cases

Vanish status

If you want to show a player's vanish status, for example, you can use the %advancedvanish_is_vanished% placeholder. This placeholder returns a boolean value, so you can use it to show a player's vanish status.

For example, if you wanted to show a player's vanish status as a color, you could use the following replacements:

placeholder_replacements:
  '%advancedvanish_is_vanished%':
    - placeholder: Yes
      replacement: <red>Vanished</red>
    - placeholder: No
      replacement: <green>Not vanished</green>

Else clause

If you don't want to specify every possible value for a placeholder, you can use the ELSE placeholder. This placeholder will be replaced with the replacement text of the first replacement that doesn't have a placeholder.

For example, if you wanted to show the current date as a color, you could use the following replacements:

placeholder_replacements:
  '%current_date_weekday_en-US%':
    - placeholder: Monday
      replacement: <red>Monday</red>
    - placeholder: Tuesday
      replacement: <gold>Tuesday</gold>
    - placeholder: ELSE
      replacement: <green>Other day</green>

Placeholder not present in a server

If you have a group with multiple servers, and you have a placeholder that is not present in one of the servers, you can use the %<placeholder>% as a placeholder it will handle the case where the placeholder is not present in the server.

placeholder_replacements:
  '%huskhomes_homes_count%':
    - placeholder: '%huskhomes_homes_count%'
      replacement: <red>No homes in this server</red>

If you want you can also set the replacement as an empty string, which will be replaced with the empty string.

placeholder_replacements:
  '%huskhomes_homes_count%':
    - placeholder: '%huskhomes_homes_count%'
      replacement: ''