hacks-guide/finalize
1
0
Fork 0
mirror of https://github.com/hacks-guide/finalize.git synced 2024-11-27 02:50:22 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

markdown fixes

Browse Source
This commit is contained in:
Lily 2024-02-17 02:20:58 +01:00
parent 77c47f03c0
commit 5002085ccf
2 changed files with 81 additions and 80 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
README.md
View File

@ -2,17 +2,17 @@
Scripts relating to Finalizing Setup on https://3ds.hacks.guide/finalizing-setup. Scripts relating to Finalizing Setup on https://3ds.hacks.guide/finalizing-setup.
- `/finalize`: Files that are packed into `finalize.romfs` - [`/finalize/`](finalize): Files that are packed into `finalize.romfs`
- `/finalize/img`: Images used for visual troubleshooting - [`/finalize/img`](finalize/img): Images used for visual troubleshooting
- `/finalize/finalize.gm9`: Script run after `finalize_helper.gm9` that: - [`/finalize/finalize.gm9`](finalize/finalize.gm9): Script run after `finalize_helper.gm9` that:
- Installs base homebrew applications to SYSNAND SD (see below for list) - Installs base homebrew applications to SYSNAND SD (see below for list)
- Copies GodMode9 to CTRNAND (`/rw/luma/payloads`) - Copies GodMode9 to CTRNAND (`/rw/luma/payloads`)
- Backs up `essential.exefs` to `/gm9/backups` - Backs up `essential.exefs` to `/gm9/backups`
- Deletes CFW installation files that are no longer necessary - Deletes CFW installation files that are no longer necessary
- Backs up minsize NAND backup to `/gm9/backups` - Backs up minsize NAND backup to `/gm9/backups`
- `/finalize/donor.db`: Empty title database used for consoles that do not have title database (i.e. no eShop software) - `/finalize/donor.db`: Empty title database used for consoles that do not have title database (i.e. no eShop software)
- `finalize_helper.gm9`: Script that is compiled as GM9 scriptrunner (`finalize_helper.firm`); extracts `finalize.romfs` - [`finalize_helper.gm9`](finalize_helper.gm9): Script that is compiled as GM9 scriptrunner (`finalize_helper.firm`); extracts `finalize.romfs`
- `docs.md`: Full error information / script documentation - [`docs.md`](docs.md): Full error information / script documentation
## Bundled software ## Bundled software
The following repositories have their compiled builds in this software package: The following repositories have their compiled builds in this software package:
@ -29,6 +29,7 @@ The following repositories have their compiled builds in this software package:
## Releases ## Releases
Releases are tagged for reference (based on usage in the guide). **Releases in this repository are not intended to be for general use.** If you want to use them regardless: Releases are tagged for reference (based on usage in the guide). **Releases in this repository are not intended to be for general use.** If you want to use them regardless:
- Clone this repository (latest commit, or a tagged release if you are looking for a specific version)
- Copy the contents of `finalize` to the root of your console's SD card - Copy the contents of `finalize` to the root of your console's SD card
- Copy `finalize.gm9` from the `finalize` folder to `/gm9/scripts/` - Copy `finalize.gm9` from the `finalize` folder to `/gm9/scripts/`
- Copy `GodMode9.firm` from the `finalize` folder to `/luma/payloads/` - Copy `GodMode9.firm` from the `finalize` folder to `/luma/payloads/`

150
docs.md
View File

@ -3,115 +3,115 @@
## Script-integrated error checking (finalize.gm9) ## Script-integrated error checking (finalize.gm9)
ERROR: "Error #01: No Nintendo 3DS folder" - **ERROR**: "Error #01: No Nintendo 3DS folder"
CAUSE: Script is outdated (error no longer exists). Was caused by lack of Nintendo 3DS folder before implementation of NOSPACE. - **CAUSE**: Script is outdated (error no longer exists). Was caused by lack of Nintendo 3DS folder before implementation of NOSPACE.
FIX : Update script - **FIX **: Update script
ERROR: "Error #02: Missing essential.exefs" - **ERROR**: "Error #02: Missing essential.exefs"
CAUSE: SYSNAND VIRTUAL:/essential.exefs does not exist, because the user denied GodMode9's prompt to make an essential.exefs backup - **CAUSE**: SYSNAND VIRTUAL:/essential.exefs does not exist, because the user denied GodMode9's prompt to make an essential.exefs backup
FIX : Tell the user to re-enter GodMode9 (by holding START on boot) and to say Yes (press A) to the essential.exefs backup prompt - **FIX **: Tell the user to re-enter GodMode9 (by holding START on boot) and to say Yes (press A) to the essential.exefs backup prompt
ERROR: "Error #03: Missing files" (also: 03a, 03b, 03c, 03d, 03e, 03f, 03g) - **ERROR**: "Error #03: Missing files" (also: 03a, 03b, 03c, 03d, 03e, 03f, 03g)
CAUSE: Script is outdated (error no longer exists). Was caused by lack of 0:/finalize (which should no longer happen with scriptrunner). - **CAUSE**: Script is outdated (error no longer exists). Was caused by lack of 0:/finalize (which should no longer happen with scriptrunner).
FIX : Update script - **FIX **: Update script
ERROR: "Error #04: No space" - **ERROR**: "Error #04: No space"
CAUSE: Insufficient space for NAND backup - **CAUSE**: Insufficient space for NAND backup
FIX : Make sufficient space (.nospace as contingency) - **FIX **: Make sufficient space (.nospace as contingency)
ERROR: "Error #05: No title database" - **ERROR**: "Error #05: No title database"
CAUSE: Script is outdated (error has been renamed; if it says 'error' and not 'information', this version of the script will create a dummy title database) - **CAUSE**: Script is outdated (error has been renamed; if it says 'error' and not 'information', this version of the script will create a dummy title database)
FIX : Update script - **FIX **: Update script
ERROR: "Information #05: No title database" - **ERROR**: "Information #05: No title database"
Cause: title.db does not exist - **CAUSE**: title.db does not exist
FIX : Allow prompt to import title database - **FIX **: Allow prompt to import title database
NOTE : If script release between 1.3.0 and 1.3.2, this will use the dummy title database, which will require reboot and DBRESET. This shouldn't happen as this version isn't known to be distributed anywhere NOTE : If script release between 1.3.0 and 1.3.2, this will use the dummy title database, which will require reboot and DBRESET. This shouldn't happen as this version isn't known to be distributed anywhere
ERROR: "Error #06: NAND backup fail" - **ERROR**: "Error #06: NAND backup fail"
CAUSE: NAND backup failed to complete for some reason - **CAUSE**: NAND backup failed to complete for some reason
FIX : Unknown (check for space/partition issues, try another SD card...) - **FIX **: Unknown (check for space/partition issues, try another SD card...)
NOTE : Will display as "#06*" on top screen if occuring during NOSPACE, as remaining SD space is not checked if Nintendo 3DS folder does not exist NOTE : Will display as "#06*" on top screen if occuring during NOSPACE, as remaining SD space is not checked if Nintendo 3DS folder does not exist
ERROR: "(Fatal) Error #07: No SD size" - **ERROR**: "(Fatal) Error #07: No SD size"
CAUSE: SD size check portion failed to run. Should not ever happen - **CAUSE**: SD size check portion failed to run. Should not ever happen
FIX : Pray - **FIX **: Pray
ERROR: "Error #08: Dummy title database" - **ERROR**: "Error #08: Dummy title database"
CAUSE: Script is outdated (error no longer exists) - **CAUSE**: Script is outdated (error no longer exists)
FIX : Update script. Will most likely cause Error #16 (Title database mount fail) on a rerun. Alternatively, run user through DBRESET and rerun outdated script. - **FIX **: Update script. Will most likely cause Error #16 (Title database mount fail) on a rerun. Alternatively, run user through DBRESET and rerun outdated script.
ERROR: "Error #09: Unsupported GodMode9 version" - **ERROR**: "Error #09: Unsupported GodMode9 version"
CAUSE: Script is outdated (error no longer exists). Was caused by GodMode9 not being version 2.1.1. - **CAUSE**: Script is outdated (error no longer exists). Was caused by GodMode9 not being version 2.1.1.
FIX : Update script - **FIX **: Update script
ERROR: "(Fatal) Error #10: Application install fail" - **ERROR**: "(Fatal) Error #10: Application install fail"
CAUSE: Script is outdated (error no longer exists because the check did not make sense), but if this happens then something seriously wrong has happened - **CAUSE**: Script is outdated (error no longer exists because the check did not make sense), but if this happens then something seriously wrong has happened
FIX : Pray - **FIX **: Pray
ERROR: "Error #11: Missing donor database" - **ERROR**: "Error #11: Missing donor database"
CAUSE: Script is outdated (error no longer exists) - **CAUSE**: Script is outdated (error no longer exists)
FIX : Update script or provide donor.db to SD:/finalize - **FIX **: Update script or provide donor.db to SD:/finalize
ERROR: "Error #12a: Copy title.db fail" (also 12b: Copy import.db fail) - **ERROR**: "Error #12a: Copy title.db fail" (also 12b: Copy import.db fail)
CAUSE: donor.db could not be copied to A:/dbs/title.db - **CAUSE**: donor.db could not be copied to A:/dbs/title.db
FIX : Most likely due to MSET9 being applied and A:/ not being mounted, so try removing MSET9 - **FIX **: Most likely due to MSET9 being applied and A:/ not being mounted, so try removing MSET9
ERROR: "Fatal Error #13a: Fix CMAC fail" (also 13b) - **ERROR**: "Fatal Error #13a: Fix CMAC fail" (also 13b)
CAUSE: CMACs could not be fixed for title.db (13a) or import.db (13b) - **CAUSE**: CMACs could not be fixed for title.db (13a) or import.db (13b)
FIX : Pray - **FIX **: Pray
ERROR: "Error #14a: CIA install fail" - **ERROR**: "Error #14a: CIA install fail"
CAUSE: CIA (Anemone3DS) is corrupt, or issue with title database - **CAUSE**: CIA (Anemone3DS) is corrupt, or issue with title database
FIX : Check for title database issues, assuming there are none check for issues with Anemone3DS.cia / with the SD card, or use FBI for verbose error details - **FIX **: Check for title database issues, assuming there are none check for issues with Anemone3DS.cia / with the SD card, or use FBI for verbose error details
ERROR: "Error #14b: CIA install fail" (also: 14c, 14d, 14e, 14f) - **ERROR**: "Error #14b: CIA install fail" (also: 14c, 14d, 14e, 14f)
CAUSE: CIA after Anemone3DS is corrupt, so at least one CIA succeeded installation but one of them failed - **CAUSE**: CIA after Anemone3DS is corrupt, so at least one CIA succeeded installation but one of them failed
FIX : Most likely a corrupt file, so have user replace file in SD:/finalize (14b = Checkpoint; 14c = FBI; 14d = ftpd; 14e = HBL; 14f = U-U). Alternatively, sketchy SD card - **FIX **: Most likely a corrupt file, so have user replace file in SD:/finalize (14b = Checkpoint; 14c = FBI; 14d = ftpd; 14e = HBL; 14f = U-U). Alternatively, sketchy SD card
ERROR: "Fatal Error #15: File creation fail" - **ERROR**: "Fatal Error #15: File creation fail"
CAUSE: 0:/gm9/flags/BACKUPFLAG could not be created - **CAUSE**: 0:/gm9/flags/BACKUPFLAG could not be created
FIX : This might happen if someone runs through NOSPACE more than once, because GodMode9 will not be able to create a file if it already exists. Ensure user has a working NAND backup and if they do then they can continue normally (move NAND backup off of SD, run script as normal). - **FIX **: This might happen if someone runs through NOSPACE more than once, because GodMode9 will not be able to create a file if it already exists. Ensure user has a working NAND backup and if they do then they can continue normally (move NAND backup off of SD, run script as normal).
ERROR: "Fatal Error #16: Title database mount fail" - **ERROR**: "Fatal Error #16: Title database mount fail"
CAUSE: A:/title.db exists but could not be mounted - **CAUSE**: A:/title.db exists but could not be mounted
FIX : This may happen if user has a dummy title database, in which case allowing the prompt is fine. Otherwise user's SD might be failing and data should be backed up yesterday. - **FIX **: This may happen if user has a dummy title database, in which case allowing the prompt is fine. Otherwise user's SD might be failing and data should be backed up yesterday.
ERROR: "Information #17: Duplicate NAND backup" - **ERROR**: "Information #17: Duplicate NAND backup"
CAUSE: 0:/gm9/flags/BACKUPFLAG exists, and 0:/Nintendo 3DS does not exist (user ran through NOSPACE more than once even though the NAND backup succeeded) - **CAUSE**: 0:/gm9/flags/BACKUPFLAG exists, and 0:/Nintendo 3DS does not exist (user ran through NOSPACE more than once even though the NAND backup succeeded)
FIX : Verify user has a NAND backup, and if they do then they should continue NOSPACE (move NAND backup off of SD, move Nintendo 3DS folder back onto SD) - **FIX **: Verify user has a NAND backup, and if they do then they should continue NOSPACE (move NAND backup off of SD, move Nintendo 3DS folder back onto SD)
ERROR: "Error #18: MSET9 detected" - **ERROR**: "Error #18: MSET9 detected"
CAUSE: MSET9 detected because user ID0 folder has a folder with "_user-id1" appended to it - **CAUSE**: MSET9 detected because user ID0 folder has a folder with "_user-id1" appended to it
FIX : Remove MSET9 (manually if failed to remove through mset9.py/MSET9 Installer, i.e. Chromebook) - **FIX **: Remove MSET9 (manually if failed to remove through mset9.py/MSET9 Installer, i.e. Chromebook)
> NOTE: There are no errors #19 or #20; I have no idea why I skipped them, I think I thought I already used them when I didn't > NOTE: There are no errors #19 or #20; I have no idea why I skipped them, I think I thought I already used them when I didn't
## Scriptrunner-integrated error checking (finalize_helper.firm) ## Scriptrunner-integrated error checking (finalize_helper.firm)
ERROR: "Error #21: finalize.romfs not found" - **ERROR**: "Error #21: finalize.romfs not found"
CAUSE: finalize.romfs could not be found in any of the checked locations (SD root, 3ds, Nintendo 3DS, DCIM, luma, /luma/payloads) - **CAUSE**: finalize.romfs could not be found in any of the checked locations (SD root, 3ds, Nintendo 3DS, DCIM, luma, /luma/payloads)
FIX : Have user place finalize.romfs in the right directory - **FIX **: Have user place finalize.romfs in the right directory
ERROR: "Error #22: finalize.romfs is invalid" - **ERROR**: "Error #22: finalize.romfs is invalid"
CAUSE: finalize.romfs does not match finalize_helper.firm's hardcoded checksum (corrupted SD? outdated file/) - **CAUSE**: finalize.romfs does not match finalize_helper.firm's hardcoded checksum (corrupted SD? outdated file/)
FIX : Replace finalize.romfs with freshly downloaded copy - **FIX **: Replace finalize.romfs with freshly downloaded copy
ERROR: "Information #23: finalize.romfs in wrong location - **ERROR**: "Information #23: finalize.romfs in wrong location
CAUSE: finalize.romfs is placed in 0:/Nintendo 3DS (this folder requires additional consent from GodMode9) - **CAUSE**: finalize.romfs is placed in 0:/Nintendo 3DS (this folder requires additional consent from GodMode9)
FIX : Tell user to allow prompts, even though it says "this is not recommended" - **FIX **: Tell user to allow prompts, even though it says "this is not recommended"
ERROR: "Error #24: SD is write-protected" - **ERROR**: "Error #24: SD is write-protected"
CAUSE: Script failed to write "0:/WRITE" dummy file (thus, SD is locked) - **CAUSE**: Script failed to write "0:/WRITE" dummy file (thus, SD is locked)
FIX : Tell user to unlock SD; if SD is unlocked, try tape-over-the-switch method, otherwise SD card is likely failing - **FIX **: Tell user to unlock SD; if SD is unlocked, try tape-over-the-switch method, otherwise SD card is likely failing
NOTE : You can emulate this by creating a file named WRITE with no file extension on root of SD NOTE : You can emulate this by creating a file named WRITE with no file extension on root of SD
## Other script-related errors ## Other script-related errors
ERROR: FBI fails to install CIAs with error 0xD900458A - **ERROR**: FBI fails to install CIAs with error 0xD900458A
CAUSE: Corrupted title database, likely caused by running dummy title database creation (from an outdated script) and then opening FBI via Download Play without resetting title database - **CAUSE**: Corrupted title database, likely caused by running dummy title database creation (from an outdated script) and then opening FBI via Download Play without resetting title database
FIX : Regardless, tell people to replace the dummy title database (DBRESET). Then, you can either have them install everything through FBI and then run the script again (redundant), or just tell people to run the script. - **FIX **: Regardless, tell people to replace the dummy title database (DBRESET). Then, you can either have them install everything through FBI and then run the script again (redundant), or just tell people to run the script.
## Other documentation ## Other documentation