❄️ 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

1. Place a Sign where you want your Thermostat controller.
2. Create the Thermostat:

   /hvac create thermostat <id> <group> [targetF]
   

   (Looking at the sign)
3. Register Equipment:

   /hvac create equipment <group> <heat_pump|ac|furnace>
   

   (Looking at a Dispenser)
4. Register Vents:

   /hvac create vent <group>
   

   (Looking at an Iron Trapdoor)
5. Adjust temperatures or profile settings directly via sign interaction or /hvac commands!

---

🎛️ 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