Skip to content

HUD and placeholders

The climate HUD

/hvac hud [on|off]

Keeps the climate where you stand on screen: the temperature, how warm it feels, a cold-to-hot gauge with a comfort word (cold, cool, comfortable, warm, hot), the humidity, the air quality and pollen, the outdoor temperature and weather, the season, and the system conditioning that spot with its mode, its target and its airflow strength: Strength 100% in green in a vent's core, less towards the edge of its reach (gold under 50%), and Outside where no system reaches.

  • It's off by default for each player, and EZvac remembers each player's choice across restarts. With no argument the command toggles it.
  • A server can show it to players who never chose (BETA 1.0 Pilot 10): hud.show-to-new-players, which the setup asks about along with the style. A player's own /hvac hud on or off always wins. The setup can also rename the title, as Climate - Your Server (hud.sidebar.title).
  • It needs ezvac.hud, which everyone has by default.

Styles

hud.style in config.yml picks how it's shown:

  • Sidebar (default): a scoreboard sidebar with the score numbers hidden, in three sections since BETA 1.0: Here (the temperature and feels-like, the comfort gauge, humidity and air), Outside (the temperature and weather, wind, and the season with the time of day: Summer, day 3 · 14:30) and System (what the system is doing, and the airflow). Each section has an accent heading with a rule under it.
  • The gauge (BETA 1.0) runs from cold to hot in the comfort colours, blue through green to red, with a white ◆ where it feels. hud.bar.style: blocks brings back the ▮▯ bar from before.
  • The system's line starts with what it's doing: ♨ heating, ❄ cooling, ● holding, ⚠ waiting on units switched off server-wide, ○ outside any system.
  • Action bar: one line above the hotbar.
  • Boss bar: a bar whose fill and colour follow the temperature.

EZvac never takes over a sidebar the server already uses. It only shows its sidebar while the player is on the server's main scoreboard and nothing else is shown there, steps back if another plugin takes over, and uses the action bar instead when a scoreboard plugin such as TAB is installed (hud.sidebar.yield-to-plugins).

In water

Swimming switches the HUD to water readings: Water, Air, Pool and Circulation lines, a 60-104 °F bar, and a pool comfort scale where 78-86 °F is comfortable and above 95 °F is a hot tub. It reads at your eyes when you're under water and at your feet otherwise, so swimming at the surface and wading both count.

In air it reads at head height, falling back to your feet.

Placeholders

With PlaceholderAPI installed (optional), the same values are available to scoreboard, TAB and chat plugins:

Placeholder Example
%ezvac_temp% (_temp_f, _temp_c) 72.4°F
%ezvac_feels_like% (_feels_like_f, _feels_like_c) 74.1°F
%ezvac_humidity% 48%
%ezvac_aqi%, %ezvac_aqi_colored% 42: the Air Quality Index (3.2), plain or in its band's colour
%ezvac_aqi_band% Good (Moderate, Sensitive, Unhealthy, Very bad, Hazardous)
%ezvac_pm25%, %ezvac_pm10% 6.4, 18: particles in µg/m³
%ezvac_pollen%, %ezvac_pollen_count% High, 95: the pollen level (Low, Med, High, V.High; before BETA 1.0 Moderate and Very high, shortened to keep sidebars narrow), and grains/m³
%ezvac_wind% Windy 22 km/h W, or Calm (3.2; the direction since BETA 1.0 Pilot 3)
%ezvac_wind_level%, %ezvac_wind_speed% Windy, 22 km/h: the level, and the speed in the server's units
%ezvac_wind_ms%, %ezvac_wind_kmh%, %ezvac_wind_mph% 6, 22, 14: the speed as a whole number
%ezvac_wind_direction%, %ezvac_wind_degrees% W, 270: where it blows from, as a compass point and in degrees (0 north); none when calm (BETA 1.0 Pilot 3)
%ezvac_weather% Rain (Clear, Thunder, Snow): as players see it, so by Minecraft's biomes, and by EZvac's air where an addon such as EZclimates shows EZvac's rain and snow; empty in dry biomes where no rain reaches
%ezvac_season% Summer (Spring, Autumn, Winter; empty where there are no seasons)
%ezvac_season_day% 3, the day of that season
%ezvac_time% 14:30, Minecraft's time of day on a 24-hour clock (sunrise is 06:00); none in the Nether and the End (BETA 1.0 Pilot 3)
%ezvac_outdoor% (_outdoor_f, _outdoor_c) 88.0°F
%ezvac_bar% / %ezvac_bar_plain% ━━━━━◆━━━━ (coloured / plain; ▮▮▮▮▮▯▯▯▯▯ with bar.style: blocks)
%ezvac_comfort% Comfortable
%ezvac_system%, %ezvac_thermostat% Home, Home: the thermostat whose air you're in (%ezvac_group%, its pre-3.0 name, still works). A system that lost its thermostat shows Headless
%ezvac_mode%, %ezvac_target% Cooling to 70.0°F (Holding 70.0°F when idle, BETA 1.0; Idle before), 70.0°F
%ezvac_zone%, %ezvac_influence%, %ezvac_conditioned% Strength 100%, 100, true
%ezvac_medium% air or water

