HunMod

What's new:
- Fix: load pair of registers (arm64)

Install:
dpkg -i path/to/pptool_1.7_ARCH.deb

Uninstall:
dpkg -r pptool

Usage:
pptool [-h] [-v] [-c] [-d] [-p PATCH] [-t TARGET] [-f] libapp offset [offset ...]

Two positionnal arguments:
libapp: path to libapp.so
offset: pool pointer offset to be searched (can be multiple)
sequence of prefixed "0x" hex strings

Options:
-c use default color
-d don't display disassembly but only addresses and offset
-h, --help show help message and exit
-v, --version show program's version number and exit

Patch options:
-p PATCH, --patch PATCH
specify a pool pointer offset for replacement
prefixed "0x" hex string
the offset argument must have a single element
arm: 0x6 < offset < 0x100000 ; offset mod 4 = 3
arm64: 0xf < offset < 0x1000000 ; offset mod 8 = 0
-t TARGET, --target TARGET
specify an address to apply the change to
(all those that match by default)
must be used for each targeted address
-f overwrite the library othewise create libapp-mod.so

Each option can be placed either before or after the positional arguments.

Examples:
[Basic Search] pptool path/to/libapp.so 0x8880
[Multiple Search] pptool path/to/libapp.so 0x8880 0xad98 0xdac0
[Basic Replacement] pptool path/to/libapp.so 0x8880 -p 0xedf0
[Targeted Replacement] pptool -p 0xedf0 -t 0x12345 -t 0x23456 path/to/libapp.so 0x8880

About the results displayed:
---------- pp+0xedf0 ----------

FUNCTION OBJECT OFFSET

･1 0x3f4e04 0x3f4e94 0x90
add x17, x27, 0xe, lsl 12
ldr x17, [x17, 0xdf0]

Colomn FUNCTION: adresss of the function loading the dart object
Colomn OBjECT: loading adress of the dart object
Colomn OFFSET: difference between first and second
Displaying disassembly

Download Instructions:
● pptool_1.7_arm.deb (63 KB):
devuploads
mega4upload

● pptool_1.7_aarch64.deb (67 KB):
devuploads
mega4upload

Этот код предназначен для работы с файлом offsets.txt, который содержит информацию об офсетах (смещения) различных методов и классов. Основные этапы работы кода:

1. Парсинг файла offsets.txt
Функция parseOffsetDotTxt() считывает содержимое файла offsets.txt, извлекает данные о namespace, классе, методе и смещении, а затем формирует JSON-структуру с этими данными.


2. Класс Uclass
Этот класс используется для работы с данными о методах внутри определённого namespace и класса. С его помощью можно получить офсет конкретного метода, используя имя метода.


3. Генерация файла Global.h
Содержит структурированные офсеты, которые упрощают доступ к ним при разработке. Генерируется код, который включает указатели на методы, переменные, и другие элементы, необходимые для взлома или модификации игры.


4. Генерация файла main.cpp
Этот файл содержит функции и хуки для изменения поведения игры. Используется библиотека MSHookFunction и патчи памяти MemoryPatch для модификации поведения определённых методов, таких как перемещение, стрельба, видимость и так далее.



Основные цели кода:

Извлечение офсетов из текстового файла.

Генерация заголовочного файла Global.h для упрощённого использования офсетов в других частях проекта.

Генерация исходного файла main.cpp, где реализованы хук-функции и патчи для изменения поведения игры.


Пример использования:

Сначала пользователь указывает путь к файлу offsets.txt.

Код парсит файл и формирует данные в формате JSON.

На основании этих данных генерируются два файла: Global.h и main.cpp.


Область применения:

Этот код, вероятно, используется для модификации Android-игр с использованием библиотеки libil2cpp.so. Это типичный подход в разработке мод-меню или инструментов для читов.

Если у вас есть конкретные вопросы по коду, например, как его адаптировать под другую игру, уточните их.

The code appears to parse a file named Offsets.txt to extract metadata about namespaces, classes, methods, and their respective offsets, and then generates C++ header (Global.h) and source (main.cpp) files for use in an Android modding or reverse engineering context. It includes functionalities like hooking functions, modifying memory, and creating patches for specific offsets.

Key Points in the Code:

1. Parsing Offsets.txt:

Functions like getNameSpace, getOffset, getClass, and getMethod extract specific pieces of information from the file's content.

parseOffsetDotTxt processes the file and organizes the extracted data into a JSON-like structure.



2. Dynamic Accessor Classes (Uclass):

The Uclass class is designed to provide a way to query offsets by namespace, class, and method dynamically.



3. Global Header (Global.h):

The generated header contains a structured organization of offsets and defines variables for different features like body parts, game configurations, and camera settings.



4. Main C++ Source (main.cpp):

The main.cpp file hooks various functions and applies memory patches using offsets extracted from Offsets.txt.

The use of MemoryPatch and HOOK_LIB demonstrates modifications to the Android application at runtime.




Suggestions and Considerations:

1. Error Handling:

Enhance error handling in getFrom and other parsing functions to handle unexpected file formats or missing data gracefully.



2. Input Validation:

Ensure that Offsets.txt contains valid data and sanitize inputs to prevent injection or parsing errors.



3. Code Structure:

Consider modularizing the code further for readability and maintainability, especially for larger projects.



4. Compatibility:

Verify the offsets and generated code are compatible with the intended target architectures (e.g., armeabi-v7a, arm64-v8a) and the Android version.



5. Legal and Ethical Compliance:

Ensure the project adheres to the terms of service and legal guidelines of the target application to avoid unintended consequences.




Let me know if you'd like assistance with debugging, optimizing, or extending this code further!