Add IIDX10 setup & faq / Clean up IIDX9

docs/changelog.md

@@ -4,6 +4,8 @@
 
 !!! tip "September 17th, 2023"
 
+	- Add IIDX 10 setup & faq
+	
 	- Clean up IIDX 9 setup & faq (mainly the codec installation)
 
 	- Removed [Btools] notice on the navigation bar

docs/games/iidx10/problems.md

@@ -0,0 +1,52 @@
+# IIDX 10 Common Problems/Tips
+
+<img src="/img/iidx10/10_logo.png">
+
+### 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](/games/iidx10/setup/#final-steps-and-setting-up-the-game) of the guide again.
+
+### I'm getting "NETWORK WARNING" instead of "NETWORK OK"
+
+!!! tip ""
+	This can be caused by:
+
+	- Invalid PCBID
+	- Firewall blocking connections
+	- Invalid eamuse url or port specified
+	- Game is not run using the Administrator account 
+
+### My game crashes immediately!
+
+!!! warning "This can have multiple reasons. These fixes shouldn't be needed for 10th style to run properly, but will be mandatory for other styles. We'll add them to 10th style anyway just in case."
+
+#### Fix #1 (Wrong data structure)
+
+!!! tip ""
+	Make sure that your unpacked data looks like this:
+
+	- JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
+	- data
+	- sidcode.txt
+	
+	Any other files are optional and don't have to be removed as these are not required to run the game.
+
+#### Fix #2 (Missing codec)
+
+!!! tip ""
+
+	You need to install a codec that is missing. 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`.
+
+	Extract `CLVSD.ax` inside the folder that contains the bm2dx.exe which should be located in `\D01\JAE`
+
+	Open up the command prompt as ***administrator***. Now type `regsvr32 "<location of your game>\CLVSD.ax"` into the command prompt.
+
+	As an example, it could look like this: `regsvr32 "D:\BEMANI\IIDX\10TH-STYLE\D01\JAE\CLVSD.ax"` A prompt should appear telling you that it has been installed successfully. 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.
+
+#### Fix #3 (RtEffects.dll didn't get replaced)
+
+!!! tip ""
+	Refer to [Getting Started](/games/iidx10/setup/#getting-started) again and check if you have followed all the instructions explained in it.

docs/games/iidx10/setup.md

@@ -0,0 +1,234 @@
+# beatmania IIDX 10th style
+
+<img src="/img/iidx10/10_logo.png">
+
+!!! tip "This guide wouldn't exist without the help of sync (Discord: `sync_plus`)."
+
+!!! 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 "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.
+	
+	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/yxrei/bemani-guide/issues)
+
+
+### 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, locate `iidx-09-to-12.zip` inside the `bemanitools-5.44.zip`. Extract it inside the folder that contains the `bm2dx.exe` which should be located in `\D01\JAE`. Pictured below is what your folder should look like, we've removed any files not necessary for **10th style**. Feel free to name your `gamestart.bat` file whatever you desire, for the sake of convenience we've kept it as it.
+
+<img src="/img/iidx10/bt1.png">
+
+<img src="/img/iidx10/bt2.png">
+
+<img src="/img/iidx10/1.png">
+
+!!! 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-10.conf` which we will take advantage of. It should look like this:
+
+<img src="/img/iidx10/btsup1.png">
+
+<img src="/img/iidx10/2.png">
+
+!!! tip ""
+
+	Now, open up `bemanitools-supplement-v1.6.zip` again and navigate into `iidx.zip`. Next, navigate into `iidx/misc` and extract `RtEffect_stub.dll` into the same folder as we previously have done. 
+	
+	Delete the already existing `RtEffect.dll` and rename `RtEffect_stub.dll` to `RtEffect.dll`. This will eliminate any immediate crashes relating to needing specific old hardware.
+
+<img src="/img/iidx10/btsup2.png">
+
+<img src="/img/iidx10/3.png">
+
+<img src="/img/iidx10/4.png">
+
+!!! tip ""
+
+	Lastly, check if your data has a folder called `util`. If it does, grab the `bm2dx_D01_JAE_no_checksum.exe` from it and place it into the `/JAE` folder (where we placed all the previous files into aswell).
+
+	Delete the original `bm2dx.exe` that is inside the folder and rename `bm2dx_D01_JAE_no_checksum.exe` to `bm2dx.exe`.
+
+	If you don't do this, you will end up getting a `HDD DATA ERROR (PROG CHKSUM)` which will result in the game not being able to run.
+
+### Configuring Your Tools
+
+!!! tip ""
+	To configure your keybinds, open up your `config.bat` file. You'll be greeted by this screen:
+
+<img src="/img/iidx10/5.png">
+
+!!! 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:
+	
+<img src="/img/iidx10/6.png">
+
+!!! info "If you'd like to play offline, you can head straight to [Final Steps and Setting up the Game](setup.md#final-steps-and-setting-up-the-game)"
+
+### Configuring Bemanitools for an Online Network
+
+!!! tip ""
+	After setting the keybinds and analogs, we can head over to the `Network` tab, which will look like this:
+
+<img src="/img/iidx10/7.png">
+
+!!! 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.
+	
+!!! 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:
+	
+<img src="/img/iidx10/8.png">
+
+!!! 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:
+	
+<img src="/img/iidx10/9.png">
+
+### Configuring the game for an Online Network
+
+!!!tip ""
+	Locate your `iidxhook-10.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:
+	
+	```
+	# 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.
+	eamuse.server=localhost:80
+
+	# PCBID
+	eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX
+
+	# 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.
+
+### Final Steps and Setting up the Game
+
+!!! tip ""
+	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-10.conf`. We want to find these lines:
+	
+	```
+	# Run the game windowed
+	gfx.windowed=false
+
+	# Windowed width, 0 for default size
+	gfx.window_width=0
+
+	# Windowed height, 0 for default size
+	gfx.window_height=0
+
+	# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.
+	gfx.scale_back_buffer_width=0
+
+	# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.
+	gfx.scale_back_buffer_height=0
+
+	# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).
+	gfx.scale_back_buffer_filter=none
+	```
+	
+	If you can't seem to find them, simply press `CTRL` + `F` and search for `gfx.windowed=false`. This will bring you to the first line we want to edit.
+	
+<img src="/img/iidx10/10.png">
+	
+!!! tip ""
+	Listed below are the values we want to change them to.
+	
+	```
+	gfx.windowed=true
+	gfx.window_width=1920
+	gfx.window_height=1080
+	gfx.scale_back_buffer_width=1920
+	gfx.scale_back_buffer_height=1080
+	gfx.scale_back_buffer_filter=linear
+	```
+	
+	When you're done, it should look like this:
+	
+<img src="/img/iidx10/11.png">
+	
+!!! tip ""
+	Before we can start the game, we need to lock the FPS of the game to `59.95`, otherwise the game will either run crazy fast or will desync. We will be using [RivaTuner Statistics Server](https://www.guru3d.com/files-get/rtss-rivatuner-statistics-server-download,17.html). Simply install it and run it.
+	
+	Now press `Add` and locate your `bm2dx.exe`. You can copy these settings listed below (click on the Framerate limit to enter the value manually):
+	
+<img src="/img/iidx10/12.png">
+
+!!! tip ""
+	We can now focus on starting the game and getting it running. Open `gamestart.bat` (if you kept the name as is)
+	
+	You will be greeted by the initialization screen and shortly after this screen:
+
+<img src="/img/iidx10/13.png">
+
+<img src="/img/iidx10/14.png">
+
+!!! tip ""
+	Hit your `Start` button to confirm to get to this screen:
+
+<img src="/img/iidx10/15.png">
+
+!!! tip ""
+	Hit your `Start` button again to confirm. This will bring you 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`.
+	
+<img src="/img/iidx10/16.png">
+
+<img src="/img/iidx10/17.png">
+
+!!! info "If you'd like to play offline, you can head straight to [Final Notes](setup.md#final-notes)"
+
+### 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.
+	
+<img src="/img/iidx10/18.png">
+
+<img src="/img/iidx10/19.png">
+
+!!! tip ""
+	It'll bring you to this next screen, select it so that `e-AMUSEMENT` switches to `ON` and it will look like this:
+	
+<img src="/img/iidx10/20.png">
+
+<img src="/img/iidx10/21.png">
+
+!!! tip ""
+	We now have to change our `SHOP NAME SETTING` and `PREFECTURE` otherwise the game will throw errors at us.
+	
+	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.
+	
+<img src="/img/iidx10/22.png">
+
+!!! 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.
+	
+<img src="/img/iidx10/23.png">
+
+!!! tip ""
+	Once that is done, hit `SAVE AND EXIT`. The game will now give you a message, which translated means: 
+	
+	`e-AMUSEMENT settings have been changed. Please turn the power off and on again.`
+	
+	So, close the game and open it up again.
+	
+<img src="/img/iidx10/24.png">
+	
+### 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!"
+
+!!! 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.

