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
This commit is contained in:
lily 2024-10-07 20:16:18 -07:00 committed by lifehackerhansol
parent 85d630200a
commit 670ce93487
No known key found for this signature in database
GPG Key ID: 80FB184AFC0B3B0E
11 changed files with 208 additions and 127 deletions

View File

@ -0,0 +1,5 @@
::: tip
Go back to [Troubleshooting](troubleshooting)
:::

View File

@ -138,4 +138,14 @@ You didn't remove MSET9 on the previous page. The script will attempt to remove
:::
<!--@include: ./_include/troubleshooting-footer.md -->
<!--@include: ./_include/troubleshooting-get-help-common.md -->
---
::: tip
Go back to [Finalizing Setup](finalizing-setup)
:::
<!--@include: ./_include/troubleshooting-return.md -->

View File

@ -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/<ID0>/<ID1>/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/<ID0>/<ID1>/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.)
<!--@include: ./_include/launch-hbl-dlp.md -->
:::
::: 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
:::
<!--@include: ./_include/troubleshooting-footer.md -->

View File

@ -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
<!--@include: ./_include/troubleshooting-sb9si-common.md -->
<!--@include: ./_include/troubleshooting-footer.md -->
<!--@include: ./_include/troubleshooting-get-help-common.md -->
---
::: 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))
:::
<!--@include: ./_include/troubleshooting-return.md -->

View File

@ -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
:::
<!--@include: ./_include/troubleshooting-footer.md -->
::: 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/<ID0>/<ID1>/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/<ID0>/<ID1>/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.)
<!--@include: ./_include/launch-hbl-dlp.md -->
:::
::: 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
:::
---
<!--@include: ./_include/troubleshooting-return.md -->

View File

@ -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.
:::
<!--@include: ./_include/troubleshooting-footer.md -->

View File

@ -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.
<!--@include: ./_include/troubleshooting-sb9si-common.md -->
<!--@include: ./_include/troubleshooting-footer.md -->
<!--@include: ./_include/troubleshooting-get-help-common.md -->
---
::: tip
Go back to [Installing boot9strap (Soundhax)](installing-boot9strap-(soundhax))
:::
<!--@include: ./_include/troubleshooting-return.md -->

View File

@ -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.
<!--@include: ./_include/troubleshooting-sb9si-common.md -->
<!--@include: ./_include/troubleshooting-footer.md -->
<!--@include: ./_include/troubleshooting-get-help-common.md -->
---
::: tip
Go back to [Installing boot9strap (SSLoth-Browser)](installing-boot9strap-(ssloth-browser))
:::
<!--@include: ./_include/troubleshooting-return.md -->

View File

@ -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
<!--@include: ./_include/troubleshooting-sb9si-common.md -->
<!--@include: ./_include/troubleshooting-footer.md -->
<!--@include: ./_include/troubleshooting-get-help-common.md -->
---
::: tip
Go back to [Installing boot9strap (super-skaterhax)](installing-boot9strap-(super-skaterhax))
:::
<!--@include: ./_include/troubleshooting-return.md -->

View File

@ -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)
:::