From a42908fb72c38d2aa301f6425c86747c046ac4c9 Mon Sep 17 00:00:00 2001 From: Akitake Date: Thu, 11 Jul 2024 15:49:19 +0200 Subject: [PATCH] Formatting --- docs/errorcodes/bemani.md | 25 +++++++++++-- docs/errorcodes/sega.md | 36 +++++++++++++++++++ docs/games/chunithmluminous/controllers.md | 18 +++++++++- docs/games/chunithmluminous/setup.md | 33 ++++++++++++++++- .../games/chunithmluminous/troubleshooting.md | 12 +++++-- 5 files changed, 118 insertions(+), 6 deletions(-) diff --git a/docs/errorcodes/bemani.md b/docs/errorcodes/bemani.md index b591b88..094d992 100644 --- a/docs/errorcodes/bemani.md +++ b/docs/errorcodes/bemani.md @@ -3,6 +3,7 @@ !!! info "Last updated: July 11th, 2024" !!! warning "Before reading" + This section contains various gamecode errors that a user may run across. There is an innumerable amount of these and I sometimes wonder if it's truly possible to have them all listed. Nonetheless, dozens, if not hundreds are currently missing. This list is a massive work in progress and will be updated with time. @@ -13,6 +14,7 @@ ### 5-0000-0000 !!! tip "" + This error can appear across any game, it's a generic critical error with several possible solutions. It is usually caused by network adapters that are enabled, other than the primary one used for network service. Try to disable some network adapters in Windows Device Manager, including hidden adapters. @@ -22,6 +24,7 @@ ### 5-2000-0000 !!! tip "" + This error can appear across any game, it's a standard network error with several possible solutions. First, make sure you have correctly entered your network service's URL properly with the `-url` parameter, that your internet connection is fine, and that the service is not down. @@ -33,6 +36,7 @@ ### 5-2002-0915 !!! tip "" + This error can appear across any game, it's a standard network error with several possible solutions. First, make sure you have correctly entered your network service's URL properly with the `-url` parameter, that your internet connection is fine, and that the service is not down. @@ -44,6 +48,7 @@ ### 5-2600-0000 !!! tip "" + This error can appear across any game, it's a standard network error with several possible solutions. First, make sure you have correctly entered your network service's URL properly with the `-url` parameter, that your internet connection is fine, and that the service is not down. @@ -58,11 +63,13 @@ ### 5-1500-0002 !!! tip "SOUND DATA CREATE ERROR" + This error occured from a corrupted installation. If your data came from a trusted source and you're having this issue, consider redownloading the files and making sure your installation was done properly. Or, perhaps your hard drive is failing. ### 5-1503-0004 !!! tip "USBIO ERROR (NO ANSWER...)" + This error occurs when the game times out trying to communicate with the I/O board. When using tools, this typically happens because I/O emulation in tools takes too long, which can be caused by long-running background services on your computer. Usual offenders are: file-syncing software (GDrive, OneDrive, back up service, etc), anti-virus / malware scans, Windows Updates, or possibly bad hardware. Try to see if you can run tools at elevated process priority (SpiceTools already does this, but you can also try -realtime as last resort). @@ -72,16 +79,19 @@ ### 5-1505-0001 !!! tip "SSD DATA ERROR" + This error occurs when the data is horribly corrupt, incomplete, or modified incorrectly. Please redownload your data from a reliable source. ### 5-1503-0042 !!! tip "CAMERA DEVICE ERROR" + This error occurs when camera devices are missing/not functional. To resolve either have two cameras connected to your machine or apply a patch for your game's specific version and date code to simply not have this error occur on startup. It can be bypassed by hitting the `Test` button so it is not a critical error. ### 5-1506-0001 !!! tip "CLOCK ERROR" + This error occurs when the clock is not set. To resolve, set the `CLOCK` in the service menu by hitting `SAVE AND EXIT` inside of the menu.   @@ -90,23 +100,28 @@ ### 5-1506-0000 !!! tip "ACIO ERROR" + A user had this error when they downloaded the game from an unreliable source, they redownloaded `libacio.dll` from a clean, trusted source and had no issues. If the error persists, consider redownloading the data from a reliable source entirely. ### 5-2009-0000 !!! tip "" + This error was seen on Sound Voltex Booth, a user had messed up their dll files. Thus, the solution would be to leave files unmodified and do not needlessly tamper. If your data came from a trusted source and you're having this issue, consider redownloading the files and making sure your installation was done properly.   ## Pop'n Error Codes ### 5-1509-0000 + !!! tip "" + A user experienced this error every few minutes or so during play. If this issue occurs, make sure you have correctly inputted your chosen network's service URL and your PCBID correctly. ### 5-2002-2400 !!! tip "" + This error was seen on Pop'n Usaneko due to improper setup and bad parameter usage in SpiceTools, make sure to follow [the first time setup](../games/popnusaneko/setup.md) and utilize the `-url` and `-p` parameters in SpiceTools so that you're not needlessly risking making mistakes in modifying the game's files. @@ -116,6 +131,7 @@ ### 5-2500-0000 !!! tip "BACKUP DATA ERROR" + Follow the steps listed [here](../games/jubeatclan/setup.md#final-steps-and-setting-up-the-game)   @@ -124,6 +140,7 @@ ### 5-1698-0000 !!! tip "" + This was seen in GITADORA Tri-Boost Re:EVOLVE. To resolve, uncheck the `Read Only` attribute on the following `contents` folders. - \contents\data\product\aep_x64\ @@ -152,16 +169,19 @@ ### 5-1506-0000 !!! tip "" + Disable all the unused network adapters inside device manager (make sure to view the hidden ones as well and disable those too!) ### 5-2500-0001 !!! tip "BACKUP DATA ERROR" + Follow the steps listed [here](../games/gitamatixx/setup.md#final-steps-and-setting-up-the-game) ### 5-2501-0000 -!!! tip "GROUP ID ERROR" +!!! tip "" + The Group ID Error is caused when it finds another cab of the same kind (GF or DM) with the same Group ID on the network. In most cases for users, this means the computer is connected to BOTH Ethernet and Wi-fi so the game sees 2 instances of itself. Thus to resolve, make sure you do not have 2 devices on the same subnet like this by checking your connections accordingly.   @@ -170,4 +190,5 @@ ### 5-1501-0000 !!! tip "" - This error was seen in NOSTALGIA Op. 2 when a user had a bad AVS config, make sure your data is from a reliable source and consider redownloading or replacing the file. + + This error was seen in NOSTALGIA Op. 2 when a user had a bad AVS config, make sure your data is from a reliable source and consider redownloading or replacing the file. \ No newline at end of file diff --git a/docs/errorcodes/sega.md b/docs/errorcodes/sega.md index 913cb92..bedbe7b 100644 --- a/docs/errorcodes/sega.md +++ b/docs/errorcodes/sega.md @@ -3,6 +3,7 @@ !!! info "Last updated: July 11th, 2024" !!! warning "Before reading" + This section contains various gamecode errors that a user may run across. There is an innumerable amount of these and I sometimes wonder if it's truly possible to have them all listed. Nonetheless, dozens, if not hundreds are currently missing. This list is a massive work in progress and will be updated with time. @@ -12,11 +13,13 @@ ### 0000 !!! tip "Unexpected Error Occured" + This error occurs when the data is horribly corrupt, incomplete, or modified incorrectly. Please redownload your data from a reliable source. ### 0032 !!! tip "Unexpected Error Occured" + Generic network error with multiple symptoms, the most typical of which being enabling DHCP in Windows while the game expects a static IP. Try adding this to `config_hook.json`: @@ -32,6 +35,7 @@ ``` !!! tip + If you're copying into an existing `config_hook.json`, remove the outer braces and add a comma to the previous item, like so: @@ -51,6 +55,7 @@ 1. Notice the comma here. !!! tip + If your game files does not include `config_hook.json`, it is OK to create a new file, then edit the launch script (usually `start.bat`) to tell the game about it: @@ -60,6 +65,7 @@ ### 0800 !!! tip "Unknown Error" + Generic network error usually thrown because the game is not able to connect to a server. Make sure that you have correctly entered your network's address in `segatools.ini` under @@ -73,6 +79,7 @@ ### 0919 !!! tip "DVD Drive Remain Error" + This error occurs if the game detects an enabled DVD drive on the system. To resolve, either disable your computer's DVD drive, or enable DVD drive emulation in `segatools.ini`: @@ -84,6 +91,7 @@ ### 0949 !!! tip "Keychip Not Found" + Enable keychip emulation in `segatools.ini`: ```ini hl_lines="2" @@ -96,6 +104,7 @@ ### 4104 !!! tip "Unexpected Error Occured" + Make sure that the game files are not on the `E:` or `Y:` drive. If that is already the case, check if the config files passed to AM Daemon exists and are valid JSON files: @@ -118,6 +127,7 @@ ### 4105 !!! tip "Unexpected Error Occured" + Check the AM Daemon window for any "runtime exception" messages, such as ```hl_lines="6" @@ -133,6 +143,7 @@ ### 6401 !!! tip "I/O board is not connected to main board" + This error occurs when the game times out trying to communicate with the I/O board. When using segatools, this happens because I/O emulation took too long, which is @@ -142,6 +153,7 @@ ### 6501 !!! tip "Aime Card Reader Not Found" + This error occurs when an Aime card reader is not found. Make sure you enabled Aime card reader emulation in `segatools.ini` if you don't have a physical reader connected: @@ -152,11 +164,13 @@ ### 6503 !!! tip "Failed to read Aime card" + This error occurs when the Aime card cannot be read. Make sure your connection to the ALL.Net server is good (the network icon in the bottom corner is green). ### 8114 !!! tip "ALL.Net System error (RTC)" + Make sure you're connected to an ALL.Net server for the first boot, or disable accounting by editing `config_hook.json`: @@ -169,6 +183,7 @@ ``` !!! tip + If you're copying into an existing `config_hook.json`, remove the outer braces and add a comma to the previous item, like so: @@ -186,6 +201,7 @@ 1. Notice the comma here. !!! tip + If your game files does not include `config_hook.json`, it is OK to create a new file, then edit the launch script (usually `start.bat`) to tell the game about it: @@ -194,24 +210,33 @@ ``` ## CHUNITHM Error Codes + ### 3101 + !!! tip "An unexpected error has occurred with the main device" + This error occurs when the game fails to communicate with the controller. Check if your controller is connected properly and if ChuniIO DLLs are working. ### 3102 + !!! tip "Initialization failure with the main device" + This error occurs when the game fails to communicate with the controller. Check if your controller is connected properly and if IO DLLs are working. ### 3201, 3202, 3203, 3204, 3205, 3206 + !!! tip "Cannot confirm the connection with the side device sensor 1/2/3/4/5/6" + This error occurs if the air sensors are not functional or blocked during system test. To resolve this, enter and exit Test mode by pressing the F1 key (or 1 on older segatools) then stay clear of your controller. If the error still happens, your air sensors may be faulty. ### 3300 + !!! tip "Duplicate servers in the same network" + If multiple CHUNITHM machines are on the same LAN network, only one of them can be the server (dip switch 1 ON). Set all other machines to dip switch 1 OFF: @@ -221,18 +246,24 @@ ``` ### 3301 + !!! tip "Duplicate STANDARD in the same group" + If multiple CHUNITHM machines are on the same LAN network and cabinet group (A/B/C/D), one of them should set reference machine settings to STANDARD and the rest to FOLLOW THE STANDARD. Change this by going to Test menu -> Game Settings (4th option) -> Reference machine settings (2nd option). ### 3400 + !!! tip "Monitor Not Supported 120fps" + This error occurs if you're running the game in SP mode but the monitor is not `1920x1080@120Hz` in 32-bit color mode. Adjust display settings and try again. ### 3401 + !!! tip "Machine Not Supported 120fps" + This error occurs if you're running the game in CVT mode at 120fps. Use SP mode (dip switch 3 OFF) to run the game in 120fps. In `segatools.ini` this would be: @@ -246,6 +277,7 @@ ### ampdGd1232a01aInit(). ErrCode -4 !!! tip "" + This error occurs because of a VFD port number mismatch. Update segatools, or if you're using a real VFD, confirm that the VFD uses the same port as specified in `config_common.json` or `config_sp.json` (CHUNITHM) under `emoney.display_port`: @@ -262,23 +294,27 @@ ### amAppImageInit(). ErrCode -5 !!! tip "" + Path to the configured AMFS directory is too long. Ensure that the path is shorter than 16 characters (32 bytes). ### RegCreateKeyExW(). ErrorCode -5 !!! tip "" + This error occurs because the Windows registry cannot be written to as a normal user. Start the game as administrator **once**, or update segatools. ### amSysFileInitEx(). ErrCode -5 !!! tip "" + The AMFS folder is read only. Uncheck the read only property in File Explorer for the AMFS folder. ### amGfetcherInit(). ErrCode -1 !!! tip "" + ICF1 is missing in the configured AMFS directory. Get the correct ICF for your game (the game ID in the ICF must be correct). diff --git a/docs/games/chunithmluminous/controllers.md b/docs/games/chunithmluminous/controllers.md index 6951641..edf01af 100644 --- a/docs/games/chunithmluminous/controllers.md +++ b/docs/games/chunithmluminous/controllers.md @@ -8,6 +8,7 @@ --- !!! 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. @@ -19,6 +20,7 @@ `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 `=`: @@ -33,6 +35,7 @@ 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 `=`: @@ -53,6 +56,7 @@ ### Keyboard !!! tip "" + Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes. @@ -66,6 +70,7 @@ ### 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. @@ -73,9 +78,11 @@ #### 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) @@ -101,6 +108,7 @@ - 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: @@ -109,6 +117,7 @@ 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. @@ -130,6 +139,7 @@ ``` ??? 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: @@ -179,6 +189,7 @@ #### iOS/iPadOS !!! tip "" + - Install Brokenithm on your iOS/iPadOS device by joining the [Brokenithm TestFlight](https://testflight.apple.com/join/15FSg9sB). - If the TestFlight is full, you will need to sideload the [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.** @@ -206,6 +217,7 @@ - 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. @@ -229,6 +241,7 @@ ### 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. @@ -236,6 +249,7 @@ 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. @@ -258,6 +272,7 @@ ### 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) @@ -283,6 +298,7 @@ ### 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! + and Discord community is a great place to start! \ No newline at end of file diff --git a/docs/games/chunithmluminous/setup.md b/docs/games/chunithmluminous/setup.md index 9e5215b..3bdebc9 100644 --- a/docs/games/chunithmluminous/setup.md +++ b/docs/games/chunithmluminous/setup.md @@ -6,6 +6,7 @@ !!! 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." !!! danger "If you're coming from a previous version of CHUNITHM" + You'll want to create a new folder for the game and start from scratch. CHUNITHM **DOES NOT** like being extracted over old data! @@ -16,6 +17,7 @@ !!! danger "There are currently issues with running game data in the `E:\` or `Y:\` drive.
Please extract the data into other drives." !!! tip "" + After downloading and extracting your data, we need to make sure your files aren't set to `Read-only`. @@ -38,6 +40,7 @@ ??? warning "If your data doesn't look like this" + If your data looks like the third image: - Create an `App` folder and move all files and folders from the image inside of it. @@ -50,12 +53,14 @@ #### Updating the base game !!! tip "" + Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary. #### Installing option data !!! tip "" + CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named `A???`, with each `?` being a number. Custom options distributed by the community might use letters instead, to distinguish them from @@ -69,6 +74,7 @@ #### Installing ICFs !!! tip "" + Install Configuration Files (ICFs) tell the game what version it is. **Without this your game cannot go online!** @@ -79,6 +85,7 @@ `ICF1` **without any file extensions.** !!! info "Showing file extensions" + By default, file extensions on Windows are hidden. Enable them by navigating to the `View` tab in File Explorer and select `File name extensions`. @@ -86,6 +93,7 @@ #### Installing unprotected executables !!! tip "" + CHUNITHM executables are protected and will not run on a regular computer. Obtained unprotected (also called "unpacked" or "decrypted" by the community) @@ -101,6 +109,7 @@ ### Patching the game !!! info "Go through the [Web Patching](../../extras/patchweb.md) guide to learn how to use a web patcher." + There are **many** patches for CHUNITHM. We will only bring up the ones we think could be genuinely useful. @@ -122,6 +131,7 @@ ### Installing segatools !!! tip "" + - Head over to [segatools releases](https://gitea.tendokyu.moe/Dniel97/segatools/releases) and download `segatools.zip`. **Do not download the source code.** - Extracting the archive should give you a few more zip files. Find **`chusan.zip`** @@ -136,6 +146,7 @@ ### Configuring segatools !!! tip "" + Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in `App\bin\segatools.ini`. @@ -145,6 +156,7 @@ section is not mentioned, you can skip them. !!! warning + If a key already exists in the section, delete everything after `=` and replace it with your setting. Do not add another key. @@ -157,6 +169,7 @@ #### `[vfs]` !!! tip "" + If you've been matching the file structure as described in the [Preparing data](#preparing-data) section, you can fill in this section with the values below: @@ -170,6 +183,7 @@ #### `[gpio]` !!! tip "" + - If you have a 120Hz monitor, set `dipsw2` and `dipsw3` to 0: ```ini @@ -189,11 +203,13 @@ #### `[gfx]` !!! tip "" + - Set `windowed` to `0` to run in fullscreen mode and `1` to run in windowed mode. - If you have multiple monitors and you're running in fullscreen mode (`windowed=0`), set `monitor` to the index of the monitor you want to run the game on. ??? info "Getting the monitor index" + Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1. @@ -204,6 +220,7 @@ !!! danger "Please choose one of the two solutions, not both!" ??? tip "Remote (Online Network)" + Head to the `[dns]` section inside `segatools.ini`. Set `default` to the address provided by your network. **Do not add `http://` or `https://` to the address!** @@ -226,6 +243,7 @@ ??? warning "Local (ARTEMiS/AquaDX)" + Both of these options require non-trivial setup. Refer to the official guides for [ARTEMiS](https://gitea.tendokyu.moe/Hay1tsme/artemis/src/branch/develop/docs/INSTALL_WINDOWS.md) and [AquaDX](https://github.com/hykilpikonna/AquaDX?tab=readme-ov-file#usage-v1-developmental-preview) to set up a local server. @@ -239,12 +257,14 @@ #### VCRedist & DirectX !!! tip "" + - Download and install the latest [VCRedist](https://github.com/abbodi1406/vcredist/releases/latest) (`VisualCppRedist_AIO_x86_x64.exe`) - Download and install the [DirectX End-User Runtimes](https://www.microsoft.com/en-us/download/details.aspx?id=8109) #### Audio !!! tip "" + - Right-click on the volume setting in your taskbar and select `Sounds`. - Navigate to the `Playback` tab, right click on your default audio device, and click on `Properties`. - Go to the `Advanced` tab. @@ -257,6 +277,7 @@ #### Fixing OpenSSL on Intel 10th Gen and newer CPUs !!! tip "" + If you have an Intel 10th Gen CPU or newer, right click `App\bin\start.bat`, select `Edit`, and add the highlighted line to the top of the file. @@ -275,12 +296,14 @@ !!! danger "If you have any issues running the game, refer to the [Troubleshooting](troubleshooting.md) page." !!! tip + Without an English patch, the service menu will be in Japanese. If you don't know Japanese, [Google Lens](https://lens.google/) is a handy tool for navigating this menu. #### GAME ASSIGNMENTS !!! tip "" + If you've followed all instructions correctly, you're now finally ready to launch the game! Start the game by running `App\bin\start.bat`. Let the game load until it reaches the screen below. @@ -288,6 +311,7 @@ !!! tip "" + Press your `Test` button (default `F1`) to enter the service menu. Use the `Service` button (default `F2`) to navigate the menu, and `Test` button to select an option. @@ -296,39 +320,46 @@ !!! tip "" + Select **グループ内基準機設定** (`SET STANDARD IN GROUP`, the second option) and toggle this setting to **基準機** (`STANDARD`). !!! tip "" + Select **終了** (`EXIT`, the last option) to exit to the main service menu. #### CLOSE SETTING !!! tip "" + Navigate to **閉店設定** (`CLOSE SETTING`, the 10th option). !!! tip "" + Navigate to **時** (`HOUR`, the 2nd option) and use the `Service` button to toggle the setting until it says **全時刻** (`ALL TIME`). !!! tip "" + Select **終了** (`EXIT`, the last option) to exit to the main service menu, then select **終了** (also the last option) in the main menu to exit the service menu. #### Waiting for Distribution Server !!! tip "" + If you're stuck at the `Waiting for Distribution Server` screen below, close the game and relaunch. !!! tip "" + You're all done! The game should load up properly now. You can add coins using the `Coin` key (default `F3`) and card in by holding the `Enter` key. @@ -339,4 +370,4 @@ !!! warning "Have any other issues?" - Check out the [Troubleshooting](troubleshooting.md) and [Error Codes](../../errorcodes/sega.md) pages. + Check out the [Troubleshooting](troubleshooting.md) and [Error Codes](../../errorcodes/sega.md) pages. \ No newline at end of file diff --git a/docs/games/chunithmluminous/troubleshooting.md b/docs/games/chunithmluminous/troubleshooting.md index 7e34bf8..06b3469 100644 --- a/docs/games/chunithmluminous/troubleshooting.md +++ b/docs/games/chunithmluminous/troubleshooting.md @@ -10,6 +10,7 @@ ### My game crashes on launch! !!! tip "" + Could be due to **many** things, the most common of which are: - `amdaemon` crashing in the background. Make sure that the `config_*.json` files @@ -22,6 +23,7 @@ monitor check"/"Bypass 1080p monitor check" on a CHUNITHM web patcher (see [Resources](../../resources.md#web-patchers)). ??? info "Capturing logs from `amdaemon` for troubleshooting" + To assist with troubleshooting, a script can be used to capture logs from `amdaemon`. Create a file named `amdaemontest.bat` in `App\bin`, then paste the code block below into the file. @@ -49,11 +51,13 @@ ### My game takes a long time to boot! !!! tip "" + CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list. !!! danger + Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data. @@ -62,6 +66,7 @@ ### My game is running too slow/fast !!! tip "" + The game could be running under or over its required refresh rate. - Make sure V-Sync isn't disabled in your graphics settings (called "Vertical sync" @@ -76,6 +81,7 @@ ### My game is stuttering !!! tip "" + For NVIDIA users, create an override for `chusanApp.exe` in NVIDIA Control Panel and change "Power management mode" to "**Prefer maximum performance**". @@ -84,6 +90,7 @@ ### My game crashes when I tab out of fullscreen! !!! tip "" + As the game is intended to run on arcade hardware, it doesn't like being minimized. One workaround for this is to use DXVK. Download the latest version from [releases](https://github.com/doitsujin/dxvk/releases/latest). @@ -94,6 +101,7 @@ You should now be able to tab out of fullscreen without crashing the game. !!! warning + The game will not ignore inputs when out of focus. This means any controller inputs will still be accepted, so try not to lean onto @@ -108,9 +116,9 @@ ### When I run the game all other audio is gone! !!! tip "" + CHUNITHM uses [WASAPI exclusive mode](https://docs.microsoft.com/en-us/windows/win32/coreaudio/exclusive-mode-streams) for audio to get better latency. You can apply the "Shared Audio" patch on a CHUNITHM web patcher (see [Resources](../../resources.md#web-patchers)) - to hear audio outside of the game at the cost of audio latency. - + to hear audio outside of the game at the cost of audio latency. \ No newline at end of file