hax-rs / hax

🧪 The versatile and intuitive memory hacking framework.

🧪 hax

🤔 About

hax is a Rust crate designed to make memory hacking, game hacking, cheat development, and any other low level memory based development simple, yet intuitive.

So far the project is in it's infancy, although many things are planned and we appreciate any form of contribution! We're on Discord and primarily discuss the project there, please note we request you not talk about cheat development as it is against Discord's terms of service.

💎 Features

• Various macros aimed to eliminate boilerplate

🪛 Installation & Usage

Adding hax to your project is simple, however it requires a bit of setup depending on your desired output.

External

To add hax to your external project and produce an executable, you must:

1. Add hax to your project with cargo: cargo add hax -F external
2. Inside of main.rs, attribute your entrypoint with #[hax::main]

Internal

To add hax to your internal project and produce a shared library (.dll, .dylib, .so), you must:

1. Add hax to your project with cargo: cargo add hax -F internal
2. Set the crate-type to ["cdylib"] inside of Cargo.toml
3. Inside of lib.rs, attribute your entrypoint with #[hax::main]

Kernel

👀

Bleeding edge

If you want to use the bleeding edge version of hax, you can add this to your Cargo.toml:

[dependencies.hax]
git = "https://github.com/hax-rs/hax"
package = "hax"

hax's Issues

Create the context

Should contain:

• Process:
  • Read/write memory
  • Pattern scan
  • Modules

Later:

• Config
• Overlay

Pass it as a parameter for now. Passing it globally is kinda complicated, since we need to initialize it at runtime.

Memory functionality

• Read & write process memory
• Universal? (same function signature for internal/external, change depending on feature flag in use)
• Bulk reading? (read entire struct in with one call)
• Caching values? (only read an address once and cache result)

Improve hax::main macro

• Manual mapping? (internal)
• Cleaner hooking? (internal)
  • #[hax::main(init=setup_hooks)]
• Try to do some checks?
  • Check if the crate-type is ["cdylib"] during compilation (internal)
  • Check if the process is running with sufficient privileges (external)

Feature list

Check if we can use this: https://crates.io/crates/inventory

Add basic support for other platforms

Primarily we will support Windows as it is the most popular operating system but I would love to have cross-platform code.