diff --git a/docs/games/iidx14/setup.md b/docs/games/iidx14/setup.md index 4f87cfd..552258c 100644 --- a/docs/games/iidx14/setup.md +++ b/docs/games/iidx14/setup.md @@ -1,94 +1,150 @@ # beatmania IIDX 14 GOLD - -!!! warning "Before reading" - This game ***will*** require you to touch and edit files manually. This guide tries to make everything as clear as possible. **[Bemanitools](https://github.com/djhackersdev/bemanitools/releases/download/5.44/bemanitools-5.44.zip) & [Bemanitools Supplement](https://github.com/djhackersdev/bemanitools-supplement/releases/download/1.6/bemanitools-supplement-1.6.zip)** will be used in this guide. +!!! 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." -!!! 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 encounter any issues or errors regarding this guide or come across issues that aren't listed, feel free to open up a [GitHub Issue!](https://github.com/two-torial/two-torial/issues) - - -### Getting Started +--- +### Preparing data !!! 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, locate `iidx-14-to-17.zip` inside the `bemanitools-5.44.zip`. Extract it inside the folder that contains the `bm2dx.exe` which should be located in `\GLD\2007072301`. Pictured below is what your folder should look like, we've removed any files not necessary for **GOLD**. Feel free to name your `gamestart.bat` file whatever you desire, for the sake of convenience we've kept it as it. + After downloading and extracting your data, we need to make sure your files aren't set to `Read-only`. - + - Right click the folder containing your data, then click on `Properties`. + - In the `General` tab go down to `Attributes`, untick `Read-only` and click `Apply`. + - A popup will appear, select `Apply changes to this folder, subfolder and files` and press `OK`. + - Finally, click `OK` again to exit out of properties. - - - +--- +### Installing Bemanitools !!! tip "" - - Next up, open the `bemanitools-supplement-v1.6.zip` or any version higher than that and navigate inside the `misc.zip`. Now navigate into `misc\d3d8to9` and extract `d3d8.dll` into the same folder as we previously have done. This enables us to use the graphic options inside `iidxhook-14.conf` which we will take advantage of. It should look like this: - - - - - -!!! tip "" - - Lastly, we need to install a codec so that background videos will work and won't cause an error. - Inside the [Bemanitools Supplement](https://github.com/djhackersdev/bemanitools-supplement/releases/download/1.6/bemanitools-supplement-1.6.zip) archive, navigate to `\iidx.zip\iidx\misc\` where you'll find `CLVSD.ax`. + - Download :material-package-down:[Bemanitools](https://github.com/djhackersdev/bemanitools/releases/download/5.48/bemanitools-5.48.zip). + + - Inside :material-zip-box:`bemanitools-5.48.zip` locate :material-zip-box:`iidx-14-to-17.zip`. - Extract `CLVSD.ax` inside a folder that you know won't be moved or renamed. + - Extract everything inside the folder that contains the :material-file:`bm2dx.exe` which is located in :material-folder:`\GLD\2007072301`. + + Pictured below is what your folder should look like. We've removed any files not necessary for **GOLD**. - Open up the command prompt as ***administrator***. Now type `regsvr32 "\CLVSD.ax"` into the command prompt. + - As an example, it could look like this: `regsvr32 "D:\BEMANI\IIDX\CLVSD.ax"` A prompt should appear telling you that it has been installed successfully. - This applies for all styles that require this codec, not just **DistorteD**. +#### Using iidxhook-14.conf & RtEffect.dll + +!!! tip "" + + - Download the :material-package-down:[Bemanitools supplements](https://github.com/djhackersdev/bemanitools-supplement/releases/download/1.6/bemanitools-supplement-1.6.zip) + + - Open :material-zip-box:`bemanitools-supplement-v1.6.zip` and navigate inside :material-zip-box:`misc.zip` + + - Inside :material-folder:`misc\d3d8to9`, extract :material-file-cog-outline:`d3d8.dll` to :material-folder:`\GLD\2007072301`. + + This enables us to use the graphic options inside :material-file-code:`iidxhook-14.conf` which we will take advantage of. + + - Open :material-zip-box:`bemanitools-supplement-v1.6.zip` and navigate inside :material-zip-box:`iidx.zip` + + - Inside :material-folder:`iidx/misc`, extract :material-file-cog-outline:`RtEffect_stub.dll` to :material-folder:`\GLD\2007072301`. + + - Delete the already existing :material-file-remove-outline:`RtEffect.dll` and rename :material-file-edit-outline:`RtEffect_stub.dll` to :material-file-cog-outline:`RtEffect.dll`. + + This will eliminate any immediate crashes relating to needing specific old hardware. + +#### Installing CLVSD.ax + +!!! tip "" + + We need to install a codec so that background videos will work and won't cause an error. + + - Open :material-zip-box:`bemanitools-supplement-v1.6.zip` and navigate to :material-folder:`\iidx.zip\iidx\misc\` where :material-file:`CLVSD.ax` is located. + + - Extract :material-file:`CLVSD.ax` inside a :material-folder: folder that you know won't be moved or renamed. + + - Open the :material-console:command prompt as ***administrator***. Now type `regsvr32 "\CLVSD.ax"` into the command prompt. + + As an example, it could look like this: `regsvr32 "D:\BEMANI\IIDX\CLVSD.ax"` + + A prompt should appear telling you that it has been installed successfully. + This applies for all styles that require this codec, not just **GOLD**. If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file. - You ***can not*** move or delete `CLVSD.ax` ***at all***, otherwise it will revert the changes and you have to install it again. +!!! danger "You **can not** move or delete :material-file:`CLVSD.ax` **at all**, otherwise it will revert the changes and you have to install it again." -### Configuring Your Tools +--- +### Configuring Bemanitools + +!!! info "To configure your keybinds, open your :material-file:`config.bat` file." + +#### Buttons !!! tip "" - To configure your keybinds, open up your `config.bat` file. You'll be greeted by this screen: - + Double click on the right on a button that you wish to 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 Game buttons**: `1 to 7, Start, EFFECT, VEFX` + - **P1 Keypad**: `Keypad Insert Card` + + **Only if** you're playing using a keyboard: + + - **Turntable**: `TT+, TT-` **and optionally** `TT+/-` which alternates between `TT+` and `TT-` on each press. + +#### Analogs (controller/cab only) !!! tip "" - It works similarly to Spice but not entirely. Make sure to also bind `Test` and `Service` since we will need it later. `Service` will also be used to **insert coins** to start the game. When you're done setting up your keybinds and analogs, it should look something like this: - - -!!! info "If you'd like to play offline, you can head straight to [Setting up the games resolution](#setting-up-the-games-resolution-locking-fps-and-fixing-stretched-videos)" + With a controller rather than binding buttons to `TT+` and `TT-`, you need to: -### Configuring Bemanitools for an Online Network + - Head to the `Analogs` tab at the top. + - In `Device`, pick your controller. + - In `Control`, pick whichever one corresponds to the turntable. + - Turn your turntable ensuring that the preview turns along with it. + - Click `OK`, leaving the rest of the settings alone. + +#### Lights (controller/cab only) !!! tip "" - After setting the keybinds and analogs, we can head over to the `Network` tab, which will look like this: - + Your controller might support having its lights controlled by the game through bemanitools. + + If it does, here's how you may link different actions to your lights: + + - In `Device`, pick your controller. + - In `Game Light`, select the corresponding button that will be used for that light. + - Repeat for your other lights. + +#### Configuring Bemanitools for a network + +!!! tip "Head over to the `Network` tab." !!! tip "" Now we will set up our PIN pad and card. - Click on `Keyboard device`, you may or may not have more than one option. This is normal. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad. + + - Click on `Keyboard device` + - You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad. + - Once you have found your correct device, the `Keyboard status` will change **(the number and location of the number does not matter, it only matters that it changed)**. + - Grab your card, create a :material-file-document-edit:`.txt` and name it however you like. In this example it's called :material-file-document-edit:`card.txt` + - Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder. !!! info "If you don't have a numpad, make sure to tick `Use top keyboard row for PIN pad input`. This will also change the `Card In` button to `Backspace`." -!!! tip "" - If you have found your correct device, the `Keyboard status` will change **(the number and location of the number does not matter, it only matters that it changed)**. It should look similiar to this: - - + + +--- +### Connecting to a network !!! tip "" - Next, grab your card, create a `.txt`, name it however you like, in this example it's called `card.txt` and place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder. It should look like this: - + - Locate your :material-file-code:`iidxhook-14.conf` + + - Open it with your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) -### Configuring the game for an Online Network + - Replace the `eamuse.server=localhost:80` with your desired network URL -!!!tip "" - Locate your `iidxhook-14.conf` and edit it in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)). It may seem overwhelming at first but it's actually fairly simple. All we really care about are these lines: + - Replace `eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX` **and** `eamuse.eamid=XXXXXXXXXXXXXXXXXXXX` with your PCBID of your network of choice. ``` # URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80. @@ -100,36 +156,29 @@ # EAMID eamuse.eamid=XXXXXXXXXXXXXXXXXXXX ``` - - Replace the `eamuse.server=localhost:80` with your desired network URL - - Replace `eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX` **and** `eamuse.eamid=XXXXXXXXXXXXXXXXXXXX` with your PCBID of your network of choice. -### Setting up the game's resolution, locking FPS and fixing stretched videos +--- +### Game resolution and locking FPS !!! tip "" - Before we begin, we'd like to mention that you have two options when it comes to how the game renders. You can choose between `Linear` and `Point`. + We'd like to mention that there are two options when it comes to how the game renders. You can choose between `Linear` and `Point`. Below is an example of how both look like. -??? info "Linear" - + ??? info "Linear" + -??? info "Point" - - -!!! tip "" + ??? info "Point" + + It comes down to your own prefrence what you decide on, `Linear` is less sharp but doesn't have pixel perfect edges. `Point` is sharp and is pixel perfect. !!! tip "" - Next up, we'll setup borderless window, configure the proper resolution and fix stretched background videos. We're using a `1920x1080` monitor so we will use that. + Next up, we'll setup borderless window and configure the proper resolution. We're using a `1920x1080` monitor so we will use that. - Repeat the previous step and open your `iidxhook-14.conf`. We want to find these lines: + Repeat the previous step and open your :material-file-code:`iidxhook-14.conf`. We want to find these lines: ``` - # Fix stretched BG videos on newer GPUs. Might appear on Red and newer - gfx.bgvideo_uv_fix=false - # Software limit the frame rate of the rendering loop in hz, e.g. 60 or 59.95 (0.0 = no software limit) gfx.frame_rate_limit=0.0 @@ -152,15 +201,12 @@ gfx.scale_back_buffer_filter=none ``` - If you can't seem to find them, simply press `CTRL` + `F` and search for each argument. It will highlight them for you. - - + If you can't seem to find them, press `CTRL` + `F` and search for `gfx.frame_rate_limit=0.0`. This will bring you to the first line we want to edit. !!! tip "" Listed below are the values we want to change them to. ``` - gfx.bgvideo_uv_fix=true gfx.frame_rate_limit=59.95 gfx.windowed=true gfx.window_width=1920 @@ -169,89 +215,101 @@ gfx.scale_back_buffer_height=1080 gfx.scale_back_buffer_filter=linear ``` - Unless you'd like to have the game properly windowed you can safely ignore `gfx.framed=false`. Under normal circumstances there shouldn't be a need for you to fiddle with `gfx.monitor_check=1.000000` so we are also going to ignore it. + Unless you'd like to have the game properly windowed you can safely ignore `gfx.framed=false`. - Make sure to adjust for if you want either `Linear` or `Point` rendering. + Make sure to decide on whether you want `Linear` or `Point` rendering. ``` gfx.scale_back_buffer_filter=linear gfx.scale_back_buffer_filter=point ``` - - When you're done, it should look like this: - - -### Final Steps and Setting up the Game +--- +### First launch + +!!! danger "If you have any issues running the game, refer to the [Troubleshooting](troubleshooting.md) page." + +#### BACKUP DATA !!! tip "" - We can now focus on starting the game and getting it running. Open `gamestart.bat` (if you kept the name as is) - You might come across an error that says: + If you've followed all instructions correctly, you're now finally ready to launch the game! - `USB I/O ERROR ERROR(FM TRNS-OUT)` or `USB I/O ERROR ERROR(FM-DL TIMEOUT)` simply reboot the game and it should work regardless. - - You will be greeted by the initialization screen and shortly after this screen: + **First plug your controller if you have one** and run :material-file:`gamestart.bat`. - + If it's your first time running the game, you'll immediately be greeted with this screen. - + + +!!! warning "If you get `USB I/O ERROR ERROR(FM TRNS-OUT)` or `USB I/O ERROR ERROR(FM-DL TIMEOUT)`" + Reboot the game and it should get fixed. + + !!! tip "" - Hit your `Test` button to confirm to get to this screen: + Press your `Test` key to confirm to get to the next error message. - +#### CLOCK ERROR + + !!! tip "" - Hit your `Test` button again to confirm. The game will then perform a `MONITOR CHECK`. + Press your `Test` key to confirm. The game will then perform a `MONITOR CHECK`. - + + + !!! tip "" - Once the `MONITOR CHECK` is done, the game puts us into the games settings menu. From there, navigate to `CLOCK SETUP`. You can leave the date, no need to manually change it. Simply navigate to `SAVE AND EXIT`. + After the monitor check, the game will bring you into it's service menu. + + Instructions on how to navigate the menu are shown at the bottom of the screen. + + - Press `1` and `2` to go up and down. + - Press `6` to select/execute. - + Navigate to `CLOCK`. You do not need to manually change it. Navigate to `SAVE AND EXIT`. - + -!!! info "If you'd like to play offline, you can head straight to [Final Notes](setup.md#final-notes)" - -### Setting Shop Name and Prefecture for Online Play +#### Enabling e-AMUSEMENT for Online Play !!! tip "" - From the games settings menu, naviate to `e-AMUSEMENT OPTIONS` and select it. This will bring you to `e-AMUSEMENT SETTINGS`. Select it aswell. + From the service menu, go to `NETWORK OPTIONS` then `e-AMUSEMENT SETTINGS`. - + - + + + !!! tip "" - It'll bring you to this next screen, if `e-AMUSEMENT` is `OFF`, select it so that `e-AMUSEMENT` switches to `ON` and it will look like this: - - + We will need to set a `SHOP NAME SETTING` and change our `SETTING AREA` otherwise the game will throw errors at us. + + !!! tip "" - We now have to change our `SHOP NAME SETTING` and `PREFECTURE` otherwise the game will throw errors at us. + + - Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen. + - Navigate to `EXIT` and select it. + - Change your `SETTING AREA` once or how many times you'd like, it doesn't matter as long as it's not the default one. - Start with the shop name, select it and change them to what ever you like. When you're done editing your shop name, navigate to `EXIT` and select it. - - + !!! tip "" - For the prefecture change it once or how many times you'd like, it doesn't matter as long as it's not the default one. + Select `SAVE AND EXIT`. - + !!! tip "" - Once that is done, hit `SAVE AND EXIT`. The game will say `NOW SAVING`. + Navigate to `GAMEMODE` to start the game. - When it's done saving, you can exit out of the `NETWORK OPTIONS`. - - - + + +--- ### Final Notes -!!! success "You're all done! From the service menu select `GAMEMODE` and the game should load ready to be played! Make sure to insert two credits by pressing your `SERVICE` key! Have fun!" +!!! success "You're all done! From the service menu select `GAMEMODE` and the game should load ready to be played. Make sure to insert two credits by pressing your `SERVICE` key. Have fun!" !!! warning "Have any other errors?" - Check out the [Common Problems/Tips](problems.md) section to resolve any issues not seen in this guide to greater depth. + Check out the [Troubleshooting](troubleshooting.md) section. diff --git a/docs/games/iidx14/problems.md b/docs/games/iidx14/troubleshooting.md similarity index 63% rename from docs/games/iidx14/problems.md rename to docs/games/iidx14/troubleshooting.md index 30d955c..bc4c2d8 100644 --- a/docs/games/iidx14/problems.md +++ b/docs/games/iidx14/troubleshooting.md @@ -5,7 +5,7 @@ ### My Game Is Running Crazy Fast! !!! tip "" - The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check [this section](setup.md#setting-up-the-games-resolution-locking-fps-and-fixing-stretched-videos) of the guide again. + The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check [this section](setup.md#game-resolution-and-locking-fps) of the guide again. ### I'm getting "NETWORK WARNING" instead of "NETWORK OK" @@ -23,18 +23,20 @@ You need to install a codec. - Inside the [Bemanitools Supplement](https://github.com/djhackersdev/bemanitools-supplement/releases/download/1.6/bemanitools-supplement-1.6.zip) archive, navigate to `\iidx.zip\iidx\misc\` where you'll find `CLVSD.ax`. + - Open :material-zip-box:`bemanitools-supplement-v1.6.zip` and navigate to :material-folder:`\iidx.zip\iidx\misc\` where :material-file:`CLVSD.ax` is located. - Extract `CLVSD.ax` inside a folder that you know won't be moved or renamed. + - Extract :material-file:`CLVSD.ax` inside a :material-folder: folder that you know won't be moved or renamed. - Open up the command prompt as ***administrator***. Now type `regsvr32 "\CLVSD.ax"` into the command prompt. + - Open the :material-console:command prompt as ***administrator***. Now type `regsvr32 "\CLVSD.ax"` into the command prompt. - As an example, it could look like this: `regsvr32 "D:\BEMANI\IIDX\CLVSD.ax"` A prompt should appear telling you that it has been installed successfully. - This applies for all styles that require this codec. + As an example, it could look like this: `regsvr32 "D:\BEMANI\IIDX\CLVSD.ax"` + + A prompt should appear telling you that it has been installed successfully. + This applies for all styles that require this codec, not just **GOLD**. If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file. - You ***can not*** move or delete `CLVSD.ax` ***at all***, otherwise it will revert the changes and you have to install it again. +!!! danger "You **can not** move or delete :material-file:`CLVSD.ax` **at all**, otherwise it will revert the changes and you have to install it again." ### My game crashes immediately! diff --git a/docs/img/iidx14/2.png b/docs/img/iidx14/2.png deleted file mode 100644 index d6c6cec..0000000 Binary files a/docs/img/iidx14/2.png and /dev/null differ diff --git a/docs/img/iidx14/3.png b/docs/img/iidx14/3.png deleted file mode 100644 index f9072b1..0000000 Binary files a/docs/img/iidx14/3.png and /dev/null differ diff --git a/docs/img/iidx14/4.png b/docs/img/iidx14/4.png deleted file mode 100644 index 79f9186..0000000 Binary files a/docs/img/iidx14/4.png and /dev/null differ diff --git a/docs/img/iidx14/bt1.png b/docs/img/iidx14/bt1.png deleted file mode 100644 index 412396f..0000000 Binary files a/docs/img/iidx14/bt1.png and /dev/null differ diff --git a/docs/img/iidx14/bt2.png b/docs/img/iidx14/bt2.png deleted file mode 100644 index 866878b..0000000 Binary files a/docs/img/iidx14/bt2.png and /dev/null differ diff --git a/docs/img/iidx14/5.png b/docs/img/iidx14/firstlaunch/1.png similarity index 100% rename from docs/img/iidx14/5.png rename to docs/img/iidx14/firstlaunch/1.png diff --git a/docs/img/iidx14/13.png b/docs/img/iidx14/firstlaunch/10.png similarity index 100% rename from docs/img/iidx14/13.png rename to docs/img/iidx14/firstlaunch/10.png diff --git a/docs/img/iidx14/14.png b/docs/img/iidx14/firstlaunch/11.png similarity index 100% rename from docs/img/iidx14/14.png rename to docs/img/iidx14/firstlaunch/11.png diff --git a/docs/img/iidx14/15.png b/docs/img/iidx14/firstlaunch/12.png similarity index 100% rename from docs/img/iidx14/15.png rename to docs/img/iidx14/firstlaunch/12.png diff --git a/docs/img/iidx14/firstlaunch/13.png b/docs/img/iidx14/firstlaunch/13.png new file mode 100644 index 0000000..b373dc9 Binary files /dev/null and b/docs/img/iidx14/firstlaunch/13.png differ diff --git a/docs/img/iidx14/6.png b/docs/img/iidx14/firstlaunch/2.png similarity index 100% rename from docs/img/iidx14/6.png rename to docs/img/iidx14/firstlaunch/2.png diff --git a/docs/img/iidx14/7.png b/docs/img/iidx14/firstlaunch/3.png similarity index 100% rename from docs/img/iidx14/7.png rename to docs/img/iidx14/firstlaunch/3.png diff --git a/docs/img/iidx14/monitor_check.png b/docs/img/iidx14/firstlaunch/4.png similarity index 100% rename from docs/img/iidx14/monitor_check.png rename to docs/img/iidx14/firstlaunch/4.png diff --git a/docs/img/iidx14/8.png b/docs/img/iidx14/firstlaunch/5.png similarity index 100% rename from docs/img/iidx14/8.png rename to docs/img/iidx14/firstlaunch/5.png diff --git a/docs/img/iidx14/9.png b/docs/img/iidx14/firstlaunch/6.png similarity index 100% rename from docs/img/iidx14/9.png rename to docs/img/iidx14/firstlaunch/6.png diff --git a/docs/img/iidx14/10.png b/docs/img/iidx14/firstlaunch/7.png similarity index 100% rename from docs/img/iidx14/10.png rename to docs/img/iidx14/firstlaunch/7.png diff --git a/docs/img/iidx14/11.png b/docs/img/iidx14/firstlaunch/8.png similarity index 100% rename from docs/img/iidx14/11.png rename to docs/img/iidx14/firstlaunch/8.png diff --git a/docs/img/iidx14/12.png b/docs/img/iidx14/firstlaunch/9.png similarity index 100% rename from docs/img/iidx14/12.png rename to docs/img/iidx14/firstlaunch/9.png diff --git a/docs/img/iidx14/1.png b/docs/img/iidx14/setup/1.png similarity index 100% rename from docs/img/iidx14/1.png rename to docs/img/iidx14/setup/1.png diff --git a/docs/img/iidx14/setup/2.png b/docs/img/iidx14/setup/2.png new file mode 100644 index 0000000..95abe25 Binary files /dev/null and b/docs/img/iidx14/setup/2.png differ diff --git a/mkdocs.yml b/mkdocs.yml index ea1637a..0fe9f45 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -27,7 +27,7 @@ nav: - "Troubleshooting": "games/iidx13/troubleshooting.md" - "IIDX 14 GOLD": - "First Time Setup": "games/iidx14/setup.md" - - "Common Problems/Tips": "games/iidx14/problems.md" + - "Troubleshooting": "games/iidx14/troubleshooting.md" - "IIDX 24 SINOBUZ": - "First Time Setup": "games/iidx24/setup.md" - "Common Problems/Tips": "games/iidx24/problems.md"