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

User page
(Alphabetized 👍)
Tags: Mobile edit Mobile web edit
(complete overhaul in several senses. enjoy lmao, i'm having fun with this so there's way more coming)
Tag: Disambiguation links
Line 1: Line 1:
Welcome to the 3ds assistance regular guide! if you are seeing this, you most likely want to be a regular, but dont know where to start. this guide will hopefully help you.
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.


==Useful Commands and Keywords==
== General Advice ==
Here are some commands that are useful to know.
* 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.


Anemone: Theme/Splash manager.


.deltheme: shows how to delete theme data.
== 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.


Emunand: Short for emulated NAND, very outdated for 3ds because there isn't a reason to use besides in very specific situations.


FBI: installs CIA formatted files.
== 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.)
<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.


Godmode9: Multi-purpose tool, including executing scripts, dumping games, and restoring NANDs.
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.


.id0: Shows where the Id0 and Id1 are.
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.


Luma3ds: your custom firmware, comes with many useful features.


.Ntrboot: sends the list of compatible ntrboot cartridges.
== Useful Commands and Keywords ==
Here are some commands that are useful to know, as well as terms that are in common usage.


Rverse: Miiverse revival program.
<code>.deltheme</code>: Shows how to delete the currently installed theme, in case it's causing a crash.


.sdroot: shows what the root of the SD card is.
<code>.id0</code>: Shows what and where the id0 and id1 are.


.Skater: brings up an embed for Super-Skaterhax troubleshooting.
<code>.luma</code>: Sends the download links to three versions of Luma: the latest version, v7.0.5, and v7.1.


Sysnand: the console's NAND. We can basically do anything on this safely, and it's been like that for a while.
<code>.ntrboot</code>: Sends the 3DS guide page that lists [[3dsguide:ntrboot|flashcarts that work with ntrboot]].


.tag 17: sends you the 11.17 interactive troubleshooter.
* <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.


.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]].  


.Tag Yarrharr: shows the reason why we dont support piracy, and says that homebrew devs dont want piracy to actually happen.
<code>.sdroot</code>: Shows what the root of the SD card is (and is not).


The rules commands: displays the rule that you want to display. for example .r4 shows rule 4, .r11 shows rule 11, etc.  
<code>.tag 17</code>: sends you the 11.17 interactive troubleshooter.


Twilightmenu++: NDS emulator. Commonly reffered to as Twlmenu.
<code>.tag yarrharr</code>: Explains why Nintendo Homebrew doesn't allow piracy from a legal standpoint and why it's harmful to homebrew developers.


.Update 3ds: brings up an embed that shows if it's safe to update.
<code>.update 3ds</code>: Brings up a embed that walks through whether your console's luma version is safe to update with.


.Updateluma: brings you to the Restoring/Updating CFW page.
<code>.vc 3ds</code>: Sends the download link to NSUI (New Super Ultimate Injector) and its usage guide.


.vc 3ds: sends the download link to new super ultimate injector and its usage guide.
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.
* redNAND: An improved type of emuNAND that doesn't take up as much space on the SD. Otherwise identical.


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


==Difference between software, firmware and hardware==
== Useful Programs ==
Hopefully, you already know this, but i might as well go over it.  
The following are apps or scripts that are commonly used or have extremely useful functionality for damaged consoles.
<br>Apps that are packaged with [[3dsguide:finalizing-setup|Finalizing Setup]] will be listed first.


Hardware is the consoles parts, such as the RAM and CPU. this can also include stuff like the n3ds’s NFC touchpoint.  
[[3DS:Anemone3DS|Anemone3DS]]: A theme and splash screen manager.


Firmware is stuff programmed into the system, such as its os. there really isnt much to go into on this topic.
[[Checkpoint]]: A save backup tool and cheat manager.


Software is programs on the firmware. this can include games, homebrew apps, system apps, etc.
[[3DS:FBI|FBI]]: A file explorer and title manager.


there is something that we do in dire situations called the hardware test. this goes and checks the entirety of the RAM for any errors. this should only be used when:
[[3DS:GodMode9|GodMode9]]: A heavily multi-use tool, mainly used as a file explorer, game dumper, title manager, and to create NAND backups.


The console is not booting and boot9strap is giving a red notification light.
[[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]].


• Replacing boot.firm and trying another sd card do not work.
[[3DS:Universal-Updater|Universal-Updater]]: Homebrew browser and updater.
 
----
 
[[3DS:faketik|faketik]]: Creates new tickets for installed apps that lost theirs. Doesn't work if the apps themselves were deleted.
 
[[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: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.
 
 
== 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|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 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 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 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 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.
*# 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.
*# GodMode9 crashes.

Revision as of 06:18, 22 August 2023

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.


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

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.)
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, cleaninty is used along with the console's unique files to create a new eShop account in the correct region.

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.


Useful Commands and Keywords

Here are some commands that are useful to know, as well as terms that are in common usage.

.deltheme: Shows how to delete the currently installed theme, in case it's causing a crash.

.id0: Shows what and where the id0 and id1 are.

.luma: Sends the download links to three versions of Luma: the latest version, v7.0.5, and v7.1.

.ntrboot: Sends the 3DS guide page that lists flashcarts that work with ntrboot.

  • .r# and .tag piracy: Display their respective rules' text, i.e. .r4 shows rule 4, .r11 shows rule 11, etc. .tag piracy adds to .r11 and sends this instead.

.skater: Brings up a embed for troubleshooting of super-skaterhax.

.sdroot: Shows what the root of the SD card is (and is not).

.tag 17: sends you the 11.17 interactive troubleshooter.

.tag yarrharr: Explains why Nintendo Homebrew doesn't allow piracy from a legal standpoint and why it's harmful to homebrew developers.

.update 3ds: Brings up a embed that walks through whether your console's luma version is safe to update with.

.vc 3ds: Sends the download link to NSUI (New Super Ultimate Injector) and its usage guide.

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.

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

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

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 backup tool and cheat manager.

FBI: A file explorer and title manager.

GodMode9: A heavily multi-use tool, mainly used as a file explorer, game dumper, title manager, and to create 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.


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 or 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: Expands TWiLightMenu++'s visual capabilities, most notably by allowing for widescreen support.


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.

OOjs UI icon information-progressive.svg 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 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 someone has Parental Controls enabled and wants to remove it, direct them to [1] (not salthax, as that site isn't updated for the latest sys version).
  • If an 0xC8804478 error happens when opening any DS mode software (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 any one of the following things is happening to a console, link the hardware test (3ds_hw_test.firm) 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.