diff --git a/docs/errorcodes/bemani.md b/docs/errorcodes/bemani.md index 732c50b9..bd266f17 100644 --- a/docs/errorcodes/bemani.md +++ b/docs/errorcodes/bemani.md @@ -94,7 +94,7 @@ Setup error in pop'n Usaneko. Follow [Game Setup](/games/bemani/popn/usaneko/setup.md) and use proper `-url` and `-p` parameters in SpiceTools. -## Jubeat +## jubeat ### 5-2500-0000 diff --git a/docs/extras/datamods.md b/docs/extras/datamods.md index 926d7e60..558a8e4f 100644 --- a/docs/extras/datamods.md +++ b/docs/extras/datamods.md @@ -33,7 +33,7 @@ If you're confused, the following may help you understand what this means. - ``` + ``` hl_lines="6-11" 📂data ┣━📂graphic ┣━📂info @@ -41,10 +41,10 @@ ┗━📂sound 📂data_mods ┗━📂mod_folder - ┣━📂graphic <--- Files that modify data/graphic go here - ┣━📂info <--- Files that modify data/info go here - ┣━📂movie <--- Files that modify data/movie go here - ┗━📂sound <--- Files that modify data/sound go here + ┣━📂graphic - Files that modify data/graphic go here + ┣━📂info - Files that modify data/info go here + ┣━📂movie - Files that modify data/movie go here + ┗━📂sound - Files that modify data/sound go here 📂dev 📂modules 📂prop diff --git a/docs/games/bemani/ddr/common/setup.md b/docs/games/bemani/ddr/common/setup.md index 9ba4f171..ad641ca3 100644 --- a/docs/games/bemani/ddr/common/setup.md +++ b/docs/games/bemani/ddr/common/setup.md @@ -63,14 +63,14 @@ - Visit [spice2x.github.io](https://spice2x.github.io) to download the latest release - Extract both `spice.exe` and `spicecfg.exe` from the archive into your game's directory - ``` + ``` hl_lines="6-7" 📂arkdata 📂com 📂data 📂modules 📂prop - 🌶️spice.exe <--- - 🌶️spicecfg.exe <--- + 🌶️spice.exe + 🌶️spicecfg.exe ``` ??? tip "For MDX-003 (64 bits)" @@ -78,14 +78,14 @@ - Visit [spice2x.github.io](https://spice2x.github.io) to download the latest release - Extract both `spice64.exe` and `spicecfg.exe` from the archive into your game's directory - ``` + ``` hl_lines="6-7" 📂arkdata 📂com 📂data 📂modules 📂prop - 🌶️spice64.exe <--- - 🌶️spicecfg.exe <--- + 🌶️spice64.exe + 🌶️spicecfg.exe ``` ## Configuring spice2x diff --git a/docs/games/bemani/iidx/common/31plus/setup.md b/docs/games/bemani/iidx/common/31plus/setup.md index dcf0f23a..16d7c542 100644 --- a/docs/games/bemani/iidx/common/31plus/setup.md +++ b/docs/games/bemani/iidx/common/31plus/setup.md @@ -50,13 +50,13 @@ --8<-- "docs/snippets/bemani/common/spice2x64_install.md" - ``` + ``` hl_lines="5-6" 📂data 📂dev 📂modules 📂prop - 🌶️spice64.exe <--- - 🌶️spicecfg.exe <--- + 🌶️spice64.exe + 🌶️spicecfg.exe ``` --8<-- "docs/snippets/bemani/common/spice2x64_stubs.md" diff --git a/docs/games/bemani/jubeat/avenue/setup.md b/docs/games/bemani/jubeat/avenue/setup.md new file mode 100644 index 00000000..858629dc --- /dev/null +++ b/docs/games/bemani/jubeat/avenue/setup.md @@ -0,0 +1,2 @@ + +--8<-- "docs/games/bemani/jubeat/common/setup.md" \ No newline at end of file diff --git a/docs/games/bemani/jubeat/beyondtheavenue/setup.md b/docs/games/bemani/jubeat/beyondtheavenue/setup.md new file mode 100644 index 00000000..6a784065 --- /dev/null +++ b/docs/games/bemani/jubeat/beyondtheavenue/setup.md @@ -0,0 +1,2 @@ + +--8<-- "docs/games/bemani/jubeat/common/setup.md" \ No newline at end of file diff --git a/docs/games/bemani/jubeat/clan/setup.md b/docs/games/bemani/jubeat/clan/setup.md deleted file mode 100644 index 92e1125f..00000000 --- a/docs/games/bemani/jubeat/clan/setup.md +++ /dev/null @@ -1,81 +0,0 @@ - -# Game Setup - ---8<-- "docs/snippets/common/old_guide.md" - ---8<-- "docs/snippets/common/data_warning.md" - -## Getting Started - -!!! tip "" - 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 main folder and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file whatever 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` and save the file. - - What do these different parameters do? - - - `-ea` enables an integrated e-amusement server within SpiceTools. - - 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/` 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. - - 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 "" - The last steps you'll have to do with your chosen tools is simply setting up your desired keybinds! Make sure you setup the `Test` keybind as it will be critical for setting up the game. Once you've done that, launch your game for the first time by double clicking the `.bat` you setup and the game should load. - - If it's your first time running the game, you'll immediately be greeted with this screen (cropped to save your sanity with scrolling repeatedly on the page), oh no! - - - -!!! tip "" - This is okay, you can use your mouse or touchscreen to simply hit `TEST` to initialize the backup data, the game will prompt you to reboot, but let's save ourselves some time and instead go into the `GAME OPTIONS` menu instead, as shown below. If you rebooted, you will see a message telling you to set the "Shop Settings" which is what we're going to now do, as shown below. - - - -!!! tip "" - Enter the `GAME OPTIONS` menu and proceed to the `SHOP SETTINGS` menu. - - - -!!! tip "" - From here, we will need to set the `SHOP NAME SETTINGS`. This is a simple process, simply navigate using the controls in the menu to set any name you desire! For the purpose of the guide, we named it `Guide` but highly encourage fun and/or lazy names. Lastly, if you're not connected to an online network, you'll need to set the `SHOP AREA` as well, navigate to any option you prefer, they're all predefined so you can't get creative here, pictured below is what we set ours to. - - - -!!! tip "" - With that, you're all done! Simply exit the service menu or reboot then enjoy the game, have fun! - -!!! warning "Have any other errors?" - Check out the [Troubleshooting](troubleshooting.md) section and [Error Code](/errorcodes/bemani.md) section to resolve any issues not seen in this guide to greater depth. \ No newline at end of file diff --git a/docs/games/bemani/jubeat/clan/troubleshooting.md b/docs/games/bemani/jubeat/clan/troubleshooting.md deleted file mode 100644 index 6421a3d7..00000000 --- a/docs/games/bemani/jubeat/clan/troubleshooting.md +++ /dev/null @@ -1,39 +0,0 @@ - -# Troubleshooting - ---8<-- "docs/snippets/common/old_guide.md" - ---8<-- "docs/snippets/common/data_warning.md" - -## Hardware Specs - -!!! tip "" - Bemani PC (ADE-704A) - - This board has a E4690 Radeon MXM card. - - CPU: Intel Celeron B810 - - GPU: AMD Radeon E4690 - - Chipset: Intel HM65 - -### My Game Is Running Slow/Lagging - -!!! tip "" - Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well. - -### My Game Is Running Crazy Fast! - -!!! 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. - -### Occasional Game Stutters During Play - -!!! tip "" - Sometimes you might have occasional stutters during play, while solutions can vary wildly from general performance issues to bad hard drives, try adding SpiceTools `-realtime` parameter to your .bat file. - -### My Touchscreen Isn't Working! - -!!! tip "" - There's a myriad of reasons for this. With SpiceTools in most cases, try using the `-wintouch` parameter if rawinput is not working for your monitor. \ No newline at end of file diff --git a/docs/games/bemani/jubeat/common/setup.md b/docs/games/bemani/jubeat/common/setup.md new file mode 100644 index 00000000..1a82f510 --- /dev/null +++ b/docs/games/bemani/jubeat/common/setup.md @@ -0,0 +1,175 @@ +# Game Setup + +--8<-- "docs/snippets/common/data_warning.md" + +## Preparing data + +--8<-- "docs/snippets/common/data_readonly.md" + + The **complete game data** should be approximately **10 GB or larger**. + If your data is significantly smaller, you likely have an update archive instead of the full game data. + + Here's what the expected data structure should look like: + + ``` + 📂data + 📂modules + 📂prop + ⚙️msvcr100.dll + ``` + +!!! danger "If your data does not look like this" + + If you have **other** `.dll` files next to your `data`, `prop`, etc., folders: + + - Create a `modules` folder if it does not exist already + - Move all `.dll` files into it + + If extra directories or files are still present (executables, scripts, etc.), **remove them**. + + **This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.** + +!!! info "If your data is already up-to-date, you can skip ahead to the [Installing spice2x](#installing-spice2x) section" + +## Updating data + +!!! danger "Make sure you're using the right update for your current game version" + + jubeat updates have `L44` and one or two datecodes in their archive names. + + **Single datecode:** Contains one update (e.g., `L44_NewDateCode.7z`) + **Two datecodes:** Updates from the older to newer version (e.g., `L44_OldDateCode-NewDateCode.rar`) + + A date code should look something like this: `YYYYMMDDXX` + + In the two-datecode example: + + - `OldDateCode` is the older date, the game version required to apply this update + - `NewDateCode` is the newer date, and is the version you'll arrive at after applying the update + +--8<-- "docs/snippets/bemani/common/data_update.md" + +## Installing spice2x + +--8<-- "docs/snippets/bemani/common/spice2x32_install.md" + + ``` hl_lines="5-6" + 📂data + 📂modules + 📂prop + ⚙️msvcr100.dll + 🌶️spice.exe + 🌶️spicecfg.exe + ``` + +--8<-- "docs/snippets/bemani/common/spice2x32_stubs.md" + +## Configuring spice2x + +--8<-- "docs/snippets/bemani/common/spicecfg_preamble.md" + +=== "Buttons" + +--8<-- "docs/snippets/bemani/common/spicecfg_buttons.md" + + !!! tip "Binding your buttons" + + Click on `Bind` or `Naive` 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` + - **Game buttons**: `Button 1 to Button 16` + - **Keypad**: `Keypad Insert Card` + + !!! tip "Using a touch screen" + + spice2x supports using a touch screen instead of the 16 game buttons. In that case, you don't need to bind these buttons. + +--8<-- "docs/snippets/bemani/common/spicecfg_buttons_additionalinfo.md" + +=== "Analogs" + +--8<-- "docs/snippets/bemani/common/spicecfg_nochange.md" + +=== "Overlay" + +--8<-- "docs/snippets/bemani/common/spicecfg_overlay.md" + +=== "Lights" + +--8<-- "docs/snippets/bemani/common/spicecfg_lights.md" + +=== "Cards" + +--8<-- "docs/snippets/bemani/common/spicecfg_cards.md" + +=== "Patches" + +--8<-- "docs/snippets/bemani/common/spicecfg_patches.md" + +=== "API" + +--8<-- "docs/snippets/bemani/common/spicecfg_nochange.md" + +=== "Options" + +--8<-- "docs/snippets/bemani/common/spicecfg_options_nvprofile.md" + +=== "Advanced" + +--8<-- "docs/snippets/bemani/common/spicecfg_nochange.md" + +=== "Development" + +--8<-- "docs/snippets/bemani/common/spicecfg_nochange.md" + +## Connecting to a network + +--8<-- "docs/snippets/bemani/common/setup_network.md" + +## Installing VCRedist & DirectX + +--8<-- "docs/snippets/common/setup_vcredist_directx.md" + +## Before playing + +--8<-- "docs/snippets/common/before_playing.md" + +## First launch + +!!! 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 `spice.exe`, press `Yes` when it asks for elevated privileges. + + If it's your first time running the game, you'll immediately be greeted with this screen. + + + + Press your `Test` key to initialize the backup data, another message with the same error will pop up. + Press your `Test` key again to open the service menu. + + Instructions on how to navigate the menu are shown on the screen. + + Go to `GAME OPTIONS`, then `SHOP SETTINGS`. + + + + You will need to set a shop name. + + - Name your shop to whatever you'd like. Again, navigation instructions are on the screen. + - Press the `EXIT` button. + + Then, set the shop area to whatever region you'd like. + + Select `SAVE AND EXIT` then `EXIT`. + + Finally, select `GAME MODE`. + +!!! success "You're all done! The game should load up properly now" + +## Help + +--8<-- "docs/snippets/common/help.md" \ No newline at end of file diff --git a/docs/games/bemani/jubeat/festo/setup.md b/docs/games/bemani/jubeat/festo/setup.md new file mode 100644 index 00000000..c2a470b0 --- /dev/null +++ b/docs/games/bemani/jubeat/festo/setup.md @@ -0,0 +1,2 @@ + +--8<-- "docs/games/bemani/jubeat/common/setup.md" \ No newline at end of file diff --git a/docs/games/bemani/museca/1plushalf/setup.md b/docs/games/bemani/museca/1plushalf/setup.md index f6276731..896a41b9 100644 --- a/docs/games/bemani/museca/1plushalf/setup.md +++ b/docs/games/bemani/museca/1plushalf/setup.md @@ -24,13 +24,13 @@ --8<-- "docs/snippets/bemani/common/spice2x64_install.md" - ``` + ``` hl_lines="5-6" 📂data 📂dev 📂modules 📂prop - 🌶️spice64.exe <--- - 🌶️spicecfg.exe <--- + 🌶️spice64.exe + 🌶️spicecfg.exe ``` --8<-- "docs/snippets/bemani/common/spice2x64_stubs.md" diff --git a/docs/games/bemani/popn/common/setup.md b/docs/games/bemani/popn/common/setup.md index 6da13219..d7c57b8b 100644 --- a/docs/games/bemani/popn/common/setup.md +++ b/docs/games/bemani/popn/common/setup.md @@ -44,13 +44,13 @@ --8<-- "docs/snippets/bemani/common/spice2x32_install.md" - ``` + ``` hl_lines="5-6" 📂data 📂dev 📂modules 📂prop - 🌶️spice.exe <--- - 🌶️spicecfg.exe <--- + 🌶️spice.exe + 🌶️spicecfg.exe ``` ## Configuring spice2x diff --git a/docs/games/bemani/sdvx/6_exceedgear/setup.md b/docs/games/bemani/sdvx/6_exceedgear/setup.md index b3955cfb..62e6de08 100644 --- a/docs/games/bemani/sdvx/6_exceedgear/setup.md +++ b/docs/games/bemani/sdvx/6_exceedgear/setup.md @@ -46,14 +46,14 @@ --8<-- "docs/snippets/bemani/common/spice2x64_install.md" - ``` + ``` hl_lines="6-7" 📂data 📂dev 📂ext 📂modules 📂prop - 🌶️spice64.exe <--- - 🌶️spicecfg.exe <--- + 🌶️spice64.exe + 🌶️spicecfg.exe ``` --8<-- "docs/snippets/bemani/common/spice2x64_stubs.md" diff --git a/docs/img/bemani/jubeat/avenue/logo.webp b/docs/img/bemani/jubeat/avenue/logo.webp new file mode 100644 index 00000000..39892f6d Binary files /dev/null and b/docs/img/bemani/jubeat/avenue/logo.webp differ diff --git a/docs/img/bemani/jubeat/beyondtheavenue/logo.webp b/docs/img/bemani/jubeat/beyondtheavenue/logo.webp new file mode 100644 index 00000000..8958e7c5 Binary files /dev/null and b/docs/img/bemani/jubeat/beyondtheavenue/logo.webp differ diff --git a/docs/img/bemani/jubeat/clan/1.webp b/docs/img/bemani/jubeat/clan/1.webp deleted file mode 100644 index d28092ff..00000000 Binary files a/docs/img/bemani/jubeat/clan/1.webp and /dev/null differ diff --git a/docs/img/bemani/jubeat/clan/10.webp b/docs/img/bemani/jubeat/clan/10.webp deleted file mode 100644 index 8373459e..00000000 Binary files a/docs/img/bemani/jubeat/clan/10.webp and /dev/null differ diff --git a/docs/img/bemani/jubeat/clan/2.webp b/docs/img/bemani/jubeat/clan/2.webp deleted file mode 100644 index ad5ba610..00000000 Binary files a/docs/img/bemani/jubeat/clan/2.webp and /dev/null differ diff --git a/docs/img/bemani/jubeat/clan/3.webp b/docs/img/bemani/jubeat/clan/3.webp deleted file mode 100644 index 095b3e63..00000000 Binary files a/docs/img/bemani/jubeat/clan/3.webp and /dev/null differ diff --git a/docs/img/bemani/jubeat/clan/5.webp b/docs/img/bemani/jubeat/clan/5.webp deleted file mode 100644 index b73d463a..00000000 Binary files a/docs/img/bemani/jubeat/clan/5.webp and /dev/null differ diff --git a/docs/img/bemani/jubeat/clan/6.webp b/docs/img/bemani/jubeat/clan/6.webp deleted file mode 100644 index 2e3f3a16..00000000 Binary files a/docs/img/bemani/jubeat/clan/6.webp and /dev/null differ diff --git a/docs/img/bemani/jubeat/clan/7.webp b/docs/img/bemani/jubeat/clan/7.webp deleted file mode 100644 index aa38322a..00000000 Binary files a/docs/img/bemani/jubeat/clan/7.webp and /dev/null differ diff --git a/docs/img/bemani/jubeat/clan/8.webp b/docs/img/bemani/jubeat/clan/8.webp deleted file mode 100644 index 43a02ccc..00000000 Binary files a/docs/img/bemani/jubeat/clan/8.webp and /dev/null differ diff --git a/docs/img/bemani/jubeat/clan/9.webp b/docs/img/bemani/jubeat/clan/9.webp deleted file mode 100644 index 5a8bfb14..00000000 Binary files a/docs/img/bemani/jubeat/clan/9.webp and /dev/null differ diff --git a/docs/img/bemani/jubeat/clan/logo.webp b/docs/img/bemani/jubeat/clan/logo.webp deleted file mode 100644 index 13b9ebbe..00000000 Binary files a/docs/img/bemani/jubeat/clan/logo.webp and /dev/null differ diff --git a/docs/img/bemani/jubeat/common/firstlaunch/backup_data_error.webp b/docs/img/bemani/jubeat/common/firstlaunch/backup_data_error.webp new file mode 100644 index 00000000..ea2fa653 Binary files /dev/null and b/docs/img/bemani/jubeat/common/firstlaunch/backup_data_error.webp differ diff --git a/docs/img/bemani/jubeat/common/firstlaunch/shop_settings.webp b/docs/img/bemani/jubeat/common/firstlaunch/shop_settings.webp new file mode 100644 index 00000000..cf9514c2 Binary files /dev/null and b/docs/img/bemani/jubeat/common/firstlaunch/shop_settings.webp differ diff --git a/docs/img/bemani/jubeat/festo/logo.webp b/docs/img/bemani/jubeat/festo/logo.webp new file mode 100644 index 00000000..219b1aa2 Binary files /dev/null and b/docs/img/bemani/jubeat/festo/logo.webp differ diff --git a/docs/snippets/bemani/common/data_bad.md b/docs/snippets/bemani/common/data_bad.md index 98c483ec..32590817 100644 --- a/docs/snippets/bemani/common/data_bad.md +++ b/docs/snippets/bemani/common/data_bad.md @@ -1,6 +1,6 @@ !!! danger "If your data does not look like this" - If you have `.dll` files next to your `data`, `prop`, etc. folders: + If you have `.dll` files next to your `data`, `prop`, etc., folders: - Create a `modules` folder if it does not exist already - Move all `.dll` files into it diff --git a/mkdocs.yml b/mkdocs.yml index 6be058de..ffc4e3bc 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -91,10 +91,13 @@ nav: - "WORLD": - "Game Setup": "games/bemani/ddr/world/setup.md" - "Troubleshooting": "games/bemani/ddr/world/troubleshooting.md" - - "Jubeat": - - "Clan": - - "Game Setup": "games/bemani/jubeat/clan/setup.md" - - "Troubleshooting": "games/bemani/jubeat/clan/troubleshooting.md" + - "jubeat": + - "festo": + - "Game Setup": "games/bemani/jubeat/festo/setup.md" + - "Ave.": + - "Game Setup": "games/bemani/jubeat/avenue/setup.md" + - "beyond the Ave.": + - "Game Setup": "games/bemani/jubeat/beyondtheavenue/setup.md" - "GITADORA": - "Matixx": - "Game Setup": "games/bemani/gitadora/matixx/setup.md" @@ -282,6 +285,7 @@ not_in_nav: | games/bemani/sdvx/common games/bemani/ddr/common games/bemani/popn/common + games/bemani/jubeat/common games/sega/chunithm/common games/sega/maimaidx/common games/sega/ongeki/common