Toggle search
Toggle menu
383
310
482
10.7K
Hacks Guide Wiki
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

3DS:Black screen unbrick and 3DS:Game modification: Difference between pages

From Hacks Guide Wiki
More actions
(Difference between pages)
VisualWikitext
Ajl721 (talk | contribs)
Approver
68 edits
→Section II - RTCBug: Added some small details
 
ItsCrocoSwine (talk | contribs)
Approver
636 edits
m fix category formatting
 
Line 1: Line 1:
{{shortcut|3DS:BSU}}
{{Page WIP|notes=* Could use instructions on how to modify and rebuild a CIA for ROM hacks (maybe a link to a different guide?)}}
When a 3DS boots to a black screen instead of the HOME Menu, it is usually a bad sign. This page lists common troubleshooting steps to fix this issue.
==Luma3DS game patching==
{{Main|3DS:Luma3DS/Configuration}}
[[3DS:Luma3DS|Luma3DS]] allows for the modification of a game or application without having to patch the original files. This is done by redirecting the application's file calls to a separate location containing the modified files. Because no original game files are actually being modified, this makes distribution/installation of ROM hacks simple, and even works with game cartridges. Files must be placed in a <code>/luma/titles/<Title&nbsp;ID>/</code> folder, with the Title ID of the title being modified. Luma3DS's game patching supports the following files:


The troubleshooting below should always be started at the first section. The troubleshooting will direct you to the next sections if necessary.
* <h3>External code.bin and exheader.bin loading</h3>
:: Patched <code>code.bin</code> and <code>exheader.bin</code> files can be loaded. Compressed <code>.code</code> files will not work with this feature, it must be uncompressed into a <code>code.bin</code>.


__TOC__
* <h3>IPS patching</h3>
:: IPS patches for <code>code.bin</code> are also supported, which contain only the changes to the original code rather than the entire <code>code.bin</code>. Patches should be named <code>code.ips</code> and placed instead of a patched <code>code.bin</code>.


== CFW Check ==
* <h3>LayeredFS</h3>
First, we will check if the console has CFW. This will help as it allows access to [[3DS:GodMode9|GodMode9]], a helpful tool for troubleshooting and fixing issues.
:: Files within a game or applications <code>romfs</code> folder can redirected by placing modified files within <code>/luma/titles/<Title&nbsp;ID>/romfs</code>.


# Power on your console while holding the {{B|SELECT}} button
* <h3>Locale Emulation</h3>
#* If your console boots to the [[3DS:Luma3DS/Configuration|Luma3DS configuration menu]], press {{B|START}} to save, then continue to the CFW troubleshooting section below
:: {{Main|3DS:Setting game locales}}
#* If your console doesn't boot to the Luma3DS configuration menu, do the same without the SD card inserted
:: Locale Emulation can be used to launch a title with different region settings than the system. Although Luma3DS allows for any region game to be launched, some games may crash if the system region settings are not supported. Luma3DS can use alternate locale information from a <code>locale.txt</code> file placed in the <code>/<Title&nbsp;ID>/</code> folder for a title. Follow [[3DS:Setting game locales]] for more detailed instructions.
#** If your console does boot to the Luma3DS configuration menu, your SD card wasn't inserted correctly, re-insert it and try again
#** If your console turns off right away, you have CFW and can continue to the CFW troubleshooting section below
#** If your console doesn't boot to the Luma3DS configuration menu but black-screens, your console is likely bricked without CFW, and you should continue to the stock troubleshooting section at the bottom of this page
#*** To make sure of this, hold {{Key press|SELECT|START|X|POWER}} for seven seconds while the console is powered off, then power off again, hold {{B|HOME}}, and then press {{B|POWER}} - if the notification LED [[3DS:boot9strap#LED_Status_Codes|lit up a color]] or the [[3DS:fastboot3DS|fastboot3DS]] menu appears, then you have working CFW but something is interfering with Luma. Join the Nintendo Homebrew Discord for more advanced help


== CFW troubleshooting ==
==ROM hacks==
ROM hacks are game mods that work by modifying or adding to a games files to change or add new content. ROM hacks can be made for a variety of different reasons, from making a game harder, adding new levels, translating the game to a different language, texture packs, randomization, and much more. Most ROM hacks on 3DS are distributed as unpacked files, and applied using Luma3DS's layeredfs. You can find some ROM hacks on their individual game pages; see a full list at [[:Category:Nintendo 3DS games|Category:Nintendo 3DS games]], or use the search feature.


