EZVAC ALPHA 3.0 FEATURES ================================ EZvac is a standalone HVAC and indoor-climate plugin for Paper 26.1 to 26.3 and its forks, including Purpur (BETA 1.0). One jar, built against the Paper 1.21.1 API on Java 21, also runs on 1.21.1 to 1.21.11 (automated suites on 1.21.1, .4, .5, .8 and .11; not play-tested), which logs at start-up that BETA 2.x drops 1.21.x. A climate system is the devices linked together in one world; it has a hidden key and no name of its own (3.0). SYSTEM MODEL ------------ - A system (SystemId: world + key) is whatever is linked together with the link tool. Its key is never shown or typed: a system upgraded from 2.x keeps its old group label as its key; a new one is #n from meta.next-system in hvac.yml, a counter whose numbers are never reused. A system exists only through its devices; there is no systems section. - One sign thermostat is the controller (head) of a system, at most one per system. Thermostat labels may repeat (3.0); commands act on the sign looked at, never on a label. A system without a thermostat is headless: its devices stay linked together and idle until a thermostat is linked to any of them, which merges the whole headless system into that thermostat's. - Every equipment unit is always in some system: created on its own, or unlinked, it is a headless system of one. Settings panels and RPM monitors are created unlinked (no system) and linked afterwards. - A pool thermostat is the same sign device with the water target range. Water that would make a pleasant room is cold to swim in and a hot tub would be unliveable as a room, so the two ranges overlap without either containing the other: rooms clamp to 60-85 F and pools to 75-104 F, both configurable. Since 3.0 a thermostat follows what is linked to it (HvacRegistry.settleHead, SystemLinks.pool): water-loop equipment or a loaded waxed copper grate makes it a pool thermostat, air equipment or an iron trapdoor a room one; an empty system decides nothing. A target still at the old range's default (72 or 82 F) moves to the new default; any other is clamped. A system never mixes air and water (SystemLinks.conflict), which is what stops a pool range being used to heat a room to 104 F. - A system may have one optional settings-panel sign. Without one, its operating profile is always NORMAL and matches the stock variable-speed behavior. When two systems merge and both have one, the absorbed system's panel is left unlinked. - A system may contain any number of heat pumps, air conditioners, or furnaces. - Equipment saves a tier (1-3; every unit is 2 in 3.0, and nothing reads it yet), so equipment tiers need no new save format. - Heat pumps and pool heat pumps cool and heat; air conditioners cool only; furnaces and boilers heat only. - Dispensers are authoritative actuators. Registered equipment cancels vanilla dispense behavior so inventory contents and redstone cannot fight the plugin. - Equipment does not consume buckets, fuel, water, power, or other resources. - Heat pumps, ACs, boilers, and pool heat pumps use water as their visible output. Furnaces use lava. - Only the exact output source created and recorded by EZvac is retracted. Player fluid is never adopted merely because it is in front of a dispenser. - An owned output is held in its cell (BETA 1.0): HvacListener cancels BlockFromToEvent from it (no flow, so no blocking a neighbouring unit's cell, no spill, no new sources), BlockIgniteEvent with cause LAVA from it, and BlockFormEvent turning it to obsidian or cobblestone. A unit owns its cell before placing the fluid, so the placement's own first update is held too. A cell with water or lava that is only flowing (level > 0) counts as empty for starting (EquipmentUnit.clearable); a source is still never adopted. - Shared output blocks have one deterministic winner. Losing units stop and release their output before the winner starts. - Rotated dispensers clean their previous owned output before claiming the new facing block. Unloaded cleanup is persisted and retried later. CONTROLLER ORDER AND SAFETY --------------------------- Every controller pass has explicit phases: 1. Validate equipment that physically delivered during the elapsed interval. 2. Advance compressor/blower RPM and calculate real delivered capacity. 3. Integrate each thermostat's room temperature. 4. Apply hysteresis, minimum-run, and minimum-off decisions. 5. Stop invalid, incompatible, disabled, blocked, or losing actuators. 6. Clean rotated/shared outputs. 7. Start the deterministic actuator winners for the new demand. A failure in one thermostat or equipment unit is logged and isolated. It does not abort every HVAC system for that controller pass. Default thermostat behavior: - Cooling starts above target + 1.0 F. - Heating starts below target - 1.0 F. - Cooling stops at target - 0.3 F. - Heating stops at target + 0.3 F. - Minimum run time is 300 ticks (normally 15 seconds). - Minimum off time is 200 ticks (normally 10 seconds). - Player targets are clamped to 60-85 F. - Control stop boundaries are not clamped to the player target range. A 60 F cooling setpoint can correctly stop at 59.7 F, and 85 F heating at 85.3 F. If a thermostat sign is unloaded, removed, disabled, or has no compatible loaded equipment, demand fails safe to idle. The cached biome profile and world clock still allow its simulated room to drift without force-loading chunks. THERMAL AND MOTOR PERFORMANCE ----------------------------- - One full-capacity unit cools 3.75 F per Minecraft hour. - One full-capacity unit heats 5.0 F per Minecraft hour. - Idle rooms drift 1.25 F per Minecraft hour toward outdoor temperature. - Active outdoor load is 0.50 F per Minecraft hour. - One Minecraft climate hour is 1,000 server ticks. - Multiple units use square-root diminishing returns, capped at 2x capacity. - Thermal integration is partition-independent across outdoor and control boundaries. Splitting the same ticks into multiple calls gives the same result. - Heat-pump and AC capacity varies from 40% to 100%. Outside the default 3 F approach band they request full output; inside it they progressively slow. - Every running heat pump and AC in a system receives the same variable-speed command. Their RPM-derived capacities are summed, so combined cooling slows in sync as the system approaches its target. - ECO caps variable compressors at 2,400 RPM, NORMAL at 3,600 RPM, and TURBO at 4,200 RPM by default. All caps are configurable. NORMAL is byte-for-byte the same RPM curve used before operating profiles were introduced. - Variable compressors ramp from a 1,200 RPM minimum. The thermal simulator uses the capacity derived from actual ramped RPM, not merely the requested capacity or a cosmetic RPM display value. - Furnaces and boilers are fixed-speed (EquipmentType.fixedSpeed): their blowers or pumps ramp to 1,100 RPM and their heat stays at full capacity. Before 3.1 boilers ran on the variable-speed curve by mistake. - Fixed and variable capacity are accounted for independently. A slowed heat pump never averages a furnace below 100%; both contributions are added before the overall multi-unit diminishing-return cap. - Profiles never affect furnaces or boilers. Variable units share one system-level profile command, including mixed AC/heat-pump cooling systems. - Equipment tiers (3.1; model.Tier, saved as 1-3) are real equipment kinds. PerformanceModel.stagedRequest asks each unit for what its tier can do: single-stage 1 always; two-stage 1, or performance.tiers.two-stage.low-stage (0.65) within the approach band; variable the requested-capacity curve above, bit for bit. Compressors turn that into RPM on the usual curve; furnaces and boilers burn at that share (at least minimum-capacity), their blower at the same share of 1,100 RPM. Single-stage and two-stage units deliver tiers.single-stage.capacity (0.70) and two-stage.capacity (0.85) of it. Format 8 (3.1) marks every unit from an older file variable (Tier.LEGACY), at full capacity. The ETA and the thermostat's load follow each unit's tier. - Very low startup RPM cannot create phantom heating/cooling or oscillate at an exact outdoor-temperature equilibrium. Controller, thermal, variable-speed, airflow, and audio tuning values are validated settings in config.yml. Invalid settings stop the plugin safely instead of starting with an internally inconsistent controller. OUTDOOR CLIMATE --------------- Outdoor temperature follows Minecraft time, the biome, the height and the season (2.1; before it, seven name-matched classes from Snowy 25/5 to Hot 100/78): - Every vanilla biome has its own climate in BiomeClimate: year-round average noon and midnight at sea level, a seasonal swing, and rain, snow or none. Examples: desert 98/64 +-14 (none), plains 72/50 +-18, jungle 88/74 +-2, taiga 52/32 +-24, snowy plains 28/8 +-26 (snow), ocean 66/60 +-10, caves steady (deep dark 52), Nether 96-120 steady, End 30 steady. - Biomes after 1.21.1 (BETA 1.0), keyed by id so the 1.21.1 API needs no constants for them: pale garden 62/48 +-16 (air 5/7, pollen 60, wind 0.5), dappled forest 66/46 +-18 (5/8, pollen 180, wind 0.75), sulfur caves 64 steady (fine 50, coarse 40: AQI ~137, Unhealthy for Sensitive Groups, dominant PM2.5 so it reads Smoke; wind 0). - biomes: in config.yml overrides any of it per biome id; values left out keep the built-in ones, and a broken entry warns and is skipped. - On 1.21.1 a data-pack biome (Biome.CUSTOM) is looked up by its key through Paper's UnsafeValues#getBiomeKey for overrides (26.1 removed it; there a data-pack biome is its own Biome with its own key, and is cached like any other; the caches are HashMaps since Biome is no longer an enum), else estimated from vanilla's biome temperature and downfall: the mean follows the temperature, the day/night swing is 10 + 25 x (1 - downfall) F, the seasonal swing follows the mean (26 F when cold down to 3 F in the tropics). - A rain biome's snow share for the temperature effect follows vanilla: above sea level + 17, where the height-adjusted biome temperature is below 0.15. What falls is decided by the air since BETA 1.0 Pilot 4 (below). - Altitude (altitude:): lapse-f-per-block (0.1) for every block above from-y (64), applied at the exact height after blending. - Underground (underground:): depth = min(sea level, surface height) - y, using the MOTION_BLOCKING_NO_LEAVES heightmap of a loaded chunk, in worlds with a sun. A smoothstep from start-depth (4) to full-depth (20) fades the day/night swing into the daily mean, and fades the seasonal swing and the rain/snow shares to nothing. - Seasons (seasons:): shift = seasonal swing x strength x sin(2 pi t / year - pi / 4), added to noon and midnight before the weather effect; t runs from the first day of spring, so mid-summer is +1 and mid-winter -1. Natural water uses 0.8 x the shift, water-lag-days (10; 5 before Pilot 4) later. Not applied to the cached profile, only when a temperature is read. - The calendar (SeasonService, seasons.yml): per world with a sun, a day count that moves on when the world's day count (full time / 24000) does, by at most one day per look; going back is ignored, so vanilla /time set day never resets the year. Time of day is the world's. New calendars start on spring day 1. /hvac season set|next|pause|resume changes it. Profiles are cached per thermostat, so an unloaded thermostat never causes a chunk load merely to sample its biome. A thermostat saves outdoorSeasonalF once it has sampled since 2.1; before that it estimates one from its daily mean. Biome transitions (biome-blend: in config.yml, 2.1): - The climate at a spot is the weighted average of biome samples every 4 blocks within radius-blocks (default 24) at the spot's height. Weights fall linearly from 1 at the spot to 0 at radius + 4, so the middle of a biome is exactly that biome. Noon, midnight and downfall average; rain and snow become shares of the surroundings. - Samples in unloaded chunks are skipped and the rest renormalised; with none loaded, the block's own biome is used. Blending never loads a chunk. - Each 4x4x4 cell's blend is cached per world and forgotten when a chunk within the radius loads or unloads. Readings interpolate bilinearly between the four nearest cell centres, so there are no 4-block steps. - Weather effects mix by share: a half-rain spot gets half the rain cooling, swing narrowing, wind and wetness. The HUD weather word follows the dominant weather (none unless at least half the surroundings get weather). Weather sensors report the real sky at their block. - Thermostats cache the blended climate; on a border they save outdoorRainShare and outdoorSnowShare, otherwise nothing new. Units (units: in config.yml, 2.1): F or C for everything shown and typed. Typed temperatures accept an F or C suffix that overrides it. Internally, and in config.yml, temperatures are always Fahrenheit. Weather (weather: in config.yml): - Rain cools the daily mean by 6 F, thunder by 9 F, snow by 3 F, and full rain narrows the day/night swing by 60%. The effect eases in and out over two in-game hours, because vanilla weather switches instantly. - Only biomes that get precipitation react. Deserts, savannas, badlands, the Nether and the End ignore weather; snowy biomes get snow. - Natural water follows only 10% of the air's shift. - Outdoor wind (1.5 / 3 / 5 m/s clear / rain / thunder) lowers "feels like". With the daily wind (3.2, below) the day's wind replaces the clear 1.5, and rain and thunder add their difference from it. WIND (3.2) ---------- - WindModel (pure) draws each day's level from SplittableRandom seeded by the world seed and day: the season calendar's day while it runs (so /hvac season set redraws it at once and /time set never replays one), else fullTime / 24000 (seasons off or paused). Weights calm 40, breezy 35, windy 18, gale 7, with windy and gale scaled by the season's windiness (spring 1.3, summer 0.7, autumn 1.3, winter 1.0; 1 without seasons) and calm taking up the difference. The day's mean speed is a seeded point in its level's range: calm 0-2, breezy 3-6, windy 7-12, gale 14-20 m/s. - Speed now = mean x (1 + gusts x noise), gusts 0.25, noise a seeded value per in-game hour cosine-eased to the next, in [-1, 1]. Over the first 2 in-game hours of a day the mean smoothsteps from yesterday's. Never < 0. - WindService caches today's and yesterday's day per world and the speed per tick, keyed by that day. Only NORMAL worlds have wind. /hvac wind set holds a level for the rest of that day, in memory only; auto clears it. - Exposure at a spot = biome exposure (blended like downfall; built-in table, wind.biomes overrides; unknown 1.0) x altitude (1 + (y - sea level) / 120, at most 1.5), capped at 1.8, x (1 - underground factor). Thermostats save it as outdoorWind (missing: 1.0). - Outdoor wind = (day's speed + rain and thunder extras) x exposure; it is Outdoor.windMs. A reading's wind = that x (1 - influence) x (sky light / 15)^2, so walls and roofs shelter a spot. Feels like uses it. - Leak factor = min(maximum-infiltration 2, 1 + 0.05 x outdoor wind at the thermostat or standalone space). It scales ThermalModel's idle drift and active leak, HumidityModel's infiltration and AirQualityModel's infiltration. Pools take none. - OutdoorAir: coarse x (1 + min(4, dust 1.5 x (1 - downfall) x (1 - wetness) x (max(0, wind - 6) / 8)^2)); fine x max(0.6, 1 - 0.03 x wind); pollen x min(1.8, 1 + 0.06 x wind). Rain washing applies after. - Levels read from a speed by the midpoints between ranges: 2.5, 6.5, 13. - Sensor.Kind.WIND is a BAMBOO_BUTTON. HUD {wind} {wind_level}; placeholders wind, wind_level, wind_speed, wind_ms, wind_kmh, wind_mph; speeds in km/h with units C, mph with F, unless wind.units says otherwise. - API 1.5: Wind (speedMs, Level) on ClimateReading and OutdoorClimate, Wind.Day, EzvacApi.windForecast(world, days), InstrumentView.Kind WIND_SENSOR. WIND DIRECTION AND REGIONS (BETA 1.0 Pilot 3) --------------------------------------------- - Degrees the wind blows FROM: 0 north (-Z), 90 east. Nothing is saved. - Belts (WindModel.belts, by the area's year-round mean): trades weight = smoothstep(68, 80 F), polar = 1 - smoothstep(28, 40 F), westerlies the rest. Usual directions 70 (trades), 255 (westerlies), 60 (polar). - RegionClimate reads biomes from World.vanillaBiomeProvider() (no chunk loads) on a 256-block grid at sea level + 8 (+ 64 when that lands in a cave biome), caches each cell in memory (mean F, air baseline, exposure, rough downfall: none 0, snow 0.5, rain 0.6), and blends cells bilinearly. If the provider throws it warns once and uses the westerlies for that world. - Day.directions: each day draws one per belt from the seed (salt 0xD1EC7): trades 70 + 25 v N, westerlies 255 + 50 v N (or uniform with chance 0.1 min(1, v)), polar 60 + 40 v N; N a normal draw clamped to +-2.5, v wind.direction.variation (0-2). A spot blends them as unit vectors. - Regions: value noise (0.75 at size-blocks, 0.25 at size/2.3), x1.6 and clamped to -1..1, its own per day, sampled at the spot minus drift x hours along the day's westerly direction. Speed = day mean x (1 + strength x noise), clamped to [level below's from, level above's to]. Direction bent by 20 x a second noise channel. Before 2 h after dawn both ease from yesterday's field at hour + 24. - Hourly swing: +-15 x min(1, v) x gust noise (salted). Gusts as in 3.2. - Fronts (WindModel.front, WindService.front once per tick per world): RAIN while raining (from 190 swinging to 225 over its first hour); BEHIND for 6 h after it stops (225 to 300 over the first hour, strength 1 - h / 6); AHEAD when clear, no /weather clear hold, and rain due within 6 h (190, strength 1 - h / 6). Applied as between(direction, front, 0.7 x strength x westerlies weight). When rain last started or stopped is kept in memory. - WindService.at(world, x, z) gives a Spot (speed, from) on open level ground; OutdoorTemperatureService takes it for climateAt/climateFor (Outdoor.windFromDegrees), so readings, the leak factor and sensors use the region's wind. Temperatures still use the world's day (wind doesn't move them). forecastAt gives each day's regional mean at noon, its level and direction (WindModel.dayAt). - Stations: forecast uses forecastAt at the station; a day with rain chance >= 0.5 turns its direction toward 225 (x 0.7 x westerlies). windNow and airNow give the area's wind (x area exposure) and outdoor air now; Forecast.Day.aqi from OutdoorAir.now at the day's rain chance and wind. - /hvac wind set [dir]: Held(level, from); Day.from(deg) sets every belt's direction to it. WindText.compass: 8 points; parseDirection takes 16 points or 0-360. - Display: {wind} "Windy 22 km/h W"; {wind_direction}, {wind_degrees}. Wind sensor line drops the direction when it would cut the label. Station screen "wind · AQI n" (ScreenText.fitted drops the AQI first). - API 1.8: Wind.fromDegrees (+ compass, towardDegrees, hasDirection), Wind.Day.fromDegrees, WeatherStationView.wind / airQuality, ForecastDay.aqi, EzvacApi.windAt(world, x, z), outdoorAirAt(world, x, z) (OutdoorTemperatureService.openAirAt), windForecast(location, days). Old constructors kept. SEASON CALENDAR (BETA 1.0 Pilot 3) ---------------------------------- - SeasonCalendar: a new one starts at max(0, world fullTime / 24000); each look adds every day passed (no more one-day cap); a clock set back still changes nothing. seasons.yml unchanged. SEASONS, RAIN OR SNOW, SUN AND OPEN-AIR SMOKE (BETA 1.0 Pilot 4) --------------------------------------------------------------- - 30-day seasons: seasons.yml records days-per-season per world (absent = config.yml's length before this start's upgrade). SeasonService.load converts a calendar counted in another length with SeasonCalendar.convert: same year, season and day of season, clamped to the last day; the old file is kept as seasons.yml.before--day-seasons.bak. ConfigUpdater.pilotFour (marked by weather.dry-areas being added) moves a stock 15 to 30 and a stock water lag of 5 to 10. An unset water-lag-days is days-per-season / 3. - Rain or snow: WeatherModel.kind = NONE where the blend's wet share < 0.5 and weather.dry-areas forbids it (never; thunder outside thunderstorms), else SNOW at air <= the line, else RAIN; the line is weather.snow-at-or-below-f (33), or snow-in-winter-below-f (40) while the calendar is in winter. Each 64-block area (OutdoorTemperatureService.area) works out a margin (line - air, SnowEdge.margin) from the air at its centre's ground (MOTION_BLOCKING_NO_LEAVES + 1 where loaded, else sea level + 1), looked at again every 200 ticks; a snowing area keeps snow until 2 F above the line, a raining one rain until 2 F below, and it changes at most once per 1000 ticks (at once after a clock jump, or when the season's line changes); held, the margin keeps its sign (at least 0.25 F). A column snows where the four nearest area centres' margins, blended bilinearly, plus 1.5 F x smooth noise (16-block lattice, world seed) are above 0; dry-areas is read at the column itself. A block 48 or more above its area's ground, in a raining column, snows by its own air. falling() is it while the world rains. Only NORMAL worlds. The weather word and Forecast.day (snow when the day's (high + low) / 2 is at or below the line; a dry area's rain chance follows dry-areas) use it. The temperature effect of weather still uses the biomes' vanilla rain and snow shares. - snowLineAt: -inf where the column's area snows; in a raining area max(area ground + 48, from-y + (air at from-y - line) / lapse) from the area's air at its ground (+inf with no lapse); NaN where rain doesn't reach now (dry-areas); given whether or not it rains. - dry-areas: seasonal (the default): WeatherService rolls each rain spell once as it starts (DryRain.reaches: world seed and day against the season's share in dry-rain-chance; spring's with no seasons) and keeps it in Conditions.reachesDry until the rain stops. WeatherModel.reachesDry is the one rule for never, thunder, seasonal and always; where it holds, WeatherModel.effect counts a blend's dry share as rain, so the air there cools and dampens. Forecast.day scales a dry area's chances by the season's share. - Sun: Sunshine.absorbedWm2 = 110 x sin(pi t / 12000) (0 from sunset to sunrise) x (0.8 + 0.2 season factor) x clouds (1 - 0.7 wet - 0.2 storm, at least 0.05) x exposure (1 where y > the MOTION_BLOCKING heightmap, else 0.25 x sky light / 15) x feels-like.sun-strength. Feels like adds 1.8 x 0.70 Q / (wind + 10) F (Steadman), times (1 - influence), in AirflowService.reading only: Outdoor.feelsLikeF (stations, outdoorAt) stays in the shade. - Smoke sources: SmokeSource gains SMOKER (6/2), BLAST_FURNACE (10/5) and TORCH (0.3/0: names ending TORCH but not REDSTONE_*, or LANTERN but not SEA_LANTERN; always burning). Room scans note sources on air paths too; up to 1,024 per space. - Open-air smoke (OutdoorSmokeService): per world and chunk, the positions of campfires, furnaces, smokers and blast furnaces from block entities on ChunkLoad (and every 100 ticks within 4 chunks of each player), plus places and ignitions (fire kept while it burns). Every 100 ticks the lit ones not in any room's smoke cells (AirflowService.roomSmokeCells) go into a 32-block grid. A reading sums emission x SmokePlume.share x 3 x strength x (1 - 0.6 wet) over the cells within reach (96). SmokePlume.share = max(near, (1 - w) pooled + w plume) x 3 / (wind + 3) x (1 - r / reach) x exp(-(dy / 24)^2); near = exp(-(r / 4)^2), pooled = 1 / (1 + (r / 16)^2), plume = 4 / (4 + 0.25 d) x exp(-c^2 / 2 width^2) for d > 0 downwind (c across), w = (wind - 0.5) / 2 clamped, 0 without a direction. Added to Outdoor.air (rooms, readings), openAirAt (maps, ignoring height) and stations' airNow (at the centre). HUMIDITY AND FEELS LIKE ----------------------- - Moisture is simulated as a dew point and shown as relative humidity. Heating a room lowers its RH without changing its moisture; cooling dries it. - Outdoor RH comes from the biome's vanilla downfall: about 30% at the daily mean in a desert, 54% on plains, 84% in a jungle or swamp. The dew point is steady through the day, so RH rises at night. Rain and snow pull it toward 97%. - Each air system's room drifts toward the outdoor moisture (15% of the gap per in-game hour). Delivered cooling pulls it toward the coil's 45 F dew point. - Water bordering a room's airflow evaporates into it, scaled by how much of the space is water surface and by how much warmer than the air the water is. A heated pool hall gets muggy. - Feels like is Steadman's apparent temperature: temperature, humidity and wind. Indoors there is no wind; at the edge of a system's reach it blends in. - The HUD's comfort word, bar and boss-bar colour follow feels like in air. Water is judged by its temperature alone. - The dew point never exceeds the air temperature; the excess condenses. - Microvariance (2.0): point readings get a smooth, deterministic offset from value noise over a 6-block lattice that drifts over 3 in-game hours. At most 0.5 F in conditioned air, 1.5 F outdoors (blended by influence), 0.3 F in pool water, 0.8 F in natural water, and 0.3 F of dew point, so RH mostly follows the temperature. Thermostats, equipment, ETAs, evaporation and every other part of the simulation use the unvaried values. DEHUMIDIFIERS ------------- - An iron block on a waxed copper grate, controlled by a sign on the iron block. It belongs to no system. - Its own airflow zone (30 blocks by default, a vent's reach) decides what it dries: the room of an air system whose airflow surrounds it, or else the zone itself, which keeps its own moisture and is what the HUD reads there. - It dries 3 F of dew point per in-game hour in a space up to 1,500 cells, proportionally less in larger ones, and starts 2% above its setpoint. - The water it removes fills a tank. Full, the grate is waterlogged and the unit empties for 30 seconds, then carries on. The grate's water is never allowed to flow. - Click: its control menu, setpoint +5 / -5 within the presets' lowest and highest, and power. Sneak-click: power. Both need ezvac.use. - When the dew point of the space it works on is at or below dehumidifier.dry-dew-point-f (35 F), there is nothing for its coil to condense: it keeps running, removes nothing, and its sign shows "Air too cold" instead of "Running" (cleared 1 F above). /hvac info says why. - Standalone units (outside a system's room) whose zones share air are one space: one dew point, stepped once per cycle with their combined strength; the water dehumidifiers remove is shared equally between their tanks. Its size and water are its largest zone's. - Humidifiers are the counterpart: an iron block with a waxed cut copper slab on top and a sign on the iron block. Same zone rules and controls; they add 3 F of dew point per in-game hour in a space up to 1,500 cells, ease off as the air nears saturation, start 2% below the setpoint, and are plumbed (no tank). While running the slab is waterlogged and bubbles; its water never flows. - Remote sensors are buttons: stone (temperature), polished blackstone (humidity), mangrove (both), birch (weather: Clear, Rain, Thunder or Snow; it needs open sky, judged by the MOTION_BLOCKING height map like vanilla rain, and shows Covered otherwise). A sensor hub sign shows up to nine of them, three per page; a click turns the page and auto-flip turns it every 5 seconds. Sensors read exactly as a thermometer at the same spot, never send redstone, and can appear on several hubs. Hub signs follow the same near-players refresh rule as every other sign. - Hygrometers and thermo-hygrometers are point sensors like thermometers: humidity inside and outside, or temperature, humidity and feels-like. AIR QUALITY (3.2) ----------------- - Every air system's room (saved on its thermostat as roomFine/Coarse/Pollen) and every standalone unit's space (zoneFine/Coarse/Pollen on each unit) holds three values: fine particles (PM2.5, ug/m3), coarse particles (PM2.5 to PM10, ug/m3; PM10 = fine + coarse) and pollen (grains/m3). A space not yet simulated starts at the outdoor air. Pools have no air. - Each value follows dC/dt = infiltration (outdoor - C) + sources - (settling + system filter + purifiers) C, solved exactly per step (an exponential approach to equilibrium). Infiltration is humidity.infiltration-per-hour. Settling per hour: fine 0.1, coarse 0.3, pollen 0.5. A system's own filter (fine 0.15, coarse 0.5, pollen 0.8) works only in a cycle its equipment delivered. - AQI is the US EPA index, the higher of the PM2.5 (2024 breakpoints) and PM10 scores, 0-500, applied to the current value rather than a 24-hour average. The dominant pollutant reads as Smoke (PM2.5) or Dust (PM10). Pollen is not in the AQI; its level is Low/Moderate/High/Very high at 20, 80 and 200 grains/m3. - Outdoor air: a built-in table per biome (air-quality.biomes overrides it) of dry-day fine, coarse and spring-peak pollen, blended across borders with the climate and saved on the thermostat's cached profile (outdoorFine/Coarse/Pollen). Pollen x season (linear between mid-seasons: spring 1.0, summer 0.6, autumn 0.25, winter 0; summer's 0.6 without seasons) x (1 - 0.85 wetness); particles x (1 - 0.6 wetness). Underground pollen fades with the ground factor. - Sources: the airflow scan notes lit-able blocks in or around the air (campfires, fire, lava, furnaces, smokers, blast furnaces, candles; at most 256 per space). Whether each burns is read every 200 ticks from loaded chunks. Emission is per block at air-quality.reference-cells (1,500), scaled by reference / max(cells, reference / 4). Torches and EZvac's own furnaces and boilers never count. - Air purifier: an iron block on a tube coral block (the filter) with a sign on the iron block, /hvac create purifier. From 3.2 HOTFIX 1 it can be made over air (No filter) or dead coral (Filter spent); its stored filter life stays 1, so the first fresh coral placed is a full filter. Same zone rules as a dehumidifier. No setpoint: a mode, Low, Medium, High (speeds 0.35, 0.65, 1.0 of its rate) or Auto (new purifiers; saved as mode). It runs whenever it is on, has a usable filter and can read the air. Auto idles on Low, steps to Medium past AQI 50 or at Moderate pollen, to High past AQI 100 or at High pollen, and steps down only 20 AQI under a step with pollen a tenth under its level. Strength on High: fine 2.5, coarse 2.5, pollen 3.0 per hour, x min(1, reference / cells); purifiers in one space add up by speed. - Filter (filterLife 1..0): wears by what the purifier captured (the exact integral of its removal), scaled to the reference size and shared by speed between the purifiers of a space, over air-quality.purifier.filter-capacity (2,400; pollen weighted 0.5), plus running hours x speed over maximum-life-days (60). At 0 it stops and its coral is set dead without physics. The block is read every cycle: fresh coral where a full filter was is a new filter; dead coral is spent; anything else is "No filter". A part-used filter keeps its level. BlockFadeEvent on a purifier's coral is cancelled. Breaking the coral never removes the purifier (partRequired = false); the sign or iron block does. - Readings: spot readings blend room and outdoor air by influence like the dew point (or a standalone zone's); /hvac info and /hvac temperature show it, but thermostats don't, as real ones measure no air; air monitor signs (Thermometer reads AIR) and cherry-button sensors (Sensor kind AIR); HUD {aqi} {aqi_band} {pollen}; placeholders aqi, aqi_colored, aqi_band, pm25, pm10, pollen, pollen_count; API 1.5 AirQuality. air-quality.enabled: false hides all of it. VENTS AND AIRFLOW ----------------- The link tool (3.0; a glinting stick with the link_tool tag, which also answers to the 2.x duct and sensor tools' tags) selects a thermostat (its position is stored on the item) and links equipment, vent blocks, settings panels and RPM monitors to its system, or selects a sensor hub and links sensors. Sneak-clicking unlinks. Linking a member of a headless system merges the whole system; a member of a system with another thermostat is refused. Only explicitly linked blocks become vents. A system conditions either air or water, decided by the vent blocks it uses: - Iron trapdoors are air vents. They condition the room around them, and the system is fed by heat pumps, air conditioners, or furnaces. - Waxed copper grates are water vents. Placed in a body of water they condition that water, and the system is fed by boilers and/or pool heat pumps. A pool heat pump heats and cools like an air heat pump (variable speed, operating profiles), so a pool can be cooled as well as heated. Only the unweathered waxed grate counts: waxed copper never oxidises, so a registered vent cannot change material on its own, and every vent in a build keeps one appearance. Scraping the wax off with an axe changes the block and unregisters the vent, the same as breaking it. - A system must be all air or all water. Linking a waxed copper grate to a system that already uses iron trapdoors is refused, and the reverse likewise. - Sources belong to a loop as well, and the two must agree. Boilers and pool heat pumps are the water loop; heat pumps, air conditioners, and furnaces are the air loop. Registering water-loop equipment for a system that distributes through iron trapdoors is refused, as is linking an iron trapdoor to a system powered by water-loop equipment. Water-loop equipment therefore never affects room climate, and an air heat pump never conditions a body of water. - Water keeps its own temperature. Water no pool system reaches - lakes, the sea, an unheated pool - reads the biome's natural water temperature: the biome's daily mean pulled toward mild values, with no day/night swing and never below 33 F. Readings at the edge of a pool blend toward that natural water, not toward the air, and an idle pool drifts toward it the way an idle room drifts toward the outdoor air. - Everything else is identical between the two. Water bodies behave exactly like rooms: the same thermostat, the same hysteresis and minimum run and off timers, the same capacity from multiple units, the same distance falloff from each vent, and the same ETA. More equipment heats faster; more vents cover more of the body. - The walk itself follows the medium: air systems travel through passable blocks and stop at liquids and solids, while water systems travel through water and stop at everything else. - Each vent seeds six-directional airflow. - Passable blocks carry air. - Liquids and solid blocks stop air. - Open doors/trapdoors pass air; closed ones stop it. - Carpets (wool and moss) pass air: a carpeted floor is still part of the room. - Core distance 0-15 receives full thermostat temperature. - Distance 16-30 blends progressively back to outdoor temperature. - Beyond distance 30 there is no influence. Airflow is event-invalidated and rebuilt incrementally. It never force-loads a chunk, inspects at most 4,000 nodes per server tick by default, and caps a system at 200,000 cells. Chunk events invalidate only vent systems whose possible airflow radius intersects that chunk, instead of every system in the world. Vents are indexed on a coarse grid at least as wide as the airflow range, so a block change looks only at vents in the few grid cells around it rather than at every vent on the server. Natural changes between two full solid blocks, such as buried grass decaying to dirt or concrete powder setting, cannot open or close an airflow path and are ignored outright. Both matter after large WorldEdit or FAWE fills, which can produce thousands of such changes per tick. Rebuilds are debounced. A system waits 20 ticks after its last invalidation before rebuilding, so a door being toggled repeatedly does not restart the walk on every change. A 200-tick ceiling guarantees that a constantly changing system still refreshes. A rebuild already in progress is allowed to finish rather than being discarded, so a repeatedly invalidated system always has a usable map instead of never completing one. The practical effect is that airflow reacts about a second after a door moves rather than instantly. DISPLAYS AND AUDIO ------------------ - Signs are rewritten only within about 64 blocks (4 chunks) of a player. Farther signs keep their last text and catch up within a second of someone coming near; nothing else depends on sign text. - Thermostat signs use a compact real-thermostat layout showing EZvac/ID, current room temperature, COOL/HEAT/IDLE/OFF, setpoint, load (3.1: delivered capacity over what the system's enabled units could deliver flat out in its profile, both after the diminishing returns, so 0-100%; before 3.1 it was raw capacity and passed 100%), the running/total units of its system (3.0; the group name before), and an approximate ETA while actively heating or cooling. - ETA is forward-simulated from the current equipment mix, actual RPM, future compressor modulation, outdoor load, and the same thermal rules as control. - The target can be changed by command or from the control menu a right-click on the sign opens (2.1; ezvac.use): +5/+1/+0.1 and -5/-1/-0.1 in the server's units, rounded to a tenth in that unit and clamped to the room or pool range, plus a power lever. No EZvac sign can be edited; line-3 target editing was removed in 2.1. - Sneak-right-clicking the sign switches the system off or on (ezvac.use). - Thermometers are independent point sensors with no stored system. Each reads its own sign block exactly like /hvac temperature: influenced vent temperature where airflow reaches it, blended edge temperature, or outdoor temperature. They may be placed outdoors or where no HVAC system exists. - RPM monitors (reworked in 3.0) show their system's equipment, one row per EquipmentType and tier: the kind, its tier as T1-T3 (BETA 1.0; stars before), the count when more than one, and the average RPM of the running units ("off" when none runs, "on" for a fixed-speed furnace or boiler). Rows are fitted to the sign or screen (DisplayService.rowText): the kind is shortened, then the speed (2.9k), then the count and the tier go; the speed is never cut. A screen shows six rows. Three rows to a page on a sign (model.Pager, shared with sensor hubs): a click turns the page, a sneak-click toggles auto-flip (every 100 ticks), which is saved; the page is not. A 2.x monitor's equipmentType is read and dropped. - Settings-panel signs show their system and ECO/NORMAL/TURBO profile. A normal right-click advances the profile; sneak-right-click moves backward. Since BETA 1.0 Pilot 2 the thermostat's menu sets it too (slot 4: click next, right-click previous). Exactly one holder: a system with a panel keeps it on the panel (saves unchanged); without one, on its Thermostat (saved as profile: only when not NORMAL). HvacRegistry.profileFor/setProfile read and write the holder; a panel joining a system with a thermostat takes the system's profile (panelJoined), a thermostat joining one with a panel holds none (thermostatJoined), and a panel leaving hands it back (handProfileBack), so the system keeps its profile. - Display writes are fingerprinted so unchanged screens are not redrawn. - Screens are the only display (BETA 1.0 Pilot 4): DisplayService.render draws a device's screen and nothing else; the sign-text writers, the Lines record and displays.screens are gone, and SignText is TextWidth (it only measures screen lines). A config with displays.screens: false logs one warning at start-up (HvacPlugin.screensOnly). The sign is read (a block-entity snapshot) only the first time a device is drawn and on forced refreshes, to blank it. - Screens (2.1): non-persistent text display entities in front of each device sign (ScreenService), placed by sign kind (wall, standing, hanging) and facing, scale 0.4 (0.34 on hanging signs), 100 px lines, full brightness. Since BETA 1.0 a screen is a status strip of up to three displays (ScreenText, ScreenPlacement.layout): - a header, one line, left-aligned: the name, what it belongs to, spaces and a glyph at the right end; its opaque background is the device's Tone (cooling blue, heating orange, holding/running green, off grey, alert amber, AQI band colours, neutral slate); - a body under it, opaque #101418, centred, 6 lines (more if a device needs them). A blank line of spaces just short of the 100 px wrap width sets the panel's width (a display sizes its panel to its widest line and centres the rest); lines are never padded, since a padded line could wrap and push the body up under the big reading. A line too wide drops its last " · " parts, then is cut (ScreenText.fitted), measured with SignText's widths, which hold the client's real widths for EZvac's own symbols (° 5, · 2, × 6, stars and ❄ 8; others outside ASCII count 9). A body without a big reading lists at most 5 rows and ends in that blank line; - the big reading, bold, at twice the scale with no background, centred over the body's top 2 blank lines and 0.01 blocks in front of it. Text and the header colour are sent only when they changed; a change of size, or gaining or losing the big reading, puts the screen up afresh. A refresh puts back a screen that its chunk unloading took away; removing a device (DisplayService.invalidate), a periodic sweep of screens without a device, and plugin disable take them down. - The sign behind a screen is kept blank (BETA 1.0: from 26.1 the sign's text shows through a screen); a blank sign isn't sent again. - Screen lines are measured in pixels with the vanilla font's widths (TextWidth) and cut to fit, so the game never wraps one; a reading that doesn't fit is left off whole rather than cut. - Breaking a registered device tells the player what was removed and which system it left, so a stray pickaxe cannot quietly unregister a thermostat. Thermometers are silent: they belong to no system, so there is nothing to warn about losing. Removals with no player behind them - explosions, pistons, fire - stay silent for the same reason. - Removing the last equipment from a system also warns that its thermostat will stay idle until equipment is added again. Nothing is deleted: the thermostat, its target, and every linked vent survive, so replacing the equipment restores the system exactly. Startup and shutdown sounds remain equipment-specific. Running equipment emits finite, spatial beacon ambience from each dispenser on a configurable cadence. Every sound is a "sound volume pitch" line under audio.sounds (2.0); [] silences an event. Running air systems' vents near a player play the conduit's ambient sound (one vent per 6-block cluster, every vent-airflow-refresh-ticks); pools and water vents stay silent. EZvac never performs broad sound/category stops, so it cannot silence an unrelated beacon, furnace, or another plugin's audio. CLIMATE HUD AND PLACEHOLDERS ---------------------------- - /hvac hud shows, per player, the local temperature, how warm it feels, a cold-to-hot bar, a comfort label (cold, cool, comfortable, warm, hot), the humidity, the outdoor temperature and weather, and the conditioning system with its mode, target, and airflow strength (Strength 100% green in the core, less towards the edge, gold under 50%; Outside where none reaches). - Styles: a scoreboard sidebar (default, score numbers hidden), the action bar, or a boss bar whose fill and colour follow the temperature. - Off by default per player; the choice is stored in the player's own data, so hvac.yml is unchanged. - The sidebar never replaces a scoreboard in use: it attaches only while the player is on the server's main scoreboard and nothing else is shown there, steps back if another plugin later takes over, and is not used at all when a packet-based scoreboard plugin such as TAB is installed (the action bar is used instead; see hud.sidebar.yield-to-plugins). - With PlaceholderAPI installed, %ezvac_temp%, %ezvac_feels_like%, %ezvac_humidity%, %ezvac_aqi%, %ezvac_pollen%, %ezvac_weather%, %ezvac_bar%, %ezvac_system% (also %ezvac_group%: the label of the serving system's thermostat, or Headless) and the rest expose the same values to other plugins. Without it, EZvac logs one line saying what installing it would add. - In water the HUD uses its own layout and scale (hud.water): Water, Air, Pool and Circulation lines, a 60-104 F bar, and pool comfort bands where 78-86 F is comfortable and above 95 F is a hot tub. It reads at the player's eyes when submerged and at the feet otherwise, so swimming at the surface and wading count as being in the water. %ezvac_medium% reports air or water. - In air, a player's climate is read at head height, falling back to the feet. Standing on a carpet, slab, stairs, or snow puts the feet inside that block, and the reading used to show the outdoor temperature there. - Values come from one snapshot per player, refreshed on the main thread every hud.update-ticks (default 10). Placeholder requests from any thread only read that snapshot, so frequently refreshing HUD plugins add no extra lookups. - Temperature lookups (HUD, /hvac temperature, thermometers) check only the systems with vents near the spot, not every system in the world. PERSISTENCE ----------- All thermostats, equipment, pending cleanup, vents, thermometers, RPM monitors, settings panels, dehumidifiers, humidifiers and air purifiers live in one versioned plugins/EZvac/hvac.yml file (format 7 since 3.0: every device saves its system's key, equipment its tier, and meta.next-system the next system number; a 2.x file loads with each group name as its system's key and is kept as hvac.yml.format6.bak before its first 3.0 save, and a 1.x file likewise as hvac.yml.format5.bak). There is no conversion back: 2.x refuses a format 7 file and leaves it untouched. config.yml is brought up to date on startup: settings added since it was written are added with their comments, nothing existing is changed, and the previous file is kept as config.yml.before-.bak. - Records use immutable world UUID + integer block coordinates. - World unloads require no detach/rebind rewrite. - Saves use a temporary file, backup, and atomic replacement when supported. - The save snapshot is built on the main thread; the YAML dump and file replacement run off it, so a large registry does not stall the server tick. Shutdown saves are synchronous, and concurrent writers are serialised. - If the main file is unreadable, the backup is restored. - Invalid records are logged and preserved instead of overwritten. - Loaded missing blocks are pruned; unloaded blocks are retained. HUD SECTIONS (BETA 1.0) ----------------------- - The stock sidebar is in sections: headings Here, Outside and System (Water, Outside and Pool for water), their lines indented a space; 14 lines. {system_mode} gives ": ", or the none-text outside a system. - {mode} for an idle system with a target is "Holding " (was "Idle"). - HudSettings.adoptSections: on the first BETA start (config.yml gained updates.*), a sidebar equal to the 3.2 stock list (STOCK_32, or WATER_STOCK_32) becomes the sectioned one; the 2.1-3.2 steps that bring an older stock sidebar up to date compare against STOCK_32 and run first. UPDATE CHECK ------------ - UpdateNotifier (BETA 1.0): off the main thread, 10 s after start-up and then every 6 hours, GETs api.github.com/repos/EZvac-Plugin/EZvac/releases (100 newest). updates.check: false turns it off; a build whose version is not a release name (e.g. a SNAPSHOT) never checks. - ReleaseVersion orders releases: ALPHA before BETA, then the numbers, then a number's pilots (P1 < P2) before it and its hotfixes after it (ALPHA-1.1-HOTFIX counts as HOTFIX1). The HUD's short version uses it too (BETA-1.0-P1 -> B1.0_P1). - UpdateCheck skips drafts and other tags; a GitHub prerelease counts as a pilot. A server on a pilot hears of the newest newer release, pilots included; one on a full release only of newer full releases. - A new one is logged once, and told to online players with ezvac.admin and to each one who joins (2 s later), with a link (updates.notify-admins). A failed check is logged once until a check succeeds. - Minecraft cutoffs: UpdateCheck.requirement() says what a release line needs beyond 1.21.1; BETA 2.0 and later need 26.1 (compared by number, 1.21.11 < 26.1; an unreadable server version counts as new enough). A check gives the newest newer release and the newest newer one that runs on the server's Minecraft. When they differ, the message says what the newest needs, links the 26.x move guide, and names the one that runs here (or says the server has it). A cutoff only reaches servers through releases built with it, so a future one goes in the releases before it. - /hvac update (ezvac.admin, chat or console, BETA 1.0): checks GitHub now, even with updates.check: false; a list read in the last minute is reused (GitHub allows 60 unauthenticated requests an hour). Players get clickable links, the console the addresses. A development build says it has nothing to compare against. SIZING ------ - Size-based heating and cooling (BETA 1.0; sizing.enabled, live through ServerSwitches and quick settings' Building size). SizingModel is pure. - A system's size is the blocks it owns: its completed airflow map, a block reached by several systems going to the nearest (ties to the lower id), as readings already do. Water systems count water. - Required = size / cells-per-unit (1860; pools pool-cells-per-unit, 1500), in variable-speed units. Installed = sum of tierCapacity (1, 0.85, 0.70) over enabled units that do the mode and aren't switched off server-wide. Undersized below 95% of required; the thermostat screen adds "Undersized /" (whole numbers from 10; a share in % if even that is too wide) while heating or cooling. - Delivered capacity: with sizing, units add up linearly and are multiplied by factor = min(maximum-speed-up, cells-per-unit / size), then capped at maximum-group-capacity (SizingModel.combine). Without it, the old aggregateIndependentCapacity (sqrt past one unit). The ETA and the load bar combine the same way. - The walk (air systems, sizing on): a block is open sky above the column's highest MOTION_BLOCKING_NO_LEAVES block (cached per column per rebuild). Inside (under cover, no open sky beside it at that height, reached without having been under open sky) a path goes the vent's range as before. Open sky, cover with open sky beside it (a doorway, under an eave), and anything reached after the path has been under open sky (escaped: an overhang, a porch, the next building) count steps and stop past outdoor-reach (3); only the inside resets them. Openings: open-sky blocks stepped into from the inside or the first covered edge block (outdoor step <= 1, not escaped), a set. A cell reached again by a more inside path (not escaped, or fewer steps) is walked on from again, so the shortest path dipping outside can't cut a building off. Found live 2026-11-01 on soms: an overhang made one door 12 openings and a side hole 300+ (air ran round under the eaves). - Leak: wind infiltration x openness, openness = min(maximum-openness, 1 + opening-leak x openings x 1000 / size); it feeds the thermal, humidity and air steps and the ETA. opening-leak 1.1: one open door (2 blocks) in a sized house stretches a hot day's ETA by about x1.45. - Neighbours: contact = faces where a block one system owns touches one another owns (same medium only). Each cycle a system is pulled by neighbour-exchange x contact / size x (their F - its F) per in-game hour, from start-of-cycle temperatures, at most half the gap, added after its thermal step. Shapes (owned, openings, contacts) are worked out after a map completes, for it and every system whose map could meet it, in slices of nodes-per-tick blocks a tick. - /hvac sync also remaps every system (blocks changed by /fill or WorldEdit fire no events). - A map with no blocks (every vent in unloaded chunks) counts as not mapped yet: no size factor, no openness, "not mapped yet" in listings. - Shapes are found through a 32-block grid of where maps lie, and each one started costs 64 of the tick's budget, so a mass remap spreads over ticks. Fresh ETA forecasts are capped at 64 per tick (DisplayService); past that a sign keeps its last ETA until its next refresh. The 1000-room benchmark averages the same as without sizing; its one tick of 40-65 ms, when every identical room reaches its target together, also happens without sizing, only later. - /hvac stats sizes (ezvac.admin, chat or console) and quick settings' Statistics > Sizes list every system's size, openings and has/needs for cooling and heating, the worst sized first (HvacController.sizeLines); /hvac info on a thermostat adds the openings and the systems its air touches. QUICK SETTINGS -------------- - /hvac quicksettings (qs; ezvac.admin, players; BETA 1.0): a chest menu, 36 slots for the main page since Pilot 4 (Devices 10, Climate systems 12, Seasons & wind 14, Display & sound 16; Addons 19, Backups & registry 21, Health 23, Updates 25; Close in 35), 36 for each subpage (Back in 27, Close in 35), 54 for Addons (Back 45, Check now 49, Close 53). - Seasons & wind (Pilot 4): the opener's world when it has a sky, else the first that has; SeasonService.set/next/setPaused and WindService.hold (calm, breezy, windy, gale, then null for as it would blow). - Display & sound (Pilot 4): ServerSwitches.setUnits, setWindUnits and setSounds; HvacSettings.units() and audioEnabled() and WindSettings.units() answer from the live switch once one is set. - Health (Pilot 4; Statistics before): TickCost times each scheduled task (Controller, Screens, Airflow, HUD, Weather stations, Open-air smoke), spread over every tick of a 1,200-tick window, with the longest single run; /hvac stats prints the same on a second line. - Addons (Pilot 4): AddonService. The catalogue (addons.json in the jar, refreshed from raw.githubusercontent.com/EZvac-Plugin/.github/main/ addons.json; AddonCatalogue.parse checks every name against a pattern and only ever builds github.com/EZvac-Plugin/ links); an installed plugin is official when its name and main class match an entry. EzvacApi.registerAddon (API 1.9) makes one switchable: Addon.setActive and each Addon.Part's switcher are called from the menu, and the choices are kept in addons.disabled, addons.parts-disabled and addons.parts-enabled (a part with startsOn false is off until switched on). Each installed addon's GitHub releases are compared with its running version (AddonVersion; prereleases only on the Pilot channel) with the background update check, on Check now, and told to admins on join. Nothing is downloaded or installed. A main-page click on an installed addon's icon opens its parts when it has any; its dye switches it. A switch is an icon in the second row with a lime or red dye beneath it; either toggles it. Clicks are cancelled, the permission is checked on every click, and the menus close when EZvac stops. Every change is logged with the player's name. - ServerSwitches holds the live state, read from config.yml at start-up and written back (config.set + saveConfig, comments kept) on each change. While installed, AirQualitySettings.enabled(), WindSettings.enabled() and ClimateSettings.Seasons.enabled() answer from it instead of their own field, so every existing check follows at once; without it (tests) they answer config.yml's value. AirQualitySettings.pollen() is enabled() and air-quality.pollen. - Device kinds (DeviceKind: the five equipment types and the three climate units) in devices.disabled: HvacController never picks a disabled kind, so it stops (retracting its output) like any unit not needed; a climate unit's switchedOn() is powered() and not off server-wide, and its control and state use it. Its own powered/enabled flag is untouched, so switching the kind back on resumes it. /hvac create of a disabled kind is refused; its sign reads "Off server-wide"; /hvac info says so. HvacController's hasAvailableEquipment skips disabled kinds, so a thermostat with nothing else for that mode goes (or stays) IDLE rather than calling; when the room is past its start point and a unit for it is off server-wide, the thermostat's transient waitingOnUnits (HEATING/COOLING, never saved) is set, and its screen ("Heat to 72.0°F", "Units off"; each fits one line, as a wrapped line would push the body over the big reading), sign footer ("Units off"), HUD mode ("Units off") and /hvac info say so. - Pollen off: the outdoor pollen factor is 0, and AirQualityModel.step sets a space's pollen to 0 at once; pollen labels read "Off" (AirText.pollenName, pollenHudName). Purifiers' Auto never steps up for pollen. - RegistryBackups: HvacRegistry.snapshot() (split out of save) on the main thread, then off it the YAML is written to a .tmp file, moved into backups/hvac--.yml and read back; seasons.yml is copied beside it as seasons-.yml. backups.auto-every- hours (0, 4, 8, 12, 24, 48, 168) is checked once a minute against the newest automatic backup's file time, so restarts don't reset it. After an automatic one, all but the newest backups.keep (10) automatic ones are deleted with their seasons files; manual ones never are. - UpdateNotifier.setChecking() starts or stops the background checks live (updates.check); setNotifyAdmins() (updates.notify-admins). BETA 1.0 PILOT 2 - Attention (model): NO_UNITS, NO_VENTS, UNITS_OFF, UNDERSIZED, worked out each cycle by HvacController.attention (Attention.of; UNDERSIZED judged in the mode it runs or would start in, neededMode, with building size on) and kept transient on the Thermostat. A system with no linked vent never starts: updateThermostat's cooling/heatingAvailable need registry.ventsFor() to be non-empty. The screen header counts them (ScreenText.attention: amber ⚠N before the glyph, the name cut before the count); DisplayService.blockedLine says "Needs a unit" / "Needs a vent" / "Needs a water vent" in red where the state line would be. The menu (ControlMenus): slot 0 attention (each with its fix), 4 profile, 8 system (units, vents, size, openings, has/needs). - Mini thermostats: a Thermostat with mini: true (saved only when true) at a wall button (Thermostat.standsOn: Tag.BUTTONS for a mini, Tag.ALL_SIGNS else; the controller and pruneMissingLoadedDevices use it). /hvac create thermostat at a button makes one (requireWallButton: FaceAttachable WALL, screens on). Clicks go through the usual thermostat handlers, cancelled, so the button never presses. ScreenService.showMini: a body and a big display (no header) at ScreenPlacement.mini / Mount.BUTTON (centre 0.5, depth -0.36, scale 0.3), MiniScreen.LINE_WIDTH 60 px (0.45 x 0.32 blocks). MiniScreen (the maintainer's pick of three designs): the room temperature big, in whole degrees without a unit letter and in the mode's colour; "Set 85°" (with " ⚠N"; "Set" goes before the count would be cut); and a gauge of 16 thin bars from Thermostat.progress() (room vs runStartF, set when the mode changes, never saved), a green dot while idle, "Off", or a short reason (DisplayService.miniBlocked). Registry requireFree keeps a button a mini thermostat or a sensor, never both. - The hold (PerformanceModel.hold/withHold): a running system's units never ask for less than what delivers its loss to the outdoors (lossFPerHour: active leak x wind x openness, when the outdoors is against it, level with the room included, PerformanceModel.against) plus 1 °F an in-game hour, on their tier and profile (steadyCapacity, solved by bisection); two-stage goes high when its low stage is short. Flat out still short: CANT_KEEP_UP, a non-blocking Attention. EtaEstimator applies the same hold. Undersized counts the profile (SizingModel.installed: variable units x profileShare, Eco 0.7, Turbo about 1.15); the menu names a faster profile that would do. - Water vent bubbles: HvacAudioService.ventBubbles, on the bubble task, puts BUBBLE_COLUMN_UP over each water vent of an enabled pool thermostat that is HEATING, only with a player within the audio radius. - Update channels: updates.channel auto|stable|pilot; UpdateCheck.Channel.of resolves auto from the running build; newer() skips pilots on STABLE. UpdateNotifier.channel()/setChannel() (forgets what was found and checks again); report() words "up to date" per channel. Quick settings › Updates slot 19 steps auto › stable › pilot. - First Pilot 2 start (ConfigUpdater.PILOT_2 = updates.channel added): pilotTwo() moves Pilot 1's stock humidifier bubbles (0.35 1.0) to 0.35 0.5 and backups.auto-every-hours 0 to 24 (RegistryBackups.DEFAULT_HOURS); StartupNotices.withPilotTwo tells admins once that backups are on and how many thermostats with units have no vent. WEATHER STATIONS - BETA 1.0. A tower (StationShape): a waxed copper cross round an iron block, iron, the waxed cut copper with the wall sign, then three iron blocks with waxed lightning rods right, left, right as seen facing the sign (the mirror image counts). Any waxed copper colour; plain rods only where waxed ones don't exist (1.21.1). Rods must point out sideways. - /hvac create weatherstation [label] on the sign; Overworld-type worlds only; a broken tower is refused with the first missing block and where it goes. Saved in hvac.yml weatherStations (label, enabled, strikes, last area). - Measures EZvac's outdoor climate only (OutdoorTemperatureService.blendedAt), never airflow or rooms: spots every 16 blocks out to area-radius (100), at its height, half of area-height (20) and the top, loaded chunks only; the blends are averaged into its Area. Measured on creation and at each sunrise and sunset (half-day of fullTime), checked every 40 ticks. - Forecast (simulation/Forecast): 7 days, days change at sunrise. High/low: the area's noon/midnight plus that day's season shift (seasonShiftIn), with WeatherModel.effect at the day's rain and thunder chance. Wind: WindService forecast (seeded, exact) times the area's exposure. Pollen: the season's factor that day. Rain/thunder: 400 runs of Minecraft's clocks forward from the world's (rain 12000-24000 on / 12000-180000 off, thunder 3600-15600 / 12000-180000, /weather clear holding them off), seeded by world seed and half-day; a day counts with >= 1200 ticks of it. Thunder only while it rains. Today/tomorrow's note is the current spell's end, certain. Dry areas (rain+snow share < 0.1) never get rain; snowier ones get snow. - Forecasts are cached per station; dropped at the half-day and on weather and thunder changes (then redrawn). - Screen: temperature big (whole degrees), sky, Hi/Lo, wind, then the note or tomorrow ("Tmrw: Rain 40%"); header tone by today's sky. Off, Damaged (rebuild its tower), Off server-wide or Measuring instead. - /hvac forecast (ezvac.use; alias weatherfc): stations within range (400) in the player's world, working and measured, nearest first, up to 5 along the top of a 27-slot menu; the chosen one's 7 days in slots 10-16. Clicking a station sign: admins get its menu (on/off, record, forecast), others the forecast. - Every second, stations with a player within 32 blocks recheck their tower (/fill and WorldEdit fire no events) and, when working and sparks are on, spawn ELECTRIC_SPARK at random rod tips. Breaks, places and explosions near a tower recheck it a tick later; /hvac sync rechecks all. - LightningStrikeEvent within 2 blocks of the sign column, from 2 below to 5 above it, counts a strike (saved). - DeviceKind.WEATHER_STATION in quick settings: off server-wide stops them, blocks creation and /hvac forecast. PUBLIC API ---------- - Since 2.1 the build is two modules: ezvac-api (the public API) and ezvac-plugin, whose jar shades the API's classes in unrelocated. JitPack publishes com.github.EZvac-Plugin.EZvac:ezvac-api:. - API 1.6 (BETA 1.0), additive only: systemSize (SizingModel assessments of both modes and the shape's contacts by system key), serverSettings (the ServerSwitches), weatherStations / weatherStationAt / weatherStationsNear (WeatherStationView with its ForecastDays), ClimateReading.airflowStrength() and ThermostatView.unitsOff (an extra record component with a 1.5-shaped constructor kept). Weather stations stay out of the sealed HvacDevice and the device events (EzvacApiImpl.inApi): EZdebug+ switches exhaustively over device kinds and InstrumentView.Kind, and a new one would throw MatchException in addons built against 1.5. - EzvacApi (version 1.1, read-only apart from HUD sections) is registered with Paper's services manager while EZvac is enabled (EzvacApiImpl in integration.api). Readings reuse AirflowService.temperatureAt / temperatureForBody, so they are the HUD's and /hvac temperature's numbers, variance included; outdoorAt reuses OutdoorTemperatureService.climateAt and seasonShiftAt; thermostat views take their unit counts from HvacController.status. Every value is an immutable record (ApiViews maps internals to them); temperatures are Fahrenheit. - Events, main thread, built only while their HandlerList has listeners (ApiEvents): PlayerClimateUpdateEvent from the HUD's update loop, which then reads every online player (ClimateHudService.ReadingObserver) and keeps the latest reading per player for latestFor (any thread); ThermostatModeChange from the controller's thermostat loop (mode before vs after); ThermostatTargetChange from the control menu and /hvac thermostat set; EquipmentStateChange from each cycle's started/stopped lists; SeasonChange from SeasonService (season before vs after any calendar change). - Devices (API 1.2): equipment(), vents(), instruments(), each also by world, plus thermostats(world), climateUnits(world) and devices(world). Views are the sealed HvacDevice (ThermostatView, EquipmentView, VentView, ClimateUnitView, InstrumentView), built in ApiViews from registry objects. A vent's medium follows its system: a pool thermostat, or else water-loop equipment, means WATER; no block lookups. HvacRegistry.DeviceObserver (EzvacApiImpl) hears runtime add*/remove* calls and pruning (MISSING), never load*; /hvac remove, /hvac remove system and link-tool unlinks run inside removingByCommand (COMMAND); a relinked vent is removed (COMMAND) and added again. ApiEvents fires DeviceAdded/DeviceRemovedEvent only while listened to. - HUD sections (API 1.1, EzvacApi.hud()): HudSections in integration.api is the registry (id = plugin name, lowercased with spaces as underscores, ":" + key; registering again replaces; a plugin's sections go with its PluginDisableEvent). ClimateHudService asks it for a lazy SectionFrame per shown player per update; each section is drawn at most once per frame and only where the layout asks. HudFormatter.lines expands sidebar lines that are just {addons} (every section not placed elsewhere, in registration order) or {section:}; the server's own lines always fit and a section that would pass 15 lines is left out whole. One-line formats replace {section:} from the template with the section's inline(). A section that throws is logged once while it keeps failing and is left out. hud.sections.hidden switches sections off; /hvac hud sections lists them. HudSettings.addAddonsLine adds {addons} to stock sidebars on upgrade. PERMISSIONS ----------- - ezvac.use (default true): help, temperature, list, info, season, and using signs: thermostat targets and power (control menu), settings panels, dehumidifiers and humidifiers, sensor hubs. - ezvac.hud (default true): show the on-screen climate HUD with /hvac hud. - ezvac.admin (default op): create, change, link, remove, sync, stats, update and quicksettings. See commands.md for the full command reference.