Toggle search
Toggle menu
12.1K
15.1K
1.2K
216.7K
GameBrew
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Nds-bootstrap: Difference between revisions

From GameBrew
More actions
← Older editNewer edit →
No edit summary
Line 6: Line 6:
|lastupdated=2025/06/24
|lastupdated=2025/06/24
|type=Title Launchers
|type=Title Launchers
|version=2.6.1
|version=2.6.2 (hotfix)
|license=GPL-3.0
|license=GPL-3.0
|download=https://github.com/DS-Homebrew/nds-bootstrap/releases
|download=https://github.com/DS-Homebrew/nds-bootstrap/releases
Line 124: Line 124:


==Changelog==
==Changelog==
'''2.6.2 (hotfix)'''
Bug fix:
* Fixed an overlooked bug where DSi-Enhanced ROMs would not boot in DSi mode without a DSi-Exclusive/DSiWare ROM set as a donor ROM.
'''2.6.1'''
'''2.6.1'''


Revision as of 02:27, 28 June 2025

nds-bootstrap
General
AuthorDS-Homebrew
TypeTitle Launchers
Version2.6.2 (hotfix)
LicenseGPL-3.0
Last Updated2025/06/24
Links
Download
Website
Source
Support Author

nds-bootstrap is an open-source application that allows Nintendo DS/DSi ROMs and homebrew to be natively utilised rather than using an emulator. nds-bootstrap works on Nintendo DSi/3DS SD cards through CFW and on Nintendo DS through flashcarts.

Note from developers:

A frontend isn't required to be used as nds-bootstrap uses an ini file to load its parameters. However, it is very much recommended. TWiLight Menu++ is a frontend for nds-bootstrap, developed by RocketRobz & co. It has 7 customizable launchers to choose from with the ability to launch emulators and other homebrew. It also includes a number of Anti-Piracy patches for the games and will automatically configure nds-bootstrap for you, with customizable per game settings.

Installation

To install nds-bootstrap, download the .7z file.

Extract the nds-bootstrap .nds files, to root:/_nds/.

For TWLMenu++ users, extract the .ver file to root:/_nds/TWiLightMenu/ (only when you are updating nds-bootstrap, as it comes bundled in TWiLight Menu++).

User guide

ROM Compatibility

nds-bootstrap supports most DS ROMs, with a few exceptions (see compatibility list).

  • You can enhance your gaming experience with cheats and faster load times than general cartridges (for games that support those features).
  • Game saving is supported too and will be saved in the .sav extention, and .pub or .prv for DSiWare.
  • Anti-Piracy patches can be loaded via IPS files, but they are not included inside the software itself.
  • nds-bootstrap also supports many homebrew applications, including games like DSCraft (please check the compatibility list above).

B4DS mode (a result of running nds-bootstrap on DS-mode flashcards with locked SCFG or DS Phat/lite):

  • Supports some DS ROMs, you can increase compatibility by inserting a DS Memory Expansion Pak.
  • Since v0.50.2 it is also possible to boot Nintendo DSi+Internet, see list of supported DSiWare titles.

Screenshots

To take screenshots directly from the hardware:

  • Open the in-game menu, select Screenshots...
  • Select the VRAM bank, in case if the screenshot looks incorrect (this feature cannot be used in B4DS mode).
  • You can now step 1 frame, while in the in-game menu (by pressing R).
  • Screenshots will be saved to screenshots.tar in sd:/_nds/nds-bootstrap/.
    • Due to hardware limitations, only screenshots of the main-set screen will be taken.
    • Limit is 50 screenshots. After reaching the limit, you cannot take any more, until you delete screenshots.tar in sd:/_nds/nds-bootstrap/, where it'll be re-created on next boot.

FAQ

Please see the FAQ page.

Controls

These do not apply to DSiWare.

L+R+Up+X (for 1 second) - Swap the screens

L+R+Down+A (for 2 seconds) - Dump RAM to sd:/_nds/nds-bootstrap, as ramDump.bin

L+R+Down+B (for 2 seconds) - Return to loader (may not work on some O3DS models, and does not work in B4DS mode)

L+Down+Select - Open the in-game menu (can be changed in the TWiLight Menu++ settings)

Screenshot (in-game menu):

R - Advance by one frame

Up/Down/Left/Right - Change VRAM bank

A - Save screenshot

B - Return to in-game menu

RAM Viewer (in-game menu):

Up/Down - Scroll

Left/Right - Fast scroll

R+Down/Up - Faster scroll

R+Left/Right - Fastest scroll

A - Enter RAM Editor

B - Return to in-game menu

Y - Specify an address to jump to

Up/Down - Increase/Decrease selected value

Left/Right - Select a value

A/B - Return to RAM Viewer/Editor at specified address

RAM Editor (in-game menu):

Up/Down/Left/Right - Select a value

A - Modify selected value

Up/Down - Increase/Decrease value by 1h

Left/Right - Increase/Decrease value by 10h

A/B - Finish modifying value

B - Return to RAM Viewer

Y - Specify an address to jump to

Up/Down - Increase/Decrease selected value

Left/Right - Select a value

A/B - Return to RAM Viewer/Editor at specified address

Media

3DS Play NDS ROM's Off Your SD Card! (TWiLightMenu) (Tech James)

Known issues

https://github.com/DS-Homebrew/nds-bootstrap/issues

Changelog

2.6.2 (hotfix)

Bug fix:

  • Fixed an overlooked bug where DSi-Enhanced ROMs would not boot in DSi mode without a DSi-Exclusive/DSiWare ROM set as a donor ROM.

