From 670ce93487c453226e0acbded42415e9fe407673 Mon Sep 17 00:00:00 2001 From: lily Date: Mon, 7 Oct 2024 20:16:18 -0700 Subject: [PATCH] ts-rework: links at end, reorg. post-install - Add links to the original page and to the main troubleshooting page at the end of each page - Re-title some headers - Consolidate boot/software/other issues into 'post-install issues' - Add warning on ssloth and skater to prevent confusion of the two - Reword landing page slightly --- ....md => troubleshooting-get-help-common.md} | 0 docs/_include/troubleshooting-return.md | 5 + docs/troubleshooting-finalizing-setup.md | 12 +- docs/troubleshooting-miscellaneous-issues.md | 59 --------- docs/troubleshooting-mset9.md | 23 +++- ...ues.md => troubleshooting-post-install.md} | 121 +++++++++++++++++- docs/troubleshooting-software-issues.md | 49 ------- docs/troubleshooting-soundhax.md | 14 +- docs/troubleshooting-ssloth-browser.md | 22 +++- docs/troubleshooting-super-skaterhax.md | 18 ++- docs/troubleshooting.md | 12 +- 11 files changed, 208 insertions(+), 127 deletions(-) rename docs/_include/{troubleshooting-footer.md => troubleshooting-get-help-common.md} (100%) create mode 100644 docs/_include/troubleshooting-return.md delete mode 100644 docs/troubleshooting-miscellaneous-issues.md rename docs/{troubleshooting-boot-issues.md => troubleshooting-post-install.md} (55%) delete mode 100644 docs/troubleshooting-software-issues.md diff --git a/docs/_include/troubleshooting-footer.md b/docs/_include/troubleshooting-get-help-common.md similarity index 100% rename from docs/_include/troubleshooting-footer.md rename to docs/_include/troubleshooting-get-help-common.md diff --git a/docs/_include/troubleshooting-return.md b/docs/_include/troubleshooting-return.md new file mode 100644 index 0000000000..0b15e20208 --- /dev/null +++ b/docs/_include/troubleshooting-return.md @@ -0,0 +1,5 @@ +::: tip + +Go back to [Troubleshooting](troubleshooting) + +::: diff --git a/docs/troubleshooting-finalizing-setup.md b/docs/troubleshooting-finalizing-setup.md index cb32564ecc..7fab3abdbc 100644 --- a/docs/troubleshooting-finalizing-setup.md +++ b/docs/troubleshooting-finalizing-setup.md @@ -138,4 +138,14 @@ You didn't remove MSET9 on the previous page. The script will attempt to remove ::: - + + +--- + +::: tip + +Go back to [Finalizing Setup](finalizing-setup) + +::: + + diff --git a/docs/troubleshooting-miscellaneous-issues.md b/docs/troubleshooting-miscellaneous-issues.md deleted file mode 100644 index 18d219d58c..0000000000 --- a/docs/troubleshooting-miscellaneous-issues.md +++ /dev/null @@ -1,59 +0,0 @@ -# Troubleshooting miscellaneous issues on consoles with custom firmware - -This page offers troubleshooting advice for commonly encountered issues on a console with custom firmware. If you are unable to solve your issue with the advice on this page, please join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) and describe your issue, including what you have already tried. - -## Other troubleshooting - -::: details Clear HOME Menu extdata - -1. Power off your console -1. Insert your SD card into your computer -1. Navigate to the `/Nintendo 3DS///extdata/00000000/` folder on your SD card -1. Delete the corresponding folder for your 3DS region: - + **EUR Region**: `00000098` - + **JPN Region**: `00000082` - + **USA Region**: `0000008f` - + **CHN Region**: `000000A1` - + **KOR Region**: `000000A9` - + **TWN Region**: `000000B1` -1. Reinsert your SD card into your console - -::: - -::: details Clear HOME Menu theme data - -1. Power off your console -1. Insert your SD card into your computer -1. Navigate to the `/Nintendo 3DS///extdata/00000000/` folder on your SD card -1. Delete the corresponding folder for your 3DS region: - + **EUR Region**: `000002ce` - + **JPN Region**: `000002cc` - + **USA Region**: `000002cd` - + **KOR Region**: `000002cf` -1. Reinsert your SD card into your console - -::: - -::: details Manually entering Homebrew Launcher - -If you are missing the Homebrew Launcher application from your HOME Menu, you can follow these instructions to manually enter the Homebrew Launcher. (You will need [boot.3dsx and boot.firm](https://github.com/LumaTeam/Luma3DS/releases/latest) on the root of your SD card.) - - - -::: - -::: details Turning off Parental Controls - -You can disable the Parental Controls feature by going to System Settings -> Parental Controls and inserting the PIN, then pressing "Clear Settings", then "Delete" to remove it. -However, if you do not know the PIN and therefore cannot access the console's settings, you will need to disable it. In order to do this, you need to obtain your console's master key (mkey): -1. Go to [this website](https://mkey.eiphax.tech/) -1. Fill the following boxes with the information: - + Device Type: Select "3DS" (the same applies if you are using a 2DS, New 3DS (XL/LL) or New 2DS (XL/LL)) - + System Date: The day and month your console's clock is set to - + Inquiry Number: Can be obtained by pressing "Forgot PIN" then "I Forgot" in the Parental Controls screen -1. After you have obtained your mkey, press OK on the screen you have obtained your Inquiry Number, then input the master key -1. Press "Clear Settings", then "Delete" to remove all Parental Controls data - -::: - - diff --git a/docs/troubleshooting-mset9.md b/docs/troubleshooting-mset9.md index d29bab9574..f023dc05f3 100644 --- a/docs/troubleshooting-mset9.md +++ b/docs/troubleshooting-mset9.md @@ -2,7 +2,7 @@ This page offers troubleshooting advice for commonly encountered issues with the "Installing boot9strap (MSET9)", "Installing boot9strap (MSET9 CLI)" and "Installing boot9strap (MSET9 Play Store)" pages. If you are unable to solve your issue with the advice on this page, please join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) and describe your issue, including what you have already tried. -## Issues with MSET9 +## MSET9 (application / script) ::: details Python 3 is not installed @@ -133,6 +133,8 @@ One or more files that MSET9 needs to run is missing or corrupted. Re-download t ::: +## MSET9 (exploit) + ::: details Red screen after reinserting SD card (Section II Step 11) You may be missing `SafeB9S.bin` from the root of your SD card, or the file may be corrupted. Copy it from the MSET9 `.zip`, replacing any existing files then follow these instructions to remove the trigger file: @@ -193,4 +195,21 @@ This likely indicates that you already have custom firmware. You should [check f - + +--- + +::: tip + +Go back to [Installing boot9strap (MSET9-CLI)](installing-boot9strap-(mset9-cli)) + +::: + +::: tip + +Go back to [Installing boot9strap (MSET9 Play Store)](installing-boot9strap-(mset9-play-store)) + +::: + + + + diff --git a/docs/troubleshooting-boot-issues.md b/docs/troubleshooting-post-install.md similarity index 55% rename from docs/troubleshooting-boot-issues.md rename to docs/troubleshooting-post-install.md index c0be57d3af..3555418dff 100644 --- a/docs/troubleshooting-boot-issues.md +++ b/docs/troubleshooting-post-install.md @@ -1,8 +1,8 @@ -# Troubleshooting boot issues on consoles with custom firmware +# Troubleshooting (Post-Install) -This page offers troubleshooting advice for commonly encountered booting issues on a console with custom firmware. If you are unable to solve your issue with the advice on this page, please join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) and describe your issue, including what you have already tried. +This page offers troubleshooting advice for commonly encountered issues after custom firmware is installed. If you are unable to solve your issue with the advice on this page, please join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) and describe your issue, including what you have already tried. -## Boot issues on consoles with custom firmware +## Boot issues ::: info @@ -97,4 +97,117 @@ Your console is likely hard-bricked. You will need to buy an ntrboot flashcart t ::: - +::: details Some other error + +Please take a photo of the error and join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) for assistance. + +::: + +## Software issues on consoles with custom firmware + +::: details DSi / DS functionality is broken or has been replaced with Flipnote Studio + +1. Download the latest release of [TWLFix-CFW](https://github.com/MechanicalDragon0687/TWLFix-CFW/releases/latest) (the `.3dsx` file) +1. Power off your console +1. Create a folder named `3ds` on the root of your SD card if it does not already exist +1. Copy `TWLFix-CFW.3dsx` to the `/3ds/` folder on your SD card +1. Reinsert your SD card into your console +1. Open the Homebrew Launcher +1. Launch TWLFix-CFW from the list of homebrew +1. Press (A) to uninstall the broken TWL titles +1. Press (Start) to reboot the console +1. Update your console by going to System Settings, then "Other Settings", then going all the way to the right and using "System Update" + + The update will see that the essential TWL titles have been uninstalled, and will redownload and reinstall them +1. Once the update is complete, tap "OK" to reboot the console + +::: + +::: details GBA Virtual Console and/or Safe Mode functionality is broken + +Your console is running Luma3DS 6.6 or older, likely via arm9loaderhax. You should follow [A9LH to B9S](a9lh-to-b9s) to update your console to a modern custom firmware environment. + +::: + +::: details Extended memory mode games (Pokemon Sun/Moon, Smash, etc.) don't work + +This can occur after a CTRTransfer or region change on Old 3DS / 2DS. Follow the instructions [here](region-changing#section-vi---fixing-locale-related-issues) to fix this issue (skipping steps 3, 4, 5, and 6). + +::: + +::: details Exception screen when booting/loading an application + +Look for your exception screen in [this page](https://wiki.hacks.guide/wiki/3DS:Error_screens/Luma3DS_exception_screen). +If you weren't able to find your error or the instructions didn't work, join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) for further assistance. + +::: + +::: details Opening the HOME Menu settings crashes the console or loads the Homebrew Launcher + +Your console likely still has menuhax67 installed. To uninstall menuhax67, download the latest release of [menuhax67](https://github.com/zoogie/menuhax67/releases/latest) (the menuhax `.zip`), then follow the ["Uninstall menuhax67" section](https://wiki.hacks.guide/wiki/3DS:Alternate_Exploits/menuhax67#Uninstall_menuhax67) here. + +::: + +::: details Something else + +Join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) for assistance, and describe the issue that you see. + +::: + +## Other troubleshooting + +::: details Clear HOME Menu extdata + +1. Power off your console +1. Insert your SD card into your computer +1. Navigate to the `/Nintendo 3DS///extdata/00000000/` folder on your SD card +1. Delete the corresponding folder for your 3DS region: + + **EUR Region**: `00000098` + + **JPN Region**: `00000082` + + **USA Region**: `0000008f` + + **CHN Region**: `000000A1` + + **KOR Region**: `000000A9` + + **TWN Region**: `000000B1` +1. Reinsert your SD card into your console + +::: + +::: details Clear HOME Menu theme data + +1. Power off your console +1. Insert your SD card into your computer +1. Navigate to the `/Nintendo 3DS///extdata/00000000/` folder on your SD card +1. Delete the corresponding folder for your 3DS region: + + **EUR Region**: `000002ce` + + **JPN Region**: `000002cc` + + **USA Region**: `000002cd` + + **KOR Region**: `000002cf` +1. Reinsert your SD card into your console + +::: + +::: details Manually entering Homebrew Launcher + +If you are missing the Homebrew Launcher application from your HOME Menu, you can follow these instructions to manually enter the Homebrew Launcher. (You will need [boot.3dsx and boot.firm](https://github.com/LumaTeam/Luma3DS/releases/latest) on the root of your SD card.) + + + +::: + +::: details Turning off Parental Controls + +You can disable the Parental Controls feature by going to System Settings -> Parental Controls and inserting the PIN, then pressing "Clear Settings", then "Delete" to remove it. +However, if you do not know the PIN and therefore cannot access the console's settings, you will need to disable it. In order to do this, you need to obtain your console's master key (mkey): +1. Go to [this website](https://mkey.eiphax.tech/) +1. Fill the following boxes with the information: + + Device Type: Select "3DS" (the same applies if you are using a 2DS, New 3DS (XL/LL) or New 2DS (XL/LL)) + + System Date: The day and month your console's clock is set to + + Inquiry Number: Can be obtained by pressing "Forgot PIN" then "I Forgot" in the Parental Controls screen +1. After you have obtained your mkey, press OK on the screen you have obtained your Inquiry Number, then input the master key +1. Press "Clear Settings", then "Delete" to remove all Parental Controls data + +::: + +--- + + + diff --git a/docs/troubleshooting-software-issues.md b/docs/troubleshooting-software-issues.md deleted file mode 100644 index 83a2b04090..0000000000 --- a/docs/troubleshooting-software-issues.md +++ /dev/null @@ -1,49 +0,0 @@ -# Troubleshooting software issues on consoles with custom firmware - -This page offers troubleshooting advice for commonly encountered issues with various software on a console with custom firmware. If you are unable to solve your issue with the advice on this page, please join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) and describe your issue, including what you have already tried. - -## Software issues on consoles with custom firmware - -::: details DSi / DS functionality is broken or has been replaced with Flipnote Studio - -1. Download the latest release of [TWLFix-CFW](https://github.com/MechanicalDragon0687/TWLFix-CFW/releases/latest) (the `.3dsx` file) -1. Power off your console -1. Create a folder named `3ds` on the root of your SD card if it does not already exist -1. Copy `TWLFix-CFW.3dsx` to the `/3ds/` folder on your SD card -1. Reinsert your SD card into your console -1. Open the Homebrew Launcher -1. Launch TWLFix-CFW from the list of homebrew -1. Press (A) to uninstall the broken TWL titles -1. Press (Start) to reboot the console -1. Update your console by going to System Settings, then "Other Settings", then going all the way to the right and using "System Update" - + The update will see that the essential TWL titles have been uninstalled, and will redownload and reinstall them -1. Once the update is complete, tap "OK" to reboot the console - -::: - -::: details GBA Virtual Console and/or Safe Mode functionality is broken - -Your console is running Luma3DS 6.6 or older, likely via arm9loaderhax. You should follow [A9LH to B9S](a9lh-to-b9s) to update your console to a modern custom firmware environment. - -::: - -::: details Extended memory mode games (Pokemon Sun/Moon, Smash, etc.) don't work - -This can occur after a CTRTransfer or region change on Old 3DS / 2DS. Follow the instructions [here](region-changing#section-vi---fixing-locale-related-issues) to fix this issue (skipping steps 3, 4, 5, and 6). - -::: - -::: details Exception screen when booting/loading an application - -Look for your exception screen in [this page](https://wiki.hacks.guide/wiki/3DS:Error_screens/Luma3DS_exception_screen). -If you weren't able to find your error or the instructions didn't work, join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) for further assistance. - -::: - -::: details Opening the HOME Menu settings crashes the console or loads the Homebrew Launcher - -Your console likely still has menuhax67 installed. To uninstall menuhax67, download the latest release of [menuhax67](https://github.com/zoogie/menuhax67/releases/latest) (the menuhax `.zip`), then follow the ["Uninstall menuhax67" section](https://wiki.hacks.guide/wiki/3DS:Alternate_Exploits/menuhax67#Uninstall_menuhax67) here. - -::: - - diff --git a/docs/troubleshooting-soundhax.md b/docs/troubleshooting-soundhax.md index c29499b6c5..65816acc58 100644 --- a/docs/troubleshooting-soundhax.md +++ b/docs/troubleshooting-soundhax.md @@ -1,6 +1,6 @@ # Troubleshooting (Soundhax) -This page offers troubleshooting advice for commonly encountered issues with the "Installing boot9strap (Soundhax)" page. If you are unable to solve your issue with the advice on this page, please join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) and describe your issue, including what you have already tried. +This page offers troubleshooting advice for commonly encountered issues with the "Installing boot9strap (Soundhax)" page, which is used on system versions between 1.0.0 and 11.3.0. If you are unable to solve your issue with the advice on this page, please join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) and describe your issue, including what you have already tried. ## Issues with Soundhax @@ -33,4 +33,14 @@ If this is unsuccessful, try using another SD card. - + + +--- + +::: tip + +Go back to [Installing boot9strap (Soundhax)](installing-boot9strap-(soundhax)) + +::: + + diff --git a/docs/troubleshooting-ssloth-browser.md b/docs/troubleshooting-ssloth-browser.md index ef01aae6df..7ca1a02447 100644 --- a/docs/troubleshooting-ssloth-browser.md +++ b/docs/troubleshooting-ssloth-browser.md @@ -1,8 +1,14 @@ # Troubleshooting (SSLoth-Browser) -This page offers troubleshooting advice for commonly encountered issues with the "Installing boot9strap (SSLoth-Browser)" page. If you are unable to solve your issue with the advice on this page, please join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) and describe your issue, including what you have already tried. +This page offers troubleshooting advice for commonly encountered issues with the "Installing boot9strap (SSLoth-Browser)" page, which is used on system versions between 11.4.0 and 11.13.0. If you are unable to solve your issue with the advice on this page, please join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) and describe your issue, including what you have already tried. -## Issues with SSLoth-Browser +::: warning + +These instructions are only valid for the "Installing boot9strap (SSLoth-Browser)" page. If you are using a **New 3DS** on version **11.15.0 through 11.17.0**, you should follow [troubleshooting instructions for Installing boot9strap (super-skaterhax)](troubleshooting-super-skaterhax) instead. + +::: + +## SSLoth-Browser ::: details Red/purple/pink and white screen after running Browserhax @@ -86,4 +92,14 @@ If this is unsuccessful, try using another SD card. - + + +--- + +::: tip + +Go back to [Installing boot9strap (SSLoth-Browser)](installing-boot9strap-(ssloth-browser)) + +::: + + diff --git a/docs/troubleshooting-super-skaterhax.md b/docs/troubleshooting-super-skaterhax.md index 1492d7e201..984b895be5 100644 --- a/docs/troubleshooting-super-skaterhax.md +++ b/docs/troubleshooting-super-skaterhax.md @@ -2,6 +2,12 @@ This page offers troubleshooting advice for commonly encountered issues with the "Installing boot9strap (super-skaterhax)" page. If you are unable to solve your issue with the advice on this page, please join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) and describe your issue, including what you have already tried. +::: warning + +These instructions are only valid for the "Installing boot9strap (super-skaterhax)" page. If you are using **anything other than** a **New 3DS** on version **11.15.0 through 11.17.0**, you should follow [troubleshooting instructions for Installing boot9strap (SSLoth-Browser)](troubleshooting-ssloth-browser) instead. + +::: + ## Issues with super-skaterhax ::: details "An error has occurred. Please save your data in any software currently in use, then restart the system." @@ -42,4 +48,14 @@ This likely indicates that you already have custom firmware. You should [check f - + + +--- + +::: tip + +Go back to [Installing boot9strap (super-skaterhax)](installing-boot9strap-(super-skaterhax)) + +::: + + diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index 978c1b4a6d..8df3800061 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -1,21 +1,21 @@ # Troubleshooting -This page offers troubleshooting advice for commonly encountered issues. If you are unable to solve your issue with the advice on this page, please join [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp) and describe your issue, including what you have already tried. +This page serves a landing page for troubleshooting resources that we offer for commonly encountered issues. Click on the link corresponding to the page you are following to explore it. + +If you're unable to fix your issue, ask for help at [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp). If your issue is missing and you know the solution, [let us know!](https://github.com/hacks-guide/Guide_3DS/issues) ::: tip **Table of Contents** -Guide pages: * [Installing boot9strap (Soundhax)](troubleshooting-soundhax) * [Installing boot9strap (MSET9)](troubleshooting-mset9) * [Installing boot9strap (SSLoth-Browser)](troubleshooting-ssloth-browser) * [Installing boot9strap (super-skaterhax)](troubleshooting-super-skaterhax) * [Finalizing Setup](troubleshooting-finalizing-setup) -Issues after installation: -* [Boot issues](troubleshooting-boot-issues) -* [Software issues](troubleshooting-software-issues) -* [Miscellaneous issues](troubleshooting-miscellaneous-issues) +--- + +* [Post-Install](troubleshooting-post-install) :::