Hytale 预发布版补丁说明 - 更新 6

[ETW_Zero]

预发布版本（更新 6，第 2 部分）

见本帖楼下，本次更新的模组注意事项在楼下的文章末尾。

预发布版本（更新 6，第 1 部分，热修复补丁 1）

2026 年 5 月 29 日

Bug 修复

移动相关

• 现在在滑铲过程中会保持冲刺状态，而不会降回行走速度。
• 修复了停止移动时冲刺输入未正确重置的问题。
• 落地时翻滚现在能够正确减少坠落伤害。

稳定性与性能

• 修复了邀请好友加入单人世界时可能发生的死锁问题。
• 修复了离开世界后可能出现的内存泄漏问题。
• 修复了一个罕见的竞态条件，该问题可能导致方块光照显示错误。

用户界面

• 现在可以在服务器详情菜单中滚动查看较长的服务器描述。
• 修复了好友列表过长时滚动卡住的问题。
• 修复了针对裸版本模组显示的一条令人困惑的模组兼容性警告。

世界生成

• 修复了世界结构资源未能正确重新加载的问题。

预发布版本（更新 6，第 1 部分）

2026 年 5 月 28 日

主要特性

• 新增方块调色板预设功能：保存并复用方块调色板！
  • 快捷设置菜单新增了一个侧边标签页，用于管理你的方块调色板。
  • 可将方块调色板保存为预设，并可随时重新加载。
  • 新增调色板编辑器，可创建、保存、删除和恢复方块调色板，并附有颜色选择器和拾色器工具用于选取调色板颜色。

世界与方块

• 草方块不再会向水下蔓延。已经存在于水下的草方块将缓慢变回泥土。

界面与体验优化

• 服务器发现：超过4个标签的服务器现在将显示前3个标签，并附加一个溢出指示器。悬停在溢出指示器上时会以工具提示的方式显示其余标签。
• 创造模式物品库现在会永久删除拖入其中的任何物品，包括拖入空槽位的情况。
• 现在你可以在创造模式物品库中通过右键单击来从一组堆叠物品中逐个丢弃。
• “EU”区域名称已更新为“Europe”。（译注：简体中文应该没有改动。）

模组与创作工具

• 新增世界设置“解析方块生成器”，控制方块生成器方块是否解析为其目标方块（例如是否生成箱子）。
• 图像和 OBJ 导入工具现在使用新的 TextureComputedColor 字段（每个物品纹理的主加权平均色）而非粒子颜色来匹配方块颜色，从而实现更精确的导入。导入工具还会过滤掉特殊品质的物品，使其无法用于导入。
• 资源编辑器新增一个按钮，可根据物品的纹理重新生成 TextureComputedColor 字段。
• 选区工具已更新，以更好地处理较长的本地化文本。
  • “删除”按钮不再与滑块重叠。
  • 显示较长的翻译文本时，菜单将保持在边界内。
  • 对于较长的翻译文本，文字现在可以缩小显示。
  • 滑块和下拉菜单的宽度已略微减小。

音频

• 为垃圾堆添加了新的碎裂音效，结合了陶罐和金属火盆的碎裂声。
• 为火盆添加了新的碎裂音效，每种火盆材料类型有不同的音效组。未点燃的火盆被破坏时不再播放火炬闪光音效。
• 为破坏树叶和行走在树叶上添加了新音效。
• 为破坏荆棘添加了新音效。
• 为布类方块添加了新的落地音效，调整了布类方块的行走音量，并移除了布类方块破坏时的成功音效。

错误修复

移动

• 在创造模式且速度倍率小于 1 的情况下冲刺时，玩家速度将不再被限制。

战斗、实体与物品修复

• 投射物生成位置现在基于服务端权威实体变换得出，仅当客户端报告的位置在基于速度的允许偏差范围内时才被接受。
• NPC 和坐骑的交互现在会验证玩家与目标实体之间的距离，防止修改过的客户端从任意距离与 NPC 交互或骑乘实体。
• 由实体工具放置的物品实体在被玩家捡起后将正确播放其物品动画。
• 笔刷音量设置现在能正确应用于所有建造工具。

世界与方块修复

• 修复了区块光照中方块和流体 ID 超出范围导致的崩溃。
• 修复了配置为下落的方块不会下落的问题。
• 修复了若干模型、纹理和动画的视觉问题，包括木桶、华彩方块、硬木栅栏纹理、绿色菌丝模型、小型酒馆箱子穿模以及门的穿模问题。