=== Section I - Prep Work ===
===Patching using layeredfs===
{{info|Some hacks have additional files and instructions to follow that aren't covered here. Always refer to the hacks installation instructions/README if available.}}
# Download a ROM hack
# Copy the files to your SD card:
#* If the files contain a <code>/luma/</code> folder, copy it to the root of your SD card merging when asked
#* If the files contain a <code>/<Title&nbsp;ID>/</code> (16 character long) folder, copy it to <code>/luma/titles/</code>
#* If the files contain <code>/romfs/</code>, <code>code.bin</code> or <code>code.ips</code>; create a new folder in <code>/luma/titles/</code> and rename it to the Title ID of the game. Copy the <code>/romfs/</code>, <code>code.bin</code> or <code>code.ips</code> to the <code>/luma/titles/<Title&nbsp;ID>/</code> folder you just made
#** You can get the game's title ID from [http://3dsdb.com/ here] (cartridges), [https://hax0kartik.github.io/3dsdb/ here] (digital games), or from the <code>FBI&nbsp;->&nbsp;Titles</code> menu. For example the Title ID for Pokémon X is <code>0004000000055D00</code>, so modified Pokémon X files would be placed at <code>/luma/titles/0004000000055D00/</code>.
# Insert your SD card into your console
# While holding {{B|SELECT}}, power on your console to enter [[3DS:Luma3DS/Configuration|the Luma3DS configuration menu]]
# Turn on '''Enable game patching''' if it is not already enabled
# Press {{B|START}} to save and exit
{{success|Your title should now be patched using layeredfs.}}


# Follow [[3dsguide:restoring-updating-cfw.html|Restoring / Updating CFW]], then "Updating GodMode9" and "Creating a NAND backup" section on [[3DS:GodMode9/Usage]]
==Game plugins==
# Take out any inserted game cartridge
{{Main|3DS:Game plugins}}
# Continue to the next section
Plugins are add-ons that run with a game. Plugins generally come in two types, 3GX or PLG. [[3DS:Game plugins/3GX|3GX plugins]] run using Luma3DS's built in plugin loader, while [[3DS:Game plugins/PLG|PLG plugins]] can be run using [https://github.com/Nanquitas/BootNTR BootNTR]. 3GX plugins are usually newer and should generally be used if given a choice. You can find some plugins on their individual game pages; see a full list at [[:Category:Nintendo 3DS games|Category:Nintendo 3DS games]], or use the search feature.


=== Section II - RTCBug ===
==Cheat codes==
Cheat codes, or Action Replay codes, are instructions to edit memory addresses that allow for games behavior and values to be edited. These can be used in a variety of ways, from invincibility, max currency, unlocking items, and more. The two main ways to use cheats are from Luma3DS's Rosalina menu, or CTRPluginFramework's Action Replay. Using cheats with CTRPluginFramework, or a dedicated cheat plugin for the game you want to play will usually be more compatible.


# Power on your console
===Rosalina menu cheats===
# Wait ten seconds, then press {{Key press|L|Down|SELECT}} at the same time
To use cheats with Rosalina menu:
#* If the [[3DS:Luma3DS/Rosalina|Rosalina menu]] opens, you're likely experiencing [[3DS:Lumabug|RTCBug]] - return by pressing B, wait 15 minutes, remove any existing cartridge inserted, and the HOME Menu should load on its own. If this doesn't work, continue to the next section
# Place cheat files in plain text at either <code>/cheats/<Title&nbsp;ID>.txt</code> or <code>/luma/titles/<Title&nbsp;ID>/cheats.txt</code>
#* If Rosalina doesn't open, continue to the next section
#* Cheat files can be generated using [[Checkpoint]], or downloaded from [https://github.com/FlagBrew/Sharkive/tree/master/3ds the Sharkive repository].
# Open the Rosalina menu ({{B|L|D-Pad down|SELECT}} by default)
# Select <code>cheats...</code>
# Press {{B|A}} on any cheats you want activated
# Press {{B|B}} until you exit the Rosalina menu


=== Section III - Luma3DS configuration reset ===
===CTRPluginFramework Action Replay===
To use cheats with CTRPluginFramework:
# Install the latest version of [https://github.com/PabloMK7/CTRPluginFramework-BlankTemplate/releases/latest CTRPluginFramework-BlankTemplate] (the <code>.3gx</code> file) using the instructions [[3DS:Game plugins/3GX|here]]
# Place cheat files in plain text at either <code>/cheats/<Title&nbsp;ID>.txt</code> or in the same folder as the <code>.3gx</code> plugin as <code>cheats.txt</code>
#* A repository of compiled cheat codes can be found [https://github.com/iSharingan/CTRPF-AR-CHEAT-CODES here]
#* Or create your own cheats; a list of all code types supported by Action Replay can be found [https://gist.github.com/Nanquitas/d6c920a59c757cf7917c2bffa76de860 here]
# Open the Rosalina menu ({{B|L|D-Pad down|SELECT}} by default)
# Press {{B|A}} on <code>Plugin Loader:</code> to enable it
# Press {{B|B}} until you exit the Rosalina menu
# launch your game of choice
#* The screen should flash another color to indicate that the plugin has successfully loaded
#* it will say <code>Plugin ready!</code> on the top screen when it is loaded
# Press {{B|SELECT}} to open the plugin menu
# Tap on <code>Action Replay</code>
# Select the Action Replay codes you want to use
# Press {{B|SELECT}} to exit the plugin menu


# Insert the SD card into your computer
==Save editors==
# Navigate to the folder <code>sd:/luma</code>
Save editors are tools that allow game saves to be edited in order to unlock items, change game progression, edit characters or companions and more. Save editors are usually limited by what the game is already capable of doing, but can sometimes unlock items not earnable through normal gameplay. Most save editors require your save to be unencrypted; you can use a save game manager such as [[Checkpoint]] to make unencrypted backups and restore save backups. You can find some Save editors on their individual game pages; see a full list at [[:Category:Nintendo 3DS games|Category:Nintendo 3DS games]], or use the search feature.
# Delete <code>config.ini</code>
# Reinsert the SD card into your console
# Power on your console
#* If your console doesn't boot to the Luma3DS config, follow [[SD Clean]], then return to section 2
# Do not enable anything, just press {{B|START}} to save the default configuration
#* If your console boots to the HOME Menu, you should look for and delete faulty patches in <code>/luma/sysmodules</code> and <code>/luma/titles</code> on the SD card before turning <code>Enable game patching</code> or <code>Loading external FIRMs and modules</code> back on
#* If your console doesn't boot to the HOME Menu, continue to the next section
#* If your console boots to an error, check [[3DS:EXCEPTION|the Luma exceptions page]] for how to fix your error, or ask for help in the Nintendo Homebrew Discord if your error isn't listed there


=== Section IV - SD HOME Menu extdata ===
==ROM editors==
ROM editors are tools that allow game files or code to be edited in order to change how the game functions. Depending on the editor it may be able to edit textures or sounds, add new game content, make the game more/less difficult, remix content in a new way such as randomizers, and much more. You can find some ROM editors on their individual game pages; see a full list at [[:Category:Nintendo 3DS games|Category:Nintendo 3DS games]], or use the search feature.


#Power on your console without the SD card inserted
==External links==
#* If it boots to the Luma3DS configuration screen, press {{B|START}} to save
* [https://www.gamebrew.org/wiki/List_of_all_3DS_Rom_Hacks List of Rom Hacks from gamebrew]
#* If it doesn't boot to the HOME menu, continue to the next section
* [https://github.com/ItsDeidara/MegaNTR MegaNTR PLG plugin collection]
#* If it boots to the HOME Menu, do the following steps:
* [https://www.gamebrew.org/wiki/List_of_all_3DS_Rom_Hacks#Plugins-0 List of plugins from gamebrew]
#*# Insert your SD card into your computer
* [https://www.gamebrew.org/wiki/List_of_3DS_homebrew_applications#Save_Managers_and_Editors-0 save editor 3DS apps from gamebrew]
#*# Navigate to <code>Nintendo 3DS</code> -> <code>ID0</code> -> <code>ID1</code> -> <code>extdata</code>
* [https://www.romhacking.net/?page=utilities&platform=51 Romhacking.net utilities]
#*#* <code>ID0</code> and <code>ID1</code> are 32-character long folders
* [https://github.com/LumaTeam/Luma3DS/wiki/Optional-features Luma3DS/wiki/Optional-features]
#*#* If you have multiple ID0/ID1 folders, do the following for all of them
[[Category:Nintendo 3DS information]]
#*# Delete the corresponding folder for your region:  
#*#* USA: <code>0000008f</code>
#*#* EUR: <code>00000098</code>
#*#* JPN: <code>00000082</code>
#*#* KOR: <code>000000A9</code>
#*# Reinsert your SD card into your console
#*# Power on your console
#*#* If it still doesn't boot to the HOME Menu, but does without the SD card, you're experiencing a very weird issue and should ask in the Nintendo Homebrew discord for more advanced help
 
=== Section V - Safe Mode ===
 
# Power on your console while holding {{Key press|L|R|Up|A}}
#* If your console boots to the Safe Mode menu, perform the update and see if it boots to the HOME Menu
#* If it doesn't boot to Safe Mode, or doesn't boot to the HOME Menu after a Safe Mode update, continue to the next section
 
=== Section VI - ctrcheck ===
 
# Follow the instructions on [[3DS:Ctrcheck|the ctrcheck page]]
# If the console doesn't boot to the HOME Menu after all applicable fixes have been tried, continue to the next section
 
=== Section VII - New 3DS camera brick{{anchor|Section VIII - New 3DS camera brick}} ===
 
{{info|If you are currently troubleshooting an old model console, ignore this and skip to the next section.
<br>If you are unsure whether your console is new or old, look at its shoulder buttons. A new model has four ({{Key press|ZL|L|R|ZR}}), and an old model has two ({{Key press|L|R}}).}}
 
# Insert your SD card into your computer
# Navigate to the <code>/luma/</code> folder
# Look for <code>errdisp.txt</code>
## If this file already exists, rename it to <code>_errdisp.txt</code>
## If this file doesn't exist, skip to the next section
# Reinsert your SD card into the console
# Power on the console
# Wait 30 seconds without pressing any buttons
# Power off the console
# Navigate to the <code>/luma/</code> folder
# Look for <code>errdisp.txt</code>
#* If this file exists, open it in a text editor, and check if the process name is <code>qtm</code>
#** If the process name is <code>qtm</code>, you need to disconnect your inner camera or replace it
#** If the process name is something else, your console has a very unusual issue and you should ask in the Nintendo Homebrew Discord for more advanced help
#* If this file doesn't exist, continue to the next section
 
=== Section VIII - CTRTransfer{{anchor|Section VII - CTRTransfer}} ===
 
# Follow the [[3dsguide:ctrtransfer.html|CTRTransfer guide on 3DS Hacks Guide]]
#* If the console doesn't boot to the HOME Menu at the end of Section II, continue to the next section of this guide
 
=== Section IX - 3ds_hw_test ===
 
# Follow the instructions on [[3DS:Hardware test|the hardware test page]]
#* If the number of errors from this is zero, continue to the next section
 
 
===Section X - Manual CTRTransfer===
 
#Follow [[3DS:CTRTransfer/Manual]]
 
----
By this point, you have exhausted all conventional fixes. If your console has not booted to the HOME Menu by now, go to the Nintendo Homebrew Discord and mention that you've tried this page already.
 
==Stock troubleshooting==
 
===Section I - Safe Mode ===
 
# Power on your console while holding {{Key press|L|R|Up|A}}
#* If your console boots to the Safe Mode menu, perform the update and see if it boots to the HOME Menu
#* If it doesn't boot to Safe Mode, or doesn't boot to the HOME Menu after a Safe Mode update, continue to the next section
 
===Section II - Shutdown menu ===
 
# Power on the console
# Wait 30 seconds without touching any buttons
# Press the POWER button
#* If the shutdown menu opens (a grey screen with text), you're experiencing <code>f000000b</code> corruption and must install boot9strap with [[3DS:ntrboot|ntrboot]] in order to fix the issue
#* If the screen stays black and the console only powers off if you hold the button for 15 seconds, this may be potentially fixable with ntrboot if it is not a hardware issue
 
[[Category:Unbricking]]
[[Category:Nintendo 3DS guides]]

Revision as of 18:41, 6 September 2024

Luma3DS game patching

Main page: 3DS:Luma3DS/Configuration

Luma3DS allows for the modification of a game or application without having to patch the original files. This is done by redirecting the application's file calls to a separate location containing the modified files. Because no original game files are actually being modified, this makes distribution/installation of ROM hacks simple, and even works with game cartridges. Files must be placed in a /luma/titles/<Title ID>/ folder, with the Title ID of the title being modified. Luma3DS's game patching supports the following files:

  • External code.bin and exheader.bin loading

Patched code.bin and exheader.bin files can be loaded. Compressed .code files will not work with this feature, it must be uncompressed into a code.bin.

  • IPS patching

IPS patches for code.bin are also supported, which contain only the changes to the original code rather than the entire code.bin. Patches should be named code.ips and placed instead of a patched code.bin.

  • LayeredFS

Files within a game or applications romfs folder can redirected by placing modified files within /luma/titles/<Title ID>/romfs.

  • Locale Emulation

Main page: 3DS:Setting game locales
Locale Emulation can be used to launch a title with different region settings than the system. Although Luma3DS allows for any region game to be launched, some games may crash if the system region settings are not supported. Luma3DS can use alternate locale information from a locale.txt file placed in the /<Title ID>/ folder for a title. Follow 3DS:Setting game locales for more detailed instructions.

ROM hacks

ROM hacks are game mods that work by modifying or adding to a games files to change or add new content. ROM hacks can be made for a variety of different reasons, from making a game harder, adding new levels, translating the game to a different language, texture packs, randomization, and much more. Most ROM hacks on 3DS are distributed as unpacked files, and applied using Luma3DS's layeredfs. You can find some ROM hacks on their individual game pages; see a full list at Category:Nintendo 3DS games, or use the search feature.

Patching using layeredfs

Info icon Some hacks have additional files and instructions to follow that aren't covered here. Always refer to the hacks installation instructions/README if available.
  1. Download a ROM hack
  2. Copy the files to your SD card:
    • If the files contain a /luma/ folder, copy it to the root of your SD card merging when asked
    • If the files contain a /<Title ID>/ (16 character long) folder, copy it to /luma/titles/
    • If the files contain /romfs/, code.bin or code.ips; create a new folder in /luma/titles/ and rename it to the Title ID of the game. Copy the /romfs/, code.bin or code.ips to the /luma/titles/<Title ID>/ folder you just made
      • You can get the game's title ID from here (cartridges), here (digital games), or from the FBI -> Titles menu. For example the Title ID for Pokémon X is 0004000000055D00, so modified Pokémon X files would be placed at /luma/titles/0004000000055D00/.
  3. Insert your SD card into your console
  4. While holding SELECT, power on your console to enter the Luma3DS configuration menu
  5. Turn on Enable game patching if it is not already enabled
  6. Press START to save and exit
Success icon Your title should now be patched using layeredfs.

Game plugins

Main page: 3DS:Game plugins

Plugins are add-ons that run with a game. Plugins generally come in two types, 3GX or PLG. 3GX plugins run using Luma3DS's built in plugin loader, while PLG plugins can be run using BootNTR. 3GX plugins are usually newer and should generally be used if given a choice. You can find some plugins on their individual game pages; see a full list at Category:Nintendo 3DS games, or use the search feature.

Cheat codes

Cheat codes, or Action Replay codes, are instructions to edit memory addresses that allow for games behavior and values to be edited. These can be used in a variety of ways, from invincibility, max currency, unlocking items, and more. The two main ways to use cheats are from Luma3DS's Rosalina menu, or CTRPluginFramework's Action Replay. Using cheats with CTRPluginFramework, or a dedicated cheat plugin for the game you want to play will usually be more compatible.

Rosalina menu cheats

To use cheats with Rosalina menu:

  1. Place cheat files in plain text at either /cheats/<Title ID>.txt or /luma/titles/<Title ID>/cheats.txt
  2. Open the Rosalina menu (L+D-Pad down+SELECT by default)
  3. Select cheats...
  4. Press A on any cheats you want activated
  5. Press B until you exit the Rosalina menu

CTRPluginFramework Action Replay

To use cheats with CTRPluginFramework:

  1. Install the latest version of CTRPluginFramework-BlankTemplate (the .3gx file) using the instructions here
  2. Place cheat files in plain text at either /cheats/<Title ID>.txt or in the same folder as the .3gx plugin as cheats.txt
    • A repository of compiled cheat codes can be found here
    • Or create your own cheats; a list of all code types supported by Action Replay can be found here
  3. Open the Rosalina menu (L+D-Pad down+SELECT by default)
  4. Press A on Plugin Loader: to enable it
  5. Press B until you exit the Rosalina menu
  6. launch your game of choice
    • The screen should flash another color to indicate that the plugin has successfully loaded
    • it will say Plugin ready! on the top screen when it is loaded
  7. Press SELECT to open the plugin menu
  8. Tap on Action Replay
  9. Select the Action Replay codes you want to use
  10. Press SELECT to exit the plugin menu

Save editors

Save editors are tools that allow game saves to be edited in order to unlock items, change game progression, edit characters or companions and more. Save editors are usually limited by what the game is already capable of doing, but can sometimes unlock items not earnable through normal gameplay. Most save editors require your save to be unencrypted; you can use a save game manager such as Checkpoint to make unencrypted backups and restore save backups. You can find some Save editors on their individual game pages; see a full list at Category:Nintendo 3DS games, or use the search feature.

ROM editors

ROM editors are tools that allow game files or code to be edited in order to change how the game functions. Depending on the editor it may be able to edit textures or sounds, add new game content, make the game more/less difficult, remix content in a new way such as randomizers, and much more. You can find some ROM editors on their individual game pages; see a full list at Category:Nintendo 3DS games, or use the search feature.

Retrieved from "https://wiki.hacks.guide/w/index.php?title=3DS:Black_screen_unbrick&oldid=6593"