Version 0.3.1

Added

• Added the new HEAD_POSITION camera tracking mode.

• The VR camera can now follow the animated position of Epic Fight’s Head joint.

• This helps prevent the camera from becoming buried inside the player model during weapon stances, attacks, and animations that move the model vertically.

• Added automatic fallback to the previous body-relative FIXED offset system when Head-joint tracking is unavailable or unsupported.

• Added a new trackingMode configuration option.

Changed

• HEAD_POSITION is now the default tracking mode.

• The default verticalOffsetMeters value has been changed from 0.300 to 0.150 for better positioning when using HEAD_POSITION.

• Existing user-defined offset values are preserved during configuration migration.

• The camera rotation remains controlled by the VR headset. Epic Fight animations only affect the camera position.

Configuration

The new default settings are:

configVersion = 4

[tracking]
trackingMode = "HEAD_POSITION"

[camera]
enabled = true
rightOffsetMeters = 0.000
verticalOffsetMeters = 0.150
forwardOffsetMeters = 0.000
epicFightModeOnly = true
firstPersonOnly = true
debugLogging = true

To return to the previous camera behavior, use:

trackingMode = "FIXED"

VR Comfort Warning

HEAD_POSITION may cause strong or rapid camera movement because the camera follows Epic Fight attack animations, weapon stances, and other animated Head-joint movements.

Stop playing immediately if you experience motion sickness, dizziness, nausea, headaches, eye strain, loss of balance, or other discomfort.

Switch to FIXED mode or stop using the mod if the symptoms continue.

Notes

• Client-side only

• No server installation required

• Designed for Minecraft 1.20.1

• Tested with Vivecraft 1.20.1-1.3.15 and Epic Fight 20.14.17

• Custom models, armatures, animation packs, and Epic Fight addons may behave differently