Vivecraft Eureka Camera Fix

Important: Always back up your world before installing, updating, or removing this mod. Use this mod entirely at your own risk.

About

Vivecraft Eureka Camera Fix, or VECF, is an unofficial client-side compatibility add-on for:

• Vivecraft
• Eureka! Ships!
• Valkyrien Skies

Designed for Minecraft Forge 1.20.1.

VECF was originally created to fix a Vivecraft VR camera issue that occurs while riding or piloting Eureka ships.

Without the fix, the VR camera may be positioned too low while mounted, causing the player's view to clip into blocks or become embedded inside the ship.

Since version 1.1.0, VECF also includes major improvements for the mounted HUD and locally rendered player model.

Features

• Corrects the Vivecraft camera position while riding Valkyrien Skies ship mounts
• Helps prevent the VR camera from clipping into ship blocks
• Makes the Vivecraft HUD follow the left controller while mounted
• Restores visible player models while riding Eureka ships
• Uses the normal Minecraft player-rendering path while mounted
• Allows Epic Fight player models to render normally while mounted
• Corrects the vertical position of the mounted player model
• Automatically restores normal Vivecraft rendering after dismounting
• Includes configurable fallback and diagnostic options
• Client-side only
• Does not modify Eureka or Valkyrien Skies ship mechanics

What's New in VECF 1.1.0

Earlier versions attempted to stabilize Vivecraft's full-body VR player model directly.

This approach was unreliable because Vivecraft's VR body pose and Valkyrien Skies ship rendering use different coordinate systems.

VECF 1.1.0 uses a simpler approach.

While the local player is riding a Valkyrien Skies ShipMountingEntity, VECF bypasses Vivecraft's VRPlayerRenderer for that player and allows the normal Minecraft player-rendering path to be used instead.

This means:

• Vanilla player models can be displayed while mounted
• Epic Fight models can also render while mounted
• Vivecraft VR input and tracking remain active
• Vivecraft rendering is automatically restored after dismounting

A small vertical model correction is also applied while mounted to prevent the player model from appearing partially buried in the ship floor.

Mounted HUD Fix

VECF 1.1.0 also introduces a proper HUD fix.

Instead of hiding the HUD by default, VECF redirects the mounted Vivecraft HUD to its native controller-based HAND rendering path.

The default behavior is now:

mountedHudMode = "LEFT_HAND"

The HUD follows the left controller while riding the ship.

This avoids the severe shaking and drifting that occurred with the previous mounted HUD behavior.

The older HUD-hiding system is still available as a fallback.

Configuration

Configuration file:

config/vecf-client.toml

Default settings:

[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

Camera Modes

MANUAL_OFFSET

Recommended and enabled by default.

Keeps the Valkyrien Skies mounted-camera behavior and applies the configured camera offset.

The tested default vertical correction is:

offsetY = 1.8

VIVECRAFT_POSITION

Uses the Vivecraft camera position directly.

FULL_VIVECRAFT_POSE

Uses both the Vivecraft camera position and HMD orientation.

This may produce more noticeable movement while the ship rotates.

DISABLED

Disables VECF camera correction.

HUD and player-model features are controlled separately.

Mounted Player Model Modes

VANILLA

Default in VECF 1.1.0.

Bypasses Vivecraft's VR player renderer for the mounted local player and allows the normal Minecraft player-rendering path to continue.

This is the recommended mode.

It also allows compatible animation systems such as Epic Fight to use their normal player-rendering path.

ROOM_LOCAL

Legacy experimental Vivecraft full-body correction mode.

Kept mainly for testing and compatibility purposes.

NORMAL

Leaves Vivecraft's normal VR player-model rendering unchanged.

HIDDEN

Hides the local player model while mounted.

This is retained as a fallback option based on the older 0.3.9 behavior.

Mounted HUD Modes

LEFT_HAND

Default in VECF 1.1.0.

Uses Vivecraft's native controller HAND HUD path while mounted.

The HUD follows the left controller.

NORMAL

Leaves Vivecraft's configured HUD behavior unchanged.

HIDDEN

Temporarily hides the normal HUD while mounted using Minecraft's F1-style HUD hiding behavior.

The previous HUD state is restored after dismounting.

This mode is retained as a fallback.

Diagnostics

diagnostics = false

When enabled, VECF writes additional information to:

logs/latest.log

Diagnostics can help identify:

• Ship mount detection
• Active player-model mode
• Mounted HUD mode
• Vivecraft self-render state
• Renderer bypass activity
• Camera correction behavior

diagnosticIntervalSeconds controls how frequently diagnostic information is written.

Installation

1. Install the required versions of Forge, Vivecraft, Valkyrien Skies, and Eureka.
2. Remove older versions of vivecraft_vs_camera_fix and VECF.
3. Place VECF-1.1.0.jar in the client mods folder.
4. Start Minecraft.
5. VECF will generate config/vecf-client.toml.

If you previously used an experimental VECF 1.0.0 or 1.1.0 phase build, deleting vecf-client.toml once is recommended so the latest default settings can regenerate.

The old:

config/vivecraft_vs_camera_fix-client.toml

is no longer used.

Tested Environment

VECF 1.1.0 was developed and tested with:

• 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 has also been tested in an environment containing Epic Fight.

Other versions may work, but they have not been fully verified.

Known Limitations

• VECF does not currently fix the view-direction change that may occur when mounting or dismounting a ship
• The mounted player-model height correction is tuned for the tested Eureka environment
• Player scaling or heavily modified animation systems may require additional compatibility work
• VANILLA changes the local mounted player away from Vivecraft's full-body VR renderer
• ROOM_LOCAL remains experimental
• Large modpacks may contain rendering modifications that have not been tested with VECF
• Internal changes in future Vivecraft, Valkyrien Skies, or Eureka versions may break compatibility

Updating from 0.3.9

VECF 1.1.0 is a major update from:

vivecraft_vs_camera_fix-0.3.9-phase1-hotfix1.jar

The mod now uses:

Mod name: Vivecraft Eureka Camera Fix
Short name: VECF
Mod ID: vecf
File name: VECF-1.1.0.jar
Config: config/vecf-client.toml

Remove the old JAR before installing VECF 1.1.0.

AI Assistance

This project was developed with the assistance of artificial intelligence tools.

AI was used for programming assistance, code review, debugging, compatibility analysis, documentation, and project organization.

The overall design, in-game testing, verification, configuration decisions, and release decisions were made by the project author.

Support

This project was created to solve compatibility issues encountered in my own Minecraft VR environment.

I am not a professional Minecraft mod developer, so I may not be able to diagnose or fix every incompatibility.

When reporting a problem, please include:

• Minecraft version
• Forge version
• Vivecraft version
• Valkyrien Skies version
• Eureka version
• VECF version
• Relevant configuration settings
• latest.log
• A description of when the problem occurs

Enabling diagnostics before reproducing an issue can provide additional useful information.

Backup and Disclaimer

Always back up your world before installing, updating, removing, or using this mod.

Every modpack is different and unexpected compatibility issues may occur.

The author is not responsible for corrupted worlds, lost progress, lost items, damaged save data, crashes, rendering problems, server issues, or other damage resulting from the use of this mod.

Use VECF entirely at your own risk.

Unofficial Add-on Disclaimer

VECF is an unofficial community-made compatibility add-on.

It is not affiliated with or endorsed by the developers or owners of:

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