1
0
mirror of https://github.com/pumpitupdev/pumptools.git synced 2024-12-18 09:25:52 +01:00
pumptools/doc/hook/exchook.md
icex2 fde943c97f doc/hook: Clarify a bunch of things regarding dependencies
- Ephasize that the games are 32-bit
- Add note about pumpnet curl deps
- Add note about indirect deps not being covered in docs
2021-03-19 16:47:40 +01:00

2.3 KiB

exchook: Exceed

This readme covers any matters that are relevant for this hook, only. Anything that applies to all hooks is covered in a main hook readme file including general data setup and a quick start guide.

Additional notable features

  • Full MK5IO emulation with API hook: Keyboard, MK6 PIUIO or your own custom IO
  • Fixed infamous hold glitch, i.e. make the damn game playable, finally

Versions supported

  • 20040325
  • 20040408

Any other version won't work, period. Pumptools has to memory patch various things like I/O because hooking them is not possible (at least not right now).

Dependencies

Make sure to read the different methods of dependency resolution available in the main hook readme file, first.

Note: Game is 32-bit, so you need to install the 32-bit versions of the dependencies!

The following direct dependencies (cmd: readelf -d piu) are required:

  • libGL.so.1
  • libGLU.so.1
  • libpthread.so.0
  • libasound.so.2
  • libz.so.1
  • libpng12.so.0
  • libc.so.6
  • libm.so.6
  • libX11.so.6
  • libstdc++.so.5

Additionally, when using piuio.so, you need the following library as well:

  • libusb-1.0.so.0

As for method 1, when using Ubuntu, the dependencies can be found in the following packages:

  • libc-bin (or gcc-multilib on a 64-bit platform)
  • libusb-1.0-0
  • libx11-6
  • zlib1g
  • libasound2

Further indirect dependencies are needed but should be taken care of automatically when using a package manager to install the direct dependencies.

Data setup

In additional to the general information applying to all hooks, this game requires all files and folders in the game folder to be in UPPERCASE on a case-sensitive file system.

Troubleshooting and FAQ

Make sure to also check the troubleshooting and FAQ section of the main hook readme. This covers various things that apply to all hooks. The following sub-sections apply mainly to this hook.

The game crashes when using the sound device hw:0

The game's sound manager relies on hardware mixing using the same device which is not supported by newer versions of alsa anymore. Instead, you have to use software mixing using the dmix device, see here.