Skip to content

C0mposer/C-Game-Modding-Utility

Repository files navigation

C/C++ Game Modding Utility

Latest Downloads

UI

This utility aims to make writing mods for 5th/6th generation console games in C/C++ easier.

It handles all the tedious setup, letting you focus on actually writing code.
No manual cross-compiler setup.
No manual ISO rebuilding.
No complicated testing workflows.

Features

  • Supports PS1, PS2, GameCube, & Wii
  • Automatically downloads required compilers/toolchains for chosen platforms
  • GUI and CLI interfaces
  • Rebuild game ISO's with your code modifications
  • Live emulator injection into supported emulators for rapid testing
  • Code cave finder and every frame hook finder
  • Multi-version symbol management
  • And much more!

Click here to see the Wiki

Quick Start:

Creating a Project

  1. Click "Create New Project", and give it a name
  2. Choose your games platform
  3. Click "Extract ISO File", and choose your games .iso/.bin/.ciso/etc

2. Setup code caves & hooks

Need help finding code caves and hooks? The tool includes:

  • Codecave Finder - Scans for free memory space & debug strings
  • Auto-Hook Detection - Automatically finds every-frame functions

3. Write Your First Mod

The tool auto-generated a project with everything you need. Edit src/main.c:

// src/main.c
void ModMain(void) {
    // Your mod code here
    player_health = 100;  // Invincibility
}

Working with game symbols: Define addresses in symbols/default.txt, declare types in include/symbols.h, then use them like normal variables. Full symbol guide

3. Test Your Mod

Click Compile in the build tab to compile your mod. Then, you can either inject into your emulator to test, or build an ISO!

Recommended Tools

Supported Emulators

Gamecube/Wii Emulators

PS2 Emulators

PS1 Emulators

Bundled Tools

  • devkitPro for GCC toolchains targeted towards the Gamecube/Wii PowerPC CPU, as well as utilities for analyzing .dol files
  • ps2toolchain for GCC toolchains targeted towards the PS2 Emotion Engine CPU.
  • mkpsxiso for extracting & rebuilding PS1 disk images.
  • Ps2IsoTools for rebuilding PS2 disk images.
  • gc_fst for extracting & rebuilding Gamecube images.
  • wiimms-iso-tools for extracting & rebuilding Wii disk images.
  • DolphinTool for converting between the different GC/Wii image formats.
  • dolphin-memory-engine for interacting with Dolphin's emulator memory.
  • pine for interacting with PCSX2's emulator memory.
  • xdelta for the creation of xdelta patch files
  • 7zip for solving life's greatest mysteries
  • Real N64 CRC Tool for updating N64 rom CRC's

Special Thanks

  • Ebbe - For testing the tool, reporting bugs, and suggesting features throughout it's development
  • Wafflewizard1 - For creating the icon

Contact

If you need any help using this utility, feel free to join the community discord: Join Discord

About

A game modding utility that makes injecting C/C++ code easier.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Languages