ValheimRAFT 适用于 1.0.12

ValheimRAFT v4.3.5 (Valheim 1.0.12 兼容性与打磨更新)
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#valheimraft-v435-valheim-1012-compatibility--polish-update][/url]
[b]ValheimRAFT[/b] 在 Valheim 中建造自定义的可移动木筏、船只和可移动基地。使用标准建筑部件扩展你的船只，抛下船锚，航行于开阔海域，并起飞！
[quote]请将 ValheimRAFT 更新至适用于 [b]Valheim 1.0.12[/b]、[b][url=https://thunderstore.io/c/valheim/p/ValheimModding/Jotunn/v/2.30.0/]ValheimModding-Jotunn-2.30.0+[/url][/b]、[b][url=https://thunderstore.io/c/valheim/p/denikson/BepInExPack_Valheim/]denikson-BepInExPack_Valheim-5.4.2350+[/url][/b] 以及 [b][url=https://thunderstore.io/c/valheim/p/ValheimModding/JsonDotNET/]ValheimModding-JsonDotNET-13.0.4+[/url][/b] 的版本。[/quote][line]
[heading]☕ 支持[/heading]
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-support][/url]
祝游玩愉快，你可以在 Ko-fi 上捐赠：
☕ [b][url=https://ko-fi.com/jndev0]在 Ko-fi 上支持 JNDEV0 (https://ko-fi.com/jndev0)[/url][/b]
[line]
[heading]⚠️ 重要的"按原样提供"免责声明[/heading]
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#%EF%B8%8F-important-as-is-disclaimer][/url]
[list]
[]此分支的创建是为了让 ValheimRAFT 在 Valheim 1.0 发布（Unity 6 引擎升级）后能够再次游玩。[/]
[]核心功能主要针对单人游玩进行了测试：载具部件建造、漂浮/航行、风帆推进、船锚切换、飞行、压舱、平滑入水过渡、舵轮装置控制以及世界保存/加载。[/]
[]ValheimRAFT 是一个庞大且复杂的代码库，包含高级机制。并非所有扩展功能或边缘情况交互都经过了详尽测试。[/]
[][b]按"原样"提供[/b]：免费提供，不附带任何保证。在测试前请务必备份你的角色和世界存档！诚挚邀请玩家和模组作者在 GitHub 仓库报告问题、Bug、提交建议或 Pull Request，并帮助维护此模组：👉 [b][url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12]https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12[/url][/b][/]
[/list][line]
[heading]📜 署名与开源历史[/heading]
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-attribution--open-source-history][/url]
[list]
[][b]原始创作者[/b]：[b]Sarcen[/b] 创建了定义了 Valheim 造船玩法的原始 ValheimRAFT 模组，并于 2023 年在 GPLv3 许可下慷慨地将其作为开源发布。[/]
[][b]现代重写与架构[/b]：[b]Zolantris[/b]（[url=https://github.com/zolantris/ValheimMods]zolantris/ValheimMods[/url]）彻底重写了该模组的架构，添加了模块化载具系统、凸包边界物理以及大量扩展功能。[/]
[/list][line]
[heading]📥 安装[/heading]
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-installation][/url]
方案 A：Thunderstore / r2modman / Gale（推荐）
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#option-a-thunderstore--r2modman--gale-recommended][/url]
[list=1]
[]通过你选择的模组管理器安装。[/]
[]依赖项将自动解析并安装。[/]
[/list]方案 B：NexusMods / Vortex / 手动安装
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#option-b-nexusmods--vortex--manual-installation][/url]
[list=1]
[]如果使用 Vortex，直接安装并启用 zip 压缩包。[/]
[]如果手动安装，请将
[code]ValheimRAFT[/code] 解压到你的
[code]Valheim/BepInEx/plugins/[/code] 目录中：
[code]Valheim/
└── BepInEx/
└── plugins/
├── ValheimRAFT/
│ ├── ValheimRAFT.dll
│ ├── ValheimVehicles.dll
│ ├── Zolantris.Shared.dll
│ ├── ZdoWatcher.dll
│ ├── DynamicLocations.dll
│ ├── ServerSync.dll
│ └── Assets/
│ └── Translations/
│ └── English/
│ └── valheimraft.json
└── Newtonsoft.Json.dll (来自 ValheimModding-JsonDotNET)[/code][/]
[/list][line]
[heading]📦 需求与依赖项[/heading]
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-requirements--dependencies][/url]
要使用此模组，请确保你安装了以下必需的依赖项：
[list=1]
[][b][url=https://thunderstore.io/c/valheim/p/denikson/BepInExPack_Valheim/]denikson-BepInExPack_Valheim-5.4.2350+[/url][/b][/]
[][b][url=https://thunderstore.io/c/valheim/p/ValheimModding/Jotunn/v/2.30.0/]ValheimModding-Jotunn-2.30.0+[/url][/b][/]
[][b][url=https://thunderstore.io/c/valheim/p/ValheimModding/JsonDotNET/]ValheimModding-JsonDotNET-13.0.4+[/url][/b][/]
[/list][line]
[heading]📜 更新日志 (v4.3.5)[/heading]
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-changelog-v435][/url]
📯 洛基之角（船只召回、舵轮调谐与紧急传送）
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-horn-of-loki-boat-recall-helm-attunement--emergency-teleport][/url]
[list]
[][b]可制作紧急工具[/b]：添加了 [b]洛基之角[/b]（
[code]$item_vessel_horn[/code]），可直接从背包中手工制作，消耗 2 个木材，无需工作台（以 Loki 命名，他是北欧神话中 Naglfar 的造船者）。[/]
[][b]死亡时保留[/b]：如果你死亡时背包中带有洛基之角，重生时它将保留在你身上，让你能够立即引导并传送回你的船上以取回或拿取备用装备！[/]
[][b]舵轮调谐（[/b]
[code][右键][/code][b]）[/b]：在交互范围内（≤ 3.5 米）直接瞄准你船只的载具舵轮，并按住右键 3 秒，将角调谐至你的船只。如果瞄准其他任何地方，将显示屏幕提示（
[code]"必须在载具舵轮处绑定"[/code]）。[/]
[][b]甲板直接传送（[/b]
[code][左键][/code][b]）[/b]：按住左键 3 秒，从世界上的任何位置引导紧急传送，直接传送到甲板上的舵轮处（即使携带金属且无论负重如何）。如果没有拥有或绑定任何船只，将显示
[code]"请先绑定一艘船"[/code]。[/]
[][b]吹号角表情[/b]：角色在 3 秒引导期间举起号角并播放
[code]"blowhorn"[/code] 表情，如果你移动或松开鼠标按钮，可以干净且即时地取消。[/]
[][b]静默取消与冲刺修复[/b]：提前松开或移动时，引导会干净且静默地取消，不会在屏幕上产生消息刷屏。解决了冲刺输入冲突（Shift+W），即奔跑时
[code]AltPlace[/code] 会触发动作栏的问题。[/]
[][b]诊断日志开关[/b]：号角和传送控制台消息现在通过该机制的 [b]"启用循环日志记录"[/b] 开关进行路由，默认情况下保持控制台完全干净。[/]
[/list]⚓ 物理与飞行稳定性
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-physics--flight-stability][/url]
[list]
[][b]锚定运动学锁定[/b]：
[list]
[]当载具已锚定（或在无玩家在船上且无人照管时自动锚定）时，载具的 Rigidbody 现在被锁定为运动学（
[code]m_body.isKinematic = true[/code]），所有速度归零。[/]
[]完全防止空中载具在玩家离开或离开渲染距离后漂移、下沉或坠入虚空（
[code]y < -5000m[/code]）。[/]
[]升起船锚时，无缝动态恢复完整物理模拟。[/]
[/list][/]
[][b]放宽飞行出水阈值[/b]：
[list]
[]将自动飞行到水面过渡的触发条件从
[code]waterLvl + 0.1f[/code] 放宽至
[code]waterLvl - 0.5f[/code]（需要约 0.5 米的船体进入水中）。[/]
[]防止海浪波峰和涌浪在贴近海面低飞时将空中载具过早踢出飞行模式。[/]
[/list][/]
[][b]修复飞行保持力[/b]：
[list]
[]修复了从空中载具上走下时会错误地绕过垂直高度保持力的问题。[/]
[/list][/]
[/list]☸️ 控制与舵轮
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#%EF%B8%8F-controls--steering-wheel][/url]
[list]
[][b]舵轮自动绑定[/b]：
[list]
[]为
[code]SteeringWheelComponent[/code] 添加了自愈式载具解析：通过层级结构、根对象、ZDO 父级 ID 或邻近度（<15 米）自动检测并链接到载具管理器，绑定
[code]InitializeControls()[/code]，并将舵轮注册到载具。[/]
[/list][/]
[][b]NullReferenceException 与交互修复[/b]：
[list]
[]解决了
[code]SteeringWheelComponent.GetHoverText()[/code] 和
[code]Hud.UpdateCrosshair[/code] 中的
[code]NullReferenceException[/code] 刷屏问题。[/]
[]修复了新放置或加载的舵轮没有悬停文本且无法被抓取或操纵的问题。[/]
[/list][/]
[/list]⛵ 风帆与建造
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-sails--construction][/url]
[list]
[][b]收缩风帆速度 0 修复（无限材料复制 Bug）[/b]：
[list]
[]修复了速度 0 / 停止 / 慢速 / 后退时收缩的风帆缩放至
[code]0f[/code] 的问题，该问题会导致
[code]BoxCollider[/code] 收缩至零体积并触发
[code]BoxCollider does not support negative scale or size[/code] 警告、
[code]Missing prefab hash: -1[/code] 错误以及拆解失败。[/]
[]对所有静止状态的风帆预制体强制实施
[code]0.01f[/code] 的最小 Y 轴缩放。[/]
[]在速度 0 时拆解风帆现在会掉落材料一次，并干净地摧毁该部件，不会产生错误或物品复制。[/]
[/list][/]
[][b]可配置风帆推进倍率[/b]：
[list]
[]添加了
[code]PropulsionConfig.SailPropulsionMultiplier[/code]（默认
[code]1.0f[/code]，范围
[code]0.05[/code] 至
[code]2.0[/code]），允许服务器管理员或玩家在不影响划船或倒退的情况下调整航行速度。[/]
[/list][/]
[/list]🌊 沉浸感与飞行/压舱调校
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-immersion--flightballast-tuning][/url]
[list]
[][b]波浪表面船体倾斜（可选启用）[/b]：
[list]
[]添加了自然波浪倾斜（
[code]PhysicsConfig.waterSurfaceTiltFactor[/code]，默认
[code]0.0f[/code] = 禁用，范围
[code]0.0[/code]–
[code]1.0[/code]，最大倾斜可达
[code]45°[/code]）。[/]
[]启用时，会平滑地将船体的俯仰和横滚与浮力计算期间采样的海浪表面进行对齐，消除海上僵硬的"桌面"外观。[/]
[]零额外射线检测（使用现有浮力点），并在飞行模式下自动禁用。[/]
[/list][/]
[][b]压舱 / 潜艇上浮与下潜速度[/b]：
[list]
[]将默认
[code]BallastClimbingOffset[/code] 调校为
[code]0.4f[/code]，以实现平滑、逼真的水下潜水和浮出水面。[/]
[]将
[code]FlightClimbingOffset[/code] 保持在
[code]2.0f[/code]，以实现灵敏的空中机动。[/]
[/list][/]
[/list]🚀 性能、同步与多人游戏
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-performance-sync--multiplayer][/url]
[list]
[][b]船只循环限速[/b]：
[list]
[]客户端部件同步（
[code]AllClientsSync()[/code]）现在被限制为最多每 2.0 秒运行一次，而不是每个 tick 持续运行。[/]
[]将载具部件与无关的陆地基地结构隔离：
[code]EnsurePiecesForVehicle()[/code] 严格针对具有有效船只偏移（
[code]MBPositionHash[/code]）或活跃木筏部件的部件，防止在大型沿海定居点附近出现大量延迟峰值。[/]
[/list][/]
[][b]服务器部件同步等待[/b]：
[list]
[]将默认
[code]ServerRaftUpdateZoneInterval[/code] 调校为
[code]3.0s[/code]（从
[code]5.0s[/code] 下调），为多人服务器提供平衡的默认值，且没有硬编码下限。[/]
[/list][/]
[][b]分段帧切片预算（≤ 2 毫秒）[/b]：
[list]
[]在
[code]Server_SyncAllVehiclePiecesToVehiclePosition[/code] 中将部件同步切片时间从每帧 10 毫秒减少到 2 毫秒，确保后台同步在可能导致可见帧率下降或微卡顿之前就让出。[/]
[/list][/]
[][b]移动阈值保护[/b]：
[list]
[]当船只锚定、停靠或移动距离小于 2.5 米时，限制部件 ZDO 更新。闲置和静止的船只消耗的后台 CPU 接近于零。[/]
[/list][/]
[][b]诊断循环日志与机制开关面板[/b]：
[list]
[]添加了轻量级
[code]LoopTracker[/code] 性能遥测。[/]
[]在机制开关 UI 中添加了 [b]"诊断与同步"[/b] 部分：
[list]
[][b]"循环日志"开关[/b]：打开/关闭控制台中的
[code][LoopPerf][/code] 诊断报告。[/]
[][b]"快速 MP 同步"开关[/b]：允许服务器管理员和船主动态切换紧凑的 1.0 秒多人部件同步（默认关闭）。[/]
[/list][/]
[/list][/]
[][b]传送清理[/b]：
[list]
[]移除传送到载具期间的左上角 HUD 消息弹窗，将部件分解详情保留在 BepInEx 日志中。[/]
[/list][/]
[/list][line]
[heading]🚀 更新日志 (v4.3.4)[/heading]
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-changelog-v434][/url]
舵轮与舵控
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#steering-wheel--helm-controls][/url]
[list]
[][b]优化悬停交互文本[/b]：
[list]
[]彻底重做了舵轮工具提示，明确说明：
[list]
[][code][Shift] 切换船锚[/code][/]
[][code][跳跃] 和 [蹲下] 调整高度/深度[/code][/]
[][code][跳跃]+[蹲下] 切换漂浮/飞行[/code][/]
[/list][/]
[]移除了过时的分隔线、废弃的教程提示、质量显示和调试提示，打造干净、沉浸式的界面。[/]
[/list][/]
[][b]跑步机动画与武器收纳修复[/b]：
[list]
[]修复了在移动中登上舵轮时角色在"跑步机"上原地奔跑的问题。[/]
[]登上舵轮时自动收纳已装备的武器和盾牌，使玩家双手放在舵轮上，干净地站立/蹲下。[/]
[/list][/]
[/list]绳梯人体工学
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#rope-ladder-ergonomics][/url]
[list]
[][b]默认即时自动攀爬[/b]：
[list]
[]将绳梯移动默认设为自动快速攀爬，无需手动切换。[/]
[]清理了悬停交互文本，移除了不必要的模式切换提示。[/]
[/list][/]
[/list]碰撞阻尼与海岸线物理
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#collision-damping--shoreline-physics][/url]
[list]
[][b]岩石撞击阻尼与防卡顿[/b]：
[list]
[]修复了船只像不受阻挡的电钻一样推平海岸线岩石并因碰撞日志刷屏而冻结游戏的问题。[/]
[]添加了动态碰撞冲量阻尼：撞击岩石时前进速度呈指数平滑衰减，并施加柔和的反向回弹速度。[/]
[/list][/]
[/list]存档清理保护与传送部件同步
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#save-cleanup-protection--teleport-piece-sync][/url]
[list]
[][b]存档清理污染防护[/b]：
[list]
[]保护
[code]ZDO.Reset[/code] 和
[code]RemoveZDO[/code] 钩子不被 Valheim Ashlands+ 存档清理周期（
[code]SaveCleanup[/code]）清除。[/]
[]在世界保存期间，活跃的世界 ZDO 被保留在内存中，防止所有船只部件从
[code]m_allPieces[/code] 和
[code]_zdoGuidLookup[/code] 中消失。[/]
[/list][/]
[][b]修复船上传送时原版部件加载[/b]：
[list]
[]修复了在漂浮模式下传送到船只时，床、箱子、工作台、墙壁和载具传送门保持不可见的问题。[/]
[]为
[code]ZDOMan.instance.m_objectsBySector[/code] 中的所有部件类型和
[code]m_portalObjects[/code] 中的传送门对象添加了通用扇区迁移。[/]
[]修复了床地图标记同步到过期区块位置的问题，即使床的 GameObject 未加载也会更新床的世界位置和扇区。[/]
[]添加了自愈式部件扫描器（
[code]EnsurePiecesForVehicle[/code]），以确保在任何情况下都能从
[code]ZDOMan[/code] 恢复部件。[/]
[/list][/]
[][b]传送前部件同步与部件分解日志[/b]：
[list]
[]在传送门到达之前同步所有部件坐标和扇区。[/]
[]对部件进行分类并将计数记录到 Unity 控制台和屏幕 HUD（左上角）：
[code][BoatPortal] Destination Vehicle ID {id} at {pos}: Found {total} pieces ({raftCount} ValheimRAFT, {vanillaCount} Vanilla, {modCount} OdinArchitect/Modded).[/code][/]
[]确保所有子 GameObject 在传送加载屏幕完成之前完全实例化（
[code][BoatPortal] Completed teleport to Vehicle {id}. Loaded pieces: {loaded}/{total}[/code]）。[/]
[/list][/]
[/list]整洁打包与模组卫生
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#clean-packaging--mod-hygiene][/url]
[list]
[][b]解耦 Newtonsoft.Json[/b]：
[list]
[]为遵守模组指南，从模组分发中移除了捆绑的
[code]Newtonsoft.Json.dll[/code]；添加了对
[code]ValheimModding-JsonDotNET-13.0.4[/code] 的官方依赖。[/]
[/list][/]
[][b]修剪废弃资源与文档[/b]：
[list]
[]移除了遗留的
[code]docs/[/code] 文件夹，并禁用了自定义风帆纹理目录（
[code]Assets/Logos[/code]、
[code]Assets/Patterns[/code]、
[code]Assets/Sails[/code]）。[/]
[/list][/]
[][b]清理问题模板[/b]：
[list]
[]从 GitHub 问题模板中移除了对
[code]YggdrasilTerrain[/code] 的过时引用。[/]
[/list][/]
[/list][line]
[heading]🚀 更新日志 (v4.3.3)[/heading]
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-changelog-v433][/url]
传送门与快速旅行全面革新
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#portal--fast-travel-overhaul][/url]
[list]
[][b]修复船到陆地传送门路由[/b]：解决了一个关键问题：在船上走过传送门会将玩家传送到船的中心，而不是连接到的陆地传送门。
[list]
[]修复了
[code]Player_Patch[/code] 中的部件放置逻辑，该逻辑错误地将岸边/陆地传送门设为附近载具的子对象（
[code]MBParentId[/code]）。[/]
[]添加了地形和放置距离验证，确保地面和陆地结构永远不会附着到载具上。[/]
[]在放置时清除射线检测部件缓存（
[code]PlayerLastRayPiece[/code]），防止过期的载具引用泄漏到后续建造中。[/]
[]修复了
[code]VehiclePiecesController.ForceUpdateAllPiecePositions[/code] 将船只和陆地传送门坐标覆盖为载具根对象的问题。[/]
[]优化了
[code]Teleport_Patch.DebouncedTeleportCoordinateUpdater[/code]，使其对陆地目的地传送门立即完成，无需不必要的 10 秒超时延迟或回退拖拽。[/]
[]在
[code]VehiclePiecesController.ActivatePiece[/code] 中添加了自动修复器，可检测现有的错位陆地传送门并将其从载具解绑，恢复到真实世界坐标。[/]
[/list][/]
[/list]床出生点与船只所有权
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#bed-spawn-point--ship-ownership][/url]
[list]
[][b]在移动的船上重生[/b]：修复了船上的床出生点，使玩家干净地在载具上的床上重生，而不是掉入海洋或默认到世界出生点。[/]
[][b]载具所有权持久化[/b]：解决了世界加载和玩家登录期间载具所有权问题，使载具在跨会话时保持可交互和响应。[/]
[/list]飞行模式与推进
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#flight-modes--propulsion][/url]
[list]
[][b]动态飞行模式[/b]：添加了不同的飞行动力学：
[list]
[][b]飞艇 / 悬浮模式[/b]：控制垂直升力，具有中性浮力。[/]
[][b]飞机模式[/b]：空气动力学俯仰、横滚和前进动量。[/]
[][b]漂浮 / 水面模式[/b]：标准水上船体浮力。[/]
[/list][/]
[][b]通用船锚切换（Shift 键）[/b]：在所有移动和飞行模式下，Shift 均可切换载具船锚，无论是否附有实体船锚部件。[/]
[/list]地图与导航
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#map--navigation][/url]
[list]
[][b]动态小地图图标[/b]：载具地图图标现在根据当前活跃的飞行/水面模式在船只、飞机和载具指示器之间动态切换。[/]
[][b]载具重命名支持[/b]：添加了默认命名和重命名支持，防止载具卡在
[code]V:Unnamed[/code] 状态。[/]
[/list][line]
[heading]🚀 更新日志 (v4.3.2)[/heading]
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#-changelog-v432][/url]
稳定性与多区域加载
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#stability--multi-zone-loading][/url]
[list]
[][b]修复快速旅行/传送门失步与部件分离[/b]：修复了一个关键问题：从船上传送走或在船附近加载会导致部件脱离、分离或抛出空引用。为
[code]Teleport_Patch[/code] 添加了安全超时和区域加载检查，在扇区初始化期间保护了
[code]WearNTear_Patch[/code] 和
[code]VehiclePiecesController[/code] 中的载具部件，并禁用了传送过渡时的剧烈原点重新居中。[/]
[][b]修复 FixedJoint 与 Rigidbody 移除错误[/b]：通过保证在移除 Rigidbody 之前所有附着的关节依赖项和连接体都被干净地解除挂钩并销毁，解决了
[code]TargetController[/code] 和
[code]VehiclePiecesController[/code] 中的 Unity 错误
[code]Can't remove Rigidbody because FixedJoint depends on it[/code]。[/]
[][b]多人游戏会话初始化保护[/b]：在远程服务器发送世界配置文件之前，保护了
[code]ZNet_WorldSession_Patches[/code] 中玩家加入/连接期间的世界 UID 查找。[/]
[][b]修正 ZDO.Load Harmony 签名[/b]：更新了
[code]Zdo_Patch[/code] 的补丁签名，以匹配 Valheim 1.0.12 / Unity 6
[code]Version.World[/code] 参数变更。[/]
[/list]风帆、推进与视觉效果
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#sails-propulsion--visuals][/url]
[list]
[][b]动态风帆收放[/b]：风帆现在根据移动状态逼真地收起和展开：
[list]
[][b]锚定、停止或速度 1（划船）[/b]：风帆完全收回/收起。[/]
[][b]速度 2（半帆）[/b]：风帆展开至 50% 高度。[/]
[][b]速度 3（全帆）[/b]：风帆展开至 100% 全帆。[/]
[/list][/]
[][b]自上而下风帆展开与横梁偏移[/b]：修正了垂直风帆缩放轴心，使风帆从横梁向下展开，而不是向甲板收缩。添加了校准的垂直偏移（
[code]SailVerticalOffset = 1.05[/code]、
[code]KarveSailVerticalOffset = 2.15[/code]），以与木筏和 Karve 桅杆完美对齐。[/]
[][b]强制实施最低风帆推进力[/b]：设置了
[code]10[/code]（
[code]MinSailSpeed[/code]）的最低基线推进速度，使带有船体的船只即使只有一面帆也能舒适移动。[/]
[][b]限制风暴风速[/b]：将默认
[code]MaxLinearVelocity[/code] 从 100 降低至 50 米/秒，以防止在严重风暴期间出现无法控制的失控速度和物理失稳。[/]
[][b]从锤子中禁用有故障的风帆与桅杆[/b]：从建造菜单中移除了自定义方形帆、三角形帆和自定义桅杆 1-3，以防止物理故障，同时保持现有已放置的预制体完全可用。[/]
[/list]可用性与生活质量
[url=https://github.com/JNDEV0/ValheimRAFT-zolantrisFork-1.0.12#usability--quality-of-life][/url]
[list]
[][b]自动绳梯部署[/b]：当船只锚定、悬停或静止（
[code]speed <= 0.01[/code]）时，绳梯现在会自动放下，确保游泳的玩家始终可以爬回船上，无需手动抛锚。在活跃飞行或航行期间，绳梯会干净地收回。[/]
[][b]舵轮锚定警报[/b]：在船只锚定时尝试前进（W）或后退（S），现在会在舵轮舵柄正上方显示浮动的黄色
[code]"请先升起船锚"[/code] 警报。[/]
[*][b]字体与本地化改进[/b]：在
[code]TMPProHelpers[/code] 中注册了所有活跃的游戏字体（AveriaSerifLibre、Norse）以及动态生成的 Arial SDF Unicode 回退字体，以防止缺失字形错误。清理了过时的外语翻译包，并添加了缺失的本地化键