feat(dev): Add a separate docker dev container

Improve the development experience by providing
an additional docker container that can be started
and used as an interactive development environment.
It provides all the tools and a stable environment
for building (identical to the build container).

.clang-format

@@ -9,23 +9,23 @@ AllowShortCaseLabelsOnASingleLine: 'false'
 AllowShortFunctionsOnASingleLine: None
 AllowShortIfStatementsOnASingleLine: 'false'
 AllowShortLoopsOnASingleLine: 'false'
-AlwaysBreakAfterDefinitionReturnType: All
+AlwaysBreakAfterDefinitionReturnType: None
 AlwaysBreakAfterReturnType: None
-AlwaysBreakBeforeMultilineStrings: 'false'
+AlwaysBreakBeforeMultilineStrings: 'true'
 BinPackArguments: 'false'
 BinPackParameters: 'false'
 BreakBeforeBinaryOperators: None
 BreakBeforeBraces: Linux
 BreakBeforeTernaryOperators: 'false'
 BreakStringLiterals: 'true'
-ColumnLimit: '120'
+ColumnLimit: '80'
-ContinuationIndentWidth: '8'
+ContinuationIndentWidth: '4'
 IncludeBlocks: Preserve
-IndentCaseLabels: 'false'
+IndentCaseLabels: 'true'
 IndentPPDirectives: None
 IndentWidth: '4'
 IndentWrappedFunctionNames: 'false'
-KeepEmptyLinesAtTheStartOfBlocks: 'false'
+KeepEmptyLinesAtTheStartOfBlocks: 'true'
 Language: Cpp
 MaxEmptyLinesToKeep: '1'
 PointerAlignment: Right

.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,103 @@
+# Bug report
+
+## Summary
+
+<!--- Provide a general summary of the issue in the Title above -->
+
+## Expected behavior
+
+<!--- Tell us what should happen -->
+
+## Current behavior
+
+<!--- Tell us what happens instead of the expected behavior -->
+
+## Detailed Description
+
+<!--- Provide a detailed description of the issue. Include links to screenshots or videos if
+necessary -->
+
+## Steps to reproduce
+
+<!-- Try running the game with a default configuration as well. If that also causes issues, please point that out here in the report. This might speed up the debugging process.-->
+
+<!--- Provide a detailed step by step description how to reproduce this issue -->
+
+1.
+1.
+1.
+1.
+
+## Possible solution
+
+<!--- Not obligatory, but suggest a fix/reason for the bug, -->
+
+## Context (Environment)
+
+### Bemanitools version(s) affected
+
+- <!--- Add one or multiple versions as a bullet list -->
+
+### Game(s) and version(s) affected
+
+- <!--- Add one or multiple game versions as a bullet list -->
+
+### Log output
+
+See attachment.
+
+<!---
+Provide FULL log output, e.g. inject.log or launcher.log. Please do not guess which things
+are relevant or not. Without knowing, you might leave out things that are relevant for the developers. You have to enable log output explicitly if not done already. 
+
+For inject.exe and launcher.exe, add `-Y logfile.log` to the command line args to output to a file, e.g. `gamestart.bat -Y logfile.log`.
+
+!!!!!!
+REMOVE ANY SENSITIVE DATA LIKE PCBIDS OR DEVICE NAMES BY REPLACING IT THEM WITH
+
+[REDACTED]
+
+BEFORE UPLOADING/POSTING ANY LOG DATA!!!
+
+Use the search and replace feature of any kind of text editor.
+!!!!!!
+-->
+
+### Configuration files
+
+See attachment.
+
+<!--- Provide any configuration files that you used, e.g. iidxhook-XX.conf. This file is located in
+the same directory as launcher.exe or inject.exe. 
+
+!!!!!!
+REMOVE ANY SENSITIVE DATA LIKE PCBIDS OR DEVICE NAMES BY REPLACING IT THEM WITH
+
+[REDACTED]
+
+BEFORE UPLOADING/POSTING ANY LOG DATA!!!
+
+Use the search and replace feature of any kind of text editor.
+!!!!!!
+-->
+
+### Command line arguments
+
+<!--- Provide how you run the game from the command line, e.g. which gamestart.bat you used and any
+additional arguments that you provided to it. Also provide the contents of the gamestart.bat you
+used if you altered it. -->
+
+### APIs used
+
+- <!--- List all APIs you used as a bullet list, e.g. iidxio-keyboard, eamio-keyboard -->
+
+### OS version
+
+<!--- Provide the version of Windows you used with whatever update/build identifier -->
+
+### Hardware specs
+
+- CPU: <!--- Insert, e.g. Core i7 2600k 3.20ghz -->
+- RAM: <!--- Insert, e.g. 16 GB -->
+- GPU: <!--- Insert, e.g. Nvidia GeForce GTX 970, 4GB -->
+- Controllers/IO: <!--- Insert, e.g. DJ Dao RE over USB -->

.github/ISSUE_TEMPLATE/feature.md

@@ -0,0 +1,21 @@
+# Feature request
+
+## Summary
+
+<!--- Provide a general summary of your changes in the Title above -->
+
+## Detailed description
+
+<!--- Describe your feature in detail -->
+
+## Benefits
+
+<!--- Describe the value/benefits of the feature in detail -->
+
+## Drawbacks
+
+<!--- Describe any drawbacks that might be introduced with this feature -->
+
+## Current blockers
+
+<!--- Describe any blockers that need to be resolved before implementing this feature -->

.github/PULL_REQUEST_TEMPLATE/pull-request.md

@@ -0,0 +1,41 @@
+# Pull request
+
+## Summary
+
+<!--- Provide a general summary of your changes in the Title above -->
+
+## Description
+
+<!--- Describe your changes in detail -->
+
+## Related Issue
+
+<!--- This project only accepts pull requests related to open issues -->
+
+<!--- If suggesting a new feature or change, please discuss it in an issue first -->
+
+<!--- If fixing a bug, there should be an issue describing it with steps to reproduce -->
+
+<!--- Please link to the issue here: -->
+
+## How Has This Been Tested?
+
+<!--- Please describe in detail how you tested your changes. -->
+
+<!--- Include details of your testing environment, and the tests you ran to -->
+
+<!--- see how your change affects other areas of the code, etc. -->
+
+## Checklist
+
+<!-- Make sure you covered all items, which apply, of the checklist below. -->
+
+<!-- Strikethrough items that do not apply and provide a brief description why. -->
+
+- \[ \] Implemented (unit) test(s) which prove that the introduced changes are working as expected.
+- Tested with the following games:
+  - \[ \] ... <!-- insert game name 1-->
+  - \[ \] ... \<!-- insert game name 2--->
+- \[ \] Followed the developer (style) guidelines.
+- \[ \] Updated existing doc of or add new doc to README file(s).
+- \[ \] Updated development documentation.

.github/workflows/build-master.yaml