创造模式、模组与插件修复

• 粘贴工具的偏移量在粘贴后将不再重置。
• 标尺工具将不再在最后一个点上显示求和符号，因为该符号无法正确渲染。
• 标尺工具现在将在首次交互运行时始终放置一个点，防止快速连续放置点时出现意外行为。
• 某些建造工具在“显示工具通知”设置禁用时仍会显示通知。现在它们将遵循该设置。
• 将粘贴工具中的一些原始字符串移至语言键，以便翻译。
• 方块筛选器中的空方块现在将被正确解析（空流体 ID 现在被视为空方块 ID ）。

界面与显示修复

• 角色编辑器中“猫眼”眼部样式现在正确显示为“猫眼”（Feline）而非“Felin”。
• 素色运动衫上衣现在正确显示为“素色运动衫”（Jersey）而非“素色连帽衫”（Hoodie），后者与另一独立的素色连帽衫外观冲突。
• 修复了物品栏拖拽处理器中可能发生的客户端崩溃：当服务端物品栏更新在鼠标按下和移动之间调整了物品栏大小时引发。
• 修复了鼠标元素处理中的客户端崩溃：当鼠标移出处理程序重入地清除鼠标元素时可能发生。
• 当服务器踢出、断开连接或超时玩家时，断开连接界面现在将显示服务器发送的实际经翻译后的原因，而非通用错误消息。
• 单机世界启动失败时，现在会在断开连接界面上显示实际错误，而非静默返回主菜单。
• 缺少世界目录的单人游戏世界现在会在断开连接界面上显示明确的“找不到世界”消息。

其他修复

• 修复了若干拼写错误。
• 损坏的 Settings.json 现在将从其备份文件中自动恢复，而不再导致客户端崩溃。
• 游戏手柄打开失败将不再报告为崩溃，因为这是本地设备状况而非客户端错误。

模组制作者需要注意的改动

预发布第一部分

• 网络协议版本已从 hytale/2 升级到 hytale/3。使用先前协议版本的客户端和服务器将无法连接。同时新增了 Crash = 7 QuicApplicationErrorCode。
• BedsPlugin#getInstance() 已重命名为 #get()，以匹配 Universe、NPCPlugin、FarmingPlugin 和 ObjectivePlugin 使用的访问器约定。
• 新增了一个共享的 Universe#transferPlayerAsync() API，集中实现了“从世界移除 → 等待目标世界 → 添加玩家”的模式。调用者现在应使用此辅助方法，仅在 whenComplete 中保留自己的回退/清理逻辑。
• WorldGen 的 SingleInstance 字段已被标记为实验性。
• World#getChunkIfInMemory、World#getChunkIfLoaded、World#getChunkIfNonTicking、World#getChunkAsync 和 World#getNonTickingChunkAsync 已被弃用。现在应直接从区块引用中作为组件来访问区块数据。

 

[ETW_Zero]

预发布版（更新 6，第 2 部分）

2026 年 6 月 2 日

战斗、NPC、物品与装备

• 移除了 Template_Aggressive_Zombies、其基础交互及相关攻击序列。僵尸现在使用 Template_Predator。
• 为多个 NPC 添加了新的死亡视觉效果。
• NPC现在可以同时携带多个实体效果生成。
• 新增 Template_Flying_Aggressive 模板，适用于能够进行远程攻击的飞行敌对 NPC。Template_Eye、Template_Spirit 和 Template_Scarak_Seeker 现已弃用。

世界与方块

• 为世界生成 V2 添加了开发中的图形系统。
  • 添加了白噪声密度。
  • 添加了透明材质提供器。
  • 添加了定向抖动位置。
  • 添加了向量偏移位置。
  • 添加了锚点道具分布。
  • 添加了以下向量提供器：加法器、叉积、乘法器、归一化器、随机、标量乘法器、设置X、设置Y、设置Z、减法器、向量投影器和平面投影器。
• 添加了爆炸性方块组件。
• 新增了荒野追踪系统；该系统根据玩家床的位置将世界中的区域识别为“家附近”或“荒野”。

模组与创意工具

• 允许控制弹射物的生成位置是否随发射实体旋转，为此增加了支持。
• 实现了开发设置，可根据实体碰撞箱体积调整软碰撞。
• 重制了软碰撞半径，使其考虑碰撞箱大小。
• ControlDoorsEffect 和 DoorInteraction 现在使用新的 DoorBlockUtils 工具函数以避免代码重复。
• 添加了纹理图集 API——用于将多个带键图像合成为单个 GPU 纹理的统一 API。
• 资产编辑器的物品预览现在会尊重物品的模型覆盖，与物品在游戏中的显示方式一致。

