Merge pull request #144 from auxbh/feat/troubleshooting

Update IIDX31-32 troubleshooting page
2026-04-26 04:26:47 -05:00 · 2025-07-03 20:13:42 +02:00 · 2025-07-03 20:13:42 +02:00 · 5729e9e0f5
commit 5729e9e0f5
parent 9b0e9e6c36 5420bb6334
2 changed files with 85 additions and 52 deletions
--- a/docs/games/bemani/iidx/common/31plus/troubleshooting.md
+++ b/docs/games/bemani/iidx/common/31plus/troubleshooting.md
@ -2,81 +2,104 @@

 --8<-- "docs/snippets/common/data_warning.md"

-### My game crashes on launch!
+!!! info "For any issues not covered here, spice2x's [Known issues](https://github.com/spice2x/spice2x.github.io/wiki/Known-issues) page might prove useful"

-!!! tip ""
+## Technical problems

-    This could be due to **many** things.
+### Crashes

-    Start by checking the audio section from the setup guide.
+!!! info "Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.<br>If you have them installed, close them both before starting any arcade game"

-    beatmania IIDX 31 and above require an AVX2 capable CPU.  
-    If your CPU is too old, the game will crash with an `EXCEPTION_ILLEGAL_INSTRUCTION` error.  
-    A known workaround is renaming/deleting the `movies` folder to prevent the game from loading them altogether. 
+??? tip "`W:SuperstepSound: Audio device is not available!!!` in logs"

