Vivecraft Eureka Camera Fix 0.3.6

This is a major update from version 0.1.1.

Camera Correction

• Preserved the existing camera correction for Vivecraft players riding Eureka and Valkyrien Skies ship mounts.

• Kept MANUAL_OFFSET as the recommended and default camera mode.

• Changed the default vertical camera offset from 1.9 to 1.8.

• Preserved the smooth mounted-camera interpolation provided by Valkyrien Skies.

• Kept the existing configurable X, Y, and Z camera offsets.

• Kept the experimental VIVECRAFT_POSITION and FULL_VIVECRAFT_POSE modes.

• Camera correction can still be disabled independently.

Vivecraft Player Model Stabilization

• Added playerModelFix, enabled by default.

• Added compatibility handling for severe shaking and vibration of Vivecraft's locally rendered full-body player model while riding moving ships.

• Rebuilds the local HMD, controller, and available full-body tracking positions using the ship's render-local coordinate system.

• Reduces the large positional vibration caused by the Vivecraft VR origin and Valkyrien Skies ship transform updating through different rendering paths.

• This correction affects only the locally rendered Vivecraft player model.

• Server position, collision, and ship mechanics are not modified.

The feature can be disabled with:

playerModelFix = false

Minor model position or orientation differences may still remain with some player-model or animation mods.

Mounted HUD Handling

Added the new mountedHudMode configuration option.

Available modes:

• HIDDEN

• NORMAL

HIDDEN

HIDDEN is the new default.

Direct attempts to stabilize Vivecraft's hand-, wrist-, and head-attached HUD while moving on Valkyrien Skies ships did not produce a reliable improvement.

Because the HUD vibration itself could not be corrected consistently, HIDDEN now uses Minecraft's normal F1-style HUD hiding behavior while the local player rides a Valkyrien Skies ShipMountingEntity.

This 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 HUD

• Other standard Forge HUD overlays

Inventory, chat, pause menus, configuration screens, and other opened interfaces remain usable.

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

• Dismounting

• Disconnecting

• Returning to the main menu

• Changing mountedHudMode to NORMAL

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

NORMAL

NORMAL leaves Vivecraft's original HUD behavior unchanged.

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

HUD Detection and Performance Improvements

• Replaced the previous Minecraft Tick Mixin with Forge's official ClientTickEvent.

• Mounted HUD handling now runs during the END phase of the client tick.

• Removed reliance on ShipMountingEntity.isController(), as its controller state was not synchronized reliably to the client in the tested environment.

• Removed nearby Eureka helm-block scanning.

• Removed render cancellation and Vivecraft GUI framebuffer-clearing experiments.

• Removed temporary mounted-state detection based on camera and player-pose rendering hooks.

• HIDDEN now activates whenever the local player rides a Valkyrien Skies ShipMountingEntity.

• Per-tick processing is limited to checking the local player, current vehicle type, and mounted-state changes.

• Minecraft's hideGui value is normally changed only when mounting, dismounting, or when another source makes the HUD visible again while still mounted.

Configuration Defaults

[camera_fix]
mode = "MANUAL_OFFSET"

offsetX = 0.0
offsetY = 1.8
offsetZ = 0.0

playerModelFix = true
mountedHudMode = "HIDDEN"

diagnostics = false
diagnosticIntervalSeconds = 5

Existing configuration files may retain values from older releases.

Delete:

config/vivecraft_vs_camera_fix-client.toml

to regenerate the configuration with the new default values.

Diagnostics

Expanded diagnostic logging for:

• Camera correction

• Player-model stabilization

• Mounted-state detection

• HUD control

Mounted HUD diagnostics can now report:

• eventSeen

• enabled

• mounted

• forcing

• hideGui

• vehicle

Enable diagnostics with:

diagnostics = true

Diagnostic information is written to:

logs/latest.log

Compatibility Fixes

• Fixed the startup crash introduced in the original 0.3.6 build.

• Corrected Forge configuration registration to use the IConfigSpec method signature required by Forge 47.4.22.

• No camera, HUD, or player-model behavior was changed by the hotfix.

Known Limitations

• The Vivecraft HUD vibration itself has not been directly fixed.

• Automatic HUD hiding is used as a workaround for the unstable mounted HUD.

• HIDDEN applies to every Valkyrien Skies ShipMountingEntity, including passenger seats that use the same entity type.

• Minor local player-model position or orientation differences may remain.

• Mods that continuously force Minecraft's F1 or hideGui state may conflict with the automatic HUD behavior.

• Compatibility with different Vivecraft, Valkyrien Skies, or Eureka versions is not guaranteed.

Updating from 0.1.1

1. Remove all older versions of vivecraft_vs_camera_fix.

2. Install only:

vivecraft_vs_camera_fix-0.3.6-hotfix1.jar

1. Back up important worlds before updating.

2. Delete the old client configuration file only when you want the new default settings to be regenerated.