ImGui for Nintendo GameCube

A Dear ImGui example for Nintendo GameCube homebrew, featuring GX fixed-function pipeline rendering, GameCube controller input mapping, software cursor support, and ImGui::Image() with GX textures :D

Developer: Sebastián Valdés Sánchez

---

---

🌐 More projects on my portfolio: Portfolio

---

🎮 Used in CubedCube — A Voxel Engine for GameCube

This ImGui backend was developed for CubedCube, a voxel engine built from scratch for the Nintendo GameCube. It uses ImGui for real-time debug profiling, memory stats, camera info, and rendering GX textures directly in the UI.

---

🛠️ Build Instructions

Prerequisites

You need the DevKitPro toolchain installed:

• devkitPPC
• libogc

Building

make

This will generate a .dol file that can run on:

• 🎮 Real Nintendo GameCube (via homebrew launcher)
• 💻 Dolphin Emulator (for testing on PC)

Running on Dolphin

run.bat

Or directly:

"path/to/Dolphin.exe" "--exec=ImGui_NintendoGameCube.dol" --batch

---

🎮 Controls

• Left Stick: Move cursor
• A Button: Click / Interact with UI elements
• X Button: Toggle ImGui input mode
• START: Exit application

---

📁 Project Structure

.
├── src/
│   ├── main.cpp              # Main application entry
│   ├── imgui_impl_gx.cpp     # GX renderer backend
│   └── imgui_impl_gcpad.cpp  # GameCube controller backend
├── include/
│   ├── imgui_impl_gx.h       # GX backend header
│   ├── imgui_impl_gcpad.h    # Controller backend header
│   └── embedded_poyo_icon.h  # Embedded texture example
├── tools/
│   ├── premake5.lua           # Premake build configuration
│   ├── engine.lua             # Project setup
│   └── config.lua             # Build paths and platform support
├── Makefile
├── run.bat
└── README.md

---

🙏 Credits

• Dear ImGui by Omar Cornut
• DevKitPro Team - GameCube/Wii toolchain (devkitPPC + libogc)
• Dolphin Emulator - GameCube/Wii emulator for testing

---

📝 License

This project is for educational and demonstration purposes. Dear ImGui is licensed under the MIT License.

---

Made with ❤️ by Sebastián Valdés