renamed →Using 3GX plugins 2: to avoid duplicate header names, left an anchor + switched button inputs to use {{Key press}} + add usage note about plugin menu button shortut
Line 1:
Line 1:
{{System version outdated article|console=ctr|sysversion=11.16.0-49}}
{{shortcut|3DS:3GX|3GX}}
{{Page WIP|notes=
*Usage notes (if any) are missing.
}}
The 3GX file format is an evolution of the old PLG file format that is used in newer game plugins. You can use them via Luma3DS's built-in plugin loader.
Due to seedminer being the current exploit method, it is easier to perform a System Transfer before setting up custom firmware on the target console. Dumping the source console's <code>movable.sed</code> before performing the transfer means that seedminer can be bypassed entirely on the target console after.
== Installation ==
If the target console does already has CFW, follow [[../Target has CFW|this guide]] instead.
<tabber>
|-|Universal Updater=
==== What you need ====
== What You Need ==
* [[3DS:Universal-Updater|Universal-Updater]]
* The latest release of [https://github.com/d0k3/GodMode9/releases/latest GodMode9] (the GodMode9 <code>.zip</code> file)
== Instructions ==
==== Installation ====
=== Section I - Prep Work ===
# Search for <code>Luma3DS</code> in Universal Updater, and download the <code>boot.firm</code> file
# Reboot your system
# In the Luma configuration screen, select any options you need, then press START
#* Hint: If you don't know what the options are, you don't need any
* For '''the source console only''', perform the following steps:
|-|Manually=
*# Power off your device
*# Insert your SD card into your computer
*# Copy <code>GodMode9.firm</code> from the GodMode9 <code>.zip</code> to the <code>/luma/payloads/</code> folder on your SD card
*# Copy the <code>gm9</code> folder from the GodMode9 <code>.zip</code> to the root of your SD card
*# Reinsert your SD card into your device
=== Section II - NAND Backup and movable.sed ===
==== What you need ====
# Press and hold {{B|Start}}, and while holding {{B|Start}}, power on your device. This will launch GodMode9
* The latest release of [https://github.com/LumaTeam/Luma3DS/releases/latest Luma3DS]
# Press {{B|Home}} to bring up the action menu
# Select "Scripts..."
# Select "GM9Megascript"
# Select "Dump Options"
# Select "System File Dump Options"
# Select "Dump movable.sed"
# Press {{B|A}} to confirm
# Press {{B|A}} to continue
# Press {{B|B}} twice to return to the main menu
# Select "Backup Options"
# Select "SysNAND Backup"
# Press {{B|A}} to confirm
#* This process will take some time
#* If you get an error, make sure that you have at least 1.3GB of free space on your SD card
# Press {{B|A}} to continue
# Press {{B|B}} to return to the main menu
# Select "Exit"
# Press {{B|A}} to relock write permissions if prompted
# Press and hold {{B|R}}, then press {{B|Start}} to power off your device
# Insert your SD card into your computer
# Copy <code><date>_<serialnumber>_sysnand_00.bin</code>, <code><date>_<serialnumber>_sysnand_00.bin.sha</code>, and <code><serialnumber>_movable_00.sed></code> from <code>/gm9/out</code> to a safe place on your computer, then delete the <code>.bin</code> and <code>.bin.sha</code> files from the SD card
# Reinsert your SD card into your device
{{info|text=The above files should be kept safe, preferably in multiple locations. Use the <code>movable.sed</code> for tools like PicHaxx Injector or unSAFE_MODE Exploit Injector.}}
==== Installation ====
=== Section III - System Transfer ===
# Copy the <code>boot.firm</code> to the root of the SD card, replacing the <code>boot.firm</code> already there
# Insert the SD card into your system and power it on
# Perform the system transfer as usual. If at all possible, choose a "PC-Based Transfer".
# On the Luma Configuration screen, enable any options that you need, then press Start
#* If you cannot follow a PC-Based Transfer and must instead use a Wireless Transfer, be aware that with this method, homebrew software, cartridge dumps, and any other data only obtainable with CFW will not be transferred over.<br>If you choose a Wireless Transfer anyway, you will need to take extra steps to move over the lost data. '''Select "Do not delete" during the transfer to preserve all data on the source system, or else you will have to reobtain all lost data again by hand.'''
#* Hint: If you don't know what the options are, you don't need them
</tabber>
=== Next Steps - Branching of the Way ===
Were you able to perform a '''PC-Based Transfer''' in Section III?
----
<tabber>
|-|Yes=
{{info|text='''The source console is finished.''' The following pages should only be performed on '''the target console'''.}}
{{success|image=none|text='''Continue to [[3dsguide:bannerbomb3|BannerBomb3]]'''}}
== Using 3GX plugins ==
After CFW is installed, place [[3DS:faketik|'''faketik''']] on the console's SD card. After this, once you finish Section IV of [[3dsguide:finalizing-setup|Finalizing Setup]], run '''faketik''' before opening FBI. This will restore all homebrew applications that disappeared after the transfer.
=== Plugin location ===
The 3GX plugin loader will look for plugins in the <code>luma</code> -> <code>plugins</code> directory. Each plugin must be inside a folder named with the game's Title ID. Inside the folder, place your <code>.3gx</code> file.
* You can get the game's title ID from [http://3dsdb.com/ here] (cartridges), [https://hax0kartik.github.io/3dsdb/ here] (digital games), or from the <code>FBI -> Titles</code> menu. For example, Taiko no Tatsujin: Dokodon! Mystery Adventure's title ID is <code>0004000000190E00</code>, so if you wanted to use a plugin for that game, you'd create a folder named <code>0004000000190E00</code>
* The creator of the plugin may have already created a folder with the correct name for you, in which case you can just copy the title ID folder from the plugin's zip/rar/7z archive to the <code>plugins</code> folder
* If you want the plugin to run for ''all'' games (for example, for the CTRPluginFramework blank plugin), rename the plugin to <code>default.3gx</code> and just leave it in the <code>plugins</code> folder
|-|No=
An example directory for a plugin affecting one game would be <code>luma</code> -> <code>plugins</code> -> <code>0004000000190E00</code> -> <code>plugin.3gx</code>.
{{Section WIP|notes=Provide more detailed instructions on how to use ninfs.}}
{{success|image=none|text='''Continue to [[3dsguide:bannerbomb3|BannerBomb3]], but return here immediately after CFW is installed'''}}
An example directory for a plugin affecting all games would be <code>luma</code> -> <code>plugins</code> -> <code>default.3gx</code>.
If you were not able to perform a PC-Based Transfer, you will want to manually restore all the homebrew data <u>after CFW is installed but before following Finalizing Setup</u>.<br>
# Copy all folders other than <code>Nintendo 3DS</code> and <code>DCIM</code> from the '''source console's''' SD card onto the '''target console's''' SD card.
# Insert the '''source console's''' SD card into your PC, mount its <code>Nintendo 3DS</code> folder using [[ninfs]], and copy out all games/savedata that was not transferred onto the '''target console'''.
# Unmount the '''source console''', mount the '''target console''' in ninfs, and copy all obtained games/savedata into the '''target console's''' <code>Nintendo 3DS</code> folder.
# [[3DS:Rebuild Title Database|Rebuild title.db]] on the '''target console''' to force all the new games/savedata to appear.
</tabber>
# Open the Rosalina menu ({{B|Left Shoulder|D-Pad Down|SELECT}} by default)
# Scroll down to the plugin loader option, then press {{B|A}} to enable it
# Exit the Rosalina menu by pressing {{B|B}} a couple of times
# Open your game of choice
#* The screen should flash another color to indicate that the plugin has successfully loaded
# Look at the information on the plugin's webpage/README for usage instructions - usage will differ for each plugin
[[Category:Nintendo 3DS guides]]
=== Usage notes ===
* Most plugins have a menu that can be launched by pressing {{B|SELECT}} while the plugin is loaded
The 3GX file format is an evolution of the old PLG file format that is used in newer game plugins. You can use them via Luma3DS's built-in plugin loader.
Copy the boot.firm to the root of the SD card, replacing the boot.firm already there
Insert the SD card into your system and power it on
On the Luma Configuration screen, enable any options that you need, then press Start
Hint: If you don't know what the options are, you don't need them
Using 3GX plugins
Plugin location
The 3GX plugin loader will look for plugins in the luma -> plugins directory. Each plugin must be inside a folder named with the game's Title ID. Inside the folder, place your .3gx file.
You can get the game's title ID from here (cartridges), here (digital games), or from the FBI -> Titles menu. For example, Taiko no Tatsujin: Dokodon! Mystery Adventure's title ID is 0004000000190E00, so if you wanted to use a plugin for that game, you'd create a folder named 0004000000190E00
The creator of the plugin may have already created a folder with the correct name for you, in which case you can just copy the title ID folder from the plugin's zip/rar/7z archive to the plugins folder
If you want the plugin to run for all games (for example, for the CTRPluginFramework blank plugin), rename the plugin to default.3gx and just leave it in the plugins folder
An example directory for a plugin affecting one game would be luma -> plugins -> 0004000000190E00 -> plugin.3gx.
An example directory for a plugin affecting all games would be luma -> plugins -> default.3gx.
Launching 3GX plugins
Open the Rosalina menu (Left Shoulder+D-Pad Down+SELECT by default)
Scroll down to the plugin loader option, then press A to enable it
Exit the Rosalina menu by pressing B a couple of times
Open your game of choice
The screen should flash another color to indicate that the plugin has successfully loaded
Look at the information on the plugin's webpage/README for usage instructions - usage will differ for each plugin
Usage notes
Most plugins have a menu that can be launched by pressing SELECT while the plugin is loaded
