mirror/Guide_3DS
1
0
Fork 0
mirror of https://github.com/hacks-guide/Guide_3DS.git synced 2025-08-11 19:24:14 +02:00
Code Issues Releases Wiki Activity

docs: port to VitePress

Browse Source 
Things that happen in this shameless squash:
- Removed 404 page
  - It doesn't work in VitePress and making it work in VitePress needs
    some invasive hack in the theme that I'm not willing to do
  - The default is more than enough, though
- Moved consoleVersionSelect include to another directory
  - This avoids being uploaded to Crowdin for translation
- Inline all SafeB9SInstaller includes
  - Not only do parameterized includes not work, but if/else statements
    don't work at all
- The sysupdate include parameter hasn't been used since MSET9, so it
  actually works just fine without any parameters. Hooray(?)
- Move mset9-chorus to an include, that logic doesn't work in VitePress
- Removed Get Started button from homepage, it breaks translations
- Tables in get-started are now shown by default; it seems VitePress really does
  not want us to use inline script. So we cannot enable it upon
  realizing that the browser is JS capable
- Include parameters are now in frontmatter to allow translation
- Hacked in a bunch of CSS values kanged from the old theme to make it
  look not stupid
- Drop headers down one level to make table of contents work
This commit is contained in:
lifehackerhansol
2024-09-16 01:58:08 -07:00
parent cf408fbf94
commit d84cb07e29
77 changed files with 1619 additions and 1332 deletions
Download Patch File Download Diff File Expand all files Collapse all files

105
docs/installing-boot9strap-(mset9-cli).md
View File

