Valkyrien Skies 2 – Unofficial

Valkyrien Skies 2 — 非官方版 · v3.2.0

非官方移植版 — 与 Valkyrien Skies 团队无关联，也未获其认可。 完善度可能不如官方 VS；使用风险自负，且不提供官方支持。源码与问题反馈：<VS2 repo>。原模组： https://valkyrienskies.org/

MC 1.20.1 · 1.21.1 · 1.21.11 — 仅支持 Fabric Sodium 0.8.12 或最新版 — 1.21.11 · Sodium 0.6.9 — 1.21.1 · Sodium 0.5.13 — 1.20.1 船只建造功能需搭配对应版本的 Eureka (VS2)。

本移植版包含以下全部功能 — 列表中的大部分功能已包含在最新官方版 VS2 中，另有少数功能由我自行移植。

★ = 本移植版新增功能。
🛠 = 官方版中已有的问题，我尝试在这些移植版本中解决。官方版本发布后，解决方案可能会有所变化！
⚓ = 官方版本已包含的功能！

渲染与光影

• ⚓ 使用 Sodium + Iris 光影时可渲染船只 — 船只地形通过缓存的分区 GPU 网格，使用光影包自身的着色程序进行绘制（法线贴图/POM效果与世界一致）；视野中有大型或多艘船时，帧率大约提升 2 倍。虽然在 1.21.11 中很快会因 Blaze3D 而略有不同（1.21.5 更改了渲染系统和 API）。
• ⚓ 船只阴影 — 使用光影时，船只可投射、接收自身阴影。
• ⚓ 发光与材质（PBR）方块 — 海晶灯、萤石、熔岩等会发光、照亮周围环境，并在光影下正确遮挡。
• ⚓ 植被摇曳 — 船上的树叶、草和作物会在光影下摇曳。
• ⚓ 实体受船只光照影响 — 夜间玩家、生物和盔甲架会受到船上火把/灯笼的照亮，不再陷入黑暗。VS2 团队已经在开发更好的方案，因此官方版本发布后，此效果会有所不同。
• 玻璃连接纹理 / CTM — Fusion 风格的连接纹理可延伸至船只方块。
• ★ 延长船只渲染距离 — 远处的船只在超出原版渲染距离后仍然可见（默认 2048 格，可配置）。
• ★ 船只镜头缩放 — 滚动鼠标滚轮可拉近或拉远骑乘时的第三人称镜头（最小/最大值可配置）；其他情况下不会影响快捷栏滚动。

移动与物理

• ★ 海浪起伏与摇晃 — 船只会随波浪上下起伏、俯仰和横摇，乘客则稳稳站在甲板上。此功能原生支持 VS2（无需 Physics Mod）；大型船体比小型船只摇晃更轻微；可在“Ocean Waves”配置项中调整。
• ⚓& 🛠 跳跃或走下船只时保留船只对玩家的影响 — 离开船只范围前，你会像滑翔翼滑翔一样随船移动，而不是直接掉落；创造模式飞行时也会随船移动。
• ★ 可配置的影响范围边界 — 默认情况下，随船移动范围会从六个面各向外延伸几格；可在游戏内实时或通过配置分别调整各面的范围（0 = 与船体边界完全一致）。
• 🛠 不再从船尾被甩飞 — 站在高速船只尾部时，不会再滑到船体下方并被甩下甲板（边缘设有小幅容差，因此脚稍微伸出船舷仍会被视为站在甲板上）。
• ★ 船只可驶过海带与海草 — 移动中的船体只会清除与其实际接触的海带（不掉落物品；海草不受影响；可切换 shipsDestroyPlants）。

骑乘、镜头与控制

• ★ & 🛠 在行驶中的船上重新登录不会让你摔死 — 你会重新出现在下线时所在位置的隐形座位上（按 SHIFT 站起，不会受到摔落伤害；站起前使用船只第三人称视角），而不是穿过尚未加载的甲板掉下去。
• ★ 坐下快捷键（X） — 按 X 坐在你脚下的船上；按 SHIFT 重新站起。
• ★ 站立操舵姿势 — 即使安装了 EMF / Fresh Animations，驾驶员也会直立站在船舵旁。
• ★ F5 船只视角循环 — 第一人称 → 第三人称 → 沉浸式船只视角 → Shoulder Surfing（如果已安装）。
• 手柄操舵 — 完整支持 Controlify。
• 🛠 下船不摔落 / 上船不冻结 — 座位会在每个游戏刻同步你的状态，因此不会出现航行约 10 秒后玩家仍冻结在最初上船的位置，也不会在长时间下降后下船时受到摔落伤害。

实体与世界

