1
0
mirror of https://github.com/djhackersdev/bemanitools.git synced 2025-01-18 23:14:02 +01:00

Add documentation: inject, launcher and iidxhooks using them

This commit is contained in:
icex2 2019-10-19 21:33:49 +02:00
parent 5aa9ad1e02
commit e96a280bde
12 changed files with 88 additions and 34 deletions

View File

@ -11,44 +11,44 @@ authentic gameplay experience, and easier support for a broader range of release
# List of supported games
* BeatStream
* BeatStream (bst.zip)
* BeatStream アニムトライヴ (bst.zip)
* BeatStream (bst.zip) using bsthook
* BeatStream アニムトライヴ (bst.zip) using bsthook
* 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)
* Dance Dance Revolution X2 (ddr-12-to-16.zip) using ddrhook
* Dance Dance Revolution X3 vs. 2ndMIX (ddr-12-to-16.zip) using ddrhook
* Dance Dance Revolution 2013 (ddr-12-to-16.zip) using ddrhook
* Dance Dance Revolution 2014 (ddr-12-to-16.zip) using ddrhook
* Dance Dance Revolution A (ddr-12-to-16.zip) using ddrhook
* 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-to-26.zip)
* Beatmania IIDX 26 Rootage (iidx-25-to-26.zip)
* Beatmania IIDX 9th Style (iidx-09-to-12.zip) using [iidxhook1](doc/iidxhook/iidxhook1.md)
* Beatmania IIDX 10th Style (iidx-09-to-12.zip) using [iidxhook1](doc/iidxhook/iidxhook1.md)
* Beatmania IIDX 11 IIDX RED (iidx-09-to-12.zip) using [iidxhook1](doc/iidxhook/iidxhook1.md)
* Beatmania IIDX 12 HAPPY SKY (iidx-09-to-12.zip) using [iidxhook1](doc/iidxhook/iidxhook1.md)
* Beatmania IIDX 13 DistorteD (iidx-13.zip) using [iidxhook2](doc/iidxhook/iidxhook2.md)
* Beatmania IIDX 14 GOLD (iidx-14-to-17.zip) using [iidxhook3](doc/iidxhook/iidxhook3.md)
* Beatmania IIDX 15 DJ TROOPERS (iidx-14-to-17.zip) using [iidxhook3](doc/iidxhook/iidxhook3.md)
* Beatmania IIDX 16 EMPRESS (iidx-14-to-17.zip) using [iidxhook3](doc/iidxhook/iidxhook3.md)
* Beatmania IIDX 17 SIRIUS (iidx-14-to-17.zip) using [iidxhook3](doc/iidxhook/iidxhook3.md)
* Beatmania IIDX 18 Resort Anthem (iidx-18.zip) using [iidxhook4](doc/iidxhook/iidxhook4.md)
* Beatmania IIDX 19 Lincle (iidx-19.zip) using [iidxhook5](doc/iidxhook/iidxhook5.md)
* Beatmania IIDX 20 Tricoro (iidx-20.zip) using [iidxhook6](doc/iidxhook/iidxhook6.md)
* Beatmania IIDX 21 SPADA (iidx-21-to-24.zip) using [iidxhook7](doc/iidxhook/iidxhook7.md)
* Beatmania IIDX 22 PENDUAL (iidx-21-to-24.zip) using [iidxhook7](doc/iidxhook/iidxhook7.md)
* Beatmania IIDX 23 copula (iidx-21-to-24.zip) using [iidxhook7](doc/iidxhook/iidxhook7.md)
* Beatmania IIDX 24 SINOBUZ (iidx-21-to-24.zip) using [iidxhook7](doc/iidxhook/iidxhook7.md)
* Beatmania IIDX 25 CANNON BALLERS (iidx-25-to-26.zip) using [iidxhook8](doc/iidxhook/iidxhook8.md)
* Beatmania IIDX 26 Rootage (iidx-25-to-26.zip) using [iidxhook8](doc/iidxhook/iidxhook8.md)
* 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)
* jubeat (experimental/buggy) (jb-01.zip) using [jbhook1](doc/jbhook1/jbhook1.md)
* jubeat saucer (fulfill) (jb-05-to-07.zip) using jbhook
* jubeat prop (jb-05-to-07.zip) using jbhook
* jubeat Qubell (jb-05-to-07.zip) using jbhook
* jubeat clan (jb-08.zip) using jbhook
* 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)
* SOUND VOLTEX BOOTH (sdvx.zip) using sdvxhook
* SOUND VOLTEX II -infinite infection- (sdvx.zip) using sdvxhook
* SOUND VOLTEX III GRAVITY WARS (sdvx.zip) using sdvxhook
* SOUND VOLTEX IV HEAVENLY HAVEN (sdvx.zip) using sdvxhook
# Supported platforms
Our main platforms are currently Windows XP and Windows 7 which are also the target platforms on the original hardware

