IIDX Install Guide for Windows 10 & 11
Table of Contents
- Table of Contents
- Introduction
- IIDX 31 EPOLIS (LDJ-2023101800)
- IIDX 30 RESIDENT (LDJ-2023090500)
- IIDX 29 CastHour & Below
- FAQ
- Where can I find resources that can help me get started in IIDX?
- How to get 120 FPS? (Only for 120hz+ monitor)
- How to customize note skins, lane cover, etc.
- What's the difference between TDJ and LDJ?
- How to launch a game in TDJ mode?
- How to transfer a profile from the older IIDX to a newer one?
- How to update IIDX?
- How to manually change the version number in-game?
- What's the difference between n-0 and n-1?
- What are alternatives to IIDX?
- Where is the support thread for IIDX?
- Troubleshooting
- Performance issues
- Network error
- I can only press 6 keys or less at a same time
- No audio is captured when recording IIDX with OBS, Discord, etc.
- IIDX doesn't capture my controller inputs
- Audio issues
- W:libutils: 'C:\LDJ\contents\libavs-win64.dll (or bm2dx.dll)' couldn't be loaded
- W:mounttab: boot(/dev/nvram2,/dev/nvram) mount error(80070002)
- More resources
Introduction
First time on installing IIDX? Please get started by following IIDX RESIDENT guide here, then you can proceed to upgrading the game to EPOLIS.
Remember to check FAQ and Troubleshooting sections in this guide if you encounter any issues or want to learn more about IIDX.
IIDX 31 EPOLIS (LDJ-2023101800)
Download link: Pixeldrain
- Make a backup copy of your IIDX RESIDENT folder.
- Install the update from LDJ-2023090500-2023101800.7z into your game folder, overwriting existing files.
- To install Omnimix, you have two following options for installing omni in data_mods folder.
- If you have Resident omni v14, install the mini omni.
- If you don't have it or still unsure, install 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 or lower.
See here for a tutorial on installing Omnimix in data_mods folder from RESIDENT guide.
Make sure to let it overwrite existing files when extracting from zip files.
- Make sure you have latest versions of spice2x and Asphyxia Core installed in your game folder from here:
Github: spice2x and Asphyxia Core
- Update your Asphyxia plugin to iidx-asphyxia-v1.4.4_a4 (contains EPOLIS support)
- In the NVIDIA control panel, select your spice64.exe from EPOLIS folder and apply recommended 3D settings here to avoid audio desync issues.
- Apply patches to your bm2dx.dll here.
Apply desired hex changes in bm2dx.dll here:
Omnimix
- 7947B6: 7F 19 → 90 90
- B5CEE3: 64 61 74 61 → 6F 6D 6E 69
- AB2697: 61 → 6F
AVX2 Patch (fixes crash on mode select, but disables videos. Only apply if your CPU doesn't support AVX2)
- 3FF350: 48 → C3
Alternative patcher: https://egrspatcher.pages.dev/
- If you wish to get WASAPI shared mode working, try setting your audio to 16bit, 48000hz or 96000hz.
- You now got EPOLIS ready to be launched!
IIDX 30 RESIDENT (LDJ-2023090500)
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 |
ifs_layeredfs | 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 (recommending 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.
Installation
- First, install Visual C++ Redistributables from vcredist, and DirectX from Microsoft website.
- Extract the LDJ-003-2022103100 zip file. Go to Asphyxia & spice2x zip files and extract all of those files into your game directory.
The folder structure should look like this:
- IIDX 30 RESIDENT
- 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.
- To update 2022103100 to 2022120800 game version, go to the LDJ-003-2022103100-2022120800 zip file, extract all files in contents folder into your game directory & overwrite existing files, and move bm2dx.dll to the modules folder & overwrite older file. After that, do the same for LDJ-20221208-20230404.7z, then LDJ-2023040400_to_2023090500.7z
- 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.
Installing Omnimix with ifs_layeredfs
ifs_layeredifs allows you to install modded files into data_mods folder and use them in-game, so mods don't have to be installed directly into the game folder. This helps keeping your vanilla game folder and mods (which in this case, an Omnimix) separated and intact.
- To install ifs_layeredfs, go to ifs_layeredfs zip file and do the following:
- Extract data_mods folder into your game directory.
- Go to 64bit folder and extract ifs_hook.dll into your modules folder.
- Go to automatic_injector_dlls folder and extract d3d9.dll into your game directory.
- To install Omnimix, do the following:
- Create a new folder named
Omnimix
in data_mods directory. - Go to Resident_omni_20230905_v13.7z and extract all files in data folder into an Omnimix folder you just created. After that, do the same for Resident_omni_20230905_mini_v14.7z, overwrite existing files, and you now have an Omnimix v14 installed!
- To uninstall Omnimix in case you don't want it, simply delete the Omnimix folder.
- To fix incorrect difficulties in DP omnimix charts, replace \Omnimix\info\0\music_omni.bin with the downloaded music_omni.bin
- Create a new folder named
Tweaks
- In the /prop/ea3-config.xml, change the version number to 2023090500. It should look like this:
-
In order to launch the game properly, open avs-config.xml in prop folder and remove the following lines:
and replace with:
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.
- 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
Alternative patcher: https://egrspatcher.pages.dev/
- Open up the sound control panel on Windows > Playback tab > Right-click on whichever is your default speaker > Properties > Advanced tab > Enable "Allow applications to take exclusive control of this device" and "Give exclusive mode applications priority" options to avoid game crash and fix music timing issues. Make sure it supports 16bit 44100hz (you'll be playing on WASAPI exclusive mode by default.)
- To avoid the music syncing problem, open up the NVIDIA control panel and do the following:
- In the “Adjust Image Settings with Preview” page, enable “Use the advanced 3D image settings” option.
- Click on “Take me there."
- In the “Manage 3D Settings” page, click on the Program Settings tab.
- Select your spice64.exe
- 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 accordingly and don't optimize any further unless you still encounter syncing issues.
- Hit apply button.
- 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
- 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.)
- 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.
- 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.
- 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
- 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.
- 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.
- 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.
- 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 issues in Troubleshooting section.
- Go to Clock, save & exit to set time.
- Tweak the rest of settings to your own liking.
- When you're done, exit the test menu by selecting the Game Mode, which should take you to the game.
- Press the Keypad Insert Card button to load up account creation.
- 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 the game folder, move them to modules folder (create one if it doesn't exists) in the install directory.
Downloads | Data Releases |
---|---|
LDJ-2022082400 | |
LDJ-2021091500 | |
LDJ-2020092900 | |
LDJ-2019100700 | |
LDJ-2018091900 | |
LDJ-2017082800 |
To get 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. Remember to seed the torrent for as long as possible.
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 section (also includes in Skip Monitor Check FPS section if enabled.)
- Skip Monitor Check (optional, but not recommended enabling it unless the game runs at stable 120 FPS.)
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.
In EPOLIS on TDJ mode, you can customize your gameplay look on the subscreen without having to go to Asphyxia settings.
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?
Do the following for enabling TDJ:
- Enable TDJ mode in spicecfg (latest version)
- Don't disable the subscreen and don't enable the single monitor mode in spicecfg & patcher.
- Enable Bypass Lightning Monitor Error, Lightning Mode Camera Crash Fix, and Force TDJ mode in the patcher (not all options are available depending on what IIDX version you have installed.)
Launching subscreen in three ways:
- To activate the subscreen window on a main screen, press the Toggle Subscreen button (can be bound in spicecfg), and use your mouse to interact on the subscreen. Only one monitor needed.
- To use a secondary monitor as a subscreen, the monitor has to support at least 1280x720@60hz and have touchscreen support.
- If your secondary monitor's resolution doesn't match the above requirement, you can fix this by enabling GPU resolution scaling for that monitor in the NVIDIA control panel or other similar program. Recommended to only have 2 monitors turned on at a time.
- Use the SpiceCompanion app on Android or IOS to hook up subscreen display on a tablet. To set up that app, do the following steps:
- Open spicecfg and go to options tab, set an API port and optionally a password.
- 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 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 (do this as a last resort.)
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 a newer one, 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:
- Apply 20221025 update on top of 20221019 and overwrite all files, it will then upgrade the game's version to 20221025.
- Apply 20221031 update on top of 20221025 and overwrite all files, it will then upgrade the game's version to 20221031.
- And so on…
The reason for these steps in order is that each update version typically contains new songs, features and bugfixes. If you did 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 upgrade the game in case something goes wrong.
Make sure that all DLLs are 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:
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?
- Key-sounded games
- beatoraja
- Bemuse (Can also be played in Flashpoint for offline experience)
- O2Mania
- O2Jam (Dead, but private servers exist)
- DJMAX Respect V (Paid, with DLCs)
- EZ2ON REBOOT : R (Paid, with DLCs)
- Non-key sounded games
- Quaver
- Malody
- Etterna
- Flash Flash Revolution
- Sixtar Gate: STARTRAIL (Paid, with DLCs)
Where is the support thread for IIDX?
Troubleshooting
Performance issues
Network error
Please check the following:
- Ensure your spice & Asphyxia server isn't blocked by a firewall.
- Have a game folder's read-only option disabled.
- Use the latest version of Asphyxia plugin that supports whichever IIDX version you have installed.
- Use latest versions of spice2x and Asphyxia.
- You have set correct EA service URL in spicecfg.
- Unticked the -ea option in spicecfg. That option is there if you want to get past the network check and play the game offline.
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 (do this as last resort):
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.
To get WASAPI shared mode working in EPOLIS, set your audio to 16bit, 48000hz or 96000hz.
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, rebind them.
Alternatively, you can use AntiMicroX to map your controller inputs into keyboard presses.
Audio issues
- 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
- 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.
See here for more info on audio modes.
To get WASAPI shared mode working in EPOLIS, set your audio to 16bit, 48000hz or 96000hz.
W:libutils: 'C:\LDJ\contents\libavs-win64.dll (or bm2dx.dll)' couldn't be loaded
This error in log.txt usually occurs if there are DLLs in the game folder. Make sure that those are in the modules folder.
W:mounttab: boot(/dev/nvram2,/dev/nvram) mount error(80070002)
Edit \prop\avs-config.xml and remove these lines:
and replace with:
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.
More resources
Check out other Rentry guides here. IIDX guide is featured in FMHY wiki.