tumbledemerald-legacy/README.md

83 lines
4.2 KiB
Markdown
Raw Permalink Normal View History

2022-10-09 08:21:40 +02:00
# tumbledemerald
2022-05-19 19:08:11 +02:00
2022-10-19 02:17:53 +02:00
## Description
tumbledemerald is a hack based on the [decompilation](https://github.com/pret/pokeemerald) 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.
2022-05-19 19:08:11 +02:00
2022-11-15 03:23:11 +01:00
[<img src="https://img.shields.io/badge/Gitpod-Open%20workspace-orange.svg?logo=GITPOD&style=for-the-badge">](https://gitpod.io/#gitgud.io/tbld/game.git) [<img src="https://img.shields.io/badge/Mastodon-gray.svg?logo=MASTODON&style=for-the-badge">](https://social.linux.pizza/@sataa)
2022-05-19 19:08:11 +02:00
2022-10-19 02:17:53 +02:00
## Installation
Compiling tumbledemerald requires a Linux-based system with the following packages installed:
2022-08-26 18:58:47 +02:00
2022-11-15 03:19:39 +01:00
- make (or GNU make, if you have access to it specifically.)
2022-10-19 02:17:53 +02:00
- gcc
- g++
- git
- GNU arm-none-eabi binutils
2022-05-19 19:08:11 +02:00
2022-11-15 03:19:39 +01:00
(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:
2022-10-19 02:17:53 +02:00
```bash
2022-11-15 03:19:39 +01:00
cd <path to tumbledemerald>/agbcc && ./build.sh && ./install.sh ../
2022-10-19 02:17:53 +02:00
```
2022-10-19 02:31:59 +02:00
Then just run `make` in the root folder of the repository.
2022-11-15 03:21:44 +01:00
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:
2022-05-19 19:08:11 +02:00
2022-10-19 02:17:53 +02:00
- 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".
2022-05-19 19:08:11 +02:00
2022-10-19 02:17:53 +02:00
For more detailed compilation instructions, see [this](INSTALL.md) document.
2022-08-26 18:58:47 +02:00
2022-10-19 02:17:53 +02:00
## Usage
2022-10-19 02:31:59 +02:00
tumbledemerald is a Game Boy Advance game. As such, you will need an [emulator](https://mgba.io) to play. The only supported emulator is [mGBA](https://mgba.io) by endrift.
2022-05-19 19:08:11 +02:00
2022-10-19 02:17:53 +02:00
## Support
If you:
2022-05-19 19:08:11 +02:00
2022-11-15 03:23:11 +01:00
* found a bug or glitch: Create an [issue](https://gitgud.io/tbld/game/-/issues) using the Bug template.
* need a save file updated: Create an [issue](https://gitgud.io/tbld/game/-/issues) using the Save Update template.
* have an idea for a cool new feature: Create an [issue](https://gitgud.io/tbld/game/-/issues) using the Feature Request template.
2022-10-19 02:17:53 +02:00
* want to contact me privately: Send me an [email](mailto:brodmoran@gmail.com) or send me a direct message on [Mastodon](https://social.linux.pizza/@sataa).
* want to become a contributor: Send a merge request!
2022-05-19 19:08:11 +02:00
2022-10-24 14:28:31 +02:00
We also have a forum [here](https://tumbledforums.flarum.cloud/) if you're into that!
2022-10-19 02:17:53 +02:00
## Roadmap
For the project roadmap, please check [here](ROADMAP.md).
2022-05-19 19:08:11 +02:00
2022-10-19 02:17:53 +02:00
## Contributing
Contributions are welcome! Please make a merge request here on GitLab using the provided template.
2022-05-19 19:08:11 +02:00
2022-10-19 02:17:53 +02:00
We're currently looking for:
2022-05-19 19:08:11 +02:00
2022-10-19 02:17:53 +02:00
* 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.
2022-11-15 03:21:44 +01:00
* someone with a brain the size of Jupiter to un-GNU tumbledemerald.
2022-10-09 08:21:40 +02:00
2022-10-19 02:17:53 +02:00
See [Installation](#installation) for directions on how to set up your system to compile.
2022-10-09 08:21:40 +02:00
2022-10-19 02:17:53 +02:00
`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.
2022-10-24 14:28:31 +02:00
## Notes
2022-11-15 03:23:11 +01:00
By default, tumbledemerald does not include Wireless Adapter support. See [this script](https://gitgud.io/tbld/scripts/-/blob/main/enable_rfu.sh) to re-enable this (for playing on a Game Boy Advance flashcart, for example.)
2022-10-09 08:21:40 +02:00
2022-10-19 02:17:53 +02:00
## Authors and acknowledgment
2022-11-16 15:32:30 +01:00
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!)
2022-10-19 02:17:53 +02:00
Special thanks: SanicConnoissuer_91, Werewolf, creepyguy256, pret, Nintendo Co, Ltd., GAME FREAK, inc., Creatures, inc., and you!.
2022-10-09 08:21:40 +02:00
2022-10-19 02:17:53 +02:00
## License
2022-11-15 03:21:44 +01:00
Due to legal reasons, tumbledemerald does not have a license. Ask ax6.
2022-10-09 08:21:40 +02:00
2022-10-19 02:17:53 +02:00
## Project status
2022-11-15 03:21:44 +01:00
tumbledemerald is actively developed, with a new feature about once every week, if I feel like it.