Move chunithm games to games/sega/chunithm/

This commit is contained in:
Akitake 2025-04-07 11:38:12 +02:00
parent 9a7179e2ea
commit 603efc0384
37 changed files with 552 additions and 556 deletions

View File

@ -1,4 +0,0 @@
# Controllers (NEW)
<img src="/img/chunithm/sdhd/new.png">
--8<-- "docs/games/chusan/controllers.md"

View File

@ -1,4 +0,0 @@
# Troubleshooting (NEW)
<img src="/img/chunithm/sdhd/new.png">
--8<-- "docs/games/chusan/troubleshooting.md"

View File

@ -1,4 +0,0 @@
# Controllers (SUN)
<img src="/img/chunithm/sdhd/sun.png">
--8<-- "docs/games/chusan/controllers.md"

View File

@ -1,4 +0,0 @@
# Troubleshooting (SUN)
<img src="/img/chunithm/sdhd/sun.png">
--8<-- "docs/games/chusan/troubleshooting.md"

View File

@ -1,4 +0,0 @@
# Troubleshooting (VERSE)
<img src="/img/chunithm/sdhd/verse.png">
--8<-- "docs/games/chusan/troubleshooting.md"

View File

@ -3,7 +3,7 @@
!!! tip ""
- Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.**11/12/13/14**
- To achieve this over the internet, we can use SoftEther VPN. Refer to the [Setting Up SoftEther VPN Guide](../../extras/softether.md) for more information.
- To achieve this over the internet, we can use SoftEther VPN. Refer to the [Setting Up SoftEther VPN Guide](/extras/softether.md) for more information.
---
### Configuring segatools.ini & Game Assignments
@ -60,4 +60,4 @@
!!! warning "Have any other issues?"
Check out the [Troubleshooting](troubleshooting.md) and [Error Codes](../../errorcodes/sega.md) pages.
Check out the [Troubleshooting](troubleshooting.md) and [Error Codes](/errorcodes/sega.md) pages.

View File

