SONS VR Mod v0.0.5-alpha

v0.0.5-alpha

Menus you can actually use, correct stereo on headsets with angled displays, and thumbsticks that
do one thing at a time.

Fixed: the world sheared when you turned your head

On headsets with canted (angled) displays — Quest 3 among them — a rectangle became a trapezium
as you turned, and the whole world was distorted with it.

The per-eye projection was being rebuilt from the four raw field-of-view tangents the runtime
reports. Four tangents can only describe a frustum square to the eye's forward axis, so the rebuild
silently dropped the shear a canted display puts into its projection: the scene was drawn on a
straight image plane and shown on a tilted one. The projection now comes from the runtime exactly as
given, and the field-of-view crop is applied on top of it instead of replacing it.

Headsets with parallel displays — Pico 4, Pimax Crystal, Index — were never affected, which is why
this went unnoticed for so long.

Fixed: the pause and save screens could not be clicked

Esc (long press on X), the save screen and the dialogs that open from them were visible but
dead: the laser passed straight through them.

They hang off the same canvas the mod moves into world space for the heads-up display, so the panel
scan skipped them as already converted. They were riding on a surface locked to the head, which is
the one thing a pointer cannot aim at. While a menu is open that canvas is now anchored in the room
like every other panel, and the display takes it back the moment the menu closes.

A second fault sat behind it: in play, the game's camera does not draw the interface layer, because
a screen-space canvas never passes through a camera at all. Move one into world space and leave it
there and it is present, laid out, fully answering the pointer, and invisible — which is what
happened to the "new save" dialog. Panels are now moved onto a layer the eye cameras draw, decided
by reading the camera's own culling mask, so a canvas that is already visible is left exactly as the
game had it.

Fixed: a clean install had no controller input at all

The SteamVR action manifest was missing from the package. Without it every action reads zero, and
the failure looks like anything but a missing file: the headset tracks, the hands track, the laser
is drawn, and no trigger, stick or button does anything — because poses do not go through the action
system and everything else does.

SonsOfTheForest_Data/StreamingAssets/SteamVR/ now ships with the release. When installing by
hand, copy it too.

Changed: thumbsticks

Control	Sends	Now needs
Right stick up	Left Shift	Close to the end of its travel
Right stick down	Left Ctrl	Close to the end of its travel
Left stick sideways	A / D	Past half

The right stick also turns the player, and a turn is a push sideways that rarely stays perfectly
sideways: the stray forward or back picked up while sweeping the thumb was enough to break into a
run or drop into a crouch in the middle of looking around. Stepping sideways asks for half travel so
walking forward does not drift into a diagonal.

Each direction is let go of at a lower threshold than it took to engage, since a thumb resting on
the line would otherwise cross it many times a second and the key would flicker with it.

Running was not bound at all before this release and now sends Left Shift, the game's own
sprint key.

Two new settings, on the panel in the headset under Movement and in MelonPreferences.cfg:

Setting	Default	Range
RunCrouchThreshold	0.85	0.50 – 0.98
StrafeThreshold	0.50	0.20 – 0.90

If you preferred the old, much lighter crouch, set RunCrouchThreshold to 0.30.

Added: interface survey on a key

F9 and F10 write the whole state of the interface to the MelonLoader log: every canvas with its
render mode, layer, event camera, raycaster, control count and contents, plus the event system and
every active raycaster. Two keys rather than one so two screens can be captured and compared.

Sons of the Forest VR mod v0.0.4-alpha Oneclick Installer

SonsVR_Mod 0.0.4-alpha

Full VR for Sons of the Forest on PC through SteamVR. No official VR mode exists; this adds one.

New in this release

• Hands follow the controllers. The arms are driven through the Final IK rig the game already
  carries on the player, with elbow goals that keep them from folding across the chest.
• Settings panel in the headset. Around thirty settings on a two column world space panel,
  opened from a controller: sliders, checkboxes, step buttons, and a Cancel that restores what was
  there on opening. Changes apply as the slider moves, so the effect is judged by looking at it.
• Laser pointer. A beam from either controller drives the pointer on every panel; the other
  trigger hands the beam across.
• Loading screen in world space, so the view no longer freezes or shows areas outside the map
  while a scene loads.
• Smooth turning as an alternative to snap turning.
• The map and the ring around it now stay aligned as the display is resized.
• Settings established by testing in the headset are now the defaults, so a fresh install starts
  where the mod is known to work.

Installing

Run SONS_VR_v0.0.4-alpha_oneclick.exe and point it at the game folder. It refuses any folder without
SonsOfTheForest.exe, since installing elsewhere succeeds and then quietly does nothing.

The first run needs an internet connection and takes several minutes, with the window
apparently doing nothing: MelonLoader downloads the tools it reads the game with, then generates
its assemblies from the copy of the game on that machine. Later starts are quick.

Start SteamVR first, then the game.

Known limitations

Held items are not yet aligned to the hands. Two full render passes per frame: single-pass stereo
needs a native XR provider, which cannot be added to a shipped game. Individual screen space
overlays can still be missing from the headset.

Alpha: expect rough edges, and please report what breaks.

SonsVR Mod Alpha 0.0.2 Pre-release

• Added inventory interaction and crafting
• Added in-game player HUD and minimap
• Implemented motion controller button mappings for actions

Alpha 0.0.1

To install this release, you must first install Melon Loader 6.0 for Sons of the Forest.
After installing Melon Loader 6.0,
extract the 7z file into the game’s root folder so that the mod files are added to the game.

Files path
SonsOfTheFOrest
|__Mods
| |__Libs
| | |__openvr_api.dll
| |
| |____SonsVR_Mod.dll
|
|___UserLibs
|__SonsSteamVR_IL2CPP.dll