IIDX Install Guide for Windows 10 & 11

beatmania_IIDX.png


Table of Contents


IIDX 31 EPOLIS (LDJ-2023101800)

IIDX 31 EPOLIS

Download link: Pixeldrain

  1. Make a backup copy of your IIDX RESIDENT folder (if you don't have it already, please follow the RESIDENT guide here.)
  2. Install the update from LDJ-2023090500-2023101800.7z onto your game folder, overwriting existing files.
  3. To install Omnimix, you have two options:
    • If you have Resident omni v14 installed, download the mini omni onto your EPOLIS folder.
    • If not, download the full omni.

To confirm whether or not you have Resident omni v14 installed, please check to see if the Marmalade Reverie song is either 000 BPM or 170 BPM in RESIDENT. If it has a proper BPM, you have v14 installed, or If not, you have v13.

Make sure to let it overwrite existing files when extracting from zip files.

  1. Make sure you have latest versions of spice2x and Asphyxia Core from here:

    Github: spice2x and Asphyxia Core

  2. Update your Asphyxia plugin to iidx-asphyxia-v1.4.4_a4
  3. In the NVIDIA control panel, select your spice64.exe in EPOLIS folder and apply recommended 3D settings here to avoid audio desync issues.
  4. Apply patches to your bm2dx.dll here.

For now, there isn't an Omnimix option that can be enabled in patcher. Apply following hex changes in bm2dx.dll here:

  • 7947B6: 7F 19 → 90 90
  • B5CEE3: 64 61 74 61 → 6F 6D 6E 69
  • AB2697: 61 → 6F
  1. You now got EPOLIS ready to be launched!

IIDX 30 RESIDENT (LDJ-2023090500)

IIDX 30 RESIDENT

To get started, you'll need to download the following files:

qBittorrent is recommended for torrents, and JDownloader for DDL.

Filenames Downloads
LDJ-2022103100 Clean Nyaa (read warning below) or Pixeldrain
Updates for LDJ-2022103100 Pixeldrain
Spice2x Github
Asphyxia Core Github
Visual C++ Pack vcredist
DirectX Runtime Microsoft

Before you download LDJ-2022103100 Clean...

If you want to torrent from Nyaa, please use a VPN (recommended ProtonVPN) to avoid getting copyright letters from your ISP.
Read here for VPN setup process in qBittorrent.

Please seed the torrent for as long as possible, because sharing is caring.

Notes about installation

See minimum required specs here. iGPU will not work for IIDX due to constant frame drops, please use a dedicated NVIDIA GPU instead.

If you aren't familiar with Omnimix, It's a music pack that restores songs removed in IIDX.

Make sure you're on latest version of Windows 10 or 11 with updated drivers.

Remember to check FAQ and Troubleshooting sections in this guide if you encounter any issues or want to learn more about the game. As a rule of thumb, you should always use a search function in Emuline before posting your issue in a support thread.

Installation

  1. First, install Visual C++ Redistributables from vcredist, and DirectX from Microsoft website.
  2. Extract the LDJ-003-2022103100 zip file. Go to Asphyxia and spice2x zip files and extract all of those files to the contents folder.
    The folder structure should look like this:
  • IIDX 30 RESIDENT
    • contents
      • api
      • data
      • dev
      • modules
      • plugins
      • prop
      • src
      • asphyxia-core-x64.exe
      • spice.exe
      • spice64.exe
      • spicecfg.exe

A spice.exe is for 32-bit, while spice64.exe is self-explanatory. It's safe to delete spice.exe and just stick with spice64.exe

It's not recommended to use non-Latin characters on a directory.

  1. To update 2022103100 to 2022120800 game version, go to the LDJ-003-2022103100-2022120800 zip file, extract the contents folder to IIDX 30 folder and overwrite existing files. After that, do the same for LDJ-20221208-20230404.7z, then LDJ-2023040400_to_2023090500.7z
  2. To install Omnimix, go to Resident_omni_20230905_v13.7z and extract data folder into contents folder, overwriting existing files. After that, do the same for Resident_omni_20230905_mini_v14.7z
  3. To fix incorrect difficulties in DP omnimix charts, replace \data\info\0\music_omni.bin with the downloaded music_omni.bin
  4. Go to the iidx-asphyxia-v1.4.3_a5 zip file and extract the iidx@asphyxia folder to the plugins folder. It's a plugin that gives you gameplay customization and have the game able to connect to Asphyxia.

Configuration

  1. In the /prop/ea3-config.xml, change the version number to 2023090500. It should look like this:
    <ext __type="str">2023090500</ext>
    
  2. In order to launch the game properly, open avs-config.xml in prop folder and remove the following lines:

    <vfs name="boot" fstype="fs" src="D:/LDJ/contents/dev/raw" dst="/dev/raw" opt="vf=1,posix=1"/>  
    <vfs name="boot" fstype="fs" src="D:/LDJ/contents/dev/nvram" dst="/dev/nvram2" opt="vf=0,posix=1"/>
    

    and replace with:

    <vfs name="boot" fstype="fs" src="dev/raw" dst="/dev/raw" opt="vf=1,posix=1"/>
    <vfs name="boot" fstype="fs" src="dev/nvram" dst="/dev/nvram" opt="vf=1,posix=1"/>
    

Warning: Those XML files are encoded in SHIFT-JIS. This means that if you open it up in a notepad or other program, edit it and then save changes, there's a small chance that you could accidentally corrupt the file and make it fail to load when launching the game via spice, thus unplayable. It's recommended to make a backup copy of those files before editing them.

  1. To get extra game features, head over to the patcher and select your bm2dx.dll in modules folder (be sure to make a backup copy first). Here are the following recommended options for you to enable:
    • Standard/Menu & Premium Free Timer Freeze (freezes the song selection's timer.)
    • Cursor Lock (after finishing the song, the song selection screen will take you to that last played song instead of the end of a folder every time.)
    • Unlock All Songs and Charts (optional)
    • CS-style Song Start Delay
    • Skip CAMERA DEVICE ERROR Prompt (you can also disable camera device in spicecfg.)
    • Force Max V-Discs (optional)
    • Enable 1P & 2P Premium Free
    • Enable BPL BATTLE
    • Quick Retry (hold both EFFECT & VEFX buttons to restart the song.)
    • Disable Volume Change (by default, your volume gets automatically changed to 100% upon launching spice. This option fixes that issue.)
    • Omnimix
  2. Open up the sound control panel on Windows > Playback > Right-click on whichever is your default device > Properties > Advanced > 16 bit, 44100 Hz to avoid game crash and fix music timing issues. Be sure to enable "Allow applications to take exclusive control of this device" and "Give exclusive mode applications priority" options as well.
  3. To avoid the music syncing problem, open up the NVIDIA control panel and do the following:
    1. In the “Adjust Image Settings with Preview” page, enable “Use the advanced 3D image settings” option.
    2. Click on “Take me there."
    3. In the “Manage 3D Settings” page, click on the Program Settings tab.
    4. Select your spice64.exe
    5. Click to see recommended settings
      • It's worth reading "Optimize PC for Infinitas" guide as it is good optimization tutorial not just for Infinitas, but data as well. For now, just change 3D settings in NVIDIA control panel and don't optimize any further unless you still encounter syncing issues.
    6. Hit apply button.

Make sure to turn off G-Sync/FreeSync (if supported in your monitor) and don’t use an FPS limiter.

The game should either run at constant 60 FPS or 120 FPS (If enabled the 120 FPS support in the patcher. See How to get 120 FPS? in FAQ section for more details.)

If you get frequent frame drops, make sure to close background processes (like Chrome, Discord, etc.) as much as possible.

  1. Turn off read-only option on the contents folder to avoid getting unexpected issues.

If the read-only checkbox returns to a square after turning off that option and hit apply, there's no need to redo the same step unless you still encounter later issues like unable to have the game connect to Asphyxia or other.

Spicecfg settings

  1. Open spicecfg.exe, and in Buttons tab, set your buttons (including Test, P1 1-7 [P2 if you are the right side player], Start, Effect, Vefx, etc.)
  2. If you plan to use the IIDX controller, switch to HID mode on your controller, go to the Analogs tab and bind the turntable. From there, you can tune the sensitivity to your liking.
Options (for Phoenixwan) Value
Device PowerA Controller HID
Control X

About KOC for PS2, it only has digital input, so you bind to TT+ and TT- buttons instead.

  1. Go to the Cards tab and click the Generate button on either P1 or P2. This will create card0.txt in your contents folder, as that card will be used for logging in your EA profile in Asphyxia.
  2. To have the game connect to Asphyxia, go to the Options tab and set the EA Service URL to http://localhost:8083

In-game setup

  1. Open asphyxia-core-win-x64.exe for starting up your server, then spice64.exe to launch the game.

Asphyxia can even run offline. You may get a bad network check when booting up the game, but just ignore that error and you'll still be able to sign in your profile without an internet connection.

  1. Wait til you come across the Backup data error message. Press the Test button to let the game generate backup data for you, and press the Test button again when you come across the Clock error (It means you have to set up your own time in-game.) You should be taken to the test menu screen.

P1/P2 1 & 2 buttons to navigate down and up, P1/P2 6 button to select.

  1. Go to Game Options and tweak settings to your liking. Do the same for Coin & Language Options.
  2. Go to Network Options, configure the shop name setting to whatever name you desire if It's empty and test the network.

If it doesn't connect to Asphyxia, see Network error in Troubleshooting section.

  1. Go to Sound Options and test the game audio.

If you don't hear any audio, try using a 3.5mm jack instead of an external speaker via USB and that the headphone jack is set as default in the sound control panel. Otherwise, see Audio crash/No Audio in Troubleshooting section.

  1. Go to Clock, save & exit to set time.
  2. When you're done, exit the test menu by selecting the Game Mode, which should take you to the game.
  3. Press the Keypad Insert Card button to load up account creation.

If you can't register an EA profile, go to http://localhost:8083 and make sure the "Allow Register" is turned on.

  1. You can go back to the test menu at any time by pressing the Test button. That's it for this guide, enjoy playing IIDX RESIDENT :)

Notes about RESIDENT

There's currently no support of saving badges in Asphyxia yet.

Resident_omni_20230905_v13's Songs List:

  • Infinitas
    • 3y3s (Long ver.)
    • Clione (Ryu☆ Remix)
    • Amabie
    • 朱と碧のランページ
    • Remain
    • Space Dog
    • TSAR BOMBA
    • 1116
    • squall
    • concon
    • 少年リップルズ
    • Gimme a Big Beat
    • Too Late Snow
    • ロミとロボの宇宙飛行
    • 24h Endurance Race
    • Ha・lle・lu・jah
    • BLAZING_LAZER
    • Stleq
    • DO-IT-AMA-SITE!!!
    • tricky trick
    • Chocolate Planet
    • Vector
    • Lycoris
    • ALL OK!!
  • Old charts
    • SWEET LAB (Old version)
    • VJ ARMY (Old version)
    • Somebody Like You (Old version)
    • ATOMIC AGE (Old version)
    • DEEP ROAR (Old version)
    • Rising in the Sun (original mix) (Old version)
    • soldier's waltz (Old version)
    • TRIP MACHINE PhoeniX (Old version)
    • madrugada (Old version)
    • State Of The Art (Old version)
    • ミッドナイト堕天使 (Old version)
    • Y&Co. is dead or alive (Old version)
    • THE SHINING POLARIS (kors k mix) (Old version)
    • Do Back Burn (Old version)
    • New Castle Legions (Old version)
  • Ultimate Mobile's exclusive charts (Non-key sounded, SP only)
    • Psychedelic Intelligence
    • Cold Moon
    • starmine(kors k Remix)
    • airflow -dreaming of the sky- Game Edition
    • Poppin' Soda
    • Sword of Vengeance

If you use a search bar to look for Ultimate Mobile songs in TDJ mode (see What's the difference between TDJ and LDJ? in FAQ section for more details on TDJ), you won't get any search result however, you can still find them in CastHour folder.

Credits in Pixeldrain

  • 遠坂 さとう - LDJ-003-2022103100-2022120800 zip file
  • Nep-Nep#6969 - LDJ-20221208-20230404.7z
  • Anon from 1cc - LDJ-2023040400_to_2023090500.7z
  • iamsub - Resident_omni_20230905_v13.7z & Resident_omni_20230905_mini_v14.7z
  • ヘルエスタ王国民 - music_omni.bin
  • xuserv - iidx-asphyxia-v1.4.3_a5 zip file

IIDX 29 CastHour & Below

Disclaimer: Since the installation process of older IIDX data are similar to RESIDENT guide, I won't provide a tutorial on those games.

Here's the IIDX plugin for an online functionality in HEROIC VERSE up to RESIDENT. Thanks dopaminos in 1cc for providing data.

If you see DLLs in contents folder, move them to modules folder (create one if it doesn't exists) in contents.

For more older data, check out Bemani ♥ Touhou Collection Torrent. Be aware that many data in that collection aren't 100% clean, so expect to encounter potential issues with those games.


FAQ

Where can I find resources that can help me get started in IIDX?

You can find everything you need to know about IIDX in IIDX.org.

How to get 120 FPS? (Only for 120hz+ monitor)

Enable the following options in the patcher:

  • Force Custom Timing and Adapter Mode in LDJ.
  • 120 FPS in all options.
  • Skip Monitor Check (optional)
How to customize note skins, lane cover, etc.

Go to http://localhost:8083/ after you open up asphyxia-core-x64.exe.
Click on IIDX under plugins on the sidebar > Profiles > Details > Settings > Tweak options to your liking > Hit Submit.

A preview list of notes, lane cover, and more can be found on IIDX.org, rgbmew and qpro preview.

What's the difference between TDJ and LDJ?

TDJ mode has 120 FPS support and a secondary screen for accessing additional features like a search bar for songs, playlist, etc. This mode is used in the Lightning model and can be enabled in spicecfg. Note that you have to use Numpad on the subscreen instead of your keyboard.

LDJ mode has 60 FPS support, but no secondary screen. This mode is used in older IIDX model and your game will be set to this default mode if this is your first time installing IIDX.

If you wish to get 120 or 60 FPS on either mode, patcher has options for that.

How to launch a game in TDJ mode?

Enable TDJ mode in spicecfg, then enable Bypass Lightning Monitor Error option and Lightning Mode Camera Crash Fix in the patcher.

To activate the subscreen, press the Toggle Subscreen button (can be bound in spicecfg)
Alternatively, use the SpiceCompanion app on Android or IOS. To set up that app, do the following steps:

  1. Open spicecfg and go to options tab, set an API port and optionally a password.
  2. Open the spicecompanion app and enter your computer’s IPv4 address (which can be found by entering ipconfig in a command prompt) & port you set in spicecfg.

If you wish to use a secondary monitor for subscreen, that monitor has to support at least 1280x720@60hz and have touchscreen support.
If your monitor resolution doesn't match above, you can fix this by enabling GPU resolution scaling for that monitor in the NVIDIA control panel or similar program. Recommended to only have 2 monitors turned on at a time.

If you still cannot launch TDJ mode, delete the first Japanese line and the whitespace in the second line on ea3-config.xml at the prop folder.

How to transfer a profile from the older IIDX to a newer one?

Move both savedata folder and card0.txt from the older IIDX to the contents folder of the newer IIDX, and then type the same card number in the cards tab on spicecfg.

How to update IIDX?

To update the game to latest version, here's an example of how you upgrade the game's version in the following steps:

  1. Apply 20221025 update on top of 20221019 and overwrite all files, it will then upgrade the game's version to 20221025.
  2. Apply 20221031 update on top of 20221025 and overwrite all files, it will then upgrade the game's version to 20221031.
  3. And so on…

The reason for these steps in order is that each update version typically contains new songs, features and bugfixes.
If you were to upgrade 20221019 to 20221031 without installing 20221025 update, you won't get contents from the update you skipped over and also may break the game. You can check the version history in patcher.

Please backup your IIDX folder each time you're planning to update the game in case something goes wrong.

If your update zip file contains a bm2dx.dll that is newer than the same file in the /contents/modules, extract that bm2dx.dll from the zip file to the modules folder and overwrite the older file. Make sure that bm2dx.dll only exists in the modules folder.

How to manually change the version number in-game?

In the /prop/ea3-config.xml, change the version number to whichever version you have installed. Let's say It's 2023090500 for example, It should look like this:

<ext __type="str">2023090500</ext>
What's the difference between n-0 and n-1?

n-0 means unreleased data, whereas n-1 means current or past data.

What are alternatives to IIDX?
Contacts & Support thread for IIDX?

DM me for any suggestions for this guide.
Emuline for support thread.


Troubleshooting

FPS & Timing issues

Check out Optimize PC for Infinitas guide. It's primarily for Infinitas, but most of the steps apply to data as well.

Network error

Please check the following:

  • If playing online, ensure your data & Asphyxia server isn't blocked by a firewall.
  • Have a contents folder's read-only option disabled.
  • Use the latest version of Asphyxia plugin that supports whichever IIDX you have installed.
  • You have set correct EA service URL on spicecfg.

If you still get a same issue, go to ea3-config.xml in prop folder and replace what's in <services> under <network> with the following lines:

<services>http://localhost:8083</services>
<services_localstrap__type="str">http://localhost:8083</services_localstrap>
I can only press 6 keys or less at a same time

This is known as ghosting and It's a common problem among all office keyboards. What you want is a keyboard designed for anti-ghosting, as almost all mechanical keyboards will have this feature built-in.

Alternatively, you can use two office keyboards simultaneously to be able to press more than 6 keys.

No audio is captured when recording IIDX with OBS, Discord, etc.

Enable the WASAPI shared mode in patcher and set your audio device to 44100 Hz.

IIDX doesn't capture my controller inputs

Check your bindings on spicecfg and ensure there aren't any controls marked as Device missing. If so, try binding buttons as naive (only possible on keyboard.)

Alternatively, you can use AntiMicroX to map your controller inputs into keyboard presses.

Asphyxia cannot record scores of 2 different difficulties of the same song (for DP charts)

The latest version of Asphyxia plugin (see update's download link in IIDX RESIDENT) likely have this bug fixed already, but if you desired to stay in the old version of a plugin, open \plugins\iidx@asphyxia\handlers\IIDXmusic.ts and change line 109 to say "dpmArray" instead of "spmArray". Restart Asphyxia and you should be okay.

Audio crash/No audio
1
2
3
##### log.txt #####
W:audio::wasapi: WrappedIAudioClient::IsFormatSupported failed, hr=0x88890008
W:SuperstepSound: Audio device is not available!!!
  • Method One (WASAPI):
    • If you set the game to use exclusive audio (by default, the game uses exclusive audio), then ensure your audio device can support exclusive mode at 44100 Hz. Be sure to enable "Allow applications to take exclusive control of this device" and "Give exclusive mode applications priority" options on the advanced tab in a sound properties window.
    • If you've enabled WASAPI shared mode in patcher, set your audio device to 44100 Hz.
    • If 44100 Hz isn't available in your audio device, try connecting the USB DAC.
  • Method Two (ASIO):
    • If 44100 Hz isn't available in your audio device, or that you're using an older CPU that doesn't supports SSE 4.2 & have enabled the SSE 4.2 Fix option in the patcher, you can route the speaker through ASIO4ALL program, then make sure to set -iidxsounddevice option to asio and -iidxasio to ASIO4ALL in spicecfg.
      • Alternatively, you could use FlexASIO if you prefer more customizability than what ASIO4ALL has to offer, then simply set -iidxsounddevice to asio and -iidxasio to FlexASIO
W:libutils: 'C:\LDJ\contents\libavs-win64.dll (or bm2dx.dll)' couldn't be loaded

This error in log.txt usually occurs if there is a bm2dx.dll in the contents folder. Make sure that the bm2dx.dll is only in the modules folder.

If, however, you noticed there are bm2dx.dll in both the contents and modules folder, you should determine which one of them is newer than the other by either comparing two bm2dx.dll's game version in the patcher or checking modification & creation date on those files. Then whichever is the newest should belong in modules folder.

W:mounttab: boot(/dev/nvram2,/dev/nvram) mount error(80070002)
1
2
3
4
5
6
7
##### log.txt #####
W:mounttab: boot(/dev/nvram2,/dev/nvram) mount error(80070002)
W:boot: logger: /dev/raw/log does not exist
W:boot: logger: cannot create /dev/raw/log
W:boot: logger: cannot create log file
W:avs-core: failed to create '/dev/raw' folder at 'D:/LDJ/contents/dev/raw': Filename too long
W:avs-core: failed to create '/dev/nvram2' folder at 'D:/LDJ/contents/dev/nvram': Filename too long

Edit \prop\avs-config.xml and remove these lines:

<vfs name="boot" fstype="fs" src="D:/LDJ/contents/dev/raw" dst="/dev/raw" opt="vf=1,posix=1"/>  
<vfs name="boot" fstype="fs" src="D:/LDJ/contents/dev/nvram" dst="/dev/nvram2" opt="vf=0,posix=1"/>

and replace with:

<vfs name="boot" fstype="fs" src="dev/raw" dst="/dev/raw" opt="vf=1,posix=1"/>
<vfs name="boot" fstype="fs" src="dev/nvram" dst="/dev/nvram" opt="vf=1,posix=1"/>

This allows the game to create both /dev/raw and /dev/nvram folders in the game directory, instead of trying to create them in a nonexistance folder location that were specified in avs-config.xml by mistake.

Edit
Pub: 28 Aug 2023 04:38 UTC
Edit: 31 Oct 2023 00:53 UTC
Views: 15062