1
0
mirror of https://github.com/yxrei/bemani-guide.git synced 2024-12-13 23:41:08 +01:00
bemani-guide/docs/games/iidx10/setup.md

306 lines
11 KiB
Markdown
Raw Normal View History

# beatmania IIDX 10th style
<img src="/img/iidx10/10_logo.png">
2024-10-28 03:29:38 +01:00
!!! danger "Please make sure you downloaded your data from an appropriate source.<br>This guide is unable to troubleshoot any problems related to bad or poorly managed data."
2024-10-28 03:29:38 +01:00
---
### Preparing data
!!! tip ""
2024-10-28 03:29:38 +01:00
After downloading and extracting your data, we need to make sure your files aren't set to `Read-only`.
2024-10-28 03:29:38 +01:00
- 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 ""
2024-10-28 03:29:38 +01:00
- 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-09-to-12.zip`.
2024-10-28 03:29:38 +01:00
- Extract everything inside the folder that contains the :material-file:`bm2dx.exe` which is located in :material-folder:`\D01\JAE`.
Pictured below is what your folder should look like. We've removed any files not necessary for **10th style**.
2024-10-28 03:29:38 +01:00
<img src="/img/iidx10/setup/1.png">
2024-10-28 03:29:38 +01:00
#### Making use of iidxhook-10.conf & RtEffect.dll
!!! tip ""
2024-10-28 03:29:38 +01:00
- Download the :material-package-down:[Bemanitools supplements](https://github.com/djhackersdev/bemanitools-supplement/releases/download/1.6/bemanitools-supplement-1.6.zip)
2024-10-28 03:29:38 +01:00
- Open :material-zip-box:`bemanitools-supplement-v1.6.zip` and navigate inside :material-zip-box:`misc.zip`
2024-10-28 03:29:38 +01:00
- Inside :material-folder:`misc\d3d8to9`, extract :material-file-cog-outline:`d3d8.dll` to :material-folder:`\D01\JAE`.
2024-10-28 03:29:38 +01:00
This enables us to use the graphic options inside :material-file-code:`iidxhook-10.conf` which we will take advantage of.
2024-10-28 03:29:38 +01:00
- Open :material-zip-box:`bemanitools-supplement-v1.6.zip` and navigate inside :material-zip-box:`iidx.zip`
2024-10-28 03:29:38 +01:00
- Inside :material-folder:`iidx/misc`, extract :material-file-cog-outline:`RtEffect_stub.dll` to :material-folder:`\D01\JAE`.
- 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.
2024-10-28 03:29:38 +01:00
#### Replacing bm2dx.exe
!!! tip ""
2024-10-28 03:29:38 +01:00
- Go to :material-folder:`D01\util` and copy :material-clipboard-file:`bm2dx_D01_JAE_no_checksum.exe` to `D01\JAE`
2024-10-28 03:29:38 +01:00
- Delete the original :material-file-remove:`bm2dx.exe`
- Rename :material-file-edit:`bm2dx_D01_JAE_no_checksum.exe` to :material-file:`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.
2024-10-28 03:29:38 +01:00
---
### Configuring Bemanitools
!!! info "To configure your keybinds, open your :material-file:`config.bat` file."
#### Buttons
!!! tip ""
2024-10-28 03:29:38 +01:00
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 ""
2024-10-28 03:29:38 +01:00
With a controller rather than binding buttons to `TT+` and `TT-`, you need to:
- 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.
2024-10-28 03:29:38 +01:00
#### Lights (controller/cab only)
!!! tip ""
2024-10-28 03:29:38 +01:00
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.
!!! info "If you'd like to play offline, you can head straight to [Game resolution and locking FPS](#game-resolution-and-locking-fps)"
#### Configuring Bemanitools for a network
!!! tip "Head over to the `Network` tab."
!!! tip ""
Now we will set up our PIN pad and card.
2024-10-28 03:29:38 +01:00
- 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`."
2024-10-28 03:29:38 +01:00
<img src="/img/iidx10/setup/2.png">
---
### Connecting to a network
!!! tip ""
2024-10-28 03:29:38 +01:00
- Locate your :material-file-code:`iidxhook-10.conf`
- Open it with your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/))
2024-10-28 03:29:38 +01:00
- Replace the `eamuse.server=localhost:80` with your desired network URL
2024-10-28 03:29:38 +01:00
- 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.
eamuse.server=localhost:80
# PCBID
eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX
# EAMID
eamuse.eamid=XXXXXXXXXXXXXXXXXXXX
```
2024-10-28 03:29:38 +01:00
---
### Game resolution and locking FPS
!!! tip ""
2024-10-28 03:29:38 +01:00
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.
2024-10-28 03:29:38 +01:00
??? info "Linear"
<img src="/img/iidx9/9th_linear.png">
2024-10-28 03:29:38 +01:00
??? info "Point"
<img src="/img/iidx9/9th_point.png">
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 and configure the proper resolution. We're using a `1920x1080` monitor so we will use that.
2024-10-28 03:29:38 +01:00
Repeat the previous step and open your :material-file-code:`iidxhook-10.conf`. We want to find these lines:
```
# 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
# 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
```
2024-10-28 03:29:38 +01:00
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.frame_rate_limit=59.95
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
```
2024-10-28 03:29:38 +01:00
Unless you'd like to have the game properly windowed you can safely ignore `gfx.framed=false`.
2024-10-28 03:29:38 +01:00
Make sure to decide on whether you want `Linear` or `Point` rendering.
```
gfx.scale_back_buffer_filter=linear
gfx.scale_back_buffer_filter=point
```
2024-10-28 03:29:38 +01:00
---
### First launch
!!! danger "If you have any issues running the game, refer to the [Troubleshooting](troubleshooting.md) page."
2024-10-28 03:29:38 +01:00
#### BACKUP DATA
!!! tip ""
2024-10-28 03:29:38 +01:00
If you've followed all instructions correctly, you're now finally ready to launch the game!
2024-10-28 03:29:38 +01:00
**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.
<img src="/img/iidx10/firstlaunch/1.png">
<img src="/img/iidx10/firstlaunch/2.png">
!!! tip ""
2024-10-28 03:29:38 +01:00
Press your `Start` key to confirm to get to the next error message.
2024-10-28 03:29:38 +01:00
#### CLOCK ERROR
<img src="/img/iidx10/firstlaunch/3.png">
!!! tip ""
Press your `Start` key to confirm. This will bring you into it's service menu.
<img src="/img/iidx10/firstlaunch/4.png">
!!! tip ""
2024-10-28 03:29:38 +01:00
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.
2024-10-28 03:29:38 +01:00
Navigate to `CLOCK`. You do not need to manually change it. Navigate to `SAVE AND EXIT`.
2024-10-28 03:29:38 +01:00
<img src="/img/iidx10/firstlaunch/5.png">
!!! info "If you'd like to play offline, you can head straight to [Final Notes](setup.md#final-notes)"
2024-10-28 03:29:38 +01:00
#### Enabling e-AMUSEMENT for Online Play
!!! tip ""
2024-10-28 03:29:38 +01:00
From the service menu, go to `e-AMUSEMENT OPTIONS` then `e-AMUSEMENT SETTINGS`.
2024-10-28 03:29:38 +01:00
<img src="/img/iidx10/firstlaunch/6.png">
2024-10-28 03:29:38 +01:00
<img src="/img/iidx10/firstlaunch/7.png">
!!! tip ""
2024-10-28 03:29:38 +01:00
It'll bring you to this screen, change it so that `e-AMUSEMENT` switches to `ON` and it will look like this:
2024-10-28 03:29:38 +01:00
<img src="/img/iidx10/firstlaunch/8.png">
2024-10-28 03:29:38 +01:00
<img src="/img/iidx10/firstlaunch/9.png">
!!! tip ""
2024-10-28 03:29:38 +01:00
We will need to set a `SHOP NAME SETTING` and change our `PREFECTURE` otherwise the game will throw errors at us.
2024-10-28 03:29:38 +01:00
<img src="/img/iidx10/firstlaunch/10.png">
!!! tip ""
2024-10-28 03:29:38 +01:00
- 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 prefecture once or how many times you'd like, it doesn't matter as long as it's not the default one.
2024-10-28 03:29:38 +01:00
<img src="/img/iidx10/firstlaunch/11.png">
!!! tip ""
2024-10-28 03:29:38 +01:00
Select `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.`
2024-10-28 03:29:38 +01:00
So, close the game and open it again.
2024-10-28 03:29:38 +01:00
<img src="/img/iidx10/firstlaunch/12.png">
---
### Final Notes
2024-10-28 03:29:38 +01:00
!!! 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?"
2024-10-28 03:29:38 +01:00
Check out the [Troubleshooting](troubleshooting.md) section.