• 🛠 生物与村民可在船上活动 — 它们会在甲板上寻路、追逐、逃跑、寻找工作站点，并按时睡觉和醒来；即使船只移动也会保持同步（不会滑动或橡皮筋式回弹）。
• 🛠 实体不会穿过船只掉落 — 生物、动物和盔甲架在世界加载、组装和拆解期间都会留在原处；盔甲架会固定在甲板上随船体旋转。
• 🛠 烟花不会在甲板上冻结 — 火箭会保持在世界坐标中，并正常燃尽 / 爆炸。
• ★ 船只持续模拟 — 启用保持活动的船只即使超出你的模拟距离，也会继续运行物理模拟、巡航和机械装置。
• 恢复原版 VS 行为：1.21.11 曾悄然破坏的功能现已恢复，包括生物在船上的寻路、拴绳、船上及周围的雨雪效果、方块质量提示、禁飞自动踢出、船只感知下船，以及船上流体逃逸设置。

命令

★ = 此移植版本新增或更改的内容。其余 /vs 命令均为 Valkyrien Skies 2 的标准命令。
⚓ = 官方版本已收录！

影响范围与视角

• ★ /vs expand-influence <amount> <face> — 在游戏中即时扩大某一面的影响范围边界（上 / 下 / 左 / 右 / 前 / 后）。
• ★ /vs contract-influence <amount> <face> — 缩小某一面的边界（不会缩到船体以内）。
• ★ /vs influence-border <true|false> — 将每艘船的影响范围边界显示为蓝色线框。

渲染开关

• ★ /vs ship-shadows <true|false> — 切换光影下的船只阴影。
• ★ /vs ship-emissive <true|false> — 切换船上方块的发光 / 材质渲染。

船只管理

• ⚓ /vs rename <ship> <name> — 重命名飞船。
• ⚓ /vs scale <ship> <factor> — 等比缩放飞船。
• ⚓ /vs delete <ships> [deleteBlocks] — 删除飞船。
• ⚓ /vs dry <ships> — 清除飞船上的所有水。
• ★ /vs desnow <ships> — 清除组装后残留的零散雪层（保险措施；组装过程本身会清除它们）。
• ⚓ /vs remass <ships> — 重新计算飞船的质量。
• ⚓ /vs splitting <ships> <bool> — 自动拆分飞船：将不相连的部分分离为独立飞船（开启）或保持为一个整体（关闭）。
• ⚓ /vs set-static <ships> <bool> — 将飞船冻结为静态、不可移动的结构（无物理效果；即使你走远也会保持位置）。
• ★ /vs set-keep-active <ships> <bool> — 即使没有玩家在模拟距离内，也让飞船保持模拟。
• ⚓ /vs teleport <ships> <pos> [angles] [vel] — 传送飞船。
• ⚓ /vs get-ship · /vs get-air · /vs get-gravity — 查询你所在位置的管理飞船 / 空气 / 重力。

物理后端

• ⚓ /vs backend engine <krunch|physx|jolt> — 切换模拟飞船的物理引擎（影响性能 + 物理手感）。
• ⚓ /vs backend lodDetail <n> — 飞船碰撞的物理细节级别（−1 = 完整细节；数值越高 = 细节越多，开销越大）。
• ⚓ /vs perf-test spawn-ship-cube <size> — 生成一个测试飞船立方体用于基准测试。

来自 Eureka 附加模组 （若已安装）

• ★ /vs eureka-assembler <floater|balloon> <true|false> — 切换 Eureka 组装器自动填充。
• ★ /vs get-ship-weight <ship> <floater|balloon> — 显示飞船的质量 + 所需的漂浮物/气球数量。

兼容性与要求

• 仅限 Fabric — 不支持 NeoForge。
• 需要 Sodium 以渲染飞船地形（它会替换区块渲染器）。最新版 Sodium 可用。
• 需搭配对应版本的 Eureka (VS2) 构建以进行飞船建造。
• 软兼容 Fresh Animations / EMF （舵轮姿势）和 Shoulder Surfing Reloaded （F5 视角循环）。已测试与 Iris + Eclipse 光影和 Voxy 兼容（飞船可在 Voxy 区块内渲染）。
• 第三方模组兼容（机械动力、CC:Tweaked、咒法编程、沉浸式传送门、基于 Flywheel 的模组等）目前 尚未 包含 — 它们都还没有 1.21.11 构建。之后会添加对 1.20.1 和 1.21.1 的支持！

已知问题

• 飞船上的水仍会溢出边缘并落到 y≈64 处才停止（无害的临时措施；下落途中会穿过地形）。
• 多人游戏几乎未经测试，大部分测试都是在单人游戏中进行的。