/b2mpatch

Converts patches from BemaniPatcher to mempatch-hook format

Primary LanguageJavaScriptMIT LicenseMIT

b2mpatch

Converts patches from BemaniPatcher to mempatch-hook format

Usage

A pre-built image is available on Docker Hub.

# convert iidx 25, 26, 27 & 28 patches
docker run --rm -it -u $(id -u):$(id -g) -v $(pwd):/data aixxe/b2mpatch b2mpatch.js    \
  --dir=/data/bin/2018091900 --url=https://mon.im/bemanipatcher/iidx25ballerz.html     \
  --dir=/data/bin/2019090200 --url=https://mon.im/bemanipatcher/iidx26rootage.html     \
  --dir=/data/bin/2020092900 --url=https://mon.im/bemanipatcher/iidx27heroicverse.html \
  --dir=/data/bin/2021091500 --url=https://mon.im/bemanipatcher/iidx28bistrover.html   \
  --output=/data/patches/

A pair of --dir and --url arguments must be provided for each patcher.

  • The --dir argument should contain all executable files required by the patcher.
  • The --url argument should contain a full URL to a patcher page.

If the --output option is not defined, all converted files will be saved to the current directory.

All patches are disabled by default.

To enable a patch, remove the # prefix from the line containing the offset and bytes.

# Disabled patch
# example.exe 7E6B5 909090 33C055

# Enabled patch
example.exe CF683 9090 4DA8

Options for union-type patches are denoted by a ## prefix. Only one should be enabled at a time.

# Patch with multiple options
## Option 1 (disabled)
# example.exe 447A0B 45540F94C0 4AD3FF80F8
## Option 2 (enabled)
example.exe 447A0B 4584ED750E 4AD3FF80F8
## Option 3 (disabled)
# example.exe 447A0B 40488B00FF 4AD3FF80F8

Extra scripts

diff2patch.js can be used to generate a mempatch file from two binaries.

# generate omnimix patch using the original and modified binaries
docker run --rm -it -u $(id -u):$(id -g) -v $(pwd):/data aixxe/b2mpatch diff2patch.js \
  --original=/data/bin/2018091900/bm2dx.dll                                           \
  --modified=/data/bin/2018091900/bm2dx_omni.dll                                      \
  --patch=/data/patches/2018-09-19-omnimix.mph

b2spice.js converts BemaniPatcher patches to proposed remote patch format.

Assuming the following directory structure:

bin
└── 2023090500
    ├── 2023-09-05 (LDJ-003).dll
    ├── 2023-09-05 (LDJ-010).dll
    └── 2023-09-05 (LDJ-012).dll

docker run --rm -it -u $(id -u):$(id -g) -v $(pwd):/data aixxe/b2mpatch b2spice.js \
  --url=https://mon.im/bemanipatcher/iidx30resident.html                           \
  --prefix=LDJ --dir=/data/bin/2023090500 --output=/data/resources/