Vivecraft Eureka 相机修复

Vivecraft Eureka 相机修复

修复在Vivecraft中驾驶Eureka船只时摄像机的位置，防止视角穿入方块。

Vivecraft Eureka 相机修复

重要提示： 在安装、更新或移除本模组之前，请务必备份您的世界。 使用本模组风险自负。

简介

Vivecraft Eureka 相机修复（VECF）是一个非官方的客户端兼容性扩展，适用于：

  • Vivecraft
  • Eureka! Ships!
  • Valkyrien Skies

专为 Minecraft Forge 1.20.1 设计。

VECF 最初是为了修复在骑乘或驾驶 Eureka 船只时出现的 Vivecraft VR 相机问题而创建的。

在没有此修复的情况下，骑乘时 VR 相机位置可能过低，导致玩家的视野卡入方块或嵌入船体内部。

自 1.1.0 版本起，VECF 还包含了对骑乘状态 HUD 和本地玩家模型渲染的重大改进。

功能

  • 修正骑乘 Valkyrien Skies 船只坐骑时的 Vivecraft 相机位置
  • 帮助防止 VR 相机卡入船只方块
  • 使骑乘状态下 Vivecraft HUD 跟随左手控制器
  • 恢复骑乘 Eureka 船只时的可见玩家模型
  • 骑乘时使用标准 Minecraft 玩家渲染路径
  • 允许 Epic Fight 玩家模型在骑乘时正常渲染
  • 修正骑乘状态玩家模型的垂直位置
  • 下船后自动恢复正常的 Vivecraft 渲染
  • 包含可配置的回退与诊断选项
  • 仅客户端
  • 不修改 Eureka 或 Valkyrien Skies 的船只机制

VECF 1.1.0 新内容

早期版本尝试直接稳定 Vivecraft 的全身体感 VR 玩家模型。

这种方法并不可靠，因为 Vivecraft 的 VR 身体姿态与 Valkyrien Skies 的船只渲染使用不同的坐标系。

VECF 1.1.0 采用了更简单的方案。

当本地玩家骑乘 Valkyrien Skies 的 ShipMountingEntity 时，VECF 会绕过 Vivecraft 对该玩家的 VRPlayerRenderer，转而使用正常的 Minecraft 玩家渲染路径。

这意味着：

  • 骑乘时可以显示原版玩家模型
  • Epic Fight 模型也可以在骑乘时渲染
  • Vivecraft 的 VR 输入和追踪保持有效
  • 下船后自动恢复 Vivecraft 渲染

骑乘时还会应用一个小的垂直模型修正，以防止玩家模型部分陷入船体地板。

骑乘 HUD 修复

VECF 1.1.0 还引入了完善的 HUD 修复。

VECF 不再默认隐藏 HUD，而是将骑乘状态下的 Vivecraft HUD 重定向到其原生的、基于控制器的 HAND 渲染路径。

现在的默认行为是：

mountedHudMode = "LEFT_HAND"

HUD 在骑乘船只时跟随左手控制器。

这避免了之前骑乘 HUD 行为中出现的剧烈抖动和漂移问题。

旧的 HUD 隐藏系统仍然作为回退选项保留。

配置

配置文件：

config/vecf-client.toml

默认设置：

[camera_fix]

mode = "MANUAL_OFFSET"

offsetX = 0.0
offsetY = 1.8
offsetZ = 0.0

playerModelFix = true

mountedPlayerModelMode = "VANILLA"

mountedHudMode = "LEFT_HAND"

diagnostics = false
diagnosticIntervalSeconds = 5

相机模式

MANUAL_OFFSET

推荐使用，且默认启用。

保留 Valkyrien Skies 的骑乘相机行为，并应用配置的相机偏移量。

经过测试的默认垂直修正值为：

offsetY = 1.8

VIVECRAFT_POSITION

直接使用 Vivecraft 的相机位置。

FULL_VIVECRAFT_POSE

同时使用 Vivecraft 的相机位置和头显朝向。

在船只旋转时，这可能会产生更明显的移动感。

DISABLED

禁用 VECF 的相机修正。

HUD 和玩家模型功能分别独立控制。

骑乘玩家模型模式

VANILLA

VECF 1.1.0 中的默认模式。

绕过了 Vivecraft 对骑乘状态本地玩家的 VR 玩家渲染器，并允许正常的 Minecraft 玩家渲染路径继续运行。

这是推荐模式。

它也允许诸如 Epic Fight 等兼容动画系统使用它们正常的玩家渲染路径。

ROOM_LOCAL

旧的实验性 Vivecraft 全身修正模式。

主要为测试和兼容性目的而保留。

NORMAL