音频

• 音频总线与衰减系统重制。
  • 当多个声音同时播放时，游戏需要决定调低哪些声音以避免重叠和互相干扰。新系统使我们能更好地控制声音如何以及何时进行衰减并快速淡出。
• 添加了在树枝堆上行走和着陆的声音。
• 为 Deco_Treasure 方块添加了新的破裂音效。
• 为仙人掌类方块添加了新的音效：行走、着陆、击中以及破裂。

Bug修复

移动修复

• 添加了防护，防止在管理背包时切换疾跑状态。
• 从侧向放置的可骑乘方块上下来时重置方向。
• 修复了当可骑乘方块沿 X 轴或 Z 轴侧向放置时的实体旋转问题。
• 修复了疾跑切换模式在停止移动后不再结束的问题。
• 滑行后现在会保持疾跑状态。
• 修复了翻滚无法抵消摔落伤害的问题。
• 修复了部分与控制器相关的设置在重启之间被重置的问题。

战斗、实体与物品修复

• 修复了当兽魔猎人没有同伴狼时其战斗状态循环的问题。
• 修复了地下城变种 NPC 不提供正确记忆的问题。
• 覆雪冷杉树叶现在可以像其他冷杉树叶一样旋转。
• 饲料袋现在可以旋转到玩家面对的方向。
• 修复了箱子在打开状态下合并成一个时会消失的问题。
• 解决了已制作物品可能被用作原料来再次制作自身的问题。
• 修复了导致家畜无法正常生产的问题。

世界与方块修复

• 修复了使用世界地图传送后玩家总是面朝北方的问题。
• 添加了当 WorldStructure 无法构建时使用后备生成器的逻辑。
• 修复了一系列可能导致 SingleInstance 生成伪影的缺陷。
• 修复了一个缺陷，该缺陷导致任何 WorldStructure 资产刷新时所有 WorldStructure 资产都被丢弃，从而阻止玩家在加载模组时加入新实例。
• 生粘土砖半砖和雕纹石砖的纹理修复。

创造模式、模组与插件修复

• 修复了当地面高度低于 0 时地面高度旋转检查导致的 SpawningContext 崩溃。
• 修复了触发体积工具的一个崩溃问题。
• 修复了针对流体的 /submerge 和 /set 命令。
• 修复了当向 Unarmed.Empty 添加次要交互时客户端崩溃的问题。
• 更新了触发体积的触发效果，使其利用区块引用/存储来访问区块数据。
• 修复了触发功能域在世界中生成时损坏的问题。
• 使用 /worldgen reload 现在会正确删除现有的触发功能域。
• 修复了当模组声明了类似 0.5.1 的语义化版本时，模组管理器显示“目标版本 0.5.1 但当前游戏版本为 0.5.1”的警告问题。
• 修复了雕刻工具在世界最大高度处导致世界崩溃的问题。
• 修复了 /pedit 生成箱子而非预制结构生成器的问题。
• 修复了建造工具密度钳制的最小值为 0 而非 1 的问题。
• 更改了耐久度条件交互，使其在物品不可破坏时始终成功。
• 改进了预制结构保存的支持模式、验证和覆盖流程。
• CraftRecipeAction 中的数量字段现在要求最小数量，以避免负数导致服务器崩溃。
• 调整了命令选项卡补全搜索的缓存行为。
• 修复了挤出工具和线条工具的方块拾取功能。
• 如果语言文件中存在重复的本地化键，现在会显示警告而不是抛出异常。
• 修复了重新加载分层资产包时，有时会将自定义资产恢复为其从父级继承的值的问题。

UI 与显示修复

• 对服务器发现菜单进行了一系列更改。
  • 服务器地址现在默认隐藏。
  • 修复了游戏语言更改时文本不更新的问题。
  • 服务器描述现在可以滚动。
• 修复了社交侧边栏面板在多次打开和关闭后可能抖动或吸附到错误位置的问题。
• 修复了本地（你的世界）选项卡中的玩家在其个人资料尚未缓存时都显示默认头像的问题。
• 修复了社交侧边栏好友滚动列表在列表过大时卡住的问题。
• 增强了好友显示名称，防止其在游戏内社交侧边栏中渲染为空白。
• 修复了当导入大型 Discord 好友列表时好友查找失败的问题。
  • 超过 500 人的列表现在可以完全加载而不会报错。
