1
0
mirror of https://github.com/xiaopeng12138/MaiDXR.git synced 2024-11-15 08:37:35 +01:00
MaiDXR/README.md
2022-02-17 00:58:44 +01:00

71 lines
2.5 KiB
Markdown

# MaiDXR
Open Source VR Arcade Simulator
## About this project
- This project is an update of https://github.com/xiaopeng12138/MaiMai-VR.
## Inspired by
- https://github.com/derole1/MaiMai-VR
- https://github.com/HelloKS/MaiMai-VR
## Used repository
- https://github.com/HelloKS/MaiMai-VR
- https://github.com/hecomi/uWindowCapture
- https://github.com/Sucareto/Mai2Touch
## Supported platform
- All SteamVR device
- All Oculus device
- Only tested on Quest 2 through Oculus link (Native and via SteamVR). The Hand Balls position is by default adjusted for the Quest 2 controller.
## Declaimer
- This project is non-profit and some resources came from Internet!
- Although this is under the MIT license, do not use this in commercial/profitable scenarios!
- Please support your local arcade if you can!
## Changelog
Please see Changes.md
## How to use
- Download [latest version of MaiDXR](https://github.com/xiaopeng12138/MaiDXR/releases)
- Download and install [com0com](https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/powersdr-iq/setup_com0com_W7_x64_signed.exe)
- Configure com0com to bind COM3 and COM5 (it must be these two ports), COM4 and COM6 is optional (bind them will make your startup process faster).
- Disable somehow DummyTouchPanel.
- If you need button light, pls disable somehow DummyLED and bind COM20 21 22 23 to COM50 51 52 53 (it must be these ports).
- Run the game in window mode and make sure there is no black bar.
- Start MaiDXR.
- Enable somehow Test mod then exit Test mode.
## Configuration
In MaiDXR window press "M" on the keyboard to toggle local motion on-off.
Edit Settings.json file under the root directory. Press F5 in the MaiDXR window or defocus then focus window again to update settings.
HandSize, HandPosition, PlayerHigh: in CM
CaptureFrameRate, TouchRefreshRate: in FPS
CameraSmooth: 0.0 - 1.0, 1.0 = no smoothing
CameraFOV: in degree
HapticDuration: in second
HapticAmplitude: 0.0 - 1.0, 1.0 = max vibration
Button(1-4: top to bottom): Pls see [VK Code](https://docs.microsoft.com/windows/win32/inputdev/virtual-key-codes). Some keys do not require "VK_" at the beginning.
## Preview
![Image Capture](https://github.com/xiaopeng12138/MaiDXR/blob/main/PreviewImage/MaiDXR_PreviewImage.png?raw=true)
## ToDo
- √ Add user-adjustable settings (controller position etc.)
- √ Add non-VR window and camera smooth
- √ Add button light
- √ Add button vibration
- Add 3rd person camera
- Add 2p
- √ Add custom button
Huge thanks to HelloKS and derole1