Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

User:Botman/3ds Assistance Regular Guide: Difference between revisions

User page
m (→‎Common troubleshooting situations: fix incorrect ending tag)
(Oi botman here’s the edit (added broken NAND as a reason to use a emuNAND))
Tags: Mobile edit Mobile web edit
 
(36 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{#approvable_by: users = Botman}}
Welcome to the 3DS assistance guide! If you're reading this, you most likely want to be better at helping in the Nintendo Homebrew Discord, but don't know where to start. This guide should serve as a helpful glossary and FAQ for those purposes.
Welcome to the 3DS assistance guide! If you're reading this, you most likely want to be better at helping in the Nintendo Homebrew Discord, but don't know where to start. This guide should serve as a helpful glossary and FAQ for those purposes.


Line 5: Line 6:
** Having only enough info to make educated guesses is fine, you're not expected to instantly find a solution. That's sometimes how it works even for the helpers.
** Having only enough info to make educated guesses is fine, you're not expected to instantly find a solution. That's sometimes how it works even for the helpers.
* You don't have to keep helping if someone's getting on your nerves. There will always be other people to find that person's issue.
* You don't have to keep helping if someone's getting on your nerves. There will always be other people to find that person's issue.
* Do NOT assist in dm. It is against the server rules, as we cannot monitor it.
* Don't assist people in DMs. It is against the server rules, as we cannot monitor it.
* Don’t expect anything for helping out. Ideally, the helping should be its own reward anyway.
** That isn't an excuse to get burnt out, though. There's a difference between being selfless and being self-destructive.


== Difference between software, firmware and hardware ==
== Difference between software, firmware and hardware ==
Line 14: Line 17:


== Basic info on SOAP transfers ==
== Basic info on SOAP transfers ==
When a console connects to anything that uses the eShop servers, the eShop gets a full list of the titles available in that console's "eShop region" (including system apps) and compares this list against what is installed on the console. (Note that the eShop region is distinct from the region of the console's firmware.)
All information on SOAP transfers can be found under [[3DS:cleaninty|cleaninty's page.]]
<br>After a console is region changed, the eShop gets a list of system apps that do not exist in the console's eShop region. This causes the error that blocks access to various online services.


To fix this, [[3DS:cleaninty|cleaninty]] is used along with the console's unique files to create a new eShop account in the correct region.
You almost always need donor files from an unusable console to do SOAP transfers, so if you need a SOAP for your console, don't try to do it yourself. Ask on the Nintendo Homebrew Discord, and one of the people with a large number of donors will be able to help.


This usually requires donor files from an unusable console, so don't try to do it yourself. Ask on the Discord, and someone who already regularly does SOAPs will be able to help.
== Command list ==
[https://docs.google.com/spreadsheets/d/1Bz-8qddZqubr7toWiW402C-WWp3R_RpsX1njt1rO46M/edit?usp=sharing This Google Doc] contains a list of every single command relating to 3ds assistance.


== Useful Keywords ==
Below is a list of keywords that are nice to know.


== Useful Commands and Keywords ==
Here are some commands that are useful to know, as well as terms that are in common usage.


<code>.deltheme</code>: Shows how to delete the currently installed theme, in case it's causing a crash.
sysNAND: The console's internal file storage. CFW can be safely installed to this without any notable risks.


<code>.id0</code>: Shows what and where the id0 and id1 are.
emuNAND: Short for emulated NAND. Used to be the way CFW was separated from the "stock" NAND, but this is no longer required. emuNANDs' only practical uses now are for Korean games' fonts or a broken NAND chip.
 
* redNAND: An improved type of emuNAND that doesn't take up as much space on the SD. Otherwise identical.
<code>.luma</code>: Sends the download links to three versions of Luma: the latest version, v7.0.5, and v7.1.
 
<code>.ntrboot</code>: Sends the 3DS guide page that lists [[3dsguide:ntrboot|flashcarts that work with ntrboot]].
 
<code>.r#</code> and <code>.tag piracy</code>: Display their respective rules' text, i.e. <code>.r4</code> shows rule 4, <code>.r11</code> shows rule 11, etc. .tag piracy adds to .r11 and sends [https://docs.google.com/document/d/1Uqm1FlouzBu7ih3JxF3vlT28fYIFY6PDcmZrItms7-o/edit?usp=sharing this] instead.
 
<code>.skater</code>: Brings up a embed for troubleshooting of [[3dsguide:installing-boot9strap-(super-skaterhax)|super-skaterhax]].  
 
<code>.sdroot</code>: Shows what the root of the SD card is (and is not).
 
<code>.tag 17</code>: sends you the 11.17 interactive troubleshooter.
 
<code>.tag yarrharr</code>: Explains why Nintendo Homebrew doesn't allow piracy from a legal standpoint and why it's harmful to homebrew developers.
 
<code>.update 3ds</code>: Brings up a embed that walks through whether your console's luma version is safe to update with.


<code>.vc 3ds</code>: Sends the download link to NSUI (New Super Ultimate Injector) and its usage guide.
CTR: Short for Citrus and/or Centrair, the code names for the 3DS.
* Examples include: [[3DS:ctrcheck|'''ctr'''check]], [[3dsguide:ctrtransfer|'''ctr'''transfer]] and the '''CTR'''NAND.


emuNAND: Short for emulated NAND. Used to be the way CFW was separated from the "stock" NAND, but this is no longer required. emuNANDs' only practical use now are for Korean games' fonts.
NTR: Short for Nitro, the code name for the DS.
* redNAND: An improved type of emuNAND that doesn't take up as much space on the SD. Otherwise identical.
* Examples include: [[3DS:ntrboot|'''ntr'''boot]] and '''NTR''' CFW.


sysNAND: The console's internal file storage. CFW can be safely installed to this without any notable risks.
TWL: short for Twilight, the code name for the DSi.
* Examples include: '''TWL'''Fix, '''TW'''i'''L'''ightMenu++, and the '''TWL'''NAND.


== Useful Programs ==
== Useful Programs ==
Line 58: Line 48:
[[3DS:Anemone3DS|Anemone3DS]]: A theme and splash screen manager.
[[3DS:Anemone3DS|Anemone3DS]]: A theme and splash screen manager.


[[Checkpoint]]: A save backup tool and cheat manager.
[[Checkpoint]]: A save file and cheat manager.


[[3DS:FBI|FBI]]: A file explorer and title manager.
[[3DS:FBI|FBI]]: A file explorer and title manager with significantly less safety checks than GodMode9.


[[3DS:GodMode9|GodMode9]]: A heavily multi-use tool, mainly used as a file explorer, game dumper, title manager, and to create NAND backups.
[[3DS:GodMode9|GodMode9]]: The Swiss Army Knife of the 3DS world. Mainly used as a file explorer, game dumper, title manager, and to create/restore NAND backups.


[[3DS:Luma3DS|Luma3DS]]: The sole remaining CFW for the 3DS. Has [[3DS:Luma3DS/Configuration|several]] useful features and a [[3DS:Luma3DS/Rosalina|built-in menu]].
[[3DS:Luma3DS|Luma3DS]]: The sole remaining CFW for the 3DS. Has [[3DS:Luma3DS/Configuration|several]] useful features and a [[3DS:Luma3DS/Rosalina|built-in menu]].


[[3DS:Universal-Updater|Universal-Updater]]: Homebrew browser and updater.
[[3DS:Universal-Updater|Universal-Updater]]: Homebrew browser and updater.
[[3DS:FTP|FTPD]]: used to transfer files from your 3ds to your PC wirelessly.


----
----
Line 74: Line 66:
[[3DS:rverse|rverse]]: A third-party revival of Miiverse.
[[3DS:rverse|rverse]]: A third-party revival of Miiverse.


[[3DS:rehid|rehid]]: Allows remapping of the buttons and touchscreen based on specific inputs or what game is being played.
[[3DS:rehid|rehid]]: Allows remapping of the buttons and touchscreen based on specific inputs, and can be configured to run differently based on what game is being played.


[[3DS:TWiLightMenu|TWiLightMenu++]]: A DSi Menu upgrade/replacement, mainly used on the 3DS to play dumps of NDS games [[3DS:DS|directly from the SD card.]]
[[3DS:TWiLightMenu|TWiLightMenu++]]: A DSi Menu upgrade/replacement, mainly used on the 3DS to play dumps of NDS games [[3DS:DS|directly from the SD card.]]


[[3DS:TWPatch|TWPatch]]: Expands TWiLightMenu++'s visual capabilities, most notably by allowing for widescreen support.
[[3DS:TWPatch|TWPatch]]: Enhances TWiLightMenu++'s visual capabilities, most notably by allowing for widescreen support.
 
[[3DS:ctrcheck|ctrcheck]]: A GodMode9 script that checks the NAND for damage. Cannot detect most hardware issues.


[[3DS:Hardware test|3ds_hw_test]]: A <code>.firm</code> payload that checks for RAM issues.


== Common troubleshooting situations ==
== Common troubleshooting situations ==
Line 85: Line 80:


{{info|1=Above all else, always remember to check [[3DS:ERR]] if you don't know what an error means - one of those pages is relatively likely to have it. If it doesn't and the error is either a stock error code or an ErrDisp, try using <code>.err</code> through Kurisu.}}
{{info|1=Above all else, always remember to check [[3DS:ERR]] if you don't know what an error means - one of those pages is relatively likely to have it. If it doesn't and the error is either a stock error code or an ErrDisp, try using <code>.err</code> through Kurisu.}}
 
* If the SD card is the problem, it may be worth it to reinsert the SD card to see if that works.
* If an error is occurring on boot and there is no known cause, see whether it keeps happening (including whether the error changes) if the SD is taken out. If it does, the issue is with the NAND.
* If an error is occurring on boot and there is no known cause, see whether it keeps happening (including whether the error changes) if the SD is taken out. If it does, the issue is with the NAND.
* If an error with the code <code>0xd900458b</code> is happening within a game, use the tag with the same name. it will lead to [https://gist.github.com/lifehackerhansol/ba13b2adb40ecbe65fd299385aec57ff] here.
* If an error with the code <code>0xd900458b</code> is happening when opening a game, use [[3DS:FCG]].
* If someone has Parental Controls enabled and wants to remove it, direct them to [https://mkey.eiphax.tech] (not salthax, as that site isn't updated for the latest sys version).
* If someone has Parental Controls enabled and wants to remove it, direct them to [[udb:3ds/3ds-parentalunlock|3DS-ParentalUnlock]] if they have CFW, or [https://mkey.eiphax.tech mkey.eiphax.tech] if they don't. (not salthax - it was never updated to work on the latest system version).
* If an <code>0xC8804478</code> error happens when opening any DS mode software (a fast way to test is by opening Download Play -> Nintendo DS), link the <code>.twlfix</code> command (which is itself a redirect to [[3DS:TWLFix]]).
* If an <code>0xC8804478</code> error happens when opening anything that uses DS mode (a fast way to test is by opening Download Play -> Nintendo DS), link the <code>.twlfix</code> command (which is itself a redirect to [[3DS:TWLFix]]).
* If any '''one''' of the following things is happening to a console, link the hardware test (<code>3ds_hw_test.firm</code>) and have the helpee send the contents of <code>hwtest.log</code> after it finishes. This will test the RAM for errors.  
* If a helpee has more than 1 ID0, tell them to do [[3DS:MID0]].
* If any '''one''' of the following things is happening to a console, link [[3DS:Hardware test|the hardware test]] and have the helpee send the contents of <code>hwtest.log</code> after it finishes. This will test the RAM for errors.  
*# The console repeatedly fails to boot and the notification LED is either [[3DS:boot9strap#LED_Status_Codes|red or magenta]] when it fails.
*# The console repeatedly fails to boot and the notification LED is either [[3DS:boot9strap#LED_Status_Codes|red or magenta]] when it fails.
*# The console randomly and inconsistently crashes, regardless of whether the SD is inserted or not.
*# The console randomly and inconsistently crashes, regardless of whether the SD is inserted or not.
Line 96: Line 92:


== Info on Older Setups ==
== Info on Older Setups ==
Before B9s, there were many other setups. below is a list of them and how to effectively move from that setup to B9s.
[[3DS:boot9strap|B9S]] is the newest of a long list of homebrew/CFW setups. Below is a list of all the mainstream older setups, in mostly chronological order, and instructions on how to upgrade from them to B9S.
 
Gateway: Using the ds profile exploit to make a 3ds flashcart (note: this doesnt meant NTRboot)


Upgrade to B9s: WIP, sorry
{{info|text=Setups marked with an <span style="color: red">(E)</span> use an [[3DS:EmuNAND and RedNAND|emuNAND]]. emuNANDs are unnecessary under boot9strap, as they were only used on these setups because modifying the sysNAND with homebrew was considered unsafe at the time.<br><br>


Userland: Homebrew Launcher access, before cfw.
If you are upgrading from one of these setups to B9S, it is advised to [[3ds:Move EmuNAND|move the emuNAND]] into your sysNAND.}}


Upgrade to B9s: Follow [[Installing boot9strap (uloader)|Installing boot9strap (uloader)]] on 11.15.0 and below and [[Installing boot9strap (nimdsphax)|Installing boot9strap (nimdsphax)]] on 11.16.0 and above.  
{{info|text=If a setup is marked as N/A, it only means there's no easier way to migrate to boot9strap. If you were using a setup marked with N/A, you can still go to [[3dsguide:index|our guide to 3DS custom firmware]] and insert your system version to install CFW normally.}}


Menuhax: (description WIP)
# '''Userland''': Any exploit that allowed non-persistent Homebrew Launcher access, such as by running a modified save file from a cartridge game.
Upgrade to B9s: [[3ds: Migrate from menuhax|Follow migrate from menuhax]]
#* Upgrade to boot9strap: Depends on your system version. If 11.15.0 or below, follow [[3ds:Alternate Exploits/Installing boot9strap (uloader)|uloader]]; if 11.16.0 or above, follow [[3ds:Alternate Exploits/Installing boot9strap (nimdsphax)|nimdsphax]].
# '''Gateway''' <span style="color: red">(E)</span>: Gateway's first attempt to take control of the 3DS homebrew scene. Uses a old/downgraded sysNAND combined with one of multiple exploits to load the Gateway Menu, from which an emuNAND on a newer version (known as Gateway Mode) is used for most homebrew functionality.
#* Upgrade to boot9strap:  [[3dsguide:ntrboot|Flash NTRBoot to the blue cartridge and install boot9strap via NTRBoot.]]
# '''Sky3DS''': Gateway's second attempt to take control. A piracy-focused [[3DS:Flashcarts|flashcart]] that spoofs a legitimate game, letting it run 3DS games directly from the HOME Menu on any firmware version without installing an exploit. Has an enormous ban risk unless you add a file that can only be extracted via CFW, and is thus obsolete.
#* Upgrade to boot9strap: N/A
# '''Stargate''': Gateway’s last attempt to take control. A piracy-focused flashcart that can run 3DS games the same way Sky3DS does, but also can run DS games and ntrboot. Has the same ban risk as Sky3DS when running 3DS games.
#* Upgrade to boot9strap: Usually N/A, but if you used their Easy CFW Mode pack, wipe the console's SD card and then follow [[3dsguide:Updating B9S|Updating B9S]].
# '''Menuhax''' <span style="color: red">(E)</span>: A set of secondary exploits that all triggered on Home Menu startup, allowed HBL access when opening Home Menu settings, and used a emuNAND. It was sometimes also used as an entrypoint for Gateway Mode.
#* Upgrade to boot9strap: Follow [[3ds:Migrate from menuhax|Migrate from menuhax]].
# '''[[3DS:arm9loaderhax|A9LH (arm9loaderhax)]]''': The direct predecessor to boot9strap - also a coldboot CFW, but with reduced functionality and safety because of how it's implemented. Supports Luma3DS versions up to 7.0.5.
#* Upgrade to boot9strap: Follow [[3dsguide:A9LH To B9S|A9LH to B9S]].
# '''B9S 1.0-1.3''': Just older versions of boot9strap. Very few practical differences aside from the older versions not having [[3DS:boot9strap#LED Status Codes|LED status codes]].
#* Upgrade to (latest) boot9strap: Follow [[3dsguide:Updating B9S|Updating B9S]]
#'''[[3DS:Fastboot3DS|FB3DS (fastboot3ds)]]''': An alternate bootloader option to B9S, trading out LED status codes for an interactive on-boot menu, FCRAM boot (useful for {{GitHub|SUOlivia/That-Shortcut-Thingy|That-Shortcut-Thingy}}), a chainloader with more flexibility and power than [[3DS:Luma3DS|Luma3DS]], and a system for backups of critical system files. Mainly useful for power users.
#* Return to boot9strap: Follow [[3dsguide:Updating B9S|Updating B9S]].

Latest revision as of 00:21, 12 April 2024

Welcome to the 3DS assistance guide! If you're reading this, you most likely want to be better at helping in the Nintendo Homebrew Discord, but don't know where to start. This guide should serve as a helpful glossary and FAQ for those purposes.

General Advice

  • Don't try to solve an issue if you have no idea how to fix it.
    • Having only enough info to make educated guesses is fine, you're not expected to instantly find a solution. That's sometimes how it works even for the helpers.
  • You don't have to keep helping if someone's getting on your nerves. There will always be other people to find that person's issue.
  • Don't assist people in DMs. It is against the server rules, as we cannot monitor it.
  • Don’t expect anything for helping out. Ideally, the helping should be its own reward anyway.
    • That isn't an excuse to get burnt out, though. There's a difference between being selfless and being self-destructive.

Difference between software, firmware and hardware

  • Hardware is the console's physical parts, such as the RAM and CPU. This also includes things like the n3DS' NFC touchpoint.
  • Software is the 'encoded instructions' that cause the hardware to do specific things. This includes games, homebrew apps, system apps, etc.
  • Firmware is any software that runs directly on top of the hardware, such as its operating system. Despite its name, 'custom firmware' usually only patches the existing firmware rather than being an entirely new one.


Basic info on SOAP transfers

All information on SOAP transfers can be found under cleaninty's page.

You almost always need donor files from an unusable console to do SOAP transfers, so if you need a SOAP for your console, don't try to do it yourself. Ask on the Nintendo Homebrew Discord, and one of the people with a large number of donors will be able to help.

Command list

This Google Doc contains a list of every single command relating to 3ds assistance.

Useful Keywords

Below is a list of keywords that are nice to know.


sysNAND: The console's internal file storage. CFW can be safely installed to this without any notable risks.

emuNAND: Short for emulated NAND. Used to be the way CFW was separated from the "stock" NAND, but this is no longer required. emuNANDs' only practical uses now are for Korean games' fonts or a broken NAND chip.

  • redNAND: An improved type of emuNAND that doesn't take up as much space on the SD. Otherwise identical.

CTR: Short for Citrus and/or Centrair, the code names for the 3DS.

NTR: Short for Nitro, the code name for the DS.

  • Examples include: ntrboot and NTR CFW.

TWL: short for Twilight, the code name for the DSi.

  • Examples include: TWLFix, TWiLightMenu++, and the TWLNAND.

Useful Programs

The following are apps or scripts that are commonly used or have extremely useful functionality for damaged consoles.
Apps that are packaged with Finalizing Setup will be listed first.

Anemone3DS: A theme and splash screen manager.

Checkpoint: A save file and cheat manager.

FBI: A file explorer and title manager with significantly less safety checks than GodMode9.

GodMode9: The Swiss Army Knife of the 3DS world. Mainly used as a file explorer, game dumper, title manager, and to create/restore NAND backups.

Luma3DS: The sole remaining CFW for the 3DS. Has several useful features and a built-in menu.

Universal-Updater: Homebrew browser and updater.

FTPD: used to transfer files from your 3ds to your PC wirelessly.


faketik: Creates new tickets for installed apps that lost theirs. Doesn't work if the apps themselves were deleted.

rverse: A third-party revival of Miiverse.

rehid: Allows remapping of the buttons and touchscreen based on specific inputs, and can be configured to run differently based on what game is being played.

TWiLightMenu++: A DSi Menu upgrade/replacement, mainly used on the 3DS to play dumps of NDS games directly from the SD card.

TWPatch: Enhances TWiLightMenu++'s visual capabilities, most notably by allowing for widescreen support.

ctrcheck: A GodMode9 script that checks the NAND for damage. Cannot detect most hardware issues.

3ds_hw_test: A .firm payload that checks for RAM issues.

Common troubleshooting situations

Some of the problems here are not actually "common" per se, but are instead included because they have a common cause and well-known solution.

Info icon Above all else, always remember to check 3DS:ERR if you don't know what an error means - one of those pages is relatively likely to have it. If it doesn't and the error is either a stock error code or an ErrDisp, try using .err through Kurisu.
  • If the SD card is the problem, it may be worth it to reinsert the SD card to see if that works.
  • If an error is occurring on boot and there is no known cause, see whether it keeps happening (including whether the error changes) if the SD is taken out. If it does, the issue is with the NAND.
  • If an error with the code 0xd900458b is happening when opening a game, use 3DS:FCG.
  • If someone has Parental Controls enabled and wants to remove it, direct them to 3DS-ParentalUnlock if they have CFW, or mkey.eiphax.tech if they don't. (not salthax - it was never updated to work on the latest system version).
  • If an 0xC8804478 error happens when opening anything that uses DS mode (a fast way to test is by opening Download Play -> Nintendo DS), link the .twlfix command (which is itself a redirect to 3DS:TWLFix).
  • If a helpee has more than 1 ID0, tell them to do 3DS:MID0.
  • If any one of the following things is happening to a console, link the hardware test and have the helpee send the contents of hwtest.log after it finishes. This will test the RAM for errors.
    1. The console repeatedly fails to boot and the notification LED is either red or magenta when it fails.
    2. The console randomly and inconsistently crashes, regardless of whether the SD is inserted or not.
    3. GodMode9 crashes.

Info on Older Setups

B9S is the newest of a long list of homebrew/CFW setups. Below is a list of all the mainstream older setups, in mostly chronological order, and instructions on how to upgrade from them to B9S.

Info icon Setups marked with an (E) use an emuNAND. emuNANDs are unnecessary under boot9strap, as they were only used on these setups because modifying the sysNAND with homebrew was considered unsafe at the time.

If you are upgrading from one of these setups to B9S, it is advised to move the emuNAND into your sysNAND.
Info icon If a setup is marked as N/A, it only means there's no easier way to migrate to boot9strap. If you were using a setup marked with N/A, you can still go to our guide to 3DS custom firmware and insert your system version to install CFW normally.
  1. Userland: Any exploit that allowed non-persistent Homebrew Launcher access, such as by running a modified save file from a cartridge game.
    • Upgrade to boot9strap: Depends on your system version. If 11.15.0 or below, follow uloader; if 11.16.0 or above, follow nimdsphax.
  2. Gateway (E): Gateway's first attempt to take control of the 3DS homebrew scene. Uses a old/downgraded sysNAND combined with one of multiple exploits to load the Gateway Menu, from which an emuNAND on a newer version (known as Gateway Mode) is used for most homebrew functionality.
  3. Sky3DS: Gateway's second attempt to take control. A piracy-focused flashcart that spoofs a legitimate game, letting it run 3DS games directly from the HOME Menu on any firmware version without installing an exploit. Has an enormous ban risk unless you add a file that can only be extracted via CFW, and is thus obsolete.
    • Upgrade to boot9strap: N/A
  4. Stargate: Gateway’s last attempt to take control. A piracy-focused flashcart that can run 3DS games the same way Sky3DS does, but also can run DS games and ntrboot. Has the same ban risk as Sky3DS when running 3DS games.
    • Upgrade to boot9strap: Usually N/A, but if you used their Easy CFW Mode pack, wipe the console's SD card and then follow Updating B9S.
  5. Menuhax (E): A set of secondary exploits that all triggered on Home Menu startup, allowed HBL access when opening Home Menu settings, and used a emuNAND. It was sometimes also used as an entrypoint for Gateway Mode.
  6. A9LH (arm9loaderhax): The direct predecessor to boot9strap - also a coldboot CFW, but with reduced functionality and safety because of how it's implemented. Supports Luma3DS versions up to 7.0.5.
  7. B9S 1.0-1.3: Just older versions of boot9strap. Very few practical differences aside from the older versions not having LED status codes.
  8. FB3DS (fastboot3ds): An alternate bootloader option to B9S, trading out LED status codes for an interactive on-boot menu, FCRAM boot (useful for That-Shortcut-Thingy), a chainloader with more flexibility and power than Luma3DS, and a system for backups of critical system files. Mainly useful for power users.