Vivecraft Epic Fight Compatibility Patch

Vivecraft Epic Fight Compatibility Patch is an unofficial add-on for Vivecraft and Epic Fight on Minecraft Forge 1.20.1.

It restores attack-related root motion that may be lost in Vivecraft VR. Starting with version 0.3.1, it also adds a configurable hybrid guard to reduce cases where forward-moving attacks carry the player through enemy mobs.

This project is not affiliated with or officially supported by Vivecraft, Epic Fight, Minecraft, Mojang Studios, or Microsoft.

Important VR Motion Warning

This mod restores movement defined by Epic Fight animations. Some attacks may move the VR camera rapidly and can cause motion sickness, dizziness, nausea, eyestrain, headaches, or disorientation.

Stop using the mod immediately if you feel unwell. Use this mod at your own risk.

Features

Root Motion Restoration

Epic Fight attacks that are intended to move the player forward can move the player again in Vivecraft VR.

The mod does not add attacks or replace animations. It restores movement already defined by Epic Fight and compatible add-ons.

Hybrid Pass-Through Guard — 0.3.1

Version 0.3.1 adds a hybrid system for forward-moving attacks:

• Stops the player before moving too deeply into a nearby mob.
• Slightly pushes the mob forward to preserve attack momentum.
• Falls back to player stopping when the target cannot be pushed.
• Can respect mob knockback resistance.
• Validates and applies mob movement on the server.

The guard and push behavior are enabled by default and can be configured separately.

Version Requirements

0.2.0 and Earlier

Versions up to 0.2.0 are client-side only.

Install the mod only in the client mods folder. These versions restore root motion but do not include the server-controlled pass-through guard.

0.3.1 and Later

Version 0.3.1 and later must be installed on both the client and dedicated server.

Vivecraft is still only required on the client. Epic Fight and this patch are required on both sides.

Do not install 0.2.0 and 0.3.1 together.

Root Motion Only

To use only the original movement restoration:

• Use version 0.2.0 as a client-side-only mod, or
• Use the latest version and set enabled = false.

Disabling the guard does not disable root-motion restoration.

Configuration

Created after the first launch:

config/epicvivecraftrootmotion-common.toml

Default 0.3.1 settings:

[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

Settings

enabled Enables the pass-through guard. Set to false for root-motion restoration only.

player_stop_distance Minimum hitbox spacing kept between the player and target. Default: 0.5

push_enabled Enables server-controlled mob pushing. Default: true

push_trigger_distance Starts requesting a push below this hitbox gap. Default: 0.7

push_distance Distance applied per accepted push request. Default: 0.05

respect_knockback_resistance Prevents highly knockback-resistant mobs from being pushed. Default: true

max_pushable_knockback_resistance Highest resistance value that may still be pushed. Default: 0.9

Installation

1. Back up your world, player data, server data, configuration files, and mod list.
2. Install Minecraft Forge 1.20.1, Epic Fight, and Vivecraft.
3. Place Vivecraft-EpicFight-CompatibilityPatch-0.3.1.jar in the client mods folder.
4. For 0.3.1 or later, place the same JAR in the dedicated server mods folder.
5. Test the mod in a temporary world first.

Recommended Companion Mods

For a more consistent first-person VR experience:

• Vivecraft Epic Fight Camera Offset
• Vivecraft Epic Fight Item Render Fix

These add-ons are optional and are not included.

Compatibility

Created for:

• Minecraft Forge 1.20.1
• Forge 47.4.22 or later
• Epic Fight 20.14.17
• Vivecraft 1.20.1-1.3.15

Other versions, custom animation packs, Epic Fight add-ons, camera mods, and movement mods are not guaranteed to work.

Development, Support, and Disclaimer

This is an independent, AI-assisted community project. AI tools were used during investigation, coding, debugging, and development.

I am not an experienced programmer and may be unable to fix every crash, conflict, synchronization issue, or future update problem. Bug reports and logs may help, but support and fixes are not guaranteed.

Always create a complete backup before installing, updating, removing, or configuring this mod.

The mod is provided as-is without warranty. By using it, you accept all risks, including unexpected movement, crashes, mod conflicts, data loss, world corruption, server problems, and physical discomfort caused by VR motion.

Please do not contact the Vivecraft or Epic Fight developers for support relating specifically to this patch.