Values are refreshed for each player every half second (hud.update-ticks), and placeholder requests only read that snapshot, so a scoreboard that refreshes often costs nothing extra. Without PlaceholderAPI, EZvac logs one line saying what installing it would add.

There are deliberately no placeholders for individual sensors: a sensor's reading stays on its hub.

Customising

Temperatures follow the server-wide units setting (°F or °C); see Configuration. Text, colours, the bar's length and range, and comfort bands are all under hud: (and hud.water: for water) in config.yml. HUD lines can use MiniMessage formatting and these tokens:

{temp} {feels} {humidity} {aqi} {aqi_band} {pollen} {wind} {wind_level} {bar} {comfort} {outdoor} {weather} {season} {season_day} {time} {wind_direction} {wind_degrees} {system} {thermostat} {mode} {system_mode} {mode_icon} {target} {zone} {version}

{time} is the time of day, 14:30 (BETA 1.0 Pilot 3). The stock sidebar shows it at the end of the season line; with seasons off, that line shows the time alone. A sidebar still on the stock BETA 1.0 lines gains it when you upgrade.

{aqi} is the Air Quality Index in its band's colour (3.2). The air values read none where the air isn't measured: in water, or with air-quality switched off. A sidebar that still has the stock lines gains the air line when you upgrade to 3.2.

{wind} is the wind you feel, Calm or Windy 22 km/h W, and {wind_level} just the word (3.2). {wind_direction} and {wind_degrees} give where it blows from (BETA 1.0 Pilot 3). They read none in water, in the Nether and the End, and with wind switched off. A stock sidebar gains a wind line too.

{system} is the label of the thermostat whose air you're in, or Headless; {group}, its name before 3.0, still works in existing configs. {system_mode} (BETA 1.0) puts the system and what it's doing on one line, Home: Holding 72.0°F, and reads just none outside any system. {mode_icon} (BETA 1.0) is what it's doing as a coloured icon: ♨, ❄, ●, ⚠ or ○.

When you upgrade to BETA 1.0, a sidebar that still has the stock lines of any release since 1.8, in air or in water, moves to the sections, with their accent headings. A sidebar you changed is left as it is.

Addon sections

Addons such as LiveExposure can add their own lines to the HUD. - On the sidebar: a line that is just {addons} shows every addon's section there. A line that is just {section:<id>} shows one section on its own, such as {section:liveexposure:body}. - On the action bar and boss bar: a section shows only where you put {section:<id>} into the format, since those have one line. - Hiding one: list its id under hud.sections.hidden. /hvac hud sections (admins) lists the sections installed addons have added. - Upgrading: when the update adds hud.sections to your config.yml, a sidebar that still has the stock lines gains {addons} under the season line (and under the Air: line in water). A sidebar you changed is left as it is, so add the line yourself there. - The limit: the sidebar shows at most 15 lines. Your own lines always fit; an addon section that would go past 15 is left out whole, so the first sections registered win.

A sidebar line with {season} or {season_day} is left out where there are no seasons, such as in the Nether or with seasons.enabled: false. The season line is new in ALPHA 2.1. When the update adds the seasons to your config.yml, a sidebar that still has the stock lines gains it too; a sidebar you changed is left as it is, so add the line yourself there.

{version} is the short EZvac version, such as A2.1. See Configuration.