diff --git a/docs/games/ddr/a20/setup.md b/docs/games/ddr/a20/setup.md new file mode 100644 index 00000000..b9637d21 --- /dev/null +++ b/docs/games/ddr/a20/setup.md @@ -0,0 +1,6 @@ +# Game Setup (DDR A2O) +
+
+
+
+
+
+
+
+??? 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.**
+
+---
+### Updating data
+
+??? danger "Please make sure you're using the right update for your current data."
+
+ DDR Patches re-uploaded by the community tend to be appropriately named `MDX-DATECODE-to-DATECODE`.
+
+ For example `MDX-2024091000-to-2024101500`.
+
+ - `2024091000` being your current data's version.
+ - `2024101500` 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
+
+
+??? tip "For MDX-003 (64 bits)"
+
+ - Head over to [spice2x.github.io](https://spice2x.github.io) and download the latest release.
+ - Extract the `spice64.exe` and `spicecfg.exe` files from the archive to your game's directory.
+
+
+
+### Configuring Spice2x
+
+!!! info "Open `spicecfg.exe`, each following sub-section corresponds to a tab at the top."
+
+#### Buttons
+
+!!! tip ""
+
+ Click on `Bind` then press the key you want associated with the action.
+
+ With your controller and/or keyboard plugged in, configure your keys for:
+
+ - **Maintenance**: `Service, Test`
+ - **P1 Panel buttons**: `Up, Down, Left, Right`
+ - **P1 Menu buttons**: ` Start, Up, Down, Left, Right`
+ - **P1 Keypad**: `1 to 9, Keypad Insert Card`
+
+#### 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."
+
+!!! 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 |
+ |---------------|-----------------------|-------------------|---------|
+ | 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)
+
+#### K-lite Codec Pack
+
+!!! tip ""
+
+ - Download and install the [K-lite Codec Pack](https://codecguide.com/download_kl.htm) (the Standard version is enough)
+
+---
+### Troubleshooting
+
+!!! warning "Have any other issue?"
+
+ Check out the [Troubleshooting](troubleshooting.md) and [Error Codes](../../../errorcodes/bemani.md) pages.
\ No newline at end of file
diff --git a/docs/games/ddr/troubleshooting.md b/docs/games/ddr/troubleshooting.md
new file mode 100644
index 00000000..1d1b4f22
--- /dev/null
+++ b/docs/games/ddr/troubleshooting.md
@@ -0,0 +1,33 @@
+!!! danger "Warning"
+
+ 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.
+
+---
+### Clock error
+
+!!! tip ""
+
+ In the test menu, navigate to `CLOCK`, and set it to match your computer's time.
+
+---
+### My game is running slow/lagging
+
+!!! tip ""
+
+ Try to eliminate any unnecessary background processes during play.
+
+---
+### Unable to login / Eamuse error / Network error
+
+!!! tip ""
+
+ Get the proper Asphyxia plugin from our [Discord server](https://discord.gg/cZRUmEPK78) in the #ddr channel > Resources post.
+ Make sure you didn't enable `-smartea` in spicecfg's options.
+
+---
+### Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?
+
+!!! tip ""
+
+ These options are locked behind network requirements and will not be displayed unless you are connected to a network that has written support for these options. Patches are available to mitigate this (see [Patches](setup.md#patches)).
\ No newline at end of file
diff --git a/docs/games/ddr/world/setup.md b/docs/games/ddr/world/setup.md
new file mode 100644
index 00000000..f16a858e
--- /dev/null
+++ b/docs/games/ddr/world/setup.md
@@ -0,0 +1,6 @@
+# Game Setup (DDR WORLD)
+
+
+
\ No newline at end of file
diff --git a/docs/games/ddrace/setup.md b/docs/games/ddrace/setup.md
deleted file mode 100644
index 5145f582..00000000
--- a/docs/games/ddrace/setup.md
+++ /dev/null
@@ -1,74 +0,0 @@
-# DANCE DANCE REVOLUTION ACE
-
-!!! danger "Warning"
-
- Please make sure your data is from an appropriate source and unmodified before proceeding, this guide is unable to troubleshoot any problems related to bad or poorly managed data.
-
- If you obtained data from a torrent file, make sure you're not seeding the data before proceeding as well.
-
- Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
-
-### Getting Started
-
-!!! tip ""
-
- This game still uses DirectSound so we can skip audio related setup needed for other games. After downloading your data, the first thing to do is make sure your files aren't set to READ ONLY, make sure to uncheck it from the main folder in the Windows Properties tab if so. Then, put your desired 32-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file anything you desire, for the sake of convenience we've named ours `gamestart.bat`.
-
-
-
-
-### Configuring Your Tools
-
-!!! tip ""
-
- Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
-
-!!! warning "If you're not using SpiceTools:"
-
- The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
-
-### Configuring for a Local Network
-
-!!! tip ""
-
- For our local network configuration example, on a single line in the `.bat` file we're going to type `spice.exe -ea -w` and save the file.
-
- What do these different parameters do?
-
- - `-ea` enables an integrated e-amusement server within SpiceTools.
- - `-w` will boot the game in windowed mode which will ease our initial setup and testing later, make sure to remove `-w` to run the game fullscreen once you're done setting up!
-
- Pictured below, the contents of our `gamestart.bat` file in Notepad++.
-
-
-
-### Configuring for an Online Network
-
-!!! tip ""
-
- For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
-
- What do these different parameters do?
-
- - `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- - `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- - `-w` will boot the game in windowed mode which will ease our initial setup and testing later, make sure to remove `-w` to run the game fullscreen once you're done setting up!
-
- Pictured below, the contents of our `gamestart.bat` file in Notepad++.
-
-
-
-!!! tip ""
- One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
-
-### Final Steps and Setting up the Game
-
-!!! tip ""
-
- One last important note before booting the game is that you should install K-Lite Mega Codec (See [Common Problems/Tips](problems.md#ddr-as-video-background-are-missing-in-the-menus-andor-some-songs-soft-lock-the-game-on-the-nthfinalextra-stage-screen) for a guide!) before booting, the game will run without it, but some songs will lock up and the game will crash and all background videos will be black on most setups.
-
- With that, you're all done! The final step you'll have to do with your chosen tools is simply setting up your desired keybinds! Once you've done that, Boot the game with your `gamestart.bat` and the game should load and be ready to be enjoyed! Have fun!
-
-!!! warning "Have any other errors?"
-
- Check out the [Common Problems/Tips](problems.md) section and [Error Code](../../errorcodes/bemani.md) section to resolve any issues not seen in this guide to greater depth.
diff --git a/docs/img/ddr/a20.png b/docs/img/ddr/a20.png
new file mode 100644
index 00000000..ef746b2a
Binary files /dev/null and b/docs/img/ddr/a20.png differ
diff --git a/docs/img/ddr/a20plus.png b/docs/img/ddr/a20plus.png
new file mode 100644
index 00000000..8a92306d
Binary files /dev/null and b/docs/img/ddr/a20plus.png differ
diff --git a/docs/img/ddr/a3.png b/docs/img/ddr/a3.png
new file mode 100644
index 00000000..02a94ade
Binary files /dev/null and b/docs/img/ddr/a3.png differ
diff --git a/docs/img/ddr/setup/1_data.png b/docs/img/ddr/setup/1_data.png
new file mode 100644
index 00000000..70184c5f
Binary files /dev/null and b/docs/img/ddr/setup/1_data.png differ
diff --git a/docs/img/ddr/setup/2_spicedata32.png b/docs/img/ddr/setup/2_spicedata32.png
new file mode 100644
index 00000000..b381e3dd
Binary files /dev/null and b/docs/img/ddr/setup/2_spicedata32.png differ
diff --git a/docs/img/ddr/setup/2_spicedata64.png b/docs/img/ddr/setup/2_spicedata64.png
new file mode 100644
index 00000000..0940c925
Binary files /dev/null and b/docs/img/ddr/setup/2_spicedata64.png differ
diff --git a/docs/img/ddr/setup/3_opthover.png b/docs/img/ddr/setup/3_opthover.png
new file mode 100644
index 00000000..bbea8983
Binary files /dev/null and b/docs/img/ddr/setup/3_opthover.png differ
diff --git a/docs/img/ddr/setup/4_cards.png b/docs/img/ddr/setup/4_cards.png
new file mode 100644
index 00000000..1e24f8ef
Binary files /dev/null and b/docs/img/ddr/setup/4_cards.png differ
diff --git a/docs/img/ddr/setup/4_network.png b/docs/img/ddr/setup/4_network.png
new file mode 100644
index 00000000..4a490969
Binary files /dev/null and b/docs/img/ddr/setup/4_network.png differ
diff --git a/docs/img/ddr/world.png b/docs/img/ddr/world.png
new file mode 100644
index 00000000..9d0d2729
Binary files /dev/null and b/docs/img/ddr/world.png differ
diff --git a/mkdocs.yml b/mkdocs.yml
index 517729f7..cf0bb6f8 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -75,9 +75,18 @@ nav:
- "First Time Setup": "games/hellopopn/setup.md"
- "Common Problems/Tips": "games/hellopopn/problems.md"
- "DDR":
- - "DDR Ace":
- - "First Time Setup": "games/ddrace/setup.md"
- - "Common Problems/Tips": "games/ddrace/problems.md"
+ - "DDR A20":
+ - "Game Setup": "games/ddr/a20/setup.md"
+ - "Troubleshooting": "games/ddr/a20/troubleshooting.md"
+ - "DDR A20 PLUS":
+ - "Game Setup": "games/ddr/a20plus/setup.md"
+ - "Troubleshooting": "games/ddr/a20plus/troubleshooting.md"
+ - "DDR A3":
+ - "Game Setup": "games/ddr/a3/setup.md"
+ - "Troubleshooting": "games/ddr/a3/troubleshooting.md"
+ - "DDR WORLD":
+ - "Game Setup": "games/ddr/world/setup.md"
+ - "Troubleshooting": "games/ddr/world/troubleshooting.md"
- "Jubeat":
- "Jubeat Clan":
- "First Time Setup": "games/jubeatclan/setup.md"
@@ -203,6 +212,7 @@ not_in_nav: |
games/mu3
games/mercury
games/mai2
+ games/ddr
theme:
name: material