保持 Vivecraft 正常的 VR 玩家模型渲染不变。

HIDDEN

骑乘时隐藏本地玩家模型。

这是基于旧的 0.3.9 行为保留的回退选项。

骑乘 HUD 模式

LEFT_HAND

VECF 1.1.0 中的默认模式。

骑乘时使用 Vivecraft 原生的控制器 HAND HUD 路径。

HUD 跟随左手控制器。

NORMAL

保持 Vivecraft 配置的 HUD 行为不变。

HIDDEN

使用 Minecraft 的 F1 风格 HUD 隐藏行为，在骑乘时暂时隐藏普通 HUD。

下船后恢复之前的 HUD 状态。

此模式作为回退选项保留。

诊断

diagnostics = false

启用后，VECF 会将附加信息写入：

logs/latest.log

诊断信息可帮助识别：

  • 船只坐骑检测
  • 当前玩家模型模式
  • 骑乘 HUD 模式
  • Vivecraft 自渲染状态
  • 渲染器绕过活动
  • 相机修正行为

diagnosticIntervalSeconds 控制诊断信息的写入频率。

安装

  1. 安装所需版本的 Forge、Vivecraft、Valkyrien Skies 和 Eureka。
  2. 移除旧版本的 vivecraft_vs_camera_fix 和 VECF。
  3. 将 VECF-1.1.0.jar 放入客户端的 mods 文件夹。
  4. 启动 Minecraft。
  5. VECF 将生成 config/vecf-client.toml。

如果您之前使用过实验性的 VECF 1.0.0 或 1.1.0 阶段版本，建议删除一次 vecf-client.toml，以便重新生成最新的默认设置。

旧的：

config/vivecraft_vs_camera_fix-client.toml

将不再使用。

测试环境

VECF 1.1.0 的开发与测试环境为：

  • Minecraft 1.20.1
  • Minecraft Forge 47.4.22
  • Vivecraft 1.20.1-1.3.15 Forge
  • Valkyrien Skies 2.4.11
  • Eureka! Ships! 1.6.3

VECF 也在包含 Epic Fight 的环境中进行了测试。

其他版本可能可以运行，但尚未经过全面验证。

已知限制

  • VECF 目前不修复上下船时可能发生的视角方向变化
  • 骑乘玩家模型的高度修正针对所测试的 Eureka 环境进行了调整
  • 玩家缩放或高度修改的动画系统可能需要额外的兼容性工作
  • VANILLA 模式将本地骑乘玩家从 Vivecraft 的全身体感 VR 渲染器切换为标准渲染
  • ROOM_LOCAL 仍处于实验阶段
  • 大型整合包可能包含未经 VECF 测试的渲染修改
  • 未来 Vivecraft、Valkyrien Skies 或 Eureka 版本的内部变更可能会导致兼容性问题

从 0.3.9 更新

VECF 1.1.0 是一次重大更新，相对于：

vivecraft_vs_camera_fix-0.3.9-phase1-hotfix1.jar

模组现在使用：

模组名称：Vivecraft Eureka Camera Fix
短名称：VECF
模组 ID：vecf
文件名：VECF-1.1.0.jar
配置文件：config/vecf-client.toml

安装 VECF 1.1.0 之前，请移除旧的 JAR 文件。

AI 辅助

本项目借助人工智能工具开发。

AI 用于编程辅助、代码审查、调试、兼容性分析、文档编写和项目组织。

整体设计、游戏内测试、验证、配置决策和发布决策均由项目作者完成。

支持

本项目是为了解决我自己的 Minecraft VR 环境中遇到的兼容性问题而创建的。

我不是专业的 Minecraft 模组开发者，因此可能无法诊断或修复所有不兼容问题。

报告问题时，请提供：

  • Minecraft 版本
  • Forge 版本
  • Vivecraft 版本
  • Valkyrien Skies 版本
  • Eureka 版本
  • VECF 版本
  • 相关配置设置
  • latest.log
  • 问题发生时的描述

在复现问题前启用 diagnostics 可以提供更多有用的信息。

备份与免责声明

在安装、更新、移除或使用此模组之前，请务必备份您的世界。

每个整合包都不尽相同，可能会出现意外的兼容性问题。

作者对因使用此模组而导致的存档损坏、进度丢失、物品丢失、存档数据损坏、崩溃、渲染问题、服务器问题或其他损害不承担任何责任。

请完全自担风险使用 VECF。

非官方扩展免责声明

VECF 是一个非官方的社区兼容性扩展。

它与以下软件的开发者或所有者没有任何关联，也未获得其认可：

  • Vivecraft
  • Valkyrien Skies
  • Eureka! Ships!
  • Epic Fight
  • Mojang Studios
  • Microsoft