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 is an unofficial client-side compatibility add-on for:

Vivecraft
Eureka! Ships!
Valkyrien Skies

It is designed for Minecraft Forge 1.20.1.

This mod was originally created to fix a camera issue that can occur when piloting Eureka ships in Vivecraft VR.

In some situations, the VR camera is positioned too low while seated on a ship mount. This can cause the player's view to clip into blocks or become embedded inside the ship.

The mod applies a configurable client-side camera correction while preserving the original Eureka and Valkyrien Skies ship mechanics.

Newer versions also include:

Stabilization for the locally rendered Vivecraft player model
An optional system that automatically hides the normal HUD while riding Valkyrien Skies ship mounts

Features

Corrects the Vivecraft camera position while riding Eureka and Valkyrien Skies ship mounts
Helps prevent the camera from clipping into ship blocks
Provides configurable camera position and orientation modes
Reduces severe vibration and jitter affecting the locally rendered Vivecraft player model
Can automatically hide the complete normal HUD while mounted
Restores the previous HUD state after dismounting
Client-side only
Designed for Minecraft Forge 1.20.1
Does not modify Eureka or Valkyrien Skies ship mechanics

Why the HUD Is Hidden by Default

While riding a moving or rotating Valkyrien Skies ship, Vivecraft's hand-, wrist-, or head-attached HUD may shake, drift, or visibly vibrate.

This appears to be caused by the Vivecraft HUD and the Valkyrien Skies ship transform being updated through different coordinate systems or at different stages of the rendering process.

Several methods were tested in an attempt to stabilize the HUD position directly, including:

Adjusting the HUD transform
Changing its attachment behavior
Cancelling parts of the HUD rendering process
Modifying the GUI framebuffer

Unfortunately, none of these methods produced a reliable improvement in the tested environment.

Because the HUD movement could not be corrected reliably, the default behavior is now to temporarily hide the normal HUD while the player is riding a Valkyrien Skies ship mount.

This is a workaround rather than a true fix for the HUD vibration.

The HUD is hidden using Minecraft's normal F1-style HUD hiding behavior and is automatically restored after dismounting.

Players who prefer to keep the HUD visible can change:

mountedHudMode = "NORMAL"

Configuration

The configuration file is located at:

config/vivecraft_vs_camera_fix-client.toml

Default Settings

[camera_fix]
mode = "MANUAL_OFFSET"

offsetX = 0.0
offsetY = 1.8
offsetZ = 0.0

playerModelFix = true
mountedHudMode = "HIDDEN"

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.

This is the tested default for Eureka ship mounts.

`VIVECRAFT_POSITION`

Uses the Vivecraft camera position directly.

This may behave differently depending on the installed Vivecraft and Valkyrien Skies versions.

`FULL_VIVECRAFT_POSE`

Uses both the Vivecraft camera position and the HMD orientation.

This mode may produce more noticeable camera movement while the ship is moving or rotating.

`DISABLED`

Disables the camera correction.

Other optional features, such as player-model stabilization and mounted HUD behavior, are controlled separately.

Camera Offset

`offsetX`

Controls the horizontal camera offset.

Default:

offsetX = 0.0

`offsetY`

Controls the vertical camera offset.

Default:

offsetY = 1.8

The default value was selected for the environment used during development and testing.

Different player models, scaling mods, Vivecraft settings, or seating positions may require adjustment.

`offsetZ`

Controls the forward and backward camera offset.

Default:

offsetZ = 0.0

Player Model Stabilization

playerModelFix = true

When enabled, the mod rebuilds the local Vivecraft full-body pose using the ship's render-local coordinate system.

This reduces the severe vibration or rapid jitter that can affect the visible Vivecraft player model while riding a moving ship.

This setting only affects the locally rendered Vivecraft player model. It does not directly stabilize the Vivecraft HUD.

Set this option to false if another player-model, animation, or rendering mod behaves incorrectly.

Mounted HUD Behavior

mountedHudMode = "HIDDEN"

Available values:

HIDDEN
NORMAL