docs/games/iidx9/problems.md

@@ -7,13 +7,35 @@
 !!! 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](/games/iidx9/setup/#final-steps-and-setting-up-the-game) of the guide again.
 
-### My game crashes immediately!
-
-!!! warning "This can have multiple reasons. We will provide two possible fixes."
-### Fix #1 (Missing codec)
+### I'm getting "NETWORK WARNING" instead of "NETWORK OK"
 
 !!! tip ""
+	This can be caused by:
+
+	- Invalid PCBID
+	- Firewall blocking connections
+	- Invalid eamuse url or port specified
+	- Game is not run using the Administrator account 
+
+### My game crashes immediately!
+
+!!! warning "This can have multiple reasons. These fixes shouldn't be needed for 9th style to run properly, but will be mandatory for other styles. We'll add them to 9th style anyway just in case."
+
+#### Fix #1 (Wrong data structure)
+
+!!! tip ""
+	Make sure that your unpacked data looks like this:
+
+	- JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
+	- data
+	- sidcode.txt
 	
+	Any other files are optional and don't have to be removed as these are not required to run the game.
+
+#### Fix #2 (Missing codec)
+
+!!! tip ""
+
 	You need to install a codec that is missing. 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`.
 
 	Extract `CLVSD.ax` inside the folder that contains the bm2dx.exe which should be located in `\C02\D\C02\JAG`
@@ -24,9 +46,10 @@
 
 	You ***can not*** move or delete `CLVSD.ax` ***at all***, otherwise it will revert the changes and you have to install it again.
 
-### Fix #2 (Missing file)
+#### Fix #3 (Missing file)
 
 !!! tip ""
+	
 	If the game still refuses to start, 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` and extract `RtEffect_stub.dll` inside the folder that contains the bm2dx.exe which should be located in `\C02\D\C02\JAG`.
 
-	Rename `RtEffect_stub.dll` to `RtEffect.dll`.
+	Rename `RtEffect_stub.dll` to `RtEffect.dll`.

docs/index.md

@@ -6,7 +6,7 @@ description: A compendium of information and guides written to ease headaches.
 
 A compendium of information and guides written to ease headaches.
 
-Last Updated: [September 15th, 2023.](changelog.md)
+Last Updated: [September 17th, 2023.](changelog.md)
 
 We now have a [Discord server!](https://discord.gg/cZRUmEPK78)
  

mkdocs.yml

@@ -12,6 +12,9 @@ nav:
             - 'IIDX 9':
                 - 'First Time Setup': 'games/iidx9/setup.md'
                 - 'Common Problems/Tips': 'games/iidx9/problems.md'
+            - 'IIDX 10':
+                - 'First Time Setup': 'games/iidx10/setup.md'
+                - 'Common Problems/Tips': 'games/iidx10/problems.md'
             - 'IIDX 24':
                 - 'First Time Setup': 'games/iidx24/setup.md'
                 - 'Common Problems/Tips': 'games/iidx24/problems.md'