❄️ EZvac | Realistic HVAC & Indoor Climate Simulation
EZvac is a lightweight, standalone HVAC and indoor-climate simulation plugin for Paper & Purpur 1.21.1. It brings realistic 3D ducted airflow, dynamic room temperature modeling, variable-speed heat pumps, sign-based thermostats, and live ETA displays to your Minecraft server!
Unlike simple static radius plugins, EZvac models actual air propagation through connected room volumes, outdoor diurnal temperature cycles, and compressor RPM ramping.
✨ Key Features
- 💨 3D Ducted Airflow Simulation: Air propagates dynamically through vents (iron trapdoors), open doors, and room volumes using a tick-budgeted 3D pathfinding graph.
- 🌡️ Smart Sign Thermostats: Displays real-time indoor temperature, setpoint targets, current operating mode (COOL / HEAT / IDLE / OFF), equipment load percentage, and dynamic ETA predictions.
- ⚙️ Variable-Speed Equipment:
- 🧊 Heat Pump: Dispenser-backed variable-speed cooling & heating.
- ❄️ Air Conditioner: Dispenser-backed variable-speed cooling.
- 🔥 Furnace: Fixed-capacity high-heat furnace unit.
- 🎛️ Operating Profiles (Eco, Normal, Turbo): Customize system speed, noise, and energy output with wall-mounted settings panels.
- ☀️ Diurnal Climate & Biomes: Outdoor ambient temperatures change dynamically based on world time and biomes (Snowy, Desert, Nether, End, Temperate).
- 📊 Diagnostic & Monitoring Devices:
- Point Thermometer: Standalone sign sensor measuring local block/vent temperature.
- RPM Monitor: Live RPM gauges showing compressor motor speed and active capacity.
- Settings Panel: Interactive profile switcher (Eco / Normal / Turbo).
- 🔒 Item & Inventory Safe: Registered equipment consumes zero fuel, buckets, or inventory items. EZvac only manages fluid output sources it creates.
🛠️ Getting Started
- Place a Sign where you want your Thermostat controller.
- Create the Thermostat:
(Looking at the sign)/hvac create thermostat <id> <group> [targetF] - Register Equipment:
(Looking at a Dispenser)/hvac create equipment <group> <heat_pump|ac|furnace> - Register Vents:
(Looking at an Iron Trapdoor)/hvac create vent <group> - Adjust temperatures or profile settings directly via sign interaction or
/hvaccommands!
🎛️ Operating Profiles
| Profile | Max Compressor RPM | Max Cooling/Heating Capacity |
|---|---|---|
| 🌿 Eco | 2,400 RPM | 70% |
| ⚡ Normal | 3,600 RPM | 100% |
| 🚀 Turbo | 4,200 RPM | 115% |
📜 Commands & Permissions
Commands
/hvac help— View in-game command reference./hvac list— List all registered HVAC devices on the server./hvac stats— View real-time airflow node budget and system performance./hvac create <device>— Register thermostats, equipment, vents, thermometers, and panels./hvac remove— Remove the targeted HVAC device./hvac set <id> <targetF>— Set thermostat target temperature.
Permissions
ezvac.use(Default:true) — Read sign displays, use help commands, and operate settings panels.ezvac.admin(Default:op) — Full administrative control (create, remove, edit, and diagnose systems).
⚙️ Technical Requirements
- Server Software: Paper, Purpur, or compatible 1.21.1 forks
- Java Version: Java 21+
- License: Public Domain / The Unlicense
- GitHub: https://github.com/EZvac-Plugin/EZvac
