From 37282dd7125ee067b269bf049ec91efac915be7d Mon Sep 17 00:00:00 2001
From: ManiacOfGitHub <43019219+ManiacOfGitHub@users.noreply.github.com>
Date: Sat, 26 Jul 2025 17:45:12 -0400
Subject: [PATCH 1/6] Initial changes for migrating to lua

---
 GodMode9                    |   2 +-
 Makefile                    |   6 +-
 README.md                   |  19 +-
 finalize.lua                |   2 +
 finalize_helper.gm9         |  97 ------
 romfs/finalize/finalize.gm9 | 582 ------------------------------------
 6 files changed, 15 insertions(+), 693 deletions(-)
 create mode 100644 finalize.lua
 delete mode 100644 finalize_helper.gm9
 delete mode 100644 romfs/finalize/finalize.gm9

diff --git a/GodMode9 b/GodMode9
index f611b31..712df19 160000
--- a/GodMode9
+++ b/GodMode9
@@ -1 +1 @@
-Subproject commit f611b31c0c6aa40a04106a4c4ca7e85b740fa38a
+Subproject commit 712df196f129e20ce6b81d7766f31d4158f7fbe0
diff --git a/Makefile b/Makefile
index 15a8788..c8d2e9c 100644
--- a/Makefile
+++ b/Makefile
@@ -9,12 +9,12 @@ builds/finalize.romfs: builds
 	@3dstool -c -t romfs --romfs-dir romfs --file $@
 
 builds/x_finalize_helper.firm: builds/finalize.romfs
-	@cp finalize_helper.gm9 GodMode9/data/autorun.gm9
-	@sed -i s/FINALIZE_SHA256SUM/$(shell sha256sum $< | awk '{print $$1}')/g GodMode9/data/autorun.gm9
+	@cp finalize.lua GodMode9/data/autorun.lua
+	@sed -i s/FINALIZE_SHA256SUM/$(shell sha256sum $< | awk '{print $$1}')/g GodMode9/data/autorun.lua
 	@$(MAKE) -C GodMode9 SCRIPT_RUNNER=1
 	@cp GodMode9/output/GodMode9.firm $@
 	@printf '\001' | dd conv=notrunc bs=1 seek=16 of=$@
 clean:
 	@rm -rf builds
 	@$(MAKE) -C GodMode9 clean
-	@rm GodMode9/data/autorun.gm9
+	@rm GodMode9/data/autorun.lua
diff --git a/README.md b/README.md
index e078ae7..a9acfb4 100644
--- a/README.md
+++ b/README.md
@@ -3,15 +3,14 @@
 Scripts relating to Finalizing Setup on https://3ds.hacks.guide/finalizing-setup.
 
 - [`/romfs/finalize/`](romfs/finalize): Files that are packed into `finalize.romfs`
-    - [`/romfs/finalize/img`](romfs/finalize/img): Images used for visual troubleshooting 
-    - [`/romfs/finalize/finalize.gm9`](romfs/finalize/finalize.gm9): Script run after `finalize_helper.gm9` that:
-        - Installs base homebrew applications to SYSNAND SD (see below for list)
-        - Copies GodMode9 to CTRNAND (`/rw/luma/payloads`)
-        - Backs up `essential.exefs` to `/gm9/backups`
-        - Deletes CFW installation files that are no longer necessary
-        - Backs up minsize NAND backup to `/gm9/backups`
-    - `/romfs/finalize/donor.db`: Empty title database used for consoles that do not have title database (i.e. no eShop software)
-- [`finalize_helper.gm9`](finalize_helper.gm9): Script that is compiled as GM9 scriptrunner (`finalize_helper.firm`); extracts `finalize.romfs`
+    - [`/romfs/finalize/img`](romfs/finalize/img): Images used for visual troubleshooting
+    - [`/romfs/finalize/donor.db`](romfs/finalize/donor.db): Empty title database used for consoles that do not have title database (i.e. no eShop software)
+- [`finalize_helper.lua`](finalize_helper.lua): Lua script that is compiled as GM9 scriptrunner (`x_finalize_helper.firm`) that:
+    - Installs base homebrew applications to SYSNAND SD (see below for list)
+    - Copies all payloads inside `/luma/payloads` on the SD card to CTRNAND (`/rw/luma/payloads`)
+    - Backs up `essential.exefs` to `/gm9/backups`
+    - Deletes CFW installation files that are no longer necessary
+    - Backs up minsize NAND backup to `/gm9/backups`
 - [`docs.md`](docs.md): Full error information / script documentation
 
 ## Bundled software
@@ -32,7 +31,7 @@ Releases are tagged for reference (based on usage in the guide). **Releases in t
 
 ### Automatically built binaries
 
