HXO-loader: Hybrid Xpl0it loader

A shared object (.so) auto-injector, particularly made for game hacking/modding in mind.

Features

• Automatically injects target shared object modules.
• Tweakable settings for effective module injection.
• Works on every linux system.
• Latest versions support Android, BSD systems too.

Installation

For Linux systems:

1. First of all, install the required dependencies:

   for Debian based systems:

   sudo apt install gcc binutils make patchelf

   *or, if you are in Arch based systems:

   sudo pacman -S gcc binutils make patchelf

2. Clone this repo:

   git clone https://github.com/bitwaree/HXO-loader.git
   cd HXO-loader

3. Build and install the library:

   make
   sudo make install
   

For BSD systems:

1. First of all, install the required dependencies:

   sudo pkg install gcc binutils make patchelf

2. Clone this repo:

   git clone https://github.com/bitwaree/HXO-loader.git
   cd HXO-loader/bsd

3. Build and install the library:

   make
   sudo make install
   

For Android apps:

Android is not as streight forward as other unix systems because of it's complicated security measures. The android version is made in such way so that the users won't have to root their devices in order to use it.

But to achieve this, one has to modify the apk/xapk itself. The detailed instructions can be found here.

Local Application/Game setup

1. Goto the directory you have your target game executable(s).

   cd <path to elf directory>
   

2. Copy HXO.ini to that directory. or, re-download using

   wget https://raw.githubusercontent.com/bitwaree/HXO-loader/master/HXO.ini

   NOTE: if this file is not copied, HXO-loader will proceed with default settings. It's always recomanded (but not mandatory) to copy this file to the directory.

3. Create a directory and place your .hxo hacks.

   mkdir modules

   NOTE: modules is the default folder name, but it can be changed by modifying HXO.ini

   cp <module1.so> <module2.so> <module3.so> ./modules/
   

   Now make sure your modules have a .hxo filename extention,(if not: do it manually) to make it recognisable.

4. Finally run the game using hxo-run or hxo-patch

   • For a test/temporary run (recommended for testing):

     hxo-run ./<elf-executable>

   • or, patch the elf to load hxo automatically (recommended for finalizing/distributing):

     hxo-patch <elf-executable>

So the tree should look something like this:

    Game-Dir
    ├── game.elf
    ├── game.elf.bak
    ├── HXO.ini
    ├── modules
    │   ├── hack1.hxo
    │   └── hack2.hxo
    └──...

• NOTE: Patching will change the target file, and it's going to create a backup file with a .bak extention. To remove/revert the patch just run:

  hxo-rmpatch <patched-elf-executable>

Acknowledgements

• INIh, an awesome INI file parser by Ben Hoyt, used in this project for configuration parsing.
• This entire project is distributed under the terms of GPL-v3 and LGPL-v3.

Terms of Distribution

Please read DISTRIBUTION.md for additional info.