Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

The Minish Cap 3DS

The Minish Cap 3DS

Nintendo 3DS dual-screen port of The Legend of Zelda: The Minish Cap, based on the open-source Minish Cap decompilation, Project Picori, and the dual-screen Android port.

Made with the help of Codex.

This project is based on open-source work from:

No ROM or extracted Nintendo game assets are distributed with this project. You must provide your own legally obtained compatible Game Boy Advance ROM.

Community

Join my Discord for updates, support, bug reports, testing builds, suggestions, and other Nintendo 3DS homebrew projects:

https://discord.gg/SMW49UMkw

Features

  • Native Nintendo 3DS port with full dual-screen support.
  • Supports both USA and European ROMs with automatic region detection.
  • True widescreen gameplay on the 400x240 top screen, plus Original and Stretch display modes.
  • Bottom-screen interface with live map, dungeon information, quest status, touch item controls, and settings.
  • New 3DS enhancements including 804 MHz mode, L2 cache, multi-core rendering, and optional 2x–5x turbo using the C-Stick.
  • Multiple display styles including Blur, Bilinear, Ultra Sharp, and Pixel Perfect.
  • On New Nintendo 3DS, the existing Wide + Pixel Perfect combination enables experimental Full View: compatible outdoor rooms render at 400x240, while supported interiors use a centered 200x120 view scaled exactly 2x.
  • Built-in Project Picori Randomizer support with separate normal and randomized save data.
  • Native stereo audio, persistent settings, reliable save handling, FPS tools, and diagnostic dumps for bug reports.

Performance

The port automatically selects a performance profile for the detected console.

New Nintendo 3DS keeps the full-presentation path with 804 MHz mode, L2 cache, multi-core rendering, and C-Stick turbo.

Old Nintendo 3DS uses an optimized renderer, lower-overhead audio path, and adaptive presentation-skip profile. When rendering cannot sustain 60 visual FPS, the engine can continue advancing near its 60 Hz target instead of slowing the entire game down. Input, touch, audio, and lifecycle handling continue to run on skipped presentation ticks.

The bottom-screen worker avoids redundant static redraws while keeping touch input sampled on every engine tick.

Installation

  1. Install the CIA with FBI, or use the 3DSX build with the Homebrew Launcher.
tmc-3ds-v1.3-E5.cia
  1. Create this folder on your SD card:
sdmc:/3ds/The Minish Cap 3DS/
  1. Place your legally obtained USA or European .gba ROM inside that folder.

The ROM can have any filename as long as it uses the .gba extension.

Recommended ROM

Both the USA and European versions are supported, but I highly recommend using the European ROM.

The European version is the ROM I used throughout the development and testing of this port, so it has received by far the most testing.

The USA version should be compatible, but it behaves slightly differently in some parts of the game, so you may encounter bugs that are not present when using the European version.

The European ROM also includes multiple languages, including English, so there is generally no disadvantage to using it.

Expected clean ROM SHA-1 values:

USA:    b4bd50e4131b027c334547b4524e2dbbd4227130
Europe: cff199b36ff173fb6faf152653d1bccf87c26fb7

The ROM stays on your SD card and is never included in the CIA.

Audio

Audio requires a working Nintendo 3DS DSP firmware setup.

If homebrew audio is not working, open the Luma3DS Rosalina Menu and use:

Miscellaneous options > Dump DSP firmware

Diagnostics

If you encounter a crash, graphical bug, performance problem, or anything unusual, press:

L + R + A

The port will pause and create a diagnostic dump containing screenshots, memory information, runtime state, performance data, and other information that can help identify the problem.

Dumps are saved under:

sdmc:/3ds/The Minish Cap 3DS/dumps/

Gameplay dumps also include a validated load-state.bin checkpoint. To reproduce the most recent dump, open:

Settings > Developer > Load State

The loader asks for confirmation, selects the newest dump-* folder, and rejects corrupted checkpoints or checkpoints created with a different ROM region. Older dumps that only contain save-state.bin remain supported, but they resume from the saved checkpoint rather than the exact captured position.

Please send the dump when reporting bugs whenever possible.

Releases

Every GitHub release includes:

  • Installable CIA
  • Homebrew Launcher 3DSX
  • FBI QR code
  • Source code archive

Latest release:

https://github.com/EstebanPdN/zelda-tmc-3ds/releases/latest

Building

Requirements:

  • devkitPro
  • devkitARM
  • libctru
  • Citro2D
  • Citro3D
  • CMake
  • makerom and bannertool for CIA packaging

Build with:

chmod +x platform/3ds/build.sh
./platform/3ds/build.sh

Builds are generated under:

build-3ds/game/tmc-3ds-v1.3-E5.cia
build-3ds/game/tmc-3ds-v1.3-E5.3dsx

The build does not include or embed a ROM.

Credits

License and Legal Notice

Source code is distributed under GPL-3.0. See LICENSE.

Third-party components retain their respective licenses as listed in THIRD-PARTY-LICENSES.md.

Nintendo owns The Legend of Zelda, The Minish Cap, and all associated game content.

This is an unofficial fan-made project and is not affiliated with or endorsed by Nintendo.

No ROM, extracted Nintendo game assets, save data, or firmware is distributed with this project.

关于 About

Native Nintendo 3DS port of The Legend of Zelda: The Minish Cap based on Project Picori

语言 Languages

C85.8%
C++9.8%
Assembly1.7%
Java1.2%
Xmake0.4%
Linker Script0.3%
GLSL0.3%
Python0.2%
JavaScript0.1%
Shell0.0%
CMake0.0%
Makefile0.0%
Perl0.0%
GDB0.0%
Nix0.0%
Dockerfile0.0%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
1052
Total Commits
峰值: 221次/周
Less
More

核心贡献者 Contributors