Skip to content

Commands and permissions

Every command starts with /hvac; /climate works too. Commands that act on a block use the block you're looking at, within six blocks.

/hvac help lists the commands you can use. Admins also get two pages, each one chat screen: /hvac help build (creating, linking and changing devices) and /hvac help server (quick settings, statistics, seasons, wind and updates). Tab completion only offers commands you can run (BETA 1.0).

Permissions

Permission Default Allows
ezvac.use everyone help, readings, /hvac list and info, /hvac forecast, and using signs: thermostat targets and on/off, settings panels, dehumidifiers, humidifiers and air purifiers, sensor hubs, weather stations' forecasts, pressing sensors
ezvac.hud everyone /hvac hud
ezvac.admin operators creating, changing, linking and removing devices, changing the season and the wind, stats, sync, update and quicksettings

For everyone (ezvac.use)

Command Does
/hvac help Lists the commands you can use. Admins: /hvac help build and /hvac help server
/hvac temperature (temp) The temperature where you stand, the outdoor temperature and weather, the humidity and "feels like" in air, and which system reaches you, how far along its airflow and its strength there (100% in the core). In water: the water temperature and the air above
/hvac hud [on\|off] Shows or hides the on-screen HUD for yourself (ezvac.hud). With no argument it toggles; your choice is remembered
/hvac list The systems in your world, with mode, room and target temperature, and how many units are running
/hvac season The season and its day ("Summer, day 3 of 30"), and how much it warms or cools the outdoors where you stand
/hvac wind Today's wind around you ("Windy, about 22 km/h from the W"), the wind where you stand and out in the open, and the next two days' (3.2; your own region's, with directions, since BETA 1.0 Pilot 3)
/hvac forecast The next seven days from the weather stations within 400 blocks, nearest first (BETA 1.0, see Weather stations). Also weatherfc
/hvac info Details of the device you're looking at: a thermostat (with its room's humidity, feels-like and air), equipment, a vent, a thermometer, an RPM monitor, a settings panel, a dehumidifier, humidifier or air purifier, a sensor or a sensor hub

Using signs and sensors

  • Thermostat: right-click opens its control menu to change the target; sneak-right-click switches its system off or on.
  • Settings panel: right-click steps Normal → Turbo → Eco → Normal; sneak-right-click goes the other way.
  • Dehumidifier / humidifier: right-click opens its control menu (setpoint +5% / -5%, and on/off); sneak-right-click switches it on or off.
  • Air purifier: right-click opens its control menu (Low, Medium, High or Auto, and on/off); sneak-right-click switches it on or off.
  • Sensor hub: right-click turns the page; sneak-right-click switches auto-flip on or off.
  • Sensor: right-click shows its reading in chat.

Building (ezvac.admin)

Creating, linking, changing and removing devices. /hvac help build lists these in game.

/hvac tutorial takes you to a guided first build in a world of its own, a hut on a floating platform, and /hvac tutorial leave brings you back where you were with your things (BETA 1.0 Pilot 10). The world is deleted 10 seconds after its last player leaves. See The tutorial.

Creating devices

