pumpitupdev / pumptools

A collection of tools to run Pump It Up games.
The Unlicense
22 stars 7 forks source link

Pumptools: The ultimate toolset to run all Linux based PIU games on any* kernel and distribution

Version: 1.12

Release history

This tool-set provides hook libraries that can be pre-loaded to run vanilla dumps of all Pump It Up games running on Linux. This also includes the only exclusive MK5 hardware based game Exceed and the MK3 Linux ports.

Public release note

Currently, the public release contains all source code required to run all games listed here. The following games however are currently not working due to missing dongle key tables and raw hdd areas (dummy files exist to allow full compilation of the project):

The required assets to run these games will follow with future releases.

Documentation

Additional documentation on different topics related to pumptools are located in the doc subfolder here.

For release distribution packages, you can find a doc.zip file inside the pumptools.zip package that contains all documentation also referenced from here:

Developers

Users

Hook libraries

Features

Games and latest versions supported

All hooks share a major set of features provided by pumptools. Therefore, common topics are covered in the main hook readme. Start there when you are setting up a game with pumptools. Additionally, refer to each dedicated hook readme for further important and required information to successfully setup and run the games.

The following games are supported and tested with the latest versions available. Earlier version might also be support and work because of the nature the hooks are implemented.

Not available, yet:

Prepare your operating system

Before you start installing and configuring anything of pumptools, read this readme on how to prepare your operating system and environment. Please also note that not every Linux distribution and different versions were tested and verified working.

Get and prepare game data

You need vanilla, i.e. non-tempered and non-decrypted, game assets as well as non-tempered executable binaries which can be pulled from legit and clean physical disks or images of them.

For setting up the games, have a look at the dedicated readme files for each hook and game.

Setup hook libraries

READ THE WHOLE README OF THE HOOK BUILD YOU WANT TO USE FIRST BEFORE DOING ANYTHING!!!

The readme files go into great detail how to setup things with various potential relevant aspects spread across the document. Being aware of them will save you a lot of puzzling and time. Furthermore, read the FAQ/troubleshooting section before as well to be aware of any known issues when you encounter them.

Building

Make sure you have the required tools installed. Once that's done, simply run

make build

to build it on your current host from the root directory of this project.

The build output is located in the build subdirectory. The built binaries can be found in build/bin and a distribution package called pumptools.zip can be found in the build subfolder.

You can also build in a docker container. The container provides the necessary build environment and also ensures compatibility regarding glibc versions.

make build-docker

The build output from the docker image is located in build/docker.

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 included with the source code.