Vivecraft史诗战斗兼容性补丁

Vivecraft Epic Fight 兼容性补丁

Vivecraft Epic Fight 兼容性补丁是 Vivecraft 和 Epic Fight 在 Minecraft Forge 1.20.1 上的非官方附加组件。

它恢复了在 Vivecraft VR 中可能丢失的与攻击相关的根运动。从 0.3.1 版本开始，它还增加了一个可配置的混合防护，以减少向前移动的攻击将玩家带入敌方生物体内的情况。

本项目与 Vivecraft、Epic Fight、Minecraft、Mojang Studios 或 Microsoft 无关联，也未获得其官方支持。

重要 VR 运动警告

此模组恢复了由 Epic Fight 动画定义的移动。某些攻击可能会快速移动 VR 摄像机，并可能导致晕动病、头晕、恶心、眼睛疲劳、头痛或迷失方向。

如果感到不适，请立即停止使用该模组。使用此模组风险自负。

功能

根运动恢复

旨在让玩家向前移动的 Epic Fight 攻击可以在 Vivecraft VR 中再次移动玩家。

该模组不会添加攻击或替换动画。它只恢复 Epic Fight 及兼容附加组件已定义的移动。

混合穿透防护 — 0.3.1

0.3.1 版本为向前移动的攻击增加了一个混合系统：

• 在玩家过于深入附近生物体内之前将其停下。
• 轻微推动生物向前，以保持攻击动量。
• 当目标无法被推动时，回退为仅停止玩家。
• 可以尊重生物的击退抗性。
• 在服务器端验证并应用生物移动。

防护和推动行为默认启用，并且可以单独配置。

版本要求

0.2.0 及更早版本

0.2.0 及更早版本仅为客户端模组。

仅将模组安装在客户端的 mods 文件夹中。这些版本恢复根运动，但不包含服务器控制的穿透防护。

0.3.1 及更高版本

0.3.1 及更高版本必须同时安装在客户端和专用服务器上。

Vivecraft 仍仅在客户端需要。Epic Fight 和此补丁在两端都需要。

不要将 0.2.0 和 0.3.1 一起安装。

仅根运动

要仅使用原始的移动恢复功能：

• 使用 0.2.0 版本作为仅客户端模组，或
• 使用最新版本并设置 enabled = false。

禁用防护不会禁用根运动恢复。

配置

首次启动后创建：

config/epicvivecraftrootmotion-common.toml

默认的 0.3.1 设置：

[passthrough_guard]
enabled = true
player_stop_distance = 0.5
push_enabled = true
push_trigger_distance = 0.7
push_distance = 0.05
respect_knockback_resistance = true
max_pushable_knockback_resistance = 0.9

设置项

enabled 启用穿透防护。设置为 false 则仅进行根运动恢复。

player_stop_distance 玩家与目标之间保持的最小碰撞箱间距。默认值：0.5

push_enabled 启用服务器控制的生物推动。默认值：true

push_trigger_distance 当碰撞箱间隙低于此值时开始请求推动。默认值：0.7

push_distance 每次接受的推动请求所应用的距离。默认值：0.05

respect_knockback_resistance 防止高击退抗性的生物被推动。默认值：true

max_pushable_knockback_resistance 仍可被推动的最高抗性值。默认值：0.9

安装

1. 备份你的世界、玩家数据、服务器数据、配置文件和模组列表。
2. 安装 Minecraft Forge 1.20.1、Epic Fight 和 Vivecraft。
3. 将 Vivecraft-EpicFight-CompatibilityPatch-0.3.1.jar 放入客户端的 mods 文件夹。
4. 对于 0.3.1 或更高版本，将相同的 JAR 放入专用服务器的 mods 文件夹。
5. 先在临时世界中测试模组。

推荐的配套模组

为了获得更一致的第一人称 VR 体验：

• Vivecraft Epic Fight 摄像机偏移修复
• Vivecraft Epic Fight 物品渲染修复

这些附加组件是可选的，不包含在内。

兼容性

为以下环境创建：

• Minecraft Forge 1.20.1
• Forge 47.4.22 或更高版本
• Epic Fight 20.14.17
• Vivecraft 1.20.1-1.3.15

不保证其他版本、自定义动画包、Epic Fight 附加组件、摄像机模组和移动模组能够正常工作。

开发、支持与免责声明

这是一个独立的、AI 辅助的社区项目。在调查、编码、调试和开发过程中使用了 AI 工具。

我不是经验丰富的程序员，可能无法修复每一个崩溃、冲突、同步问题或未来的更新问题。错误报告和日志可能会有所帮助，但不保证提供支持或修复。

在安装、更新、移除或配置此模组之前，请务必创建完整的备份。

该模组按“原样”提供，不附带任何保证。使用即表示您接受所有风险，包括意外移动、崩溃、模组冲突、数据丢失、世界损坏、服务器问题以及由 VR 运动引起的身体不适。

请不要就该补丁的具体问题联系 Vivecraft 或 Epic Fight 的开发人员寻求支持。