GitHub - PascalPixel/alchemy: 🌋 Alchemy is a decompilation of both ☀️ Golden Sun games for Gameboy Advance · GitHub
Skip to content
PascalPixelPublic

About

🌋 Alchemy is a decompilation of both ☀️ Golden Sun games for Gameboy Advance

Topics

Resources

Stars

184 stars

Watchers

6 watching

Forks

Repository files navigation

🌋 Alchemy

Alchemy is a decompilation of the Game Boy Advance games ☀️ Golden Sun: The Broken Seal and ⚓️ Golden Sun: The Lost Age.

What is a decompilation?

Camelot wrote Golden Sun as source code, then compiled it into the 0s and 1s on the cartridge. They never released that source, so Alchemy writes it again: C code that compiles back into exactly the same 0s and 1s.

It’s like working out a cake’s exact recipe by baking new cakes until one tastes identical. It’s mad, but it works!

With the source, anyone can read how Golden Sun really works, from the damage formulas to every cutscene, and change it: rebalance it, translate it, add scenes, or build editors and ports on top of it.

What’s in it?

The source, not a game to download. Building it gives you back the games exactly as Camelot shipped them, in Japanese, English, German, Spanish, French and Italian. Every picture, song and line of dialogue is Camelot’s own, taken from the cartridge into files you can open and edit. Remakes, mods and ports can grow from it in projects of their own.

Who’s making it?

Me! I’m Pascal Pixel, and I started Alchemy in July 2026 as a hobby, to enjoy making things again after a burnout. I build it with AI coding assistants. They propose C code, the build compares it with the cartridge, and only what matches stays. I decide what to tackle next, how the code is organized and named, and what counts as finished, and when something’s broken or stuck, that’s where I dig in.

Progress tracker

The Broken Seal is fully rebuilt and builds from this repository alone, no cartridge needed. I’m still tidying up its code, naming things and writing the documentation. The Lost Age builds too and is well on its way, but the parts that aren’t rewritten yet still come from your own cartridge dump.

How much of each game's code and data is rebuilt, day by day since 16 July 2026

A map of the project's files by size

Can I build it myself?

Yes! INSTALL.md has the few commands it takes on Linux, macOS or Windows. Every build is checked against the hashes of the original cartridges, so anyone with their own copy can see it’s the same game:

Language The Broken Seal The Lost Age
Japanese 35ef9e4c9f38183ebd6a3e3923a11ce9a4333718 4c79e60962299654981628ccd99b122ef27043f7
English 5c4695205413df7db52b9a184815a07783999971 b500663220cb9bf56b9f8e8c0c544f1d6fa3a824
German c23ab91a39434623cf1a999f387d743ade1a22a6 7820b4c7ba9002b0e9be23a6f45a9ab204986438
Spanish de0bdc889594b012cad213ca83707feb81ada28b a2e3e80036195343c2713410ac14f4e329e3f40d
French 42f3b262c16cfc5bde1fa2b25016fb74046de1b3 f14855c0f8c87a95cc52189e8e3b2bd9df186322
Italian ca45e04b26b2f040ac63e679a459d21869f5f28d 57f1d005666b81645e55412658427e27099c5907

Where do I start reading?

The documentation explains how the games work underneath, like what happens in a battle round or how a town’s people and events are set up. If you’d rather start in the code, the battle effects are a good first stop: their guide explains how everything drawn during a battle, from Psynergy to summons, is put on screen, and MATCHING.md collects the plain C spellings that compile to the game's exact instructions.

Acknowledgements

Golden Sun, its characters, music, art and original code were made by Camelot Software Planning and published by Nintendo. Alchemy is an unofficial fan project, and neither company is involved with it or endorses it.

Thank you to:

  • Everyone on r/GoldenSun, for cheering Alchemy on and keeping the love for these games alive.
  • Tarpman and Karathan, who worked out the compiler and flags Camelot used.
  • Coaltergeist, for camelot-gcc, the compiler Alchemy first built with before alchemy-gcc replaced it.
  • pret, whose decompilations set the standard Alchemy measures itself against, and whose agbcc builds the games’ sound and save code.
  • Simon Lindholm, for the permuter that Alchemy Devtools reimplements in Rust.

About

🌋 Alchemy is a decompilation of both ☀️ Golden Sun games for Gameboy Advance

Topics

Resources

Stars

184 stars

Watchers

6 watching

Forks

Contributors

Languages