README.md

Doom2D - Game Boy Advance Port

A port of Doom2D to the Game Boy Advance.

---

Screenshots

Requirements

1. DevkitARM (Setup Guide)
   • Windows: Use DevkitPro Installer.
   • macOS/Linux: Install via devkitpro-pacman.

     sudo dkp-pacman -S devkitARM

   • Verify: arm-none-eabi-gcc --version
2. Python 3 for tools (e.g. build info, asset scripts).
3. Butano — included as a git submodule. After clone, run:

   git submodule update --init --recursive

---

Build

make -j$(nproc)

---

Contribution

1. Fork the repository.
2. Clone the forked repository (with submodules).
3. Create a branch for your feature.
4. Test your changes on emulators and hardware.
5. Submit a pull request.

---

Credits

• Doom2D — original game by PRIKOL Software.
• Butano by GValiente for the GBA development framework.

---

License

Code is licensed under the GNU General Public License v3.0. Original game assets may be under their respective licenses.