-
-??? warning "If your data doesn't look like this"
-
- If you're missing the `modules` folder and instead have bunch of `.dll` files next to your folders:
-
- - Create a `modules` folder.
- - Move all `.dll` files inside of it so you end up with a structure as shown above.
-
- If extra files are present next to your folders, such as executables, scripts, etc.. **remove them**.
- **This also means your data was tampered with and we strongly recommend getting new data from somewhere else.**
-
-!!! info "If you don't need to update your data, you can skip over to the [Installing spice2x](#installing-spice2x) section."
-
----
-### Updating data
-
-??? danger "Please make sure you're using the right update for your current data."
-
- SDVX Patches re-uploaded by the community tend to be appropriately named `KFC-DATECODE-to-DATECODE`.
-
- For example `KFC-2024043000-to-2024052100`.
-
- - `2024043000` being your current data's version.
- - `2024052100` being the one you would arrive at.
-
-!!! tip ""
-
- - Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
- - Open `prop\ea3-config.xml` in a text editor and find the following lines near the top.
-
- ```xml
- 
+=== "Analogs"
-??? warning "If you're using an AMD graphics card"
+--8<-- "docs/snippets/bemani/sdvx/spicecfg_analogs.md"
- A few more files are required to make your game work with AMD as the game was built for NVIDIA.
+=== "Overlay"
- - From the spice2x archive, extract the `.dll` files found in `spice2x\stubs\64\` to your data's `modules` folder.
+--8<-- "docs/snippets/bemani/common/spicecfg_overlay.md"
- 
+=== "Lights"
-### Configuring spice2x
+--8<-- "docs/snippets/bemani/common/spicecfg_lights.md"
-!!! info "Open `spicecfg.exe`, each following sub-section corresponds to a tab at the top."
+=== "Cards"
-#### Buttons
+--8<-- "docs/snippets/bemani/common/spicecfg_cards.md"
-!!! tip ""
+=== "Patches"
- Click on `Bind` then press the key you want associated with the action.
+--8<-- "docs/snippets/bemani/common/spicecfg_patches.md"
- With your controller and/or keyboard plugged in, configure your keys for:
+=== "API"
- - **Maintenance:** `Service, Test`
- - **Game buttons:** `BT-A, BT-B, BT-C, BT-D, FX-L, FX-R, Start`
- - **P1 Keypad**: `Keypad 0 to 9, Keypad Insert Card`
+--8<-- "docs/snippets/bemani/common/spicecfg_api.md"
- **Only if** you're playing using a keyboard:
+=== "Options"
- - **Knobs:** `VOL-L Left, VOL-L Right, VOL-R Left, Vol-R Right`
+--8<-- "docs/snippets/bemani/common/spicecfg_options.md"
+
+--8<-- "docs/snippets/bemani/common/spicecfg_options_nvprofile.md"
+
+=== "Advanced"
+
+--8<-- "docs/snippets/bemani/common/spicecfg_advanced.md"
+
+=== "Development"
+
+--8<-- "docs/snippets/bemani/common/spicecfg_development.md"
+
+## Configuring Audio
+
+--8<-- "docs/snippets/bemani/common/setup_audio.md"
+
+## Connecting to a network
+
+--8<-- "docs/snippets/bemani/common/setup_network.md"
+
+## Configuring your game
+
+!!! info "Read through the [Extra Information](extras.md) page"
+
+## Monitor Orientation
+
+--8<-- "docs/snippets/bemani/common/display_portraitfirst.md"
+
+## Installing VCRedist & DirectX
+
+--8<-- "docs/snippets/common/setup_vcredist_directx.md"
+
+## Before playing
+
+!!! tip "A few things to remember before each play session"
+
+ - Close of any applications running in the background which could affect performance
+ - Double-check your monitor orientation is correct for this game
+ - Double-check your sample rate is correct for this game
+ - Connect your controller
-#### Analogs (controller/cab only)
+## First launch
!!! tip ""
- With a controller rather than binding buttons to VOL-L and VOL-R, you need to:
+ If you've followed all instructions correctly, you're finally ready to launch the game!
- - Click `Bind`.
- - In `Device`, pick your controller.
- - In `Control`, pick `X` for `VOL-L` or `Y` for `VOL-R`.
- - Turn your knob ensuring that the Preview knob turns along with it.
- - Click `Close`, leaving the rest of the settings alone.
- - Repeat for your other knob.
-
-#### Overlay
-
-!!! tip ""
-
- Modifying buttons in this section is not required but you are free to change what you want.
-
- Click on `Bind` then press the key you want associated with the action.
-
-#### Lights (controller/cab only)
-
-!!! tip ""
-
- Your controller might support having its lights controlled by the game through spice2x.
-
- If it does, here's how you may link different actions to your lights:
-
- - Click `Bind`.
- - In `Device`, pick your controller.
- - In `Light Control`, select the corresponding light.
- - Click `Close`.
- - Repeat for your other lights.
-
-#### Cards
-
-!!! info "Covered in the [Connecting to a network](#connecting-to-a-network) section."
-
-#### Patches
-
-!!! info "Go through the [spice2x Patching](/extras/patchsp2x.md) page to import patches."
-
-!!! tip ""
-
- Ever since the 2024-09-10 update, patches have a description built-in to them.
-
- To view it, hover-over the `(?)` or `(!)` to the left of each patch's name.
-
-!!! danger "To prevent issues, avoid patching things you don't need or understand."
-
-#### API
-
-!!! warning "Leave everything at default unless you know what you're doing."
-
-#### Options
-
-!!! info "If you don't know what an option does, hover over the question mark at the very left."
-
- 
-
-!!! danger "Be very careful changing options you don't understand as it may cause issues."
-
-!!! tip "Required"
-
- | Category | Option | Parameter | Setting |
- |---------------|-----------------------|-------------------|---------|
- | Game Options | SDVX Disable Cameras | -sdvxdisablecams | ON |
- | Network | EA Service URL | -url | Covered in [Connecting to a network](#connecting-to-a-network) |
-
-!!! tip "Highly Recommended for NVIDIA users ONLY"
-
- | Category | Option | Parameter | Setting |
- |-------------------|-----------------------------------|---------------| |
- | Graphics (common) | NVIDIA profile optimization | -nvprofile | ON |
-
-
-#### Advanced & Development
-
-!!! warning "Leave everything at default unless you know what you're doing."
-
----
-### Connecting to a network
-
-!!! danger "Please choose one of the two solutions, not both!"
-
-??? tip "Remote (Online Network)"
-
- Open `spicecfg.exe` and head to the `Options` tab.
-
- In the `Network` category, set the following settings:
-
- - `EA Service URL` to the URL provided by your network.
- - `PCBID` to the PCBID provided by your network.
-
- 
-
- Next you need a card number.
- If you don't already have one, generate one in the `Cards` tab.
- To keep your card number safe, create a new `.txt` file with ONLY it inside.
-
- Once that's done, head to the `Cards` tab, for `Player 1` click `Open...` and point to your text file.
-
- 
-
-??? tip "Local e-amuse Emulator (Asphyxia)"
-
- This is covered in the [Asphyxia CORE](/extras/asphyxia.md) page.
-
----
-### Pre-launch requirements
-
-!!! info "These steps are required, otherwise your game won't run."
-
-#### 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 ""
-
- - Open `spicecfg.exe`.
- - At the very top, click on `Shortcuts` then `Audio Playback Devices`.
- - In the popup window, right click on your default audio device, and click on `Properties`.
- - Go to the `Advanced` tab.
- - Check both boxes under `Exclusive Mode`.
- - Open the `Default Format` dropdown.
- - Pick the `16 bit, 44100 Hz (CD Quality)` option and click `Apply` then `OK`.
-
- 
-
-#### Monitor orientation
-
-!!! tip ""
-
- Before each play session, you will have to make sure your monitor is in `Portrait` or `Portrait (flipped)` mode.
-
- To do so:
-
- - Right click on your desktop.
- - Click `Display Options`.
- - Look for `Display orientation` and set it to `Portrait` or `Portrait (flipped)`.
-
- 
-
- - Rotate your monitor vertically.
-
-#### Valkyrie / Nemsys / Language settings
-
-!!! info "Read through the [Extra Information](extras.md) page and edit your `prop\ea3-config.xml` file if necessary."
-
----
-### First launch
-
-!!! danger "If you have any issues running the game, refer to the [Troubleshooting](troubleshooting.md) page."
-
-!!! tip ""
-
- If you've followed all instructions correctly, you're now finally ready to launch the game!
-
- **First plug your controller if you have one** and run `spice64.exe`, press `Yes` when it asks for elevated privileges.
+ Run `spice64.exe`, press `Yes` when it asks for elevated privileges.
The game will go through a series of checks, let it run, if you've done everything properly they'll pass.
-#### Calibration
-
-
-
-!!! tip ""
+
If you're seeing this screen, it means you need to calibrate your knobs.
- Press your `Test` key. The game will instruct you where to navigate inside the menu.
+ Press your `Test` key. Here is how you navigate this menu:
- - Press `BT-A` to go up.
- - Press `BT-B` to go down.
- - Press `Start` to select.
+ - Press `BT-A` to go up
+ - Press `BT-B` to go down
+ - Press `Start` to select
Select `I/O CHECK` and press `Start`.
-
-
-!!! tip ""
+
Select `CALIBRATION SETTINGS` and press `Start`.
-
-
-
-!!! tip ""
+
+
Select `CALIBRATION` and press `Start`.
First, your left knob (`VOL-L` for keyboard players)
- 1. **Slowly turn** your **LEFT knob counterclockwise** (`VOL-L Left`) until the first line says `COUNT = OK`.
- 2. Press `Start`.
- 3. **Slowly turn** your **LEFT knob clockwise** (`VOL-L Right`) until the first line says `COUNT = OK`.
- 4. Press `Start`.
+ - **Slowly turn** your **LEFT knob counterclockwise** (`VOL-L Left`) until the line says `COUNT = OK` then press `Start`.
+ - **Slowly turn** your **LEFT knob clockwise** (`VOL-L Right`) until the line says `COUNT = OK` then press `Start`.
Now same thing but for the right knob (`VOL-R` for keyboard players)
- 5. **Slowly turn** your **RIGHT knob counterclockwise** (`VOL-R Left`) until the first line says `COUNT = OK`.
- 6. Press `Start`.
- 7. **Slowly turn** your **RIGHT knob clockwise** (`VOL-R Right`) until the first line says `COUNT = OK`.
- 8. Press `Start`.
+ - **Slowly turn** your **RIGHT knob counterclockwise** (`VOL-R Left`) until the line says `COUNT = OK` then press `Start`.
+ - **Slowly turn** your **RIGHT knob clockwise** (`VOL-R Right`) until the line says `COUNT = OK` then press `Start`.
-
+
-!!! tip ""
-
Select `SAVE AND EXIT` and press `Start`.
-
-
-!!! tip ""
+
Select `GAME MODE` and press `Start`.
- You're all done! The game should load up properly now.
+ You're all done! The game should load up properly now and you may card in.
----
-### Carding in
+## Troubleshooting
-!!! tip ""
+!!! warning "Need help?"
- Once the game is done loading, you need to card in.
+ These guides might help:
- - Press your `Keypad Insert Card` button.
- - Enter your code using your keypad binds.
+ - [Extra Information](extras.md)
+ - [Troubleshooting](troubleshooting.md)
+ - [Error Codes](/errorcodes/bemani.md)
----
-### Troubleshooting
-
-!!! warning "Have any other issue?"
-
- Check out the [Troubleshooting](troubleshooting.md) and [Error Codes](/errorcodes/bemani.md) pages.
-
- For any more game-specific information, check out [Extra Information](extras.md).
+ Still stuck? Join our Discord community to ask for help!
+ You can find the invite link on our [homepage](/index.md).
\ No newline at end of file
diff --git a/docs/games/bemani/sdvx/6_exceedgear/troubleshooting.md b/docs/games/bemani/sdvx/6_exceedgear/troubleshooting.md
index 79a7f2b0..78125846 100644
--- a/docs/games/bemani/sdvx/6_exceedgear/troubleshooting.md
+++ b/docs/games/bemani/sdvx/6_exceedgear/troubleshooting.md
@@ -1,87 +1,131 @@
-# SOUND VOLTEX EXCEED GEAR
+# Troubleshooting
-!!! 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." +--8<-- "docs/snippets/common/data_warning.md" ---- -### I'm having performance issues! +!!! 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 - 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. +### Crashes ---- -### My game is running slow/fast, After finishing a song the game gets stuck loading! +!!! info "Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.
If you have them installed, close them both before starting any arcade game." -!!! tip "" +??? tip "`W:BM2D: CreateLayer() 指定したレイヤーは存在しません` then `EXCEPTION_ACCESS_VIOLATION` in logs" - The most common reason for this is the game is running over its required refresh rate. - 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. - ---- -### My game is crashing shortly after launching! - -!!! danger "This only applies if you have updated to `2025121000`" - -!!! tip "" - - Check your `log.txt` for the following message: -
- `W:BM2D: CreateLayer() 指定したレイヤーは存在しません touch_effect` - - It means someone gave you bad update data. - - 1. Check your `contents` directory and `modules` directory. You should only have DLLs in one of them. If you have it in both, delete the DLLs in `contents` directory and keep the DLLs in `modules`. - - 2. Check your `modules` directory. `afp-core.dll` must be `1015KB` and `afp-utils.dll` must be `179KB`. If they are not, then you missed an update. Find and redownload `2024110500` update and onwards. Make sure you properly copy *all* DLLs to the `modules` directory in each update. Do not ask where to obain the update in the Discord server. ---- -### How do I set my offset? - -!!! tip "" - - Play through a chart you're comfortable with. - - If you're getting too many `Late`, decrease your offset `(-)`. - If you're getting too many `Early`, increase your offset `(+)`. - - Sound Voltex Exceed Gear has two types of offset adjustments, visual and audio based, so be sure to fiddle with both to find desirable settings. - ---- -### How do I run the game windowed borderless? - -!!! tip "" - - Some players utilize windowed mode and use 3rd party software called [Borderless Gaming](https://github.com/Codeusa/Borderless-Gaming/releases) in order to achieve this, follow the program's instructions accordingly. - ---- -### Where are all the navigators? - -!!! tip "" - - Many navigators are locked behind network requirements and they will not show unless connected to a network that has written support for the events they're typically locked behind. - ---- -### My game audio is super quiet! - -!!! tip "" - - Press your `Test` key to enter its menu, go to `SOUND OPTIONS` and change the volume from `20` to `30`. - ---- -### When I run the game all other audio is gone! - -!!! tip "" - - Sound Voltex Exceed Gear 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). + - Open `log.txt` using an editor that supports `SHIFT-JIS` encoding for Japanese text (like [Notepad++](https://notepad-plus-plus.org/downloads/)) - You can use the `Shared Mode WASAPI` patch to deal with some hardware issues, it can also be used to hear audio outside the game at the cost of audio latency. + - Look for this error message: `W:BM2D: CreateLayer() 指定したレイヤーは存在しません touch_effect` + *Note: While `touch_effect` is common, the missing resource name may vary* ---- -### I'm not getting any audio / My game crashes due to audio + If you find it, and it's followed by: `W:signal: exception raised: EXCEPTION_ACCESS_VIOLATION` + + Then there's a **problem with your game data**. -!!! tip "" + - Make sure there are no DLL files next to the main game directories (`data`, `prop`, etc..) + If there are, **move them all** under the `modules` directory - Many setups have found some difficulty with audio due to various equipment being used. Consider using the `Shared Mode WASAPI` patch. + For game version `2024-11-05` and newer, check the following files in your `modules` directory: + + - `afp-core.dll` should be 1,015 KB + - `afp-utils.dll` should be 179 KB + + If the sizes don't match: + + - Redownload `2024110500` and newer updates + - Re-apply all updates in chronological order, always copying **all** DLL files to the `modules` directory + + If the issue isn't resolved by now, **we recommend performing a fresh installation using trusted data sources**. + +??? tip "`W:SuperstepSound: Audio device is not available!!!` in logs" + + - Open `log.txt` using an editor that supports `SHIFT-JIS` encoding for Japanese text (like [Notepad++](https://notepad-plus-plus.org/downloads/)) + + - 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. + 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" + + 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. + + There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead. + +### Performance + +!!! info "Check out spice2x's [PC optimization](https://github.com/spice2x/spice2x.github.io/wiki/PC-optimization) guide" + +??? 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 + + Try these steps to resolve framerate issues: + + - 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 + + If issues persist: + + - Double-check that you followed all steps in the [setup guide](setup.md) correctly + - Your PC hardware might be insufficient to keep a steady 120 FPS, you can try to either: + - [Patch](/extras/patchsp2x.md) the game with `Valkyrie Mode 60Hz` to stick in Valkyrie mode but run at 60 FPS + - [Switch to Nemsys mode](extras.md#nemsys-and-valkyrie-modes) + - 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/loud" + + - Make sure to not be in a credit as your current progress will be lost + - Bind and press your `Test` key to enter the Test menu + - Go to `SOUND OPTIONS` and change the volume at will + - `SAVE AND EXIT` > `GAME MODE` to return to the game + +## 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 "Where are all the navigators? Why am I missing songs?" + + A lot of content is locked behind events and will not show up unless connected to a network that has written support for these events. + + 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)`. \ No newline at end of file