Vivecraft Eureka Camera Fix 0.3.9-phase1-hotfix1
========================================

Overview
--------
Unofficial client-side compatibility add-on for Minecraft Forge 1.20.1 using:
- Vivecraft 1.20.1-1.3.15 Forge
- Valkyrien Skies 2.4.11
- Eureka 1.6.3

This version is based directly on the stable 0.3.6-hotfix1 implementation.
The 0.3.7 and 0.3.8 camera/model experiments are not included.

Features
--------
- Keeps the 0.3.6 mounted camera offset correction.
- Keeps the 0.3.6 Forge ClientTickEvent-driven mounted HUD hiding.
- Keeps the optional 0.3.6 ship-local Vivecraft model stabilization.
- Adds a new mounted local-player model mode. The default is HIDDEN.

Mounted player model
--------------------
mountedPlayerModelMode = "HIDDEN"

Available values:
- HIDDEN: while the local player rides a Valkyrien Skies ShipMountingEntity,
  temporarily disable Vivecraft's first-person self-model rendering. Other players remain visible.
- NORMAL: keep the local Vivecraft model visible and use the original 0.3.6
  playerModelFix setting.

The HIDDEN mode only changes rendering. It does not remove the player entity or
change controls, collision, ship operation, server state, or remote players.
The local Vivecraft model may also be absent from third-person mirror views
while mounted because the entire Vivecraft shouldRenderSelf is forced off.

Camera settings
---------------
mode = "MANUAL_OFFSET"
offsetX = 0.0
offsetY = 1.8
offsetZ = 0.0

Player model stabilization
--------------------------
playerModelFix = true

This is the unchanged 0.3.6 model stabilization and is mainly relevant when
mountedPlayerModelMode is NORMAL.

Mounted HUD behavior
--------------------
mountedHudMode = "HIDDEN"

Available values:
- HIDDEN: use Minecraft's built-in F1 hideGui state while mounted.
- NORMAL: leave the normal HUD unchanged.

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

Installation
------------
1. Remove every older vivecraft_vs_camera_fix JAR.
2. Place vivecraft_vs_camera_fix-0.3.9-phase1-hotfix1.jar in the client mods folder.
3. Delete config/vivecraft_vs_camera_fix-client.toml once to generate the new
   mountedPlayerModelMode setting with its HIDDEN default.

Important
---------
Back up important worlds before installing, updating, or removing compatibility
mods. Use this mod at your own risk.

This project was developed with AI assistance. Real Quest 3 testing is required.