View File

@ -4,6 +4,11 @@ iidxhook is a collection of hook libraries for BeatmaniaIIDX 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 iidxhook version
(see below).
# Versions
iidxhook comes in a few different flavors. The game and its engine changed over

View File

@ -6,6 +6,8 @@ The following games are compatible with this version of iidxhook:
* RED
* HAPPY SKY
The games must be bootstrapped using [inject](../inject.md).
# Data setup and running the game
Ensure your folder with your unpacked data looks like this:

View File

@ -3,6 +3,8 @@
The following games are compatible with this version of iidxhook:
* DistorteD
The games must be bootstrapped using [inject](../inject.md).
# Data setup and running the game
Ensure your folder with your unpacked data looks like this:

View File

@ -6,6 +6,8 @@ The following games are compatible with this version of iidxhook:
* EMPRESS
* SIRIUS
The games must be bootstrapped using [inject](../inject.md).
# Data setup and running the game
Ensure your folder with your unpacked data looks like this:

View File

@ -3,6 +3,8 @@
The following games are compatible with this version of iidxhook:
* Resort Anthem
The games must be bootstrapped using [launcher](../launcher.md).
# Data setup and running the game
We assume that you are using a clean/vanilla data dump. Ensure your ("concents")

View File

@ -3,6 +3,8 @@
The following games are compatible with this version of iidxhook:
* Lincle
The games must be bootstrapped using [launcher](../launcher.md).
# Data setup and running the game
We assume that you are using a clean/vanilla data dump. Ensure your ("concents")

View File

@ -3,6 +3,8 @@
The following games are compatible with this version of iidxhook:
* Tricoro
The games must be bootstrapped using [launcher](../launcher.md).
# Data setup and running the game
We assume that you are using a clean/vanilla data dump. Ensure your ("concents")

View File

@ -6,6 +6,8 @@ The following games are compatible with this version of iidxhook:
* copula
* SINOBUZ
The games must be bootstrapped using [launcher](../launcher.md).
# Data setup and running the game
We assume that you are using a clean/vanilla data dump. Ensure your ("concents")

View File

@ -3,6 +3,8 @@
The following games are compatible with this version of iidxhook:
* CANNON BALLERS
The games must be bootstrapped using [launcher](../launcher.md).
# Data setup and running the game
## Supported versions of Windows

18
doc/inject.md Normal file
View File

@ -0,0 +1,18 @@
# Inject
Inject is a tool that creates a process for a specified application executable
file and injects a specified list of library/dll files into the process before
it is kicked off.
Typically, the tool is run when you use one of the bat script files to start
any of the games that require its usage, e.g. older IIDX games.
It comes with further option switches for development, e.g. Halting until
a debugger is attached, outputting debug output to a logfile etc.
Just run the application without any parameters to get a usage message:
```
inject.exe
```
How inject.exe is used can be taken from the bat script files of various
(typically older) games.

15
doc/launcher.md Normal file
View File

@ -0,0 +1,15 @@
# Launcher
Launcher is a tool which is required to run the more recent titles. It sets up
the AVS environment for the target game to boot before it runs the it.
Typically, the tool is run when you use one of the bat script files to start
any of the games that require its usage, e.g. newer IIDX games.
It comes with option switches to configure the AVS environment and for
development, e.g. Halting until a debugger is attached, outputting debug
output to a logfile etc.
Just run the application without any parameters to get a usage message:
```
launcher.exe
```