Skip to content
A RPG for the Game Boy Color -- WARNING: code base is very broken, I do not recommend re-using any code from here
Assembly Lua Python Other
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode Add VS Code tasks file Mar 18, 2018
battle Fix two battle bugs and add extended OAM support Nov 1, 2017
constants Add new tilesets Mar 19, 2018
corruptions The corruption factory has only been operating intermittently and i'm… Dec 4, 2017
doc Docs cleaned up (#10) May 15, 2018
gfx Slightly optimize palette calculation Apr 6, 2018
home Fix overworld loading incorrect bank Mar 29, 2018
images Put fixed beach tileset Feb 3, 2018
macros Clean up text macros Jan 27, 2018
main grammar May 15, 2018
maps Added potential new Startham Maze and an empty template Apr 23, 2018
rants First version of rant added May 14, 2018
save Properly init text animation slots Jan 10, 2018
sound Update DevSound Mar 8, 2018
text Remove ambiguity May 15, 2018
tileset Add new tilesets Mar 19, 2018
tools Added potential new Startham Maze and an empty template Apr 23, 2018
.gitattributes Don't display diffs for binary files Jan 19, 2018
.gitignore Created img2tileset compiler batch, updated .gitignore Mar 18, 2018
.gitmodules Remove incorrect directory Jan 19, 2018 Update RGBDS versions May 8, 2018
Makefile Make DevSound a submodule Jan 19, 2018 Add link to download page Sep 2, 2018
WinCompiler.bat Add installation instructions and clean up bins Jan 19, 2018
WinMakefile Make DevSound a submodule Jan 19, 2018
battle.asm Woops, forgot some files Aug 21, 2017
build.txt welp we forgot something Dec 18, 2017
constants.asm Add emote constants Dec 18, 2017
engine.asm Move START menu to its own file Dec 8, 2017
gfx.asm Split gfx/graphics.asm Sep 4, 2017
home.asm Merge branch 'master' of Feb 17, 2018
macros.asm Make DevSound a submodule Jan 19, 2018
main.asm Rewrite Makefile for better maintainability Aug 21, 2017
maps.asm Remove unused tileset & cleanup INCLUDEs Jan 24, 2018
save.asm Woops, forgot some files Aug 21, 2017
sound.asm Update sound.asm Mar 6, 2018
text.asm Move save.asm strings to text/ Jan 30, 2018
tileset.asm Add new tilesets Mar 19, 2018
version.txt Fix version to follow semantics Sep 4, 2017

Aevilia GB

Build status badge

A RPG for the Game Boy Color, written in pure Sharp LR35902 (aka GBz80) assembly.

Please be aware that this codebase is not updated anymore. A rewrite, not public for the moment, is being worked on.

Note : this is neither a tutorial nor a walkthrough for the game.


Download links are provided here.

Compiling The Game

Nightlies (ROM rebuilt daily) can be found here

If you want to build the ROM from source, please refer to the file.

Running The Game

To play the game, you can either play it on hardware, or use an emulator.

For hardware, we recommend the Everdrive X5 flashcart, although any flashcart should work. We may also release cartridges of the game when it's finished, depending on popularity and interest.

If you're looking for emulator advice, check out our wiki page.


Aevilia is licensed under the Apache 2.0 license (please refer to the LICENSE file).

DevSound is licensed under the MIT license (please refer to its own LICENSE file).

The gist of these licenses is that re-use of the code/assets present in these repositories is allowed, even for commercial uses, as long as the licenses are included, and the modifications are clearly stated (in the case of Aevilia's license). If you want more info, you can always read the whole licenses (although I wish that on nobody), ask us (there's contact info below), or even just google what you're allowed to do.


  • bin/aevilia.gbc
    The game's ROM. To obtain this, compile the source (refer further down)
    Load it in your favorite emulator to play.
    Except VBA. You already know the A doesn't stand for 'accuracy'.
  • bin/aevilia.sym, bin/
    Helper files for debugging, also generated when compiling. Not required if you just want to play the game.
  • bin/HUD.lua
    Load it with the game in BizHawk to obtain a nice little HUD, showing collision, interaction boxes, etc.
    Again, useful for debugging, not for playing. Except maybe if TASing, as the emulator slows down a lot (20~40 fps) while using it.
  • compiler.offline.exe,
    Help build the game on Windows.
  • tools/*
    Stuff to help building and modifying Aevilia, such as a map editor.
  • doc/*
    Incomplete (largely so) documentation on the game engine.
  • images/*
    Resources, be it original copies before they are encoded in the game, or concept art.
  • corruptions/*
    Some fun the team had while messing with corruptors and this very game. Note that all of these are older builds and ~90% are unplayable.


Most programming was done by ISSOtm.

Sound engine by DevEd and Pigu, soundtrack by DevEd.

Most graphics were drawn by Kai.

Map-making by Parzival and Charmy.


Replace "@..." with "" in any of these.

  • ISSOtm : eldredhabert0@... (if you speak French, that's my main language !)
  • DevEd : deved8@...
  • Parzival : parzivalwolfram@...
  • Charmy   : amazingcharm4757@...
You can’t perform that action at this time.