Command Look at Notes
/hvac create thermostat <label> [target] a sign, or a button on a wall Target 60-85 °F, default 72. Labels may repeat. At a wall button it makes a mini thermostat (BETA 1.0 Pilot 2)
/hvac create poolthermostat <label> [target] a sign Also pool. Starts in the pool range: 75-104 °F, default 82
/hvac create heatpump [t1\|t2\|t3] a dispenser Cools and heats
/hvac create ac [t1\|t2\|t3] a dispenser Cools
/hvac create furnace [t1\|t2\|t3] a dispenser Heats, at full power
/hvac create boiler [t1\|t2\|t3] a dispenser Heats a pool, at full power
/hvac create poolheatpump [t1\|t2\|t3] a dispenser Also poolhp. Heats and cools a pool
/hvac create thermometer [label] a sign
/hvac create hygrometer [label] a sign
/hvac create thermohygrometer [label] a sign Also thermohygro
/hvac create airmonitor [label] a sign Shows the AQI and pollen where it stands (3.2)
/hvac create rpmmonitor [label] a sign Shows its system's equipment once linked
/hvac create settingspanel [label] a sign One per system, once linked
/hvac create dehumidifier [label] its sign Also dehum. A sign on an iron block that sits on a waxed copper grate
/hvac create humidifier [label] its sign Also hum. A sign on the side of an iron block under a waxed cut copper slab
/hvac create purifier [label] its sign Also airpurifier. A sign on an iron block that sits on a tube coral block, its filter (3.2). The coral can be placed afterwards (3.2 HOTFIX 1)
/hvac create sensor [label] a button Stone, polished blackstone, mangrove, birch, cherry (air quality) or bamboo (wind, 3.2)
/hvac create sensor-hub [label] a sign Also sensorhub
/hvac create weatherstation [label] the wall sign on its tower Also station. The tower must be whole: see Weather stations (BETA 1.0)

An equipment tier (t1, t2 or t3) is optional: two-stage unless given. Equipment, settings panels and RPM monitors are linked to a thermostat with the link tool, below. Holding the tool with a thermostat selected while you create one links it straight away. Labels are 1-32 letters, numbers, _ or -. A typed temperature is in the server's units; add F or C (72F, 22C) to use the other one. The pre-3.0 forms with a group name still work: the group is ignored, with a note. Build guides: Equipment, Dehumidifiers and humidifiers, Air quality, Sensors.

/hvac link-tool gives the link tool, a glinting stick. /hvac duct-tool, /hvac sensor-tool and /hvac tool give it too, and the duct and sensor tools from before 3.0 work as link tools.

Click Does
Right-click a thermostat Selects it
Right-click a dispenser, a vent block, a settings panel or an RPM monitor Links it to the selected thermostat. Something in a headless system brings the whole system along; something that belongs to another thermostat is refused
Right-click a sensor hub, then sensors Links the sensors to the hub: at most nine, in the same world
Sneak-right-click a device Unlinks it: a unit gets a headless system of its own, a vent is unregistered, a sign shows "Not linked"
Sneak-right-click a thermostat Unlinks the thermostat; its system carries on headless

A system is all air or all water, and the vents must match its equipment. See Equipment and Vents and airflow.

Thermostats and equipment

These act on the device you're looking at: labels may repeat, so a thermostat isn't found by name.

Command Does
/hvac thermostat set <temperature> Sets the target, kept within the allowed range
/hvac thermostat enable / disable Switches the system on or off
/hvac thermostat info Room and target temperature, mode, what's linked, and whether it's on
/hvac equipment enable / disable / info The equipment you're looking at
/hvac equipment tier <t1\|t2\|t3> Changes its tier: ★☆☆ single-stage, ★★☆ two-stage, ★★★ variable (also 1-3, single, two-stage, variable, modulating). See Tiers
/hvac rename <label> Renames the sign you're looking at: a thermostat, RPM monitor, settings panel, sensor hub, thermometer, sensor, or dehumidifier, humidifier or air purifier sign

The control menu a thermostat's sign opens:

Raise Lower
Top row Black pane: +5 White pane: -5
Middle row Green pane: +1 Red pane: -1
Bottom row Lime pane: +0.1 Orange pane: -0.1

Steps are in the server's units: degrees Fahrenheit, or Celsius with units: C. The target never goes past the allowed range (60-85 °F for a room, 75-104 °F for a pool). The middle shows the target, the room's temperature and humidity, and a lever that switches the system on or off.

EZvac signs can't be edited; before 2.1, a thermostat's target was typed on line 3 of its sign.

Removing devices

Command Does
/hvac remove Removes the device you're looking at. Equipment takes its water or lava away (later, if that chunk isn't loaded). Removing a settings panel returns its system to Normal; removing a thermostat leaves its system headless; removing a sensor takes it off every hub
/hvac remove system Holding the link tool, looking at any part of a system: says what it would remove. /hvac remove system confirm within 15 seconds removes every device of it. The blocks stay

