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

1. Install the required versions of Forge, Vivecraft, Valkyrien Skies, and Eureka.

2. Remove all older versions of vivecraft_vs_camera_fix.

3. Place the latest JAR in the client mods folder.

4. Start Minecraft and allow the configuration file to generate.

5. 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