From 22710cc195ed7a7afb7caa9a27f7c02e68d1c534 Mon Sep 17 00:00:00 2001 From: beerpiss Date: Thu, 28 Nov 2024 13:10:56 +0700 Subject: [PATCH 1/4] [chunithm] mention Bottersnike's custom TASOLLER firmware, now that there's a public release --- docs/games/chunithmluminous/controllers.md | 18 +- docs/games/chunithmnew/controllers.md | 16 +- docs/games/chunithmnewplus/controllers.md | 618 +++++++++++---------- docs/games/chunithmsun/controllers.md | 618 +++++++++++---------- docs/games/chunithmsunplus/controllers.md | 618 +++++++++++---------- 5 files changed, 978 insertions(+), 910 deletions(-) diff --git a/docs/games/chunithmluminous/controllers.md b/docs/games/chunithmluminous/controllers.md index 065fac1..0fc1009 100644 --- a/docs/games/chunithmluminous/controllers.md +++ b/docs/games/chunithmluminous/controllers.md @@ -246,7 +246,21 @@ 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 "" +!!! danger "Please choose one of the two solutions, not both!" + +??? tip "Bottersnike's custom firmware" + + Bottersnike has written custom firmware for the TASOLLER which fixes many issues with the original + firmware (e.g. dropped and ghost inputs). + + To install this firmware, download the latest version of + :material-file-code:`TASOLLER-FirmwareUpdater.exe`, :material-file-cog:`host_aprom.bin` and + :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), + then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). + + You do not need any IO DLLs for this. + +??? warning "HID custom firmware" - 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. @@ -299,4 +313,4 @@ 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! \ No newline at end of file + and Discord community is a great place to start! diff --git a/docs/games/chunithmnew/controllers.md b/docs/games/chunithmnew/controllers.md index 63aaa8d..7b1241f 100644 --- a/docs/games/chunithmnew/controllers.md +++ b/docs/games/chunithmnew/controllers.md @@ -246,7 +246,19 @@ 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 "" +!!! danger "Please choose one of the two solutions, not both!" + +??? tip "Bottersnike's custom firmware" + + Bottersnike has written custom firmware for the TASOLLER which fixes many issues with the original + firmware (e.g. dropped and ghost inputs). + + To install this firmware, download the latest version of + :material-file-code:`TASOLLER-FirmwareUpdater.exe`, :material-file-cog:`host_aprom.bin` and + :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), + then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). + +??? warning "HID custom firmware" - 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. @@ -299,4 +311,4 @@ 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! \ No newline at end of file + and Discord community is a great place to start! diff --git a/docs/games/chunithmnewplus/controllers.md b/docs/games/chunithmnewplus/controllers.md index cff8054..0fc1009 100644 --- a/docs/games/chunithmnewplus/controllers.md +++ b/docs/games/chunithmnewplus/controllers.md @@ -1,302 +1,316 @@ -# CHUNITHM NEW PLUS - - -!!! danger "Please make sure you downloaded your data from an appropriate source.
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: - - - - 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.exe`. - - 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" - @echo off - - pushd %~dp0 - - start /min platform-tools\adb reverse tcp:52468 tcp:52468 - 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 - ``` - -#### 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. - -### 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! \ No newline at end of file +# CHUNITHM LUMINOUS + + +!!! danger "Please make sure you downloaded your data from an appropriate source.
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: + + + + 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.exe`. + - 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" + @echo off + + pushd %~dp0 + + start /min platform-tools\adb reverse tcp:52468 tcp:52468 + 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 + ``` + +#### 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). + +!!! danger "Please choose one of the two solutions, not both!" + +??? tip "Bottersnike's custom firmware" + + Bottersnike has written custom firmware for the TASOLLER which fixes many issues with the original + firmware (e.g. dropped and ghost inputs). + + To install this firmware, download the latest version of + :material-file-code:`TASOLLER-FirmwareUpdater.exe`, :material-file-cog:`host_aprom.bin` and + :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), + then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). + + You do not need any IO DLLs for this. + +??? warning "HID custom firmware" + + - 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. + +### 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! diff --git a/docs/games/chunithmsun/controllers.md b/docs/games/chunithmsun/controllers.md index aae4c6b..0fc1009 100644 --- a/docs/games/chunithmsun/controllers.md +++ b/docs/games/chunithmsun/controllers.md @@ -1,302 +1,316 @@ -# CHUNITHM SUN - - -!!! danger "Please make sure you downloaded your data from an appropriate source.
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: - - - - 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.exe`. - - 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" - @echo off - - pushd %~dp0 - - start /min platform-tools\adb reverse tcp:52468 tcp:52468 - 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 - ``` - -#### 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. - -### 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! \ No newline at end of file +# CHUNITHM LUMINOUS + + +!!! danger "Please make sure you downloaded your data from an appropriate source.
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: + + + + 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.exe`. + - 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" + @echo off + + pushd %~dp0 + + start /min platform-tools\adb reverse tcp:52468 tcp:52468 + 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 + ``` + +#### 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). + +!!! danger "Please choose one of the two solutions, not both!" + +??? tip "Bottersnike's custom firmware" + + Bottersnike has written custom firmware for the TASOLLER which fixes many issues with the original + firmware (e.g. dropped and ghost inputs). + + To install this firmware, download the latest version of + :material-file-code:`TASOLLER-FirmwareUpdater.exe`, :material-file-cog:`host_aprom.bin` and + :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), + then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). + + You do not need any IO DLLs for this. + +??? warning "HID custom firmware" + + - 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. + +### 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! diff --git a/docs/games/chunithmsunplus/controllers.md b/docs/games/chunithmsunplus/controllers.md index 5f9bb0f..0fc1009 100644 --- a/docs/games/chunithmsunplus/controllers.md +++ b/docs/games/chunithmsunplus/controllers.md @@ -1,302 +1,316 @@ -# CHUNITHM SUN PLUS - - -!!! danger "Please make sure you downloaded your data from an appropriate source.
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: - - - - 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.exe`. - - 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" - @echo off - - pushd %~dp0 - - start /min platform-tools\adb reverse tcp:52468 tcp:52468 - 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 - ``` - -#### 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. - -### 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! \ No newline at end of file +# CHUNITHM LUMINOUS + + +!!! danger "Please make sure you downloaded your data from an appropriate source.
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: + + + + 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.exe`. + - 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" + @echo off + + pushd %~dp0 + + start /min platform-tools\adb reverse tcp:52468 tcp:52468 + 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 + ``` + +#### 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). + +!!! danger "Please choose one of the two solutions, not both!" + +??? tip "Bottersnike's custom firmware" + + Bottersnike has written custom firmware for the TASOLLER which fixes many issues with the original + firmware (e.g. dropped and ghost inputs). + + To install this firmware, download the latest version of + :material-file-code:`TASOLLER-FirmwareUpdater.exe`, :material-file-cog:`host_aprom.bin` and + :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), + then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). + + You do not need any IO DLLs for this. + +??? warning "HID custom firmware" + + - 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. + +### 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! From 7625bef94662ae4bc0fc626f0160df77aeebc2c0 Mon Sep 17 00:00:00 2001 From: beerpiss Date: Thu, 28 Nov 2024 13:12:59 +0700 Subject: [PATCH 2/4] fix: end of line endings --- docs/games/chunithmnewplus/controllers.md | 632 +++++++++++----------- docs/games/chunithmsun/controllers.md | 632 +++++++++++----------- docs/games/chunithmsunplus/controllers.md | 632 +++++++++++----------- 3 files changed, 948 insertions(+), 948 deletions(-) diff --git a/docs/games/chunithmnewplus/controllers.md b/docs/games/chunithmnewplus/controllers.md index 0fc1009..f2e4275 100644 --- a/docs/games/chunithmnewplus/controllers.md +++ b/docs/games/chunithmnewplus/controllers.md @@ -1,316 +1,316 @@ -# CHUNITHM LUMINOUS - - -!!! danger "Please make sure you downloaded your data from an appropriate source.
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: - - - - 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.exe`. - - 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" - @echo off - - pushd %~dp0 - - start /min platform-tools\adb reverse tcp:52468 tcp:52468 - 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 - ``` - -#### 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). - -!!! danger "Please choose one of the two solutions, not both!" - -??? tip "Bottersnike's custom firmware" - - Bottersnike has written custom firmware for the TASOLLER which fixes many issues with the original - firmware (e.g. dropped and ghost inputs). - - To install this firmware, download the latest version of - :material-file-code:`TASOLLER-FirmwareUpdater.exe`, :material-file-cog:`host_aprom.bin` and - :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), - then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). - - You do not need any IO DLLs for this. - -??? warning "HID custom firmware" - - - 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. - -### 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! +# CHUNITHM LUMINOUS + + +!!! danger "Please make sure you downloaded your data from an appropriate source.
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: + + + + 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.exe`. + - 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" + @echo off + + pushd %~dp0 + + start /min platform-tools\adb reverse tcp:52468 tcp:52468 + 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 + ``` + +#### 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). + +!!! danger "Please choose one of the two solutions, not both!" + +??? tip "Bottersnike's custom firmware" + + Bottersnike has written custom firmware for the TASOLLER which fixes many issues with the original + firmware (e.g. dropped and ghost inputs). + + To install this firmware, download the latest version of + :material-file-code:`TASOLLER-FirmwareUpdater.exe`, :material-file-cog:`host_aprom.bin` and + :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), + then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). + + You do not need any IO DLLs for this. + +??? warning "HID custom firmware" + + - 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. + +### 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! diff --git a/docs/games/chunithmsun/controllers.md b/docs/games/chunithmsun/controllers.md index 0fc1009..f2e4275 100644 --- a/docs/games/chunithmsun/controllers.md +++ b/docs/games/chunithmsun/controllers.md @@ -1,316 +1,316 @@ -# CHUNITHM LUMINOUS - - -!!! danger "Please make sure you downloaded your data from an appropriate source.
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: - - - - 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.exe`. - - 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" - @echo off - - pushd %~dp0 - - start /min platform-tools\adb reverse tcp:52468 tcp:52468 - 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 - ``` - -#### 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). - -!!! danger "Please choose one of the two solutions, not both!" - -??? tip "Bottersnike's custom firmware" - - Bottersnike has written custom firmware for the TASOLLER which fixes many issues with the original - firmware (e.g. dropped and ghost inputs). - - To install this firmware, download the latest version of - :material-file-code:`TASOLLER-FirmwareUpdater.exe`, :material-file-cog:`host_aprom.bin` and - :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), - then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). - - You do not need any IO DLLs for this. - -??? warning "HID custom firmware" - - - 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. - -### 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! +# CHUNITHM LUMINOUS + + +!!! danger "Please make sure you downloaded your data from an appropriate source.
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: + + + + 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.exe`. + - 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" + @echo off + + pushd %~dp0 + + start /min platform-tools\adb reverse tcp:52468 tcp:52468 + 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 + ``` + +#### 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). + +!!! danger "Please choose one of the two solutions, not both!" + +??? tip "Bottersnike's custom firmware" + + Bottersnike has written custom firmware for the TASOLLER which fixes many issues with the original + firmware (e.g. dropped and ghost inputs). + + To install this firmware, download the latest version of + :material-file-code:`TASOLLER-FirmwareUpdater.exe`, :material-file-cog:`host_aprom.bin` and + :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), + then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). + + You do not need any IO DLLs for this. + +??? warning "HID custom firmware" + + - 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. + +### 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! diff --git a/docs/games/chunithmsunplus/controllers.md b/docs/games/chunithmsunplus/controllers.md index 0fc1009..f2e4275 100644 --- a/docs/games/chunithmsunplus/controllers.md +++ b/docs/games/chunithmsunplus/controllers.md @@ -1,316 +1,316 @@ -# CHUNITHM LUMINOUS - - -!!! danger "Please make sure you downloaded your data from an appropriate source.
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: - - - - 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.exe`. - - 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" - @echo off - - pushd %~dp0 - - start /min platform-tools\adb reverse tcp:52468 tcp:52468 - 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 - ``` - -#### 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). - -!!! danger "Please choose one of the two solutions, not both!" - -??? tip "Bottersnike's custom firmware" - - Bottersnike has written custom firmware for the TASOLLER which fixes many issues with the original - firmware (e.g. dropped and ghost inputs). - - To install this firmware, download the latest version of - :material-file-code:`TASOLLER-FirmwareUpdater.exe`, :material-file-cog:`host_aprom.bin` and - :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), - then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). - - You do not need any IO DLLs for this. - -??? warning "HID custom firmware" - - - 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. - -### 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! +# CHUNITHM LUMINOUS + + +!!! danger "Please make sure you downloaded your data from an appropriate source.
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: + + + + 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.exe`. + - 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" + @echo off + + pushd %~dp0 + + start /min platform-tools\adb reverse tcp:52468 tcp:52468 + 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 + ``` + +#### 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). + +!!! danger "Please choose one of the two solutions, not both!" + +??? tip "Bottersnike's custom firmware" + + Bottersnike has written custom firmware for the TASOLLER which fixes many issues with the original + firmware (e.g. dropped and ghost inputs). + + To install this firmware, download the latest version of + :material-file-code:`TASOLLER-FirmwareUpdater.exe`, :material-file-cog:`host_aprom.bin` and + :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), + then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). + + You do not need any IO DLLs for this. + +??? warning "HID custom firmware" + + - 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. + +### 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! From 6d9c9b7fcf21c37f19c49a76f08dbc5399196548 Mon Sep 17 00:00:00 2001 From: beerpiss Date: Thu, 28 Nov 2024 13:14:22 +0700 Subject: [PATCH 3/4] fix: certified copy pasting moment --- docs/games/chunithmnewplus/controllers.md | 4 ++-- docs/games/chunithmsun/controllers.md | 4 ++-- docs/games/chunithmsunplus/controllers.md | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/games/chunithmnewplus/controllers.md b/docs/games/chunithmnewplus/controllers.md index f2e4275..45b986c 100644 --- a/docs/games/chunithmnewplus/controllers.md +++ b/docs/games/chunithmnewplus/controllers.md @@ -1,5 +1,5 @@ -# CHUNITHM LUMINOUS - +# CHUNITHM NEW PLUS + !!! danger "Please make sure you downloaded your data from an appropriate source.
This guide is unable to troubleshoot any problems related to bad or poorly managed data." diff --git a/docs/games/chunithmsun/controllers.md b/docs/games/chunithmsun/controllers.md index f2e4275..a4c7540 100644 --- a/docs/games/chunithmsun/controllers.md +++ b/docs/games/chunithmsun/controllers.md @@ -1,5 +1,5 @@ -# CHUNITHM LUMINOUS - +# CHUNITHM SUN + !!! danger "Please make sure you downloaded your data from an appropriate source.
This guide is unable to troubleshoot any problems related to bad or poorly managed data." diff --git a/docs/games/chunithmsunplus/controllers.md b/docs/games/chunithmsunplus/controllers.md index f2e4275..d2e1c4c 100644 --- a/docs/games/chunithmsunplus/controllers.md +++ b/docs/games/chunithmsunplus/controllers.md @@ -1,5 +1,5 @@ -# CHUNITHM LUMINOUS - +# CHUNITHM SUN PLUS + !!! danger "Please make sure you downloaded your data from an appropriate source.
This guide is unable to troubleshoot any problems related to bad or poorly managed data." From 1054b1b53aa4246536f51407a0f734c6806b6cf1 Mon Sep 17 00:00:00 2001 From: beerpiss Date: Thu, 28 Nov 2024 13:15:53 +0700 Subject: [PATCH 4/4] fix: also mention in chunithm new --- docs/games/chunithmnew/controllers.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/games/chunithmnew/controllers.md b/docs/games/chunithmnew/controllers.md index 7b1241f..14da1cc 100644 --- a/docs/games/chunithmnew/controllers.md +++ b/docs/games/chunithmnew/controllers.md @@ -258,6 +258,8 @@ :material-file-cog:`led_aprom.bin` from the [release archive](https://gitea.tendokyu.moe/tasoller/host-aprom/releases), then follow the setup instructions in the [README](https://gitea.tendokyu.moe/tasoller/host-aprom#setup). + You do not need any IO DLLs for this. + ??? warning "HID custom firmware" - Install the [custom Host and LED firmware](https://pixeldrain.com/u/DajSPEoa) to your controller.