SecondaryLifer / StarHaven

# Star Haven
A native Nintendo 3DS port of **Paper Mario** (Nintendo 64), built from the
Paper Mario decompilation. The game's own C code runs
on the 3DS; nothing is emulated.
**Star Haven contains no game data.** You need your own Paper Mario ROM (EU or US).
## Install
1. On a 3DS with custom firmware, open **FBI → Remote Install →
 Scan QR Code** and scan the code on the right. It always installs the newest release.
 You can also download `StarHaven.cia` or `StarHaven.3dsx` from
 Releases.
2. Copy your ROM to the SD card as `/3ds/StarHaven/baserom.z64` (`.z64`, `.n64` and `.v64`
 all work).
3. Start Star Haven from the HOME menu.
Full instructions: the player readme.
## Features
- EU and US versions in one package
- 60 fps (in-between frames are added), or the original 30
- Fast-forward and faster text
- Original, Fill or Wide screen, the 3D slider with a depth setting, remappable buttons
- A touch bottom screen with tabs:
 - **Stats**, with a quick-save button
 - **Map**: the world map, showing where you are
 - **Party**: tap a partner to switch to them
 - **Tattle**: every enemy Goombario has tattled so far; tap one to read the whole tattle
 - **Found**: star pieces, badges, hidden blocks and panels and item spots collected in each area
 - plus Items, and the battle menus as buttons in battle
- A randomizer, chosen when you start a new file, with a seed you can share
- 60 fps on the New 3DS family; about 30 fps on the original 3DS and 2DS, with a few extras
 off there (CIA only)
- Tells you on the bottom screen when a newer version is out (one check at start, nothing is
 downloaded; Options can turn it off)
| | | |
|:---:|:---:|:---:|
| | | |
| World map | Party: tap a partner to switch | Options |
| | | |
| Tattle log | Tap an enemy to read its tattle | Found: what you collected in each area |
| | | |
| New file: Classic or Randomizer | What the randomizer shuffles | |
## Building
See port/3ds/README.md. Everything builds in a Docker image with
devkitARM, libctru and citro3d, and needs your own ROMs in `ver/pal/` and `ver/us/`.
## Layout
| | |
|---|---|
| `port/3ds/` | the 3DS port: platform layer, renderer, audio, tools, packaging |
| `src/`, `include/`, `ver/` | the decompilation, with port changes under `#ifdef _3DS` |
| `DECOMP_README.md` | the decompilation's own readme |
## License
The port (everything under `port/3ds/` and the port's changes to the decompilation) is
licensed under the Apache License 2.0, copyright 2026 SecondaryLifer. Forks
are welcome; keep the NOTICE file and credit Star Haven by SecondaryLifer.
The decompilation itself is pmret/papermario.
## Legal
Star Haven is a fan project. It is not affiliated with or endorsed by Nintendo. *Paper Mario*
is a trademark of Nintendo. Release packages contain no Nintendo game data: images, models,
sounds and text are read from the player's own ROM at startup. The screenshots show the game
running on the port.