# Game Setup - two-torial.xyz
Arcade Games Troubleshooting Guide
Author: two-torial Team

Skip to content

# Game Setup

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover.
TWO-TORIAL does not provide or distribute game data. Do not ask.

## Preparing data

Ensure your game files are not marked as read-only:

- Right click the directory containing your files
- Click on `Properties`
- Under the `General` tab, find `Attributes` and uncheck `Read-only`
- Click `Apply`
- When prompted, select `Apply changes to this folder, subfolders and files`
- Click `OK` to confirm, then `OK` again to close Properties

The complete game data should be approximately 26 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:

    📂yyyymmddrr (revision directory, y = year digit, m = month digit, d = day digit, r = revision digit)
    📂data
    📄sidcode.txt

## Installing Bemanitools

- Download the latest Bemanitools release here

- Inside `bemanitools-x.xx.zip` locate `iidx-14-to-17.zip`

- Extract all files from `iidx-14-to-17.zip` to your revision directory (yyyymmddrr)

You may delete the `gamestart-[14,15,17].bat` and `iidxhook-[14,15,17].conf` files as you only need the ones for 16 (Empress)

- Download the latest Bemanitools supplements release here

- Inside `bemanitools-supplement-vx.x.zip` locate `misc.zip`

- Inside `misc\d3d8to9\`, extract `d3d8.dll` to your revision directory

This lets you configure graphics options inside `iidxhook-xx.conf` (xx being your game version number)

For background movies to work, you need to install and register a codec.

This also applies for IIDX 12 to 18, if you'd done it before you shouldn't need to again and may skip this step.

- Inside `bemanitools-supplement-vx.x.zip` locate and open `iidx.zip`

- Inside `iidx\misc\`, extract `CLVSD.ax` to any directory where the file can stay long term
  As an example we will be using your Documents folder, but it really could be anywhere you prefer.

- Open a command prompt as administrator, and run `regsvr32 "CHOSEN_PATH\CLVSD.ax"`
  For the Documents folder, the command would be `regsvr32 "C:\Users\YOUR_USERNAME\Documents\CLVSD.ax"`

You should get confirmation that the file has been registered successfully.

If an error occurs, you most likely didn't start your command prompt as administrator, or the location to CLVSD.ax was incorrect.

In the end, here's what the expected data structure should look like:

    📄bm2dx.exe
    📄config.bat
    📄config.exe
    📄d3d8.dll
    📄d3dx9_24.dll
    📄dbghelp.dll
    📄eamio.dll
    📄gamestart-16.bat
    📄gcidata.nsd
    📄geninput.dll
    📄iidxhook3.dll
    📄iidxhook-16.conf
    📄iidxio.dll
    📄inject.exe
    📄libacio.dll
    📄libavs-win32.dll
    📄libavs-win32-ea3.dll
    📄vefx.txt
    📄vefxio.dll

## Configuring Bemanitools

Open the `config.bat` file. The following tabs correspond to the ones in the configuration window.

ButtonsLightsAnalogsNetwork

This tab is used to bind your keyboard and controller buttons

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.

Additional info

- Use page navigation at the bottom to bind multiple buttons to the same input
- Check Bind Many to bind multiple controls in sequence
- Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

- In `Device`, pick your controller
- In `Game Light`, select the corresponding button that will be used for that light
- Repeat for your other lights

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

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

This tab lets you configure which cards are used to save your game profile to

If you haven't generated a card number before, you can grab one from here

Now we will set up our PIN pad and card.

- Click on `Keyboard device` for whichever player's card reader you want to use
- 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 `Keypad status` will change (the number and location of the number does not matter, it only matters that it changed)
- Create a `.txt` file in a location that is easily accessible, and name it however you like
- Inside the file, paste in your card number. Example: `E0045812F8AFB2DE`
- Point to the file you created by clicking `Browse...` and selecting it

If you don't have a numpad, tick `Use top keyboard row for PIN pad input`. This will also change the `Card In` button to `Backspace`

## Connecting to a network

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join.
You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

- Open `iidxhook-xx.conf` (xx being your game version) with a text editor

- In the line `eamuse.server=localhost:80`, replace `localhost:80` with your provided network url

- In the lines `eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX` and `eamuse.eamid=XXXXXXXXXXXXXXXXXXXX`, replace the part after `=` with your provided PCBID

- Example:

      # 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=http://be.ma.ni/

      # PCBID
      eamuse.pcbid=ABMYPRECIOUSPCBIDCDE

      # EAMID
      eamuse.eamid=ABMYPRECIOUSPCBIDCDE

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

- Open `iidxhook-xx.conf` (xx being your game version) with a text editor

- In the line `eamuse.server=localhost:80`, replace `localhost:80` to point to your asphyxia server, typically `localhost:8083`

- Example:

      # 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:8083

## Configuring graphics

- Open your `iidxhook-xx.conf` (xx being your game version)

- Locate and change the options we're interested in:

    gfx.framed=false                    # Only matters if windowed. False for borderless, True for decorations (title bar, etc..)
    gfx.frame_rate_limit=0.0            # Set this to 59.95
    gfx.windowed=false                  # False for fullscreen, True for windowed
    gfx.window_width=0                  # Set to your desired game width (recommended: monitor width)
    gfx.window_height=0                 # Set to your desired game height (recommended: monitor height)
    gfx.scale_back_buffer_width=0       # Set to your desired game width (recommended: monitor width)
    gfx.scale_back_buffer_height=0      # Set to your desired game height (recommended: monitor height)
    gfx.scale_back_buffer_filter=none   # Set to point or linear (pick one from examples below)

Here are visual examples of the two filter options:

point (sharp, pixel perfect)

linear (less sharp, not pixel perfect)

## Before playing

A few things to remember before each play session

- Close of any applications running in the background which could affect performance
- Double-check your monitor is oriented properly for this game
- Double-check your sample rate is correct for this game
- Connect your controller

## First launch

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 `gamestart.bat` as Administrator.

If it's your first time running the game, you'll soon be greeted with this screen.

Press your `Test` key to initialize the backup data, a message will pop up stating it's been initialized.

If right here you get `USB I/O ERROR ERROR(FM TRNS-OUT)` or `USB I/O ERROR ERROR(FM-DL TIMEOUT)` instead of the `BACKUP DATA ERROR`, reboot the game and it should get fixed.

Next, you'll get another error.

Press your `Test` key again and let the game run for a bit until the monitor check is complete.

You will now be taken to the 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

Start by going up to `CLOCK`.

Here, simply select `SAVE AND EXIT` and the clock will be set.

You'll be back in the service menu.

Go to `NETWORK OPTIONS` then `e-AMUSEMENT SETTINGS`.

You will need to set a shop name.

- Name your shop to whatever you'd like. Again, navigation instructions are at the bottom of the screen
- Go to `EXIT` then `SAVE AND EXIT`

Select `GAME OPTIONS`.

Here, you want to select a display type.

This setting affects timing offset in the song.

- `TYPE A`: No frame offset - Intended for CRT displays
- `TYPE B`: +1 frame offset - Intended for LCD displays

We recommend starting with `TYPE B` and changing this later if you encounter any issues.

- Go to `SAVE AND EXIT` then `GAME MODE`

You're all done! The game should load up properly now. Insert credits by pressing your `SERVICE` key!

## Help

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support!
Click on the Discord logo at the bottom right of the page.

October 23, 2025