Leahnaya/two-torial
1
0
Fork 0
mirror of https://github.com/two-torial/two-torial.git synced 2026-08-24 12:34:14 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity

iidx: Update the troubleshooting guide

Browse Source
This commit is contained in:
auxbh
2025-07-03 16:42:25 +00:00
parent e57eaadb2c
commit 95dd9a2813
1 changed files with 60 additions and 46 deletions
Download Patch File Download Diff File Expand all files Collapse all files

106
docs/games/bemani/iidx/common/31plus/troubleshooting.md
View File

@@ -2,81 +2,95 @@
--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 hasn't found refuses to boot due to misconfigured audio.
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.
- Look for this error message: `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:
When using `TDJ mode` the audio is very quiet by default. To mitigate this, you can use the `Increase Game Volume` patch.
- 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
### When I run the game all other audio is gone!
### Audio
!!! tip ""
!!! info "Check out our [Audio](/extras/audio.md) guide to understand audio modes better"
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.
!!! info "Ensure your default audio device's sample rate is set properly"
### I'm not getting any audio, or my audio is completely wrecked and I'm using an External Dac!
- **44100 Hz** sample rate for **WASAPI Exclusive** and **ASIO**
- **48000 Hz** if your game is patched with `Shared Mode WASAPI`
!!! tip ""
??? tip "I can't change my device's sample rate"
Many setups have found some difficulty with audio due to various equipment being used. Consider using the `Shared Mode WASAPI` patch.
If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):
### My audio is slowed/distorted and I'm using the `Shared Mode WASAPI` patch.
- 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
!!! tip ""
If you still can't change the sample rate:
When using this patch, you must set your audio device's sample rate to 48000 Hz.
- 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.