Repository navigation
[Release] PaperBoat for Android – unofficial Paper Mario 64 port tuned for handhelds (Odin 3)
Hi everyone! I've been working on an unofficial Android port of PaperBoat, Harbour Masters' native PC port of Paper Mario 64, focused on making it feel at home on Android handhelds. I've been testing it on an AYN Odin 3 (Android 15).
No game files are included. You need your own Paper Mario (USA) ROM. The app extracts the game on your device the first time you import it.
- APK: [link]
- Source code (GitHub): [link]
What's new
New illustrated menus
- Main menu: a hand-drawn storybook main menu with a moving pointer, a yellow highlight, a red outline that follows the button shape, and three sparkles that follow your selection.
- Options menu: a hand-drawn Options menu with five tabs: Graphics, Audio, Controls, System and Cheats.
- The active tab is raised and highlighted, and each tab remembers where you were.
- Pause menu: an in-game pause menu, opened from the "Menu" book button at the top of the screen, with shortcuts to every settings page and Resume.
- Touch and controller: every menu works with touch and with a controller.
- Scrolling lists: long lists scroll by dragging with your finger, with momentum, plus a draggable scrollbar.
- Menu sounds: custom sounds for navigating, confirming, finishing the ROM import and errors.
- Startup: a clean black launch screen, with no grey splash.
Touch controls
- Layout: on-screen controls with a separated layout and a round analog stick.
- Layout editor: drag every button where you want it.
- Toggle in-game: you can switch the touch controls off while playing. The Menu button stays available.
Graphics options
- HD Textures: HD interface, icons and backgrounds. (optional pack, see below)
- Story Book filter: a painted storybook look with ink outlines, canvas grain and a colour grade. It's an original shader inspired by the "Story Book" GShade preset, rebuilt for OpenGL ES, and it toggles live.
- CRT filter: scanlines and a phosphor mask (CRT Shader Pack by @Lywx, adapted for Android). It also toggles live.
- Resolution, frame rate and anti-aliasing: Internal Resolution, Frame Rate (up to 120 FPS), Match Refresh Rate, MSAA and VSync.
- Texture filters: 2D Texture Filter, Dialogue Text Filter and 3D Texture Filter (Three-Point, Linear or None).
- Screen: Full Height View (no letterbox), Rounded Projector Reel and Disable Mipmaps.
- Status Bar page:
- Always Show and Scale (50–200%).
- Show or hide HP, FP, Star Power, Star Points, Coins, Star Pieces and Badges.
- Background, Flat Bottom, Flat Color, Box Width and Box Height.
- Reset Status Bar.
Gameplay options (System tab)
- Action Commands: Original, Easy, Easier or Easiest.
- Block Window: 3, 7 or 10 frames.
- Show Hidden Blocks: Original, Watt in party, Watt joined or Always.
- Toggles: Always Chuck Quizmo, Mute I Spy Sound, Prevent Loading Zone Storage, Sprint Button and Free QoL Badges.
- Game Language: English, Español or Français. (optional packs)
- Clean Text: a sharp 4K dialogue font. (optional pack)
- Button Prompts: N64, Xbox or Switch icons. (optional packs)
- Restart Game: applies language, text and button changes.
- Save management: import and export saves, and manage mods.
Cheats (Cheats tab)
- Infinite HP
- Infinite FP
- No Badge Cost
- Max Star Power
- Power Bounce Chance
- 2x Star Points and Coins
Optional packs
The HD textures, Clean Text, Xbox/Switch prompts and the Spanish/French translations are made by other people, so they are not included in the public APK or the repo.
If you have them, there are two ways to use them:
- On the installed APK: copy them to
Android/data/dev.net64.paperboat.debug/files/features/, using the file names listed inANDROID.md, then restart the game. - On your own build: drop them in
android/app/src/main/assets/features/before building.
All credit goes to their authors:
- Clean Text 4K: [author]
- Xbox Buttons: [author]
- Switch Button Prompts: [author]
- Spanish translation: [author]
- French translation: [author]
- HD Status-UI and Backgrounds: [author]
- CRT Shader Pack: @Lywx
- Story Book GShade preset (inspiration): [author]
Known limitations
- Only the USA ROM is supported. EUR and JPN aren't supported yet: the engine is built for the USA version, and they need their own extraction recipes.
- Story Book is a one-pass approximation, not the full GShade preset, because that preset is Windows-only.
- It's a work in progress. You may still run into visual glitches in some areas. Please report them with a screenshot!
- ARM64 only, OpenGL ES 3.0.
Credits
- Harbour Masters: the PaperBoat team (Bass3l, JeodC, KiritoDv, Caladius) and libultraship/Torch. This port is built entirely on their work.
- The Paper Mario decomp project.
- The authors of every optional pack listed above.
- Android port, menus and art direction: JayElDragon.
This is a fan project. It is not affiliated with Nintendo or Harbour Masters. Please dump your own copy of the game.