@@ -1,59 +1,62 @@
---
title: "Installing boot9strap (MSET9 CLI)"
---
# Installing boot9strap (MSET9 CLI)
{% include toc title="Table of Contents" %}
::: details Technical Details (optional)
{% capture technical_info %}
<summary><em>Technical Details (optional)</em></summary>
[MSET9](https://github.com/zoogie/MSET9) is an exploit for the System Settings application developed by [zoogie](https://github.com/zoogie). It exploits a flaw where the ID1 (the second 32-character folder name inside of the Nintendo 3DS folder, inside of the ID0) can be *any* name as long as it is 32 characters. Performing a specific sequence of actions results in the console executing the instructions that are encoded into the ID1 folder name, which can be used to grant full control over the 3DS.
{% endcapture %}
<details>{{ technical_info | markdownify }}</details>
{: .notice--info}
:::
### Compatibility Notes
## Compatibility Notes
::: warning
This page requires a computer running Windows, Linux, or macOS. If you have an Android phone/tablet or a Chromebook, follow [Installing boot9strap (MSET9 Play Store)](installing-boot9strap-(mset9-play-store)) instead. If you do not have access to any of these devices, you will need to use an [alternate exploit](https://wiki.hacks.guide/wiki/3DS:Alternate_Exploits).
{: .notice--warning}
### What You Need
:::
## What You Need
* The latest release of [MSET9](https://github.com/hacks-guide/MSET9/releases/latest)
* Any 3.x version of [Python](https://www.python.org/downloads/) **installed on your computer**
+ If you are on Linux or macOS, you may already have Python 3. Check by opening a Terminal window and entering `python3 -V`. If this returns a version number, it will work for this guide.
### Instructions
## Instructions
::: info
On this page, you will use the MSET9 script, which is used to trigger MSET9. While the script is in progress, user data will temporarily disappear but will return upon the completion of this page. If you get an error when running the script, the solution to that error can most likely be found on the [troubleshooting](troubleshooting#installing-boot9strap-mset9) page.
{: .notice--info}
#### Section I - Prep Work
:::
### Section I - Prep Work
In this section, you will prepare the MSET9 exploit by **temporarily** creating a new HOME Menu profile with no user data, and then setting up that profile with only the minimum data required for MSET9 to trigger. Your existing user data will disappear, but will come back when you are finished with this page.
1. Insert your SD card into your computer
1. Copy everything from the MSET9 `.zip` to the root of your SD card, overwriting any existing files
::: info
![MSET9 root layout](/images/screenshots/mset9/mset9-root-layout.png)
{: .notice--info}
:::
1. Run the MSET9 script:
{% capture mset9-chorus %}
+ **Windows**: Double-click `MSET9-Windows.bat`
+ **macOS**: Double-click `MSET9-macOS.command` and enter your password if prompted
+ **Linux**: open a Terminal window, `cd` to the root of your SD card, then type `python3 mset9.py` and press Enter
{% endcapture %}
{{ mset9-chorus }}
<!--@include: ./_include/mset9-chorus.md -->
::: info
![Image: MSET9 setup](/images/screenshots/mset9/mset9-select.png)
{: .notice--info}
:::
1. Type the number corresponding to your console model and version, then press Enter
+ The window should change to this:
::: info
![Image: MSET9 setup](/images/screenshots/mset9/mset9-setup-notcreated.png)
{: .notice--info}
:::
+ Ensure that the correct console model and version is displayed
1. Type `1`, then press Enter to begin the process of creating the MSET9 ID1
@@ -72,14 +75,15 @@ In this section, you will prepare the MSET9 exploit by **temporarily** creating
1. Power off your console by pressing the power button then tapping Power Off on the lower screen
1. Insert your SD card into your computer
1. Run the MSET9 script:
{{ mset9-chorus }}
<!--@include: ./_include/mset9-chorus.md -->
1. Type the number corresponding to your console model and version, then press Enter
+ The window should change to this and display `Ready`:
::: info
![Image: MSET9 setup](/images/screenshots/mset9/mset9-ready.png)
{: .notice--info}
:::
+ If the window says [Not ready - check MSET9 status for more details](/images/screenshots/mset9/mset9-not-ready.png):
+ Type `2`, then press Enter to check the MSET9 status and follow the directions indicated
@@ -88,12 +92,15 @@ In this section, you will prepare the MSET9 exploit by **temporarily** creating
1. Type `0`, then press Enter to close the script
1. Reinsert your SD card into your console
#### Section II - MSET9
### Section II - MSET9
In this section, you will trigger MSET9 to launch SafeB9SInstaller (the custom firmware installer).
::: danger
These instructions must be followed **EXACTLY**, so double-check EVERYTHING you are doing to avoid errors!
{: .notice--danger}
:::
1. Power on your console, ensuring System Settings is selected
+ If System Settings is not selected, **[hover over](/images/screenshots/mset9/hover-settings.png)** the System Settings icon using the D-Pad, power your console off, then back on
@@ -104,7 +111,7 @@ These instructions must be followed **EXACTLY**, so double-check EVERYTHING you
+ The menu will refresh and say that no SD card is inserted
1. Insert your SD card into your computer
1. Run the MSET9 script:
{{ mset9-chorus }}
<!--@include: ./_include/mset9-chorus.md -->
1. Type the number corresponding to your console model and version, then press Enter
1. In the MSET9 window, type `3`, then press Enter to inject MSET9
+ You should see "MSET9 successfully injected!"
@@ -113,22 +120,29 @@ These instructions must be followed **EXACTLY**, so double-check EVERYTHING you
1. If the exploit was successful, you will have booted into SafeB9SInstaller
+ If you get a red screen or the console gets stuck on a loading screen, follow the [troubleshooting guide](troubleshooting#installing-boot9strap-mset9)
#### Section III - Installing boot9strap
### Section III - Installing boot9strap
{% include_relative include/install-boot9strap-safeb9sinstaller.txt %}
{%- include_relative include/configure-luma3ds.txt %}
In this section, you will install custom firmware onto your console.
#### Section IV - Removing MSET9
1. When prompted, input the key combo given on the top screen to install boot9strap
+ If a step on the lower screen has red-colored text, and you are not prompted to input a key combo, [follow this troubleshooting guide](troubleshooting#issues-with-safeb9sinstaller)
1. Once it is complete, press (A) to reboot your console
<!--@include: ./_include/configure-luma3ds.md -->
### Section IV - Removing MSET9
In this section, you will remove MSET9 to prevent further issues and to restore your user data (games, themes, etc). (This will not remove the custom firmware that you have just installed.)
::: danger
Do NOT skip this section! If you skip it, applications may crash unexpectedly and you will encounter errors on the next page!
{: .notice--danger}
:::
1. Power off your console
1. Insert your SD card into your computer
1. Run the MSET9 script:
{{ mset9-chorus }}
<!--@include: ./_include/mset9-chorus.md -->
1. Type the number corresponding to your console model and version, then press Enter
+ The current state should display [Injected](/images/screenshots/mset9/mset9-injected.png)
+ If you have already removed the trigger file (or never injected in the first place), the current state will show [Ready](/images/screenshots/mset9/mset9-ready.png), skip to Step 6
@@ -138,11 +152,18 @@ Do NOT skip this section! If you skip it, applications may crash unexpectedly an
+ You should see "Successfully removed MSET9!"
1. Press Enter to close the MSET9 script
{% include_relative include/luma3ds-installed-note.txt %}
<!--@include: ./_include/luma3ds-installed-note.md -->
___
Did you follow Section IV (Removing MSET9)? That section is MANDATORY!
{: .notice--danger}
::: danger
### Continue to [Finalizing Setup](finalizing-setup)
{: .notice--primary}
Did you follow Section IV (Removing MSET9)? That section is MANDATORY!
:::
::: tip
Continue to [Finalizing Setup](finalizing-setup)
:::