@ -1,344 +1,344 @@
!!! danger "Please make sure you downloaded your data from an appropriate source.<br>This guide is unable to troubleshoot any problems related to bad or poorly managed data."
---
!!! tip ""
segatools, by default, only accepts keyboard input and does not recognize any
controllers. However, it can be configured with IO DLLs to add support for controllers.
The controller you plan on using should also be provided with these IO DLLs. If unsure,
check the support section for your controller, or contact the vendor directly. Alternate
options for the most common controllers are listed below.
These IO DLLs should be copied to your game's `App\bin\` folder and referenced in
`segatools.ini` under the `[chuniio]` section.
!!! tip ""
If you have a single DLL, uncomment the `path=` line by removing the leading semicolon (`;`),
then add your DLL's file name after the `=`:
```ini hl_lines="5"
[chuniio]
; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.
; (will use chu2to3 engine internally)
;(1)!
path=controller.dll
```
1. Note that there is no leading semicolon.
!!! tip ""
If you have two DLLs, ending in `_x86.dll` and `_x64.dll` (or `_chusan.dll` and `_amdaemon.dll`),
uncomment the `path32=` and `path64=` lines by removing the leading semicolon (`;`), then
add your DLLs after the `=`:
```ini hl_lines="5 6"
[chuniio]
; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.
; x86 chuniio to path32, x64 to path64. Both are necessary.
;(1)!
path32=controller_x86.dll
path64=controller_x64.dll
```
1. Note that there is no leading semicolon.
---
### Keyboard
!!! tip ""
Keyboard is the default input method, and while not recommended for playing the game,
it is useful for testing purposes.
The default layout uses `SDFGHJKL` for slider input, and `Space Bar` for the AIRs.
If you wish to change the default keybinds, an explanation on how to set these is included
above the `[io3]` section in your `segatools.ini`.
---
### Brokenithm
!!! tip ""
Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom
half of the screen as the ground slider, and sliding into the upper half activates the air
sensors.
#### Android
!!! warning
Your computer and your Android device must be on the same local network.
!!! tip ""
- Download the latest version of [Brokenithm-Android](https://github.com/tindy2013/Brokenithm-Android/releases/latest)
and install it on your Android device.
- Download the latest version of [Brokenithm-Android-Server](https://github.com/tindy2013/Brokenithm-Android-Server/releases/latest)
and extract **only `brokenithm_server.exe`** to your `App\bin\` folder.
- Download the latest version of [Brokenithm-Evolved IO DLLs](https://gitea.tendokyu.moe/Dniel97/Brokenithm-Evolved/releases) and extract the DLL files to your `App\bin\` folder.
- Edit your `App\bin\segatools.ini` to reference the extracted DLLs:
```ini hl_lines="2"
[aimeio]
path=aime_brokenithm.dll
```
```ini hl_lines="2 3"
[chuniio]
path32=brokenithm_x86.dll
path64=brokenithm_x64.dll
```
- Run `brokenithm_server.exe`. A command prompt window should open, saying that
it is waiting for a device on port 52468.
- Open the Brokenithm app on your Android device. Enter your computer's IP address
in the Address box on the top right, then tap Start.
- Run the game as normal.
??? info "Getting your computer's IP address"
Open **Settings** -> **Network and Internet** and select **Properties**. Scroll down to
the bottom and check the address under the **IPv4 address** field:
<img src="/img/chunithm/sdhd/controllers/0_ipaddress.png">
That is your computer's IP address.
??? info "Automatically launching the Brokenithm server when starting the game"
**This will only work if you extracted `brokenithm_server.exe` to `App\bin\` as previously instructed.**
You can edit the launch script to launch the Brokenithm server when starting the game.
Edit `App\bin\start.bat` to add a line above the existing commands:
```batch hl_lines="5"
@echo off
pushd %~dp0
start /min brokenithm_server
start /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json
inject_x86 -d -k chusanhook_x86.dll chusanApp.exe
taskkill /f /im amdaemon.exe > nul 2>&1
echo.
echo Game processes have terminated
pause
```
??? info "Improving latency"
You can improve latency by running Brokenithm with your Android device tethered to
your computer. However, this requires a little extra setup:
- Connect your Android device to your computer with a USB cable.
- If you haven't enabled Developer options on your device, do it by navigating to
the "About" page in your phone's settings, then tap "Build number" seven times.
This varies by device, so if unsure, look up the instructions for your specific
one.
- Navigate to Developer options and enable USB debugging.
- On your computer, download and extract [Android SDK Platform Tools](https://dl.google.com/android/repository/platform-tools-latest-windows.zip)
to your `App\bin\` folder.
- Navigate to the `App\bin\platform-tools` folder in File Explorer, click on the
address bar, type `cmd`, and hit Enter to open a command prompt.
- In the command prompt, type the following command:
```batch
adb reverse tcp:52468 tcp:52468
```
- Start brokenithm_server in TCP mode with the -T command line flag, `brokenithm_server.exe -T`.
- On your Android device, open Brokenithm, and change the address to `0.0.0.0`.
- If the text box to the left of the "SETTINGS" button say "UDP", tap on it
once to switch to "TCP" mode.
- Tap on "START", and you will now be connected via the USB cable.
- You can now start the game as normal.
The next time you play the game, you only need to run the `adb reverse ...` command
again. To do this automatically when the game starts, add a line to the `start.bat`
script **before** the `brokenithm_server` line:
```batch hl_lines="5 6"
@echo off
pushd %~dp0
start /min platform-tools\adb reverse tcp:52468 tcp:52468
start /min brokenithm_server -T
start /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json
inject_x86 -d -k chusanhook_x86.dll chusanApp.exe
taskkill /f /im amdaemon.exe > nul 2>&1
echo.
echo Game processes have terminated
pause
```
#### iOS/iPadOS
!!! tip ""
- Install Brokenithm on your iOS/iPadOS device by joining the [Brokenithm TestFlight](https://testflight.apple.com/join/U6kwvETm) ^^(iOS 18 only)^^.
- If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different [IPA](https://redive.estertion.win/ipas/Brokenithm-iOS-build-10.ipa) with [Sideloadly](https://sideloadly.io/).
- If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, **uninstall it.**
- Install the **non-Microsoft Store** version of iTunes from the [website](https://www.apple.com/itunes/download/win64).
- Download the latest version of [Brokenithm-Evolved-iOS server](https://redive.estertion.win/ipas/Brokenithm/Brokenithm-Evolved-iOS-v0.3.7z)
and extract it to `App\bin\Brokenithm-Server`.
- Download the latest version of [Brokenithm-Evolved IO DLLs](https://gitea.tendokyu.moe/Dniel97/Brokenithm-Evolved/releases) and extract the DLL files to your `App\bin\` folder.
- Edit your `App\bin\segatools.ini` to reference the extracted DLLs:
```ini hl_lines="2"
[aimeio]
path=aime_brokenithm.dll
```
```ini hl_lines="2 3"
[chuniio]
path32=brokenithm_x86.dll
path64=brokenithm_x64.dll
```
- Run `App\bin\Brokenithm-Server\Brokenithm-Evolved-iOS.exe`. A command prompt window
should open, saying that it is waiting for a device.
- On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a
USB cable.
- Run the game as normal.
??? info "Automatically launching the Brokenithm server when starting the game"
**This will only work if you extracted the server to `App\bin\Brokenithm-Server` as previously instructed.**
You can edit the launch script to launch the Brokenithm server when starting the game.
Edit `App\bin\start.bat` to add a line above the existing commands:
```batch hl_lines="5"
@echo off
pushd %~dp0
start /min Brokenithm-Server\Brokenithm-Evolved-iOS.exe
start /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json
inject_x86 -d -k chusanhook_x86.dll chusanApp.exe
taskkill /f /im amdaemon.exe > nul 2>&1
echo.
echo Game processes have terminated
pause
```
### TASOLLER
!!! warning
This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the
controller after January 2022, the update should have already been applied.
If you've purchased the controller before then, you will need to update the touch
firmware by following the instructions on [DJ-DAO's support page](https://www.dj-dao.com/en/support/11.html).
!!! tip ""
- Install the [custom Host and LED firmware](https://pixeldrain.com/u/DajSPEoa) to your controller.
Instructions on how to do so is provided in the linked archive.
- Pick one of these two TASOLLER IO DLLs to download and extract to your `App\bin` folder.
They should be functionally the same, but if one doesn't work, you can try the other:
- [chuniio-tasoller](https://gitea.tendokyu.moe/Scribbler/chuniio-tasoller/releases) (download `lib.zip`)
- [chuniio-rs](https://gitea.tendokyu.moe/beerpsi/chuniio-rs/releases) (download `chusan.zip`)
- Edit your `App\bin\segatools.ini` to reference the extracted DLLs:
```ini
[chuniio]
path32=chuniio_tasoller.dll;(1)!
path64=chuniio_tasoller_x64.dll;(2)!
```
1. Or `chuniio_tasoller_v2_chusan.dll` if you downloaded `chuniio-rs`.
2. Or `chuniio_tasoller_v2_amdaemon.dll` if you downloaded `chuniio-rs`.
- Connect the controller to your computer, and then start the game.
### YubiDeck
!!! tip ""
- Switch your YubiDeck to HID output mode. Instructions on how to do so are provided
in the [YubiDeck manual](https://drive.google.com/file/d/11KVlKbg3zGCRwI7R-30t2IJc6OQwDEgo/view).
- Download the latest version of [YubiDeck IO DLLs](https://gitea.tendokyu.moe/beerpsi/chuniio-yubideck/releases)
and extract it to your `App\bin` folder.
- Edit your `App\bin\segatools.ini` to reference the extracted DLLs:
```ini
[chuniio]
path32=chuniio_yubideck_chusan.dll
path64=chuniio_yubideck_amdaemon.dll
```
- Optionally, reference the included AimeIO DLL to use the controller's
built-in card reader:
```ini
[aimeio]
path=aimeio_yubideck.dll
```
- Connect the controller to your computer, and then start the game.
### Laverita 3
!!! tip ""
- Switch your Laverita to IO mode. You can do so in ConfigApp
found in the yuancon [discord](https://discord.gg/4ncuRrq).
- Change the COM port of your controller. You can do so in
Device manager by looking for `USB Serial Device` you may need to unplug and replug your controller to properly idetify which one is the Laverita.
- Double click on it
- Go to Port Settings
- Click on Advanced
- From the dropdown select COM1
- Restart to ensure changes took effect and saved
- Edit your `App\bin\segatools.ini` to disable io emulation and set led:
```ini
[led]
; Output billboard LED strip data to a named pipe called "\\.\pipe\chuni_led"
cabLedOutputPipe=0
; Output billboard LED strip data to serial
cabLedOutputSerial=1
; Output slider LED data to the named pipe
controllerLedOutputPipe=0
; Output slider LED data to the serial port
controllerLedOutputSerial=1
; Use the OpeNITHM protocol for serial LED output
controllerLedOutputOpeNITHM=0
; Serial port to send data to if using serial output. Default is COM5.
serialPort=COM1
; Baud rate for serial data (set to 115200 if using OpeNITHM)
serialBaud=9600
[slider]
; Enable slider emulation. If you have real AC slider, set this to 0.
; Slider serial port must be COM1.
enable=0
[io4]
enable=0
```
- Then start the game.
### Arcade hardware and other controllers
!!! tip ""
If you're interested in using a cabinet slider and air sensors, or possibly even
making your own controller, the [Cons&Stuff website](https://consandstuff.github.io/)
and Discord community is a great place to start!
!!! danger "Please make sure you downloaded your data from an appropriate source.<br>This guide is unable to troubleshoot any problems related to bad or poorly managed data."
---
!!! tip ""
segatools, by default, only accepts keyboard input and does not recognize any
controllers. However, it can be configured with IO DLLs to add support for controllers.
The controller you plan on using should also be provided with these IO DLLs. If unsure,
check the support section for your controller, or contact the vendor directly. Alternate
options for the most common controllers are listed below.
These IO DLLs should be copied to your game's `App\bin\` folder and referenced in
`segatools.ini` under the `[chuniio]` section.
!!! tip ""
If you have a single DLL, uncomment the `path=` line by removing the leading semicolon (`;`),
then add your DLL's file name after the `=`:
```ini hl_lines="5"
[chuniio]
; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.
; (will use chu2to3 engine internally)
;(1)!
path=controller.dll
```
1. Note that there is no leading semicolon.
!!! tip ""
If you have two DLLs, ending in `_x86.dll` and `_x64.dll` (or `_chusan.dll` and `_amdaemon.dll`),
uncomment the `path32=` and `path64=` lines by removing the leading semicolon (`;`), then
add your DLLs after the `=`:
```ini hl_lines="5 6"
[chuniio]
; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.
; x86 chuniio to path32, x64 to path64. Both are necessary.
;(1)!
path32=controller_x86.dll
path64=controller_x64.dll
```
1. Note that there is no leading semicolon.
---
### Keyboard
!!! tip ""
Keyboard is the default input method, and while not recommended for playing the game,
it is useful for testing purposes.
The default layout uses `SDFGHJKL` for slider input, and `Space Bar` for the AIRs.
If you wish to change the default keybinds, an explanation on how to set these is included
above the `[io3]` section in your `segatools.ini`.
---
### Brokenithm
!!! tip ""
Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom
half of the screen as the ground slider, and sliding into the upper half activates the air
sensors.
#### Android
!!! warning
Your computer and your Android device must be on the same local network.
!!! tip ""
- Download the latest version of [Brokenithm-Android](https://github.com/tindy2013/Brokenithm-Android/releases/latest)
and install it on your Android device.
- Download the latest version of [Brokenithm-Android-Server](https://github.com/tindy2013/Brokenithm-Android-Server/releases/latest)
and extract **only `brokenithm_server.exe`** to your `App\bin\` folder.
- Download the latest version of [Brokenithm-Evolved IO DLLs](https://gitea.tendokyu.moe/Dniel97/Brokenithm-Evolved/releases) and extract the DLL files to your `App\bin\` folder.
- Edit your `App\bin\segatools.ini` to reference the extracted DLLs:
```ini hl_lines="2"
[aimeio]
path=aime_brokenithm.dll
```
```ini hl_lines="2 3"
[chuniio]
path32=brokenithm_x86.dll
path64=brokenithm_x64.dll
```
- Run `brokenithm_server.exe`. A command prompt window should open, saying that
it is waiting for a device on port 52468.
- Open the Brokenithm app on your Android device. Enter your computer's IP address
in the Address box on the top right, then tap Start.
- Run the game as normal.
??? info "Getting your computer's IP address"
Open **Settings** -> **Network and Internet** and select **Properties**. Scroll down to
the bottom and check the address under the **IPv4 address** field:
<img src="/img/chunithm/sdhd/controllers/0_ipaddress.png">
That is your computer's IP address.
??? info "Automatically launching the Brokenithm server when starting the game"
**This will only work if you extracted `brokenithm_server.exe` to `App\bin\` as previously instructed.**
You can edit the launch script to launch the Brokenithm server when starting the game.
Edit `App\bin\start.bat` to add a line above the existing commands:
```batch hl_lines="5"
@echo off
pushd %~dp0
start /min brokenithm_server
start /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json
inject_x86 -d -k chusanhook_x86.dll chusanApp.exe
taskkill /f /im amdaemon.exe > nul 2>&1
echo.
echo Game processes have terminated
pause
```
??? info "Improving latency"
You can improve latency by running Brokenithm with your Android device tethered to
your computer. However, this requires a little extra setup:
- Connect your Android device to your computer with a USB cable.
- If you haven't enabled Developer options on your device, do it by navigating to
the "About" page in your phone's settings, then tap "Build number" seven times.
This varies by device, so if unsure, look up the instructions for your specific
one.
- Navigate to Developer options and enable USB debugging.
- On your computer, download and extract [Android SDK Platform Tools](https://dl.google.com/android/repository/platform-tools-latest-windows.zip)
to your `App\bin\` folder.
- Navigate to the `App\bin\platform-tools` folder in File Explorer, click on the
address bar, type `cmd`, and hit Enter to open a command prompt.
- In the command prompt, type the following command:
```batch
adb reverse tcp:52468 tcp:52468
```
- Start brokenithm_server in TCP mode with the -T command line flag, `brokenithm_server.exe -T`.
- On your Android device, open Brokenithm, and change the address to `0.0.0.0`.
- If the text box to the left of the "SETTINGS" button say "UDP", tap on it
once to switch to "TCP" mode.
- Tap on "START", and you will now be connected via the USB cable.
- You can now start the game as normal.
The next time you play the game, you only need to run the `adb reverse ...` command
again. To do this automatically when the game starts, add a line to the `start.bat`
script **before** the `brokenithm_server` line:
```batch hl_lines="5 6"
@echo off
pushd %~dp0
start /min platform-tools\adb reverse tcp:52468 tcp:52468
start /min brokenithm_server -T
start /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json
inject_x86 -d -k chusanhook_x86.dll chusanApp.exe
taskkill /f /im amdaemon.exe > nul 2>&1
echo.
echo Game processes have terminated
pause
```
#### iOS/iPadOS
!!! tip ""
- Install Brokenithm on your iOS/iPadOS device by joining the [Brokenithm TestFlight](https://testflight.apple.com/join/U6kwvETm) ^^(iOS 18 only)^^.
- If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different [IPA](https://redive.estertion.win/ipas/Brokenithm-iOS-build-10.ipa) with [Sideloadly](https://sideloadly.io/).
- If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, **uninstall it.**
- Install the **non-Microsoft Store** version of iTunes from the [website](https://www.apple.com/itunes/download/win64).
- Download the latest version of [Brokenithm-Evolved-iOS server](https://redive.estertion.win/ipas/Brokenithm/Brokenithm-Evolved-iOS-v0.3.7z)
and extract it to `App\bin\Brokenithm-Server`.
- Download the latest version of [Brokenithm-Evolved IO DLLs](https://gitea.tendokyu.moe/Dniel97/Brokenithm-Evolved/releases) and extract the DLL files to your `App\bin\` folder.
- Edit your `App\bin\segatools.ini` to reference the extracted DLLs:
```ini hl_lines="2"
[aimeio]
path=aime_brokenithm.dll
```
```ini hl_lines="2 3"
[chuniio]
path32=brokenithm_x86.dll
path64=brokenithm_x64.dll
```
- Run `App\bin\Brokenithm-Server\Brokenithm-Evolved-iOS.exe`. A command prompt window
should open, saying that it is waiting for a device.
- On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a
USB cable.
- Run the game as normal.
??? info "Automatically launching the Brokenithm server when starting the game"
**This will only work if you extracted the server to `App\bin\Brokenithm-Server` as previously instructed.**
You can edit the launch script to launch the Brokenithm server when starting the game.
Edit `App\bin\start.bat` to add a line above the existing commands:
```batch hl_lines="5"
@echo off
pushd %~dp0
start /min Brokenithm-Server\Brokenithm-Evolved-iOS.exe
start /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json
inject_x86 -d -k chusanhook_x86.dll chusanApp.exe
taskkill /f /im amdaemon.exe > nul 2>&1
echo.
echo Game processes have terminated
pause
```
### TASOLLER
!!! warning
This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the
controller after January 2022, the update should have already been applied.
If you've purchased the controller before then, you will need to update the touch
firmware by following the instructions on [DJ-DAO's support page](https://www.dj-dao.com/en/support/11.html).
!!! tip ""
- Install the [custom Host and LED firmware](https://pixeldrain.com/u/DajSPEoa) to your controller.
Instructions on how to do so is provided in the linked archive.
- Pick one of these two TASOLLER IO DLLs to download and extract to your `App\bin` folder.
They should be functionally the same, but if one doesn't work, you can try the other:
- [chuniio-tasoller](https://gitea.tendokyu.moe/Scribbler/chuniio-tasoller/releases) (download `lib.zip`)
- [chuniio-rs](https://gitea.tendokyu.moe/beerpsi/chuniio-rs/releases) (download `chusan.zip`)
- Edit your `App\bin\segatools.ini` to reference the extracted DLLs:
```ini
[chuniio]
path32=chuniio_tasoller.dll;(1)!
path64=chuniio_tasoller_x64.dll;(2)!
```
1. Or `chuniio_tasoller_v2_chusan.dll` if you downloaded `chuniio-rs`.
2. Or `chuniio_tasoller_v2_amdaemon.dll` if you downloaded `chuniio-rs`.
- Connect the controller to your computer, and then start the game.
### YubiDeck
!!! tip ""
- Switch your YubiDeck to HID output mode. Instructions on how to do so are provided
in the [YubiDeck manual](https://drive.google.com/file/d/11KVlKbg3zGCRwI7R-30t2IJc6OQwDEgo/view).
- Download the latest version of [YubiDeck IO DLLs](https://gitea.tendokyu.moe/beerpsi/chuniio-yubideck/releases)
and extract it to your `App\bin` folder.
- Edit your `App\bin\segatools.ini` to reference the extracted DLLs:
```ini
[chuniio]
path32=chuniio_yubideck_chusan.dll
path64=chuniio_yubideck_amdaemon.dll
```
- Optionally, reference the included AimeIO DLL to use the controller's
built-in card reader:
```ini
[aimeio]
path=aimeio_yubideck.dll
```
- Connect the controller to your computer, and then start the game.
### Laverita 3
!!! tip ""
- Switch your Laverita to IO mode. You can do so in ConfigApp
found in the yuancon [discord](https://discord.gg/4ncuRrq).
- Change the COM port of your controller. You can do so in
Device manager by looking for `USB Serial Device` you may need to unplug and replug your controller to properly idetify which one is the Laverita.
- Double click on it
- Go to Port Settings
- Click on Advanced
- From the dropdown select COM1
- Restart to ensure changes took effect and saved
- Edit your `App\bin\segatools.ini` to disable io emulation and set led:
```ini
[led]
; Output billboard LED strip data to a named pipe called "\\.\pipe\chuni_led"
cabLedOutputPipe=0
; Output billboard LED strip data to serial
cabLedOutputSerial=1
; Output slider LED data to the named pipe
controllerLedOutputPipe=0
; Output slider LED data to the serial port
controllerLedOutputSerial=1
; Use the OpeNITHM protocol for serial LED output
controllerLedOutputOpeNITHM=0
; Serial port to send data to if using serial output. Default is COM5.
serialPort=COM1
; Baud rate for serial data (set to 115200 if using OpeNITHM)
serialBaud=9600
[slider]
; Enable slider emulation. If you have real AC slider, set this to 0.
; Slider serial port must be COM1.
enable=0
[io4]
enable=0
```
- Then start the game.
### Arcade hardware and other controllers
!!! tip ""
If you're interested in using a cabinet slider and air sensors, or possibly even
making your own controller, the [Cons&Stuff website](https://consandstuff.github.io/)
and Discord community is a great place to start!

View File

@ -103,7 +103,7 @@
### Patching the game
!!! info "Go through the [Web Patching](../../extras/patchweb.md) guide to learn how to use a web patcher."
!!! info "Go through the [Web Patching](/extras/patchweb.md) guide to learn how to use a web patcher."
There are **many** patches for CHUNITHM.
@ -386,4 +386,4 @@
!!! warning "Have any other issues?"
Check out the [Troubleshooting](./troubleshooting.md) and [Error Codes](../../errorcodes/sega.md) pages.
Check out the [Troubleshooting](./troubleshooting.md) and [Error Codes](/errorcodes/sega.md) pages.

View File

@ -1,130 +1,130 @@
!!! danger "Please make sure you downloaded your data from an appropriate source.<br>This guide is unable to troubleshoot any problems related to bad or poorly managed data."
---
### My game crashes on launch!
!!! tip ""
Could be due to **many** things, the most common of which are:
- `amdaemon` crashing in the background. Make sure that the `config_*.json` files
have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
- Using the incorrect dipswitch settings for your refresh rate (e.g. `dipsw3=0` on
a 60Hz screen). Refer to the game setup guide to fix it.
- Enabling 120FPS on a monitor that is not **exactly 120Hz** or **exactly 1080p**.
If you cannot set your monitor's refresh rate to 120Hz, apply the "Bypass 120Hz
monitor check"/"Bypass 1080p monitor check" on a CHUNITHM web patcher (see [Resources](../../resources.md#web-patchers)).
??? info "Capturing logs from `amdaemon` for troubleshooting"
To assist with troubleshooting, a script can be used to capture logs from `amdaemon`. Create a file named
`amdaemontest.bat` in `App\bin`, then paste the code block below into the file.
```batch
@echo off
cls
echo Attempting to run AM Daemon ...
echo Window should close after 30 seconds
echo Log will be generated at amdaemontest.txt
call :sub >amdaemontest.txt
exit /b
:sub
set OPENSSL_ia32cap=:~0x20000000
pushd %~dp0
start /b "AM Daemon" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json
ping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe
```
Double-click it to run. The script should run for 30 seconds, and you will get a file
named `amdaemontest.txt` in `App\bin`, which you can send to help people troubleshoot your issue.
---
### My game takes a long time to boot!
!!! tip ""
CHUNITHM game files consist of thousands of small XML files, which Windows Defender
takes a long time to scan through. Add your game folder to the Windows Defender
exclusion list.
!!! danger
Doing this will prevent Windows Defender from scanning your game folder for viruses.
Only do this if you trust the source of the data.
---
### My game is running too slow/fast
!!! tip ""
The game could be running under or over its required refresh rate.
- Make sure V-Sync isn't disabled in your graphics settings (called "Vertical sync"
in NVIDIA Control Panel and "Wait for Vertical Refresh" in AMD Control Panel.)
- Make sure your monitor's refresh rate is set to 60Hz or 120Hz.
It could also be that your computer's performance isn't good enough to keep
a steady framerate.
---
### My game is stuttering
!!! tip ""
For NVIDIA users, create an override for `chusanApp.exe` in NVIDIA Control Panel
and change "Power management mode" to "**Prefer maximum performance**".
---
### My game crashes when I tab out of fullscreen!
!!! tip ""
As the game is intended to run on arcade hardware, it doesn't like being minimized.
One workaround for this is to use DXVK. Download the latest version from [releases](https://github.com/doitsujin/dxvk/releases/latest).
This will be a `dxvk-x.y.z.tar.gz` file, which you can open using [7zip](https://www.7-zip.org/).
Navigate to the `x32` folder, and copy the `d3d9.dll` file to your game's `App\bin` folder, agreeing
to overwrite when asked.
You should now be able to tab out of fullscreen without crashing the game.
!!! warning
The game will not ignore inputs when out of focus.
This means any controller inputs will still be accepted, so try not to lean onto
your slider whilst tabbed out!
This also means that you can accidentally enter the service menu by hitting your
`Test` key even if the game is minimised. If you were in the middle of a credit,
**your scores will be lost.**
---
### When I run the game all other audio is gone!
!!! tip ""
CHUNITHM uses [WASAPI exclusive mode](https://docs.microsoft.com/en-us/windows/win32/coreaudio/exclusive-mode-streams)
for audio to get better latency.
You can apply the "Shared Audio" patch on a CHUNITHM web patcher (see [Resources](../../resources.md#web-patchers))
to hear audio outside of the game at the cost of audio latency.
---
### Cabinet-to-Cabinet(c2c) Fixes
!!! tip ""
c2c can have many problems but you can fix most of them by applying the "Patch for head-to-head play" and disabling "Set all timers to 999" on a CHUNITHM web patcher (see [Resources](../../resources.md#web-patchers)).
If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.
If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.
!!! danger "Please make sure you downloaded your data from an appropriate source.<br>This guide is unable to troubleshoot any problems related to bad or poorly managed data."
---
### My game crashes on launch!
!!! tip ""
Could be due to **many** things, the most common of which are:
- `amdaemon` crashing in the background. Make sure that the `config_*.json` files
have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
- Using the incorrect dipswitch settings for your refresh rate (e.g. `dipsw3=0` on
a 60Hz screen). Refer to the game setup guide to fix it.
- Enabling 120FPS on a monitor that is not **exactly 120Hz** or **exactly 1080p**.
If you cannot set your monitor's refresh rate to 120Hz, apply the "Bypass 120Hz
monitor check"/"Bypass 1080p monitor check" on a CHUNITHM web patcher (see [Resources](/resources.md#web-patchers)).
??? info "Capturing logs from `amdaemon` for troubleshooting"
To assist with troubleshooting, a script can be used to capture logs from `amdaemon`. Create a file named
`amdaemontest.bat` in `App\bin`, then paste the code block below into the file.
```batch
@echo off
cls
echo Attempting to run AM Daemon ...
echo Window should close after 30 seconds
echo Log will be generated at amdaemontest.txt
call :sub >amdaemontest.txt
exit /b
:sub
set OPENSSL_ia32cap=:~0x20000000
pushd %~dp0
start /b "AM Daemon" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json
ping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe
```
Double-click it to run. The script should run for 30 seconds, and you will get a file
named `amdaemontest.txt` in `App\bin`, which you can send to help people troubleshoot your issue.
---
### My game takes a long time to boot!
!!! tip ""
CHUNITHM game files consist of thousands of small XML files, which Windows Defender
takes a long time to scan through. Add your game folder to the Windows Defender
exclusion list.
!!! danger
Doing this will prevent Windows Defender from scanning your game folder for viruses.
Only do this if you trust the source of the data.
---
### My game is running too slow/fast
!!! tip ""
The game could be running under or over its required refresh rate.
- Make sure V-Sync isn't disabled in your graphics settings (called "Vertical sync"
in NVIDIA Control Panel and "Wait for Vertical Refresh" in AMD Control Panel.)
- Make sure your monitor's refresh rate is set to 60Hz or 120Hz.
It could also be that your computer's performance isn't good enough to keep
a steady framerate.
---
### My game is stuttering
!!! tip ""
For NVIDIA users, create an override for `chusanApp.exe` in NVIDIA Control Panel
and change "Power management mode" to "**Prefer maximum performance**".
---
### My game crashes when I tab out of fullscreen!
!!! tip ""
As the game is intended to run on arcade hardware, it doesn't like being minimized.
One workaround for this is to use DXVK. Download the latest version from [releases](https://github.com/doitsujin/dxvk/releases/latest).
This will be a `dxvk-x.y.z.tar.gz` file, which you can open using [7zip](https://www.7-zip.org/).
Navigate to the `x32` folder, and copy the `d3d9.dll` file to your game's `App\bin` folder, agreeing
to overwrite when asked.
You should now be able to tab out of fullscreen without crashing the game.
!!! warning
The game will not ignore inputs when out of focus.
This means any controller inputs will still be accepted, so try not to lean onto
your slider whilst tabbed out!
This also means that you can accidentally enter the service menu by hitting your
`Test` key even if the game is minimised. If you were in the middle of a credit,
**your scores will be lost.**
---
### When I run the game all other audio is gone!
!!! tip ""
CHUNITHM uses [WASAPI exclusive mode](https://docs.microsoft.com/en-us/windows/win32/coreaudio/exclusive-mode-streams)
for audio to get better latency.
You can apply the "Shared Audio" patch on a CHUNITHM web patcher (see [Resources](/resources.md#web-patchers))
to hear audio outside of the game at the cost of audio latency.
---
### Cabinet-to-Cabinet(c2c) Fixes
!!! tip ""
c2c can have many problems but you can fix most of them by applying the "Patch for head-to-head play" and disabling "Set all timers to 999" on a CHUNITHM web patcher (see [Resources](/resources.md#web-patchers)).
If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.
If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

View File

@ -1,4 +1,4 @@
# Cab-to-Cab Play over Internet (LUMINOUS)
<img src="/img/chunithm/sdhd/luminous.png">
--8<-- "docs/games/chusan/c2c.md"
--8<-- "docs/games/sega/chunithm/common/chusan/c2c.md"

View File

@ -1,4 +1,4 @@
# Controllers (LUMINOUS)
<img src="/img/chunithm/sdhd/luminous.png">
--8<-- "docs/games/chusan/controllers.md"
--8<-- "docs/games/sega/chunithm/common/chusan/controllers.md"

View File

@ -1,4 +1,4 @@
# Game Setup (LUMINOUS)
<img src="/img/chunithm/sdhd/luminous.png">
--8<-- "docs/games/chusan/setup.md"
# Game Setup (LUMINOUS)
<img src="/img/chunithm/sdhd/luminous.png">
--8<-- "docs/games/sega/chunithm/common/chusan/setup.md"

View File

@ -1,4 +1,4 @@
# Troubleshooting (LUMINOUS)
<img src="/img/chunithm/sdhd/luminous.png">
--8<-- "docs/games/chusan/troubleshooting.md"
--8<-- "docs/games/sega/chunithm/common/chusan/troubleshooting.md"

View File

@ -1,4 +1,4 @@
# Cab-to-Cab Play over Internet (LUMINOUS PLUS)
<img src="/img/chunithm/sdhd/luminousplus.png">
--8<-- "docs/games/chusan/c2c.md"
--8<-- "docs/games/sega/chunithm/common/chusan/c2c.md"

View File

@ -1,4 +1,4 @@
# Controllers (LUMINOUS PLUS)
<img src="/img/chunithm/sdhd/luminousplus.png">
--8<-- "docs/games/chusan/controllers.md"
--8<-- "docs/games/sega/chunithm/common/chusan/controllers.md"

View File

@ -1,4 +1,4 @@
# Game Setup (LUMINOUS PLUS)
<img src="/img/chunithm/sdhd/luminousplus.png">
--8<-- "docs/games/chusan/setup.md"
# Game Setup (LUMINOUS PLUS)
<img src="/img/chunithm/sdhd/luminousplus.png">
--8<-- "docs/games/sega/chunithm/common/chusan/setup.md"

View File

@ -1,4 +1,4 @@
# Troubleshooting (LUMINOUS PLUS)
<img src="/img/chunithm/sdhd/luminousplus.png">
--8<-- "docs/games/chusan/troubleshooting.md"
--8<-- "docs/games/sega/chunithm/common/chusan/troubleshooting.md"

View File

@ -1,4 +1,4 @@
# Cab-to-Cab Play over Internet (NEW)
<img src="/img/chunithm/sdhd/new.png">
--8<-- "docs/games/chusan/c2c.md"
--8<-- "docs/games/sega/chunithm/common/chusan/c2c.md"

View File

@ -0,0 +1,4 @@
# Controllers (NEW)
<img src="/img/chunithm/sdhd/new.png">
--8<-- "docs/games/sega/chunithm/common/chusan/controllers.md"

View File

@ -1,4 +1,4 @@
# Game Setup (NEW)
<img src="/img/chunithm/sdhd/new.png">
--8<-- "docs/games/chusan/setup.md"
--8<-- "docs/games/sega/chunithm/common/chusan/setup.md"

View File

@ -0,0 +1,4 @@
# Troubleshooting (NEW)
<img src="/img/chunithm/sdhd/new.png">
--8<-- "docs/games/sega/chunithm/common/chusan/troubleshooting.md"

View File

@ -1,4 +1,4 @@
# Cab-to-Cab Play over Internet (NEW PLUS)
<img src="/img/chunithm/sdhd/newplus.png">
--8<-- "docs/games/chusan/c2c.md"
--8<-- "docs/games/sega/chunithm/common/chusan/c2c.md"

View File

@ -1,4 +1,4 @@
# Controllers (NEW PLUS)
<img src="/img/chunithm/sdhd/newplus.png">
--8<-- "docs/games/chusan/controllers.md"
--8<-- "docs/games/sega/chunithm/common/chusan/controllers.md"

View File

@ -1,4 +1,4 @@
# Game Setup (NEW PLUS)
<img src="/img/chunithm/sdhd/newplus.png">
--8<-- "docs/games/chusan/setup.md"
--8<-- "docs/games/sega/chunithm/common/chusan/setup.md"

View File

@ -1,4 +1,4 @@
# Troubleshooting (NEW PLUS)
<img src="/img/chunithm/sdhd/newplus.png">
--8<-- "docs/games/chusan/troubleshooting.md"
--8<-- "docs/games/sega/chunithm/common/chusan/troubleshooting.md"

View File

@ -1,4 +1,4 @@
# Cab-to-Cab Play over Internet (SUN)
<img src="/img/chunithm/sdhd/sun.png">
--8<-- "docs/games/chusan/c2c.md"
--8<-- "docs/games/sega/chunithm/common/chusan/c2c.md"

View File

@ -0,0 +1,4 @@
# Controllers (SUN)
<img src="/img/chunithm/sdhd/sun.png">
--8<-- "docs/games/sega/chunithm/common/chusan/controllers.md"

View File

@ -1,4 +1,4 @@
# Game Setup (SUN)
<img src="/img/chunithm/sdhd/sun.png">
--8<-- "docs/games/chusan/setup.md"
--8<-- "docs/games/sega/chunithm/common/chusan/setup.md"

View File

@ -0,0 +1,4 @@
# Troubleshooting (SUN)
<img src="/img/chunithm/sdhd/sun.png">
--8<-- "docs/games/sega/chunithm/common/chusan/troubleshooting.md"

View File

@ -1,4 +1,4 @@
# Cab-to-Cab Play over Internet (SUN PLUS)
<img src="/img/chunithm/sdhd/sunplus.png">
--8<-- "docs/games/chusan/c2c.md"
--8<-- "docs/games/sega/chunithm/common/chusan/c2c.md"

View File

@ -1,4 +1,4 @@
# Controllers (SUN PLUS)
<img src="/img/chunithm/sdhd/sunplus.png">
--8<-- "docs/games/chusan/controllers.md"
--8<-- "docs/games/sega/chunithm/common/chusan/controllers.md"

View File

@ -1,4 +1,4 @@
# Game Setup (SUN PLUS)
<img src="/img/chunithm/sdhd/sunplus.png">
--8<-- "docs/games/chusan/setup.md"
--8<-- "docs/games/sega/chunithm/common/chusan/setup.md"

View File

@ -1,4 +1,4 @@
# Troubleshooting (SUN PLUS)
<img src="/img/chunithm/sdhd/sunplus.png">
--8<-- "docs/games/chusan/troubleshooting.md"
--8<-- "docs/games/sega/chunithm/common/chusan/troubleshooting.md"

View File

@ -1,4 +1,4 @@
# Cab-to-Cab Play over Internet (VERSE)
<img src="/img/chunithm/sdhd/verse.png">
--8<-- "docs/games/chusan/c2c.md"
--8<-- "docs/games/sega/chunithm/common/chusan/c2c.md"

View File

@ -1,4 +1,4 @@
# Controllers (VERSE)
<img src="/img/chunithm/sdhd/verse.png">
--8<-- "docs/games/chusan/controllers.md"
--8<-- "docs/games/sega/chunithm/common/chusan/controllers.md"

View File

@ -1,4 +1,4 @@
# Game Setup (VERSE)
<img src="/img/chunithm/sdhd/verse.png">
--8<-- "docs/games/chusan/setup.md"
--8<-- "docs/games/sega/chunithm/common/chusan/setup.md"

View File

@ -121,40 +121,40 @@ nav:
- SEGA:
- "CHUNITHM":
- "NEW":
- "Game Setup": "games/chunithmnew/setup.md"
- "Controllers": "games/chunithmnew/controllers.md"
- "Cab-to-Cab": "games/chunithmnew/c2c.md"
- "Troubleshooting": "games/chunithmnew/troubleshooting.md"
- "Game Setup": "games/sega/chunithm/new/setup.md"
- "Controllers": "games/sega/chunithm/new/controllers.md"
- "Cab-to-Cab": "games/sega/chunithm/new/c2c.md"
- "Troubleshooting": "games/sega/chunithm/new/troubleshooting.md"
- "NEW PLUS":
- "Game Setup": "games/chunithmnewplus/setup.md"
- "Controllers": "games/chunithmnewplus/controllers.md"
- "Troubleshooting": "games/chunithmnewplus/troubleshooting.md"
- "Cab-to-Cab": "games/chunithmnewplus/c2c.md"
- "Game Setup": "games/sega/chunithm/newplus/setup.md"
- "Controllers": "games/sega/chunithm/newplus/controllers.md"
- "Troubleshooting": "games/sega/chunithm/newplus/troubleshooting.md"
- "Cab-to-Cab": "games/sega/chunithm/newplus/c2c.md"
- "SUN":
- "Game Setup": "games/chunithmsun/setup.md"
- "Controllers": "games/chunithmsun/controllers.md"
- "Troubleshooting": "games/chunithmsun/troubleshooting.md"
- "Cab-to-Cab": "games/chunithmsun/c2c.md"
- "Game Setup": "games/sega/chunithm/sun/setup.md"
- "Controllers": "games/sega/chunithm/sun/controllers.md"
- "Troubleshooting": "games/sega/chunithm/sun/troubleshooting.md"
- "Cab-to-Cab": "games/sega/chunithm/sun/c2c.md"
- "SUN PLUS":
- "Game Setup": "games/chunithmsunplus/setup.md"
- "Controllers": "games/chunithmsunplus/controllers.md"
- "Troubleshooting": "games/chunithmsunplus/troubleshooting.md"
- "Cab-to-Cab": "games/chunithmsunplus/c2c.md"
- "Game Setup": "games/sega/chunithm/sunplus/setup.md"
- "Controllers": "games/sega/chunithm/sunplus/controllers.md"
- "Troubleshooting": "games/sega/chunithm/sunplus/troubleshooting.md"
- "Cab-to-Cab": "games/sega/chunithm/sunplus/c2c.md"
- "LUMINOUS":
- "Game Setup": "games/chunithmluminous/setup.md"
- "Controllers": "games/chunithmluminous/controllers.md"
- "Troubleshooting": "games/chunithmluminous/troubleshooting.md"
- "Cab-to-Cab": "games/chunithmluminous/c2c.md"
- "Game Setup": "games/sega/chunithm/luminous/setup.md"
- "Controllers": "games/sega/chunithm/luminous/controllers.md"
- "Troubleshooting": "games/sega/chunithm/luminous/troubleshooting.md"
- "Cab-to-Cab": "games/sega/chunithm/luminous/c2c.md"
- "LUMINOUS PLUS":
- "Game Setup": "games/chunithmluminousplus/setup.md"
- "Controllers": "games/chunithmluminousplus/controllers.md"
- "Troubleshooting": "games/chunithmluminousplus/troubleshooting.md"
- "Cab-to-Cab": "games/chunithmluminousplus/c2c.md"
- "Game Setup": "games/sega/chunithm/luminousplus/setup.md"
- "Controllers": "games/sega/chunithm/luminousplus/controllers.md"
- "Troubleshooting": "games/sega/chunithm/luminousplus/troubleshooting.md"
- "Cab-to-Cab": "games/sega/chunithm/luminousplus/c2c.md"
- "VERSE":
- "Game Setup": "games/chunithmverse/setup.md"
- "Controllers": "games/chunithmverse/controllers.md"
- "Troubleshooting": "games/chunithmverse/troubleshooting.md"
- "Cab-to-Cab": "games/chunithmverse/c2c.md"
- "Game Setup": "games/sega/chunithm/verse/setup.md"
- "Controllers": "games/sega/chunithm/verse/controllers.md"
- "Troubleshooting": "games/sega/chunithm/verse/troubleshooting.md"
- "Cab-to-Cab": "games/sega/chunithm/verse/c2c.md"
- "maimai DX":
- "BUDDiES":
- "Game Setup": "games/maimaidx/buddies/setup.md"
@ -208,7 +208,7 @@ nav:
- Other Resources: resources.md
not_in_nav: |
games/chusan
games/sega/chunithm/common
games/mu3
games/mercury
games/mai2