Version: 5.49
A collection of tools to run various Bemani arcade games.
Bemanitools 5 (BT5) is the successor to Bemanitools 4 which introduces a big code cleanup and support for newer games. 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.
Browse our documentation as it might already cover various questions and concerns you are looking for or about to ask.
Read the dedicated CONTRIBUTING.md documentation.
The tl;dr version and golden rules of the sections in the document:
The following games are supported with their corresponding hook-libraries.
bst.zip): bsthookbst.zip): bsthookddr-11.zip): ddrhook1ddr-12-us.zip): ddrhook1ddr-12.zip): ddrhook2ddr-13.zip): ddrhook2ddr-14-to-18.zip): ddrhook2ddr-14-to-18.zip): ddrhook2ddr-14-to-18.zip): ddrhook2ddr-14-to-18.zip): ddrhook2ddr-14-to-18.zip): ddrhook2iidx-09-to-12.zip): iidxhook1iidx-09-to-12.zip): iidxhook1iidx-09-to-12.zip): iidxhook1iidx-09-to-12.zip): iidxhook1iidx-13.zip): iidxhook2iidx-14-to-17.zip): iidxhook3iidx-14-to-17.zip): iidxhook3iidx-14-to-17.zip): iidxhook3iidx-14-to-17.zip): iidxhook3iidx-18.zip): iidxhook4iidx-19.zip): iidxhook5iidx-20-cn.zip):
iidxhook5-cniidx-20.zip): iidxhook6iidx-21-to-24.zip): iidxhook7iidx-21-to-24.zip): iidxhook7iidx-21-to-24.zip): iidxhook7iidx-21-to-24.zip): iidxhook7iidx-25-to-26.zip): iidxhook8iidx-25-to-26.zip): iidxhook8iidx-27-to-30.zip): iidxhook9iidx-27-to-30.zip): iidxhook9iidx-27-to-30.zip): iidxhook9iidx-27-to-30.zip): iidxhook9jb-01.zip): jbhook1jb-02.zip): jbhook1jb-03.zip): jbhook2jb-04.zip): jbhook2jb-05-to-07.zip): jbhook3jb-05-to-07.zip): jbhook3jb-05-to-07.zip): jbhook3jb-08.zip): jbhook3jb-08.zip): jbhook3sdvx-01-to-04.zip): sdvxhooksdvx-01-to-04.zip): sdvxhooksdvx-01-to-04.zip): sdvxhooksdvx-01-to-04.zip): sdvxhooksdvx-05-to-06): sdvxhook2sdvx-05-to-06): sdvxhook2Our 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.
Check the 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 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.
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:
See also bemanitools-supplement for files.
See the development document.
A dedicate architecture document outlines the architecture of Bemanitools and points out the most important aspects you should know before you get started with development.
Please refer to the API documentation.
Please refer to the dedicated documentation.
Source code license is the Unlicense; you are permitted to do with this as thou wilt. For details, please refer to the LICENSE file included with the source code.