-Binaries are automatically built by [GitHub Actions](https://github.com/hacks-guide/finalize/actions/). Place `finalize_helper.firm` in `/luma/payloads/` and `finalize.romfs` on root of SD.
+Binaries are automatically built by [GitHub Actions](https://github.com/hacks-guide/finalize/actions/). Place `x_finalize_helper.firm` in `/luma/payloads/` and `finalize.romfs` on root of SD.
 
 ### Manual file placement
 
diff --git a/finalize.lua b/finalize.lua
new file mode 100644
index 0000000..f84a9d8
--- /dev/null
+++ b/finalize.lua
@@ -0,0 +1,2 @@
+ui.echo("This would be Finalizing Setup,\nbut for now it is just stubbed.\nPress (A) to power off.")
+sys.power_off()
\ No newline at end of file
diff --git a/finalize_helper.gm9 b/finalize_helper.gm9
deleted file mode 100644
index 2c96350..0000000
--- a/finalize_helper.gm9
+++ /dev/null
@@ -1,97 +0,0 @@
-# Scriptrunner for https://3ds.hacks.guide/finalizing-setup file copying operations
-# Ver. 1.10.2 - Last modified: 2025-04-14
-
-set PREVIEW_MODE "Finalizing Setup Helper Script\n> Copying SD files..."
-
-set WRITE 0:/WRITE
-rm -o -s $[WRITE]
-if fdummy $[WRITE] 400
-   rm -o -s $[WRITE]
-else
-   set PREVIEW_MODE "Finalizing Setup Helper Script\n> Copying SD files... :("
-   echo "Error #24: SD is write-protected\n \nYour SD card is set to read-only.\nEnsure that the lock switch is flipped\nin the upright position.\nOtherwise, your SD card may be failing.\n \nIf this error persists, ask for help\non Discord: https://discord.gg/MWxPgEp"
-   poweroff
-end
-
-if find -f "0:/finalize (*).romfs" ROMFS
-    cp -w -o -s $[ROMFS] 0:/finalize.romfs
-    rm -o -s $[ROMFS]
-end
-
-if find -f "0:/3ds/finalize (*).romfs" ROMFS
-    cp -w -o -s $[ROMFS] 0:/finalize.romfs
-    rm -o -s $[ROMFS]
-end
-
-if find -f "0:/luma/payloads/finalize (*).romfs" ROMFS
-    cp -w -o -s $[ROMFS] 0:/finalize.romfs
-    rm -o -s $[ROMFS]
-end
-
-if find -f "0:/luma/finalize (*).romfs" ROMFS
-    cp -w -o -s $[ROMFS] 0:/finalize.romfs
-    rm -o -s $[ROMFS]
-end
-
-if find -f "0:/DCIM/finalize (*).romfs" ROMFS
-    cp -w -o -s $[ROMFS] 0:/finalize.romfs
-    rm -o -s $[ROMFS]
-end
-
-if find -f "0:/Nintendo 3DS/finalize (*).romfs" ROMFS
-    echo "Information #23: finalize.romfs in wrong location\n \nfinalize.romfs is in the wrong location.\nThis script will attempt to move it.\nPlease hit <A> on the next few prompts."
-    cp -w -o -s $[ROMFS] 0:/finalize.romfs
-    rm -o -s $[ROMFS]
-end
-
-if find 0:/3ds/finalize.romfs NULL
-    cp -w -o -s 0:/3ds/finalize.romfs 0:/finalize.romfs
-    rm -o -s 0:/3ds/finalize.romfs
-end
-
-if find 0:/luma/payloads/finalize.romfs NULL
-    cp -w -o -s 0:/luma/payloads/finalize.romfs 0:/finalize.romfs
-    rm -o -s 0:/luma/payloads/finalize.romfs
-end
-
-if find 0:/luma/finalize.romfs NULL
-    cp -w -o -s 0:/luma/finalize.romfs 0:/finalize.romfs
-    rm -o -s 0:/luma/finalize.romfs
-end
-
-if find 0:/DCIM/finalize.romfs NULL
-    cp -w -o -s 0:/DCIM/finalize.romfs 0:/finalize.romfs
-    rm -o -s 0:/DCIM/finalize.romfs
-end
-
-if find "0:/Nintendo 3DS/finalize.romfs" NULL
-    echo "Information #23: finalize.romfs in wrong location\n \nfinalize.romfs is in the wrong location.\nThis script will attempt to move it.\nPlease hit <A> on the next few prompts."
-    cp -w -o -s "0:/Nintendo 3DS/finalize.romfs" 0:/finalize.romfs
-    rm -o -s "0:/Nintendo 3DS/finalize.romfs"
-end
-
-if not find 0:/finalize.romfs NULL
-    set PREVIEW_MODE "Finalizing Setup Helper Script\n> Copying SD files... :("
-    echo "Error #21: finalize.romfs not found\n \nfinalize.romfs could not be found on the SD card.\nCopy it to root of SD and try again."
-    poweroff
-end
-
-if not sha 0:/finalize.romfs FINALIZE_SHA256SUM
-    shaget 0:/finalize.romfs ACTUAL_SHA256SUM
-    set PREVIEW_MODE "Finalizing Setup Helper Script\n> Copying SD files... :("
-    echo "Error #22: finalize.romfs is invalid\n \nThe file finalize.romfs is corrupt or unreadable.\nRe-download it, copy it to root of SD, and try again.\n \nExpected: FINALIZE_SHA256SUM\nReceived: $[ACTUAL_SHA256SUM]"
-    poweroff
-else
-    imgmount 0:/finalize.romfs
-    cp -w -o -s G:/finalize/GodMode9.firm 0:/luma/payloads/GodMode9.firm
-    if not find 0:/gm9/scripts NULL
-        mkdir 0:/gm9/scripts
-    end
-    cp -w -o -s G:/finalize/finalize.gm9 0:/gm9/scripts/finalize.gm9
-    imgumount
-end
-
-if not boot 0:/luma/payloads/GodMode9.firm
-   echo "Error #25: Could not boot GodMode9\n \nThis normally happens due to insufficient SD space.\nPlease make at least 20MB of free space."
-   poweroff
-end
diff --git a/romfs/finalize/finalize.gm9 b/romfs/finalize/finalize.gm9
deleted file mode 100644
index 0c5f251..0000000
--- a/romfs/finalize/finalize.gm9
+++ /dev/null
@@ -1,582 +0,0 @@
-# Script for https://3ds.hacks.guide/finalizing-setup
-# Ver. 1.10.2 - Last modified: 2025-04-14
-# GodMode9 scripts can be dangerous!
-# Visit https://github.com/hacks-guide/finalize/releases to verify the integrity of this script.
-# Credits: GM9Megascript contributors ("Scripts from Plailect's Guide"), Mr. Burguers (SD card capacity check), ihaveamac (title.db stuff), J0n_b0 (MSET9 check), Naim2000 (better Nintendo 3DS folder check)
-
-rm -o -s 0:/luma/payloads/finalize_helper.firm
-for 0:/luma/payloads *_finalize_helper.firm
-	rm -o -s $[FORPATH]
-next
-
-set PREVIEW_MODE "> Checking for problems...\nAsking for permission... ---\nInstalling homebrew... ---\nCopying GodMode9 to CTRNAND... ---\nCleaning up SD card... ---\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-
-# First order of business - Grab a hold of finalize.romfs
-if not find G:/finalize/finalize.gm9 NULL
-	if not find 0:/finalize.romfs ROMFS
-		set PREVIEW_MODE "> Checking for problems... :(\nAsking for permission... ---\nInstalling homebrew... ---\nCopying GodMode9 to CTRNAND... ---\nCleaning up SD card... ---\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-		echo "Error #21: finalize.romfs not found\n \nfinalize.romfs could not be found on the SD card.\nCopy it to root of SD and try again."
-		poweroff
-	end
-
-	if not shaget $[ROMFS] ROMFS_SHA256
-		set PREVIEW_MODE "> Checking for problems... :(\nAsking for permission... ---\nInstalling homebrew... ---\nCopying GodMode9 to CTRNAND... ---\nCleaning up SD card... ---\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-		echo "Error #22: finalize.romfs is unreadable\n \nCould not read finalize.romfs.\n(How did this happen..? Did it get corrupt?)\n\nCopy finalize.romfs to your SD card and try again."
-		poweroff
-	end
-
-	if not imgmount $[ROMFS]
-		set PREVIEW_MODE "> Checking for problems... :(\nAsking for permission... ---\nInstalling homebrew... ---\nCopying GodMode9 to CTRNAND... ---\nCleaning up SD card... ---\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-		echo "Error #22: Failed to mount finalize.romfs\n\nCould not mount finalize.romfs.\n(How did this happen..? Did it get corrupt?)\n\nCopy finalize.romfs to your SD card and try again."
-		poweroff
-	end
-end
-
-# Copy finalize files to RAMDRIVE
-if not cp -w -s G:/finalize 9:/finalize
-	# WHAT????
-	set PREVIEW_MODE "> Checking for problems... :(\nAsking for permission... ---\nInstalling homebrew... ---\nCopying GodMode9 to CTRNAND... ---\nCleaning up SD card... ---\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-	echo "Error #22: finalize.romfs is unreadable\n \nCould not copy files from finalize.romfs.\n(How did this happen..? Did it get corrupt?)\n\nCopy finalize.romfs to your SD card and try again."
-	poweroff
-end
-
-# We're done with finalize.romfs now
-imgumount
-
-# Check for missing essentials
-# BuildEssentialBackup() will return 1 (failure) if any of these files are missing. As well as nand_hdr.bin, but like lol
-
-set MISSINGESSENTIAL ""
-set SEED ""
-
-if	find -s 1:/rw/sys/SecureInfo_A NULL
-elif	find -s 1:/rw/sys/SecureInfo_B NULL
-else
-	set MISSINGESSENTIAL "$[MISSINGESSENTIAL]SecureInfo\n" # Does GodMode9 support \t
-end
-
-if	find -s 1:/rw/sys/LocalFriendCodeSeed_B NULL
-elif	find -s 1:/rw/sys/LocalFriendCodeSeed_A NULL
-else
-	set MISSINGESSENTIAL "$[MISSINGESSENTIAL]LocalFriendCodeSeed\n"
-end
-
-if	find -s 1:/private/movable.sed SEED
-else
-	set MISSINGESSENTIAL "$[MISSINGESSENTIAL]movable.sed\n"
-end
-
-# Check for missing essential.exefs
-
-if not find S:/essential.exefs NULL
-	if chk -u $[MISSINGESSENTIAL] ""
-		set PREVIEW_MODE "9:/finalize/img/error30.png"
-		echo "Fatal Error #30: Missing console-unique files\n \nThe following files are missing from the NAND:\n$[MISSINGESSENTIAL]\n \nAsk for help on Discord:\nhttps://discord.gg/MWxPgEp"
-		poweroff
-	else
-		set PREVIEW_MODE "9:/finalize/img/error02.png"
-		echo "Error #02: Missing essential.exefs\n \nessential.exefs does not exist.\nClose and re-open GodMode9,\nmaking sure to say Yes to the\n'Create essential files' popup."
-		poweroff
-	end
-end
-
-# Check for missing Nintendo 3DS folder
-
-if not find "0:/Nintendo 3DS" NULL
-	if find 0:/gm9/flags/BACKUPFLAG NULL
-		goto BACKUPDUPE
-	end
-	goto NOSPACE
-end
-
-# Okay, at this point, we have the Nintendo 3DS folder. But do we have A: ?
-
-@IS_SYSNAND_SD_OK
-
-if isdir A:
-	goto SYSNAND_SD_OK
-end
-
-# We don't. Why not?
-
-if not shaget $[SEED]@110:10 NULL # This should end up failing normally if SEED is "". I'd hope. Someone test this.
-	set PREVIEW_MODE "9:/finalize/img/error31.png"
-	echo "Fatal Error #31: Missing encryption key\n \nThe system is missing movable.sed from NAND.\n(How did this happen...?)\n \nAsk for help on Discord:\nhttps://discord.gg/MWxPgEp"
-	# At this stage, we have essential.exefs.
-	# I could copy it. But how do we know that this isn't like, a failed/cancelled Manual Movable Moveover? The user might have been doing something.
-	poweroff
-end
-
-# Okay, we have an ID0. Is it there?
-
-if not find "0:/Nintendo 3DS/$[SYSID0]" SYSID0PATH
-	if find 0:/gm9/flags/nospace NULL
-		goto NOSPACE
-	end
-
-	set PREVIEW_MODE "9:/finalize/img/error33.png"
-	echo "Information #33: Empty Nintendo 3DS folder\n \nThe Nintendo 3DS folder has no data for this console.\nTurn on your console with the SD inserted,\nallow it to reach the HOME Menu, then run\nthis script again."
-	reboot
-end
-
-# Check for and attempt to fix edited MSET9 ID1
-
-if find "$[SYSID0PATH]/????????????????????????????????_user-id1" CURRENT
-	set PREVIEW_MODE "9:/finalize/img/error18a.png"
-	echo "Error #18a: MSET9 detected\n \nID1 still affected by MSET9.\nAttempting to fix it.\n \nPress (A) to continue, then\nenter the key combo if prompted."
-	allow "0:/Nintendo 3DS"
-	strsplit -b REAL $[CURRENT] "_"
-	if not mv $[CURRENT] $[REAL]
-		set PREVIEW_MODE "9:/finalize/img/error19a.png"
-		echo "Fatal Error #19a: Could not remove MSET9\n \nFailed to rename ID1.\nPlease remove MSET9 manually.\nIf you continue to see this prompt,\nask for help on Discord:\nhttps://discord.gg/MWxPgEp"
-		poweroff
-	end
-	if find "$[SYSID0PATH]/*sdmc*b9" MSET9ID1
-		if not rm -s $[MSET9ID1]
-			set PREVIEW_MODE "9:/finalize/img/error19b.png"
-			echo "Fatal Error #19b: Could not remove MSET9\n \nFailed to remove hax'd ID1.\nPlease remove MSET9 manually.\nIf you continue to see this prompt,\nask for help on Discord:\nhttps://discord.gg/MWxPgEp"
-		poweroff
-		end
-	end
-	set FIXEDMSET9 YES
-end
-
-# Check for and attempt to delete hax'd MSET9
-
-if find "$[SYSID0PATH]/*sdmc*b9" MSET9ID1
-	set PREVIEW_MODE "9:/finalize/img/error18b.png"
-	echo "Error #18b: MSET9 detected\n \nMSET9 hax'd ID1 is still present.\n \nAttempting to fix it.\n \nPress (A) to continue, then\nenter the key combo if prompted."
-	allow "0:/Nintendo 3DS"
-	if not rm -s $[MSET9ID1]
-		set PREVIEW_MODE "9:/finalize/img/error19b.png"
-		echo "Fatal Error #19b: Could not remove MSET9\n \nFailed to remove hax'd ID1.\nPlease remove MSET9 manually.\nIf you continue to see this prompt,\nask for help on Discord:\nhttps://discord.gg/MWxPgEp"
-		poweroff
-	end
-	set FIXEDMSET9 YES
-end
-
-# Eject and reinsert SD to mount SYSNAND SD
-
-if chk $[FIXEDMSET9] YES
-	set PREVIEW_MODE "9:/finalize/img/mset9_reinsert.png"
-	switchsd "MSET9 has been removed.\n \nEject and reinsert your SD card to continue."
-	goto IS_SYSNAND_SD_OK
-end
-
-# SYSID0 path exists at this point, yet not SYSNAND SD. Why?
-
-set PREVIEW_MODE "9:/finalize/img/error32.png"
-echo "Fatal Error #32: Nintendo 3DS folder is inaccessible\n \nCould not access the Nintendo 3DS folder.\n(How did this happen..?)\n \nAsk for help on Discord:\nhttps://discord.gg/MWxPgEp"
-poweroff
-
-@SYSNAND_SD_OK
-
-# Check for sufficient SD space
-
-if find 0:/gm9/flags/BACKUPFLAG NULL
-	goto SDFREE_NEXT
-end
-
-if chk $[SDFREE] INVALID # should not happen
-    set PREVIEW_MODE "9:/finalize/img/error07.png"
-    echo "Fatal Error #07: No SD size\n \nCould not get SD card size.\nThis should not happen.\nAsk for help on Discord:\nhttps://discord.gg/MWxPgEp"
-else
-    strsplit -f -b SDFREE_VALUE $[SDFREE] " "
-    strsplit -f SDFREE_UNITS $[SDFREE] " "
-    if chk $[SDFREE_UNITS] GB
-        if chk $[ONTYPE] O3DS
-            goto SDFREE_NEXT
-        end
-        strsplit -f -b SDFREE_VALUE_1 $[SDFREE_VALUE] .
-        strsplit -f SDFREE_VALUE_2 $[SDFREE_VALUE] .
-        if chk -u $[SDFREE_VALUE_1] 1
-            goto SDFREE_NEXT
-        end
-        if chk $[SDFREE_VALUE_2] 0
-        elif chk $[SDFREE_VALUE_2] 1
-        elif chk $[SDFREE_VALUE_2] 2
-        elif chk $[SDFREE_VALUE_2] 3
-        else
-            goto SDFREE_NEXT
-        end
-    end
-    if not find 0:/gm9/flags NULL
-        mkdir -o -s 0:/gm9/flags
-    end
-    fdummy -o -s 0:/gm9/flags/nospace 400
-    if chk $[ONTYPE] O3DS
-        set PREVIEW_MODE "9:/finalize/img/error04.png"
-        echo "Error #04: No space\n \nInsufficient space on SD card.\nYou need 1.0GB, but you have $[SDFREE].\nMake some space, then try again.\n \nTIP: You can temporarily remove the Nintendo 3DS\nand DCIM folders from your SD card\nto make enough space."
-    else
-        set PREVIEW_MODE "9:/finalize/img/error04.png"
-        echo "Error #04: No space\n \nInsufficient space on SD card.\nYou need 1.4GB, but you have $[SDFREE].\nMake some space, then try again.\n \nTIP: You can temporarily remove the Nintendo 3DS\nand DCIM folders from your SD card\nto make enough space."
-    end
-end
-poweroff
-
-@SDFREE_NEXT
-
-# If INSTALLFLAG exists, show setup message that skips CIA install
-
-if find 0:/gm9/flags/INSTALLFLAG NULL
-	set PREVIEW_MODE "Checking for problems... DONE\n> Asking for permission...\nInstalling homebrew... SKIP\nCopying GodMode9 to CTRNAND... ---\nCleaning up SD card... ---\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-	ask "This script will do the following:\n- Copy GodMode9 to CTRNAND\n- Remove unnecessary SD files\n- Create an essential.exefs backup\n- Create a NAND backup (~1GB)\n \nThis script may take up to\nfifteen minutes to complete.\n \nIf you're okay with this,\npress (A) to continue."
-	allow 1:
-	goto INSTALL_NEXT
-end
-
-# Check for title database
-
-if not find A:/dbs/title.db NULL
-	set PREVIEW_MODE "9:/finalize/img/error05.png"
-	ask "Information #05: No title database\n \nTitle database not found.\nPress (A) to automatically import one.\n(A title database is necessary\nfor this script to run.)"
-	goto IMPORT
-end
-
-if not imgmount A:/dbs/title.db
-	set PREVIEW_MODE "9:/finalize/img/error16.png"
-	if ask "Error #16: Title database mount fail\n \nTitle database exists, but could not\nbe accessed.\n \nAttempt donor import?\n(If you have anything installed on\nthis console, this may result in\ninstalled digital games being rendered\n INACCESSIBLE!)"
-	goto IMPORT
-	else
-	poweroff
-	end
-end
-
-goto MAIN
-
-@IMPORT
-
-mkdir -o -s A:/dbs
-
-if not cp -w -o -s 9:/finalize/donor.db A:/dbs/title.db
-	set PREVIEW_MODE "9:/finalize/img/error12a.png"
-	echo "Error #12a: Copy title.db fail\n \nTitle database could not be copied to A:/dbs.\n(Is your SD card locked?)\n \nAsk for help on Discord:\nhttps://discord.gg/MWxPgEp"
-	poweroff
-end
-
-if not cp -w -o -s 9:/finalize/donor.db A:/dbs/import.db
-	set PREVIEW_MODE "9:/finalize/img/error12b.png"
-	echo "Error #12b: Copy import.db fail\n \nTitle database could not be copied to A:/dbs.\n(Is your SD card locked?)\n \nAsk for help on Discord:\nhttps://discord.gg/MWxPgEp"
-	poweroff
-end
-
-if not fixcmac A:/dbs/title.db
-	set PREVIEW_MODE "9:/finalize/img/error13a.png"
-	echo "Fatal Error #13a: Fix CMAC fail\n \nCMACs could not be fixed for title database.\n(How did this happen?)\n \nAsk for help on Discord:\nhttps://discord.gg/MWxPgEp"
-	poweroff
-end
-
-if not fixcmac A:/dbs/import.db
-	set PREVIEW_MODE "9:/finalize/img/error13b.png"
-	echo "Fatal Error #13b: Fix CMAC fail\n \nCMACs could not be fixed for title database.\n(How did this happen?)\n \nAsk for help on Discord:\nhttps://discord.gg/MWxPgEp"
-	poweroff
-end
-
-
-
-@MAIN
-
-# Ask for consent here
-
-set PREVIEW_MODE "Checking for problems... DONE\n> Asking for permission...\nInstalling homebrew... ---\nCopying GodMode9 to CTRNAND... ---\nCleaning up SD card... ---\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-
-ask "This script will do the following:\n- Install base homebrew applications\n- Copy GodMode9 to CTRNAND\n- Remove unnecessary SD files\n- Create an essential.exefs backup\n- Create a NAND backup (~1GB)\n \nThis script may take up to\nfifteen minutes to complete.\n \nIf you're okay with this,\npress (A) to continue."
-allow 1:
-		
-set PREVIEW_MODE "Checking for problems... DONE\nAsking for permission... DONE\n> Installing homebrew...\nCopying GodMode9 to CTRNAND... ---\nCleaning up SD card... ---\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-
-# Install base homebrew applications
-# Can't be issues with the copy anymore...
-
-if not install 9:/finalize/Anemone3DS.cia
-	set PREVIEW_MODE "9:/finalize/img/error14a.png"
-	echo "Error #14a: CIA install fail\n \nA CIA (Anemone3DS) failed to install.\n \nAsk for help on Discord: https://discord.gg/MWxPgEp"
-	poweroff
-end
-
-if not install 9:/finalize/Checkpoint.cia
-	set PREVIEW_MODE "9:/finalize/img/error14b.png"
-	echo "Error #14b: CIA install fail\n \nA CIA (Checkpoint) failed to install.\n \nAsk for help on Discord: https://discord.gg/MWxPgEp"
-	poweroff
-end
-
-if not install 9:/finalize/FBI.cia
-	set PREVIEW_MODE "9:/finalize/img/error14c.png"
-	echo "Error #14c: CIA install fail\n \nA CIA (FBI) failed to install.\n \nAsk for help on Discord: https://discord.gg/MWxPgEp"
-	poweroff
-end
-
-if not install 9:/finalize/ftpd.cia
-	set PREVIEW_MODE "9:/finalize/img/error14d.png"
-	echo "Error #14d: CIA install fail\n \nA CIA (ftpd) failed to install.\n \nAsk for help on Discord: https://discord.gg/MWxPgEp"
-	poweroff
-end
-
-if not install 9:/finalize/Homebrew_Launcher.cia
-	set PREVIEW_MODE "9:/finalize/img/error14e.png"
-	echo "Error #14e: CIA install fail\n \nA CIA (Homebrew Launcher) failed to install.\n \nAsk for help on Discord: https://discord.gg/MWxPgEp"
-	poweroff
-end
-
-if not install 9:/finalize/Universal-Updater.cia
-	set PREVIEW_MODE "9:/finalize/img/error14f.png"
-	echo "Error #14f: CIA install fail\n \nA CIA (Universal-Updater) failed to install.\n \nAsk for help on Discord: https://discord.gg/MWxPgEp"
-	poweroff
-end
-
-set PREVIEW_MODE "Checking for problems... DONE\nAsking for permission... DONE\nInstalling homebrew... DONE\n> Copying GodMode9 to CTRNAND...\nCleaning up SD card... ---\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-
-@INSTALL_NEXT
-
-if find 0:/gm9/flags/INSTALLFLAG NULL
-	set PREVIEW_MODE "Checking for problems... DONE\nAsking for permission... DONE\nInstalling homebrew... SKIP\n> Copying GodMode9 to CTRNAND...\n> Cleaning up SD card...\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-end
-
-# Copy GodMode9 to CTRNAND
-
-cp -w -o -s 0:/luma/payloads 1:/rw/luma/payloads
-
-# Delete Finalizing Setup Helper on CTRNAND if it exists
-
-rm -o -s 1:/rw/luma/payloads/finalize_helper.firm
-for 1:/rw/luma/payloads *_finalize_helper.firm
-	rm -o -s $[FORPATH]
-next
-
-set PREVIEW_MODE "Checking for problems... DONE\nAsking for permission... DONE\nInstalling homebrew... DONE\nCopying GodMode9 to CTRNAND... DONE\n> Cleaning up SD card...\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-
-if find 0:/gm9/flags/INSTALLFLAG NULL
-	set PREVIEW_MODE "Checking for problems... DONE\nAsking for permission... DONE\nInstalling homebrew... SKIP\nCopying GodMode9 to CTRNAND... ---\n> Cleaning up SD card...\nBacking up essential.exefs... ---\nBacking up NAND... ---"
-end
-
-# Remove unnecessary SD files
-
-## A9LH to B9S / Updating B9S
-
-rm -o -s 0:/arm9loaderhax.bin
-rm -o -s 0:/arm9loaderhax_si.bin
-rm -o -s 0:/luma/payloads/SafeB9SInstaller.bin
-rm -o -s 0:/luma/payloads/Decrypt9WIP.bin
-rm -o -s 0:/luma/payloads/Hourglass9.bin
-rm -o -s 0:/luma/payloads/GodMode9.bin
-rm -o -s 0:/boot9strap/secret_sector.bin
-
-## General
-
-rm -o -s 0:/SafeB9SInstaller.bin
-rm -o -s 0:/boot9strap/boot9strap.firm
-rm -o -s 0:/boot9strap/boot9strap.firm.sha
-
-## Soundhax
-
-rm -o -s 0:/soundhax-chn-o3ds-post5.0.m4a
-rm -o -s 0:/soundhax-chn-o3ds-v3.xand4.x.m4a
-rm -o -s 0:/soundhax-eur-n3ds.m4a
-rm -o -s 0:/soundhax-eur-o3ds-post5.0.m4a
-rm -o -s 0:/soundhax-eur-o3ds-pre2.1.m4a
-rm -o -s 0:/soundhax-eur-o3ds-v2.1and2.2.m4a
-rm -o -s 0:/soundhax-eur-o3ds-v3.xand4.x.m4a
-rm -o -s 0:/soundhax-eur-o3ds-pre2.1-post5franken.m4a
-rm -o -s 0:/soundhax-eur-o3ds-v2.1and2.2-post5franken.m4a
-rm -o -s 0:/soundhax-jpn-n3ds.m4a
-rm -o -s 0:/soundhax-jpn-o3ds-post5.0.m4a
-rm -o -s 0:/soundhax-jpn-o3ds-pre2.1.m4a
-rm -o -s 0:/soundhax-jpn-o3ds-v2.1and2.2.m4a
-rm -o -s 0:/soundhax-jpn-o3ds-v3.xand4.x.m4a
-rm -o -s 0:/soundhax-jpn-o3ds-pre2.1-post5franken.m4a
-rm -o -s 0:/soundhax-jpn-o3ds-v2.1and2.2-post5franken.m4a
-rm -o -s 0:/soundhax-kor-n3ds.m4a
-rm -o -s 0:/soundhax-kor-o3ds-post5.0.m4a
-rm -o -s 0:/soundhax-kor-o3ds-v3.xand4.x.m4a
-rm -o -s 0:/soundhax-twn-o3ds-post5.0.4m4a
-rm -o -s 0:/soundhax-twn-o3ds-v3.xand4.x.m4a
-rm -o -s 0:/soundhax-usa-n3ds.m4a
-rm -o -s 0:/soundhax-usa-o3ds-post5.0.m4a
-rm -o -s 0:/soundhax-usa-o3ds-pre2.1.m4a
-rm -o -s 0:/soundhax-usa-o3ds-v2.1and2.2.m4a
-rm -o -s 0:/soundhax-usa-o3ds-v3.xand4.x.m4a
-rm -o -s 0:/soundhax-usa-o3ds-pre2.1-post5franken.m4a
-rm -o -s 0:/soundhax-usa-o3ds-v2.1and2.2-post5franken.m4a
-rm -o -s 0:/soundhax.m4a
-rm -o -s 0:/otherapp.bin
-
-## BannerBomb3
-
-rm -o -s 0:/bb3.bin
-rm -o -s "A:/Nintendo DSiWare/F00D43D5.bin"
-
-## unSAFE_MODE
-
-rm -o -s 0:/usm.bin
-rm -o -s 0:/3ds/slotTool/
-rm -o -s 0:/3ds/slotTool.3dsx
-
-## Fredtool / Frogtool
-
-rm -o -s 0:/484E4441.bin
-rm -o -s 0:/484E4441.bin.patched
-rm -o -s 0:/frogcert.bin
-rm -o -s 0:/private/ds/app/4B47554A/001/T00031_1038C2A757B77_000.ppm
-rm -o -s 0:/movable.sed
-rm -o -s 0:/3ds/Frogtool.3dsx
-rm -o -s 0:/boot.nds
-
-## Browser
-
-rm -o -s 0:/browserhax_hblauncher_ropbin_payload.bin
-rm -o -s 0:/arm11code.bin
-
-## menuhax67 / nimdsphax-common (that's y i'm requesting it be made)
-
-rm -o -s 0:/Launcher.dat # sorry gateway users
-rm -o -s 0:/3ds/menuhax67_installer.3dsx
-rm -o -s 0:/3ds/nimdsphax/
-
-## Alternate Exploits
-
-rm -o -s 0:/freaky.bin
-rm -o -s 0:/steelhax/
-rm -o -s 0:/petitcom_us.icn
-rm -o -s 0:/petitcom_jpn.icn # technically redundant
-rm -o -s 0:/petitcom_eu.icn
-
-## MSET9
-
-rm -o -s 0:/mset9.bat
-rm -o -s 0:/MSET9-Windows.bat
-rm -o -s 0:/mset9.command
-rm -o -s 0:/MSET9-macOS.command
-rm -o -s 0:/mset9.py
-rm -o -s 0:/b9
-rm -o -s 0:/SafeB9S.bin
-rm -o -s 0:/_INSTRUCTIONS.txt
-rm -o -s 0:/errors.txt
-
-set PREVIEW_MODE "Checking for problems... DONE\nAsking for permission... DONE\nInstalling homebrew... DONE\nCopying GodMode9 to CTRNAND... DONE\nCleaning up SD card... DONE\n> Backing up essential.exefs...\nBacking up NAND... ---"
-
-if find 0:/gm9/flags/INSTALLFLAG NULL
-	set PREVIEW_MODE "Checking for problems... DONE\nAsking for permission... DONE\nInstalling homebrew... SKIP\nCopying GodMode9 to CTRNAND... DONE\nCleaning up SD card... DONE\n> Backing up essential.exefs...\n> Backing up NAND... ---"
-end
-
-# Backup essential.exefs
-
-if not find 0:/gm9/backups NULL
-	mkdir 0:/gm9/backups
-end
-findnot 0:/gm9/backups/$[SERIAL]_essential_??.exefs OUTPATH
-cp -w S:/essential.exefs $[OUTPATH]
-
-set PREVIEW_MODE "Checking for problems... DONE\nAsking for permission... DONE\nInstalling homebrew... DONE\nCopying GodMode9 to CTRNAND... DONE\nCleaning up SD card... DONE\nBacking up essential.exefs... DONE\n> Backing up NAND..."
-
-if find 0:/gm9/flags/INSTALLFLAG NULL
-	set PREVIEW_MODE "Checking for problems... DONE\nAsking for permission... DONE\nInstalling homebrew... SKIP\nCopying GodMode9 to CTRNAND... DONE\nCleaning up SD card... DONE\nBacking up essential.exefs... DONE\n> Backing up NAND... ---"
-end
-
-# NAND backup
-
-if find 0:/gm9/flags/BACKUPFLAG NULL
-	goto BACKUPSKIP
-end
-
-findnot 0:/gm9/backups/$[DATESTAMP]_$[SERIAL]_sysnand_??.bin OUTPATH
-
-if	cp -h S:/nand_minsize.bin $[OUTPATH]
-else
-	set PREVIEW_MODE "9:/finalize/img/error06.png"
- 	echo "Error #06: NAND backup fail\n \nThe NAND backup failed for some reason.\n(Did you cancel it?)\nAsk for help on Discord:\nhttps://discord.gg/MWxPgEp"
-	poweroff
-end
-goto CLEANUP
-
-@NOSPACE # Contingency if SD is backed up due to lack of space
-
-set PREVIEW_MODE "Checking for problems... No 3DS folder\n> Backing up NAND..."
-if not find 0:/gm9/backups NULL
-	mkdir 0:/gm9/backups
-end
-findnot 0:/gm9/backups/$[DATESTAMP]_$[SERIAL]_sysnand_??.bin OUTPATH
-
-if	cp -h S:/nand_minsize.bin $[OUTPATH]
-else
-	set PREVIEW_MODE "9:/finalize/img/error06_nospace.png"
- 	echo "Error #06: NAND backup fail\n \nThe NAND backup failed for some reason.\n(Do you have enough space?)\nAsk for help on Discord:\nhttps://discord.gg/MWxPgEp"
-	poweroff
-end
-
-if not find 0:/gm9/flags NULL
-	mkdir 0:/gm9/flags
-end
-if find 0:/gm9/flags/BACKUPFLAG NULL
-	rm -o -s 0:/gm9/flags/BACKUPFLAG
-end
-	
-set BACKUPFLAG 0:/gm9/flags/BACKUPFLAG
-if not fdummy $[BACKUPFLAG] 400
-	set PREVIEW_MODE "9:/finalize/img/error15.png"
- 	echo "Fatal Error #15: File creation fail\n \nCould not create 0:/gm9/flags/BACKUPFLAG.\n(How did this happen?)\n \nAsk for help on Discord:\nhttps://discord.gg/MWxPgEp"
-	poweroff
-end
-
-set PREVIEW_MODE "9:/finalize/img/emptysd_complete.png"
-echo "NAND backup complete.\nCopy the two SysNAND files in SD:/gm9/backups\nto a safe location on your computer, then\ndelete them from your SD card.\nThen, copy your Nintendo 3DS folder back\nto your SD card and re-run this script.\n \nIf you don't have a Nintendo 3DS folder backup,\nopen HOME Menu, then re-run this script."
-poweroff
-
-@CLEANUP # Self-removes script and remove script flags
-
-if find 0:/gm9/flags/INSTALLFLAG NULL
-	set PREVIEW_MODE "Checking for problems... DONE\nAsking for permission... DONE\nInstalling homebrew... SKIP\nCopying GodMode9 to CTRNAND... DONE\nCleaning up SD card... DONE\nBacking up essential.exefs... DONE\nBacking up NAND... DONE"
-	goto INSTALLSKIP
-end
-
-cp -w 9:/finalize/GM9Megascript.gm9 0:/gm9/scripts/GM9Megascript.gm9
-rm -o -s 0:/gm9/scripts/finalize.gm9
-rm -o -s 0:/finalize.romfs
-
-set PREVIEW_MODE "9:/finalize/img/complete.png"
-
-echo "Success: Setup complete! :D\n \nRemember to backup the contents of\nSD:/gm9/backups to somewhere safe."
-# rm -o -s 0:/finalize
-rm -o -s 0:/gm9/flags
-
-poweroff
-
-@BACKUPSKIP
-
-cp -w 9:/finalize/GM9Megascript.gm9 0:/gm9/scripts/GM9Megascript.gm9
-rm -o -s 0:/gm9/scripts/finalize.gm9
-rm -o -s 0:/finalize.romfs
-
-set PREVIEW_MODE "9:/finalize/img/complete_backupflag.png"
-
-if find 0:/gm9/flags/INSTALLFLAG NULL
-	echo "Success: Setup complete! :D\n \nRemember to backup the contents of\nSD:/gm9/backups to somewhere safe.\n \nWARNING: NAND backup automatically skipped!\nIf you need to make another backup,\nfollow these instructions:\nhttps://tinyurl.com/gm9nandbackup\nWARNING: CIA install skipped by user request!"
-else
-	echo "Success: Setup complete! :D\n \nRemember to backup the contents of\nSD:/gm9/backups to somewhere safe.\n \nWARNING: NAND backup automatically skipped!\nIf you need to make another backup,\nfollow these instructions:\nhttps://tinyurl.com/gm9nandbackup"
-end
-
-# rm -o -s 0:/finalize
-rm -o -s 0:/gm9/flags
-poweroff
-
-@BACKUPDUPE
-
-set PREVIEW_MODE "9:/finalize//img/error17.png"
-
-ask "Information #17: Duplicate NAND backup\nIt looks like you've already made a NAND backup.\n \nIf you want to install homebrew applications,\nyou should copy your NAND backup from\nSD:/gm9/backups to a safe location on your computer,\ndelete the backup from the SD card, and\ncopy the Nintendo 3DS folder back to your SD card.\n(If you've lost the folder, you can regenerate\none by opening HOME Menu with this SD inserted.)\n \nPress (A) to make another NAND backup anyway.\nPress (B) to cancel."
-goto NOSPACE
-
-@INSTALLSKIP
-
-cp -w 9:/finalize/GM9Megascript.gm9 0:/gm9/scripts/GM9Megascript.gm9
-rm -o -s 0:/gm9/scripts/finalize.gm9
-rm -o -s 0:/finalize.romfs
-
-set PREVIEW_MODE "9:/finalize/img/complete_installflag.png"
-
-echo "Success: Setup complete! :D\n \nRemember to backup the contents of\nSD:/gm9/backups to somewhere safe.\n \nWARNING: CIA install skipped by user request!"
-# rm -o -s 0:/finalize
-rm -o -s 0:/gm9/flags
-
-poweroff
-
-

From ef4ec02c310d3dd28351d32a9a51e6914dbbc718 Mon Sep 17 00:00:00 2001
From: ManiacOfGitHub <43019219+ManiacOfGitHub@users.noreply.github.com>
Date: Thu, 31 Jul 2025 00:41:56 -0400
Subject: [PATCH 2/6] Implemented finalize helper features

---
 Makefile             |  7 +++-
 data/lang/en_US.json | 11 ++++++
 finalize.lua         | 89 +++++++++++++++++++++++++++++++++++++++++++-
 3 files changed, 103 insertions(+), 4 deletions(-)
 create mode 100644 data/lang/en_US.json

diff --git a/Makefile b/Makefile
index c8d2e9c..2bba2ad 100644
--- a/Makefile
+++ b/Makefile
@@ -10,11 +10,14 @@ builds/finalize.romfs: builds
 
 builds/x_finalize_helper.firm: builds/finalize.romfs
 	@cp finalize.lua GodMode9/data/autorun.lua
-	@sed -i s/FINALIZE_SHA256SUM/$(shell sha256sum $< | awk '{print $$1}')/g GodMode9/data/autorun.lua
-	@$(MAKE) -C GodMode9 SCRIPT_RUNNER=1
+	@cp -r data/lang GodMode9/data/
+	@sha256sum $< | awk '{print $$1}' > GodMode9/data/finalize-romfs-hash
+	@$(MAKE) -C GodMode9 SCRIPT_RUNNER=1 AUTO_UNLOCK=1
 	@cp GodMode9/output/GodMode9.firm $@
 	@printf '\001' | dd conv=notrunc bs=1 seek=16 of=$@
 clean:
 	@rm -rf builds
 	@$(MAKE) -C GodMode9 clean
 	@rm GodMode9/data/autorun.lua
+	@rm GodMode9/data/finalize-romfs-hash
+	@rm -rf GodMode9/data/lang
diff --git a/data/lang/en_US.json b/data/lang/en_US.json
new file mode 100644
index 0000000..76792a8
--- /dev/null
+++ b/data/lang/en_US.json
@@ -0,0 +1,11 @@
+{
+    "INIT_MESSAGE": "The Finalizing Setup Script is now starting...",
+    "ASK_FOR_HELP": "If this error persists, ask for help\non Discord: https://discord.gg/MWxPgEp",
+
+    "ERROR_00": "Error #00: Build error\nYou have encountered an error\nthat should only occur if the script\nwas built incorrectly.",
+    "ERROR_04": "Error #04: No space\n \nInsufficient space on SD card.\nYou need %s, but you have %s.\nMake some space, then try again.\n \nTIP: You can temporarily remove the Nintendo 3DS\nand DCIM folders from your SD card\nto make enough space.",
+    "ERROR_21": "Error #21: finalize.romfs not found\n \nfinalize.romfs could not be found on the SD card.\nCopy it to root of SD and try again.",
+    "ERROR_22": "Error #22: finalize.romfs is invalid\n \nThe file finalize.romfs is corrupt or unreadable.\nRe-download it, copy it to root of SD, and try again.\n \nExpected: %s\n \nReceived: %s",
+    "INFO_23" : "Information #23: finalize.romfs in wrong location\n \nfinalize.romfs is in the wrong location.\nThis script will attempt to move it.\nPlease hit <A> on the next few prompts.",
+    "ERROR_26": "Error #26: SD card not mounted.\n \nThis should not be possible."
+}
\ No newline at end of file
diff --git a/finalize.lua b/finalize.lua
index f84a9d8..e98b061 100644
--- a/finalize.lua
+++ b/finalize.lua
@@ -1,2 +1,87 @@
-ui.echo("This would be Finalizing Setup,\nbut for now it is just stubbed.\nPress (A) to power off.")
-sys.power_off()
\ No newline at end of file
+--[[
+Script for https://3ds.hacks.guide/finalizing-setup
+This script is not intended be run manually.
+Credits have been moved to within the script's optional menu.
+--]]
+local scriptVersion = "2.0.0"
+local lastModified = "2025-07-30"
+local json = require('json')
+local finalizeRomfs = "0:/finalize.romfs"
+
+local langCode = "en_US" -- translation support will be added later(TM)
+local langPath = CURRDIR .. "/lang/" .. langCode .. ".json"
+local lang = json.decode(fs.read_file(langPath, 0, fs.stat(langPath).size))
+
+ui.show_text(lang["INIT_MESSAGE"])
+
+if not fs.sd_is_mounted() then
+    ui.echo(string.format("%s\n \n%s", lang["ERROR_26"], lang["ASK_FOR_HELP"]))
+    sys.power_off()
+end
+
+local minBytes
+if CONSOLE_TYPE == "O3DS" then
+    minBytes = (1024 ^ 3)
+else
+    minBytes = (1024 ^ 3) * 1.4
+end
+local bytesFree = fs.stat_fs("0:/").free
+if bytesFree < minBytes then
+    ui.echo(string.format(lang["ERROR_04"], ui.format_bytes(minBytes), ui.format_bytes(bytesFree)))
+end
+
+local write = "0:/WRITE"
+pcall(fs.remove, write)
+local success = pcall(fs.make_dummy_file, write, 0x400)
+if not success then
+    ui.echo(string.format("%s\n \n%s", lang["ERROR_25"], lang["ASK_FOR_HELP"]))
+    sys.power_off()
+end
+pcall(fs.remove, write)
+
+local romfsCheckDirectoryList = {"0:/", "0:/3ds/", "0:/luma/payloads/", "0:/luma/", "0:/DCIM/"}
+local filenameMatchList = {"finalize.romfs", "finalize(*).romfs", "finalize (*).romfs"}
+for _,dir in ipairs(romfsCheckDirectoryList) do
+    for _,filename in ipairs(filenameMatchList) do
+        local success, filesFound = pcall(fs.find_all, dir, filename)
+        if success then
+            for _,path in ipairs(filesFound) do
+                pcall(fs.move, dir .. path, finalizeRomfs, {no_cancel = true, silent = true, overwrite = true})
+            end
+        end
+    end
+end
+for _,filename in ipairs(filenameMatchList) do
+    local success, filesFound = pcall(fs.find_all, "0:/Nintendo 3DS/", filename)
+    if success then
+        for _,path in ipairs(filesFound) do
+            ui.echo(lang["INFO_23"])
+            pcall(fs.move, "0:/Nintendo 3DS/" .. path, finalizeRomfs, {no_cancel = true, silent = true, overwrite = true})
+        end
+    end
+end
+
+if not fs.exists("0:/finalize.romfs") then
+    ui.echo(lang["ERROR_21"])
+    sys.power_off()
+end
+
+local success, expectedHash = pcall(fs.read_file, CURRDIR.."/finalize-romfs-hash", 0, 64)
+if not success then
+    ui.echo(string.format("%s\n \n%s\nfinalize romfs hash file does not exist", lang["ERROR_00"], lang["ASK_FOR_HELP"]))
+    sys.power_off()
+end
+
+local success, result = pcall(fs.hash_file, finalizeRomfs, 0, 0)
+if not success then
+    ui.echo(string.format(lang["ERROR_22"], expectedHash, "hash failed"))
+    sys.power_off()
+end
+local gotHash = util.bytes_to_hex(result)
+
+if gotHash ~= expectedHash then
+    ui.echo(string.format(lang["ERROR_22"], expectedHash, gotHash))
+    sys.power_off()
+end
+
+ui.echo("The script finished without errors.\n(This script is still in development)")
\ No newline at end of file

From 5fdbd8b2e6594e7681c4baa568e88ae7c9743fb7 Mon Sep 17 00:00:00 2001
From: ManiacOfGitHub <43019219+ManiacOfGitHub@users.noreply.github.com>
Date: Thu, 31 Jul 2025 09:19:47 -0400
Subject: [PATCH 3/6] fix moving finalize.romfs

---
 GodMode9     |  2 +-
 finalize.lua | 10 +++++++---
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/GodMode9 b/GodMode9
index 712df19..cf1cb1c 160000
--- a/GodMode9
+++ b/GodMode9
@@ -1 +1 @@
-Subproject commit 712df196f129e20ce6b81d7766f31d4158f7fbe0
+Subproject commit cf1cb1cfc5965cec3dd10ba98269aeb37b9b7a9d
diff --git a/finalize.lua b/finalize.lua
index e98b061..ba5632a 100644
--- a/finalize.lua
+++ b/finalize.lua
@@ -39,14 +39,17 @@ if not success then
 end
 pcall(fs.remove, write)
 
-local romfsCheckDirectoryList = {"0:/", "0:/3ds/", "0:/luma/payloads/", "0:/luma/", "0:/DCIM/"}
+local romfsCheckDirectoryList = {"0:", "0:/3ds", "0:/luma/payloads", "0:/luma", "0:/DCIM"}
 local filenameMatchList = {"finalize.romfs", "finalize(*).romfs", "finalize (*).romfs"}
 for _,dir in ipairs(romfsCheckDirectoryList) do
     for _,filename in ipairs(filenameMatchList) do
         local success, filesFound = pcall(fs.find_all, dir, filename)
         if success then
             for _,path in ipairs(filesFound) do
-                pcall(fs.move, dir .. path, finalizeRomfs, {no_cancel = true, silent = true, overwrite = true})
+                if path ~= "0:/finalize.romfs" then
+                    pcall(fs.remove, "0:/finalize.romfs")
+                    pcall(fs.move, path, finalizeRomfs, {no_cancel = true, silent = true, overwrite = true})
+                end
             end
         end
     end
@@ -84,4 +87,5 @@ if gotHash ~= expectedHash then
     sys.power_off()
 end
 
-ui.echo("The script finished without errors.\n(This script is still in development)")
\ No newline at end of file
+ui.echo("The script finished without errors.\n(This script is still in development)")
+sys.power_off()
\ No newline at end of file

From 9417928e12a7f9e11278a082893a19467c768003 Mon Sep 17 00:00:00 2001
From: ManiacOfGitHub <43019219+ManiacOfGitHub@users.noreply.github.com>
Date: Sat, 6 Sep 2025 21:16:16 -0400
Subject: [PATCH 4/6] Added language selector Credit to Google Fonts for the
 icon

---
 Makefile                 |   2 ++
 data/language_select.png | Bin 0 -> 9185 bytes
 finalize.lua             |  19 ++++++++++++++++++-
 3 files changed, 20 insertions(+), 1 deletion(-)
 create mode 100644 data/language_select.png

diff --git a/Makefile b/Makefile
index 2bba2ad..0f1174a 100644
--- a/Makefile
+++ b/Makefile
@@ -10,6 +10,7 @@ builds/finalize.romfs: builds
 
 builds/x_finalize_helper.firm: builds/finalize.romfs
 	@cp finalize.lua GodMode9/data/autorun.lua
+	@cp data/language_select.png GodMode9/data/
 	@cp -r data/lang GodMode9/data/
 	@sha256sum $< | awk '{print $$1}' > GodMode9/data/finalize-romfs-hash
 	@$(MAKE) -C GodMode9 SCRIPT_RUNNER=1 AUTO_UNLOCK=1
@@ -20,4 +21,5 @@ clean:
 	@$(MAKE) -C GodMode9 clean
 	@rm GodMode9/data/autorun.lua
 	@rm GodMode9/data/finalize-romfs-hash
+	@rm GodMode9/data/language_select.png
 	@rm -rf GodMode9/data/lang
diff --git a/data/language_select.png b/data/language_select.png
new file mode 100644
index 0000000000000000000000000000000000000000..cbc20bee4bb7fb73bac65fcc348778b4ce644c77
GIT binary patch
literal 9185
zcmds-RaYEcw5}lu1h?R>L4yRh#)AcScXtmS+#4s*Sa5e~oM6G-g1fsrochkb**E78
zoF1cXjP6=hYt8x2cRs5k6y+sRkqD7sU|>+CrNotCU|{2b&*up5fY%)T0yp3d)<s!T
z6n0^d$shQF=qRP-0t18m>Axo|3?u^|28JqBT3kf+N5)C!#~*4Ek8fcdC~=BG!MFj!
z9M}bTn4<X%5`5vXU1XHOjjFJScJY+H2h5|L!IU3FWu;(hl!6<&jn~weS{Yi@ZByUw
zmM43fU6wM^KO_v_U1iXYx4Z0SdhTtHc&~YkWe`vxPy}O${{Q@9`w1IcwM@NYER$a$
zOThDAwNZt30}>+Qpj?2Gl9JoeT!nIhjJ_5Ak8>={P4rAYx0W9l#$fg}pR3V8IOIq?
zmQ#bY#Lse~6beEwuB)XC0iGnh&Zgqx;(pkEqXYA@;!=jr<AQh3uTN+DylZ|>C$BG0
zcwe;Z-A@*``eTQCulB}&ebJeVHNL9i?!F09r)yI!QTEioZwQ8u!tlnXSKeOnSd)M*
z)S5+Ye(&q;^*QhQc$q{-vuEJYc2Jm}kFMF`dLY2^tSuTOVT*;$L^&KTGb>TCB+>I>
zvZHGM^7sBl^#xvbe4uNF1nD-4xPAML`ZWQM3XM#XqhORGriK5@&HVYfV=K+H;R7(H
zC5E~xhb0ZXJa%1Uc+pt6FIl*WL4-<Ycpa}jTK*Q(B{}V-7*Z`Ag`(wTF5KgYL+8t`
zdpVN(VN;OxY$<&a78aKINNRjm)+@C0rNW@okCjpeUZH)mh#UbK`Dn4>=yGS6{p;8D
zwHN~SLd_cEOYC?5I$v+9rVK~3h5UC%(r_459hd5Rd&M(II4t9iO1{MqZm7P!zKmiA
zr{#T%S**93-slPY#iTXW>fs<!!++NHiBiz(S}_tB9%t&T^$hgTpjBsnA6Z6-gTv{4
zd%V)>K}$p9>E*L=izV^xTP|+B)7ff!I=2I<pqDGKpv#AAwPvzB1I1n&-60>*Nqf~K
zT5P^dPEG>rv)1Bv#6B*Nn317dsoNZh!zk*r{wJUjVlFF|=_TiCA3+owr--?x84Y21
zeGTNf4B@$I^+w)#`H5|+^lnJRimoos<!Y3BxTciXWq18_9#cf4x4j^GqVsBu|K?~O
zYVL9p0|`_sRgD)@RqwdpjPklU+&CUeW=vM`Sau525uD6+x&>yea*WE0P(B8qt-JhU
zB#m9BCOpZ=_j~+cA}tl>iUR#%O+Tp^-($rypZl?<PbQb$Vp&y(HLhB_mm8F@ML)O0
z_sQ?=<&KxxcCCZt+wusP&%GmcVSfJczZ$W@X0ID-8=R9R=-Wj<Sp@;;>6ks$+=s{O
zy11fnVM?(`KgU;g*)SLnkLr~H&2Kw4<kIi=_ax%eJ(v1--4ITj?U+j-xT}Dy5&C&?
zaiM=X+<}@t)o7=~1LCxv`NJZh?03KM@wphXpzECnCimf6u96b)I3<3@zW2TNKAfS?
z_qpE)+sERxnG?5&L-IIXCJ-9457HV0!h*$AC8Hcjz?V&7@WMwpxJ-~Q;lfy!;8K&5
z3EfXt0(%l=zt@MorY0VGvth%RyUw@1wULqU9AwPtv^Pnz*hECg70$#$r02=M5p8SQ
z#9^`^^mM3mv1s4G#9AFbp7%TopojdC2w{Em9<`A6Z$km^Kb{Nqg;>v5uK2%Rk)@5I
z2Njg$n74~Q>9?>UAYsjJ^%>wsMJrscs%oJp3Ax7?W7*7TA|RrnWpO)XUDti@c-T#!
znNh84g$UfQ2VKr9rzuyv9!wGMZFm-NTO-M*vcej$=(U)VWQ(F)0uxR};*?v>9tx-M
zaiO-hwmjm}!*9M)Z%*K>{VwaPJk)N9OUSE%Lo?F%BG@@%u2L_mN<r`@DFKxNXUb{r
zdp!Jb11`QK^(LN_pM-5x)!Ti)P&pet)9Zg}ncX!tqgbc^;(Y*5UK=gtr%U{1@Cso#
z3Q%<F)y34(3=1$ZHZD}ieqDAMAIw%vL?z<-qo2Bv<$J3|ovXvJnarRz<P;r}c2_(_
z#0i%p45rFgu5~;9=QI#UaUX)`j-uWdiDMM5#N&g(uJl^!aWEy}_p+U+aDD^CgN7*}
zs$M%oI2kQFDLTRKRj<PauL)ZShV6`>m6(+V6KHahqkZ(ssv(G0)$4V1yhZYvk=L30
z9!ULH1`GA}D=qX3zbpLVWhKR4yl&14etxFYq`t+la(Hs^AoWpgyUxqrY+b{$Yr#8|
zjAZ@jvF6L|N4;Sx-FiMH%Mud$%BFpHP?Sw+w)HoLT`x{a7*KUn`Ttg6=pr5vmoq|Z
zLZ*wNX`@@D2i5DVaiK7Sh$@LF++>L^f#xB<>q$u-H$b)#(n;0b-5VA9g7@~YCMx`1
z9(^CL355IvGVppOdBGx->_HrwEFJf`l;P(X2i|w5IN$)@1&(<uSFtcOiN_j~{%s8%
z6HO53OqIr)K9X*vWaPzgZ;dQyWT+C^_*TXEt#d`Q%$xL&Lohx_vdu?Au=T1fwOZF!
zU}HDwM)+hR=SRMS9Ws~WOo0PBJPJO!inGsTvx^12{eQYq_)x5r7mC+sOHd9}6)M^`
zh6lIT=ZE{q-(r5rx5z@f_GCO#9xS}PTK_mS_j^D%pH5M5{TMKid;!g$W2BPo)kRI=
z_^xj1<>kc(;<o+A+RsMQ*Ra}Xx3qiDzkjMCHtJ=!A`3fYhuRl_-VRBq>J^KP(6Q(I
zdPh=_C3ul&xw;XXE85dL;AtJo-Wdh@+s-(of!iJ$B}V35h74I=TyN1svMc<a7Pvaw
z=INq9Ff}#h{7S4yr(T}gmS_lvC4hm0LjzaQu4JGH(r$UVU25OA9X6!60+usu1Q3K?
zjR*LI2SYYKK5bkx`Sj|`A;zlpBp(zZr%iEaJK?D?SXOF3yDPzj52o^CHzN;=p!aRL
zZgVZlbvZmT*9>rN-=gsYu6>_w5hbOLO00ldFkbV64<a}HUuNjsDgVL5HXXSN_TQd!
z&v>0p4WICwn1wBzQYvlcy@|qy_FByd)JEU?Tg>L7>2a9S^vQ&`dPmGIY;KQ}=E+(X
zaBHl4IbCi`FLSV)kDMnNJzgJ}lfh&I83Z<i89<hCn8Ee|=Gx^oy1RU)Lgy}ClGJLs
zsis=UNfiVyQDnVXPY=><a_sU_he$!$BRU=r88Z(5)lh-*Ty~#%1x(EzE_XbQt1(O|
z6i1y<2!|YJO)ob4WM=u`k)N-p74E&3?4a}u`9zk4OrwPdHpN<1ukF~He}-I1Hl23&
zPNBW+?@?n1WrpB6mxg+BQ-{;*V?On5jL&4y6J=h02*WqGSvoqUbr&hC3_`w~7UM<y
z1eI@g-q9To4GwO*U9=fswV7i|bAG;ef|6i~5EB#pdj};=>G+*N(O^BxK(mx95fumS
zRA$tHM>a=GQ^@243a+isPq~_`<j>APIgL~eLnCn}p3E(mSbSGkmo`9;*UYVn!>FDV
z<D98-38X3oNo8ePu2uCmQ$<n|Hk2>jZqgRg5em6ET$6?UU<;euw%6fg!UTRB=TX}=
zSIal%blR*{8T;k`$qmv%PdqmHdyqMP%WTVxBqYJCkE(7ZHdBPVSV_@N-PAOnSQ{{0
zP#`VsUY$cjLTEmJ9^yv<h4a$Gcf_{YJY64{;J!mnNJ~rG66pKJrU?nOTdePzH}HEX
zkWTz;&gGM0lu6L?`g}Fc+Y#DQo+0G_3Y6xz=RG07G-(tN4TvyjNL-DI^XOjQt!2D8
z&g*$d_my|xXMh%pmx;<JCKP$=wgWzrva+wQ!R~3O2Oygj+7L1oL$*?<XQ~W@(%$W1
z3&Gb4UqNiR<P3mh19VOp79Q?3O2?+*Z7tW0yXVDeXM@0cmsi1?gAM`ZuB~j>|DPTV
z9Brk9Wc)4II~`6C+1ggKO23_@^I3V7FWcu5(eG|7gV#jf{*N6{Nce61uBCZ%cKh%Q
zf`{2%c1O6^eAxRh_T|8zq;(~eIN>mPbe$Z}*F|_hm$#!%y{_h@ys^YN{mm|WZ9>ZR
z42fH*L;GItz!5K*taYmmyKYaGI$v&ed|vLiVk^#GG6cQV-EB>EfS~a{Yp1nS$--wM
zw<zn*XVz&%3BaP{<PE#+jrhb1wvsFSUD)+*s^kNL!-Yei!}!kdubu77=x7ujxw-<N
z!a|_pzb7hVpQIe!8v7Ua)NBY?;2BQUc&l8jkGNEZB@xvGbw{hyd#7GbO?upYm!q&@
zC@Com<<f62hgle>C7sG<D|F^L-$*=`VOu}1WDxhaPVa9Ik?h{4wS&nm7wZoIx3t4i
zOx!O<cNAOg*!G>)q9(|wC-lLVyp2H%G8<F-j^#b)(Aaxs{WczlRRJ?J-xB2lz)P8q
z-2$Z?{dck};#IF<NLUz)R_%vf;S|78t@X4u0>0CBp;jvR6=BF!-ZzNm)7p<MRD3ke
z0Kf(`3FS$~egpKhalsn$1(ov%XAvsCL0j1|@VY#D|JYQpYVPn^s1l7!Fn*V<Zg9~=
zo|4X}S2s2-N|Mk*?+bl>4CB6o6a`kfS{bf=S8(tL1&2Rr<iwT}zeRj}+EyBfIpCsj
zzaS06aVAmdCoVSFKy4SW7JTNy<8TExrV3=|?pAcWw1Tr&f5D(4A^j(?R}MemMnziJ
zZ{c^ASi8%$>I@0zDs+nSZMa4qPz7fhot;>4une(vEtI;nyOe{yI;f(OG5E(zPSpY*
zzqSx*yQ!g0fVpF)1Te9zQT&=gg27{zVo%g>@hXuc2O8W6R#sLH?Kde{lR<mg{-C|_
z2eSZG2N4>&e~x*&J(W(fZCZ?uPno5do|g}0)7Wh=Pfd={MDn4M`R;Tn$8dbE;mibC
z<Qswe?vM=Im2xfi4=mwY+p=8TXt6@CKfqfT#cn6$1of{#^d&QDpjCSzGn_|&{YnS}
z)wC$Pj{=(|BJmZDuuB3GUHiM2Zq-eslXmrRng0b^%n;@@gB2t%0|BR-zU4Ihi=}h*
zP}hc%ifZFvKt#B?av=m6&zV^E^!j*#{rvDtoOlXXp*p>~;dpCqan%G=x1JC4I^-;7
zhuHP#OCESGuf8}El#fAF*imSW{DOSKKNW(^8}<~#y_yR0ZF%6^MwJj3?+r%$B%clP
zJ(!|tO1ozTylrY~s&EDLXMo|5+YB*CHVWKfmR`>Z-;5pg$=t%O=fGd1zjH*xvrX}h
z+0B=T*L?g>TpY|twD?+M6u!5gPTHAkZsJzQl->={)6ZFNV<o{xbw08p(0s(hrzy#f
za~`%p3@q|!om|4qqOtu@jk3DT57{r;!z^`JN;3H!hpGecZocSu*io$C?)1noF+|_t
zx_a-7cHsGAeBrYigoi7s`c~AjJ1#sGEhiuHXXBFB{j=4~U;M9iL*{-%^k~5!nDg+8
z<%hcUTF&-otxAXF)eWj<bB{0@GPqV6K15+-UU`((T4GXA!yux%)NwrBa!218x}wn}
z_0(KtRF>cTb5;IAdt#@jWmz_mE3rxo#uP=Oxq+0m3$lW}NHxZ&g0Z#D?K@uo(g>lo
zDli~Yz-8uc%)7p&+j!av<nY@nAkY(YG(SD+r1<cGea-5@7+5?gS-H1Y<!^*}E0B+0
z88^e27cn%@=G7>{erb$m6MUjl>#W>rC)<Ld1ZNjkq_HFFeL8M66qUp`+QkKOx<+Ee
z5XMbQ5(;Wz1VkJi1E<3cg6wd7H)J=5rm@)0g(W0A5FKG<#|V#Gg#-O3%gT{);UiJ|
z-aBVRL~)s9mAvXsvqw$oZ$@*tv`(o+I%fi{x#g5X4q>QTmS`^(o0fX?-28JGqDT~K
z#<P;aCRx=QfwcpVbq0ItG-gE+v)WGy25^r$eUp6k@fcVLy|di7&Na8^9eKye)u&pt
z7rt*p6*3C#$Exco)3@%uN?e)Wj*y<U&w?=o3295I6f@!fF^YI*@22_hsu$dh^WvmF
zLfV^ECk(8VOxB3hfcbrY^3>w_w+P*b%q(ZJ=xsx1h<}KDX6)*(SN@~0e}RN06$Ld0
zfC?7d-R2%R5Ruf$zEb`krWr=(!)bc@!u=%c4g1LWMU)7UBH)kjTao)&;o+^wDgv4k
z>RifnvzjzPpMv*Nzj`?mFec`r6awOhQ)%T^XhpK<h7kq4>t*%Wwt4|hSO(Ivn@AG9
zgIJpcZNvWzYB{ZUvf9`<=uFZh<I4$Us2Fl4?cuX<(8s^l(9Um0BB#jzz4gcty@E;B
z`*SExh56wLSsspZTYSAF_NbUxqmPnWxL8Rt<9@KjTZna4ACXAk6-(&c$X-oZxAA6t
z;gbSnof<rs6VqFxbaj$dqOy0WR;t%}o9VGiFSO=7{Dp@I%Xp7_3$mp*xV~<f!O307
zjQxd@G#spS7n|DDy(&IBE1A)o{l*1lDCj&>UC$NdGR@(=hDPSOO>!^7C!QY6RV*ou
z=NA>F^X`qNha~}yX!9zXfc?B#m7ZUznWVeBJ0T$f>yrzo##n1Ye0)3)zsv6T%#nOU
z6#->m9P<-4rP}fsEZkFdvFh~59T^%kkM5Eq+W}D*vt2>$FfJ^L7Wb1#FrVM^k8IME
zSwmDp4ojeU0`ScMZN*}vT~rI7+tgC_;QQ5NRTOnUX!tg*qjXX#^OK8Gdt(e%5=pv~
zYFnSbZ+BE#0gaG75bI+8Wjxvz!$v5&`C)EA4SO1~;?#VQ0}A&U9efnF^XDpMyWXJK
zNNtaOQhFlQi?JZva7M|pN^2_<yakM~-N+_?A}}1~D*@9yW;Ufnq$=P(O!~oq$F}=d
zO`*KGxoJJ;x@g_%yfbtH@Se3!p<1;v^-&cGHa0e~P!tip|5~Fj+$*N#R{`A@yaTm;
z8N|Vt%HUjT4smn*uGMz$dB7V{Qod6o$8t^A!XhC-osNi_&Jp`qK)D?o8yg0SA>uv-
zeg=#S;dVevc4QC`Xajn;;+@7Ndll7E9Vm08Xn><Fg=V?tX*ZfP&b-7K_)UTMQS(kw
zJt)5C+vDcYMvLiwoxu`@hI$syOW7pf<{zP;g6R9-SO0MgdcZO2LGAV2-EW(mwz%w<
zo1AxKRGxFfNJYKO&36IjaeKDrzdZoBc~9zr71CeRg>rS^JhcjKoCsuGCdFs|1IkeV
zQY3b((?sF1bQt#``K;7gj6dESDLnxtw;X=h4aMeqe^N_J3jj{K?OvR(n@q~0VsDz?
zP%9U}B>dZ)Y-v1Bl;x`cxfw~KS9#T3!lhvWEEWAFlBucb`qk-5t3$`a7&1{W73Wb2
z7o{Os3@>I5^W$oN^-xMXpW{KFAwY{nZ!N5T8X5!sBNThu5U{_Sj9wksB8}VIrYs`a
zHd3jwK{w|;=sKLit=A*$<3HFmr@(-TSJS3@&g8JdQU=-?lhJGl1gQuSWC*}FpnXFl
z0|5vOR(A@EMyB`gU;BU6u%4x=Y$=r)0-j$%Ye3^>Wc0T&6(hh+3<-PsMFZ1e{jFth
z<;X$za!b=)*yHMu2<A)y5x^Vz>_xOeA!9!K6BMp`1Q^oVQ2Q7Z$JT9)e=PUdJH!0#
z8P%Rwy8sbrnPqT5#f`>pBb_mu#V{)QRTNy!-|Bu+s~%=<4*;!$IYz@-$L?T6DFTpB
zQ(9m#2K^|6vuCd>=wte73N-^mWRRuj&_vSzJqIa>V|$e?tf-eJV4MiI(T>QIXoKMJ
z#Q0d|j3?XW&}Fq#8f@knPSfi})M>}4fq}Itwm6R#5@=+-E~^>TO1B|oKzhR;0Bj2b
z95->DMeV#S2ceCqk2qN@Iorq`bUU0mm@UH_1Bmi`;%o0`oU({tRl5F93DA$)s*_u+
zC#X`V{ngqH);o>CB>e7DK{$ALdwmf>?JgCJ4yft?u(*JQ@AGPuil+qP!yZ)~z{}^J
z0CtoKczL`Ld(`t-2^n`rK;cWZDCnx?Dgx3;%4)5n-Ldy4hC$npi!4EJ)1D2(DZ?Fl
zzzm(iFp&6N(VGkfj^&KV2_0$HiKxtZl?zp-)Exy@GS#b@PEyKSR>ye<!5JJBZ$)G!
zkU8a|Aexw%#BTt2%7gzqE+*!N_OG%oh>$->c^f9~Lj%ymlx!3$$(QZQ1nqE9m+Q4Q
zVl7MOOD9afxS^z6SLb(m9oO`qd-jB)($mvR1^o8;E*+Fy<mxSTa$Z*Fc9(ADS;cU)
zW*Qh~QM%)*@f7O)dk>OV%A_sMw7qHw_&WJTDx2N?eM@#~6m)bb*dk4}Qg^{lfNq(9
zNsB-7t4gU_S)o<6A~HzeB6zyvgEPWlMHr17#rJ&W^$cE@k+_MJu7qC*%*i(;mfyce
zFKJ6L|G8PYC{zg(x{0buNCGEfsn7hN>St)Z!CAT*4iZz%bJ?WD)LMj+a~vnyju=)C
z+4~3eoFI9AtuO*Q@cYFUH=74e4h~nKrIq}mfVdML+rW;;qVIEex^muq-qlbESo7_(
z#fGx9uVzEo`Q)1HDu2NwWmeVao`444+h*c(0s^i8FZ)ao@VCD|{b5HKKN|dOJ#3hh
zkq5Q_tKYz*lSYfHZcF=b;=TV{;{ERQ4O*<ICVM-$m-!*qkDjohM#DRXZ*yHzKE#r_
zLaiZX;CV(Gqe56GoZWfi1wdW;n*l&f4QA-0;AUiAU%Og?{zD)7Uuc;tG;2i7=?ppq
zz8)_&Ag3U}66ThE(P<<XQ%-nN8#KlE1%W(Hh@nff9G?R8{O|`9lk&XN5JQQu17KwT
zFhBhKh(^4>1ZA<7{25xcu&|JYg1by+IyNxyV?E#_AckCqe_(t@M@BeK;=cr`m21|#
zJl*y1ZLve<ev1TcZ*TX6q2~!}^e1kEzwWGzIHWd63~PA(2xYMJXsrf(>z__}L>d`F
zB0L7Qp7Z1?)2drQA*Kmoync-wyzJ}&Yu!CABP+WEbyx#Bnlg<lFbW16dlIuAq4~Q^
zb=+29k7jpNu<|@;f}VzEXCR(xHx(0~%QiJhg0J)^X0XIGhbD~u7y$B35n0vfaJdGC
zdzE^lt7V)+i=tO1=&s6F*qAg0Ep7B?<<hxC$m+WjW2K+rYH*B&X&U*Qw61-6p|*9m
zrR#->lpG__-&!}d@5jdP{id~_TxWdT(!UmWO_uq*7hK4A#~e>JRIMl@uSwaf4s2u4
z<+7D3)|yJ++s`?X;nV-1Yxa~Npy}=F8=Uub6>eQO*^Q7BNt|@tCnF*%oA%jcG2$*c
z6W#jp%8#iw8D`jQ=_Vv1wc=c6-|iTW=3n?X2=vR@A@%p)YM$3uQG00C=d6IUpR5y$
zh#TsE3~x?Xp7^XK><z8C*|@~i%3(wSOyrBu((yyUvi7w1-F(505(H1twv733D#(Il
zscFuBQ!Z{B?ICNlI|La}Q%GDKtKai|d3iY?xy}u^&M!^=<<<y}Ow!!&(QPoYIht{!
zMdAxc9c7HT6j@R#+30gthipRS$wq2Ij(OA^v=7pnn*V@W^_87{2S)DOx4)@uCIWI=
z<l7JoEC#NQ{Ka=4463#CZ-eLv?T@F*!<Wm(DBQ)S-2s*+AGoA{*Mvk~uJ+O@KIgxz
z$@rlT@~L0y6af)20(iv4?1=W{8!C1runjNIntxegDV@8fyYZi%rS)Z{1SyeT<p6z<
zfcYug_sm{$bjxAdpy1`E8Jo&Vb*9+sJHbkN?VQq@vyud%jvA=8ePu3acj+nX>7sTW
zgUu8|<hu<c1pP~~{jJC-u!bS4EP%&J3ngpQkMQx2w6%F}#0DuT4ppEES7ARaw;TnX
z6o))V<G7Pe#czsh>R^mXtDgXefm%wpuyItP5G7YJ=|78%9$Oi!mNDCZ&#CPdH6_@J
z5uHz#lCyzBMWon9C#+XDz^VUhT$lYdIw@J2an{!AEd21ox+ZS%F%rUVwl#|)()D-x
z&y0p3v+w%~!uqkhT|E42Zrl+KU5_vIl_?td8;zl`9|cM>_f~XJiNl20Q!I*?j$^en
z5O9*ybS?b2KiBH)xrByBG?$dp4Bhws5R~ExEz@4Lu_eFlz9VG}0qGZlK2SaqA@4HI
z;d$s9=+H+y>huWb>()Pp))7+cV@BOY?vkL?&6=e0eIzl!#FvQ*?L2uZF*)IRjAi?-
zwzPU^e^dF9<AN6*v_7$>$!dTo5Y%Uf`aUU6anhmwi6DKb35$|{UJEmvtQC!G=zv3b
zWp%fFD`tmwD%y;+4KM4pBc}(IcTL9MH`Ryc93{o0slteYwj+LHovw<{h7^JHlQ(`&
zHd$>k=1uM`5snT#BQvx8@Au6tSx2eJfe_p;+Seyb+!PdDoPREA6|!dy2WP7QAY^P}
z!tZg)B+IC$?dxOfkqF8j@?N-OWo_iV-pa)s560o#Y!$;>Y4bk5I#)0qZ~YcyG;hqZ
z`7WxXE1@it*sWZY_HIn4)34o1a)M$f;RgW$fz4d`;Ls4C&poSc4E?EZHfX-j;%^L*
z1&Q2JorQv`YSPGY|7YLTWW0`BL8jv+!bgwEaF$4HHuDr(IRKqJY%w2@(UCPI(T~F|
za&qH}&kH)P3tL+=EMsh(v*a5(JJ*iDtcg@UQv26WO8jEhi^RU?6g9~PX#|C!E&LXF
zpQK)AF841aFU5}h*nVnH#WVYf6!+E+^`*(O7wx|Dme8K5>NxCZd!<Y?jV_Im<Sk<N
zZ{XKpr8&;Cg}S2V^=05>HxQDTJa5!)f&IlCJU3vc#`1W2j}S{+!}OPITMuKr!O8zV
zGMooj8}6TS)e4%>?>LO;L}!l=P%Hd=^48l_eBN=on8G1~(HJ<)i$Me1U>ra$xboN|
zmJ7S4A2<1)uA2$Vk#H(22LnK{Nqtdxt+<tS(%Bw6ZnuIc`F5zBEQEt_Ky(iW`AQP#
zIN0&p3C!@j5B?kPt_Tt38>5U}#zj$%LuFX5!?;3!VJio^h`|*~YG4hdWn>cAqLw3&
zoeFeBGJPL`y^G5vR(^h>hT(BP+o?SX&rDx*<fq2aS3Qmdyg%0fztL|f(Nb8RRIWdw
zY7wCG60m*lv&bhWv4{`*CiA{^ns9S#Ya=O!nAf=<Ok$o9Vu+NjqO80exev^Zi*`>u
zmE`xJox9Jz_Q~@Lch%JnHmT`R-=ttgrwu9SqQKxrkb2Ka2e3mopkA(tX~E9U4&Ybm
zGATz#)<<?xR^Sw`QB%m$uRS&NE!KKO+beSX@nYfv!wb6-gr3gj$|Gu#2lqB(L63AG
zs%N%wE}J<NdIYiHzaZa7_~BT&M<0eWm;e1gU{!aUZYFZXFt>nBaCi@)4*BfY{uaS|
zR0Rcv@qqy;85wH;3>q67YikomCX=l0{lAX%`Zo}$PpsU#iR~Uh8!|_SSfd~#6WRP}
zZL=?Gr;Rq^&iBza#^|9&I$L4K_taan7|MBlmW!#}6i^n(Y@~<Rmpm~s0qnZYb6btn
xc>?JNT;>7YneYFc?)q5h|L1p&grmL+5i!q1Rdmhk0JrJDNK43zSBe@2{vT#foe}^5

literal 0
HcmV?d00001

diff --git a/finalize.lua b/finalize.lua
index ba5632a..da1de34 100644
--- a/finalize.lua
+++ b/finalize.lua
@@ -8,7 +8,24 @@ local lastModified = "2025-07-30"
 local json = require('json')
 local finalizeRomfs = "0:/finalize.romfs"
 
-local langCode = "en_US" -- translation support will be added later(TM)
+local langCodes = {
+    English="en_US"
+}
+
+ui.show_png("V:/language_select.png")
+
+local languageNames = {}
+for i, v in pairs(langCodes) do   
+    table.insert(languageNames, i)
+end
+
+local userSelection = ui.ask_selection("", languageNames)
+if not userSelection then
+    sys.power_off()
+end
+local languageSel = languageNames[userSelection]
+local langCode = langCodes[languageSel]
+
 local langPath = CURRDIR .. "/lang/" .. langCode .. ".json"
 local lang = json.decode(fs.read_file(langPath, 0, fs.stat(langPath).size))
 

From 8c803e6695b09d9573e715805138db51cbfccc3b Mon Sep 17 00:00:00 2001
From: ManiacOfGitHub <43019219+ManiacOfGitHub@users.noreply.github.com>
Date: Thu, 11 Sep 2025 22:21:42 -0400
Subject: [PATCH 5/6] new util module, dual locale system, essential check

---
 Makefile                          |  2 +
 data/luapackages/finalizeUtil.lua | 11 +++++
 finalize.lua                      | 78 +++++++++++++++++++++++++------
 romfs/finalize/lang/en_US.json    | 13 ++++++
 4 files changed, 90 insertions(+), 14 deletions(-)
 create mode 100644 data/luapackages/finalizeUtil.lua
 create mode 100644 romfs/finalize/lang/en_US.json

diff --git a/Makefile b/Makefile
index 0f1174a..76b11f2 100644
--- a/Makefile
+++ b/Makefile
@@ -12,6 +12,7 @@ builds/x_finalize_helper.firm: builds/finalize.romfs
 	@cp finalize.lua GodMode9/data/autorun.lua
 	@cp data/language_select.png GodMode9/data/
 	@cp -r data/lang GodMode9/data/
+	@cp -r data/luapackages GodMode9/data/
 	@sha256sum $< | awk '{print $$1}' > GodMode9/data/finalize-romfs-hash
 	@$(MAKE) -C GodMode9 SCRIPT_RUNNER=1 AUTO_UNLOCK=1
 	@cp GodMode9/output/GodMode9.firm $@
@@ -23,3 +24,4 @@ clean:
 	@rm GodMode9/data/finalize-romfs-hash
 	@rm GodMode9/data/language_select.png
 	@rm -rf GodMode9/data/lang
+	@rm -rf GodMode9/data/luapackages/finalizeUtil.lua
diff --git a/data/luapackages/finalizeUtil.lua b/data/luapackages/finalizeUtil.lua
new file mode 100644
index 0000000..bc52f41
--- /dev/null
+++ b/data/luapackages/finalizeUtil.lua
@@ -0,0 +1,11 @@
+local finalizeUtil = {}
+
+function finalizeUtil.error(text, image, powerOff)
+    ui.show_png("9:/finalize/img/" .. image .. ".png")
+    ui.echo(text)
+    if powerOff then
+        sys.power_off()
+    end
+end
+
+return finalizeUtil
\ No newline at end of file
diff --git a/finalize.lua b/finalize.lua
index da1de34..01ddbc9 100644
--- a/finalize.lua
+++ b/finalize.lua
@@ -6,13 +6,14 @@ Credits have been moved to within the script's optional menu.
 local scriptVersion = "2.0.0"
 local lastModified = "2025-07-30"
 local json = require('json')
+local finalizeUtil = require('finalizeUtil')
 local finalizeRomfs = "0:/finalize.romfs"
 
 local langCodes = {
     English="en_US"
 }
 
-ui.show_png("V:/language_select.png")
+ui.show_png(CURRDIR .. "/language_select.png")
 
 local languageNames = {}
 for i, v in pairs(langCodes) do   
@@ -26,8 +27,9 @@ end
 local languageSel = languageNames[userSelection]
 local langCode = langCodes[languageSel]
 
-local langPath = CURRDIR .. "/lang/" .. langCode .. ".json"
-local lang = json.decode(fs.read_file(langPath, 0, fs.stat(langPath).size))
+-- Load temporary locale file, complete one is stored in finalize.romfs because all of the locales don't fit in VRAM
+local tempLangPath = CURRDIR .. "/lang/" .. langCode .. ".json"
+local lang = json.decode(fs.read_file(tempLangPath, 0, fs.stat(tempLangPath).size))
 
 ui.show_text(lang["INIT_MESSAGE"])
 
@@ -36,17 +38,6 @@ if not fs.sd_is_mounted() then
     sys.power_off()
 end
 
-local minBytes
-if CONSOLE_TYPE == "O3DS" then
-    minBytes = (1024 ^ 3)
-else
-    minBytes = (1024 ^ 3) * 1.4
-end
-local bytesFree = fs.stat_fs("0:/").free
-if bytesFree < minBytes then
-    ui.echo(string.format(lang["ERROR_04"], ui.format_bytes(minBytes), ui.format_bytes(bytesFree)))
-end
-
 local write = "0:/WRITE"
 pcall(fs.remove, write)
 local success = pcall(fs.make_dummy_file, write, 0x400)
@@ -104,5 +95,64 @@ if gotHash ~= expectedHash then
     sys.power_off()
 end
 
+local success, result = pcall(fs.img_mount, finalizeRomfs)
+if not success then
+    ui.echo(string.format(lang["ERROR_22"], expectedHash, gotHash) .. "\nImage mount failed... somehow?")
+    sys.power_off()
+end
+
+local success, result = pcall(fs.copy, "G:/finalize", "9:/finalize", {overwrite=true, recursive=true, silent=true})
+if not success then
+    ui.echo(string.format(lang["ERROR_22"], expectedHash, gotHash) .. "\nCopying to RAM failed... somehow?")
+    sys.power_off()
+end
+
+-- We're done with finalize.romfs now
+fs.img_umount()
+
+
+-- New locale files can now be mounted, some finalizeUtil functions become usable too.
+local newLangPath = "9:/finalize/lang/" .. langCode .. ".json"
+lang = json.decode(fs.read_file(newLangPath, 0, fs.stat(newLangPath).size))
+
+-- Check for missing essentials
+-- BuildEssentialBackup() will return 1 (failure) if any of these files are missing. As well as nand_hdr.bin, but like lol
+local missingEssential = ""
+
+if not (fs.find("1:/rw/sys/SecureInfo_A") or fs.find("1:/rw/sys/SecureInfo_B")) then
+    missingEssential = missingEssential .. "SecureInfo\n"
+end
+
+if not (fs.find("1:/rw/sys/LocalFriendCodeSeed_B") or fs.find("1:/rw/sys/LocalFriendCodeSeed_A")) then
+    missingEssential = missingEssential .. "LocalFriendCodeSeed\n"
+end
+
+if not fs.find("1:/private/movable.sed") then
+    missingEssential = missingEssential .. "movable.sed\n"
+end
+
+-- Check for essential.exefs, create if doesn't exist
+
+local success = sys.check_embedded_backup()
+if (not success) or (not fs.find("S:/essential.exefs")) then
+    if missingEssential ~= "" then
+        finalizeUtil.error(string.format(lang["ERROR_30"], missingEssential) .. "\n \n" .. lang["ASK_FOR_HELP"], "error30", true)
+    else
+        finalizeUtil.error(lang["ERROR_02"], "error02", true)
+    end
+end
+
+local minBytes
+if CONSOLE_TYPE == "O3DS" then
+    minBytes = (1024 ^ 3)
+else
+    minBytes = (1024 ^ 3) * 1.4
+end
+local bytesFree = fs.stat_fs("0:/").free
+if bytesFree < minBytes then
+    finalizeUtil.error(string.format(lang["ERROR_04"], ui.format_bytes(minBytes), ui.format_bytes(bytesFree)), "error04", true)
+end
+
+
 ui.echo("The script finished without errors.\n(This script is still in development)")
 sys.power_off()
\ No newline at end of file
diff --git a/romfs/finalize/lang/en_US.json b/romfs/finalize/lang/en_US.json
new file mode 100644
index 0000000..4507c39
--- /dev/null
+++ b/romfs/finalize/lang/en_US.json
@@ -0,0 +1,13 @@
+{
+    "INIT_MESSAGE": "The Finalizing Setup Script is now starting...",
+    "ASK_FOR_HELP": "Ask for help on Discord:\nhttps://discord.gg/MWxPgEp",
+
+    "ERROR_00": "Error #00: Build error\nYou have encountered an error\nthat should only occur if the script\nwas built incorrectly.",
+    "ERROR_02": "Error #02: Missing essential.exefs\n \nessential.exefs does not exist.\nTry again,\nmaking sure to say Yes to the\n'Create essential files' popup.",
+    "ERROR_04": "Error #04: No space\n \nInsufficient space on SD card.\nYou need %s, but you have %s.\nMake some space, then try again.\n \nTIP: You can temporarily remove the Nintendo 3DS\nand DCIM folders from your SD card\nto make enough space.",
+    "ERROR_21": "Error #21: finalize.romfs not found\n \nfinalize.romfs could not be found on the SD card.\nCopy it to root of SD and try again.",
+    "ERROR_22": "Error #22: finalize.romfs is invalid\n \nThe file finalize.romfs is corrupt or unreadable.\nRe-download it, copy it to root of SD, and try again.\n \nExpected: %s\n \nReceived: %s",
+    "INFO_23" : "Information #23: finalize.romfs in wrong location\n \nfinalize.romfs is in the wrong location.\nThis script will attempt to move it.\nPlease hit <A> on the next few prompts.",
+    "ERROR_26": "Error #26: SD card not mounted.\n \nThis should not be possible.",
+    "ERROR_30": "Fatal Error #30: Missing console-unique files\n \nThe following files are missing from the NAND:\n%s"
+}
\ No newline at end of file

From 25d245f9365a0fa2539f138dfd36b39cfd6c6911 Mon Sep 17 00:00:00 2001
From: ManiacOfGitHub <43019219+ManiacOfGitHub@users.noreply.github.com>
Date: Thu, 23 Oct 2025 20:11:25 -0400
Subject: [PATCH 6/6] Update GodMode9

---
 GodMode9 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/GodMode9 b/GodMode9
index cf1cb1c..2c11812 160000
--- a/GodMode9
+++ b/GodMode9
@@ -1 +1 @@
-Subproject commit cf1cb1cfc5965cec3dd10ba98269aeb37b9b7a9d
+Subproject commit 2c11812cf9e72428d7e5a08f93921481b568fe45