`HIDDEN`

Enabled by default.

Temporarily activates Minecraft's built-in F1-style HUD hiding behavior while the local player is riding a Valkyrien Skies ShipMountingEntity.

This mode was added because the Vivecraft HUD could not be stabilized reliably while riding moving Eureka ships.

It hides the complete normal HUD, including:

Hotbar
Health
Hunger
Armor
Experience bar
Crosshair
First Aid HUD elements
Survive HUD elements
Jade overlays
Vivecraft hand-, wrist-, or head-attached normal HUD
Other standard Forge HUD overlays

Opened screens remain usable, including:

Inventory
Chat
Pause menu
Configuration screens
Other menus and containers

The HUD state that existed before mounting is saved and restored after:

Dismounting
Disconnecting from a world
Returning to the main menu
Changing mountedHudMode to NORMAL

If the HUD was already hidden before mounting, it will remain hidden after dismounting.

`NORMAL`

Leaves the HUD unchanged while mounted.

Use this mode if you prefer to keep the Vivecraft HUD visible or if another mod conflicts with the automatic F1 behavior.

The HUD may continue to shake or drift while the ship is moving.

Diagnostics

diagnostics = false
diagnosticIntervalSeconds = 5

`diagnostics`

Enables diagnostic information in:

logs/latest.log

This can help identify:

Whether the mod detected a Valkyrien Skies ship mount
Whether mounted HUD hiding is active
The current Minecraft HUD state
The detected vehicle class
Camera correction information

`diagnosticIntervalSeconds`

Controls how frequently diagnostic information is written to the log.

Avoid setting this unnecessarily low, as frequent logging can make latest.log considerably larger.

Installation

Install the required versions of Forge, Vivecraft, Valkyrien Skies, and Eureka.
Remove all older versions of vivecraft_vs_camera_fix.
Place the latest JAR in the client mods folder.
Start Minecraft and allow the configuration file to generate.
Adjust the configuration only when necessary.

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

Tested Environment

The current version 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

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

Known Limitations

The Vivecraft HUD vibration itself has not been fixed
The default HIDDEN mode is a workaround that hides the unstable HUD while mounted
Minor player-model position or orientation differences may remain depending on the installed animation and player-model mods
HIDDEN may apply to other Valkyrien Skies mounts that use the same ShipMountingEntity system, including passenger seats
A mod that continuously forces Minecraft's HUD state may conflict with the mounted HUD feature
Different Vivecraft, Valkyrien Skies, or Eureka versions may change internal behavior and break compatibility
Large modpacks may contain rendering or animation modifications that have not been tested with this add-on

AI Assistance

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

AI was used to help with:

Java programming
Code review
Debugging
Project structure
Compatibility research
Problem analysis
Documentation

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

Support

I am not a professional Minecraft mod developer.

This project was created to solve specific compatibility issues that affected my own VR gameplay.

Unfortunately, I may not have the technical knowledge or development experience required to diagnose or fix every crash, incompatibility, bug, or interaction with other mods.

In particular, the Vivecraft HUD vibration could not be corrected reliably, which is why the automatic HUD-hiding workaround was introduced.

I sincerely apologize in advance if I am unable to resolve an issue or provide a working fix.

When reporting a problem, please include:

Minecraft version
Forge version
Vivecraft version
Valkyrien Skies version
Eureka version
Mod version
Relevant configuration settings
latest.log
A description of when the issue occurs

Enabling diagnostics before reproducing the issue may provide additional useful information.

Backup and Disclaimer

Always create a backup of your world before installing, updating, removing, or using this mod.

Although this mod has been tested, every modpack is different and unexpected compatibility issues may occur.

By using this mod, you acknowledge that you do so entirely at your own risk.

The author is not responsible for:

Corrupted worlds
Lost progress
Lost items
Damaged save data
Server issues
Game data corruption
Crashes or rendering problems
Any other damage or loss resulting from the use of this mod

Unofficial Add-on Disclaimer

This 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!
Mojang Studios
Microsoft