• 修复了 F11 全屏切换循环问题。
• 修复了在游戏内 UI 窗口（如背包或制作 UI）打开时 F 键无法使用的问题。
• 修复了使用右键丢弃时在存储栏和快捷栏中重复放置物品的问题。
• 修复了重新绑定键盘或控制器按键时图标不更新的问题。

稳定性与性能修复

• 修复了空手使用放置流体交互时可能发生的服务器崩溃。
• 修复了由实体以无效旋转角度生成导致的罕见服务器崩溃。
• 修复了在重新连接或返回主菜单期间点击、打字或使用控制器时可能发生的客户端崩溃。
• 修复了在多行文本字段中编辑文本时可能发生的客户端崩溃。
• 修复了靠近持有零耐久度物品的容器时可能发生的客户端崩溃。
• 修复了会话结束后可能发生的内存泄漏。
• 修复了重新加载资源时的罕见崩溃。

其他修复

• 修复了玩家死亡标记在距离出生点过远时不在地图上显示的问题。
• 游戏内的漏洞报告表单现在支持视频附件。
• 修复了游戏失去焦点时背包输入被清除的问题。
• 修复了所选输出设备不可用时音频卡顿的问题。
• 在游戏服务器中添加了检查，以记录交互期间可能有异常行为的游戏客户端的警告。
• 修复了多个拼写错误。
• 引用了已重命名装扮的玩家头像现在将在登录时自动修复，而不是阻止你加入游戏。系统会显示哪些装扮槽位发生了变化。

模组制作者需要注意的改动

• BlockChunk#getEnvironmentChunk() 方法已弃用。插件应直接通过区块实体引用获取 EnvironmentChunk。此外，WorldChunk 上的三个方法现已弃用：#getBlockChunk()、#getBlockComponentChunk() 和 #getBlock(int, int, int)。这三个方法都应替换为通过区块实体引用直接获取组件。对于 #getBlock，应改用从该引用获取的 BlockChunk#getBlock(int, int, int)。
• ProcessingBenchBlock#getProcessingSlots() 和 #getProcessingFuelSlots() 现在返回 ShortSet 而非 Set<Short>。ProcessingBenchWindow#setProcessingSlots(ShortSet) 和 #setProcessingFuelSlots(ShortSet) 现在接受 ShortSet 作为其参数类型。
• PrefabSaverSettings#isClearSupportValues() 和 #setClearSupportValues(boolean) 已被移除。插件必须迁移到 #getSupportMode() / #setSupportMode(SupportMode)。新的 SupportMode 枚举提供了三个值：KEEP_EXISTING（等同于旧的 false）、REMOVE（旧的 true）和 CALCULATE（新增；根据世界物理自动烘焙支撑值）。
• ExplosionUtils#performExplosion(...) 现在需要传入一个 Rotation3f 旋转参数，传入 new Rotation3f(0, 0, 0) 可保持现有行为。BlockHarvestUtils#performBlockDamage(...) 现在需要传入一个 boolean 类型的 isExplosion 参数，传入 false 可保持现有行为。
• ControlDoorsEffect#DoorAction 的访问权限已从 public 改为 private。对此枚举的外部引用必须迁移到 DoorBlockUtils#DoorState，后者现已成为公共 API 的一部分，并涵盖相同的状态。
• SpatialStructure<T> 的所有方法签名已更新为使用 JOML 不可变接口类型；原先参数类型为 Vector3d 和 Vector3i 的现分别改为 Vector3dc 和 Vector3ic。任何接口都必须相应更新其方法签名。
• DurabilityConditionInteraction 现在在手持物品不可破坏时返回 true，而非 false。之前使用耐久度条件作为门控来阻止对不可破坏物品执行操作的交互链，现在将放行通过。
• 对于清单名称中包含空格的插件，其基础权限字符串现在将使用下划线代替空格。此前在组 com.example 中注册为 "My Plugin" 的插件，其基础权限为 com.example.my plugin；现在变为 com.example.my_plugin。任何引用旧形式的硬编码权限检查或配置条目都必须更新。
• CodecException#getMessage() 现在返回完整的富化消息，包括键和源上下文。要获取仅通过构造函数传入的原始消息，请改用新的 #getRawMessage() 方法。