NalulunaSpaceCalibrator (Patreon)

Please read the instruction. Use NalulunaAvatars 0.2.33 or later.

Old versions do not get information from the NalulunaSpaceCalibrator, so the VIVE trackers position will not be corrected.

Description

This is a Beat Saber mod that corrects the misalignment between the Oculus VR space and the SteamVR VR space, making it possible to easily use the VIVE tracker with the Oculus (or PICO) HMD. OpenVR-SpaceCalibrator is not required when using this mod.

When using Oculus HMDs, VIVE trackers and Index controllers are displayed in odd positions and angles. This is because the Oculus VR space and the SteamVR space do not match, and this misalignment needs to be corrected in some way.

Generally, this can be solved by using OpenVR-SpaceCalibrator, but this spatial misalignment is not a completely fixed value, and in my experience, it changes slightly (a few cm to 10 cm) when the tracking is off by a large amount, after a long time, after a reboot, etc. Therefore, it was necessary to re-calibrate with OpenVR-SpaceCalibrator each time.

This mod not only allows this correction to be performed in Beat Saber, but by preparing a dedicated calibration tracker and attaching it to the HMD, it can continue to calibrate at all times (during the menu screen). This ensures that any new misalignments that occur during play will continue to be corrected naturally.

However, this is a Beat Saber mod, so outside of Beat Saber (other games or apps), this correction will not be applied. In Beat Saber, the tracker positions in NalulunaAvatars and AlternativePlay mods are corrected by this mod.

Install

1. Install BeatSaberMarkupLanguage by ModAssistant

(If your mod environment is already set up, it's probably already in there.)

2. Extract the downloaded zip file to the following location (overwrite)

* C:\Program Files (x86)\Steam\steamapps\common\Beat Saber

(Move (overwrite) the Plugins and UserData folders in the zip here)

3. "Naluluna Space Calibrator" has been added to "MODS" (left side of the screen)

Instruction

◆ Ensure Oculus HMD and VIVE trackers are recognized on SteamVR

First, make sure that both the Oculus HMD and VIVE trackers are recognized together on SteamVR. If only the HMD is recognized, check if ["activateMultipleDrivers" : true] is set as shown below. "requireHmd" does not need to be changed.

Oculus Touch x Vive Trackers Guide
https://www.reddit.com/r/oculus/comments/8f7c0o/oculus_touch_x_vive_trackers_guide/

◆ For Oculus HMD + 3 VIVE trackers in an environment with 3 trackers, with calibration each time

Since one of the trackers is used for calibration, the tracker needs to be held in the hand instead of being worn on the body during calibration. Once the calibration is finished, you can put it back on your body.

https://youtu.be/wIdiCoSanmY

1. Open [NalulunaSpaceCalibrator] from the left menu as shown in the movie 0:15.

2. In the center list left, select the Oculus controller to be used for calibration. In the video, the right controller is selected.

3. On the right of the center list, select the VIVE tracker to be used for calibration. The list shows the coordinates that represent the position, so move the VIVE tracker while looking at the numbers to confirm which one is the target VIVE tracker.

4. Hold the Oculus controller and the VIVE tracker in one hand at the same time, making sure that the two are firmly positioned and that the tracking does not interfere with them

5. Press [Calibrate] in the lower center with the controller in the other hand. The Status on the left side of the screen will change to Calibrating. If there is a problem, the cause will be displayed.

6. When the status changes to Calibrating, move your hand with the two controllers in a large figure-eight motion. ( Make sure to focus on slow and large changes in angle )

7. Calibration will be completed when the sufficient samples for correction are collected or after 10 seconds. The correction is also complete at this point.

8. VIVE trackers position is now displayed correctly in NalulunaAvatars. If there is a tracker that is not used for  the avatar, the automatic recognition of the tracker role may not work. Please press [TRACKER MAPPING] to manually assign the role as shown in the video.

◆ For constant calibration with Oculus HMD + VIVE tracker dedicated for calibration

By preparing a dedicated VIVE tracker for calibration (not allocated to the avatar's role), you can eliminate the hassle of reattaching the tracker each time and the tedious calibration operation.

The dedicated calibration tracker is fixed to the HMD. When wrapping it with a band, be careful not to cover the LED emitting part of the CV1 or the cameras on the Quest; the location of the LEDs can be seen in the dark with the camera on your phone.

https://youtu.be/SOL9jq7bmsc

1. Open [NalulunaSpaceCalibrator] from the left menu as shown in the video 0:08.

2. In the center list on the left, select the Oculus HMD to be used for calibration.

3. In the center list on the right, select the VIVE tracker to be used for calibration. The list shows the coordinates of the location, so move the VIVE tracker while looking at the numbers to confirm which one is the target VIVE tracker and select it.

4. Turn on [Keep Calibrating in Menu] on the left side of the screen. The Status on the left side of the screen will change to Calibrating. If there is a problem, the cause will be displayed.

5. When the status changes to Calibrating, move your head in a large figure-eight motion. ( Make sure to focus on making large changes in the angle slowly )

6. There is no calibration stop. Calibration and position correction will continue during the menu screen.  (No calibrating during song play to prevent accidents)

7. VIVE trackers position is now displayed correctly in NalulunaAvatars. If there is a tracker that is not used for the avatar, the automatic recognition of the tracker role may not work. Please press [TRACKER MAPPING] to manually assign the role as shown in the video.

8. When the Oculus and SteamVR VR spaces are aligned, the position of the Index controllers (if you have) are also corrected at the same time. If you remove the battery from the Oculus controller when you start SteamVR, The Index controllers are recognized as the main controllers, so you can play normally with the Oculus + Index controllers environment.

OpenVR-SpaceCalibrator

With this mod, OpenVR-SpaceCalibrator is not needed while Beat Saber is running, but even if it were running at the same time, it would work without problems. In this case, the mod performs correction between the VR space that OpenVR-SpaceCalibrator has corrected and the current VR space. Any misalignment that occurred after calibration by OpenVR-SpaceCalibrator will be corrected.

Note that this mod does not include the OpenVR-SpaceCalibrator source code. It uses a lighter processing algorithm that does not use singular value decomposition.

Oculus Mode

When this mod is used with "-vrmode oculus" or with Beat Saber purchased from the Oculus store, please turn on "Support Oculus Mode" in the Experimental tab. This feature is still in the experimental stage.

Download

NalulunaModAssistant
https://www.patreon.com/posts/74489335

NalulunaSpaceCalibrator 0.1.0 or later are available with NalulunaModAssistant.

Old versions

NalulunaSpaceCalibrator 0.0.7 for Beat Saber 1.24.1
https://www.patreon.com/file?h=66874861&i=12474764

Updates

0.0.7
- Fixed a bug that sometimes caused Target device not found even if Target was selected
- Increased timeout period for manual calibration
- Added setting to increase the number of samples

0.0.6
- Minor fix for AlternativePlay mod