EZvac:为你的服务器带来逼真的 HVAC 体验
恒温器、热泵、空调、壁炉、锅炉和管道出风口,可对真实的房间和泳池进行温控:由方块构建,模拟真实物理效果。无需客户端模组:可在 Paper 和 Purpur 上运行。
功能特性
- 加热与制冷:行为如同真实设备。单级、双级和变速机组(以星号显示)在功率和维持室温均匀性方面各有不同。恒温器告示牌会实时显示预计到达时间 (ETA) 以及系统的工作强度。
- 建造简单: 一个链接工具即可将恒温器连接到其设备、出风口和告示牌。无需输入名称,且每栋房屋都可以拥有自己的“家”。
- 气流系统:遵循你的管道和门窗,并随距离衰减。
- 泳池和热水浴缸:配备锅炉和泳池热泵。
- 动态气候: 每个生物群系都有独特的气候,包含季节变化、山区空气更冷以及地下空气恒定。雨水会降温,加热会干燥空气,HUD 会显示体感温度。
- 除湿机和加湿器:适用于任何房间、棚屋或地下室。
- 全方位传感器: 温度计、湿度计、集线器告示牌上的按钮传感器、转速监测仪以及 Eco/Normal/Turbo 面板。
- 所有告示牌均配备发光屏幕和点击菜单,提供气候 HUD(侧边栏、动作栏或 Boss 栏)、PlaceholderAPI 占位符支持,以及华氏度 (°F) 或摄氏度 (°C) 切换。
官方插件
- LiveExposure: 为生存玩家提供体温机制。户外的高温或低温会逐渐消耗玩家状态,并在 EZvac 的 HUD 中显示。
- EZdebug+: 调试药水(或链接工具),可透视墙壁显示设备轮廓,并展示每个系统的运行情况。
这些插件基于 EZvac 的开放 API 构建,任何人都可以制作自己的插件。请从它们的 GitHub 发布页面下载。
安全构建
每次版本发布都会针对之前所有版本的存档文件进行测试,升级时会先备份你的数据,且 EZvac 绝不会触碰它无法读取的存档。
开始使用
完整指南、命令列表和更新日志请访问 GitHub。
适用于 Paper 或 Purpur 1.21.1,Java 21。采用 MIT 许可证。
有疑问或不知如何开始?加入我们的 Discord 服务器!
EZvac: realistic HVAC for your server
Thermostats, heat pumps, air conditioners, furnaces, boilers and ducted vents that condition real rooms and pools: built from blocks, simulated like the real thing. No client mod: runs on Paper and Purpur.
What it does
- Heating and cooling that behave like real equipment. Single-stage, two-stage and variable-speed units (shown as stars) differ in power and in how evenly they hold a room. Thermostat signs show a live ETA and how hard the system is working.
- Simple to build: one link tool connects a thermostat to its equipment, vents and signs. No names to type, and every house can have its own "Home".
- Airflow that follows your ducts and doors and fades with distance
- Pools and hot tubs with boilers and pool heat pumps
- A living climate: every biome has its own weather, with seasons, colder air up mountains and steady air underground. Rain cools, heating dries the air, and the HUD shows how warm it feels.
- Dehumidifiers and humidifiers for any room, shed or basement
- Sensors everywhere: thermometers, hygrometers, button sensors on a hub sign, RPM monitors and Eco/Normal/Turbo panels
- Lit screens and click menus on every sign, a climate HUD (sidebar, action bar or boss bar), PlaceholderAPI placeholders, and °F or °C
Official addons
- LiveExposure: a body temperature for survival players. Heat and cold wear them down outdoors, shown on EZvac's HUD.
- EZdebug+: a Debug Potion (or the link tool) that outlines equipment through walls and shows every system at work.
Addons are built on EZvac's open API, and anyone can make their own. Download them from their GitHub releases.
Built to be safe
Every release is tested against save files from every earlier release, upgrades back up your data first, and EZvac never touches a save it can't read.
Get started
Full guide, commands and changelog on GitHub.
Paper or Purpur 1.21.1, Java 21. MIT licensed.
Questions or unsure how to start? Join our discord server!
下载 EZvac
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EZvac
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EZvac
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EZvac
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EZvac
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EZvac
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EZvac
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EZvac
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EZvac
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EZvac
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
一个不会让你感到迷茫的初次体验。 BETA 1.0 Pilot 10 是正式版 BETA 1.0 发布前的最后一个测试版:它为新建服务器提供了配置向导,并引导你共同搭建第一个系统。
支持 Java 25 上的 Paper 或 Purpur 26.1 至 26.3(Java 21 上的 1.21.x 仍可使用,但会附带警告)。存档格式保持不变(格式 8),API 维持为 1.13,升级无需额外操作:已运行 EZvac 的服务器不会被要求重新进行设置。
设置向导
- 在新安装中,第一位加入的管理员会在聊天栏收到提示:[Set up]、[Later] 或 [Don't ask again]。
- 包含九页简短内容:温度单位(°F 或 °C)、风速显示、新玩家 HUD(及其标题,设为 Climate - Your Server)、更新公告、备份设置、匿名统计数据(说明其内容及为何有益)以及官方附加组件。
- 所有选择立即生效,也可在快速设置中进行调整。使用
/hvac setup可再次运行此向导。
搭建你的第一个系统
- 从设置向导的最后一页或输入
/hvac tutorial进入:在一个独立的世界中,一座位于浮动平台上的小木屋。 - 发光的幽灵方块会在每一步指示你需要操作的位置:热泵、恒温器、通风口、连接部件以及外壳,你可以使用任意喜欢的方块进行建造。
- 泄漏处会显示为红色,教程将解释为何关闭门窗以及墙壁无缝隙的重要性。
- 点击 [Back to my world] 即可返回原世界:你将回到原来的位置,保留物品栏和游戏模式。教程世界将在最后一名玩家离开后 10 秒自动删除,确保每次运行都是全新的。
- 当前仅涵盖一台热泵,未来将扩展支持更多设备。
所有内容详见 changelog 和 getting started guide。
Faster:性能补丁。 BETA 1.0 的预发布版本。存档未更改(格式 8),API 仍为 1.13:所有旧的 hvac.yml 均可加载,且插件无需任何改动。
性能
在与同一台机器上运行的 Pilot 8 对比测试中:
| Pilot 8 | Pilot 9 | |
|---|---|---|
| 20 名玩家开启 HUD | 每刻 2.40 ms | 0.12 ms |
| 第一分钟内的最差一帧耗时(1,000 个房间) | 约 240 ms | 低于 100 ms |
| 控制器每轮的工作量(经分析) | 减少 63% |
- HUD 的性能开销降低了约二十倍。 其大部分开销来自 MiniMessage 的转义处理,该处理会对每个值运行整个解析器。现在,无需转义的文本将保持不变,每行仅计算其显示的内容,之前绘制过的行不会再次解析,且在室外环境中气候数据仅在每次更新时读取一次。
- 不再因备份导致四分之一秒的卡顿: 启动后一分钟以及每天一次的备份操作,现在仅在主线程上进行快照拍摄。
- 控制器的工作量大幅减少: 每个分配器每轮仅读取一次,而非九次;并且对无事件触发却已损坏设备的检查被分散到五个周期中进行。
匿名统计
EZvac 现已向 bStats 报告匿名统计数据:包括服务器和玩家数量、版本信息,以及一些设置项(F 或 C、卸载状态下运行的设备、频段内系统数量、官方插件及其版本)。这些数据不包含任何可识别服务器或玩家的信息。
快速设置 › 匿名统计 列出了具体发送的数据内容,并允许一次性启用或禁用全部数据或各个部分。通过 plugins/bStats/config.yml 可为所有插件关闭此功能。详见 metrics。
配合 EZclimates 0.3.2 使用
EZclimates 0.3.2 同样更加轻量:在冬季风暴中有二十名玩家的情况下,它占用的服务器线程比例从 11.3% 降至 8.0%,且季节或天气变化时出现的长帧延迟问题已消除。
完整说明:CHANGELOG。
无人靠近时也能持续运行的房屋。 BETA 1.0 的预发布版本。存档未更改(格式 8):所有旧的 hvac.yml 均可加载。
卸载区块中的设备
在此之前,当设备所在的区块卸载时,设备会停止运行:被遗弃的房屋会随外部天气变化,其冰箱也会冻结在时间中。现在,即使超出可达范围:
- 恒温器会继续呼叫,其热泵、空调、锅炉和锅炉房继续运行,包括电机和 RPM。
- 冰箱和冰柜保持低温,霜冻会持续积累。
- 服务于房间的除湿机、加湿器和净化器 会继续对该房间进行工作。
EZvac 根据它上次看到的情况来驱动它们:房间的大小和开口、哪些单元可以正常运行、冰箱所处的空气环境。在卸载的区块中不会放置或读取任何内容,也不会加载任何区块。 当区块重新加载时,单元的 lava 或 water 才会加入;而在离开期间填满的净化器过滤器则会显示为已耗尽。
- 开销几乎为零: 在有 1,000 个系统且无人靠近的情况下,每秒额外增加约 0.08 ms,相比于让它们停止运行。
/hvac list会列出哪些系统正在卸载状态下运行,Health 页面会显示它们的开销。simulation.unloaded-devices: false会阻止超出可达范围的设备运行,与之前一样。
因此,插件的 Web 或手机仪表板可以在任何地方监控和控制房屋,即使服务器上没有人在线。
加热持续时间
对恒温器执行 /hvac info 会显示其处于当前模式的时间以及上次运行时间:Heating for 12 min · last cooled 14:02 to 14:20。
针对插件开发者的 API 1.13
ThermostatView.modeSince()、lastRun()和timeInMode():进入当前模式的实时时间,以及上次加热或冷却运行的开始和结束时间。EZvac 会保留当前模式和上次运行记录;如需完整历史记录,请记录ThermostatModeChangeEvent。- 恒温器、设备和气候单元视图上的
loaded():判断设备所在区块是否已加载。
修复
- 预报不再显示“Rain from 03:00. Snowstorm from 03:00”这种重复信息:计划中的暴风雪仅在下雪区域命名。
完整说明:CHANGELOG。
EZvac/R:制冷功能,以及适用于所有屏幕的全新外观。 BETA 1.0 的预发布版本。存档格式未变(格式 8):所有旧版 hvac.yml 均可加载。
制冷功能
四种设备用于保持桶内低温,它们吸收的热量会加热所在的房间:
| 建造方式 | 容量/温度范围 | |
|---|---|---|
| 迷你冰箱 | 侧面带有告示牌的桶 | 33 至 50 °F,七个槽位,以及一个约低 10 °F 的冷藏盒 |
| 冰箱 | 铁块上方放置 1 到 3 个桶 | 33 至 50 °F |
| 冷柜 | 铁块上方依次放置冷冻桶、冰箱桶 | 冷藏区 33 至 50 °F,冷冻区 −5 至 10 °F,自动除霜 |
| 深冷柜 | 铁块上方放置一个桶 | −20 至 0 °F;带盖子的箱式冷柜;需手动除霜 |
- 结霜: 每次打开冷柜且其运行时都会积累霜冻,先从桶的边缘开始,然后逐渐覆盖靠壁的食物,直到手动除霜才能清除。
- 开门: 打开门会让室内的空气进入,且敞开的桶会逐渐升温。
- 在 EZvac 本身中,食物不会腐烂。配合 EZclimates 0.3.0 的食物腐烂机制,食物存放温度越低,保鲜时间越长。
请参阅 制冷功能。
适用于所有屏幕的全新外观
现在每个屏幕都是一个面板,其尺寸精确匹配对应的告示牌(例如迷你恒温器的告示牌大小或按钮的面板尺寸):
- 墙上的按钮 用于设置恒温器的目标温度、设定值、净化器的风扇速度、深冷柜的除霜功能、设置面板的配置方案及页面切换。
- 恒温器上配有半环形旋钮;进度条平滑填充;设备监控图标按对应设备的实际速度旋转。
- 需要关注的事项会在标题栏用 ⚠ 标记,并在菜单中列出。
- 当你走近时屏幕会自动唤醒,因此服务器上安装大量设备并不会增加额外开销。
- 设置
screens.new-look: false可保留经典屏幕样式。
面向插件开发者的 API 1.12
- 从其他插件控制任意设备,支持来自任何线程:包括恒温器、除湿机、加湿器、空气净化器、冰箱和冷柜以及各类设备。专为网页面板和机器人设计;EZvac 不检查权限,由插件自行决定谁可以控制什么。使用
EzvacApi.get().control(plugin).as(player)。 - 在通过 API 或屏幕按钮进行的每次更改之前,触发一个可取消的
DeviceControlEvent,并告知操作者身份。 ClimateUnitView中的制冷类型,包含insideF()和cold()方法,以及针对任意容器逐槽位的storageTemperatureF()方法。
修复
- RPM 监控现在显示熔炉鼓风机的速度和锅炉泵的速度,而不仅仅是“开启”状态。
- 插件描述在菜单中不再被截断。
完整更新日志:CHANGELOG。
BETA 1.0 的第六个测试版。 玩家看到的天气: EZvac 不再在玩家看到下雨时显示下雪。存档未更改(格式 8)。
这是一个测试版:正式发行前的测试构建。请在 GitHub 上报告任何异常情况。
玩家看到的天气
在没有显示 EZvac 自身雨雪效果的插件的情况下,玩家看到的是基于生物群系的 Minecraft 原版天气。现在 EZvac 的说法与此一致:
- HUD 和
%ezvac_weather%; - 传感器;
- 气象站的预报。
因此,平原冬季会下雨,雪地生物群系会下雪,沙漠保持干燥。温度仍然遵循 EZvac 的空气温度,所以寒冷的冬雨依然刺骨。
使用 EZclimates 时,它会在世界中显示 EZvac 的雨雪效果,一切均遵循 EZvac 自身的调用,如同以往一样:寒冷的冬季平原会下雪,沙漠中会有部分冬季降雨。
面向插件开发者:API 1.11
setShowsWeather(plugin, worlds):声明你的插件会向玩家展示 EZvac 的雨雪效果及其范围。HudContext.gauge(fraction, colorAt):一个 HUD 计量条,绘制方式与 EZvac 的体感温度计量条完全相同,并沿你自己的刻度着色。
同时发布:EZclimates 0.2.0
体温现在不仅受空气影响:
- 淋湿: 雨水和水会使你弄湿,而潮湿会让寒冷更刺骨。
- 火源: 篝火能在暴风雪中让你保持舒适。
- 食物: 热食能抵御寒冷,冷食能缓解炎热。
- 盔甲: 金属盔甲在阳光下暴晒。
- 运动: 疾跑、游泳和挖矿会让你变暖。
- 新陈代谢: 寒冷会让你感到饥饿。
- 细微之处: 在冷空气中能看到你的呼吸,寒冷的夜晚会让你冻醒。
其 HUD 部分采用 EZvac 的风格,包含计量条和图标(☂45%, ♨+60°, ⚡1.4×)。
本次发布还包含:
- 灯光会融化积雪,如同原版一样。
- 融雪下的草地不再保持灰色。
- 高速移动时不再有卡顿尖峰。
它位于 GitHub。
升级
无需操作:config.yml 保持不变。
BETA 1.0 的第五个测试版。 EZdebug 已内置: 手持链接工具,即可像 EZvac 那样观察你所选的系统,包括其房间泄漏的开口——在墙壁后方呈现为发光的红色。存档格式保持不变(格式 8)。
这是一个测试版:在正式发布前的测试构建。如有任何异常,请在 GitHub 上报告。
EZdebug,已内置
选中温控器系统后手持链接工具,你将看到 EZvac 视角下的该系统:
- 设备会透过墙壁发光,标识带有边框,通风口会被标记;
- 通风口在工作时会喷出气流,并从中升起一股柱状效果:制冷时呈青色,制热时呈橙色;
- 空气填充空间的边缘会以点状环绕在你周围,让你直观了解房间覆盖的范围;
- 泄漏的开口在墙壁后方会发出红光:包括打开的门、窗户和孔洞。关闭其中一个,待房间重新映射后,其发光效果便会消失。
仅你本人可见此效果,且不会随世界存档保存。
在 /hvac addons 中,它被列为第一项,名为 EZdebug (built in),并配有开关选项。
EZdebug+ 则可通过调试药水一次性显示所有系统的上述信息,以及更多内容。当该模组安装且开启时,内置的 EZdebug 将自动退居次要位置。
面向插件开发者:API 1.10
systemSpace(world, system):获取系统所填充空间的边缘及其泄漏的开口。
同步发布:EZdebug+ 0.4.0
EZdebug+ 插件现已支持显示:
- 所有邻近房间的边缘与泄漏点;
- 气象站的覆盖区域;
- 从传感器集线器、RPM 监视器和设置面板到其连接目标的虚线;
- 更大的通风口气流喷发效果。
可在 GitHub 下载。
升级说明
ezdebug 已添加至 config.yml 并附带注释,原文件将保留作为备份。
BETA 1.0 的第四次测试版本。
- 季节长度为 30 天, 并且 雨水会由 EZvac 自身转化为降雪。
- 阳光下的体感温度比阴影处更高。
- 露天明火会在下风向熏黑空气。
- 官方插件 已切换至全新的 插件菜单,快速设置中也增加了更多选项。
- 随之推出的还有 EZclimates,这是一款新的官方插件,用于在世界中展示 EZvac 的季节变化。
存档格式保持不变(格式 8)。
这是一个 测试版:即正式发行前的测试构建。请在 GitHub 上报告任何异常情况。
30 天季节
- 每个季节默认持续 30 个 Minecraft 日,一年为 120 天,较之前的 15 天有所增加。
- 每个世界都会保留其季节和日期: 原本使用默认 15 天的服务器在首次启动时会变为 30 天,而夏季第 8 天仍保持为夏季第 8 天。你选择的长度会被保留。
- 长度可以在稍后更改, 且不会导致世界进入下一个季节。
雨或雪
- 根据 EZvac 的空气逻辑, 包括季节和一天中的时间:平原在寒冷的冬季会下雪,暖流会让苔原下雨,山顶可能白雪皑皑而山谷却在降雨。
- 气温低于 33 °F 时下雪,冬季低于 40 °F 时也会下雪, 因为现实中的雪往往在略高于冰点的温度下降落。
- 雨雪的分界线随冷空气在地表蔓延, 呈波浪状而非网格状,且风暴不会在这两者之间闪烁切换。
- 沙漠、热带草原和恶地会根据季节获得降雨: 冬季约 10 次中有 6 次是雨,春季和秋季约 10 次中有 1 次是雨,夏季约 20 次中有 1 次是雨。由
weather.dry-areas和weather.dry-rain-chance设置。 - HUD、传感器和天气预报会跟随这一变化。 单独运行时,世界仍显示 Minecraft 自带的雨雪;EZclimates 则显示 EZvac 的雨雪。
阳光下的体感
- 站在阳光下感觉比阴影处更温暖: 夏季正午最明显,云层下较少,夜间无此效果,微风会将其吹散。田野里晴朗的夏季正午,体感温度比旁边的森林高出约 8 到 10 °F。
- 仅改变体感温度: 空气、房间和气象站的数据保持不变。
烟雾
- 吸烟器和高炉有各自的速率, 高于普通熔炉。
- 火把和灯笼各自贡献少量烟雾, 因此由数十个火把照亮的房间会变得朦胧。红石火把不计入在内。
- 露天明火会在下风向熏黑空气:
- 点燃的营火、熔炉以及任何房间外的火焰;
- 在它们旁边最浓,并随风向上延伸最多 96 格,在无风日子里会聚集在周围;
- 它在室外、气象站和地图上可见,并渗入附近的房间。
官方插件
/hvac addons(也在快速设置中)列出服务器上的 EZvac 官方插件。- 可以在服务器运行时开启或关闭某个插件, 或者一次只切换其中一部分;你的选择会在重启后保留。在此版本之前发布的插件需要更新才能被切换。
- 商店 列出了你尚未拥有的官方插件及其功能说明。点击即可在聊天栏中获取链接;EZvac 永远不会下载或安装任何东西。
- 更新: 拥有新版本发布的插件会显示相应提示,管理员加入时也会收到通知。
快速设置
- 重新分为两行, 新增三个页面:
- 季节与风: 一键移动一个季节或一天,暂停季节,并设置当天的风力;
- 显示与声音: °F 或 °C,风的单位,以及设备声音,均可实时调整;
- 性能: 显示 EZvac 各部分对服务器 tick 的开销。
/hvac stats也会显示这些信息。
仅限屏幕
- 设备不再在其告示牌上书写: 每个设备都在其屏幕上显示,背后的告示牌保持空白。
displays.screens配置项已移除。
面向插件开发者:API 1.9
precipitationAt、snowLineAt、dailyMeanAirF、freezingWaterF和SeasonView.progress()。WeatherPlan和WeatherEvent,以便插件规划气象站所预报的天气。registerAddon,以便插件可以从插件菜单中进行切换。
新插件:EZclimates 0.1.0
可看可感的季节, 适用于 Minecraft 26.1 及更高版本,依赖 packetevents:
- EZvac 指定的地方下雨和下雪;
- 树叶和草地随年份变色;
- 积雪沉降与融化,湖泊结冰;
- 作物根据气温生长,因此温室在冬季也能生长;
- 按季节出现的鲜花、花瓣、落叶和蘑菇;
- 规划好的天气,如暴雪、热浪和寒潮,由 EZvac 的气象站预报;
- 体温系统,此前属于 LiveExposure 插件的功能。
它已在 GitHub 发布。
同时为插件菜单更新了:EZdebug+ 0.3.0 和 MapPeek 0.3.0。LiveExposure 0.2.1 是该插件的最终版本:其功能现已融入 EZclimates,并在 Minecraft 1.21.x 上继续正常工作。
升级指南
新的设置项及其注释已添加到 config.yml 中,旧文件将作为备份保留。
BETA 1.0 的第三个测试版。 风如今从一个特定的方向吹来,由气候设定并经降雨偏转,且因地区而异。气象站会预报其所在区域的风和空气质量,季节日历遵循 Minecraft 自身的天数,HUD 上也有时钟。存档未变(格式 8),且不保存任何新数据。
这是一个测试版:在全量发布之前的测试构建。请在 GitHub 上报告任何异常情况。
风从何处吹来
-
每个气候都有其盛行风,如同现实世界的信风带:
- 炎热气候(沙漠、热带草原、丛林):信风,来自东东北方;
- 温和气候(平原、森林、海洋):西风带,来自西西南方;
- 寒冷气候(雪地平原、冰封山峰):极地东风带,来自东北方。
每日风向会在上述基准附近波动,以西风带最为常见。EZvac 从世界种子读取生物群系信息,因此它知道无人探索过的陆地,并且风向会从一个气候区逐渐过渡到另一个气候区。
-
降雨会改变风向,如同天气锋面一样:雨前西风带转向南方,降雨期间来自西南方,雨停后转向西西北方。
-
你可以在看到风的各个地方观察到它:
- 风速传感器:
Roof Gale 61km/h NW; - HUD 中的
{wind},以及新增的{wind_direction}和{wind_degrees}占位符; /hvac wind,现在会显示你周围的风况;/hvac temperature、气象站屏幕和预报菜单。
无风日没有方向。
- 风速传感器:
-
/hvac wind set <level> [direction]: 罗盘方位点(如nw、wsw)或度数(如270)。
区域风
- 约 1,500 格宽的区域比当日基准风更强或更弱,幅度可达 40%,但不会超过约一个等级:在多风日,一个区域可能是微风,而另一个区域则是大风。
- 它们随风向漂移经过一天,因此一阵有风的区域会掠过。
- 房间、传感器和体感温度使用其所在位置的风。你用
/hvac wind set设置的等级在所有地方都保持一致。
气象站
- 每个气象站都会预报其所在区域的风及其方向。
- 空气质量: 屏幕在风力旁显示该区域的 AQI,预报菜单则以色带颜色显示每日预期的 AQI。
季节日历
/time add、睡觉或跳过时间会使季节随着每一天的流逝而推进。 在此之前,一次只计算一天。- 新的日历从 Minecraft 自身的时间开始,因此世界第 0 天是春季的第一天。你已有的世界将保留其季节和天数。
- 将时钟拨回仍然永远不会重置年份。
HUD 上的时钟
- 侧边栏的季节行末尾显示一天中的时间:
Summer, day 3 · 14:30。如果关闭季节功能,则仅显示时间。 - 新增:
{time}标记和%ezvac_time%占位符。
在你的网络地图上:MapPeek 0.2.0
MapPeek 插件现在支持 squaremap 和 BlueMap,并在其上显示:
- 气象站的风向箭头和图标;
- 已探索地图上的风和空气质量;
- 时间和季节;
- 可选地,以移动粒子形式显示风。
通过 /mappeek 菜单进行设置。它已在 GitHub 单独发布。
从 Pilot 2 升级
- 停止服务器并备份
plugins/EZvac。 - 用
EzVac-BETA-1.0-P3.jar替换 jar 文件,然后启动服务器。
- 存档保持格式 8,且不保存任何新数据。
- 你的
config.yml新增了wind.direction和wind.regions。仍使用默认行的侧边栏将增加时钟。 - 你的世界保留其季节和天数。
- 插件: EZdebug+ 0.2.1 和 LiveExposure 0.2.0 无需更改即可工作。MapPeek 0.2.0 需要 Pilot 3;MapPeek 0.1.0 也可继续使用。
面向插件开发者:API 1.8
可在 JitPack 获取,坐标为 com.github.EZvac-Plugin.EZvac:ezvac-api:BETA-1.0-P3。
- 风向:
Wind和Wind.Day新增了fromDegrees(),以及compass()、towardDegrees()和hasDirection()。 - 气象站:
WeatherStationView.wind()和airQuality(),以及ForecastDay.aqi()。 - 无需加载区块即可在任何地方使用:
windAt(world, x, z)和outdoorAirAt(world, x, z);windForecast(location, days)提供某区域的天数预报。 - 兼容: 保留了所有旧版构造函数,因此 1.7 版本的插件仍可正常工作。
测试情况
已在 Purpur 26.1.2 和 1.21.1 上运行测试,以及在 26.3 配合 squaremap 和 BlueMap 测试。1.21.x 仍受支持,但未在每个版本上进行游玩测试。
完整列表请参阅 更新日志。
BETA 1.0 的第二个测试版。 恒温器现在可以做得很小,例如安装在墙上的按钮式迷你恒温器,而恒温器的菜单则是运行系统的地方。存档格式未变(格式 8),因此所有内容均可从第一个测试版无缝迁移。
这是一个测试版:在正式发布前的测试构建。请在 GitHub 上报告任何异常情况。
迷你恒温器
-
安装在墙上按钮中的恒温器,配有比按钮稍大一点的显示屏。它显示:
- 房间温度,以大号字体显示整数度数,并根据当前状态着色;
- 目标温度,
Set 85°; - 一个进度条,显示房间距离目标温度的接近程度。
与现实生活中的恒温器一样,没有室外读数或季节模式。
-
像创建普通恒温器一样创建: 查看墙上的一个按钮并运行
/hvac create thermostat <label> [target]。它在其他方面与任何其他恒温器相同:其菜单、链接、建筑大小、HUD 和 API。 -
点击它以打开菜单。 点击不会给按钮通电,箭头键也不会。潜行点击可关闭或开启系统。
-
一个按钮要么是迷你恒温器,要么是传感器,不能兼有。
恒温器的菜单
- 配置(顶部中间):无需设置面板即可选择节能、正常或涡轮模式。单击切换到下一个,右键单击切换到上一个。拥有设置面板的系统会与面板共享此配置,且设置面板的使用方式保持不变。
- 需要注意的事项(左上角):列出系统需要处理的问题及其解决方法。
- 系统信息(右上角):显示已链接的设备,若开启建筑大小显示,则还显示其尺寸、开口以及所需设备的数量。
需要注意的事项
屏幕会在图标旁边用琥珀色数字统计这些问题(⚠2),并在菜单中说明每个问题的含义:
- 缺少通风口: 系统现在启动时必须至少有一个通风口。如果没有通风口,空气或水无处排放;泳池需要一个水循环通风口。升级时,管理员会被告知有多少个恒温器拥有设备但缺少通风口,因为这些恒温器将无法再启动。
- 缺少设备 用于加热或制冷。
- 服务器全局禁用了设备。
- 能力不足: 即使满负荷运行,散热量仍大于制热量,通常是由于开口过大或强风导致。请关闭开口或增加设备。
- 根据当前配置,设备容量不足: 节能模式下压缩机功率受限,因此热泵或空调在节能模式下的有效输出仅为额定值的 70%。菜单会在适用时提示更快的配置是否可行:“节能模式下制热不足……使用正常模式即可应对”。
达到目标温度
当接近目标温度时,设备仅会根据房间的保温能力逐步降低输出。 以前,设备在接近目标时会减速至最低输出,而在密封性较差的房间中,这可能导致温度始终差零点几度无法达标。现在,设备输出永远不会低于房间的散热速率,从而确保能准确达到目标温度。在密封良好的房间中行为不变,预计到达时间也遵循相同的规则。
更新渠道
- 选择你希望接收哪些版本的通知: 稳定版(正式版本及其紧急修复补丁)或 测试版(包含测试版构建)。可在
/hvac quicksettings› Updates 中设置,或使用updates.channel命令。默认情况下,它将跟随你所运行的 EZvac 版本类型。 - 通知消息会随渠道变化: “最新的稳定版发布”,或者如果是稳定版渠道收到了测试版更新,则会提示等待下一次完整正式版发布。
其他更新
- 自动备份默认开启,每 24 小时一次。第一个测试版的服务器将在此更新后启用该功能,管理员会收到一次通知。
- 加热泳池的水循环通风口会产生气泡。
- 加湿器的气泡更深。 如果你在
config.yml中修改过声音,该设置将被保留。
从第一个测试版升级
- 停止服务器并备份
plugins/EZvac。 - 用
EzVac-BETA-1.0-P2.jar替换原有的 jar 文件,然后启动服务器。
- 存档保持为格式 8。
- 你的
config.yml新增了updates.channel选项。自动备份频率变为每 24 小时一次,除非你手动更改过,否则加湿器的声音效果会变深。 - 拥有设备但缺少通风口的恒温器不再启动: 请为其链接一个通风口。
- 插件: EZdebug+ 0.2.1 和 LiveExposure 0.2.0 无需更改即可正常工作。新的 MapPeek 插件可在 Squaremap 上显示气象站。
面向插件开发者:API 1.7
可通过 JitPack 获取,坐标为 com.github.EZvac-Plugin.EZvac:ezvac-api:BETA-1.0-P2。
- 气象站覆盖范围: 新增
WeatherStationView.areaRadius()和areaHeight(),以便地图绘制时使用。 - 恒温器相关: 新增
ThermostatView.profile()、mini()、attention()和blocked()方法。 - 兼容性: 1.6 版本插件所依赖的内容均未发生变化。针对
ThermostatView.Attention的switch语句需添加default分支。
完整列表请参阅 更新日志。
首个 BETA 版本:EZvac 适用于 Minecraft 26.x。 单个 jar 文件即可在 Paper 和 Purpur 26.1 至 26.3 上运行,同时也支持 1.21.x。这是 EZvac 迄今为止最大的更新:供暖和制冷效果随建筑规模缩放、气象站、供服务器管理员使用的设置菜单、重新设计的屏幕和 HUD,以及一个能从损坏的存档中恢复的插件。存档格式保持不变(格式 8),因此所有来自 ALPHA 3.2 的设备均可沿用。
这是一个试点版本:即 BETA 1.0 正式发布前的测试构建。试点版本在 GitHub 上称为预发布版(prereleases),在 Modrinth 上称为测试版(betas)。请在 GitHub 上报告任何异常情况。
Minecraft 26.x
- 兼容 26.1、26.2 和 26.3,需使用 Paper 26.x 所需的 Java 25。在 26.x 中,生物群系不再是固定列表。EZvac 现在采用一种跨版本兼容的方式查询生物群系,因此数据包中的生物群系仍能拥有独立的气候。
- 三个新生物群系拥有独立的气候和空气:
- 苍白花园 (pale garden): 一片失去色彩的深色森林,略偏凉爽(正午 62 °F,午夜 48 °F),避风,花粉极少;
- 斑驳森林 (dappled forest): 比一般森林更凉爽干燥(66 °F 和 46 °F),拥有森林空气;
- 硫磺洞穴 (sulfur caves): 恒温 64 °F,由熔岩和温泉加热,空气浑浊(AQI 约 137,显示为烟雾),因此净化器在那里物有所值。
- 苍白橡木和白杨木 的标志牌、悬挂式标志牌和活板门像其他木材一样工作。
- 支持 1.21.x,但已标记为弃用,EZvac 会在启动时提示。EZvac 优先在 26.x 上进行游玩和测试。在 1.21.x 上,此版本通过了 1.21.1、1.21.4、1.21.5、1.21.8 和 1.21.11 的自动化测试。由于无人专门用于在这些版本上进行测试,且中间版本未单独检查,BETA 2.x 将完全放弃对 1.21.x 的支持:它将需要 Minecraft 26.1 或更高版本。参见 迁移到 Minecraft 26.x。
按建筑规模供暖与制冷
在此之前,只要通风口足够,一台设备就能冷却一座豪宅。现在,更大的建筑需要更多的设备,正如现实世界那样。
- 每 1,860 立方方块空气需要一台 ★★★ 级设备: 相当于约 465 平方方块地板面积、高度为 4 块方块的一层楼。★★ 级设备计为 0.85 台,★ 级设备计为 0.70 台,设备数量可累加。因此,拥有 11,160 立方方块空气的建筑需要六台 ★★★ 级设备。泳池每 1,500 立方方块水需要一台 ★★★ 级加热器。
- 设备不足会导致速度变慢。 恒温器的屏幕上会显示 Undersized 1/3(尺寸不足 1/3):表示系统当前容量占所需容量的比例。小房间的速度更快,最快可达两倍。预计时间(ETA)会考虑所有这些情况。
- 查看你的状态:
- 在恒温器上使用
/hvac info可查看建筑的体积、开口情况以及系统当前容量占所需容量的比例; /hvac stats sizes以及快速设置中的 Sizes 选项列出所有系统,按尺寸最不足的优先排序。
- 在恒温器上使用
- 开口会导致泄漏。 敞开的门、窗户或通向天空的洞口会让室外空气进入,增加系统负担。门口本身会计入其对应的几处开口,无论门外是什么。
- 空气止于屋顶边缘。 空气仅向屋顶外延伸 3 个方块,因此室外的通风口只会形成一小团空气气泡,而非广阔区域。
- 相邻系统 如果空气相连(例如通过敞开的门口,暖气房与冷气房相邻),它们会相互平衡。墙壁或关闭的门会将它们隔开。
- 使用
/fill或 WorldEdit 建造? 请使用/hvac sync重新映射每个系统的空气区域。 - 你的服务器,你做主:
- 对于从 ALPHA 升级的服务器,默认处于关闭状态,因此你的建筑供暖和制冷效果与之前完全一致。管理员在加入时会收到一次通知。通过
/hvac quicksettings中的 Building size 选项开启它。 - 新服务器默认开启此功能。
- 你可以随时将其关闭。
- 对于从 ALPHA 升级的服务器,默认处于关闭状态,因此你的建筑供暖和制冷效果与之前完全一致。管理员在加入时会收到一次通知。通过
气象站
一款新设备:一座塔楼,可为附近的玩家预测未来七天的天气。
-
建造方法(仅限管理员),自下而上:
- 围绕一个铁块放置四个涂蜡铜块,呈十字形;
- 一个铁块;
- 一块带正面标志牌的涂蜡切制铜块;
- 至 6. 三个铁块,右侧、左侧和右侧各放置一根涂蜡避雷针。
然后看向标志牌并运行
/hvac create weatherstation [label]。如果塔楼不完整,EZvac 会指出缺失哪个方块及其位置。在 1.21.9 之前,普通避雷针也可用。 -
仅测量室外环境: 以气象站为中心,半径 100 方块、向上 20 方块的区域气候,在日出和日落时进行测量。它从不读取室内温度,因此旁边的房屋不会干扰其数据。
-
诚实的预报:
- 每日的最高温和最低温、风速和花粉浓度是精确的,基于该区域的气候、季节日历和世界种子;
- 降雨和雷暴仅在 Minecraft 自身天气时钟已知的范围内确定(例如“15:00 开始下雨”、“全天晴朗”),之后的概率则作为可能性给出,因为下一段天气是随机的。
-
阅读预报:
- 屏幕 显示温度、今日天气以及确定性信息;
- 点击屏幕 可查看七天预报;
/hvac forecast(所有人可用)列出 400 方块内的气象站,按距离由近及远排序。
-
火花与闪电: 正常工作的气象站附近有人时,其避雷针会产生火花,并统计击中塔楼的每次雷击。
-
损坏: 塔楼损坏会导致气象站停止工作,直到重建完成。
-
设置: 管理员可在其菜单中开关气象站。气象站属于快速设置的“Devices”页面类别之一,
config.yml中的weather-stations设置控制范围、区域和火花效果。
快速设置
/hvac quicksettings(或 /hvac qs,仅限管理员)是一个集中管理影响整个服务器的设置的菜单。更改立即生效,写入 config.yml 并记录日志。
- 设备: 可切换为全服关闭状态:热泵、空调、熔炉、锅炉、泳池热泵、除湿机、加湿器、空气净化器或气象站。它们会停止运行,屏幕显示“全服关闭”,且无法制造新设备。若恒温器无加热或制冷对象,则显示单元已关闭。
- 气候系统: 可在不重启服务器的情况下切换空气质量、花粉、风力、季节和建筑大小的开关。
- 备份与注册表:
- 立即备份注册表,或自动每隔 4、8、12、24 或 48 小时,以及每周备份一次(保留最新的 10 个自动备份);
- 查看
hvac.yml的状态。
- 统计信息与更新:
/hvac stats和/hvac update的显示内容,以及更新检查的开关选项。
当 hvac.yml 损坏时
手动编辑出错、条目错误或文件损坏不再导致 EZvac 崩溃。
- 管理员会在游戏中收到通知, 在加入服务器后瞬间触发。消息会说明
hvac.yml是在本次启动时从备份中恢复的,还是某些条目被隔离保存了。 - 更多回退机制: 如果
hvac.yml.bak也无法读取,EZvac 将从plugins/EZvac/backups/目录中最新的可读备份进行恢复。 - 停止而非消失: 在没有可读文件的情况下,EZvac 保持加载状态但不运行且不保存数据,
/hvac命令会解释原因。执行/hvac quicksettings可打开恢复菜单:通过点击即可抢救文件或恢复备份,随后只需等待一秒。 /hvac registry列出被隔离保存的内容,而/hvac registry repair --force可故意丢弃这些内容。- 升级绝不会触发上述任何情况。 成功升级到较新的存档格式后,管理员会收到升级成功的提示。
屏幕与 HUD
-
所有屏幕均重新设计为状态条。 标题颜色由设备当前行为决定:蓝色并带 ❄ 表示制冷,橙色并带 ♨ 表示制热,绿色表示维持温度,灰色表示关闭,琥珀色表示需要您干预。主读数以大号字体居中显示在其下方。屏幕后的告示牌现在变为空白,因为在 26.x 版本中其文本会透显出来。
-
RPM 监控器 以
T1至T3显示层级(例如HP T3 ×2 2,950)。长行会被缩短,但转速数值永远不会被截断。 -
HUD 侧边栏按区块组织:
- 分为此处 (Here)、外部 (Outside) 和系统 (System),每个区块带有强调色标题;
- 一条从蓝到绿再到红的舒适度仪表,并在感觉舒适的位置标有 ◆;
- 一个图标显示系统当前行为(♨ 制热、❄ 制冷、● 维持温度)。
原版侧边栏在您升级时会移至对应区块;若您曾修改过,则保持不变。
-
气流强度可视化: 在通风口核心区域以绿色显示
Airflow: Strength 100%,越靠近影响范围边缘强度越低,低于 50% 时显示为金色。此前显示的是Core或62% leakage,其含义与实际相反。 -
空闲系统显示其维持的温度: 显示为
Holding 72.0°F,而非之前的Idle。
更新通知
- EZvac 会在有新版本发布时通知管理员。 它在启动时及每 6 小时检查一次 GitHub,记录日志,并在管理员加入时告知。
- 测试版 (Pilots): 运行测试版的服务器会收到关于其他测试版和正式版的更新通知;运行正式版的服务器仅接收正式版的更新通知。
/hvac update会立即进行检查。它还会告知新版本是否支持您当前的 Minecraft 版本,因此 1.21.x 服务器不会收到无法运行的 BETA 2.x 安装提示。- 设置
updates.check: false可关闭后台检查。
其他新增与修复内容
/hvac help更简洁: 玩家仅能看到自己的命令,管理员额外获得两页内容/hvac help build和/hvac help server。Tab 补全仅提供您可执行的命令。- 修复: 单元的液态水或岩浆可能蔓延至同一外壳内的相邻单元,或淹没在其外壳未完成前链接的建筑。现在它会限制在自身单元格内。
- 修复: 1.8 至 2.2 版本的默认侧边栏从未包含季节、附加组件、空气和风力相关的行。
从 ALPHA 3.2 升级
- 停止服务器并备份
plugins/EZvac文件夹。 - 将 jar 文件替换为
EzVac-BETA-1.0-P1.jar。在 26.x 版本上,请使用 Java 25 运行服务器。 - 启动服务器。
- 存档格式仍为 8。 所有设备均可迁移。
- 您的
config.yml新增了updates、devices、backups、sizing和weather-stations区块及其注释,其中建筑大小默认为关闭状态。 - 纯文本告示牌 (
displays.screens: false) 不再受支持。它们仍可工作,但不会显示任何新功能行,且可能在后续版本中被移除。通过 Geyser 连接的基岩版玩家无法看到屏幕。 - 不支持回退至 ALPHA 版本, 请妥善保留该备份。
- 附加组件: EZdebug+ 0.2.1 和 LiveExposure 0.2.0 无需更改即可正常工作。
面向附加组件开发者:API 1.6
可通过 JitPack 获取,坐标为 com.github.EZvac-Plugin.EZvac:ezvac-api:BETA-1.0-P1。
- 建筑大小:
systemSize提供系统的大小、开口数量以及其满足需求的能力。 - 快速设置:
serverSettings提供各项开关选项。 - 气象站:
weatherStations、weatherStationAt和weatherStationsNear,各自包含七天预报数据。 - 读数:
ClimateReading.airflowStrength()和ThermostatView.unitsOff()。 - 兼容性: 1.5 版本附加组件所使用的内容均未发生变化。气象站未包含在
HvacDevice和设备事件中,因此针对所有设备类型的switch语句依然完整。
完整列表请参阅 更新日志。
这是 ALPHA 3.2 的 Bug 修复版本,除此之外没有其他改动。存档未变更(格式 8),因此这是一个直接替换升级,回退到 3.2 只需替换 jar 文件即可。
已修复:空气净化器难以建造
/hvac create purifier 命令要求在铁块下方放置一个活着的管珊瑚块。管珊瑚离开水源后几秒内就会死亡,因此在使用命令时它往往已经死亡,导致无法建造空气净化器。
现在:
- 你可以先建造空气净化器。 在铁块下方不放任何方块进行建造,它会处于“无滤芯”状态;放在死珊瑚上建造,则会显示“滤芯耗尽”。
- 你放置在铁块下方的第一个管珊瑚块将成为一个新的滤芯,并且会像其他滤芯一样保持存活。
- 铁块下方的其他任何方块仍会被拒绝。
已验证
- 414 个自动化测试,包括针对在没有滤芯的情况下建造空气净化器的新测试。
- 已在 Purpur 1.21.1 上实地验证:在空中建造(“无滤芯”);玩家放置珊瑚(“滤芯 100%”,15 秒后仍存活);在死珊瑚上建造(“滤芯耗尽”);在石头上建造被拒绝;附近散落的珊瑚仍然会死亡。
升级方法
停止服务器,将 plugins 文件夹中的 EZvac jar 文件替换为 EzVac-ALPHA-3.2-HOTFIX1.jar,然后重新启动服务器。插件无需更改:EZdebug+ 0.2.1 和 LiveExposure 0.2.0 仍可照常使用。
下方的 jar 文件由 GitHub Actions 从 0518b7d 构建。完整详情请参阅 CHANGELOG.md。
API 版本发布。 插件现在可以获取所有 EZvac 设备及其位置信息。对玩家或服务器没有任何影响:存档、配置文件和游戏内容与 ALPHA 2.1 完全一致,因此升级只需替换 jar 文件即可。
EZdebug+ 是一个基于此 API 构建的新官方插件:它使用调试药水为每个告示牌添加边框,穿透墙壁显示装备轮廓,并让正常运行的通风口以彩色烟雾效果呈现。
从 2.1 升级
停止服务器,将 jar 文件替换为 EzVac-ALPHA-2.2.jar,然后重新启动。无需进行任何转换或设置。回退到 2.1 同样只需替换为对应的 jar 文件。
面向插件开发者:API 1.2
该 API 托管在 JitPack,坐标为 com.github.EZvac-Plugin.EZvac:ezvac-api:ALPHA-2.2。
-
按世界遍历所有设备:
equipment():热泵、空调、熔炉、锅炉和泳池热泵,包括其所属系统、运行状态(是否开启及正在运行)、模式以及电机转速;vents():其所属系统,以及是吹出空气还是水;instruments():温度计和湿度计、传感器、传感器集线器(包含其所显示的传感器)、转速监控器和设置面板;thermostats(world)、climateUnits(world);devices(world):指定世界中的所有设备。
-
单一密封类型: 每个视图都是带有
position()方法的HvacDevice,因此一个switch语句即可覆盖所有类型。 -
事件:
DeviceAddedEvent;DeviceRemovedEvent:当设备被破坏、通过命令移除或检测到缺失时触发。
地图类插件可以一次性读取
devices(world)并监听这些事件。与 EZvac 的其他事件一样,如果没有插件监听,这些事件不会产生任何性能开销。 -
未包含的内容: 传感器读数不属于上述视图的一部分。请使用
readingAt方法读取任意位置的读数。
详细信息及示例请参阅 API 指南。所有内容变更详见 更新日志。
需要 Paper 1.21.1 或其分支(如 Purpur),并在 Java 21 环境下运行。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