@@ -0,0 +1,39 @@
+name: "Build bemanitools"
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  build:
+    runs-on: "ubuntu-22.04"
+    steps:
+      - name: "Checkout repository"
+        uses: "actions/checkout@v2"
+
+      - name: "Install prerequisites"
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y runc containerd docker.io
+
+      - name: "Build"
+        run: |
+          make build-docker
+
+      # Do some unpacking of the dist zip. Artifact upload repackages stuff
+      - name: "Prepare artifact package"
+        run: |
+          mkdir artifact
+          cd artifact
+          unzip ../build/bemanitools.zip
+          cd ..
+
+      - name: "Upload artifact"
+        uses: "actions/upload-artifact@v2"
+        with:
+          name: bemanitools-${{ github.sha }}
+          retention-days: 90
+          if-no-files-found: "error"
+          path: |
+            artifact/**

.github/workflows/build-tag.yaml

@@ -0,0 +1,75 @@
+name: "Build bemanitools and publish release"
+
+permissions:
+  contents: write
+  packages: write
+
+on:
+  push:
+    tags:
+      - "*.*"
+
+jobs:
+  build:
+    runs-on: "ubuntu-22.04"
+    steps:
+      - name: "Checkout repository"
+        uses: "actions/checkout@v2"
+
+      # Building bootstrapped using docker containers
+      - name: "Install prerequisites"
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y runc containerd docker.io
+      
+      - name: "Build"
+        run: |
+          make build-docker
+
+      # Do some unpacking of the dist zip. Artifact upload repackages stuff
+      - name: "Prepare artifact package"
+        run: |
+          mkdir artifact
+          cd artifact
+          unzip ../build/bemanitools.zip
+          cd ..
+
+      - name: "Upload artifact"
+        uses: "actions/upload-artifact@v2"
+        with:
+          name: bemanitools-${{ github.sha }}
+          retention-days: 90
+          if-no-files-found: "error"
+          path: |
+            artifact/**
+
+  publish-release:
+    needs: "build"
+    runs-on: "ubuntu-22.04"
+    steps:
+      # This already extracts the contents of the artifact
+      - name: "Download artifact"
+        uses: "actions/download-artifact@v2"
+        with:
+          name: bemanitools-${{ github.sha }}
+
+      - name: "Get the version"
+        id: get_version
+        run: |
+          echo ::set-output name=VERSION::$(echo $GITHUB_REF | cut -d / -f 3)
+
+      # The publish release action does not package the artifact *sigh*
+      - name: "Create release package"
+        run: |
+          zip bemanitools-${{ steps.get_version.outputs.VERSION }}.zip *
+
+      - name: "Publish release"
+        uses: "marvinpinto/action-automatic-releases@v1.2.1"
+        with:
+          repo_token: "${{ secrets.GITHUB_TOKEN }}"
+          automatic_release_tag: "latest"
+          draft: false
+          prerelease: true
+          title: ${{ steps.get_version.outputs.VERSION }}
+          files: |
+            bemanitools-${{ steps.get_version.outputs.VERSION }}.zip

.gitignore

@@ -4,3 +4,4 @@ build/
 .vscode
 .vs
 version
+.DS_Store

CHANGELOG.md

@@ -1,177 +1,420 @@
 # Release history
+
+Note for CI/CD: Ensure the version formatting in the sections is kept identical to the versions
+given in tags. The pipeline will pick this up and cuts out the relevant section for release notes.
+
+## 5.49
+
+### Features
+
+### Fixes
+
+## 5.48
+
+### Features
+
+- feat(config): Add invert analog input option. Remark: The old configuration file format is
+  upgraded but downgrading is not possible anymore. The new saves are using a new filename and it
+  doesn't delete the old files, see `C:\Users\<YOUR_USERNAME>\AppData\Roaming\DJHACKERS`
+
+### Fixes
+
+## 5.47
+
+### Features
+
+N/A
+
+### Fixes
+
+- fix(ddr/p3ioemu): Handle unknown 2B command to fix DDR X IO errors
+- fix(ddr/p3io): Crash on all supported DDR games due to incorrect p3io message size validation
+- fix(geninput): Sony DualShock 4 not working
+
+## 5.46
+
+### Features
+
+- feat(ddrio): Wrapper/shim library to drive another ddrio in a dedicated IO thread. Improves
+  performance for highly IO bound ddrio implementations, e.g. ddrio-p3io
+- feat(iidxiotest): bi2a-iidx support
+
+### Fixes
+
+- fix(jb03/04): Missing XML in gamestart script
+- fix(jbhook1): Rotate error message box when screen is rotated
+- fix(jbhook1): Improve/fix automatic config/nvram fs initialization
+
+## 5.45
+
+### Features
+
+- feat(iidx 30): Added support
+- feat(ddr): Add ddrio implementation with P3IO driver backend
+- feat(ddr): Add p3io-ddr-tool for testing/debugging real P3IO devices with EXTIO
+- feat(ddr): Add testing tool for real EXTIO devices
+- feat(ddr): Add extio driver
+- feat(ddr): Add p3io driver
+- feat(iidx 20-26): New/fixed gfx up-/downscaling feature, old one was broken
+- feat(ddr): Vigem driver for ddrio
+- feat(iidx 25-30): The user can now set a custom camera device override of "SKIP" to leave that
+  camera unassigned
+
+### Fixes
+
+- fix(iidx 09/10): Fix stretched BGAs on 1st and 3rd style videos
+
+## 5.44
+
+### Features
+
+- feat(doc): ezusb dev journal entry, 10th style ezusb boot up and security setup
+- feat(iidx 09/10): ezusb API call monitoring module and configuration flag
+- feat(iidx 19): Add back btools monitor check for iidxhook5
+- feat(iidx 9-19): Add configurable settings path hook. Redirect settings paths, i.e. `d/`, `e/` and
+  `f/` drive "folders" to an arbitrary path on any partition, e.g. writable partition
+- feat(iidx 9/10): Improve commandline script for irbeat-patch 09 and 10, add interactive mode
+
+### Fixes
+
+- fix(iidx 10): SQ-INIT error caused by incorrect security configuration
+- fix(iidx 9-24): Wire up coin input in ezusb1/2 IO emulation layer
+- fix(pnm 15-18): Fix IO buffer inconsistency causing random input misfiring
+- fix(jb 1-8): Fix IO buffer inconsistency causing random input misfiring
+- fix(iidx 9-24): Fix IO buffer inconsistency causing random input misfiring
+- fix(iidx 19): imagefs override strategy with local file redir. Required to enable monitor-check on
+  all chart files
+- fix(iidx 9-19): Code synchronization issue causing deadlock resulting in game hang/stuck on boot
+- fix(iidx 9-19): Fix broken settings path handling with mixed / and \\
+- fix(iidx 27): Align disabled cam connection config defaults with 28/29
+- fix(inject): Fix missing forwarding of exit code
+- fix(inject): Getting stuck when game exits cleanly due to locked up debugger thread.
+- fix(iidx 18/19 CN): gamestart.bat creating dev/nvram and dev/raw folders
+
+## 5.43
+
+- iidx29: (Officially) support IIDX CASTHOUR
+- Code structure maintenance
+- Various documentation improvements
+
+## 5.42
+
+- Bugfix: Fix diagonal texture tearing on IIDX 18 and 19 based games
+- Feature: Add support for IIDX Resort Anthem CN using iidxhook4-cn
+- Feature/bugfix: Enable "nvidia fix" for iidxhook4, 5 and 5-cn. Should fix crashing on some/all
+  nvidia cards
+- Various minor fixes
+
+## 5.41
+
+- Feature: Support pop'n music 15-18 using popnhook1
+- Feature: Support IIDX tricoro CN using iidxhook5-cn
+- Various documentation improvements
+
+## 5.40
+
+- Feature: Support DDR X and X2 US/EU using ddrhook1 including memory card emulation
+- Fix: sdvxhook2 crashing on some OS versions
+- Feature: Support sdvx generator lights in sdvxio
+
+## 5.39
+
+- jbhook3: Fix window mode, remove window frame option, add show cursor on window option
+- Code simplification and cleanup round plug modules
+- Code structure improvements p3io jubeat
+
+## 5.38
+
+- sdvxhook2: Support sound voltex exceed gear
+
+## 5.37
+
+- jbhook1: Support jubeat (1) and ripples
+- jbhook2: Support jubeat knit and copious
+- jbhook3: Support jubeat saucer, prop, qubell, clan and festo
+
+## 5.36
+
+- iidxhook9: Support for IIDX28
+- Various bugfixes
+
+## 5.35
+
+- Jubeat: Add jbio-p4io
+- Nostalgia: Add nostio-panb
+- Misc: Add wavepass support to aciodrv-icca (and eamio-icca)
+- Misc: Refactor aciodrv to support multiple devices using the same port (with aciomgr)
+- Misc: Fix d3d9ex windowed hook not behaving correctly (size/framed)
+- Misc: Fix docs not being included with release
+- Various bugfixes
+
+## 5.34
+
+- IIDX: Support IO and card reader feature switches to disable emulation in iidxhook4-7
+- Jubeat: jbio implementation for magicbox hardware
+- Misc: Various documentation improvements
+- IIDX: Turntable multiplier (can also be used as inverted) for iidxhook9
+- IIDX: iidxhook9, add force screen resolution option to fix sometimes wrong auto res detection by
+  iidx27 causing inaccurate/wrong refresh rates on monitor check
+- IIDX: iidxio BIO2 implementation -> Use BIO2 hardware with any iidxhook or other software
+  supporting BT5's iidxio interface
+- IIDX: BIO2 exit hook, exit the game pressing Start P1 + Start P2, Effect and VEFX
+- launcher: Allow overriding service URL from command line
+- IIDX: vigem-iidxio, tool to allow using iidxio (ezusb, ezusb2 or bio2) to emulate XBOX controllers
+  to play other non arcade games that support xinput, e.g. Lunatic Rave (note: Infinitas does not
+  work with this since it only supports direct input)
+
+## 5.33
+
+- iidxhook9: Support for IIDX27
+- sdvxio-bio2: Driver for real sdvx5 cabinet IO hardware
+- vigem-sdvxio: Tool to allow using sdvxio (kfca or bio2) to emulate an xbox controller
+- Various bugfixes and refactoring for inject and launcher
+
+## 5.32
+
+- Various bugfixes
+
+## 5.31
+
+- DDR: Fix p3io and extio lights not working / being swapped when using geninput
+- DDR: Add HDXS light support
+- DDR: Add 64 bit support
+- DDR: Add option to use COM4 as the p3io rs232 port instead of emulating (for use with acrealio
+  etc.)
+- Jubeat: Add network adapter hook
+- Misc: Fix aciodrv sometimes hanging on boot (eamio-icca and sdvxio-kfca)
+
+## 5.30
+
+- SDVX: sdvxhook2 headphone force and cursor confining config options
+- DDR: Add light support for SMX gen 4 pads
+
+## 5.29
+
+- SDVX: Add option for monitor rotation
+- SDVX: Add option to allow overriding network adapter IP
+- IIDX: Add force display adapter and refresh rate configuration
+- SDVX: Allow specifying display adapter to open for d3d9ex hook
+- IIDX/SDVX camerahooks bugfix: Camera sometimes not detected on some older machines
+
+## 5.28
+
+- Improve documentation in various places
+- Automatic code formatting in build pipeline
+- Bugfix: Recursive config.bat script
+- Enable automatic building on pushes to master
+- Bugfix: Stop SDVX hanging on thankyou for playing
+- sdvx2: Support for Vivid Wave using sdvxhook2
+- sdvxio-kfca: Driver for real sdvx cabinet IO hardware
+
+## 5.27
+
+- Various documentation updates regarding development and how to contribute
+- KFCA emulation accuracy fixes
+- Fix passthrough of serial calls when using real hardware (e.g. card reader passthrough
+  IIDX25+/SDVX5+)
+- Add sdvxio-kfca driver to talk to real SDVX hardware
+- Refactor d3d9 hook module to improve maintainability. Also fixes upscaling not working on IIDX20+.
+- Remove d3d8 hook module to improve maintainability. Make old d3d8 based games, e.g. iidxhook1/2,
+  use d3d9 instead. Requires usage of d3d8to9 wrapper library to use gfx patching features.
+- Add dev doc about IIDX rendering loops
+- Add an initial draft of an architecture document (will be worked on in iterations)
+- Refactor BIO2 emulation to make it re-usable by other games
+
 ## 5.26
-* iidxio-ezusb: Reduce sleep time to Sleep(1) to avoid framerate issues on some versions of iidx.
+
-* Bugfix: iidx d3d9 games, mainly the newer ones iidx 20-25, freezing. Happened on boot, during song selection or during the song.
+- iidxio-ezusb: Reduce sleep time to Sleep(1) to avoid framerate issues on some versions of iidx.
-* Bugfix: log_server_init deadlock on iidxhook4-7. This caused games like iidx24 to hang before even showing a render window.
+- Bugfix: iidx d3d9 games, mainly the newer ones iidx 20-25, freezing. Happened on boot, during song
-* iidxhook: Add feature to allow GPU based up-/downscaling of rendered frame. This gives
+  selection or during the song.
-you the possibility to upscale the resolution of old SD (640x480) games to your monitor's/TV's
+- Bugfix: log_server_init deadlock on iidxhook4-7. This caused games like iidx24 to hang before even
-native resolution which can have a few advantages: better image quality if the monitor's upscaler
+  showing a render window.
-is not doing a good job, especially on resolutions that are not a multiple of its native resolution;
+- iidxhook: Add feature to allow GPU based up-/downscaling of rendered frame. This gives you the
-Reduce display latency if the upscaler is slow, avoid over-/underscan which cannot always be fixed
+  possibility to upscale the resolution of old SD (640x480) games to your monitor's/TV's native
-entirely or at all (depending on your GPU and monitor model). See the iidxhook configuration file
+  resolution which can have a few advantages: better image quality if the monitor's upscaler is not
-for the new parameters available.
+  doing a good job, especially on resolutions that are not a multiple of its native resolution;
-* Major readme cleanup. Add development documentation like style guide, guidelines, development setup.
+  Reduce display latency if the upscaler is slow, avoid over-/underscan which cannot always be fixed
+  entirely or at all (depending on your GPU and monitor model). See the iidxhook configuration file
+  for the new parameters available.
+- Major readme cleanup. Add development documentation like style guide, guidelines, development
+  setup.
 
 ## 5.25
-* Bugfix: iidx14 and 15 crashing on Windows 10
+
-* Bugfix: IO2 driver not using correct package sizes on reads/write -> iidxio-ezusb2.dll now working
+- Bugfix: iidx14 and 15 crashing on Windows 10
-* Improve ezusb2-boot.bat script to handle flashing of IO2 firmware
+- Bugfix: IO2 driver not using correct package sizes on reads/write -> iidxio-ezusb2.dll now working
-* Remove broken x64 builds of ezusb1/2 tools -> Just use the x86 tool versions instead
+- Improve ezusb2-boot.bat script to handle flashing of IO2 firmware
-(use the x64 versions of iidxio-ezusb.dll and iidxio-ezusb2.dll with iidx25)
+- Remove broken x64 builds of ezusb1/2 tools -> Just use the x86 tool versions instead (use the x64
-* iidxhook1-8: Allow floating point values for frame rate limiting, e.g. 59.95 (hz).
+  versions of iidxio-ezusb.dll and iidxio-ezusb2.dll with iidx25)
-* Improve timing with ezusb (C02) driver
+- iidxhook1-8: Allow floating point values for frame rate limiting, e.g. 59.95 (hz).
+- Improve timing with ezusb (C02) driver
 
 ## v5.24
-* Bugfix: iidxhook8 hangs very early on startup (race condition in log-server module)
+
+- Bugfix: iidxhook8 hangs very early on startup (race condition in log-server module)
 
 ## v5.23
-* Refactored configurion (file) handling for iidxhooks, RE-READ THE DOCUMENTATION.
+
-This gets rid of the "short cmd parameters", e.g. -w for windowed mode, and replaces
+- Refactored configurion (file) handling for iidxhooks, RE-READ THE DOCUMENTATION. This gets rid of
-them with full name parameters, e.g. -p gfx.windowed=true, which improves handling
+  the "short cmd parameters", e.g. -w for windowed mode, and replaces them with full name
-of configuration files/values. 
+  parameters, e.g. -p gfx.windowed=true, which improves handling of configuration files/values.
-* Add a lot of unit tests to the codebase
+- Add a lot of unit tests to the codebase
-* Refactored round plug security infrastructure, shared with IIDX and jubeat (1)
+- Refactored round plug security infrastructure, shared with IIDX and jubeat (1)
-* Move shared utility modules between iidxhook modules to a separate utilty module 'iidxhook-util'
+- Move shared utility modules between iidxhook modules to a separate utilty module 'iidxhook-util'
-* Add experimental jubeat (1) support (buggy IO emulation) 
+- Add experimental jubeat (1) support (buggy IO emulation)
-* Various fixes to improve all iidxhooks when running on Windows 10
+- Various fixes to improve all iidxhooks when running on Windows 10
-* Bugfix: iidxio-ezusb getting stuck on newer Windows platforms
+- Bugfix: iidxio-ezusb getting stuck on newer Windows platforms
-* Update iidxhook docs, e.g. how to get old IIDX versions sync on Windows 10
+- Update iidxhook docs, e.g. how to get old IIDX versions sync on Windows 10
-* Various documentation updates
+- Various documentation updates
-* Various code cleanup
+- Various code cleanup
-* Various other minor bugfixes
+- Various other minor bugfixes
 
 ## v5.22
-* Added a lot of documentation and readme stuff (READ IT!!11)
-* Re-numbering iidxhook implementations to make room for missing games
-* Support for IIDX 18 -> iidxhook4
-* Support for IIDX 19 -> iidxhook5
-* Support for IIDX 20 -> iidxhook6
-* A lot of code refactoring and cleanup
-* Refactor p3io emulation
-* Remove obsolete BT4 DDR stuff
-* iidxhook: Refactored software monitor check and bugfixes. You can use the
-auto monitor check to determine your machine's refresh rate or (new) set the
-refresh rate yourself in the configuration file, e.g. when you already have
-determined it using one of the newer IIDX games and want to skip that monitor
-check or if BT5's software monitor check doesn't work properly (e.g. on Win 7).
-* iidxhook1-3: Check if eamuse server is reachable and log a warning otherwise.
-This should make debugging invalid URLs or connection issues easier.
-* iidxhook: Revised ezusb and ezusb2 emulation layer. Translucent support
-removed, all IO emulation goes through BT5's iidxio interface.
-* iidxio: Add implementations for ezusb (C02 IO) and ezusb2 (IO2) hardware. This
-allows you to run _ANY_ IIDX game supported by BT5 either with real C02 or IO2
-hardware.
-* iidxhook: Remove translucent card reader feature. Again, to create a unified
-interface for _ALL_ versions, use the eamio-icca.dll if you want to run on 
-real ICCA (slotted or wavepass) readers. 
-* Various other bugfixes
 
-Again, read the various markdown (.md) readme files. We tried to document
+- Added a lot of documentation and readme stuff (READ IT!!11)
-everything to the best of our knowledge. If you are missing something, please
+- Re-numbering iidxhook implementations to make room for missing games
-contribute by adding that information and submitting a patch to us.
+- Support for IIDX 18 -> iidxhook4
+- Support for IIDX 19 -> iidxhook5
+- Support for IIDX 20 -> iidxhook6
+- A lot of code refactoring and cleanup
+- Refactor p3io emulation
+- Remove obsolete BT4 DDR stuff
+- iidxhook: Refactored software monitor check and bugfixes. You can use the auto monitor check to
+  determine your machine's refresh rate or (new) set the refresh rate yourself in the configuration
+  file, e.g. when you already have determined it using one of the newer IIDX games and want to skip
+  that monitor check or if BT5's software monitor check doesn't work properly (e.g. on Win 7).
+- iidxhook1-3: Check if eamuse server is reachable and log a warning otherwise. This should make
+  debugging invalid URLs or connection issues easier.
+- iidxhook: Revised ezusb and ezusb2 emulation layer. Translucent support removed, all IO emulation
+  goes through BT5's iidxio interface.
+- iidxio: Add implementations for ezusb (C02 IO) and ezusb2 (IO2) hardware. This allows you to run
+  _ANY_ IIDX game supported by BT5 either with real C02 or IO2 hardware.
+- iidxhook: Remove translucent card reader feature. Again, to create a unified interface for _ALL_
+  versions, use the eamio-icca.dll if you want to run on real ICCA (slotted or wavepass) readers.
+- Various other bugfixes
+
+Again, read the various markdown (.md) readme files. We tried to document everything to the best of
+our knowledge. If you are missing something, please contribute by adding that information and
+submitting a patch to us.
 
 ## v5.21
-* Camera hook for IIDX 25 (use any UVC webcam in-game), by Xyen
+
-* *deep breath* Source code release
+- Camera hook for IIDX 25 (use any UVC webcam in-game), by Xyen
+- *deep breath* Source code release
 
 ## v5.20
-* Support for the new IIDX 25 IO board (xyen)
+
-* New IO hook system with better multi-threading behavior
+- Support for the new IIDX 25 IO board (xyen)
-* Add a replaceable "vefxio" backend dll for IIDX (xyen)
+- New IO hook system with better multi-threading behavior
-* Card reader emulation can now be disabled in iidxhook (xyen)
+- Add a replaceable "vefxio" backend dll for IIDX (xyen)
-* Add jbhook (xyen, mon)
+- Card reader emulation can now be disabled in iidxhook (xyen)
-* Add ddrhook (ported from Bemanitools 4 by mon)
+- Add jbhook (xyen, mon)
-* Various ICCA emulation improvements (xyen, mon)
+- Add ddrhook (ported from Bemanitools 4 by mon)
-* QoL improvements to config.exe (xyen, mon)
+- Various ICCA emulation improvements (xyen, mon)
-* Other bug fixes (various contributors)
+- QoL improvements to config.exe (xyen, mon)
+- Other bug fixes (various contributors)
 
 ## a19
-* iidx 17 support
+
-* Bugfix: forums.php?action=viewthread&threadid=51257&postid=1425861#post1425861
+- iidx 17 support
-* iidx 14-17: Improved monitor check and new monitor check screen which shows 
+- Bugfix: forums.php?action=viewthread&threadid=51257&postid=1425861#post1425861
-the current frame rate instead of just a white screen
+- iidx 14-17: Improved monitor check and new monitor check screen which shows the current frame rate
-* iidx 09-13: Improved monitor check (but still white screen when in progress. 
+  instead of just a white screen
-d3d8 doesn't offer any text render out of the box)
+- iidx 09-13: Improved monitor check (but still white screen when in progress. d3d8 doesn't offer
-* iidxfx(2)-exit-hook: Switch off lights on shutdown
+  any text render out of the box)
-* Various other bugfixes
+- iidxfx(2)-exit-hook: Switch off lights on shutdown
+- Various other bugfixes
 
 ## a18
-* Bugfix: forums.php?action=viewthread&threadid=51063
+
-* Various other bugfixes
+- Bugfix: forums.php?action=viewthread&threadid=51063
+- Various other bugfixes
 
 ## a17
-* IIDX 16 support
+
-* Fix broken debug output to file (for iidxhook1-3 and all games using launcher)
+- IIDX 16 support
-* Improve debug output
+- Fix broken debug output to file (for iidxhook1-3 and all games using launcher)
-* Various minor bugfixes
+- Improve debug output
+- Various minor bugfixes
 
 ## a16
-* Add tools.zip which contains various tools for development: ezusb IO related, 
+
-bemanitools API testing, acio related
+- Add tools.zip which contains various tools for development: ezusb IO related, bemanitools API
-* Add documentation (.md files) for tools
+  testing, acio related
-* Add iidxfx(2)-exit-hook.dll: Hook this using either inject or launcher 
+- Add documentation (.md files) for tools
-(depending on the game version) and exit the game by pressing Start P1 + Start 
+- Add iidxfx(2)-exit-hook.dll: Hook this using either inject or launcher (depending on the game
-P2 + VEFX + Effect simultaneously
+  version) and exit the game by pressing Start P1 + Start P2 + VEFX + Effect simultaneously
-* Bugfix iidxio API: 16seg not working on IIDX games with FX2 emulation
+- Bugfix iidxio API: 16seg not working on IIDX games with FX2 emulation
-* Bugfix iidxio API: return value of init call not getting checked in hook 
+- Bugfix iidxio API: return value of init call not getting checked in hook libraries
-libraries
+- SDVX input emulation fixes
-* SDVX input emulation fixes
+- Various other bugfixes
-* Various other bugfixes
 
 ## a15
-* Select best network adapter if having multiple
+
-* Add Felica card detection
+- Select best network adapter if having multiple
-* Fix SDVX HID lighting
+- Add Felica card detection
-* Fix IIDX FX2 deck lighting
+- Fix SDVX HID lighting
+- Fix IIDX FX2 deck lighting
 
 ## a13
-* iidx 15 (DJ Troopers) support
+
-* Fix BG video triangle seam on old games
+- iidx 15 (DJ Troopers) support
-* New options handling: cmd args and options file
+- Fix BG video triangle seam on old games
+- New options handling: cmd args and options file
 
 ## a11
-* Fix nVidia crash on GOLD
+
+- Fix nVidia crash on GOLD
 
 ## a10
-* Adds IO2 emulation for Gold
+
-* Add IO2 translucent mode for Gold ONLY atm (untested due to lack of hardware)
+- Adds IO2 emulation for Gold
-* Random input bug resolved (also kinda untested, so maybe?)
+- Add IO2 translucent mode for Gold ONLY atm (untested due to lack of hardware)
+- Random input bug resolved (also kinda untested, so maybe?)
 
 ## a09
-* Add IIDX 14 support
+
+- Add IIDX 14 support
 
 ## a08
-* Add experimental KFCA (SDVX PCB) support
+
-* Add Sound Voltex and BeatStream builds
+- Add experimental KFCA (SDVX PCB) support
+- Add Sound Voltex and BeatStream builds
 
 ## a07
-* Add IIDX 13 DistorteD support
+
-* Add option to use real card readers with IIDX 13
+- Add IIDX 13 DistorteD support
+- Add option to use real card readers with IIDX 13
 
 ## a06
-* Fixes bug in chart data loader interception code
+
+- Fixes bug in chart data loader interception code
 
 ## a05
-* Fix broken card reader emulation on Copula
+
-* Add monitor check/auto timebase for old IIDX games (9-12) -> refer to the 
+- Fix broken card reader emulation on Copula
-readme file on how to use it
+- Add monitor check/auto timebase for old IIDX games (9-12) -> refer to the readme file on how to
+  use it
 
 ## a04
-* Add software frame rate limiter for all D3D8 based games (-g option).
+
+- Add software frame rate limiter for all D3D8 based games (-g option).
 
 ## a03
-* Add support for IIDX 9-12
+
-* Translucent mode: Use real C02 EZUSB IO hardware
+- Add support for IIDX 9-12
-* eamio-real.dll: Use real slotted or wave pass card readers
+- Translucent mode: Use real C02 EZUSB IO hardware
-* Setup guide, advanced features and FAQ: see readme file iidxhook1.md
+- eamio-real.dll: Use real slotted or wave pass card readers
+- Setup guide, advanced features and FAQ: see readme file iidxhook1.md
 
 ## a02
-* Fonts are always correct irrespective of system locale! (Make sure you 
+
-install East Asian fonts tho)
+- Fonts are always correct irrespective of system locale! (Make sure you install East Asian fonts
-* No longer crashes shitty gaming mice that don't follow the USB spec! (will 
+  tho)
-backport this to bt4)
+- No longer crashes shitty gaming mice that don't follow the USB spec! (will backport this to bt4)
-* launcher.exe now has a UAC manifest! (because 2006 called and told me to get 
+- launcher.exe now has a UAC manifest! (because 2006 called and told me to get with the fucking
-with the fucking program)
+  program)
 
 ## a01
-* Initial Alpha, only supports IIDX 21 and 22 for now.
+
+- Initial Alpha, only supports IIDX 21 and 22 for now.

CONTRIBUTING.md

@@ -0,0 +1,88 @@
+# Contributing
+
+This document outlines different types of contributions and how YOU can help us to improve the
+project. Read it, as it provides guidelines that are there to help you and the maintainers.
+
+## Reporting and discussions: Issues section on gitlab
+
+In order to avoid having to manage ongoing discussions and bug reports on different communication
+channels, e.g. forums, messangers or other closed groups, we ask everyone to treat the issue section
+on gitlab as the place to open their relevant discussions and bug reports regarding the project.
+
+The maintainers of the project do not have the time nor motivation to micromanage on the various
+channels and enter all data here to have it collected. This is a simple task that *ANYONE* can do
+allowing the maintainers and developers to spend their time on the codebase.
+
+## Bug reports
+
+Follow these steps when reporting bugs to ensure you provide all information we *always* need and
+make your report valuable and actionable.
+
+1. On the bemanitools repository, go `Issues` on the left-hand sidebar.
+1. Use the search function to check if there is an already open issue regarding what you want to
+   report
+   1. If that applies, read the open issue to check what's already covered regarding the bug
+   1. Provide additional information or things that are missing. Upload your log files, screenshots,
+      videos etc. Be careful to remove sensitive information like PCBIDs
+   1. Give a thumbs up to the issue to show you are interested/affected as well
+1. If no existing issue avilable, create a new one
+1. Come up with a descriptive title
+1. **USE OUR BUG REPORTING TEMPLATE**: Pick it by selecting `Bug` on the `Description` section
+1. Follow the sections and their instructions provided by the template and fill them in. All fields
+   are mandatory to provide a comprehensive report if not stated otherwise
+1. When finished, submit the issue
+
+## Pull requests: bugfixes, new features or other code contributions
+
+Pull requests are welcome! May it be a merge request to an already known issue or a new feature that
+you consider as a valuable contribution, please open a MR.
+
+**!!! Maintaining documentation by adding new or improving existing documentation is as important as
+code !!!**
+
+If you want to start working on a new feature that was proposed in an issue, yet, it is recommended
+to reach out to the active developers about this, first, to discuss if this contribution is valuable
+to the project. Otherwise, you might waste your time on implementing something that won't make it
+into master.
+
+Please read our [development guidelines](doc/development.md) as they contain valuable information
+that your contribution meets our standards. This is not meant to annoy people but ensures
+consistency that the project stays maintainable for everyone.
+
+Steps for contributing to the repository using a merge request:
+
+1. If you are new to git, take a bit of time to learn the basics which are very simple, e.g. Google
+   for "git tutorial for non-programmers"
+1. Fork the upstream repository (Fork button on the top right on the main page of the repository)
+1. You can start editing files like documentation easily inside gitlab which might be the prefered
+   option for many non-coders
+1. Clone your fork to your local machine and start working on stuff
+1. Ensure you push your changes to your fork on gitlab
+1. When done, go to the `Merge Requests` section on the left sidebar of the upstream repository
+1. Hit the `New merge request` button
+1. Select the `master` branch as the source branch
+1. Select whatever branch you worked, likely `master` if you didn't change that, as the target
+   branch
+1. Hit `Compare branches and continue`
+1. Provide a descriptive title of what your change is about
+1. **USE OUR MR TEMPLATES**
+   1. If you submit a bugfix, use the `Bugfix` tempalte and fill in the sections
+   1. If you submit a new feature, use the `Feature` template and fill in the sections
+1. If you submit some minor fixes or documentation improvements, there is no template for that.
+   Please provide a expressive description what you did and *why* you did that
+1. If any of your changes are tied to one or multiple issues, link them in the description
+1. When done, hit `Submit merge request`
+
+The maintainers will take a look at your submission and provide their feedback. The intention of
+this process is to ensure the contribution meets the quality standards. Please also see this is a
+learning opportunity, especially with your first contribution, if a lot of comments and change
+requests are being made. The maintainers are open to discuss their suggestions/feedback if
+reasonable feedback is given back to them.
+
+Once all discussion is resolved and the involved maintainers approved your submission, it will be
+merged into master and also included in the next release.
+
+## Roadmap
+
+No concrete roadmap or timeline exists. We want to continue adding support for new games as well as
+old games (some of the old games supported by BT4 are not supported, yet).

Dockerfile.build

@@ -0,0 +1,21 @@
+FROM --platform=amd64 debian:11.6-slim@sha256:f7d141c1ec6af549958a7a2543365a7829c2cdc4476308ec2e182f8a7c59b519
+
+LABEL description="Build environment for bemanitools"
+
+# mingw-w64-gcc has 32-bit and 64-bit toolchains
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    mingw-w64 \
+    mingw-w64-common \
+    make \
+    zip \
+    git \
+ && rm -rf /var/lib/apt/lists/*
+
+RUN mkdir /bemanitools
+WORKDIR /bemanitools
+
+ENTRYPOINT [ \
+    "/bin/sh", \
+    "-c" , \
+    "cd /bemanitools && \
+    make" ]

Dockerfile.dev

@@ -0,0 +1,21 @@
+FROM --platform=amd64 debian:11.6-slim@sha256:f7d141c1ec6af549958a7a2543365a7829c2cdc4476308ec2e182f8a7c59b519
+
+LABEL description="Development environment for bemanitools"
+
+# mingw-w64-gcc has 32-bit and 64-bit toolchains
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    mingw-w64 \
+    mingw-w64-common \
+    make \
+    zip \
+    git \
+    clang-format \
+    python3-pip \
+ && rm -rf /var/lib/apt/lists/*
+
+RUN pip3 install mdformat
+
+RUN mkdir /bemanitools
+WORKDIR /bemanitools
+
+ENV SHELL /bin/bash

GNUmakefile

@@ -11,33 +11,119 @@ BUILDDIR        ?= build
 # Internal variables
 #
 
-depdir          := $(BUILDDIR)/dep
+builddir_docker 	  := $(BUILDDIR)/docker
-objdir          := $(BUILDDIR)/obj
-bindir          := $(BUILDDIR)/bin
 
-toolchain_32    := i686-w64-mingw32-
+docker_build_container_name := "bemanitools-build"
-toolchain_64    := x86_64-w64-mingw32-
+docker_build_image_name     := "bemanitools-build:latest"
+docker_dev_container_name := "bemanitools-dev"
+docker_dev_image_name     := "bemanitools-dev:latest"
 
-gitrev          := $(shell git rev-parse HEAD)
+depdir                := $(BUILDDIR)/dep
-cppflags        := -I src -I src/main -I src/test -DGITREV=$(gitrev)
+objdir                := $(BUILDDIR)/obj
-cflags          := -O2 -pipe -ffunction-sections -fdata-sections \
+bindir                := $(BUILDDIR)/bin
-                    -Wall -std=c99
+
-ldflags		:= -Wl,--gc-sections -static-libgcc
+toolchain_32          := i686-w64-mingw32-
+toolchain_64          := x86_64-w64-mingw32-
+
+gitrev                := $(shell git rev-parse HEAD)
+cppflags              := -I src -I src/main -I src/test -DGITREV=$(gitrev)
+cflags                := -O2 -pipe -ffunction-sections -fdata-sections \
+                          -Wall -std=c99 -DPSAPI_VERSION=1
+cflags_release        := -Werror
+ldflags		          := -Wl,--gc-sections -static-libgcc
 
 #
 # The first target that GNU Make encounters becomes the default target.
 # Define our ultimate target (`all') here, and also some helpers
 #
 
-all:
+all: build
+
+FORCE:
+
+.PHONY: \
+build-docker \
+dev-docker \
+clean \
+code-format \
+doc-format \
+print-building \
+print-release \
+run-tests \
+version \
+FORCE
+
+release: \
+print-release \
+clean \
+code-format \
+doc-format \
+all \
+run-tests
+
+build: \
+print-building \
+version
+
+print-building:
+	$(V)echo "Build gitrev "$(gitrev)"..."
+
+print-release:
+	$(V)echo "Starting release build..."
+
+clean:
+	$(V)echo "Cleaning up..."
+	$(V)rm -rf $(BUILDDIR)
+
+code-format:
+	$(V)echo "Applying clang-format..."
+	$(V)find src/main src/test -name '*.c' -o -name '*.h' | xargs clang-format -i -style=file
+
+doc-format:
+	$(V)echo "Applying mdformat on all docs..."
+	$(V)find . -name '*.md' | xargs mdformat --wrap 100
+
+run-tests:
+	$(V)echo "Running tests..."
+	$(V)./run-tests-wine.sh
 
 # Generate a version file to identify the build
 version:
-	@echo "$(gitrev)" > version
+	$(V)echo "$(gitrev)" > version
 
-.PHONY: clean
+build-docker:
+	$(V)docker rm -f $(docker_build_container_name) 2> /dev/null || true
+	$(V)docker \
+		build \
+		-t $(docker_build_image_name) \
+		-f Dockerfile.build \
+		.
+	$(V)docker \
+		run \
+		--volume $(shell pwd):/bemanitools \
+		--name $(docker_build_container_name) \
+		$(docker_build_image_name)
 
-clean:
+dev-docker:
+	$(V)docker rm -f $(docker_dev_container_name) 2> /dev/null || true
+	$(V)docker \
+		build \
+		-t $(docker_dev_image_name) \
+		-f Dockerfile.dev \
+		.
+	$(V)docker \
+		run \
+		--interactive \
+		--tty \
+		--volume $(shell pwd):/bemanitools \
+		--name $(docker_dev_container_name) \
+		$(docker_dev_image_name)
+
+clean-docker:
+	$(V)docker rm -f $(docker_dev_container_name) || true
+	$(V)docker image rm -f $(docker_dev_image_name) || true
+	$(V)docker rm -f $(docker_build_container_name) || true
+	$(V)docker image rm -f $(docker_build_image_name) || true
 	$(V)rm -rf $(BUILDDIR)
 
 #
@@ -54,11 +140,12 @@ libs		:=
 avsdlls		:=
 avsexes		:=
 
+testdlls    :=
 testexes    :=
 
 include Module.mk
 
-modules		:= $(dlls) $(exes) $(libs) $(avsdlls) $(avsexes) $(testexes)
+modules		:= $(dlls) $(exes) $(libs) $(avsdlls) $(avsexes) $(testdlls) $(testexes)
 
 #
 # $1: Bitness
@@ -70,6 +157,7 @@ define t_moddefs
 
 cppflags_$3	+= $(cppflags) -DBUILD_MODULE=$3
 cflags_$3	+= $(cflags)
+release: cflags_$3	+= $(cflags_release)
 ldflags_$3	+= $(ldflags)
 srcdir_$3	?= src/main/$3
 
@@ -94,6 +182,7 @@ $$(eval $$(foreach lib,$(libs),$$(call t_archive,$1,indep,$$(lib))))
 
 $$(eval $$(foreach avsver,$$(avsvers_$1),$$(call t_avsver,$1,$$(avsver))))
 
+$$(eval $$(foreach dll,$(testdlls),$$(call t_linkdll,$1,indep,$$(dll))))
 $$(eval $$(foreach exe,$(testexes),$$(call t_linkexe,$1,indep,$$(exe))))
 
 endef
@@ -133,6 +222,8 @@ $$(depdir_$1_$2_$3):
 $$(objdir_$1_$2_$3):
 	$(V)mkdir -p $$@
 
+$$(volatile_$3:%.c=$$(objdir_$1_$2_$3)/%.o): FORCE
+
 $$(objdir_$1_$2_$3)/%.o: $$(srcdir_$3)/%.c \
 		| $$(depdir_$1_$2_$3) $$(objdir_$1_$2_$3)
 	$(V)echo ... $$@
@@ -174,7 +265,7 @@ $$(dll_$1_$2_$3) $$(implib_$1_$2_$3):	$$(obj_$1_$2_$3) $$(abslib_$1_$2_$3) \
 	$(V)echo ... $$(dll_$1_$2_$3)
 	$(V)$$(toolchain_$1)gcc -shared \
 		-o $$(dll_$1_$2_$3) -Wl,--out-implib,$$(implib_$1_$2_$3) \
-		$$^ $$(ldflags_$3)
+		-Wl,--start-group $$^ -Wl,--end-group $$(ldflags_$3)
 	$(V)$$(toolchain_$1)strip $$(dll_$1_$2_$3)
 	$(V)$$(toolchain_$1)ranlib $$(implib_$1_$2_$3)
 
@@ -204,7 +295,7 @@ impdef_$1_$2_$3	?= src/imports/import_$1_$2_$3.def
 
 $$(bindir_$1_$2)/lib$3.a: $$(impdef_$1_$2_$3) | $$(bindir_$1_$2)
 	$(V)echo ... $$@ [dlltool]
-	$(V)$$(toolchain_$1)dlltool -l $$@ -d $$<
+	$(V)$$(toolchain_$1)dlltool --kill-at -l $$@ -d $$<
 
 endef
 

Module.mk

@@ -21,12 +21,20 @@
 #
 #  4:   Patch 2:    beatmania IIDX 14 GOLD
 #
+#  4:   Patch 3:    pop'n music 15 ADVENTURE
+#
 #  6:   Patch 5:    beatmania IIDX 15 DJ Troopers
 #
+#  7:   Patch 1:    pop'n music 16 PARTY
+#
 #  8:   Patch 3:    beatmania IIDX 16 Empress
 #                   jubeat
 #
-# 10:   Patch 4:    DanceDanceRevolution X2
+#  9:   Patch 0:    pop'n music 17 THE MOVIE
+#
+# 10:   Patch 1:    pop'n music 18 Sengoku Retsuden
+#       Patch 2:    jubeat Knit
+#       Patch 4:    DanceDanceRevolution X2
 #
 # 11:   Patch 1:    beatmania IIDX 18 Resort Anthem
 #                   pop'n music 19 Tune Street
@@ -42,17 +50,23 @@
 # 15:   Patch 8:    DanceDanceRevolution (2013)
 #                   beatmania IIDX 20 tricoro
 #                   pop'n music 21 Sunny Park
-#                   SOUND VOLTEX (all known versions)
+#                   SOUND VOLTEX (1-4)
 #					jubeat prop
 #
 # 16:   Patch 1:    beatmania IIDX 21 SPADA
 #                   beatmania IIDX 22 PENDUAL
 #					beatmania IIDX 23 copula
 #                   beatmania IIDX 24 SINOBUZ
+#       Patch 3:    DanceDanceRevoluion A20+ (64-bit)
 #     "Patch" 3:    Silent Scope Bone Eater (compatible with p7)
 #	  "Patch" 7:    Steel Chronicle VicTroopers (not a Bemani, w/e)
 #
 # 17:   Patch 0:    beatmania IIDX 25 CANNON BALLERS
+#                   beatmania IIDX 26 Rootage
+#                   beatmania IIDX 27 HEROIC VERSE
+#
+#       Patch 3:    SOUND VOLTEX VIVID WAVE
+#
 #
 
 cflags          += \
@@ -66,77 +80,127 @@ cflags          += \
 # Each AVS-dependent project should consume the earliest AVS import definition
 # that is still ABI-compatible with the real build its target links against.
 
-avsvers_32      := 1700 1603 1601 1508 1403 1304 1101 803 0
+avsvers_32      := 1700 1603 1601 1508 1403 1306 1304 1101 1002 803 0
-avsvers_64      := 1700 1603 1601 1508
+avsvers_64      := 1700 1603 1601 1509 1508
 
 imps            += avs avs-ea3
 
 include src/main/aciodrv/Module.mk
+include src/main/aciodrv-proc/Module.mk
 include src/main/acioemu/Module.mk
+include src/main/aciomgr/Module.mk
 include src/main/aciotest/Module.mk
+include src/main/asio/Module.mk
+include src/main/avs-util/Module.mk
+include src/main/bio2drv/Module.mk
+include src/main/bio2emu-iidx/Module.mk
+include src/main/bio2emu/Module.mk
 include src/main/bsthook/Module.mk
 include src/main/bstio/Module.mk
+include src/main/camhook/Module.mk
 include src/main/cconfig/Module.mk
 include src/main/config/Module.mk
-include src/main/ddrhook/Module.mk
+include src/main/d3d9-util/Module.mk
-include src/main/ddrio/Module.mk
+include src/main/d3d9exhook/Module.mk
-include src/main/ddrio-smx/Module.mk
+include src/main/ddrhook-util/Module.mk
+include src/main/ddrhook1/Module.mk
+include src/main/ddrhook2/Module.mk
+include src/main/ddrio-async/Module.mk
+include src/main/ddrio-p3io/Module.mk
 include src/main/ddrio-mm/Module.mk
-include src/main/eamio/Module.mk
+include src/main/ddrio-smx/Module.mk
+include src/main/ddriotest/Module.mk
+include src/main/ddrio/Module.mk
+include src/main/dinput/Module.mk
 include src/main/eamio-icca/Module.mk
+include src/main/eamio/Module.mk
 include src/main/eamiotest/Module.mk
-include src/main/ezusb/Module.mk
+include src/main/extio/Module.mk
+include src/main/extiodrv/Module.mk
+include src/main/extiotest/Module.mk
 include src/main/ezusb-emu/Module.mk
-include src/main/ezusb-iidx/Module.mk
+include src/main/ezusb-iidx-16seg-emu/Module.mk
+include src/main/ezusb-iidx-emu/Module.mk
 include src/main/ezusb-iidx-fpga-flash/Module.mk
 include src/main/ezusb-iidx-sram-flash/Module.mk
+include src/main/ezusb-iidx/Module.mk
 include src/main/ezusb-tool/Module.mk
-include src/main/ezusb2/Module.mk
+include src/main/ezusb/Module.mk
 include src/main/ezusb2-dbg-hook/Module.mk
 include src/main/ezusb2-emu/Module.mk
-include src/main/ezusb2-iidx/Module.mk
 include src/main/ezusb2-iidx-emu/Module.mk
+include src/main/ezusb2-iidx/Module.mk
+include src/main/ezusb2-popn-emu/Module.mk
+include src/main/ezusb2-popn-shim/Module.mk
 include src/main/ezusb2-tool/Module.mk
-include src/main/ezusb-iidx-emu/Module.mk
+include src/main/ezusb2/Module.mk
 include src/main/geninput/Module.mk
 include src/main/hook/Module.mk
 include src/main/hooklib/Module.mk
+include src/main/iidx-bio2-exit-hook/Module.mk
 include src/main/iidx-ezusb-exit-hook/Module.mk
 include src/main/iidx-ezusb2-exit-hook/Module.mk
 include src/main/iidx-irbeat-patch/Module.mk
+include src/main/iidxhook-d3d9/Module.mk
 include src/main/iidxhook-util/Module.mk
 include src/main/iidxhook1/Module.mk
 include src/main/iidxhook2/Module.mk
 include src/main/iidxhook3/Module.mk
 include src/main/iidxhook4/Module.mk
+include src/main/iidxhook4-cn/Module.mk
 include src/main/iidxhook5/Module.mk
+include src/main/iidxhook5-cn/Module.mk
 include src/main/iidxhook6/Module.mk
 include src/main/iidxhook7/Module.mk
 include src/main/iidxhook8/Module.mk
-include src/main/iidxio/Module.mk
+include src/main/iidxhook9/Module.mk
+include src/main/iidxio-bio2/Module.mk
 include src/main/iidxio-ezusb/Module.mk
 include src/main/iidxio-ezusb2/Module.mk
+include src/main/iidxio/Module.mk
 include src/main/iidxiotest/Module.mk
 include src/main/inject/Module.mk
+include src/main/jbio-magicbox/Module.mk
+include src/main/jbio-p4io/Module.mk
 include src/main/jbio/Module.mk
-include src/main/jbhook/Module.mk
+include src/main/jbiotest/Module.mk
+include src/main/jbhook-util/Module.mk
+include src/main/jbhook-util-p3io/Module.mk
 include src/main/jbhook1/Module.mk
+include src/main/jbhook2/Module.mk
+include src/main/jbhook3/Module.mk
 include src/main/launcher/Module.mk
 include src/main/mempatch-hook/Module.mk
 include src/main/mm/Module.mk
 include src/main/p3io/Module.mk
+include src/main/p3iodrv/Module.mk
 include src/main/p3ioemu/Module.mk
+include src/main/p3io-ddr-tool/Module.mk
+include src/main/p4iodrv/Module.mk
 include src/main/p4ioemu/Module.mk
+include src/main/popnhook-util/Module.mk
+include src/main/popnhook1/Module.mk
+include src/main/popnio/Module.mk
 include src/main/pcbidgen/Module.mk
 include src/main/sdvxhook/Module.mk
+include src/main/sdvxhook2-cn/Module.mk
+include src/main/sdvxhook2/Module.mk
+include src/main/sdvxio-bio2/Module.mk
+include src/main/sdvxio-kfca/Module.mk
 include src/main/sdvxio/Module.mk
 include src/main/security/Module.mk
 include src/main/unicorntail/Module.mk
 include src/main/util/Module.mk
 include src/main/vefxio/Module.mk
+include src/main/vigem-iidxio/Module.mk
+include src/main/vigem-sdvxio/Module.mk
+include src/main/vigem-ddrio/Module.mk
+include src/main/vigemstub/Module.mk
 
 include src/test/cconfig/Module.mk
+include src/test/d3d9hook/Module.mk
 include src/test/iidxhook-util/Module.mk
+include src/test/iidxhook8/Module.mk
 include src/test/security/Module.mk
 include src/test/test/Module.mk
 include src/test/util/Module.mk
@@ -152,12 +216,15 @@ $(zipdir)/:
 
 $(zipdir)/tools.zip: \
 		build/bin/indep-32/aciotest.exe \
+		build/bin/indep-32/ddriotest.exe \
 		build/bin/indep-32/eamiotest.exe \
 		build/bin/indep-32/ezusb-iidx-fpga-flash.exe \
 		build/bin/indep-32/ezusb-iidx-sram-flash.exe \
 		build/bin/indep-32/iidxiotest.exe \
+		build/bin/indep-32/iidx-bio2-exit-hook.dll \
 		build/bin/indep-32/iidx-ezusb-exit-hook.dll \
 		build/bin/indep-32/iidx-ezusb2-exit-hook.dll \
+		build/bin/indep-32/jbiotest.exe \
 		build/bin/indep-32/pcbidgen.exe \
 		dist/iidx/ezusb-boot.bat \
 		dist/iidx/ezusb2-boot.bat \
@@ -170,27 +237,25 @@ $(zipdir)/tools.zip: \
 	$(V)zip -j $@ $^
 
 $(zipdir)/tools-x64.zip: \
+		build/bin/indep-64/aciotest.exe \
+		build/bin/indep-64/ddriotest.exe \
 		build/bin/indep-64/eamiotest.exe \
 		build/bin/indep-64/iidxiotest.exe \
+		build/bin/indep-64/iidx-bio2-exit-hook.dll \
 		build/bin/indep-64/iidx-ezusb-exit-hook.dll \
 		build/bin/indep-64/iidx-ezusb2-exit-hook.dll \
+		build/bin/indep-64/jbiotest.exe \
+		build/bin/indep-64/mempatch-hook.dll \
 		| $(zipdir)/
 	$(V)echo ... $@
 	$(V)zip -j $@ $^
 
-$(zipdir)/src.zip: .git/HEAD  $(zipdir)/
-	$(V)echo ... $@
-	$(V)git archive -o $@ HEAD
-
 $(zipdir)/iidx-09-to-12.zip: \
 		build/bin/indep-32/iidxhook1.dll \
 		build/bin/indep-32/config.exe \
 		build/bin/indep-32/eamio.dll \
-		build/bin/indep-32/eamio-icca.dll \
 		build/bin/indep-32/geninput.dll \
 		build/bin/indep-32/iidxio.dll \
-		build/bin/indep-32/iidxio-ezusb.dll \
-		build/bin/indep-32/iidxio-ezusb2.dll \
 		build/bin/indep-32/vefxio.dll \
 		build/bin/indep-32/inject.exe \
 		dist/iidx/config.bat \
@@ -214,11 +279,8 @@ $(zipdir)/iidx-13.zip: \
 		build/bin/avs2_0-32/iidxhook2.dll \
 		build/bin/indep-32/config.exe \
 		build/bin/indep-32/eamio.dll \
-		build/bin/indep-32/eamio-icca.dll \
 		build/bin/indep-32/geninput.dll \
 		build/bin/indep-32/iidxio.dll \
-		build/bin/indep-32/iidxio-ezusb.dll \
-		build/bin/indep-32/iidxio-ezusb2.dll \
 		build/bin/indep-32/vefxio.dll \
 		build/bin/indep-32/inject.exe \
 		dist/iidx/config.bat \
@@ -233,11 +295,8 @@ $(zipdir)/iidx-14-to-17.zip: \
 		build/bin/avs2_0-32/iidxhook3.dll \
 		build/bin/indep-32/config.exe \
 		build/bin/indep-32/eamio.dll \
-		build/bin/indep-32/eamio-icca.dll \
 		build/bin/indep-32/geninput.dll \
 		build/bin/indep-32/iidxio.dll \
-		build/bin/indep-32/iidxio-ezusb.dll \
-		build/bin/indep-32/iidxio-ezusb2.dll \
 		build/bin/indep-32/vefxio.dll \
 		build/bin/indep-32/inject.exe \
 		dist/iidx/config.bat \
@@ -259,11 +318,8 @@ $(zipdir)/iidx-18.zip: \
 		build/bin/avs2_1101-32/launcher.exe \
 		build/bin/indep-32/config.exe \
 		build/bin/indep-32/eamio.dll \
-		build/bin/indep-32/eamio-icca.dll \
 		build/bin/indep-32/geninput.dll \
 		build/bin/indep-32/iidxio.dll \
-		build/bin/indep-32/iidxio-ezusb.dll \
-		build/bin/indep-32/iidxio-ezusb2.dll \
 		build/bin/indep-32/vefxio.dll \
 		dist/iidx/config.bat \
 		dist/iidx/gamestart-18.bat \
@@ -273,16 +329,28 @@ $(zipdir)/iidx-18.zip: \
 	$(V)echo ... $@
 	$(V)zip -j $@ $^
 
+$(zipdir)/iidx-18-cn.zip: \
+		build/bin/avs2_1101-32/iidxhook4-cn.dll \
+		build/bin/indep-32/config.exe \
+		build/bin/indep-32/geninput.dll \
+		build/bin/indep-32/iidxio.dll \
+		build/bin/indep-32/vefxio.dll \
+		build/bin/indep-32/inject.exe \
+		dist/iidx/config.bat \
+		dist/iidx/gamestart-18-cn.bat \
+		dist/iidx/iidxhook-18-cn.conf \
+		dist/iidx/vefx.txt \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
 $(zipdir)/iidx-19.zip: \
 		build/bin/avs2_1304-32/iidxhook5.dll \
 		build/bin/avs2_1304-32/launcher.exe \
 		build/bin/indep-32/config.exe \
 		build/bin/indep-32/eamio.dll \
-		build/bin/indep-32/eamio-icca.dll \
 		build/bin/indep-32/geninput.dll \
 		build/bin/indep-32/iidxio.dll \
-		build/bin/indep-32/iidxio-ezusb.dll \
-		build/bin/indep-32/iidxio-ezusb2.dll \
 		build/bin/indep-32/vefxio.dll \
 		dist/iidx/config.bat \
 		dist/iidx/gamestart-19.bat \
@@ -297,11 +365,8 @@ $(zipdir)/iidx-20.zip: \
 		build/bin/avs2_1508-32/launcher.exe \
 		build/bin/indep-32/config.exe \
 		build/bin/indep-32/eamio.dll \
-		build/bin/indep-32/eamio-icca.dll \
 		build/bin/indep-32/geninput.dll \
 		build/bin/indep-32/iidxio.dll \
-		build/bin/indep-32/iidxio-ezusb.dll \
-		build/bin/indep-32/iidxio-ezusb2.dll \
 		build/bin/indep-32/vefxio.dll \
 		dist/iidx/config.bat \
 		dist/iidx/gamestart-20.bat \
@@ -311,16 +376,28 @@ $(zipdir)/iidx-20.zip: \
 	$(V)echo ... $@
 	$(V)zip -j $@ $^
 
+$(zipdir)/iidx-20-cn.zip: \
+		build/bin/avs2_1304-32/iidxhook5-cn.dll \
+		build/bin/indep-32/config.exe \
+		build/bin/indep-32/geninput.dll \
+		build/bin/indep-32/iidxio.dll \
+		build/bin/indep-32/vefxio.dll \
+		build/bin/indep-32/inject.exe \
+		dist/iidx/config.bat \
+		dist/iidx/gamestart-20-cn.bat \
+		dist/iidx/iidxhook-20-cn.conf \
+		dist/iidx/vefx.txt \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
 $(zipdir)/iidx-21-to-24.zip: \
 		build/bin/avs2_1601-32/iidxhook7.dll \
 		build/bin/avs2_1601-32/launcher.exe \
 		build/bin/indep-32/config.exe \
 		build/bin/indep-32/eamio.dll \
-		build/bin/indep-32/eamio-icca.dll \
 		build/bin/indep-32/geninput.dll \
 		build/bin/indep-32/iidxio.dll \
-		build/bin/indep-32/iidxio-ezusb.dll \
-		build/bin/indep-32/iidxio-ezusb2.dll \
 		build/bin/indep-32/vefxio.dll \
 		dist/iidx/config.bat \
 		dist/iidx/gamestart-21.bat \
@@ -336,25 +413,72 @@ $(zipdir)/iidx-21-to-24.zip: \
 	$(V)echo ... $@
 	$(V)zip -j $@ $^
 
-$(zipdir)/iidx-25.zip: \
+$(zipdir)/iidx-25-to-26.zip: \
 		build/bin/avs2_1700-64/iidxhook8.dll \
 		build/bin/avs2_1700-64/launcher.exe \
 		build/bin/indep-64/config.exe \
 		build/bin/indep-64/eamio.dll \
-		build/bin/indep-64/eamio-icca.dll \
 		build/bin/indep-64/geninput.dll \
 		build/bin/indep-64/iidxio.dll \
-		build/bin/indep-64/iidxio-ezusb.dll \
-        build/bin/indep-64/iidxio-ezusb2.dll \
 		build/bin/indep-64/vefxio.dll \
 		dist/iidx/config.bat \
 		dist/iidx/gamestart-25.bat \
+		dist/iidx/gamestart-26.bat \
 		dist/iidx/iidxhook-25.conf \
+		dist/iidx/iidxhook-26.conf \
 		dist/iidx/vefx.txt \
 		| $(zipdir)/
 	$(V)echo ... $@
 	$(V)zip -j $@ $^
 
+$(zipdir)/iidx-27-to-30.zip: \
+		build/bin/avs2_1700-64/iidxhook9.dll \
+		build/bin/avs2_1700-64/launcher.exe \
+		build/bin/indep-64/config.exe \
+		build/bin/indep-64/eamio.dll \
+		build/bin/indep-64/geninput.dll \
+		build/bin/indep-64/iidxio.dll \
+		build/bin/indep-64/vefxio.dll \
+		dist/iidx/config.bat \
+		dist/iidx/gamestart-27.bat \
+		dist/iidx/gamestart-28.bat \
+		dist/iidx/gamestart-29.bat \
+		dist/iidx/gamestart-30.bat \
+		dist/iidx/iidxhook-27.conf \
+		dist/iidx/iidxhook-28.conf \
+		dist/iidx/iidxhook-29.conf \
+		dist/iidx/iidxhook-30.conf \
+		dist/iidx/vefx.txt \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/iidx-hwio-x86.zip: \
+		build/bin/indep-32/aciomgr.dll \
+		build/bin/indep-32/eamio-icca.dll \
+		build/bin/indep-32/iidxio-bio2.dll \
+		build/bin/indep-32/iidxio-ezusb.dll \
+		build/bin/indep-32/iidxio-ezusb2.dll \
+		dist/iidx/iidxio-bio2.conf \
+		build/bin/indep-32/vigem-iidxio.exe \
+		dist/iidx/vigem-iidxio.conf \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/iidx-hwio-x64.zip: \
+		build/bin/indep-64/aciomgr.dll \
+		build/bin/indep-64/eamio-icca.dll \
+		build/bin/indep-64/iidxio-bio2.dll \
+		build/bin/indep-64/iidxio-ezusb.dll \
+		build/bin/indep-64/iidxio-ezusb2.dll \
+		dist/iidx/iidxio-bio2.conf \
+		build/bin/indep-64/vigem-iidxio.exe \
+		dist/iidx/vigem-iidxio.conf \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
 $(zipdir)/jb-01.zip: \
 		build/bin/avs2_803-32/jbhook1.dll \
 		build/bin/indep-32/inject.exe \
@@ -369,33 +493,84 @@ $(zipdir)/jb-01.zip: \
 	$(V)echo ... $@
 	$(V)zip -j $@ $^
 
+$(zipdir)/jb-02.zip: \
+		build/bin/avs2_1002-32/jbhook1.dll \
+		build/bin/indep-32/inject.exe \
+		build/bin/indep-32/config.exe \
+		build/bin/indep-32/eamio.dll \
+		build/bin/indep-32/geninput.dll \
+		build/bin/indep-32/jbio.dll \
+		dist/jb/config.bat \
+		dist/jb/gamestart-02.bat \
+		dist/jb/jbhook-02.conf \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/jb-03.zip: \
+		build/bin/avs2_1101-32/jbhook2.dll \
+		build/bin/avs2_1101-32/launcher.exe \
+		build/bin/indep-32/config.exe \
+		build/bin/indep-32/eamio.dll \
+		build/bin/indep-32/geninput.dll \
+		build/bin/indep-32/jbio.dll \
+		dist/jb/config.bat \
+		dist/jb/gamestart-03.bat \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/jb-04.zip: \
+		build/bin/avs2_1304-32/jbhook2.dll \
+		build/bin/avs2_1304-32/launcher.exe \
+		build/bin/indep-32/config.exe \
+		build/bin/indep-32/eamio.dll \
+		build/bin/indep-32/geninput.dll \
+		build/bin/indep-32/jbio.dll \
+		dist/jb/config.bat \
+		dist/jb/gamestart-03.bat \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
 $(zipdir)/jb-05-to-07.zip: \
-		build/bin/avs2_1508-32/jbhook.dll \
+		build/bin/avs2_1508-32/jbhook3.dll \
 		build/bin/avs2_1508-32/launcher.exe \
 		build/bin/indep-32/config.exe \
 		build/bin/indep-32/eamio.dll \
 		build/bin/indep-32/geninput.dll \
 		build/bin/indep-32/jbio.dll \
 		dist/jb/config.bat \
-		dist/jb/gamestart.bat \
+		dist/jb/gamestart-04.bat \
 		| $(zipdir)/
 	$(V)echo ... $@
 	$(V)zip -j $@ $^
 
 $(zipdir)/jb-08.zip: \
-		build/bin/avs2_1700-32/jbhook.dll \
+		build/bin/avs2_1700-32/jbhook3.dll \
 		build/bin/avs2_1700-32/launcher.exe \
 		build/bin/indep-32/config.exe \
 		build/bin/indep-32/eamio.dll \
 		build/bin/indep-32/geninput.dll \
 		build/bin/indep-32/jbio.dll \
 		dist/jb/config.bat \
-		dist/jb/gamestart.bat \
+		dist/jb/gamestart-04.bat \
 		| $(zipdir)/
 	$(V)echo ... $@
 	$(V)zip -j $@ $^
 
-$(zipdir)/sdvx.zip: \
+$(zipdir)/jb-hwio.zip: \
+		build/bin/indep-32/aciomgr.dll \
+		build/bin/indep-32/eamio-icca.dll \
+		build/bin/indep-32/jbio-magicbox.dll \
+		build/bin/indep-32/jbio-p4io.dll \
+		dist/jb/jbio-h44b.conf \
+		dist/jb/eamio-icc.conf \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/sdvx-01-to-04.zip: \
 		build/bin/avs2_1508-32/launcher.exe \
 		build/bin/avs2_1508-32/sdvxhook.dll \
 		build/bin/indep-32/config.exe \
@@ -408,10 +583,96 @@ $(zipdir)/sdvx.zip: \
 	$(V)echo ... $@
 	$(V)zip -j $@ $^
 
-$(zipdir)/ddr-12-to-16.zip: \
+$(zipdir)/sdvx-05-to-06.zip: \
-		build/bin/avs2_1508-32/launcher.exe \
+		build/bin/avs2_1700-64/launcher.exe \
-		build/bin/avs2_1508-32/ddrhook.dll \
+		build/bin/avs2_1700-64/sdvxhook2.dll \
-		build/bin/avs2_1508-32/unicorntail.dll \
+		build/bin/indep-64/config.exe \
+		build/bin/indep-64/eamio.dll \
+		build/bin/indep-64/geninput.dll \
+		build/bin/indep-64/sdvxio.dll \
+		dist/sdvx5/config.bat \
+		dist/sdvx5/gamestart.bat \
+		dist/sdvx5/sdvxhook2.conf \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/sdvx-05-cn.zip: \
+		build/bin/avs2_1700-64/launcher.exe \
+		build/bin/avs2_1700-64/sdvxhook2-cn.dll \
+		build/bin/indep-64/config.exe \
+		build/bin/indep-64/eamio.dll \
+		build/bin/indep-64/geninput.dll \
+		build/bin/indep-64/sdvxio.dll \
+		dist/sdvx5/config.bat \
+		dist/sdvx5/gamestart-cn.bat \
+		dist/sdvx5/sdvxhook2-cn.conf \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/sdvx-hwio-x86.zip: \
+		build/bin/indep-32/aciomgr.dll \
+		build/bin/indep-32/eamio-icca.dll \
+		build/bin/indep-32/sdvxio-kfca.dll \
+		build/bin/indep-32/sdvxio-bio2.dll \
+		build/bin/indep-32/vigem-sdvxio.exe \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/sdvx-hwio-x64.zip: \
+		build/bin/indep-64/aciomgr.dll \
+		build/bin/indep-64/eamio-icca.dll \
+		build/bin/indep-64/sdvxio-kfca.dll \
+		build/bin/indep-64/sdvxio-bio2.dll \
+		build/bin/indep-64/vigem-sdvxio.exe \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/ddr-11.zip: \
+		build/bin/indep-32/inject.exe \
+		build/bin/avs2_803-32/ddrhook1.dll \
+		build/bin/avs2_803-32/unicorntail.dll \
+		build/bin/indep-32/config.exe \
+		build/bin/indep-32/ddrio.dll \
+		build/bin/indep-32/ddrio-mm.dll \
+		build/bin/indep-32/ddrio-smx.dll \
+		build/bin/indep-32/eamio.dll \
+		build/bin/indep-32/geninput.dll \
+		dist/ddr/config.bat \
+		dist/ddr/gamestart-11.bat \
+		dist/ddr/gamestart-11-us.bat \
+		dist/ddr/ddr-11.conf \
+		dist/ddr/ddr-11-us.conf \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/ddr-12-us.zip: \
+		build/bin/indep-32/inject.exe \
+		build/bin/avs2_1002-32/ddrhook1.dll \
+		build/bin/avs2_1002-32/unicorntail.dll \
+		build/bin/indep-32/config.exe \
+		build/bin/indep-32/ddrio.dll \
+		build/bin/indep-32/ddrio-mm.dll \
+		build/bin/indep-32/ddrio-smx.dll \
+		build/bin/indep-32/eamio.dll \
+		build/bin/indep-32/geninput.dll \
+		dist/ddr/config.bat \
+		dist/ddr/gamestart-12-us.bat \
+		dist/ddr/gamestart-12-eu.bat \
+		dist/ddr/ddr-12-us.conf \
+		dist/ddr/ddr-12-eu.conf \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/ddr-12.zip: \
+		build/bin/avs2_1002-32/launcher.exe \
+		build/bin/avs2_1002-32/ddrhook2.dll \
+		build/bin/avs2_1002-32/unicorntail.dll \
 		build/bin/indep-32/config.exe \
 		build/bin/indep-32/ddrio.dll \
 		build/bin/indep-32/ddrio-mm.dll \
@@ -420,10 +681,84 @@ $(zipdir)/ddr-12-to-16.zip: \
 		build/bin/indep-32/geninput.dll \
 		dist/ddr/config.bat \
 		dist/ddr/gamestart-12.bat \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/ddr-13.zip: \
+		build/bin/avs2_1306-32/launcher.exe \
+		build/bin/avs2_1306-32/ddrhook2.dll \
+		build/bin/avs2_1306-32/unicorntail.dll \
+		build/bin/indep-32/config.exe \
+		build/bin/indep-32/ddrio.dll \
+		build/bin/indep-32/ddrio-mm.dll \
+		build/bin/indep-32/ddrio-smx.dll \
+		build/bin/indep-32/eamio.dll \
+		build/bin/indep-32/geninput.dll \
+		dist/ddr/config.bat \
 		dist/ddr/gamestart-13.bat \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/ddr-14-to-18.zip: \
+		build/bin/avs2_1508-32/launcher.exe \
+		build/bin/avs2_1508-32/ddrhook2.dll \
+		build/bin/avs2_1508-32/unicorntail.dll \
+		build/bin/indep-32/config.exe \
+		build/bin/indep-32/ddrio.dll \
+		build/bin/indep-32/eamio.dll \
+		build/bin/indep-32/geninput.dll \
+		dist/ddr/config.bat \
+		dist/ddr/gamestart-17.bat \
+		dist/ddr/gamestart-18.bat \
 		dist/ddr/gamestart-14.bat \
 		dist/ddr/gamestart-15.bat \
 		dist/ddr/gamestart-16.bat \
+		dist/ddr/gamestart-17.bat \
+		dist/ddr/gamestart-18.bat \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/ddr-16-to-18-x64.zip: \
+		build/bin/avs2_1603-64/launcher.exe \
+		build/bin/avs2_1603-64/ddrhook2.dll \
+		build/bin/avs2_1603-64/unicorntail.dll \
+		build/bin/indep-64/config.exe \
+		build/bin/indep-64/ddrio.dll \
+		build/bin/indep-64/eamio.dll \
+		build/bin/indep-64/geninput.dll \
+		dist/ddr/config.bat \
+		dist/ddr/gamestart-17.bat \
+		dist/ddr/gamestart-18.bat \
+		dist/ddr/gamestart-16.bat \
+		dist/ddr/gamestart-17.bat \
+		dist/ddr/gamestart-18.bat \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/ddr-hwio-x86.zip: \
+		build/bin/indep-32/ddrio-async.dll \
+		build/bin/indep-32/ddrio-p3io.dll \
+		build/bin/indep-32/ddrio-mm.dll \
+		build/bin/indep-32/ddrio-smx.dll \
+		build/bin/indep-32/extiotest.exe \
+		build/bin/indep-32/p3io-ddr-tool.exe \
+		build/bin/indep-32/vigem-ddrio.exe \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
+$(zipdir)/ddr-hwio-x64.zip: \
+		build/bin/indep-64/ddrio-async.dll \
+		build/bin/indep-64/ddrio-p3io.dll \
+		build/bin/indep-64/ddrio-mm.dll \
+		build/bin/indep-64/ddrio-smx.dll \
+		build/bin/indep-64/extiotest.exe \
+		build/bin/indep-64/p3io-ddr-tool.exe \
+		build/bin/indep-64/vigem-ddrio.exe \
 		| $(zipdir)/
 	$(V)echo ... $@
 	$(V)zip -j $@ $^
@@ -442,10 +777,29 @@ $(zipdir)/bst.zip: \
 	$(V)echo ... $@
 	$(V)zip -j $@ $^
 
+$(zipdir)/popn-15-to-18.zip: \
+		build/bin/avs2_803-32/popnhook1.dll \
+		build/bin/indep-32/config.exe \
+		build/bin/indep-32/inject.exe \
+		build/bin/indep-32/geninput.dll \
+		build/bin/indep-32/eamio.dll \
+		build/bin/indep-32/popnio.dll \
+		build/bin/indep-32/ezusb2-popn-shim.dll \
+		dist/popn/config.bat \
+		dist/popn/gamestart-15.bat \
+		dist/popn/gamestart-16.bat \
+		dist/popn/gamestart-17.bat \
+		dist/popn/gamestart-18.bat \
+		dist/popn/popnhook-15.conf \
+		dist/popn/popnhook-16.conf \
+		dist/popn/popnhook-17.conf \
+		dist/popn/popnhook-18.conf \
+		| $(zipdir)/
+	$(V)echo ... $@
+	$(V)zip -j $@ $^
+
 $(zipdir)/doc.zip: \
-		doc/iidxhook \
+		doc/ \
-		doc/jbhook \
-		doc/tools \
 		| $(zipdir)/
 	$(V)echo ... $@
 	$(V)zip -r $@ $^
@@ -456,10 +810,13 @@ $(BUILDDIR)/tests.zip: \
 		build/bin/indep-32/cconfig-test.exe \
 		build/bin/indep-32/cconfig-util-test.exe \
 		build/bin/indep-32/cconfig-cmd-test.exe \
+		build/bin/indep-32/d3d9hook.dll \
+		build/bin/indep-32/d3d9hook-test.exe \
 		build/bin/indep-32/iidxhook-util-config-eamuse-test.exe \
 		build/bin/indep-32/iidxhook-util-config-gfx-test.exe \
 		build/bin/indep-32/iidxhook-util-config-misc-test.exe \
 		build/bin/indep-32/iidxhook-util-config-sec-test.exe \
+		build/bin/indep-32/inject.exe \
 		build/bin/indep-32/security-id-test.exe \
 		build/bin/indep-32/security-mcode-test.exe \
 		build/bin/indep-32/security-rp-test.exe \
@@ -467,6 +824,7 @@ $(BUILDDIR)/tests.zip: \
 		build/bin/indep-32/security-rp3-test.exe \
 		build/bin/indep-32/security-util-test.exe \
 		build/bin/indep-32/util-net-test.exe \
+		build/bin/indep-64/iidxhook8-config-cam-test.exe \
 		dist/test/run-tests.sh \
 		| $(zipdir)/
 	$(V)echo ... $@
@@ -474,21 +832,41 @@ $(BUILDDIR)/tests.zip: \
 
 $(BUILDDIR)/bemanitools.zip: \
 		$(zipdir)/bst.zip \
-		$(zipdir)/ddr-12-to-16.zip \
+		$(zipdir)/ddr-11.zip \
+		$(zipdir)/ddr-12.zip \
+		$(zipdir)/ddr-12-us.zip \
+		$(zipdir)/ddr-13.zip \
+		$(zipdir)/ddr-14-to-18.zip \
+		$(zipdir)/ddr-16-to-18-x64.zip \
+		$(zipdir)/ddr-hwio-x86.zip \
+		$(zipdir)/ddr-hwio-x64.zip \
 		$(zipdir)/doc.zip \
 		$(zipdir)/iidx-09-to-12.zip \
 		$(zipdir)/iidx-13.zip \
 		$(zipdir)/iidx-14-to-17.zip \
 		$(zipdir)/iidx-18.zip \
+		$(zipdir)/iidx-18-cn.zip \
 		$(zipdir)/iidx-19.zip \
 		$(zipdir)/iidx-20.zip \
+		$(zipdir)/iidx-20-cn.zip \
 		$(zipdir)/iidx-21-to-24.zip \
-		$(zipdir)/iidx-25.zip \
+		$(zipdir)/iidx-25-to-26.zip \
+		$(zipdir)/iidx-27-to-30.zip \
+		$(zipdir)/iidx-hwio-x86.zip \
+		$(zipdir)/iidx-hwio-x64.zip \
 		$(zipdir)/jb-01.zip \
+		$(zipdir)/jb-02.zip \
+		$(zipdir)/jb-03.zip \
+		$(zipdir)/jb-04.zip \
 		$(zipdir)/jb-05-to-07.zip \
 		$(zipdir)/jb-08.zip \
-		$(zipdir)/src.zip \
+		$(zipdir)/jb-hwio.zip \
-		$(zipdir)/sdvx.zip \
+		$(zipdir)/popn-15-to-18.zip \
+		$(zipdir)/sdvx-01-to-04.zip \
+		$(zipdir)/sdvx-05-to-06.zip \
+		$(zipdir)/sdvx-05-cn.zip \
+		$(zipdir)/sdvx-hwio-x86.zip \
+		$(zipdir)/sdvx-hwio-x64.zip \
 		$(zipdir)/tools.zip \
 		$(zipdir)/tools-x64.zip \
 		CHANGELOG.md \

README.md

@@ -1,107 +1,189 @@
 # Bemanitools 5
-Version: 5.26</br>
-[Release history](CHANGELOG.md)
 
-A collection of tools to run [various Bemani arcade games](#list-of-supported-games).
+Version: `5.49`
 
-Bemanitools 5 (BT5) is the successor to Bemanitools 4 which introduces a big code cleanup and support for newer games.
+[Changelog](CHANGELOG.md)
-BT5 uses a cleaner approach than BT4 did; specifically, all input and lighting is handled by emulating the protocols
-spoken by the real IO PCBs, instead of replacing chunks of game code like BT4. The benefits of this approach are a more
-authentic gameplay experience, and easier support for a broader range of releases from each game series.
 
-# List of supported games
+A collection of tools to run [various Bemani arcade games](#supported-games).
-* BeatStream
-    * BeatStream (bst.zip)
-    * BeatStream アニムトライヴ (bst.zip)
-* Dance Dance Revolution
-    * Dance Dance Revolution X2 (ddr-12-to-16.zip)
-    * Dance Dance Revolution X3 vs. 2ndMIX (ddr-12-to-16.zip)
-    * Dance Dance Revolution 2013 (ddr-12-to-16.zip)
-    * Dance Dance Revolution 2014 (ddr-12-to-16.zip)
-    * Dance Dance Revolution A (ddr-12-to-16.zip)
-* Beatmania IIDX
-    * Beatmania IIDX 9th Style (iidx-09-to-12.zip)
-    * Beatmania IIDX 10th Style (iidx-09-to-12.zip)
-    * Beatmania IIDX 11 IIDX RED (iidx-09-to-12.zip)
-    * Beatmania IIDX 12 HAPPY SKY (iidx-09-to-12.zip)
-    * Beatmania IIDX 13 DistorteD (iidx-13.zip)
-    * Beatmania IIDX 14 GOLD (iidx-14-to-17.zip)
-    * Beatmania IIDX 15 DJ TROOPERS (iidx-14-to-17.zip)
-    * Beatmania IIDX 16 EMPRESS (iidx-14-to-17.zip)
-    * Beatmania IIDX 17 SIRIUS (iidx-14-to-17.zip)
-    * Beatmania IIDX 18 Resort Anthem (iidx-18.zip)
-    * Beatmania IIDX 19 Lincle (iidx-19.zip)
-    * Beatmania IIDX 20 Tricoro (iidx-20.zip)
-    * Beatmania IIDX 21 SPADA (iidx-21-to-24.zip)
-    * Beatmania IIDX 22 PENDUAL (iidx-21-to-24.zip)
-    * Beatmania IIDX 23 copula (iidx-21-to-24.zip)
-    * Beatmania IIDX 24 SINOBUZ (iidx-21-to-24.zip)
-    * Beatmania IIDX 25 CANNON BALLERS (iidx-25.zip)
-* jubeat
-    * jubeat (experimental/buggy) (jb-01.zip)
-    * jubeat saucer (fulfill) (jb-05-to-07.zip)
-    * jubeat prop (jb-05-to-07.zip)
-    * jubeat Qubell (jb-05-to-07.zip)
-    * jubeat clan (jb-08.zip)
-* SOUND VOLTEX
-    * SOUND VOLTEX BOOTH (sdvx.zip)
-    * SOUND VOLTEX II -infinite infection- (sdvx.zip)
-    * SOUND VOLTEX III GRAVITY WARS (sdvx.zip)
-    * SOUND VOLTEX IV HEAVENLY HAVEN (sdvx.zip)
 
-# Supported platforms
+Bemanitools 5 (BT5) is the successor to Bemanitools 4 which introduces a big code cleanup and
-Our main platforms are currently Windows XP and Windows 7 which are also the target platforms on the original hardware
+support for newer games. BT5 uses a cleaner approach than BT4 did; specifically, all input and
-of those games. However, as it gets more difficult to get and maintain hardware comptible with Windows XP, this might
+lighting is handled by emulating the protocols spoken by the real IO PCBs, instead of replacing
-change in the future. Many games also run on very recent Windows 10 builds but bear with us that it's hard to keep up
+chunks of game code like BT4. The benefits of this approach are a more authentic gameplay
-with Windows updates breaking legacy software.
+experience, and easier support for a broader range of releases from each game series.
 
-# Distribution contents
+## Documentation
-Check the [list of supported games](#list-of-supported-games) to grab the right files for your game. BT5 also includes
-a *tools* subpackage (tools.zip) as well as the full source code (src.zip).
 
-You will find *.md files in various sub-packages that give you further instructions for setup, usage, error information
+Browse our [documentation](doc/README.md) as it might already cover various questions and concerns
-or FAQ. We advice you to read them as your questions and concerns might already be answered by them. If not, let us
+you are looking for or about to ask.
-know if there is any information that you consider helpful or important to know and should be added.
+
+## Contributions and bug reporting
+
+[Read the dedicated CONTRIBUTING.md documentation](CONTRIBUTING.md).
+
+The tl;dr version and golden rules of the sections in the document:
+
+- **EVERYONE** can contribute, this is **NOT** limited to people coding
+- [Open an issue on gitlab for discussions, feature requests and bug reports](CONTRIBUTING.md#reporting-and-discussions-issues-section-on-github)
+- [ALWAYS report bugs as issues and ALWAYS use the available bug template](CONTRIBUTING.md#bug-reports)
+- [Everyone is allowed to submit changes which are not just limited to code by opening merge requests](CONTRIBUTING.md#pull-requests-bugfixes-new-features-or-other-code-contributions)
+- [Documentation improvements can and even should be contributed by non developers](CONTRIBUTING.md#pull-requests-bugfixes-new-features-or-other-code-contributions)
+
+## Supported games
+
+The following games are supported with their corresponding hook-libraries.
+
+- BeatStream
+  - BeatStream (`bst.zip`): bsthook
+  - BeatStream アニムトライヴ (`bst.zip`): bsthook
+- [Dance Dance Revolution](doc/ddrhook/README.md)
+  - Dance Dance Revolution X (`ddr-11.zip`): [ddrhook1](doc/ddrhook/ddrhook1.md)
+  - Dance Dance Revolution X2 (US/EU regions) (`ddr-12-us.zip`): [ddrhook1](doc/ddrhook/ddrhook1.md)
+  - Dance Dance Revolution X2 (JP region) (`ddr-12.zip`): [ddrhook2](doc/ddrhook/ddrhook2.md)
+  - Dance Dance Revolution X3 vs. 2ndMIX (`ddr-13.zip`): [ddrhook2](doc/ddrhook/ddrhook2.md)
+  - Dance Dance Revolution 2013 (`ddr-14-to-18.zip`): [ddrhook2](doc/ddrhook/ddrhook2.md)
+  - Dance Dance Revolution 2014 (`ddr-14-to-18.zip`): [ddrhook2](doc/ddrhook/ddrhook2.md)
+  - Dance Dance Revolution A (`ddr-14-to-18.zip`): [ddrhook2](doc/ddrhook/ddrhook2.md)
+  - Dance Dance Revolution A20 (`ddr-14-to-18.zip`): [ddrhook2](doc/ddrhook/ddrhook2.md)
+  - Dance Dance Revolution A20+ (`ddr-14-to-18.zip`): [ddrhook2](doc/ddrhook/ddrhook2.md)
+- [Beatmania IIDX](doc/iidxhook/README.md)
+  - Beatmania IIDX 9th Style (`iidx-09-to-12.zip`): [iidxhook1](doc/iidxhook/iidxhook1.md)
+  - Beatmania IIDX 10th Style (`iidx-09-to-12.zip`): [iidxhook1](doc/iidxhook/iidxhook1.md)
+  - Beatmania IIDX 11 IIDX RED (`iidx-09-to-12.zip`): [iidxhook1](doc/iidxhook/iidxhook1.md)
+  - Beatmania IIDX 12 HAPPY SKY (`iidx-09-to-12.zip`): [iidxhook1](doc/iidxhook/iidxhook1.md)
+  - Beatmania IIDX 13 DistorteD (`iidx-13.zip`): [iidxhook2](doc/iidxhook/iidxhook2.md)
+  - Beatmania IIDX 14 GOLD (`iidx-14-to-17.zip`): [iidxhook3](doc/iidxhook/iidxhook3.md)
+  - Beatmania IIDX 15 DJ TROOPERS (`iidx-14-to-17.zip`): [iidxhook3](doc/iidxhook/iidxhook3.md)
+  - Beatmania IIDX 16 EMPRESS (`iidx-14-to-17.zip`): [iidxhook3](doc/iidxhook/iidxhook3.md)
+  - Beatmania IIDX 17 SIRIUS (`iidx-14-to-17.zip`): [iidxhook3](doc/iidxhook/iidxhook3.md)
+  - Beatmania IIDX 18 Resort Anthem (`iidx-18.zip`): [iidxhook4](doc/iidxhook/iidxhook4.md)
+  - Beatmania IIDX 19 Lincle (`iidx-19.zip`): [iidxhook5](doc/iidxhook/iidxhook5.md)
+  - Beatmania IIDX tricoro CN (狂热节拍 IIDX 2) (`iidx-20-cn.zip`):
+    [iidxhook5-cn](doc/iidxhook/iidxhook5-cn.md)
+  - Beatmania IIDX 20 Tricoro (`iidx-20.zip`): [iidxhook6](doc/iidxhook/iidxhook6.md)
+  - Beatmania IIDX 21 SPADA (`iidx-21-to-24.zip`): [iidxhook7](doc/iidxhook/iidxhook7.md)
+  - Beatmania IIDX 22 PENDUAL (`iidx-21-to-24.zip`): [iidxhook7](doc/iidxhook/iidxhook7.md)
+  - Beatmania IIDX 23 copula (`iidx-21-to-24.zip`): [iidxhook7](doc/iidxhook/iidxhook7.md)
+  - Beatmania IIDX 24 SINOBUZ (`iidx-21-to-24.zip`): [iidxhook7](doc/iidxhook/iidxhook7.md)
+  - Beatmania IIDX 25 CANNON BALLERS (`iidx-25-to-26.zip`): [iidxhook8](doc/iidxhook/iidxhook8.md)
+  - Beatmania IIDX 26 Rootage (`iidx-25-to-26.zip`): [iidxhook8](doc/iidxhook/iidxhook8.md)
+  - Beatmania IIDX 27 Heroic Verse (`iidx-27-to-30.zip`): [iidxhook9](doc/iidxhook/iidxhook9.md)
+  - Beatmania IIDX 28 BISTROVER (`iidx-27-to-30.zip`): [iidxhook9](doc/iidxhook/iidxhook9.md)
+  - Beatmania IIDX 29 CASTHOUR (`iidx-27-to-30.zip`): [iidxhook9](doc/iidxhook/iidxhook9.md)
+  - Beatmania IIDX 30 RESIDENT (`iidx-27-to-30.zip`): [iidxhook9](doc/iidxhook/iidxhook9.md)
+- [jubeat](doc/jbhook/README.md)
+  - jubeat (`jb-01.zip`): [jbhook1](doc/jbhook/jbhook1.md)
+  - jubeat ripples (`jb-02.zip`): [jbhook1](doc/jbhook/jbhook1.md)
+  - jubeat knit (`jb-03.zip`): [jbhook2](doc/jbhook/jbhook2.md)
+  - jubeat copious (`jb-04.zip`): [jbhook2](doc/jbhook/jbhook2.md)
+  - jubeat saucer (fulfill) (`jb-05-to-07.zip`): [jbhook3](doc/jbhook/jbhook3.md)
+  - jubeat prop (`jb-05-to-07.zip`): [jbhook3](doc/jbhook/jbhook3.md)
+  - jubeat qubell (`jb-05-to-07.zip`): [jbhook3](doc/jbhook/jbhook3.md)
+  - jubeat clan (`jb-08.zip`): [jbhook3](doc/jbhook/jbhook3.md)
+  - jubeat festo (`jb-08.zip`): [jbhook3](doc/jbhook/jbhook3.md)
+- [pop'n music](doc/popnhook/README.md)
+  - pop'n music 15 ADVENTURE (`popn-15-to-18.zip`) using [popnhook1](doc/popnhook/popnhook1.md)
+  - pop'n music 16 PARTY♪ (`popn-15-to-18.zip`) using [popnhook1](doc/popnhook/popnhook1.md)
+  - pop'n music 17 THE MOVIE (`popn-15-to-18.zip`) using [popnhook1](doc/popnhook/popnhook1.md)
+  - pop'n music 18 せんごく列伝 (`popn-15-to-18.zip`) using [popnhook1](doc/popnhook/popnhook1.md)
+- SOUND VOLTEX
+  - SOUND VOLTEX BOOTH (`sdvx-01-to-04.zip`): sdvxhook
+  - SOUND VOLTEX II -infinite infection- (`sdvx-01-to-04.zip`): sdvxhook
+  - SOUND VOLTEX III GRAVITY WARS (`sdvx-01-to-04.zip`): sdvxhook
+  - SOUND VOLTEX IV HEAVENLY HAVEN (`sdvx-01-to-04.zip`): sdvxhook
+  - SOUND VOLTEX Vivid Wave (`sdvx-05-to-06`): sdvxhook2
+  - SOUND VOLTEX EXCEED GEAR (`sdvx-05-to-06`): sdvxhook2
+
+## Auxiliary tooling
+
+- Bootstrapping
+  - [inject](doc/inject.md): Inject arbitrary hooking libraries into a target application process.
+  - [launcher](doc/launcher.md): Bootstrap Konami's AVS environment and launch a target application
+    with arbitrary injected hooking libraries.
+- Beatmnia IIDX Ezusb IO board
+  - [ezusb-iidx-fpga-flash](doc/tools/ezusb-iidx-fpga-flash.md): Flash a binary blob with FPGA
+    firmware to a target ezusb FX IO board
+  - [ezusb-iidx-sram-flash](doc/tools/ezusb-iidx-sram-flash.md): Flash a binary blob with SRAM
+    contents to a target ezusb FX2 IO board
+- Exit hooks: Exit the game with a button combination using native cabinet inputs
+  - [iidx-ezusb-exit-hook](doc/tools/iidx-ezusb-exit-hook.md): For IIDX with ezusb IO
+  - [iidx-bio2-exit-hook](doc/tools/iidx-bio2-exit-hook.md): For IIDX with BIO2 IO
+  - [iidx-ezusb2-exit-hook](doc/tools/iidx-ezusb-exit-hook.md): For IIDX with ezusb FX2 IO
+- Bemanitools API testing: Tools for testing bemanitools API implementations
+  - [ddriotest](doc/tools/ddriotest.md): For [ddrio API](doc/api.md#io-boards)
+  - [eamiotest](doc/tools/eamiotest.md): For [eamio API](doc/api.md#eamuse-readers)
+  - [iidxiotest](doc/tools/iidxiotest.md): For [iidxio API](doc/api.md#io-boards)
+  - [jbiotest](doc/tools/jbiotest.md): For [jbio API](doc/api.md#io-boards)
+- DDR IO testing: Tools for testing hardware of a real DDR cabinet
+  - [p3io-ddr-tool](doc/tools/p3io-ddr-tool.md)
+  - [extiotest](doc/tools/extiotest.md)
+- [aciotest](doc/tools/aciotest.md): Command line tool to quickly test ACIO devices
+- config: UI input/output configuration tool when using the default bemanitools API (geninput)
+- ir-beat-patch-9/10: Patch the IR beat phase on IIDX 9 and 10
+- [mempatch-hook](doc/tools/mempatch-hook.md): Patch raw memory locations in the target process
+  based on the provided configuration
+- [pcbidgen](doc/tools/pcbidgen.md): Konami PCBID generator tool
+- [ViGEm clients](doc/vigem/README.md): Expose BT5 APIs as XBOX game controllers to play any games
+  with real cabinet hardware.
+
+## Pre-requisites
+
+### Supported platforms
+
+Our main platforms are currently Windows XP and Windows 7 which are also the target platforms on the
+original hardware of those games. However, as it gets more difficult to get and maintain hardware
+comptible with Windows XP, this might change in the future. Many games also run on very recent
+Windows 10 builds but bear with us that it's hard to keep up with Windows updates breaking legacy
+software.
+
+### Distribution contents
+
+Check the [list of supported games](#supported-games) to grab the right files for your game. BT5
+also includes a *tools* subpackage (tools.zip) as well as the full source code (src.zip).
+
+You will find \*.md files in various sub-packages that give you further instructions for setup,
+usage, error information or FAQ. We advice you to read them as your questions and concerns might
+already be answered by them. If not, let us know if there is any information that you consider
+helpful or important to know and should be added.
+
+### Setup and dependencies
+
+Most (older generation) games were developed for Windows XP Embedded but should run fine on any
+consumer version of Windows XP. Newer versions of Windows, e.g. Windows 7, 8 and 10, should be fine
+as well. Some hooks also include fixes required to run the games on a more recent version.
+
+Depending on the game, you also need the following dependencies installed:
+
+- The 32-bit (x86) version of
+  [Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package MFC Security Update](https://www.microsoft.com/en-sg/download/details.aspx?id=26999)
+- The 32-bit (x86) and 64-bit (x64) versions of
+  [Microsoft Visual C++ Redistributable Packages for Visual Studio 2013](https://www.microsoft.com/en-sg/download/details.aspx?id=40784)
+- The
+  [DirectX 9 End-User Runtimes (June 2010)](https://www.microsoft.com/en-us/download/details.aspx?id=8109)
+
+See also [bemanitools-supplement](https://www.github.com/djhackersdev/bemanitools-supplement/) for
+files.
+
+## Development
+
+### Building
+
+See the [development document](doc/development.md).
+
+### Architecture
+
+A dedicate [architecture document](doc/architecture.md) outlines the architecture of Bemanitools and
+points out the most important aspects you should know before you get started with development.
+
+### API
 
-# Development
-## API
 Please refer to the [API documentation](doc/api.md).
 
-## Source Code
+## Release process
-The source code is included with this distribution package (src.zip). Please refer to the
-[development document](doc/development.md) for further details.
-
-## Bugs and TODOs
-We have our own issue tracker for this. If you want to contribute or have any bugs to report, please reach out to us on
-the various channels we are available on. Please help us by providing a detailed description of your concern including:
-* The version of bemanitools you are using
-* The games affected including version
-* Log output of bemanitools and the game
-* The APIs you have been using with bemanitools, e.g. iidxio-keyboard, eamio-keyboard.
-* The OS version you are running this on
-* Specs of your hardware including CPU, RAM, GPU
-* A detailed description of your issue. Describe the symptoms and the steps to trigger and reproduce them. Videos and
-screenshots might be helpful depending on the issue.
-
-## Contributions
-Patches are welcome! Let us know if you have any contributions, e.g. bugfixes, and send us a patch file. Please read
-our [development guidelines](doc/development.md) as they contain valuable information that your contribution meets our
-standards. 
-
-Once submitted, we will review your contribution and get back to you about any changes or when we merge them to our
-upstream repository. Your changes, once approved, will be included in the next release.
-
-## Roadmap 
-No concrete roadmap or timeline exists. We want to continue adding support for new games as well as old games (some of
-the old games supported by BT4 are not supported, yet). However, our time and workforce is limited. If you are
-interested in contributing, please check the [contribution section](#contributions).
-
-# License
-Source code license is the Unlicense; you are permitted to do with this as thou wilt. For details, please refer to the
-[LICENSE file](LICENSE) included with the source code.
-
-
-
 
+Please refer to the [dedicated documentation](doc/release-process.md).
 
+## License
 
+Source code license is the Unlicense; you are permitted to do with this as thou wilt. For details,
+please refer to the [LICENSE file](LICENSE) included with the source code.

dist/bst/config.bat

@@ -1 +1 @@
-@start config bst
+@start config.exe bst

dist/ddr/config.bat

@@ -1 +1 @@
-@start config ddr
+@start config.exe ddr

dist/ddr/ddr-11-us.conf

@@ -0,0 +1,32 @@
+# 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=0101020304050607086F
+
+# EAMID
+eamuse.eamid=0101020304050607086F
+
+# Mcode of the game to run.
+security.mcode=GQHDXUAA
+
+# Emulate P3IO COM4 and its downstream devices. Uses the Windows COM4 port when disabled.
+ddrhook1.use_com4_emu=true
+
+# SD cabinet mode
+ddrhook1.standard_def=false
+
+# Use 15 kHz monitor mode
+ddrhook1.use_15khz=false
+
+# Enable USB memory data emulation
+ddrhook1.usbmem_enabled=false
+
+# Specify path for P1 USB memory data
+ddrhook1.usbmem_path_p1=usbmem_p1
+
+# Specify path for P2 USB memory data
+ddrhook1.usbmem_path_p2=usbmem_p2
+
+# Run the game windowed
+gfx.windowed=false

dist/ddr/ddr-11.conf

@@ -0,0 +1,32 @@
+# 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=0101020304050607086F
+
+# EAMID
+eamuse.eamid=0101020304050607086F
+
+# Mcode of the game to run.
+security.mcode=GQHDXJAA
+
+# Emulate P3IO COM4 and its downstream devices. Uses the Windows COM4 port when disabled.
+ddrhook1.use_com4_emu=true
+
+# SD cabinet mode
+ddrhook1.standard_def=false
+
+# Use 15 kHz monitor mode
+ddrhook1.use_15khz=false
+
+# Enable USB memory data emulation
+ddrhook1.usbmem_enabled=false
+
+# Specify path for P1 USB memory data
+ddrhook1.usbmem_path_p1=usbmem_p1
+
+# Specify path for P2 USB memory data
+ddrhook1.usbmem_path_p2=usbmem_p2
+
+# Run the game windowed
+gfx.windowed=false

dist/ddr/ddr-12-eu.conf

@@ -0,0 +1,32 @@
+# 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=0101020304050607086F
+
+# EAMID
+eamuse.eamid=0101020304050607086F
+
+# Mcode of the game to run.
+security.mcode=GQJDXEAA
+
+# Emulate P3IO COM4 and its downstream devices. Uses the Windows COM4 port when disabled.
+ddrhook1.use_com4_emu=true
+
+# SD cabinet mode
+ddrhook1.standard_def=false
+
+# Use 15 kHz monitor mode
+ddrhook1.use_15khz=false
+
+# Enable USB memory data emulation
+ddrhook1.usbmem_enabled=false
+
+# Specify path for P1 USB memory data
+ddrhook1.usbmem_path_p1=usbmem_p1
+
+# Specify path for P2 USB memory data
+ddrhook1.usbmem_path_p2=usbmem_p2
+
+# Run the game windowed
+gfx.windowed=false

dist/ddr/ddr-12-us.conf

@@ -0,0 +1,32 @@
+# 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=0101020304050607086F
+
+# EAMID
+eamuse.eamid=0101020304050607086F
+
+# Mcode of the game to run.
+security.mcode=GQJDXUAA
+
+# Emulate P3IO COM4 and its downstream devices. Uses the Windows COM4 port when disabled.
+ddrhook1.use_com4_emu=true
+
+# SD cabinet mode
+ddrhook1.standard_def=false
+
+# Use 15 kHz monitor mode
+ddrhook1.use_15khz=false
+
+# Enable USB memory data emulation
+ddrhook1.usbmem_enabled=false
+
+# Specify path for P1 USB memory data
+ddrhook1.usbmem_path_p1=usbmem_p1
+
+# Specify path for P2 USB memory data
+ddrhook1.usbmem_path_p2=usbmem_p2
+
+# Run the game windowed
+gfx.windowed=false

dist/ddr/gamestart-11-us.bat

@@ -0,0 +1,11 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist conf\nvram mkdir conf\nvram
+if not exist conf\raw mkdir conf\raw
+
+regsvr32 /s com\CLVsd.ax
+regsvr32 /s com\xactengine2_10.dll
+
+inject ddrhook1.dll DDR.exe --config ddr-11-us.conf %*

dist/ddr/gamestart-11.bat

@@ -0,0 +1,11 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist conf\nvram mkdir conf\nvram
+if not exist conf\raw mkdir conf\raw
+
+regsvr32 /s com\CLVsd.ax
+regsvr32 /s com\xactengine2_10.dll
+
+inject ddrhook1.dll DDR.exe --config ddr-11.conf %*

dist/ddr/gamestart-12-eu.bat

@@ -0,0 +1,11 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist conf\nvram mkdir conf\nvram
+if not exist conf\raw mkdir conf\raw
+
+regsvr32 /s com\CLVsd.ax
+regsvr32 /s com\xactengine2_10.dll
+
+inject ddrhook1.dll DDR.exe --config ddr-12-eu.conf %*

dist/ddr/gamestart-12-us.bat

@@ -0,0 +1,11 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist conf\nvram mkdir conf\nvram
+if not exist conf\raw mkdir conf\raw
+
+regsvr32 /s com\CLVsd.ax
+regsvr32 /s com\xactengine2_10.dll
+
+inject ddrhook1.dll DDR.exe --config ddr-12-us.conf %*

dist/ddr/gamestart-12.bat

@@ -8,4 +8,4 @@ if not exist conf\raw mkdir conf\raw
 regsvr32 /s k-clvsd.dll
 regsvr32 /s xactengine2_10.dll
 
-.\launcher.exe -K .\ddrhook.dll .\ddr.dll %*
+.\launcher.exe -K .\ddrhook2.dll .\ddr.dll %*

dist/ddr/gamestart-13.bat

@@ -8,4 +8,4 @@ if not exist conf\raw mkdir conf\raw
 regsvr32 /s k-clvsd.dll
 regsvr32 /s xactengine2_10.dll
 
-.\launcher.exe -K .\ddrhook.dll .\ddr.dll %*
+.\launcher.exe -K .\ddrhook2.dll .\ddr.dll %*

dist/ddr/gamestart-14.bat

@@ -11,4 +11,4 @@ if not exist conf\raw mkdir conf\raw
 regsvr32 /s k-clvsd.dll
 regsvr32 /s xactengine2_10.dll
 
-.\launcher.exe -K .\ddrhook.dll .\mdxja_945.dll %*
+.\launcher.exe -K .\ddrhook2.dll .\mdxja_945.dll %*

dist/ddr/gamestart-15.bat

@@ -11,4 +11,4 @@ if not exist conf\raw mkdir conf\raw
 regsvr32 /s k-clvsd.dll
 regsvr32 /s xactengine2_10.dll
 
-.\launcher.exe -K .\ddrhook.dll .\mdxja_945.dll %*
+.\launcher.exe -K .\ddrhook2.dll .\mdxja_945.dll %*

dist/ddr/gamestart-16.bat

@@ -12,4 +12,4 @@ if not exist conf\raw mkdir conf\raw
 regsvr32 /s com\k-clvsd.dll
 regsvr32 /s com\xactengine2_10.dll
 
-.\launcher.exe -H 33554432 -K .\ddrhook.dll .\arkmdxp3.dll %*
+.\launcher.exe -H 33554432 -K .\ddrhook2.dll .\arkmdxp3.dll %*

dist/ddr/gamestart-17.bat

@@ -0,0 +1,15 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist conf\nvram mkdir conf\nvram
+if not exist conf\nvram\ea3-config.xml copy prop\eamuse-config.xml conf\nvram\ea3-config.xml
+if not exist conf\nvram\coin.xml copy prop\coin.xml conf\nvram\coin.xml
+if not exist conf\nvram\eacoin.xml copy prop\eacoin.xml conf\nvram\eacoin.xml
+if not exist conf\nvram\testmode-v.xml copy prop\testmode-v.xml conf\nvram\testmode-v.xml
+if not exist conf\raw mkdir conf\raw
+
+regsvr32 /s com\k-clvsd.dll
+regsvr32 /s com\xactengine2_10.dll
+
+.\launcher.exe -H 33554432 -K .\ddrhook2.dll .\arkmdxp3.dll %*

dist/ddr/gamestart-18.bat

@@ -0,0 +1,15 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist conf\nvram mkdir conf\nvram
+if not exist conf\nvram\ea3-config.xml copy prop\eamuse-config.xml conf\nvram\ea3-config.xml
+if not exist conf\nvram\coin.xml copy prop\coin.xml conf\nvram\coin.xml
+if not exist conf\nvram\eacoin.xml copy prop\eacoin.xml conf\nvram\eacoin.xml
+if not exist conf\nvram\testmode-v.xml copy prop\testmode-v.xml conf\nvram\testmode-v.xml
+if not exist conf\raw mkdir conf\raw
+
+regsvr32 /s com\k-clvsd.dll
+regsvr32 /s com\xactengine2_10.dll
+
+.\launcher.exe -H 33554432 -K .\ddrhook2.dll .\arkmdxp3.dll %*

dist/iidx/config.bat

@@ -1 +1 @@
-@start config iidx
+@start config.exe iidx

dist/iidx/gamestart-18-cn.bat

@@ -0,0 +1,17 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist d mkdir d
+if not exist e mkdir e
+if not exist f mkdir f
+
+if not exist e\avs_conf mkdir e\avs_conf
+if not exist e\avs_conf\CONF mkdir e\avs_conf\CONF
+if not exist e\avs_conf\CONF\NVRAM mkdir e\avs_conf\CONF\NVRAM
+if not exist e\avs_conf\CONF\RAW mkdir e\avs_conf\CONF\RAW
+
+if not exist dev\nvram mkdir dev\nvram
+if not exist dev\raw mkdir dev\raw
+
+inject iidxhook4-cn.dll bm2dx.exe -D --config iidxhook-18-cn.conf %*

dist/iidx/gamestart-20-cn.bat

@@ -0,0 +1,17 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist d mkdir d
+if not exist e mkdir e
+if not exist f mkdir f
+
+if not exist e\avs_conf mkdir e\avs_conf
+if not exist e\avs_conf\CONF mkdir e\avs_conf\CONF
+if not exist e\avs_conf\CONF\NVRAM mkdir e\avs_conf\CONF\NVRAM
+if not exist e\avs_conf\CONF\RAW mkdir e\avs_conf\CONF\RAW
+
+if not exist dev\nvram mkdir dev\nvram
+if not exist dev\raw mkdir dev\raw
+
+inject iidxhook5-cn.dll bm2dx.exe -D --config iidxhook-20-cn.conf %*

dist/iidx/gamestart-26.bat

@@ -0,0 +1,16 @@
+@echo off
+cd /d %~dp0
+
+if not exist dev mkdir dev
+if not exist dev\e mkdir dev\e
+if not exist dev\g mkdir dev\g
+if not exist dev\nvram mkdir dev\nvram
+if not exist dev\raw mkdir dev\raw
+if not exist dev\raw\log mkdir dev\raw\log
+if not exist dev\raw\fscache mkdir dev\raw\fscache
+
+for /R prop\defaults %%D in (*.*) do (
+    if not exist dev\nvram\%%~nxD copy /y prop\defaults\%%~nxD dev\nvram
+)
+
+launcher -H 134217728 -K iidxhook8.dll bm2dx.dll --config iidxhook-26.conf %*

dist/iidx/gamestart-27.bat

@@ -0,0 +1,16 @@
+@echo off
+cd /d %~dp0
+
+if not exist dev mkdir dev
+if not exist dev\e mkdir dev\e
+if not exist dev\g mkdir dev\g
+if not exist dev\nvram mkdir dev\nvram
+if not exist dev\raw mkdir dev\raw
+if not exist dev\raw\log mkdir dev\raw\log
+if not exist dev\raw\fscache mkdir dev\raw\fscache
+
+for /R prop\defaults %%D in (*.*) do (
+    if not exist dev\nvram\%%~nxD copy /y prop\defaults\%%~nxD dev\nvram
+)
+
+launcher -H 134217728 -B iidxhook9.dll bm2dx.dll --config iidxhook-27.conf %*

dist/iidx/gamestart-28.bat

@@ -0,0 +1,16 @@
+@echo off
+cd /d %~dp0
+
+if not exist dev mkdir dev
+if not exist dev\e mkdir dev\e
+if not exist dev\g mkdir dev\g
+if not exist dev\nvram mkdir dev\nvram
+if not exist dev\raw mkdir dev\raw
+if not exist dev\raw\log mkdir dev\raw\log
+if not exist dev\raw\fscache mkdir dev\raw\fscache
+
+for /R prop\defaults %%D in (*.*) do (
+    if not exist dev\nvram\%%~nxD copy /y prop\defaults\%%~nxD dev\nvram
+)
+
+launcher -H 134217728 -B iidxhook9.dll bm2dx.dll --config iidxhook-28.conf %*

dist/iidx/gamestart-29.bat

@@ -0,0 +1,16 @@
+@echo off
+cd /d %~dp0
+
+if not exist dev mkdir dev
+if not exist dev\e mkdir dev\e
+if not exist dev\g mkdir dev\g
+if not exist dev\nvram mkdir dev\nvram
+if not exist dev\raw mkdir dev\raw
+if not exist dev\raw\log mkdir dev\raw\log
+if not exist dev\raw\fscache mkdir dev\raw\fscache
+
+for /R prop\defaults %%D in (*.*) do (
+    if not exist dev\nvram\%%~nxD copy /y prop\defaults\%%~nxD dev\nvram
+)
+
+launcher -H 134217728 -B iidxhook9.dll bm2dx.dll --config iidxhook-29.conf %*

dist/iidx/gamestart-30.bat

@@ -0,0 +1,16 @@
+@echo off
+cd /d %~dp0
+
+if not exist dev mkdir dev
+if not exist dev\e mkdir dev\e
+if not exist dev\g mkdir dev\g
+if not exist dev\nvram mkdir dev\nvram
+if not exist dev\raw mkdir dev\raw
+if not exist dev\raw\log mkdir dev\raw\log
+if not exist dev\raw\fscache mkdir dev\raw\fscache
+
+for /R prop\defaults %%D in (*.*) do (
+    if not exist dev\nvram\%%~nxD copy /y prop\defaults\%%~nxD dev\nvram
+)
+
+modules\launcher -H 134217728 -B iidxhook9.dll bm2dx.dll --config iidxhook-30.conf %*

dist/iidx/iidx-irbeat-patch-09.bat

@@ -1,12 +1,45 @@
 @echo off
+cd /d %~dp0
 
-IF "%1"=="" GOTO USAGE
+REM Open menu if no arguments specified
+if "%~1" == "" goto menu
 
-iidx-irbeat-patch.exe 9 %1 e\\settings.bin.0
+if "%~1" gtr "3" goto badbeat
-iidx-irbeat-patch.exe 9 %1 f\\settings.bin.1
+if "%~1" == "0" goto badbeat
-GOTO END
 
-:USAGE
+set beat = "%~1" - 1
-	ECHO "Usage: iidx-irbeat-patch.bat <beat phase>"
+iidx-irbeat-patch.exe 9 %beat% e\\settings.bin.0
+iidx-irbeat-patch.exe 9 %beat% f\\settings.bin.1
+
+if not errorlevel 0 goto error
+echo Beat phase patched sucessfully
+exit /b
+
+:menu
+echo Select beat phase:
+echo 1 - beat#1
+echo 2 - beat#2
+echo 3 - beat#3
+
+choice /n /c:123
+set /a beat = %errorlevel% - 1
+
+echo.
+iidx-irbeat-patch.exe 9 %beat% e\\settings.bin.0
+iidx-irbeat-patch.exe 9 %beat% f\\settings.bin.1
+echo.
+
+if not errorlevel 0 goto error
+echo Beat phase patched sucessfully
+timeout 5
+exit /b
+
+:error
+echo Something has gone wrong with the patching process, have you run the game at least once?
+pause
+exit /b
+
+:badbeat
+echo Invalid beat phase specified, values are 1 to 3.
+exit /b
 
-:END

dist/iidx/iidx-irbeat-patch-10.bat

@@ -1,12 +1,45 @@
 @echo off
+cd /d %~dp0
 
-IF "%1"=="" GOTO USAGE
+REM Open menu if no arguments specified
+if "%~1" == "" goto menu
 
-iidx-irbeat-patch.exe 10 %1 e\\settings.bin.0
+if %~1 gtr 3 goto badbeat
-iidx-irbeat-patch.exe 10 %1 f\\settings.bin.1
+if %~1 == 0 goto badbeat
-GOTO END
 
-:USAGE
+set /a beat = %~1 - 1
-	ECHO "Usage: iidx-irbeat-patch.bat <beat phase>"
+iidx-irbeat-patch.exe 9 %beat% e\\settings.bin.0
+iidx-irbeat-patch.exe 9 %beat% f\\settings.bin.1
+
+if not errorlevel 0 goto error
+echo Beat phase patched sucessfully
+exit /b
+
+:menu
+echo Select beat phase:
+echo 1 - beat#1
+echo 2 - beat#2
+echo 3 - beat#3
+
+choice /n /c:123
+set /a beat = %errorlevel% - 1
+
+echo.
+iidx-irbeat-patch.exe 10 %beat% e\\settings.bin.0
+iidx-irbeat-patch.exe 10 %beat% f\\settings.bin.1
+echo.
+
+if not errorlevel 0 goto error
+echo Beat phase patched sucessfully
+timeout 5
+exit /b
+
+:error
+echo Something has gone wrong with the patching process, have you run the game at least once?
+pause
+exit /b
+
+:badbeat
+echo Invalid beat phase specified, values are 1 to 3.
+exit /b
 
-:END

dist/iidx/iidxhook-09.conf

@@ -10,7 +10,7 @@ eamuse.pcbid=0101020304050607086F
 # EAMID
 eamuse.eamid=0101020304050607086F
 
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
+# Fix stretched BG videos on newer GPUs. Might appear on SIRIUS and older. On 9th and 10th style this issue may only affect older BGAs (from 1st-3rd style)
 gfx.bgvideo_uv_fix=false
 
 # Run the game in a framed window (requires windowed option)
@@ -25,11 +25,11 @@ gfx.monitor_check=-1.000000
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -40,20 +40,32 @@ 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
 
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Enable monitoring of ezusb.dll calls by logging call traces. Only works on 9th and 10th style!
+ezusb.api_call_monitoring=false
+
+# Set the type of ezusb IO board. 0 = C02, 1 = D01. Note: Impacts security settings!
+ezusb.io_board_type=0
+
 # Disable operator clock setting system clock time
 misc.disable_clock_set=false
 
-# Use d3d9 hooks instead of d3d8 to enable d3d9 hook features not available on d3d8 (e.g. upscaling). Requires  d3d8to9 wrapper library to be used with this game.
-misc.use_d3d9_hooks=false
-
 # Stub calls to rteffect.dll (10th to DistorteD)
 misc.rteffect_stub=false
 
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
+misc.settings_path=.\
+
 # Security boot version (e.g. GEC02).
 sec.boot_version=GEC02   
 
 # Security boot seeds for ezusb, format: X:X:X where X is a number of 0-9 (e.g. 0:0:0).
 sec.boot_seeds=0:0:0
 
-# Security black plug mcode id string (e.g. GQC02JAA).
+# Security black plug mcode id string (e.g. GEC02JAA).
-sec.black_plug_mcode=GQC02JAA
+sec.black_plug_mcode=GEC02JAA

dist/iidx/iidxhook-10.conf

@@ -10,7 +10,7 @@ eamuse.pcbid=0101020304050607086F
 # EAMID
 eamuse.eamid=0101020304050607086F
 
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
+# Fix stretched BG videos on newer GPUs. Might appear on SIRIUS and older. On 9th and 10th style this issue may only affect older BGAs (from 1st-3rd style)
 gfx.bgvideo_uv_fix=false
 
 # Run the game in a framed window (requires windowed option)
@@ -25,11 +25,11 @@ gfx.monitor_check=-1.000000
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -40,15 +40,27 @@ 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
 
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Enable monitoring of ezusb.dll calls by logging call traces. Only works on 9th and 10th style!
+ezusb.api_call_monitoring=false
+
+# Set the type of ezusb IO board. 0 = C02, 1 = D01. Note: Impacts security settings!
+ezusb.io_board_type=1
+
 # Disable operator clock setting system clock time
 misc.disable_clock_set=false
 
-# Use d3d9 hooks instead of d3d8 to enable d3d9 hook features not available on d3d8 (e.g. upscaling). Requires  d3d8to9 wrapper library to be used with this game.
-misc.use_d3d9_hooks=false
-
 # Stub calls to rteffect.dll (10th to DistorteD)
 misc.rteffect_stub=false
 
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
+misc.settings_path=.\
+
 # Security boot version (e.g. GEC02).
 sec.boot_version=GEC02   
 

dist/iidx/iidxhook-11.conf

@@ -10,7 +10,7 @@ eamuse.pcbid=0101020304050607086F
 # EAMID
 eamuse.eamid=0101020304050607086F
 
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
+# Fix stretched BG videos on newer GPUs. Might appear on SIRIUS and older. On 9th and 10th style this issue may only affect older BGAs (from 1st-3rd style)
 gfx.bgvideo_uv_fix=false
 
 # Run the game in a framed window (requires windowed option)
@@ -25,11 +25,11 @@ gfx.monitor_check=-1.000000
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -40,15 +40,27 @@ 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
 
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Enable monitoring of ezusb.dll calls by logging call traces. Only works on 9th and 10th style!
+ezusb.api_call_monitoring=false
+
+# Set the type of ezusb IO board. 0 = C02, 1 = D01. Note: Impacts security settings!
+ezusb.io_board_type=1
+
 # Disable operator clock setting system clock time
 misc.disable_clock_set=false
 
-# Use d3d9 hooks instead of d3d8 to enable d3d9 hook features not available on d3d8 (e.g. upscaling). Requires  d3d8to9 wrapper library to be used with this game.
-misc.use_d3d9_hooks=false
-
 # Stub calls to rteffect.dll (10th to DistorteD)
 misc.rteffect_stub=false
 
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
+misc.settings_path=.\
+
 # Security boot version (e.g. GEC02).
 sec.boot_version=GEC02   
 

dist/iidx/iidxhook-12.conf

@@ -10,7 +10,7 @@ eamuse.pcbid=0101020304050607086F
 # EAMID
 eamuse.eamid=0101020304050607086F
 
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
+# Fix stretched BG videos on newer GPUs. Might appear on SIRIUS and older. On 9th and 10th style this issue may only affect older BGAs (from 1st-3rd style)
 gfx.bgvideo_uv_fix=false
 
 # Run the game in a framed window (requires windowed option)
@@ -25,11 +25,11 @@ gfx.monitor_check=-1.000000
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -40,18 +40,30 @@ 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
 
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Enable monitoring of ezusb.dll calls by logging call traces. Only works on 9th and 10th style!
+ezusb.api_call_monitoring=false
+
+# Set the type of ezusb IO board. 0 = C02, 1 = D01. Note: Impacts security settings!
+ezusb.io_board_type=1
+
 # Fix broken 3D background on Happy Sky's music select (if appearing completely white)
 misc.happy_sky_ms_bg_fix=false
 
-# Use d3d9 hooks instead of d3d8 to enable d3d9 hook features not available on d3d8 (e.g. upscaling). Requires  d3d8to9 wrapper library to be used with this game.
-misc.use_d3d9_hooks=false
-
 # Disable operator clock setting system clock time
 misc.disable_clock_set=false
 
 # Stub calls to rteffect.dll (10th to DistorteD)
 misc.rteffect_stub=false
 
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
+misc.settings_path=.\
+
 # Security boot version (e.g. GEC02).
 sec.boot_version=GEC02   
 

dist/iidx/iidxhook-13.conf

@@ -10,7 +10,7 @@ eamuse.pcbid=0101020304050607086F
 # EAMID
 eamuse.eamid=0101020304050607086F
 
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
+# Fix stretched BG videos on newer GPUs. Might appear on SIRIUS and older. On 9th and 10th style this issue may only affect older BGAs (from 1st-3rd style)
 gfx.bgvideo_uv_fix=false
 
 # Run the game in a framed window (requires windowed option)
@@ -25,11 +25,11 @@ gfx.monitor_check=-1.000000
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -40,18 +40,30 @@ 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
 
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Enable monitoring of ezusb.dll calls by logging call traces. Only works on 9th and 10th style!
+ezusb.api_call_monitoring=false
+
+# Set the type of ezusb IO board. 0 = C02, 1 = D01. Note: Impacts security settings!
+ezusb.io_board_type=1
+
 # Fix broken 3D background on DistorteD's music select (if appearing completely black)
 misc.distorted_ms_bg_fix=false
 
-# Use d3d9 hooks instead of d3d8 to enable d3d9 hook features not available on d3d8 (e.g. upscaling). Requires  d3d8to9 wrapper library to be used with this game.
-misc.use_d3d9_hooks=false
-
 # Disable operator clock setting system clock time
 misc.disable_clock_set=false
 
 # Stub calls to rteffect.dll (10th to DistorteD)
 misc.rteffect_stub=false
 
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
+misc.settings_path=.\
+
 # Security boot version (e.g. GEC02).
 sec.boot_version=GEC02   
 

dist/iidx/iidxhook-14.conf

@@ -7,7 +7,7 @@ eamuse.pcbid=0101020304050607086F
 # EAMID
 eamuse.eamid=0101020304050607086F
 
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
+# Fix stretched BG videos on newer GPUs. Might appear on SIRIUS and older. On 9th and 10th style this issue may only affect older BGAs (from 1st-3rd style)
 gfx.bgvideo_uv_fix=false
 
 # Run the game in a framed window (requires windowed option)
@@ -22,11 +22,11 @@ gfx.monitor_check=-1.000000
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -37,11 +37,17 @@ 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
 
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
 # Disable operator clock setting system clock time
 misc.disable_clock_set=false
 
-# Security boot version (e.g. GEC02).
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
-sec.boot_version=GQGLDJAA
+misc.settings_path=.\
 
 # Security black plug mcode id string (e.g. GQC02JAA).
-sec.black_plug_mcode=GQGLDJA
+sec.black_plug_mcode=GQGLDJAA

dist/iidx/iidxhook-15.conf

@@ -7,7 +7,7 @@ eamuse.pcbid=0101020304050607086F
 # EAMID
 eamuse.eamid=0101020304050607086F
 
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
+# Fix stretched BG videos on newer GPUs. Might appear on SIRIUS and older. On 9th and 10th style this issue may only affect older BGAs (from 1st-3rd style)
 gfx.bgvideo_uv_fix=false
 
 # Run the game in a framed window (requires windowed option)
@@ -22,11 +22,11 @@ gfx.monitor_check=-1.000000
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -37,11 +37,17 @@ 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
 
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
 # Disable operator clock setting system clock time
 misc.disable_clock_set=false
 
-# Security boot version (e.g. GEC02).
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
-sec.boot_version=GQHDDJAA
+misc.settings_path=.\
 
 # Security black plug mcode id string (e.g. GQC02JAA).
-sec.black_plug_mcode=GQHDDJA
+sec.black_plug_mcode=GQHDDJAA

dist/iidx/iidxhook-16.conf

@@ -7,7 +7,7 @@ eamuse.pcbid=0101020304050607086F
 # EAMID
 eamuse.eamid=0101020304050607086F
 
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
+# Fix stretched BG videos on newer GPUs. Might appear on SIRIUS and older. On 9th and 10th style this issue may only affect older BGAs (from 1st-3rd style)
 gfx.bgvideo_uv_fix=false
 
 # Run the game in a framed window (requires windowed option)
@@ -25,11 +25,11 @@ gfx.pci_id=1002:7146
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -40,11 +40,17 @@ 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
 
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
 # Disable operator clock setting system clock time
 misc.disable_clock_set=false
 
-# Security boot version (e.g. GEC02).
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
-sec.boot_version=GQI00JAA
+misc.settings_path=.\
 
 # Security black plug mcode id string (e.g. GQC02JAA).
-sec.black_plug_mcode=GQI00JA
+sec.black_plug_mcode=GQI00JAA

dist/iidx/iidxhook-17.conf

@@ -7,7 +7,7 @@ eamuse.pcbid=0101020304050607086F
 # EAMID
 eamuse.eamid=0101020304050607086F
 
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
+# Fix stretched BG videos on newer GPUs. Might appear on SIRIUS and older. On 9th and 10th style this issue may only affect older BGAs (from 1st-3rd style)
 gfx.bgvideo_uv_fix=false
 
 # Run the game in a framed window (requires windowed option)
@@ -25,11 +25,11 @@ gfx.pci_id=1002:7146
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -40,11 +40,17 @@ 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
 
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
 # Disable operator clock setting system clock time
 misc.disable_clock_set=false
 
-# Security boot version (e.g. GEC02).
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
-sec.boot_version=GCJDJJAA
+misc.settings_path=.\
 
 # Security black plug mcode id string (e.g. GQC02JAA).
-sec.black_plug_mcode=GCJDJJA
+sec.black_plug_mcode=GCJDJJAA

dist/iidx/iidxhook-18-cn.conf

@@ -0,0 +1,50 @@
+# PCBID
+eamuse.pcbid=0101020304050607086F
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=false
+
+# 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
+
+# Enable/disable software monitor check/auto timebase or set a pre-determined refresh value. -1 disables this feature. 0 enables auto detecting the current refresh rate on startup. Setting any positive value > 0 allows you to set a pre-determined refresh rate (e.g. retrieved from the monitor check on newer IIDX games). Either the auto detected value or pre-determined value is used to patch any chart files in-memory to fix song synchronization issues. Requires constant refresh rate!!!
+gfx.monitor_check=-1.000000
+
+# Patch the GPU device ID detection (leave empty to disable), format XXXX:YYYY, two 4 digit hex numbers (vid:pid). Examples: 1002:7146 (RV515, Radeon X1300), 1002:95C5 (RV620 LE, Radeon HD3450)
+gfx.pci_id=1002:7146
+
+# 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
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Fix diagonal tearing with video cards other than Radeon X1300 and HD3450
+gfx.diagonal_tearing_fix=false
+
+# Disable ezusb IO emulation and enable usage of real ezusb1/2 IO hardware
+io.disable_io_emu=false
+
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
+misc.settings_path=.\
+
+# Security black plug mcode id string (e.g. GQC02JAA).
+sec.black_plug_mcode=GKJDZCAA

dist/iidx/iidxhook-18.conf

@@ -1,6 +1,3 @@
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
-gfx.bgvideo_uv_fix=false
-
 # Run the game in a framed window (requires windowed option)
 gfx.framed=false
 
@@ -16,11 +13,11 @@ gfx.pci_id=1002:7146
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -30,3 +27,21 @@ 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
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Fix diagonal tearing with video cards other than Radeon X1300 and HD3450
+gfx.diagonal_tearing_fix=false
+
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted/wavepass readers)
+io.disable_card_reader_emu=false
+
+# Disable ezusb IO emulation and enable usage of real ezusb1/2 IO hardware
+io.disable_io_emu=false
+
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
+misc.settings_path=.\

dist/iidx/iidxhook-19.conf

@@ -1,23 +1,23 @@
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
-gfx.bgvideo_uv_fix=false
-
 # Run the game in a framed window (requires windowed option)
 gfx.framed=false
 
 # 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
 
+# Enable/disable software monitor check/auto timebase or set a pre-determined refresh value. -1 disables this feature. 0 enables auto detecting the current refresh rate on startup. Setting any positive value > 0 allows you to set a pre-determined refresh rate (e.g. retrieved from the monitor check on newer IIDX games). Either the auto detected value or pre-determined value is used to patch any chart files in-memory to fix song synchronization issues. Requires constant refresh rate!!!
+gfx.monitor_check=-1.000000
+
 # Patch the GPU device ID detection (leave empty to disable), format XXXX:YYYY, two 4 digit hex numbers (vid:pid). Examples: 1002:7146 (RV515, Radeon X1300), 1002:95C5 (RV620 LE, Radeon HD3450)
 gfx.pci_id=1002:7146
 
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -27,3 +27,21 @@ 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
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Fix diagonal tearing with video cards other than Radeon X1300 and HD3450
+gfx.diagonal_tearing_fix=false
+
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted/wavepass readers)
+io.disable_card_reader_emu=false
+
+# Disable ezusb IO emulation and enable usage of real ezusb1/2 IO hardware
+io.disable_io_emu=false
+
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
+misc.settings_path=.\

dist/iidx/iidxhook-20-cn.conf

@@ -0,0 +1,47 @@
+# PCBID
+eamuse.pcbid=0101020304050607086F
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=false
+
+# 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
+
+# Patch the GPU device ID detection (leave empty to disable), format XXXX:YYYY, two 4 digit hex numbers (vid:pid). Examples: 1002:7146 (RV515, Radeon X1300), 1002:95C5 (RV620 LE, Radeon HD3450)
+gfx.pci_id=1002:7146
+
+# 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
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Fix diagonal tearing with video cards other than Radeon X1300 and HD3450
+gfx.diagonal_tearing_fix=false
+
+# Disable ezusb IO emulation and enable usage of real ezusb1/2 IO hardware
+io.disable_io_emu=false
+
+# Path to store the settings, e.g. bookkeeping, operator settings. d:, e: and f: drive configuration/settings data
+misc.settings_path=.\
+
+# Security black plug mcode id string (e.g. GQC02JAA).
+sec.black_plug_mcode=GKJDZCAA

dist/iidx/iidxhook-20.conf

@@ -1,6 +1,3 @@
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
-gfx.bgvideo_uv_fix=false
-
 # Run the game in a framed window (requires windowed option)
 gfx.framed=false
 
@@ -13,11 +10,11 @@ gfx.pci_id=1002:7146
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -27,3 +24,15 @@ 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
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted/wavepass readers)
+io.disable_card_reader_emu=false
+
+# Disable ezusb IO emulation and enable usage of real ezusb1/2 IO hardware
+io.disable_io_emu=false

dist/iidx/iidxhook-21.conf

@@ -1,6 +1,3 @@
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
-gfx.bgvideo_uv_fix=false
-
 # Run the game in a framed window (requires windowed option)
 gfx.framed=false
 
@@ -13,11 +10,11 @@ gfx.pci_id=1002:7146
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -27,3 +24,15 @@ 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
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted/wavepass readers)
+io.disable_card_reader_emu=false
+
+# Disable ezusb IO emulation and enable usage of real ezusb1/2 IO hardware
+io.disable_io_emu=false

dist/iidx/iidxhook-22.conf

@@ -1,6 +1,3 @@
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
-gfx.bgvideo_uv_fix=false
-
 # Run the game in a framed window (requires windowed option)
 gfx.framed=false
 
@@ -13,11 +10,11 @@ gfx.pci_id=1002:7146
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -27,3 +24,15 @@ 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
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted/wavepass readers)
+io.disable_card_reader_emu=false
+
+# Disable ezusb IO emulation and enable usage of real ezusb1/2 IO hardware
+io.disable_io_emu=false

dist/iidx/iidxhook-23.conf

@@ -1,6 +1,3 @@
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
-gfx.bgvideo_uv_fix=false
-
 # Run the game in a framed window (requires windowed option)
 gfx.framed=false
 
@@ -13,11 +10,11 @@ gfx.pci_id=1002:7146
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -27,3 +24,15 @@ 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
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted/wavepass readers)
+io.disable_card_reader_emu=false
+
+# Disable ezusb IO emulation and enable usage of real ezusb1/2 IO hardware
+io.disable_io_emu=false

dist/iidx/iidxhook-24.conf

@@ -1,6 +1,3 @@
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
-gfx.bgvideo_uv_fix=false
-
 # Run the game in a framed window (requires windowed option)
 gfx.framed=false
 
@@ -13,11 +10,11 @@ gfx.pci_id=1002:7146
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -27,3 +24,15 @@ 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
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted/wavepass readers)
+io.disable_card_reader_emu=false
+
+# Disable ezusb IO emulation and enable usage of real ezusb1/2 IO hardware
+io.disable_io_emu=false

dist/iidx/iidxhook-25.conf

@@ -1,6 +1,3 @@
-# Fix stretched BG videos on newer GPUs. Might appear on Red and newer
-gfx.bgvideo_uv_fix=false
-
 # Run the game in a framed window (requires windowed option)
 gfx.framed=false
 
@@ -13,11 +10,11 @@ gfx.pci_id=1002:7146
 # Run the game windowed
 gfx.windowed=false
 
-# Windowed width, -1 for default size
+# Windowed width, 0 for default size
-gfx.window_width=-1
+gfx.window_width=0
 
-# Windowed height, -1 for default size
+# Windowed height, 0 for default size
-gfx.window_height=-1
+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
@@ -28,16 +25,28 @@ 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
 
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
 # Disables the camera emulation
 cam.disable_emu=false
 
-# Override camera device ID 1 detection (copy from device manager, do not escape)
+# Disable camera 1. Use, i.e., if you only have one camera and want it to be mapped to camera 2 ingame.
+cam.disable_camera1=false
+
+# Disable camera 2. Use, i.e., if you have more than one camera but only want to map camera 1 ingame.
+cam.disable_camera2=false
+
+# Override camera device ID 1 detection (copy from device manager, do not escape) Leave blank to automatically detect
 cam.device_id1=
 
-# Override camera device ID 2 detection (copy from device manager, do not escape)
+# Override camera device ID 2 detection (copy from device manager, do not escape) Leave blank to automatically detect
 cam.device_id2=
 
-# Disable card reader emulation and enable usage of real card reader hardware on COM0 (for games supporting slotted readers)
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted readers)
 io.disable_card_reader_emu=false
 
 # Disable BIO2 emulation and enable usage of real BIO2 hardware

dist/iidx/iidxhook-26.conf

@@ -0,0 +1,56 @@
+# Run the game in a framed window (requires windowed option)
+gfx.framed=false
+
+# 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
+
+# Patch the GPU device ID detection (leave empty to disable), format XXXX:YYYY, two 4 digit hex numbers (vid:pid). Examples: 1002:7146 (RV515, Radeon X1300), 1002:95C5 (RV620 LE, Radeon HD3450)
+gfx.pci_id=1002:7146
+
+# 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
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9 device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Disables the camera emulation
+cam.disable_emu=false
+
+# Disable camera 1. Use, i.e., if you only have one camera and want it to be mapped to camera 2 ingame.
+cam.disable_camera1=false
+
+# Disable camera 2. Use, i.e., if you have more than one camera but only want to map camera 1 ingame.
+cam.disable_camera2=false
+
+# Override camera device ID 1 detection (copy from device manager, do not escape) Leave blank to automatically detect
+cam.device_id1=
+
+# Override camera device ID 2 detection (copy from device manager, do not escape) Leave blank to automatically detect
+cam.device_id2=
+
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted readers)
+io.disable_card_reader_emu=false
+
+# Disable BIO2 emulation and enable usage of real BIO2 hardware
+io.disable_bio2_emu=false
+
+# Disables the poll limiter, warning very high CPU usage may arise
+io.disable_poll_limiter=false

dist/iidx/iidxhook-27.conf

@@ -0,0 +1,84 @@
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted readers)
+io.disable_card_reader_emu=false
+
+# Disable BIO2 emulation and enable usage of real BIO2 hardware
+io.disable_bio2_emu=false
+
+# Disables the poll limiter, warning very high CPU usage may arise
+io.disable_poll_limiter=false
+
+# Lightning cab mode (requires additional IO emulation)
+io.lightning_mode=false
+
+# Disable camera connection
+io.disable_cams=true
+
+# Disables the built in file hooks, requiring manual file creation
+io.disable_file_hooks=false
+
+# Turntable sensitivity multiplier (1.0 is default)
+io.tt_multiplier=1.0
+
+# Disables the camera emulation
+cam.disable_emu=true
+
+# Disable camera 1. Use, i.e., if you only have one camera and want it to be mapped to camera 2 ingame.
+cam.disable_camera1=false
+
+# Disable camera 2. Use, i.e., if you have more than one camera but only want to map camera 1 ingame.
+cam.disable_camera2=false
+
+# Override camera device ID detection (copy from device manager, do not escape)
+cam.device_id1=
+
+# Override camera device ID detection (copy from device manager, do not escape)
+cam.device_id2=
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=true
+
+# Run the game windowed
+gfx.windowed=false
+
+# Confine mouse cursor to window
+gfx.confined=false
+
+# Windowed width, -1 for default size
+gfx.window_width=-1
+
+# Windowed height, -1 for default size
+gfx.window_height=-1
+
+# Windowed X, -1 for default X position
+gfx.window_x=-1
+
+# Windowed Y, -1 for default Y position
+gfx.window_y=-1
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9ex device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Orientation to force monitor into, -1 to use default, 0, 1, 2, 3 to do 0, 90, 180, 270 degrees
+gfx.force_orientation=-1
+
+# Force a screen resolution (width), -1 to disable. Use this if the game does not auto detect your monitor's resolution properly, e.g. 1368x768 instead of 1280x720.
+gfx.force_screen_res.width=-1
+
+# Force a screen resolution (height), -1 to disable. Use this if the game does not auto detect your monitor's resolution properly, e.g. 1368x768 instead of 1280x720.
+gfx.force_screen_res.height=-1
+
+# IP of adapter to force override with
+adapter.override_ip=
+
+# Force ASIO audio mode/device (if applicable / TDJ default)
+asio.force_asio=false
+
+# Force WASAPI audio mode (if applicable / LDJ default)
+asio.force_wasapi=true
+
+# The ASIO device name to use
+asio.device_name=XONAR SOUND CARD(64)
+

dist/iidx/iidxhook-28.conf

@@ -0,0 +1,84 @@
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted readers)
+io.disable_card_reader_emu=false
+
+# Disable BIO2 emulation and enable usage of real BIO2 hardware
+io.disable_bio2_emu=false
+
+# Disables the poll limiter, warning very high CPU usage may arise
+io.disable_poll_limiter=false
+
+# Lightning cab mode (requires additional IO emulation)
+io.lightning_mode=false
+
+# Disable camera connection
+io.disable_cams=true
+
+# Disables the built in file hooks, requiring manual file creation
+io.disable_file_hooks=false
+
+# Turntable sensitivity multiplier (1.0 is default)
+io.tt_multiplier=1.0
+
+# Disables the camera emulation
+cam.disable_emu=true
+
+# Disable camera 1. Use, i.e., if you only have one camera and want it to be mapped to camera 2 ingame.
+cam.disable_camera1=false
+
+# Disable camera 2. Use, i.e., if you have more than one camera but only want to map camera 1 ingame.
+cam.disable_camera2=false
+
+# Override camera device ID detection (copy from device manager, do not escape)
+cam.device_id1=
+
+# Override camera device ID detection (copy from device manager, do not escape)
+cam.device_id2=
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=true
+
+# Run the game windowed
+gfx.windowed=false
+
+# Confine mouse cursor to window
+gfx.confined=false
+
+# Windowed width, -1 for default size
+gfx.window_width=-1
+
+# Windowed height, -1 for default size
+gfx.window_height=-1
+
+# Windowed X, -1 for default X position
+gfx.window_x=-1
+
+# Windowed Y, -1 for default Y position
+gfx.window_y=-1
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9ex device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Orientation to force monitor into, -1 to use default, 0, 1, 2, 3 to do 0, 90, 180, 270 degrees
+gfx.force_orientation=-1
+
+# Force a screen resolution (width), -1 to disable. Use this if the game does not auto detect your monitor's resolution properly, e.g. 1368x768 instead of 1280x720.
+gfx.force_screen_res.width=-1
+
+# Force a screen resolution (height), -1 to disable. Use this if the game does not auto detect your monitor's resolution properly, e.g. 1368x768 instead of 1280x720.
+gfx.force_screen_res.height=-1
+
+# IP of adapter to force override with
+adapter.override_ip=
+
+# Force ASIO audio mode/device (if applicable / TDJ default)
+asio.force_asio=false
+
+# Force WASAPI audio mode (if applicable / LDJ default)
+asio.force_wasapi=true
+
+# The ASIO device name to use
+asio.device_name=XONAR SOUND CARD(64)
+

dist/iidx/iidxhook-29.conf

@@ -0,0 +1,84 @@
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted readers)
+io.disable_card_reader_emu=false
+
+# Disable BIO2 emulation and enable usage of real BIO2 hardware
+io.disable_bio2_emu=false
+
+# Disables the poll limiter, warning very high CPU usage may arise
+io.disable_poll_limiter=false
+
+# Lightning cab mode (requires additional IO emulation)
+io.lightning_mode=false
+
+# Disable camera connection
+io.disable_cams=true
+
+# Disables the built in file hooks, requiring manual file creation
+io.disable_file_hooks=false
+
+# Turntable sensitivity multiplier (1.0 is default)
+io.tt_multiplier=1.0
+
+# Disables the camera emulation
+cam.disable_emu=true
+
+# Disable camera 1. Use, i.e., if you only have one camera and want it to be mapped to camera 2 ingame.
+cam.disable_camera1=true
+
+# Disable camera 2. Use, i.e., if you have more than one camera but only want to map camera 1 ingame.
+cam.disable_camera2=false
+
+# Override camera device ID detection (copy from device manager, do not escape)
+cam.device_id1=
+
+# Override camera device ID detection (copy from device manager, do not escape)
+cam.device_id2=
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=true
+
+# Run the game windowed
+gfx.windowed=false
+
+# Confine mouse cursor to window
+gfx.confined=false
+
+# Windowed width, -1 for default size
+gfx.window_width=-1
+
+# Windowed height, -1 for default size
+gfx.window_height=-1
+
+# Windowed X, -1 for default X position
+gfx.window_x=-1
+
+# Windowed Y, -1 for default Y position
+gfx.window_y=-1
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9ex device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Orientation to force monitor into, -1 to use default, 0, 1, 2, 3 to do 0, 90, 180, 270 degrees
+gfx.force_orientation=-1
+
+# Force a screen resolution (width), -1 to disable. Use this if the game does not auto detect your monitor's resolution properly, e.g. 1368x768 instead of 1280x720.
+gfx.force_screen_res.width=-1
+
+# Force a screen resolution (height), -1 to disable. Use this if the game does not auto detect your monitor's resolution properly, e.g. 1368x768 instead of 1280x720.
+gfx.force_screen_res.height=-1
+
+# IP of adapter to force override with
+adapter.override_ip=
+
+# Force ASIO audio mode/device (if applicable / TDJ default)
+asio.force_asio=false
+
+# Force WASAPI audio mode (if applicable / LDJ default)
+asio.force_wasapi=true
+
+# The ASIO device name to use
+asio.device_name=XONAR SOUND CARD(64)
+

dist/iidx/iidxhook-30.conf

@@ -0,0 +1,84 @@
+# Disable card reader emulation and enable usage of real card reader hardware on COM1 (for games supporting slotted readers)
+io.disable_card_reader_emu=false
+
+# Disable BIO2 emulation and enable usage of real BIO2 hardware
+io.disable_bio2_emu=false
+
+# Disables the poll limiter, warning very high CPU usage may arise
+io.disable_poll_limiter=false
+
+# Lightning cab mode (requires additional IO emulation)
+io.lightning_mode=false
+
+# Disable camera connection
+io.disable_cams=true
+
+# Disables the built in file hooks, requiring manual file creation
+io.disable_file_hooks=false
+
+# Turntable sensitivity multiplier (1.0 is default)
+io.tt_multiplier=1.0
+
+# Disables the camera emulation
+cam.disable_emu=true
+
+# Disable camera 1. Use, i.e., if you only have one camera and want it to be mapped to camera 2 ingame.
+cam.disable_camera1=true
+
+# Disable camera 2. Use, i.e., if you have more than one camera but only want to map camera 1 ingame.
+cam.disable_camera2=false
+
+# Override camera device ID detection (copy from device manager, do not escape)
+cam.device_id1=
+
+# Override camera device ID detection (copy from device manager, do not escape)
+cam.device_id2=
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=true
+
+# Run the game windowed
+gfx.windowed=false
+
+# Confine mouse cursor to window
+gfx.confined=false
+
+# Windowed width, -1 for default size
+gfx.window_width=-1
+
+# Windowed height, -1 for default size
+gfx.window_height=-1
+
+# Windowed X, -1 for default X position
+gfx.window_x=-1
+
+# Windowed Y, -1 for default Y position
+gfx.window_y=-1
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9ex device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Orientation to force monitor into, -1 to use default, 0, 1, 2, 3 to do 0, 90, 180, 270 degrees
+gfx.force_orientation=-1
+
+# Force a screen resolution (width), -1 to disable. Use this if the game does not auto detect your monitor's resolution properly, e.g. 1368x768 instead of 1280x720.
+gfx.force_screen_res.width=-1
+
+# Force a screen resolution (height), -1 to disable. Use this if the game does not auto detect your monitor's resolution properly, e.g. 1368x768 instead of 1280x720.
+gfx.force_screen_res.height=-1
+
+# IP of adapter to force override with
+adapter.override_ip=
+
+# Force ASIO audio mode/device (if applicable / TDJ default)
+asio.force_asio=false
+
+# Force WASAPI audio mode (if applicable / LDJ default)
+asio.force_wasapi=true
+
+# The ASIO device name to use
+asio.device_name=XONAR SOUND CARD(64)
+

dist/iidx/iidxio-bio2.conf

@@ -0,0 +1,8 @@
+# Autodetect BIO2 port (default: on)
+bio2.autodetect=true
+
+# BIO2 serial port. Optional, if autodetect property is turned on
+bio2.port=COM4
+
+# BIO2 bus baudrate (real devices expect 115200)
+bio2.baud=115200

dist/iidx/vigem-iidxio.conf

@@ -0,0 +1,26 @@
+# Use relative mode analog mapping instead of absolute analog values
+vigem.iidxio.tt.anlog.relative=false
+
+# Sensitivity value for relative mode (1 to 32767). Tweak if you are having issues with jittering/misfiring/unresponsiveness
+vigem.iidxio.tt.anlog.relative_sensitivity=1024
+
+# Button turntable: "debounce" value (1 to 50, recommend 20). Tweak if you are having issues with TT button misfiring/unresponsiveness
+vigem.iidxio.tt.button.debounce=20
+
+# Button turntable: minimum ticks required within (debounce * 2) ms to register movement (1 to 4, recommend 2). Tweak if you button input is too (un-) responsive
+vigem.iidxio.tt.button.threshold=2
+
+# Print verbose debug output to the console for debugging turntable sensitivity issues
+vigem.iidxio.tt.debug_output=false
+
+# Enable input based key lighting
+vigem.iidxio.cab_light.enable_keylight=true
+
+# Different cabinet light modes: 0 = off, 1 = neons sequence, 2 = neons flash on TT spin
+vigem.iidxio.cab_light.light_mode=0
+
+# Display text on 16seg. If text exceeds 9 char display limit, it will scroll + cycle
+vigem.iidxio.cab_light.text_16seg=
+
+# Cycle time/scroll speed for text exceeding 16seg display length (9) to scroll from right
+vigem.iidxio.cab_light.text_scroll_cycle_time_ms=500

dist/jb/config.bat

@@ -1 +1 @@
-@start config jb
+@start config.exe jb

dist/jb/eamio-icc.conf

@@ -0,0 +1,5 @@
+# ICCA serial port
+icc.port=COM2
+
+# ICCA bus baudrate (real devices expect 57600)
+icc.baud=57600

dist/jb/gamestart-02.bat

@@ -0,0 +1,7 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist dev\nvram mkdir dev\nvram
+
+inject jbhook1.dll jubeat.exe --config jbhook-02.conf %*

dist/jb/gamestart-03.bat

@@ -0,0 +1,11 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist dev\nvram mkdir dev\nvram
+if not exist dev\nvram\ea3-config.xml copy prop\ea3-config.xml dev\nvram\ea3-config.xml
+if not exist dev\nvram\coin.xml copy prop\defaults\coin.xml dev\nvram\coin.xml
+if not exist dev\nvram\eacoin.xml copy prop\defaults\eacoin.xml dev\nvram\eacoin.xml
+if not exist dev\raw mkdir dev\raw
+
+launcher -H 33554432 -K jbhook2.dll jubeat.dll -v

dist/jb/gamestart-04.bat

@@ -3,8 +3,9 @@
 cd /d %~dp0
 
 if not exist dev\nvram mkdir dev\nvram
+if not exist dev\nvram\ea3-config.xml copy prop\ea3-config.xml dev\nvram\ea3-config.xml
 if not exist dev\nvram\coin.xml copy prop\defaults\coin.xml dev\nvram\coin.xml
 if not exist dev\nvram\eacoin.xml copy prop\defaults\eacoin.xml dev\nvram\eacoin.xml
 if not exist dev\raw mkdir dev\raw
 
-launcher -K jbhook.dll jubeat.dll
+launcher -H 33554432 -K jbhook3.dll jubeat.dll

dist/jb/jbhook-01.conf

@@ -1,6 +1,9 @@
 # Run the game windowed
 gfx.windowed=false
 
+# rotate the normally-horizontal game window to be vertical
+gfx.vertical=true
+
 # 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
 

dist/jb/jbhook-02.conf

@@ -0,0 +1,18 @@
+# Run the game windowed
+gfx.windowed=false
+
+# rotate the normally-horizontal game window to be vertical
+gfx.vertical=true
+
+# 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=0101020304050607086F
+
+# EAMID
+eamuse.eamid=0101020304050607086F
+
+# Mcode of the game to run.
+security.mcode=GCI44JAA
+

dist/jb/jbio-h44b.conf

@@ -0,0 +1,5 @@
+# H44B serial port
+h44b.port=COM2
+
+# H44B bus baudrate (real devices expect 57600)
+h44b.baud=57600

dist/old/config-dm.bat

@@ -1 +1 @@
-@start config dm
+@start config.exe dm

dist/old/config-gf.bat

@@ -1 +1 @@
-@start config gf
+@start config.exe gf

dist/old/config-pnm.bat

@@ -1 +1 @@
-@start config pnm
+@start config.exe pnm

dist/old/config-sdvx.bat

@@ -1 +1 @@
-@start config sdvx
+@start config.exe sdvx

dist/popn/config.bat

@@ -0,0 +1 @@
+@start config.exe pnm

dist/popn/gamestart-15.bat

@@ -0,0 +1,16 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist e\bookkeeping mkdir e\bookkeeping
+if not exist e\CONF\NVRAM mkdir e\CONF\NVRAM
+if not exist e\CONF\NVRAM\0 mkdir e\CONF\NVRAM\0
+if not exist e\CONF\NVRAM\1 mkdir e\CONF\NVRAM\1
+if not exist e\CONF\NVRAM\2 mkdir e\CONF\NVRAM\2
+if not exist e\CONF\NVRAM\3 mkdir e\CONF\NVRAM\3
+if not exist e\CONF\RAW mkdir e\CONF\RAW
+if not exist e\settings mkdir e\settings
+if not exist e\UP mkdir e\UP
+
+inject popnhook1.dll ezusb.dll=ezusb2-popn-shim.dll popn15.exe --config popnhook-15.conf %*
+

dist/popn/gamestart-16.bat

@@ -0,0 +1,16 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist e\bookkeeping mkdir e\bookkeeping
+if not exist e\CONF\NVRAM mkdir e\CONF\NVRAM
+if not exist e\CONF\NVRAM\0 mkdir e\CONF\NVRAM\0
+if not exist e\CONF\NVRAM\1 mkdir e\CONF\NVRAM\1
+if not exist e\CONF\NVRAM\2 mkdir e\CONF\NVRAM\2
+if not exist e\CONF\NVRAM\3 mkdir e\CONF\NVRAM\3
+if not exist e\CONF\RAW mkdir e\CONF\RAW
+if not exist e\settings mkdir e\settings
+if not exist e\UP mkdir e\UP
+
+inject popnhook1.dll ezusb.dll=ezusb2-popn-shim.dll popn16.exe --config popnhook-16.conf %*
+

dist/popn/gamestart-17.bat

@@ -0,0 +1,16 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist e\bookkeeping mkdir e\bookkeeping
+if not exist e\CONF\NVRAM mkdir e\CONF\NVRAM
+if not exist e\CONF\NVRAM\0 mkdir e\CONF\NVRAM\0
+if not exist e\CONF\NVRAM\1 mkdir e\CONF\NVRAM\1
+if not exist e\CONF\NVRAM\2 mkdir e\CONF\NVRAM\2
+if not exist e\CONF\NVRAM\3 mkdir e\CONF\NVRAM\3
+if not exist e\CONF\RAW mkdir e\CONF\RAW
+if not exist e\settings mkdir e\settings
+if not exist e\UP mkdir e\UP
+
+inject popnhook1.dll ezusb.dll=ezusb2-popn-shim.dll popn17.exe --config popnhook-17.conf %*
+

dist/popn/gamestart-18.bat

@@ -0,0 +1,16 @@
+@echo off
+
+cd /d %~dp0
+
+if not exist e\bookkeeping mkdir e\bookkeeping
+if not exist e\CONF\NVRAM mkdir e\CONF\NVRAM
+if not exist e\CONF\NVRAM\0 mkdir e\CONF\NVRAM\0
+if not exist e\CONF\NVRAM\1 mkdir e\CONF\NVRAM\1
+if not exist e\CONF\NVRAM\2 mkdir e\CONF\NVRAM\2
+if not exist e\CONF\NVRAM\3 mkdir e\CONF\NVRAM\3
+if not exist e\CONF\RAW mkdir e\CONF\RAW
+if not exist e\settings mkdir e\settings
+if not exist e\UP mkdir e\UP
+
+inject popnhook1.dll ezusb.dll=ezusb2-popn-shim.dll popn18.exe --config popnhook-18.conf %*
+

dist/popn/popnhook-15.conf

@@ -0,0 +1,23 @@
+# 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=0101020304050607086F
+
+# EAMID
+eamuse.eamid=0101020304050607086F
+
+# Run the game windowed
+gfx.windowed=false
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=false
+
+# Windowed width, 0 for default size
+gfx.window_width=0
+
+# Windowed height, 0 for default size
+gfx.window_height=0
+
+# Security black plug mcode id string (e.g. GQC02JAA).
+sec.black_plug_mcode=GQG15JAA

dist/popn/popnhook-16.conf

@@ -0,0 +1,23 @@
+# 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=0101020304050607086F
+
+# EAMID
+eamuse.eamid=0101020304050607086F
+
+# Run the game windowed
+gfx.windowed=false
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=false
+
+# Windowed width, 0 for default size
+gfx.window_width=0
+
+# Windowed height, 0 for default size
+gfx.window_height=0
+
+# Security black plug mcode id string (e.g. GQC02JAA).
+sec.black_plug_mcode=GQH16JAA

dist/popn/popnhook-17.conf

@@ -0,0 +1,23 @@
+# 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=0101020304050607086F
+
+# EAMID
+eamuse.eamid=0101020304050607086F
+
+# Run the game windowed
+gfx.windowed=false
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=false
+
+# Windowed width, 0 for default size
+gfx.window_width=0
+
+# Windowed height, 0 for default size
+gfx.window_height=0
+
+# Security black plug mcode id string (e.g. GQC02JAA).
+sec.black_plug_mcode=GQI17JAA

dist/popn/popnhook-18.conf

@@ -0,0 +1,23 @@
+# 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=0101020304050607086F
+
+# EAMID
+eamuse.eamid=0101020304050607086F
+
+# Run the game windowed
+gfx.windowed=false
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=false
+
+# Windowed width, 0 for default size
+gfx.window_width=0
+
+# Windowed height, 0 for default size
+gfx.window_height=0
+
+# Security black plug mcode id string (e.g. GQC02JAA).
+sec.black_plug_mcode=GCJ39JAA

dist/sdvx/config.bat

@@ -1 +1 @@
-@start config sdvx
+@start config.exe sdvx

dist/sdvx5/config.bat

@@ -0,0 +1 @@
+@start config.exe sdvx

dist/sdvx5/gamestart-cn.bat

@@ -0,0 +1,17 @@
+@echo off
+cd /d %~dp0
+
+if not exist dev mkdir dev
+if not exist dev\e mkdir dev\e
+if not exist dev\g mkdir dev\g
+if not exist dev\nvram mkdir dev\nvram
+if not exist dev\raw mkdir dev\raw
+if not exist dev\raw\c.dest echo $null >> dev\raw\c.dest
+if not exist dev\raw\log mkdir dev\raw\log
+if not exist dev\raw\fscache mkdir dev\raw\fscache
+
+for /R prop\defaults %%D in (*.*) do (
+    if not exist dev\nvram\%%~nxD copy /y prop\defaults\%%~nxD dev\nvram
+)
+
+launcher -H 268435456 -K sdvxhook2-cn.dll soundvoltex.dll --config sdvxhook2-cn.conf %*

dist/sdvx5/gamestart.bat

@@ -0,0 +1,16 @@
+@echo off
+cd /d %~dp0
+
+if not exist dev mkdir dev
+if not exist dev\e mkdir dev\e
+if not exist dev\g mkdir dev\g
+if not exist dev\nvram mkdir dev\nvram
+if not exist dev\raw mkdir dev\raw
+if not exist dev\raw\log mkdir dev\raw\log
+if not exist dev\raw\fscache mkdir dev\raw\fscache
+
+for /R prop\defaults %%D in (*.*) do (
+    if not exist dev\nvram\%%~nxD copy /y prop\defaults\%%~nxD dev\nvram
+)
+
+launcher -H 268435456 -K sdvxhook2.dll soundvoltex.dll --config sdvxhook2.conf %*

dist/sdvx5/sdvxhook2-cn.conf

@@ -0,0 +1,24 @@
+# Disable IO emulation and enable usage of real KFCA hardware
+io.disable_io_emu=false
+
+# Path to unis version file under the prop.s folder
+cn.unis_path=prop/unis.xml
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=true
+
+# Run the game windowed
+gfx.windowed=false
+
+# Windowed width, -1 for default size
+gfx.window_width=720
+
+# Windowed height, -1 for default size
+gfx.window_height=1280
+
+# Disables the camera emulation
+cam.disable_emu=false
+
+# Override camera device ID detection (copy from device manager, do not escape)
+cam.device_id1=
+

dist/sdvx5/sdvxhook2.conf

@@ -0,0 +1,69 @@
+# Disable card reader emulation and enable usage of real card reader hardware on COM2
+io.disable_card_reader_emu=false
+
+# Disable BIO2 emulation and enable usage of real BIO2 hardware
+io.disable_bio2_emu=false
+
+# Disables the poll limiter, warning very high CPU usage may arise
+io.disable_poll_limiter=false
+
+# Forces game to think headphones are attached
+io.force_headphones=false
+
+# Disables the built in file hooks, requiring manual file creation (/dev/raw/j.dest)
+io.disable_file_hooks=false
+
+# Disables the built in power control hooks, allowing game to modify system power settings
+io.disable_power_hooks=false
+
+# Disables the built in NVAPI control hooks, allowing game to modify system monitor settings
+io.disable_nvapi_hooks=false
+
+# Emulates the card reader on COM1 instead of COM2
+io.com1_card_reader=false
+
+# Run the game in a framed window (requires windowed option)
+gfx.framed=true
+
+# Run the game windowed
+gfx.windowed=false
+
+# Confine mouse cursor to window
+gfx.confined=false
+
+# Windowed width, -1 for default size
+gfx.window_width=1080
+
+# Windowed height, -1 for default size
+gfx.window_height=1920
+
+# Windowed X, -1 for default X position
+gfx.window_x=-1
+
+# Windowed Y, -1 for default Y position
+gfx.window_y=-1
+
+# Forced refresh rate, -1 to not force any (try 59 or 60 if monitor check fails to lock on high refresh rate monitors)
+gfx.forced_refresh_rate=-1
+
+# D3D9ex device adapter (monitor), -1 to use default, 0, 1, 2 etc. to use specified adapter
+gfx.device_adapter=-1
+
+# Orientation to force monitor into, -1 to use default, 0, 1, 2, 3 to do 0, 90, 180, 270 degrees
+gfx.force_orientation=-1
+
+# Force a screen resolution (width), -1 to disable. Use this if the game does not auto detect your monitor's resolution properly, e.g. 1368x768 instead of 1280x720.
+gfx.force_screen_res.width=-1
+
+# Force a screen resolution (height), -1 to disable. Use this if the game does not auto detect your monitor's resolution properly, e.g. 1368x768 instead of 1280x720.
+gfx.force_screen_res.height=-1
+
+# Disables the camera emulation
+cam.disable_emu=false
+
+# Override camera device ID detection (copy from device manager, do not escape)
+cam.device_id1=
+
+# IP of adapter to force override with
+adapter.override_ip=
+

dist/test/run-tests.sh

@@ -25,4 +25,6 @@ wine ./security-rp2-test.exe
 wine ./security-rp3-test.exe
 wine ./util-net-test.exe
 
+wine ./inject.exe d3d9hook.dll d3d9hook-test.exe
+
 echo "All tests successful."

doc/README.md

@@ -0,0 +1,34 @@
+# Bemanitools 5 documentation
+
+This folder contains various types of documentation.
+
+Table of contents:
+
+- Game
+  - [Error codes](game-error-codes.md): List of bemani game specific error codes that you might
+    encounter during boot or gameplay with troubleshooting information
+- Key tools
+  - [Inject](inject.md): Readme for one of BT5's key applications, `inject.exe`
+  - [Launcher](launcher.md): Readme for another one of BT5's key applications, `launcher.exe`
+  - [Tools](tools/README.md): Documentation for additional user and development tooling
+- Game hooks
+  - [ddrhook](ddrhook/README.md): Documentation relevant to `ddrhook` implementations
+  - [iidxhook](iidxhook/README.md): Documentation relevant to `iidxhook` implementations
+  - [jbhook](jbhook/README.md): Documentation relevant to `jbhook` implementations
+  - [popnhook](popnhook/README.md): Documentation relevant to `popnhook` implementations
+  - [sdvxhook](sdvxhook/README.md): Documentation relevant to `sdvxhook` implementations
+- Development
+  - [API](api.md): Available APIs and IO (hardware) implementations for BT5 and instructions how to
+    use them
+  - [Architecture](architecture.md): Outline of BT5's architecture, how things are designed and why
+  - [Development](development.md): Development environment, building, releasing, etc.
+  - [Developer documentation](dev/README.md): Various lose documentation/notes by developers
+  - [Tools](tools/README.md): Documentation for additional user and development tooling
+
+## Further external documentation
+
+A list of external documentation that can be useful when dealing with bemanitools, supported data
+and hardware.
+
+- [arcade-docs](https://github.com/Shizmob/arcade-docs): An open (to read and contribute) repository
+  of arcade hardware and software documentation

doc/api.md

@@ -1,43 +1,81 @@
 # Bemanitools API
-Bemanitools introduces interfaces abstracting the IO hardware of many games. This is used to implement support for
+
-non-intended IO devices from simple keyboard support, standard gamecontrollers to custom IO boards or using real
+Bemanitools introduces interfaces abstracting the IO hardware of many games. This is used to
-hardware with the games (e.g. support for real legacy hardware).
+implement support for non-intended IO devices from simple keyboard support, standard gamecontrollers
+to custom IO boards or using real hardware with the games (e.g. support for real legacy hardware).
 
 For a list of already supported and included hardware by game, see the next section.
 
-The BT5 API separates main game IO hardware like buttons, turn tables, spinners, lights etc. (bstio, iidxio, ...) from
+The BT5 API separates main game IO hardware like buttons, turn tables, spinners, lights etc. (bstio,
-eamuse hardware like 10-key pads and card readers (eamio).
+iidxio, ...) from eamuse hardware like 10-key pads and card readers (eamio).
 
-If you want to write an implementation for your own custom piece of hardware, check out the SDK (*bemanitools*
+If you want to write an implementation for your own custom piece of hardware, check out the SDK
-sub-folder) in the source code (src.zip).
+(*bemanitools* sub-folder) in the source code (src.zip).
 
 ## Implementations
+
+### IO boards
+
 The following implementations are already shipped with BT5.
 
-* BeatStream
+- BeatStream
-    * bstio.dll (default): Keyboard, joystick and mouse input
+  - bstio.dll (default): Keyboard, joystick and mouse input
-* Dance Dance Revolution
+- Dance Dance Revolution
-    * ddrio.dll (default): Keyboard, joystick and mouse input
+  - ddrio.dll (default): Keyboard, joystick and mouse input
-    * ddrio-mm.dll: Minimaid hardware
+  - [ddrio-p3io.dll](ddrhook/ddrio-p3io.md): DDR P3IO (Dragon PCB) + EXTIO hardware
-    * ddrio-smx.dll: StepManiaX platforms
+  - ddrio-mm.dll: Minimaid hardware
-* Beatmania IIDX
+  - [ddrio-smx.dll](ddrhook/ddrio-smx.md): StepManiaX platforms
-    * iidxio.dll (default): Keyboard, joystick and mouse input
+  - [ddrio-async](ddrhook/ddrio-async.md): Wrapper/shim library to drive another ddrio in a
-    * iidxio-ezusb.dll: Ezusb (C02 IO) driver
+    dedicated IO thread
-    * iidxio-ezusb2.dll: Ezusb FX2 (IO2) driver
+- Beatmania IIDX
-* jubeat
+  - iidxio.dll (default): Keyboard, joystick and mouse input
-    * jbio.dll (default): Keyboard, joystick and mouse input
+  - [iidxio-bio2.dll](iidxhook/iidxio-bio2.md): BIO2 driver
-* SOUND VOLTEX
+  - [iidxio-ezusb.dll](iidxhook/iidxio-ezusb.md): Ezusb (C02 IO) driver
-    * sdvxio.dll (default): Keyboard, joystick and mouse input
+  - [iidxio-ezusb2.dll](iidxhook/iidxio-ezusb2.md): Ezusb FX2 (IO2) driver
+- jubeat
+  - jbio.dll (default): Keyboard, joystick and mouse input
+- pop'n music
+  - popnio.dll (default): Keyboard, joystick and mouse input
+- SOUND VOLTEX
+  - sdvxio.dll (default): Keyboard, joystick and mouse input
+  - [sdvxio-bio2.dll](sdvxhook/sdvxio-bio2.md): BIO2 driver
+  - [sdvxio-kfca.dll](sdvxhook/sdvxio-kfca.md): KFCA IO board driver
+
+### Eamuse readers
 
 Eamuse hardware support is implemented separately:
-* eamio.dll (default): Keyboard and joystick input 
+
+- eamio.dll (default): Keyboard and joystick input
+- eamio-icca.dll: Slotted/wave pass readers, required for old games with magnetic stripe cards
+
+#### ICCA readers for IIDX and port config in device manager
+
+The COM port for the card readers needs to be configured correctly in device manager. Otherwise,
+communication with the readers will fail if the settings do not align with how the game or
+bemanitools wants to operate them.
+
+Use built-in ports on your mainboard if available but an external USB to serial port dongle also
+works.
+
+- Assign `COM1` to the COM port the card readers are connected to.
+- Ensure that the following settings for the COM port you are going to use are set
+  - BAUD rate 57600
+  - Data bits 8
+  - Parity None
+  - Stop bits 1
+  - Flow control None.
 
 ## Development notes
-A DEF file for geninput.dll is included. To convert the DEF into an import library suitable for use with Visual C++, run
+
+A DEF file for geninput.dll is included. To convert the DEF into an import library suitable for use
+with Visual C++, run
+
 ```
 lib /machine:i386 /def:geninput.def
 ```
+
 from the Visual C++ command line. If you're using mingw then use dlltool:
+
 ```
 dlltool -d geninput.def -l geninput.a
 ```

doc/architecture.md

@@ -0,0 +1,239 @@
+# Bemanitools architecture
+
+This document gives you an overview of the architecture of Bemanitools (5). Why do we need this?
+This helps document the various design decisions and how everything comes together, in the end. At
+some point when things are evolving and other developers want to pick up the project, this might
+give them answers to why some things were done well or not so well. This allows them to iterate on
+the current design (document) to analyze if a change they want to apply might work out or not.
+
+Anway, enough preface...I guess you got the idea. This document will be split into several sections
+which address different aspects of the architecture.
+
+## The big picture
+
+TODO create a graphic that presents the key modules and ideas.
+
+## Detouring library functions, IAT hooking
+
+One of Bemanitools's goals is to avoid patching of executables, libraries or any game data and
+instead rely on intercepting calls to libraries to patch bugs or introduce new features. To support
+a game on a non native platform transparently, e.g. your home desktop, this allows us to intercept
+I/O communication to emulate hardware or files/filesystem features the game expects to be available.
+
+We create a so called "hook library/hook.dll" which gets injected to the target process (the game)
+before the game runs any of its application code. This is well known by the terms of dll injection
+and will not be further discussed here (google it). The injected dll will replace the function
+addresses in the IATs to detour any calls to our own handler functions before, eventually, calling
+the real function. This way, we can intercept the call and do cool things.
+
+These features are covered by the modules in the following subfolders in src/main:
+
+- hook: Essentially, this is capnhook: https://github.com/decafcode/capnhook. General tools for
+  hooking Win32 API calls.
+- hooklib: Some additional helper modules to take care of specific issues in Bemanitools, e.g. rs232
+  related stuff for ACIO.
+
+Check the modules for details.
+
+## Hooking and IRP
+
+IRP stands for "I/O request packet" and is a kernel mode structure used in Windows drivers for
+communication with the OS. The data structure describes an I/O request with parameters for that
+request avoiding function calls with large number of arguments to a driver.
+
+We make use of that "IRP pattern" by creating a flexible and maintainable abstraction layer for the
+following hooking modules:
+
+- iohook: Hook I/O (e.g. file) related calls
+- d3d9: Hook d3d9 graphics API calls
+
+An IRP handler is implemented to handle selected IRP calls based on the specified operation type.
+IRP handlers can be chained which allows splitting up different features/interceptors to different
+functions and modules allowing you to create a clear structure. At the end of the forwarding chain,
+you the real API function that maps to the abstracted operation is called. However, a handler can
+decide at any time to not forward calls which allows you to implement emulation of access to
+selected files or I/O devices.
+
+Modules that make use of this:
+
+- iidxhook-util/d3d9
+- ezusb-emu/device
+- ezusb2-emu/device
+- acioemu/emu
+
+## Bemanitools's hook libraries, let's glue everything together
+
+Bemanitools dlls to be injected into target game processes are refered to as "hook dlls" and come in
+different flavours targetting different games and often different versions of the same game
+(series), for example:
+
+- ddrhook: Hook dll for Dance Dance Revolution games
+- iidxhook1-8: Hook dlls for Beatmania IIDX, we are currently at 8 different implementations due to
+  the various iterations the game went through, related to software and hardware.
+- sdvxhook: Hook dll for SoundVoltex series
+
+The following sub-sections will give you some brief insights on each hook implementation and what
+modules were used.
+
+### bsthook
+
+TODO
+
+### ddrhook
+
+TODO
+
+### iidxhook
+
+IIDX went through so many hard- and software iterations, it's actually amazing that the development
+team(s) refactored and improved parts of the game and hardware with each iteration. However, when
+facing emulation and supporting compatibility to legacy OS platforms, it can't get any worse. On the
+bright side, IIDX helped shaping Bemanitools a lot and created a solid foundation other games can
+build on.
+
+Because of that, we have 8 iidxhook implementations supporting sometimes different software
+features/fixes and hardware. The following sub-sub-sections list the most relevant aspects and
+modules to point out common and different higher level features.
+
+Essentially, the main module file of each iidxhook implementation just glues the APIs of the modules
+it requires together. An additional configuration layer allows users to tweak some of the features.
+
+TODO go into some more detail about some differences in the hook modules, e.g. 18 to 19 look
+identical -> but different AVS versions
+
+#### iidxhook1 (9-12)
+
+- Ezusb C02 I/O emulation
+  - Setupapi emulation
+  - Full security emulation with SRAM and round plugs
+  - Full serial emulation for magstripe card readers
+  - Full game essential I/O emulation
+- d3d8 patching and extended features (superseded by d3d9 hook module + d3d8to9 wrapper)
+- clock patching
+- Font patching for Japanese chars
+- Network related patches to enable eamuse to custom servers
+- Filesystem patches to detour E and F backup drives for settings
+
+#### iidxhook2 (13)
+
+- Ezusb C02 I/O emulation
+  - Setupapi emulation
+  - Full security emulation with SRAM and round plugs
+  - Full game essential I/O emulation
+- ACIO ICCA card reader emulation, slotted readers
+- d3d8 patching and extended features (superseded by d3d9 hook module + d3d8to9 wrapper)
+- clock patching
+- Font patching for Japanese chars
+- Network related patches to enable eamuse to custom servers
+- Filesystem patches to detour E and F backup drives for settings
+
+#### iidxhook3 (14-17)
+
+- Ezusb IO2 I/O emulation
+  - Setupapi emulation
+  - Full security emulation with SRAM and round plugs
+  - Full game essential I/O emulation
+- ACIO ICCA card reader emulation, slotted readers
+- d3d9 patching and extended features
+- Font patching for Japanese chars
+- Network related patches to enable eamuse to custom servers
+- Filesystem patches to detour E and F backup drives for settings
+
+#### iidxhook4 (18)
+
+- Ezusb IO2 I/O emulation
+  - Setupapi emulation
+  - Full game essential I/O emulation
+- ACIO ICCA card reader emulation, slotted readers
+- d3d9 patching and extended features
+- Font patching for Japanese chars
+- Filesystem patches to detour E and F backup drives for settings
+
+#### iidxhook4-cn (18 CN)
+
+- Ezusb IO2 I/O emulation
+  - Setupapi emulation
+  - Full security emulation with SRAM and round plugs
+  - Full game essential I/O emulation
+- d3d9 patching and extended features
+- Font patching for Japanese chars
+- Filesystem patches to detour E and F backup drives for settings
+
+#### iidxhook5 (19)
+
+- Ezusb IO2 I/O emulation
+  - Setupapi emulation
+  - Full game essential I/O emulation
+- ACIO ICCA card reader emulation, wave pass readers
+- d3d9 patching and extended features
+- Font patching for Japanese chars
+- Filesystem patches to detour E and F backup drives for settings
+
+#### iidxhook5-cn (20 CN)
+
+- Ezusb IO2 I/O emulation
+  - Setupapi emulation
+  - Full security emulation with SRAM and round plugs
+  - Full game essential I/O emulation
+- d3d9 patching and extended features
+- Font patching for Japanese chars
+- Filesystem patches to detour E and F backup drives for settings
+
+#### iidxhook6 (20)
+
+- Ezusb IO2 I/O emulation
+  - Setupapi emulation
+  - Full game essential I/O emulation
+- ACIO ICCA card reader emulation, wave pass readers
+- d3d9 patching and extended features
+- Font patching for Japanese chars
+
+#### iidxhook7 (21-24)
+
+- Ezusb IO2 I/O emulation
+  - Setupapi emulation
+  - Full game essential I/O emulation
+- ACIO ICCA card reader emulation, wave pass readers
+- d3d9 patching and extended features
+- Font patching for Japanese chars
+
+#### iidxhook8 (25-26)
+
+- ACIO BIO2 I/O emulation
+  - Setupapi emulation
+  - Full game essential I/O emulation
+- ACIO ICCA card reader emulation, wave pass readers
+- d3d9 patching and extended features
+- Font patching for Japanese chars
+
+### jbhook
+
+TODO
+
+### popnhook
+
+TODO
+
+### sdvxhook
+
+TODO
+
+## The ezusb (emulation) stack
+
+TODO
+
+## The ACIO (emulation) stack
+
+TODO
+
+## BT5 API
+
+TODO
+
+## AVS and launcher
+
+TODO
+
+## Inject
+
+TODO

doc/ddrhook/README.md

@@ -0,0 +1,50 @@
+# ddrhook
+
+ddrhook is a collection of hook libraries for "Dance Dance Revoluion" providing emulation and
+various patches to run these games on non BemaniPC hardware and newer Windows versions.
+
+The hook libraries must be bootstrapped either using [inject](../inject.md) or
+[launcher](../launcher.md) depending on the version you want to run. Further instructions are given
+in dedicated readme files for each ddrhook version (see below).
+
+## Versions
+
+ddrhook comes in a few different flavors. The game and its engine changed over the years. Some game
+versions might require patches/parameters enabled which others don't need or have different AVS
+versions. Here is the list of supported games:
+
+- [ddrhook1](ddrhook1.md): X, X2 (US/EU regions)
+- [ddrhook2](ddrhook2.md): X2 (JP region), X3 vs. 2ndMIX, 2013, 2014, A
+
+When building bemanitools, independent packages are created for each set of games which are ready to
+be dropped on top of vanilla AC data dumps. We recommend using pristine dumps to avoid any conflicts
+with other hardcoded hacks or binary patches.
+
+## How to run
+
+To run your game with ddrhook, you have to use the inject tool to inject the DLL to the game
+process. `dist/ddr` contains bat scripts with all the important parameters configured. Further
+parameters can be added but might not be required to run the game with default settings. Further
+information on how to setup the data for each specific version are elaborated in their dedicated
+readme files.
+
+## Command line options
+
+Add the argument *-h* when running inject with ddrhook to print help/usage information with a list
+of parameters you can apply to tweak various things.
+
+## ddrio API
+
+Available implementations that can be swapped out depending on which kind of IO hardware you want to
+use:
+
+- `ddrio`: Default implementation supporting keyboard, mouse and USB game controllers
+- ddrio-mm: Support Minimaid custom interface
+- [ddrio-smx](ddrio-smx.md): Support for StepManiaX dance platforms
+- [ddrio-p3io](ddrio-p3io.md): P3IO + EXTIO driver implementation
+- [ddrio-async](ddrio-async.md): Wrapper/shim library to drive another ddrio in a dedicated IO
+  thread
+
+## Unicorntail
+
+[Instructions how to run on Chimera PCBs](unicorntail.md).

doc/ddrhook/ddrhook1.md

@@ -0,0 +1,131 @@
+# ddrhook1
+
+## Supported games
+
+The following games are supported with this hook library:
+
+- Dance Dance Revolution X
+- Dance Dance Revolution X2 (US/EU regions)
+
+The games must be bootstrapped using [inject](../inject.md).
+
+## Data setup
+
+Ensure your folder with your unpacked data looks like this:
+
+- `conf`
+- `data`
+- `ddr`
+- `ddr_YYYYMMDDRR` where `YYYYMMDDRR` corresponds to different datecodes of different versions.
+  Multiple folders of these possible
+
+`DDR.exe` files should be in `ddr` and `ddr_YYYYMMDDRR` folders.
+
+Unpack the distribution package `ddr-11.zip` into one of the folders containing a `DDR.exe` file. We
+recommend using the one with the latest datecode which denotes the latest version of the game
+including bugfixes etc.
+
+`gamestart-11.bat` as well as `ddrhook1.dll` are now expected to be located in the same folder as
+(one) `DDR.exe` file.
+
+## Running
+
+Run `gamestart-11.bat` as administrator. For the US version of the game, run `gamestart-11-us.bat`
+instead. This can be done by either by double clicking or running it from `cmd.exe`. The latter is
+recommended to have any debug output kept on screen after closing the game.
+
+This will run [inject](../inject.md) with the `ddrhook1.dll`. On first run, if you don't have a
+conguration file, e.g. `ddr-11.conf`, available in the same folder, a default one will be created
+and the game exits. Simply re-run `gamestart-11.bat` again.
+
+## Configuration ddrhook
+
+The hook library can be configured via cmd arguments or a configuration file. The latter is
+generated (*ddr-11.conf* in the same directory) on the first start of the game using the
+gamestart-XX.bat file. It contains default values for all available parameters and comments
+explaining each parameter. Please follow the comments when configuring your setup.
+
+Add the argument *-h* when running gamestart-XX.bat (e.g. *gamestart-XX.bat -h*) to print help/usage
+information with a list of all available parameters. Every parameter can be either set as command
+line argument or using a configuration file.
+
+To set a parameter from the command line, just add it as an argument after the bat file like this
+
+```
+gamestart-11.bat -p gfx.windowed=true
+```
+
+The syntax for the "key=value" is the same as in the config file. Make sure to have a pre-ceeding
+"-p" for every parameter added.
+
+However, if a parameter is specifed in the configuration file and as a command line argument, the
+command line argument overrides the config file's value.
+
+## Configure USB memory cards and edit data
+
+You can setup actual USB thumb drives mapped to a drive letter, e.g. `E:\` for player 1 and `F:\`
+for player 2, or just have them point to any local directory, e.g. `usbmem_p1` and `usbmem_p2`.
+
+Set-up your folder mappings in the [conf file or via command line args](#configuration-ddrhook) like
+follows:
+
+- Enable USB memory data emulation: `ddrhook1.usbmem_enabled=true`
+- Set P1 USB memory data path pointing to local folder `usbmem_p1` next to `DDR.EXE`:
+  `ddrhook1.usbmem_path_p1=usbmem_p1`
+- Set P1 USB memory data path pointing to local folder `usbmem_p2` next to `DDR.EXE`:
+  `ddrhook1.usbmem_path_p1=usbmem_p2`
+- Have/create a subfolder called `DDR_EDIT` on any location/USB drive you want to use
+- Name your edit data file either `DDR_EDIT_J.DAT` (for JP version) or `DDR_EDIT_U.DAT` (for US
+  version) and place it in the `DDR_EDIT` directory.
+
+For the example setup above, the full relative path of the edit file should be
+`usbmem_p1\DDR_EDIT\DDR_EDIT_J.DAT` for player 1.
+
+Note that USB memory cards are not detected by the game and the game stays silent about that if they
+do not contain edit data, your path mapping does not resolve or you misplaced or named your edit
+data file incorrectly.
+
+## Grey and glitchy arrows
+
+This is a known issue with many GPUs, typically non-Radeon GPUs.
+
+There is currently not patch available in Bemanitools for that. We assume this is an issue with
+incompatible shader code.
+
+There are solutions to hard-patch the code available elsewhere.
+
+## Troubleshooting and FAQ
+
+### Issues with background videos (not) playing
+
+The game expects you have the `CLVSD.ax` file registered for decoding videos.
+
+Grab the `CLVSD.ax` file and go to *Start* > *Run* > enter `regsvr32 clvsd.ax` and execute. Make
+sure to run as Administrator, otherwise you will get errors due to invalid permissions.
+
+### Game crashes during boot
+
+If you have played a newer version of DDR, e.g. DDR 2014+, you might have the `k-clvsd.dll` codec
+registered which crashes DDR X and likely X2 (EU/US) as well.
+
+Unregister `k-clvsd.dll`, e.g. `regsvr32 /u k-clvsd.dll`, and
+[registering `CLVSD.ax`](#issues-with-background-videos-not-working).
+
+Note that `CLVSD.ax` will likely hang any newer/more recent DDR versions on startup and require you
+to use the `k-clvsd.dll` that came with the respective version instead. See
+[this section](ddrhook2.md#video-codecs-for-background-videos) for further details.
+
+### Black screen/render window without a response
+
+This symptom might have many causes, here is a list of known issues and what can be done:
+
+- If not done already, try installing
+  [DirectX Redist (June 2010)](https://www.microsoft.com/en-us/download/details.aspx?id=8109)
+- If you have an integrated/second GPU, ensure it is disabled
+- External (USB) audio devices could cause issues. Ensure you are running on on-board/integrated
+  sound cards and unplug any external audio devices.
+- [Disable fullscreen optimizations](https://devblogs.microsoft.com/directx/demystifying-full-screen-optimizations/):
+  Right click on `DDR.exe`, *Properties* > *Compatibility* > *Disable fullscreen optimizations*
+- Check if you can run `DDR.exe` without Bemanitools by simply launching it. It should at least boot
+  into a startup screen. If that isn't even possible, then it's likely not an issue with
+  Bemanitools. Note that your data path needs to be `D:\HDX` for that to work though.