Vivecraft Epic Fight Item Render Fix

Overview

Vivecraft Epic Fight Item Render Fix is a small client-side compatibility mod for Minecraft Forge 1.20.1.

This mod was specifically created for players who use Epic Fight while playing Vivecraft in first-person view with the full player model visible.

In this setup, Epic Fight renders the weapon on its custom animated player model, while Vivecraft may also render the same held item at the VR controller or hand position. This can cause the weapon or offhand item to appear twice.

This mod hides only the Vivecraft-rendered held items while preserving Epic Fight's custom player model and weapon rendering.

Why I Made This Mod

I created this mod because I wanted to play Epic Fight in Vivecraft while using the following setup:

Vivecraft VR mode
First-person view
First-person player model enabled
Epic Fight battle mode enabled

When using this combination, the player's normal VR arms are already hidden while Epic Fight's custom animated model is displayed.

However, the items rendered at the Vivecraft controller positions could remain visible. As a result, the same weapon could appear both on the Epic Fight model and in front of the player's VR hands.

The same issue could also affect items held in the offhand.

The purpose of this mod is to remove those duplicate Vivecraft-rendered items without disabling or modifying Epic Fight's own custom model rendering.

Features

Hides the duplicate Vivecraft-rendered main-hand item
Hides the duplicate Vivecraft-rendered offhand item
Keeps Epic Fight's custom player model visible
Keeps Epic Fight's custom weapon rendering intact
Designed for Vivecraft first-person gameplay with the player model enabled
Only applies while Epic Fight battle mode is active by default
Only applies during VR gameplay by default
Main-hand and offhand behavior can be configured separately
Client-side only
Does not modify inventories, held items, combat mechanics, networking, or world data

Intended Setup

This mod is intended for the following combination:

Vivecraft in VR mode
First-person perspective
First-person player model rendering enabled
Epic Fight battle mode

This mod may not provide any visible benefit if the first-person player model is disabled or if Epic Fight is not being used.

Configuration

The configuration file is generated in:

config/vivecraft_epic_item_render_fix-client.toml

Available settings:

[general]
enabled = true
hideMainHandItem = true
hideOffhandItem = true
battleModeOnly = true
vrOnly = true
firstPersonOnly = true
debugLogging = false

Minecraft must be restarted after changing the configuration.

Requirements

Minecraft 1.20.1
Forge
Vivecraft
Epic Fight

This is a client-side mod and normally does not need to be installed on a dedicated server.

AI-Assisted Development

This mod was created with the assistance of AI.

I am not an experienced programmer, and I may not have the technical knowledge required to diagnose or fix every crash, incompatibility, or unexpected issue.

I apologize in advance if I am unable to resolve a problem.

Bug reports and log files may still be helpful, but I cannot guarantee that every issue will be investigated or fixed.

Important Warning

Please create a backup of your world and important game files before installing or updating this mod.

Although this mod is designed to affect only client-side rendering, heavily modded Minecraft environments can behave unpredictably due to version differences, configuration changes, and interactions between mods.

Use this mod at your own risk.

I am not responsible for corrupted worlds, lost items, damaged game data, crashes, or any other problems caused directly or indirectly by using this mod.