2.6.1

What's new?

  • Added ROM pre-load settings (automatically activated) for more games for improved ROM reading:
    • Dragon Ball: Origins (Sound data)
    • Dragon Ball: Origins 2 (Sound data)
    • Dragon Ball Z: Supersonic Warriors 2 (Character sprites and sound data, the latter for 3DS)
    • 3DS: Kamen Rider: Dragon Knight (Everything except sound data)
  • A DSi-Exclusive/DSiWare ROM can now be used as a donor ROM in order to increase the cluster cache from 6KB (0x17B0) to 12KB (0x3000) when running a DSi-Enhanced game in DSi mode. This can be useful if nds-bootstrap shows An error has occurred. due to ROM cluster fragmentation, and you don't feel like reformatting the SD card to de-fragment the ROM.
    • If you are using a DSi, then TWLMenu++ has already set a donor ROM automatically after booting for the first time.

Bug fixes:

  • Fixed crashing with a communication error when selecting anything after connecting to My Pokemon Ranch on Wii.
    • The crash was caused by not reading the sound data due to the pre-loaded ROM data map getting cleared after selecting the Connect to Wii option in the Gen 4 Pokemon games.
  • Fixed a bug which lasted since v1.0.0, where the "Wanted!" feature in Assassin's Creed II: Discovery would crash with both screens nearly white, and no DSi/3DS camera image on the top screen.


2.6.0

What's new?

  • 3DS: Updated ROM pre-load settings for WarioWare: D.I.Y. (Europe) to pre-load all data used for the currently set language.
  • DSi/3DS: Added ROM pre-load settings (automatically activated) for more games for improved ROM reading:
    • Dragon Quest IV: Chapters of the Chosen (USA) (English Party Chat v1.2)
    • Elite Forces: Unit 77 (DSi)
    • Nanostray (DSi)
    • Nanostray 2 (DSi)
    • Stitch Jam
    • Motto! Stitch! DS: Rhythm de Rakugaki Daisakusen
  • DSi/3DS: Screen filter and/or DS Phat colors are now applied to Actimagine/Mobiclip videos!
    • When running with NTR clock speed, video resolution will be reduced in half to reduce slowdown.
  • When starting a game for the first time with this version, the ESRB splash screen (if enabled) on the top screen is now displayed at the same time as the "Please wait..." message on the bottom screen.
  • For some ESRB-rated online games which don't display the online notice (ex. Pokemon Black & White 1 & 2), it can now be displayed on the bottom screen (replacing the "Please wait..." message on first boot) below the ESRB splash screen.
    • Online notice flags are stored on TWLMenu++'s side (along with the rating descriptors).

Bug fixes:

  • DSi: Due to the pre-load setting addition, Nanostray 2 no longer crashes when going into gameplay!
  • Fixed a (somewhat) long-standing issue where Professor Layton and the Curious Village would not reset correctly from nds-bootstrap's in-game menu, instead showing video cutscenes or the puzzle mode.
  • DSi/3DS: Bomberman no longer crashes on opening an area when using a screen filter and/or DS Phat colors.
  • DSi/3DS: Fixed card read DMA not being properly patched for My Healthy Cooking Coach and possibly some other early DSi-Enhanced games.
    • The title would crash after boot without the fix.
  • DSi/3DS: Fixed games which use SDK 2.1 or later not booting from flashcards (without B4DS mode).
  • DSi/3DS: Fixed DSi mode not working on flashcards.
  • Yet another attempt to fix the in-game menu not opening on Ace3DS+ flashcards, by clearing the WiFi IRQ register on arm7 before boot.
    • Implemented after a user has found out that the in-game menu opens on Shantae: Risky's Revenge due to the WiFi IRQ register not being checked.
  • DSi/3DS: Fixed rebooting after dumping RAM.
  • DS: Fixed SuperCard CF support (not to be confused with SuperCard MiniSD).

Known bugs:

  • Screen filter and/or DS Phat colors are not applied to all games containing Mobiclip videos, as the code which plays the videos may be stored in the overlays instead of the main ARM9 code.
    • Some games where the code is stored in the overlays are supported manually.
  • Despite the pre-load setting addition, Stitch Jam still randomly soft-locks. The cause of the soft-locks is unknown.

Release notes.

Credits

Developers:

  • Rocket Robz: Lead developer, DSi mode and DSiWare support, B4DS mode, general maintenance and updates
  • shutterbug2000: SDK5 support, help with DSi mode support, and some other implemented stuff
  • ahezard: Starting the project, former lead developer
  • Pk11: In-game menu, screenshot taking, manual loading, and translation management
  • Gericom: Improving B4DS compatibility, parts of libtwl code used, Pokémon Wii connection patch, and SD -> flashcard R/W patch for DSiWare

Other:

  • devkitPro: devkitARM and libnds
  • Arisotura: BIOS reader from dsibiosdumper used in the in-game menu
  • retrogamefan & Rudolph: Included AP-patches
    • enler: Fixing AP-patch for Pokemon Black 2 (Japan) for DS⁽ⁱ⁾ mode compatibility
    • Rocket Robz: Fixing some DS⁽ⁱ⁾-Enhanced game AP-patches for DS⁽ⁱ⁾ mode compatibility
  • VeaNika: DS Phat (NTR-001) color LUT from GBARunner3

Translators:

External links

Retrieved from "https://www.gamebrew.org/index.php?title=Nds-bootstrap&oldid=200844"

Advertising: