Skip to content

Commit d8ae590

Browse files
author
fox8091
committed
Add several files to the rebase
1 parent 8ab2707 commit d8ae590

22 files changed

+1505
-0
lines changed

‎_pages/en_US/contribute.txt‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
title: "Contribute"
3+
---
4+
5+
We're glad that you'd like to contribute to 3ds.hacks.guide! Here are a few ways that you can do so:
6+
7+
## Maintenance
8+
9+
This guide is open source - its repository is available [here](https://github.com/hacks-guide/Guide_3DS). If you feel there is an issue with the guide, you can file an issue to make us aware, or file a pull request to have your changes merged into the guide.
10+
11+
## Translations
12+
13+
If you'd like to translate this guide into other languages (or help keep the translations up-to-date), check out our [Crowdin](https://crowdin.com/project/3ds-guide).
14+
15+
## Seeding
16+
17+
A number of files on this guide are only available as torrents. If you'd like to help seed these torrents to ensure their availability in the future, you can use [this]({{ "rss.xml" | absolute_url }}) RSS feed.
18+
19+
## Donations
20+
21+
Maintaining this guide (as well as our support channels) is primarily a volunteer effort, but if this guide has helped you in some way, donations are greatly appreciated.
22+
23+
[![Paypal]({{ "/images/paypal_white.png" | absolute_url }}){:height="72px" width="256px"}{: style="padding-bottom: .35em"}](https://paypal.me/NintendoHomebrew){: .align-center}
24+
[https://paypal.me/NintendoHomebrew](https://paypal.me/NintendoHomebrew)
25+
{: .text-center}
26+
{: .notice--info}
27+
28+

‎_pages/en_US/credits.txt‎

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
---
2+
title: "Credits"
3+
---
4+
5+
**Special thanks to Plailect, the original creator and maintainer of the guide!**
6+
{: .notice--primary}
7+
8+
**Special thanks to all of [#Cakey on Freenode](http://webchat.freenode.net/?channels=%23Cakey) for being awesome!**
9+
{: .notice--primary}
10+
11+
**Special thanks to all of [the translators](https://crowdin.com/project/3ds-guide) for being awesome!**
12+
{: .notice--primary}
13+
14+
If I forgot you here, contact me and I'll add your name.
15+
16+
{% capture notice-1 %}
17+
18+
+ Al3x_10m
19+
+ aliaspider
20+
+ AngelSL
21+
+ ashinnblunts
22+
+ AuroraWright
23+
+ b1l1s
24+
+ BernardoGiordano
25+
+ Cartman123
26+
+ Cell9
27+
+ coder65535
28+
+ Cruel
29+
+ d0k3
30+
+ dank101
31+
+ Dazzozo
32+
+ DeadPhoenix
33+
+ Delebile
34+
+ DinohScene
35+
+ dukesrg
36+
+ elementalcode
37+
+ elSeledonio
38+
+ erman1337
39+
+ felipejfc
40+
+ figgyc
41+
+ fox8091
42+
+ Frozen_Chen
43+
+ Gelex
44+
+ Hamcha
45+
+ icecream
46+
+ ihaveamac
47+
+ IngeniousDefault
48+
+ J-D-K
49+
+ Jisagi
50+
+ jkcgs
51+
+ kartik
52+
+ LordBass
53+
+ mid-kid
54+
+ MrNbaYoh
55+
+ Mrrraou
56+
+ Night_Fallen_Wolf
57+
+ Normmatt
58+
+ Plailect
59+
+ plutooo
60+
+ Psi-Hate
61+
+ RandallHoffman
62+
+ Raugo
63+
+ Reboot.ms
64+
+ s_99
65+
+ SciresM
66+
+ Shadowtrance
67+
+ shinyquagsire23
68+
+ skiptirengu
69+
+ smealum
70+
+ Steveice10
71+
+ stuckpixel
72+
+ Syphurith
73+
+ Tech0verlord
74+
+ TiniVi
75+
+ TuxSH
76+
+ Urbanshadow
77+
+ Vappy
78+
+ vegaroxas
79+
+ Wolfvak
80+
+ WulfyStylez
81+
+ xy2_
82+
+ yellows8
83+
+ yifan_lu
84+
+ zoogie
85+
86+
{% endcapture %}
87+
88+
<div class="notice--info">{{ notice-1 | markdownify }}</div>

‎_pages/en_US/donations.txt‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
title: "Donations" #
3+
---
4+
5+
[![Paypal]({{ "/images/paypal_white.png" | absolute_url }}){:height="72px" width="256px"}{: style="padding-bottom: .35em"}](https://paypal.me/NintendoHomebrew){: .align-center}
6+
[https://paypal.me/NintendoHomebrew](https://paypal.me/NintendoHomebrew)
7+
{: .text-center}
8+
{: .notice--info}

‎_pages/en_US/dumping-titles-and-game-cartridges.txt‎

Lines changed: 142 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,142 @@
1+
---
2+
title: "Dumping Titles and Game Cartridges"
3+
---
4+
5+
{% include toc title="Table of Contents" %}
6+
7+
For support (in English) with GodMode9, as well as help with scripting and to get updates and info, join [GodMode9 on Discord](https://discord.gg/BRcbvtFxX4).
8+
{: .notice--primary}
9+
10+
### Required Reading
11+
12+
Aside from creating and restoring NAND backups, GodMode9 has the functionality to dump installed titles to an installable `.cia` file, to dump game cartridge data to a `.3ds` ROM file, and to directly install a game cartridge to the system.
13+
14+
## Updating GodMode9
15+
16+
These instructions are written for use with GodMode9 v2.0.0 or later. If you have an older version of GodMode9, follow these instructions to update it.
17+
{: .notice--info}
18+
19+
### What You Need
20+
21+
* The latest release of [GodMode9](https://github.com/d0k3/GodMode9/releases/latest)
22+
23+
### Instructions
24+
25+
1. Power off your device
26+
1. Insert your SD card into your computer
27+
1. Copy `GodMode9.firm` from the GodMode9 `.zip` to the `/luma/payloads/` folder on your SD card
28+
1. Copy the `gm9` folder from the GodMode9 `.zip` to the root of your SD card
29+
1. Reinsert your SD card into your device
30+
31+
## Dumping a Game Cartridge
32+
33+
{% capture notice %}
34+
Insert the game cartridge you intend to dump into your device
35+
+ 3DS game cartridges will be dumped to a `.3ds` format
36+
+ NDS game cartridges will be dumped to a `.nds` format
37+
{% endcapture %}
38+
39+
<div class="notice--info">{{ notice | markdownify }}</div>
40+
41+
1. Press and hold (Start), and while holding (Start), power on your device. This will launch GodMode9
42+
1. Navigate to `[C:] GAMECART`
43+
1. Follow the steps applicable to your game cartridge:
44+
+ **3DS Game Cartridge:** Press (A) on `[TitleID].trim.3ds` to select it
45+
+ **NDS Game Cartridge:** Press (A) on `[TitleID].nds` to select it
46+
- Trimmed dumps are not recommended for NDS games in general, as they can cause various playback issues
47+
1. Select "Copy to 0:/gm9/out"
48+
1. Your non-installable `.3ds` or `.nds` formatted file will be outputted to the `/gm9/out/` folder on your SD card
49+
50+
## Installing a Game Cartridge Directly to the System
51+
52+
This will only work for 3DS games; it is not possible to install an NDS game cartridge to the system as a title.
53+
{: .notice--info}
54+
55+
1. Press and hold (Start), and while holding (Start), power on your device. This will launch GodMode9
56+
1. Navigate to `[C:] GAMECART`
57+
1. Press (A) on `[TitleID].trim.3ds` to select it, then select "NCSD image options...", then select "Install game image"
58+
1. Press (A) to unlock SysNAND (lvl1) writing, then input the key combo given
59+
1. Once the process is complete, your game will show up in the HOME Menu as an installed title.
60+
61+
## Dumping a 3DS Game Cartridge to .CIA
62+
63+
This should only be used if [Installing a Game Cartridge Directly to the System](#installing-a-game-cartridge-directly-to-the-system) does not work.
64+
{: .notice--info}
65+
66+
1. Press and hold (Start), and while holding (Start), power on your device. This will launch GodMode9
67+
1. Navigate to `[C:] GAMECART`
68+
1. Press (A) on `[TitleID].trim.3ds` to select it, then select "NCSD image options...", then select "Build CIA from file"
69+
1. Your installable `.cia` formatted file will be outputted to the `/gm9/out/` folder on your SD card
70+
71+
## Dumping an Installed Title
72+
73+
This allows dumping of both System- and User-installed digital titles, such as ones downloaded from the eShop.
74+
{: .notice--info}
75+
76+
1. Press and hold (Start), and while holding (Start), power on your device. This will launch GodMode9
77+
1. Press (Home) to bring up the action menu
78+
1. Select "Title manager"
79+
1. Select one of the following depending on the type of title you wish to dump
80+
+ **User Installed Title**: `[A:] SD CARD`
81+
+ **System Title / DSiWare**: `[1:] NAND / TWL`
82+
1. Select the title you wish to dump
83+
1. Select "Manage Title..."
84+
1. Select "Build CIA (standard)"
85+
1. Your installable `.cia` formatted file will be outputted to the `/gm9/out/` folder on your SD card
86+
87+
## Backup GBA VC Saves
88+
89+
The game will be outputted to the `/gm9/out/` folder on your SD card with the name `<TitleID>.gbavc.sav`.
90+
{: .notice--info}
91+
92+
To identify a `<TitleID>.gbavc.sav` file's Title ID, you can get a listing of all games on the system and their corresponding Title IDs by pressing (Home) to bring up the action menu, selecting `Title manager`, and selecting `[A:] SD CARD`.
93+
{: .notice--info}
94+
95+
1. Do the following process for each GBA VC game that you want to backup the save for:
96+
+ Launch the GBA VC game
97+
+ Exit the GBA VC game
98+
+ Power off your device
99+
+ Press and hold (Start), and while holding (Start), power on your device. This will launch GodMode9
100+
+ Navigate to `[S:] SYSNAND VIRTUAL`
101+
+ Press (A) on `agbsave.bin` to select it
102+
+ Select "AGBSAVE options..."
103+
+ Select "Dump GBA VC save"
104+
+ Press (A) to continue
105+
+ Press (Start) to reboot your device
106+
107+
## Restore GBA VC Saves
108+
109+
To identify a `<TitleID>.gbavc.sav` file's Title ID, you can get a listing of all games on the system and their corresponding Title IDs by pressing (Home) to bring up the action menu, selecting `Title manager`, and selecting `[A:] SD CARD`.
110+
{: .notice--info}
111+
112+
1. Do the following process for each GBA VC game that you want to restore the save for:
113+
+ Launch the GBA VC game
114+
+ Exit the GBA VC game
115+
+ Power off your device
116+
+ Press and hold (Start), and while holding (Start), power on your device. This will launch GodMode9
117+
+ Navigate to `[0:] SDCARD` -> `gm9`
118+
+ Press (Y) on the `<TitleID>.gbavc.sav` file you wish to restore to copy it
119+
+ Press (B) to return to the main menu
120+
+ Navigate to `[S:] SYSNAND VIRTUAL`
121+
+ Press (A) on `agbsave.bin` to select it
122+
+ Select "AGBSAVE options..."
123+
+ Select "Inject GBA VC save"
124+
+ Press (A) to continue
125+
+ Press (Start) to reboot your device
126+
+ Launch the GBA VC game
127+
+ Exit the GBA VC game
128+
129+
## Encrypting / Decrypting a .CIA file
130+
131+
For organizational purposes, copy each `.cia` file you wish to encrypt / decrypt to the `/cias/` folder on your SD card
132+
{: .notice--info}
133+
134+
1. Press and hold (Start), and while holding (Start), power on your device. This will launch GodMode9
135+
1. Navigate to `[0:] SDCARD` -> `cias`
136+
1. Press (A) on the `.cia` file to select it, then select "CIA image options..."
137+
1. Select the option to perform the desired function:
138+
+ **Encrypt to 0:/gm9/out:** Create an encrypted copy of the selected `.cia` file in the `/gm9/out/` folder on your SD card
139+
+ **Decrypt to 0:/gm9/out:** Create a decrypted copy of the selected `.cia` file in the `/gm9/out/` folder on your SD card
140+
+ **Encrypt inplace:** Replace the selected `.cia` file with an encrypted version
141+
+ **Decrypt inplace:** Replace the selected `.cia` file with a decrypted version
142+
1. Your encrypted / decrypted `.cia` will be outputted to the desired location

‎_pages/en_US/f3-(linux).txt‎

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
title: "F3 (Linux)"
3+
---
4+
5+
{% include toc title="Table of Contents" %}
6+
7+
### Required Reading
8+
9+
This is an add-on section for checking your SD card for errors using F3.
10+
11+
Depending on the size of your SD card and the speed of your computer, this process can take up to several hours!
12+
13+
This page is for Linux users only. If you are not on Linux, check out the [H2testw (windows)](h2testw-(windows)) or [F3X (mac)](f3x-(mac)) pages.
14+
15+
### What You Need
16+
17+
* The latest version of [F3](https://github.com/AltraMayor/f3/releases/latest)
18+
19+
### Instructions
20+
21+
1. Unzip the f3 `.zip` file
22+
1. `cd` into the f3 directory
23+
1. Run `make` to compile F3
24+
1. Insert your SD card into your computer
25+
1. Mount your SD card
26+
1. Run `./f3write <your sd card mount point>`
27+
1. Wait until the process is complete. See below for an example output.
28+
29+
~~~ bash
30+
$ ./f3write /media/michel/6135-3363/
31+
Free space: 29.71 GB
32+
Creating file 1.h2w ... OK!
33+
...
34+
Creating file 30.h2w ... OK!
35+
Free space: 0.00 Byte
36+
Average Writing speed: 4.90 MB/s
37+
~~~
38+
39+
1. Run `./f3read <your sd card mount point>`
40+
1. Wait until the process is complete. See below for an example output.
41+
42+
~~~ bash
43+
$ ./f3read /media/michel/6135-3363/
44+
SECTORS ok/corrupted/changed/overwritten
45+
Validating file 1.h2w ... 2097152/ 0/ 0/ 0
46+
...
47+
Validating file 30.h2w ... 1491904/ 0/ 0/ 0
48+
49+
Data OK: 29.71 GB (62309312 sectors)
50+
Data LOST: 0.00 Byte (0 sectors)
51+
Corrupted: 0.00 Byte (0 sectors)
52+
Slightly changed: 0.00 Byte (0 sectors)
53+
Overwritten: 0.00 Byte (0 sectors)
54+
Average Reading speed: 9.42 MB/s
55+
~~~
56+
57+
___
58+
59+
If the test shows the result `Data LOST: 0.00 Byte (0 sectors)`, your SD card is good and you can delete all `.h2w` files on your SD card
60+
{: .notice--success}
61+
62+
If the test shows any other results, your SD card may be corrupted or damaged and you may have to replace it!
63+
{: .notice--danger}
64+
65+
### Return to [Get Started](get-started)
66+
{: .notice--primary}

‎_pages/en_US/f3x-(mac).txt‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
title: "F3X (Mac)"
3+
---
4+
5+
{% include toc title="Table of Contents" %}
6+
7+
### Required Reading
8+
9+
This is an add-on section for checking your SD card for errors using F3X.
10+
11+
Depending on the size of your SD card and the speed of your computer, this process can take up to several hours!
12+
13+
This page is for Mac users only. If you are not on Mac, check out the [H2testw (windows)](h2testw-(windows)) or [F3 (Linux)](f3-(linux)) pages.
14+
15+
If you're using a Mac on macOS 10.13 (High Sierra) and above, follow [F3XSwift (Mac)](f3xswift-(mac)) instead.
16+
{: .notice--primary}
17+
18+
### What You Need
19+
20+
* The latest release of [F3X](https://github.com/insidegui/F3X/releases/latest)
21+
22+
### Instructions
23+
24+
1. Unzip the F3X `.zip` file
25+
1. Insert your SD card into your computer
26+
1. Run the F3X app
27+
1. Select your SD card
28+
1. Press "Start Test"
29+
1. Wait until the process is complete.
30+
31+
___
32+
33+
If the test shows the result `Success! Your card is ok!` your SD card is good and you can delete all `.h2w` files on your SD card
34+
{: .notice--success}
35+
36+
If the test shows any other results, your SD card may be corrupted or damaged and you may have to replace it!
37+
{: .notice--danger}
38+
39+
### Return to [Get Started](get-started)
40+
{: .notice--primary}

0 commit comments

Comments
 (0)