-### My game is running too slow/fast / Game gets stuck / Monitor error at boot / Error 5-1503-0043
+    - Open `log.txt` using an editor that supports `SHIFT-JIS` encoding for Japanese text (like [Notepad++](https://notepad-plus-plus.org/downloads/))

-!!! tip ""
+    - Search for `Superstep`

-    Potential causes:
+    If you find a line with `Audio device is not available!!!`, it means the game refuses to boot due to a misconfigured or missing audio device.  
+    Check the setup guide's **Configuring audio** section as well as our general [Audio guide](/extras/audio.md) to understand the issue better.

-    1. The game could be running over/under its required refresh rate (60 for LDJ, 120 for TDJ)  
-    To solve this, make sure v-sync isn't disabled in your graphics card's settings.
-    For NVIDIA users, enable `NVIDIA profile optimization (-nvprofile)` in the `Options` tab. 
-    2. It could be that your computer's performance isn't good enough to keep a steady framerate.
-    
-### I'm having performance issues / my FPS fluctates!
+??? tip "`EXCEPTION_ACCESS_VIOLATION` in logs"

-!!! tip ""
+    - Open `log.txt` using an editor that supports `SHIFT-JIS` encoding for Japanese text (like [Notepad++](https://notepad-plus-plus.org/downloads/))

-    If you're having performance issues of some kind, spice2x's [PC optimization](https://github.com/spice2x/spice2x.github.io/wiki/PC-optimization) guide is worth looking at.
-    If none of that works, your PC probably isn't good enough to run the game, sorry.
+    - Search for `EXCEPTION_ACCESS_VIOLATION`

-### Unable to login / Eamuse error / Network error
+    beatmania IIDX 31 and above require a CPU that is AVX2 capable. If you encounter this message, it may indicate that your CPU is too old and does not support AVX2.  
+    A known workaround is renaming/deleting the `movies` folder to prevent the game from loading them altogether.

-!!! tip ""
+??? tip "I'm using a laptop with a hybrid internal+dedicated GPU setup"

-    Get the proper Asphyxia plugin from our [Discord server](https://discord.gg/cZRUmEPK78) in the #iidx channel > Resources post.
-    Make sure you didn't enable `-smartea` in spicecfg's options.
+    Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.  

-### How do I set my offset?
+    There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead. 

-!!! tip ""
+### Performance

-    Play through a chart you're comfortable with.
+!!! info "Check out spice2x's [PC optimization](https://github.com/spice2x/spice2x.github.io/wiki/PC-optimization) guide"

-    If you're getting too many `Fast`, increase your offset `(+)`.   
-    If you're getting too many `Slow`, decrease your offset `(-)`.
+??? tip "Game is running too slow/fast / Monitor error 5-1503-0043"

-### My inputs aren't working / I can't get past error messages!
+    Your game is likely running at an incorrect framerate. The expected framerates are:

-!!! tip ""
+    - Legacy cab mode: 60 FPS
+    - Lightning Model cab mode: 120 FPS

-    If **none** of your inputs are working, try updating [spice2x](https://spice2x.github.io/), you can also try using the beta versions if the stable releases don't work for you.
+    Try these steps to resolve framerate issues:

-### My game audio is super quiet!
+    - Make sure that your patch or DLL matches your cab mode
+    - Close any software that can affect framerates (like RTSS)
+    - Close unnecessary background programs
+    - Ensure V-SYNC is not forcefully disabled in your graphics card control panel
+    - For NVIDIA users: Enable `NVIDIA profile optimization (-nvprofile)` in spicecfg's `Options` tab

-!!! tip ""
+    If issues persist:
+
+    - Double-check that you followed all steps in the setup guide correctly
+    - Your PC hardware might be insufficient to keep a steady 120 FPS, you can try switching to Legacy cab mode
+    - Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources
+
+### Audio
+
+!!! info "Check out our [Audio](/extras/audio.md) guide to understand audio modes better"
+
+!!! info "Ensure your default audio device's sample rate is set properly"
+
+    - **44100 Hz** sample rate for **WASAPI Exclusive** and **ASIO**
+    - **48000 Hz** if your game is patched with `Shared Mode WASAPI`
+
+??? tip "I can't change my device's sample rate"
+
+    If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):
+
+    - Check if you can modify the sample rate in the device's software/control panel
+    - If not, try uninstalling the device's software. This may restore control over Windows audio settings
+
+    If you still can't change the sample rate:
+
+    - Configure the game's audio mode to match your device's current sample rate instead
+    - Try using a different audio device
+
+??? tip "I can't hear anything else than the game"
+
+    Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.
+
+    Check out our [Audio](/extras/audio.md) guide to understand audio modes better.
+
+    If you're using WASAPI Exclusive, you'll want to [patch the game](/extras/patchsp2x.md) with `Shared Mode WASAPI` to hear other applications.
+
+    If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use.  
+    In this case, you'll need to route all audio through software such as [Voicemeeter](https://vb-audio.com/Voicemeeter/banana.htm), and have Voicemeeter output the mix to your ASIO device.
+
+??? tip "Game audio is too quiet"

    When using `TDJ mode` the audio is very quiet by default. To mitigate this, you can use the `Increase Game Volume` patch.

-### When I run the game all other audio is gone!
+### Subscreen

-!!! tip ""
+!!! info "For more in-depth troubleshooting, refer to the spice2x [Subscreen troubleshooting](https://github.com/spice2x/spice2x.github.io/wiki/Configuring-touch-screens-as-subscreen#troubleshooting) page"

-    IIDX uses [WASAPI exclusive mode](https://docs.microsoft.com/en-us/windows/win32/coreaudio/exclusive-mode-streams) for audio to get better audio latency.  
-    Unlike former versions of the games which used [DirectSound](https://en.wikipedia.org/wiki/DirectSound).   
-    
-    You can use the `Shared Mode WASAPI` patch to hear other apps while the game is running, at the cost of some audio latency.
+??? tip "Touch input isn't being registered"

-### I'm not getting any audio, or my audio is completely wrecked and I'm using an External Dac!
-
-!!! tip ""
-
-    Many setups have found some difficulty with audio due to various equipment being used. Consider using the `Shared Mode WASAPI` patch.
-
-### My audio is slowed/distorted and I'm using the `Shared Mode WASAPI` patch.
-
-!!! tip ""
-
-    When using this patch, you must set your audio device's sample rate to 48000 Hz.
+    If you're using a physical touch screen, make sure to close **all** spice2x overlays, including the FPS counter.  
+    If you're using the virtual subscreen, ensure that the `-iidxnativetouch` option is not enabled.
--- a/docs/games/bemani/sdvx/6_exceedgear/troubleshooting.md
+++ b/docs/games/bemani/sdvx/6_exceedgear/troubleshooting.md
@ -43,7 +43,7 @@

    - Search for `Superstep`

-    If you find a line with `Audio device is not available!!!`, it means the game hasn't found refuses to boot due to misconfigured audio.  
+    If you find a line with `Audio device is not available!!!`, it means the game refuses to boot due to a misconfigured or missing audio device.   
    Check the setup guide's [Configuring audio section](setup.md#configuring-audio) as well as our general [Audio guide](/extras/audio.md) to understand the issue better.

 ??? tip "I'm using a laptop with a hybrid internal+dedicated GPU setup"
@ -59,6 +59,7 @@
 ??? tip "Game is running too slow/fast"

    Your game is likely running at an incorrect framerate. The expected framerates are:
+
    - Nemsys mode: 60 FPS
    - Valkyrie mode: 120 FPS

@ -116,6 +117,15 @@
    - Go to `SOUND OPTIONS` and change the volume at will
    - `SAVE AND EXIT` > `GAME MODE` to return to the game

+### Subscreen
+
+!!! info "For more in-depth troubleshooting, refer to the spice2x [Subscreen troubleshooting](https://github.com/spice2x/spice2x.github.io/wiki/Configuring-touch-screens-as-subscreen#troubleshooting) page"
+
+??? tip "Touch input isn't being registered"
+
+    If you're using a physical touch screen, make sure to close **all** spice2x overlays, including the FPS counter.  
+    If you're using the virtual subscreen, ensure that the `-sdvxnativetouch` option is not enabled.
+
 ## FAQ

 ??? tip "How to run the game in windowed borderless mode?"
@ -128,4 +138,4 @@

    It may also be that the content is only available in specific regions like Japan and your game is configured with another region.

-    You can fix this by [patching](/extras/patchsp2x.md) `Fake Region` to `Japan (J)`.
+    You can fix this by [patching](/extras/patchsp2x.md) `Fake Region` to `Japan (J)`.