The above gifs are from the pokeemerald-expansion repository.
pokehns-expansion is a GBA ROM hack base that equips developers with a comprehensive toolkit for creating Pokémon ROM hacks. It provides a base with the Johto and Kanto regions.
pokehns-expansion is built on top of RHH's pokeemerald-expansion, which is itself built from pret's pokeemerald decompilation project, with features from pokemonHnS integrated. On its own it is a clone of pokemonHnS with the capability to add later-generation features.
1: This README and the rest of the documentation are very much still work in progress. They have been taken from the parent pokeemerald-expansion project and will gradually be updated over time. Please feel free to contribute to this effort.
2: The pokehns-expansion project itself is also very much still work in progress. If this point is still in the documentation, the project will only be accepting pull requests for bug fixes, feature alignment to the original pokehns project, and the pokehns 2.0 release feature list, which may be found further down this page in the PULL REQUEST SCOPE section.
3: pokehns-expansion is currently up to date with pokeemerald-expansion version 1.14.2. Incremental updates will be made as time permits after new releases of the pokeemerald-expansion master branch become available.
pokehns-expansion offers hundreds of features from various core series Pokémon games, along with popular quality-of-life enhancements designed to streamline development and improve the player experience. A full list of those featues can be found in FEATURES.md.
If you use pokehns-expansion, please credit RHH (Rom Hacking Hideout) and pokemonHnS. Optionally, include the version number for clarity.
Based off pokehns-expansion https://github.com/TixoRebel/pokehns-expansion, using RHH's pokeemerald-expansion 1.14.2 https://github.com/rh-hideout/pokeemerald-expansion/ and pokemonHnS https://github.com/PokemonHnS-Development/pokemonHnS.
Please consider crediting all contributors involved in the upstream pokeemerald-expansion project!
pokehns-expansionis not supported by thepokeemerald-expansionRHH Discord server, therefore we please ask that they are not disturbed with HnS-specific queries.pokehns-expansionsupports multiplayer functionality with other games built onpokeemerald-expansion. It is not compatible with official Pokémon games.pokehns-expansionincorporates regular updates frompokeemeraldviapokeemerald-expansion, andpokemonHnS, including bug fixes and documentation improvements.
❗❗ Important: Do not use GitHub's "Download Zip" option as it will not include commit history. This is necessary if you want to update or merge other feature branches.
If you're new to git and GitHub, Team Aqua's Asset Repo has a guide to forking and cloning the repository. Then you can follow one of the following guides:
For detailed documentation, visit the pokehns-expansion documentation page.
If you are looking to report a bug, open a pull request, or request a feature, our CONTRIBUTING.md has guides for each.
All pull requests are to be made to the development-bugfix branch.
At this time the pokehns-expansion will only accept pull requests for the following:
- Bug fixes. Current known bugs include but are not restricted to:
- Battle music mapping correction
- Battle Frontier restoration
- Feature alignment to the original
pokehnsproject. - Optimization and widening of the
IS_HNSconfiguration implementation, introduced to decrease HnS ROM size. - Restoration of the
make emeraldbuild capability, which as a long-term goal will build basepokeemerald-expansion. - The
pokehns2.0 release feature list:
- Full HGSS TM list, 100TMs
- Later gen learnsets with HnS spice
- Trainer rematches and phonecalls via pokegear
- Radio in pokegear
- GBC music player item
- Hidden items
- Restore bike and surf music
- Revert Ice Path puzzle to the GSC/HGSS boulder-in-hole puzzle
Our community uses the Pokemon Heart & Soul Discord server to communicate and organize. Most of our discussions take place there, and we welcome anybody to join us!