Breaking a device's block removes it too, and tells you what was removed.

Running the server (ezvac.admin)

Settings and checks for the whole server. /hvac help server lists these in game.

Command Does
/hvac quicksettings (qs) Opens the quick settings menu: device kinds and climate systems on or off, the season and the wind, units and sounds, addons, registry backups, health and updates (BETA 1.0)
/hvac setup The first-start setup again: units, wind, the HUD for new players, updates, backups, anonymous statistics and the official addons (BETA 1.0 Pilot 10, see The setup). /hvac setup skip marks it done without asking
/hvac addons Opens the Addons page: EZvac's official addons on this server, switched on and off (with their parts), the ones it doesn't have with their links, and which have an update (BETA 1.0 Pilot 4)
/hvac stats Device totals and airflow statistics, and what each part of EZvac costs the server's tick over the last minute (BETA 1.0 Pilot 4)
/hvac stats sizes Every system's size and openings, and what it has of the units it needs for cooling and heating, the worst sized first (BETA 1.0, see Sizing)
/hvac sync Applies block and world changes straight away instead of on the next update, and maps every system's air again: run it after building with /fill or WorldEdit, which don't tell EZvac
/hvac registry How hvac.yml read at this start: recovered from a backup, and the entries kept aside and why (BETA 1.0)
/hvac registry repair --force Discards the entries kept aside for good, after copying hvac.yml aside. While EZvac is stopped on an unreadable file, salvages it instead: keeps every entry that still reads. Without --force it says what it would do. See When hvac.yml is broken
/hvac update Checks GitHub for a newer EZvac now, and says whether it runs on this server's Minecraft (BETA 1.0, see below)
/hvac hud sections The sections addons have added to the HUD, with the {section:<id>} token for each (see HUD and placeholders)

Seasons

Anyone can look with /hvac season; changing it needs ezvac.admin. Each world with a sun has its own calendar (see Climate).

Command Does
/hvac season set <spring\|summer\|autumn\|winter> [day] Jumps to that season, on day 1 or the day given. fall works too
/hvac season next Jumps to the first day of the next season
/hvac season pause / resume Stops the calendar, or starts it again. While paused the days pass but the season stays

Outdoor temperatures take on the new season at once; rooms drift there over time, as they do when the weather changes. The commands act on your own world; from the console, add a world's name at the end (it defaults to the main world).

Wind

Anyone can look with /hvac wind; setting it needs ezvac.admin. Only worlds with a sky have wind (see Wind).

Command Does
/hvac wind set <calm\|breezy\|windy\|gale> [direction] Holds today's wind at that level, and from that direction if given (nw, wsw or degrees such as 270, BETA 1.0 Pilot 3), until the day ends, or the season calendar moves. It isn't saved
/hvac wind set auto Lets the wind blow as it would again

As with the seasons, from the console add a world's name at the end.

/hvac update

New in BETA 1.0. It reads GitHub's list of releases, from chat or the console, and says one of three things:

  • You're on the latest EZvac.
  • A newer one is out, and it works on this server's Minecraft, with a link to the release.
  • A newer one is out, but it needs a newer Minecraft. BETA 2.x needs Minecraft 26.1 or newer, so a 1.21.x server is told that, with a link to Moving to Minecraft 26.x. It also names the newest EZvac that still runs on 1.21.x, or says the server already has it.

Like the update notifier, it follows the server's update channel (updates.channel, BETA 1.0 Pilot 2): on Pilot it hears about newer pilots too, and on Stable only about full releases and hotfixes. Up to date, it says "the latest stable release", "the latest EZvac on the Pilot channel", or, for a pilot on Stable, that it waits for the next full release. It works even with updates.check: false, and asking again within a minute reuses the list it just read. A development build has nothing to compare against, and says so.