Throw wide the gates, that we may pass!

XIVR is an open-source project that aims to add VR support to the critically acclaimed Japanese MMORPG which has an expanded free trial with no restrictions on playtime. This open-source mod is purely based on original code, and does not include any copyrighted materials. While, to our knowledge, the mod is undetectable and fully usable on live servers, using this mod is against the TOS. Use at your own risk; we are not liable for damages caused.

XIVR is currently in an alpha state. It will be released as a minimum viable product to gauge user interest and attract other developers interested in working with us. The code is open-source, and we are willing to merge in new features! If you're interested, please let us know!

• List of chat/macro commands •

/xivr opens the VR settings

/xivr on enables VR

/xivr off disables VR

/xivr recenter recenters the camera

/xivr screen renders the game in 2D on a floating screen whenever you need it (sniping minigame, etc)

/xivr uiz [amount] sets the distance from the floating screen, where [amount] is a positive or negative value. The default is a value of 0.

/xivr uiscale [amount] sets the sets the size of the floating screen, where [amount] is a positive or negative value. The default is a value of 1.

/xivr uireset resets the distance and size of the floating screen

/xivr conloc enables controller locomotion (aka onward locomotion) for first person

/xivr horizon makes it so the camera angle is corrected if rotated vertically so the horizon never changes, preventing vr sickness

/xivr hsnap enables horizontal snap turning via analogue sticks

/xivr vsnap enables vertical snap turning via analogue sticks

/xivr snapanglex [degrees] sets the amount of degrees for horizontal snap turning using the analogue stick, where [degrees] is a positive number

/xivr snapangley [degrees] sets the amount of degrees for vertical snap turning using the analogue stick, where [degrees] is a positive number

/xivr rotatex [degrees] immediate X axis snap turning, where [degrees] is a positive or negative number

/xivr rotatey [degrees] immediate Y axis snap turning, where [degrees] is a positive or negative number

/xivr offsetx [amount] moves the camera directly along the X axis, where [amount] is a positive or negative value. This can be used for an over-the-shoulder view.

/xivr offsety [amount] moves the camera directly along the Y axis, where [amount] is a positive or negative value. This can be used for an over-the-shoulder view.

• Changelog •

v0.0.0.2 released now installing via the repo should work again

v0.0.0.3 released now the UI should no longer hide randomly, if you have downloaded a previous version please delete \AppData\Roaming\XIVLauncher\pluginConfigs\ xivr.json should the error have been saved in the file

v0.0.0.4 released, "band aid edition" Fix cross-eyed world via /xivr swapeyes and ui via /xivr swapeyesui If your normal (non vr) controller isnt working please try /xivr motcontoggle

v0.0.0.5 experimental release

Fixed floating UI scaling curvature bug

Fixed shadow glitching at edge of vision

Changes to loading order if it crashed previously please try this and report back

If started from the title screen settings will auto apply if started from the game please run /xivr loadcon after starting vr

v0.0.0.6

Fixed controller zoom not working

Updated to new game version

v0.0.0.8

Implemented automatic resolution resize (wont work on first load because it needs to fetch headset data once from Steam VR eye resolution)

Fixed certain UI elements displaying differently in each eye

Added multiple new menu entries for existing chat commands

Changed loading order, might crash more or less please report back

v0.0.0.9

Fixed Dresser Camera

Added IPD slider

New VR settings menu

Added verbose logging, logs are saved to dalamud.log in the XIVLauncher folder

Less Crashing

v0.0.0.10

Support for 6.3

Added first person locomotion based on head tracking, look in the direction you want to go

Added vertical support for first person locomotion, point or look in the direction you want to fly/swim

Fixed unintended first person camera behavior

v0.0.1.0 HANDTRACKING UPDATE

Disabled culling in first person

Mounts now are visible in first person

All combat effects now are visible in first person

Added toggle to show player body in first person without head

Added hand tracking in first person (if controllers and body is enabled)

Added Z-Offset slider

Removed flickering UI target arrow

Added in world target arrow (by @AJBats)

Added size slider for target arrow (by @AJBats)

Known Issues

First person camera location might be off, please use the offset sliders

If headgear is hidden using the toggle in the menu then the player head wont hide

While in first person with tracking the arms of some NPCs might randomly break

Gear polygon stretching from hand

Its hard to target the exits of player houses in first person

v0.0.3.0 Now actually playable edition

UI

→added toggle to render UI inside the game world with occlusion /xivr uidepth

→added UI z-offset and scale sliders

→fixed UI z-offset and scale chat commands

→while VR is active the mouse will be locked to the game window, you can alt tab to click on other windows

→added ability to click on UI elements that are off screen because the game resolution is too high for the users display (up to 3x the res)

→Dalamud (imgUI) is now visible in the headset

controls

→added ability to point at UI using motion controls to click on UI elements

→added ability to point into the game world using motion controllers to target, interact and place AOE attacks

→added ability to target, interact with objects and place AOE attacks via head tracking when using xbox controllers or kbm

→added ability to move housing furniture via motion controls

→added ability to click the mouse via the right trigger on both normal and motion controllers

→the outline of targets you are looking or pointing at will highlight

→added native two button controller mappings (WMR, Vive Focus3/XR, Pico, Touch, Quest etc.)

→long pressing a stick down on motion controllers now changes its mode, the left stick switches from movement to dpad while the right stick it switches to a scroll wheel

→fixed being unable to zoom in on the map using controllers in first person

→added option to display weapons in the hands in first person

→added controller haptics for stick mode switching and highlighting potential targets with motion controllers

→fixed being unable to target certain things like housing doors in first person

→pressing the right stick while holding the right bumper switches into a mode for controlling Dalamud, in this mode the face buttons are replaced by esc, F10-12 so you can remap them freely

tracking

→in first person mode the camera now gets recentered to the head location of the player model

→in first person mode there no longer is a gap in the neck

→the upper body of the player model is now tracked in accordance to head movement when unmounted

→fixed a issue with the arms of certain NPCs breaking when using motion controls

→removed option to hide body in first person

→added Y- & Z-Offset slider for first person

→reenabled head tracking in cutscenes (still as buggy as before)

→fixed player head not hiding correctly when headgear is set to invisible

→upper torso tracking is disabled when using controller or head turning and instead the torso is turning to counteract the turning of the player model

Note: for now all tracking code is disable when mounted

rendering

→added 2D mode /xivr mode2d , recommended if you are unable to get double the FPS (not compatible with asymmetric projection)

→added asymmetric projection toggle, enabling this will improve the performance (requires XIVR restart)

→fixed a DirectX bug that stopped SteamVR from initializing (Thanks to @joko for helping us debug)

→the desktop screen no longer flickers and instead displays black

→implemented ASW 2.0

→optimized shadow map for 100°FOV headsets

→added ultra wide shadow map toggle, for use with widescreen headsets such as the Pimax and Xtal

→fixed internal render resolution slightly decreasing every time you turn VR on and off

→fixed a stereo mismatch in the rendering of the UI

→removed broken post processing effects

Note: changing resolution in SteamVR now requiers a full game restart

other

→the refresh rate limit now gets set to unlimited automatically but requires a restart of the game to take effect

→fixed a bug with under water fx appearing above water

→the mod now is available in 日本語 (Japanese)