From 85041405c8b47b2db5ab8bb0c1c834e784a91886 Mon Sep 17 00:00:00 2001
From: jade-ish <128985070+eightbitgiraffe@users.noreply.github.com>
Date: Tue, 3 Jun 2025 07:57:45 -0400
Subject: [PATCH] update museca's troubleshooting guide based on sdvx's
---
.../museca/1plushalf/troubleshooting.md | 72 ++++++++++---------
1 file changed, 39 insertions(+), 33 deletions(-)
diff --git a/docs/games/bemani/museca/1plushalf/troubleshooting.md b/docs/games/bemani/museca/1plushalf/troubleshooting.md
index 1ab02610..608fcb72 100644
--- a/docs/games/bemani/museca/1plushalf/troubleshooting.md
+++ b/docs/games/bemani/museca/1plushalf/troubleshooting.md
@@ -1,59 +1,65 @@
# Troubleshooting
---8<-- "docs/snippets/common/old_guide.md"
-
--8<-- "docs/snippets/common/data_warning.md"
-## Hardware Specs
+!!! 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 ""
- Bemani PC (ADE-6291)
+## Technical Problems
- Konami (2018)
+??? tip "I'm using a laptop with a hybrid internal+dedicated GPU setup"
- Based on an AMD Embedded R Series SoC.
+ 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.
- CPU: AMD RX-421BD
+ There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.
- GPU: Radeon R7
+### Performance
- RAM: 4 GB
+!!! info "Check out spice2x's [PC optimization](https://github.com/spice2x/spice2x.github.io/wiki/PC-optimization) guide"
- OS: Windows 7 Embedded
+??? tip "Game is running too slow/fast"
+ Your game is likely running at an incorrect framerate. MÚSECA expects the game to run at 60 fps constantly.
+
+ Try these steps to resolve framerate issues:
-### My Game Is Running Slow/Lagging
+ - Verify your monitor's refresh ratae is set at exactly 60 Hz.
+ - 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 ""
- Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
+ If issues persist:
-### My Game Is Running Crazy Fast!
+ - Double-check that you followed all steps in the [setup guide](setup.md) correctly
+ - Your PC hardware might be insufficient to keep a steady 60 FPS. Make sure your PC meets the requirements of this game.
+ - Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources.
-!!! tip ""
- The most common reason for this is the game is running over its required 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
+ Your PC may not meet the specifications for MÚSECA. In the arcade, it runs on a Bemani PC (ADE-6291):
-### Occasional Game Stutters During Play
+ - CPU: AMD RX-421BD
-!!! tip ""
- Sometimes you might have occasional stutters during play, while solutions can vary wildly from general performance issues to bad hard drives
- Try enabling the `processpriority` option in spicetools, and set it to `realtime`.
+ - GPU: Radeon R7
-### Which Offset Is Which?
+ - RAM: 4 GB
-!!! tip ""
- If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).
+ - OS: Windows 7 Embedded
-### Booting the Game in Offline Mode
+## Audio
-!!! tip ""
- If your game version is PIX-2018073002, this version supports turning off E-Amusement. In order to do that, change the game code to `J:B:A` (`B` in `prop/ea3-config.xml`), disable/disconnect all network adapters and turn set the E-Amusement setting in the game's operator menu to OFF.
+??? tip "I can't hear anything else than the game!"
-### When I Run This Game All Other Background Audio Is Gone! What's Going On?
-
-!!! tip ""
Museca is a 64-bit game utilizing a feature in Windows called [WASAPI exclusive mode](https://docs.microsoft.com/en-us/windows/win32/coreaudio/exclusive-mode-streams) to obtain less audio latency. Unfortunately, this cannot be changed.
-### I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!
+??? tip "I'm not getting any audio/My audio is completely wrecked and I'm using an external DAC!
-!!! tip ""
- Several external DACs have issues with [WASAPI exclusive mode](https://docs.microsoft.com/en-us/windows/win32/coreaudio/exclusive-mode-streams) and are unable to be used entirely, it's likely you'll be forced to use your motherboard's sound chip, or find a compatible DAC.
\ No newline at end of file
+ Several external DACs have issues with [WASAPI exclusive mode](https://docs.microsoft.com/en-us/windows/win32/coreaudio/exclusive-mode-streams) and are unable to be used entirely, it's likely you'll be forced to use your motherboard's sound chip, or find a compatible DAC.
+
+## FAQ
+
+??? tip "How to run the game in windowed borderless mode?"
+
+ You'll need to use 3rd party software like [Borderless Gaming](https://github.com/Codeusa/Borderless-Gaming/releases) in order to achieve this.
+
+??? tip "Can the game be run offline?"
+
+ If your game version is PIX-2018073002, this version supports turning off E-Amusement. In order to do that, change the game code to `J:B:A` (`B` in `prop/ea3-config.xml`), disable/disconnect all network adapters and turn set the E-Amusement setting in the game's operator menu to OFF.
# Troubleshooting
---8<-- "docs/snippets/common/old_guide.md"
-
--8<-- "docs/snippets/common/data_warning.md"
-## Hardware Specs
+!!! 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 ""
- Bemani PC (ADE-6291)
+## Technical Problems
- Konami (2018)
+??? tip "I'm using a laptop with a hybrid internal+dedicated GPU setup"
- Based on an AMD Embedded R Series SoC.
+ 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.
- CPU: AMD RX-421BD
+ There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.
- GPU: Radeon R7
+### Performance
- RAM: 4 GB
+!!! info "Check out spice2x's [PC optimization](https://github.com/spice2x/spice2x.github.io/wiki/PC-optimization) guide"
- OS: Windows 7 Embedded
+??? tip "Game is running too slow/fast"
+ Your game is likely running at an incorrect framerate. MÚSECA expects the game to run at 60 fps constantly.
+
+ Try these steps to resolve framerate issues:
-### My Game Is Running Slow/Lagging
+ - Verify your monitor's refresh ratae is set at exactly 60 Hz.
+ - 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 ""
- Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
+ If issues persist:
-### My Game Is Running Crazy Fast!
+ - Double-check that you followed all steps in the [setup guide](setup.md) correctly
+ - Your PC hardware might be insufficient to keep a steady 60 FPS. Make sure your PC meets the requirements of this game.
+ - Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources.
-!!! tip ""
- The most common reason for this is the game is running over its required 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
+ Your PC may not meet the specifications for MÚSECA. In the arcade, it runs on a Bemani PC (ADE-6291):
-### Occasional Game Stutters During Play
+ - CPU: AMD RX-421BD
-!!! tip ""
- Sometimes you might have occasional stutters during play, while solutions can vary wildly from general performance issues to bad hard drives
- Try enabling the `processpriority` option in spicetools, and set it to `realtime`.
+ - GPU: Radeon R7
-### Which Offset Is Which?
+ - RAM: 4 GB
-!!! tip ""
- If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).
+ - OS: Windows 7 Embedded
-### Booting the Game in Offline Mode
+## Audio
-!!! tip ""
- If your game version is PIX-2018073002, this version supports turning off E-Amusement. In order to do that, change the game code to `J:B:A` (`