The legacy codebase of TumbledEmerald, kept for general use until v3's release, as well as for archival purposes.
Go to file
2022-11-15 13:27:31 +00:00
.gitlab/issue_templates Make some issue templates. 2022-10-11 00:13:07 +00:00
agbcc@d59cfb5ac1 Revert "Speed up saving some more." 2022-10-11 01:19:10 +00:00
asm import from github 2022-05-19 17:14:13 +00:00
berry_fix import from github 2022-05-19 17:14:13 +00:00
common_syms import from github 2022-05-19 17:14:13 +00:00
constants import from github 2022-05-19 17:14:13 +00:00
data Merge branch 'unionpatch' into 'main' 2022-10-11 17:52:45 +00:00
docs Lots of documentation work. 2022-10-19 00:17:53 +00:00
gflib import from github 2022-05-19 17:14:13 +00:00
graphics Revert "Replace cursor.png" 2022-10-24 12:08:58 +00:00
include Revert "Fairy type" 2022-10-12 01:20:23 +00:00
libagbsyscall import from github 2022-05-19 17:14:13 +00:00
sound import from github 2022-05-19 17:14:13 +00:00
src Revert "Fairy type" 2022-10-12 01:20:23 +00:00
tools import from github 2022-05-19 17:14:13 +00:00
.gitattributes import from github 2022-05-19 17:14:13 +00:00
.gitignore import from github 2022-05-19 17:14:13 +00:00
.gitmodules fix submodules 2022-10-11 11:39:36 +00:00
asmdiff.ps1 import from github 2022-05-19 17:14:13 +00:00
asmdiff.sh import from github 2022-05-19 17:14:13 +00:00
build_tools.sh import from github 2022-05-19 17:14:13 +00:00
charmap.txt import from github 2022-05-19 17:14:13 +00:00
CONTRIBUTING.md Lots of documentation work. 2022-10-19 00:17:53 +00:00
CREDITS.md Lots of documentation work. 2022-10-19 00:17:53 +00:00
decap.py Lots of documentation work. 2022-10-19 00:17:53 +00:00
FAQ.md Update FAQ.md 2022-10-20 10:07:41 +00:00
FEATURES.md Update some text 2022-10-11 21:41:19 +00:00
graphics_file_rules.mk Revert "Fairy type" 2022-10-12 01:20:23 +00:00
INSTALL.md Update INSTALL.md 2022-11-15 02:16:02 +00:00
json_data_rules.mk import from github 2022-05-19 17:14:13 +00:00
ld_script_modern.txt import from github 2022-05-19 17:14:13 +00:00
ld_script.txt feat: try adding a debug menu 2022-05-25 13:40:25 +00:00
make_tools.mk import from github 2022-05-19 17:14:13 +00:00
Makefile feat: try adding a debug menu 2022-05-25 13:40:25 +00:00
map_data_rules.mk import from github 2022-05-19 17:14:13 +00:00
README.md Update README.md 2022-11-15 02:23:11 +00:00
ROADMAP.md Lots of documentation work. 2022-10-19 00:17:53 +00:00
songs.mk import from github 2022-05-19 17:14:13 +00:00
spritesheet_rules.mk import from github 2022-05-19 17:14:13 +00:00
STYLE.md Lots of documentation work. 2022-10-19 00:17:53 +00:00
sym_bss.txt import from github 2022-05-19 17:14:13 +00:00
sym_common.txt import from github 2022-05-19 17:14:13 +00:00
sym_ewram.txt import from github 2022-05-19 17:14:13 +00:00

tumbledemerald

Description

tumbledemerald is a hack based on the decompilation of Pokémon Emerald by pret. The project's aim is to modify Pokémon Emerald to bring it up to the standards of modern Pokémon titles.

Installation

Compiling tumbledemerald requires a Linux-based system with the following packages installed:

  • make (or GNU make, if you have access to it specifically.)
  • gcc
  • g++
  • git
  • GNU arm-none-eabi binutils

(Bonus points for getting it to work with Clang, cmake, and non-GNU binutils, because rms gives me a headache.)

Run this command to compile agbcc, pret's toolchain:

cd <path to tumbledemerald>/agbcc && ./build.sh && ./install.sh ../

Then just run make in the root folder of the repository.

If you're new to Linux-based systems or the build system in general, I recommend using Gitpod. If you opt to go that route, here's what you need to do:

  • Click the "Gitpod" button above.
  • If you haven't signed up for GitHub, GitLab, or Bitbucket before, follow the steps provided on Gitpod's site to set up an account.
  • You should launch into a tab with a terminal window at the bottom. Wait until you see agbcc successfully installed! in the terminal window before continuing.
  • Type "make" (without the quotes) into the terminal and press "Enter".

For more detailed compilation instructions, see this document.

Usage

tumbledemerald is a Game Boy Advance game. As such, you will need an emulator to play. The only supported emulator is mGBA by endrift.

Support

If you:

  • found a bug or glitch: Create an issue using the Bug template.
  • need a save file updated: Create an issue using the Save Update template.
  • have an idea for a cool new feature: Create an issue using the Feature Request template.
  • want to contact me privately: Send me an email or send me a direct message on Mastodon.
  • want to become a contributor: Send a merge request!

We also have a forum here if you're into that!

Roadmap

For the project roadmap, please check here.

Contributing

Contributions are welcome! Please make a merge request here on GitLab using the provided template.

We're currently looking for:

  • someone who can work with GBA music (to add a custom song).
  • documentation contributions. Our documentation could use some updates!
  • Windows buildscripts.
  • volunteers to build CIA packages for tumbledemerald.
  • debug menu developers.
  • someone with a brain the size of Jupiter to un-GNU tumbledemerald.

See Installation for directions on how to set up your system to compile.

make will usually stop you if it sees something wrong with your code. If the error is too vague, try running make with the -d argument (make -d). However, the only way to be completely certain is to test.

Notes

By default, tumbledemerald does not include Wireless Adapter support. See this script to re-enable this (for playing on a Game Boy Advance flashcart, for example.)

Authors and acknowledgment

Lead developers: Supersonic and Werewolf CIA packages: Supersonic and SanicConnoissuer_91 Prebuilt ROMS: Supersonic, creepyguy256, and SanicConnoissuer_91 Features: ghoulslash, Supersonic, dunsparce9, AsparagusEduardo, surskitty, DizzyEgggg, Ketsuban (if I forgot you, please let me know!) Special thanks: SanicConnoissuer_91, Werewolf, creepyguy256, pret, Nintendo Co, Ltd., GAME FREAK, inc., Creatures, inc., and you!.

License

Due to legal reasons, tumbledemerald does not have a license. Ask ax6.

Project status

tumbledemerald is actively developed, with a new feature about once every week, if I feel like it.