# Launch <tvar=UU>'''Universal-Updater'''</tvar> from the HOME Menu, or from the Homebrew Launcher
# Launch <tvar="UU">'''Universal-Updater'''</tvar> from the HOME Menu, or from the Homebrew Launcher
# Select the magnifying glass on the bottom screen, then search for '''Luma3DS'''
# Select the magnifying glass on the bottom screen, then search for '''Luma3DS'''
# Press <tvar=A>{{B|A}}</tvar> while hovering over '''Luma3DS''' from the list of homebrew
# Press <tvar="A">{{B|A}}</tvar> while hovering over '''Luma3DS''' from the list of homebrew
# Choose <code>boot.firm</code> and wait for the install to finish
# Choose <code>boot.firm</code> and wait for the install to finish
# Reboot your console
# Reboot your console
Line 26:
Line 26:
==== <translate>What you need</translate> ====
==== <translate>What you need</translate> ====
* <translate>The latest release of <tvar=luma3dslink>[https://github.com/LumaTeam/Luma3DS/releases/latest Luma3DS]</tvar> (the Luma3DS <code>.zip</code> file)</translate>
* <translate>The latest release of <tvar="luma3dslink">[https://github.com/LumaTeam/Luma3DS/releases/latest Luma3DS]</tvar> (the Luma3DS <code>.zip</code> file)</translate>
==== <translate>Installation</translate> ====
==== <translate>Installation</translate> ====
Line 44:
Line 44:
<translate>
<translate>
The 3GX plugin loader will look for plugins in the <tvar=luma_pl_path><code>luma</code> -> <code>plugins</code></tvar> directory. Each plugin must be inside a folder named with the game's Title ID. Inside the folder, place your <code>.3gx</code> file.
The 3GX plugin loader will look for plugins in the <tvar="luma_pl_path"><code>luma</code> -> <code>plugins</code></tvar> 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 [<tvar=3dsdb_cart>http://3dsdb.com/</tvar> here] (cartridges), [<tvar=3dsdb>https://hax0kartik.github.io/3dsdb/</tvar> here] (digital games), or from the <tvar=fbi_tl_path><code>FBI -> Titles</code></tvar> menu. For example, <tvar=taikoname>Taiko no Tatsujin: Dokodon! Mystery Adventure</tvar>'s title ID is <tvar=taiko_id><code>0004000000190E00</code></tvar>, so if you wanted to use a plugin for that game, you'd create a folder named <tvar=taiko_id><code>0004000000190E00</code></tvar>
* You can get the game's title ID from [<tvar="3dsdb_cart">http://3dsdb.com/</tvar> here] (cartridges), [<tvar="3dsdb">https://hax0kartik.github.io/3dsdb/</tvar> here] (digital games), or from the <tvar="fbi_tl_path"><code>FBI -> Titles</code></tvar> menu. For example, <tvar="taikoname">Taiko no Tatsujin: Dokodon! Mystery Adventure</tvar>'s title ID is <tvar="taiko_id"><code>0004000000190E00</code></tvar>, so if you wanted to use a plugin for that game, you'd create a folder named <tvar="taiko_id"><code>0004000000190E00</code></tvar>
* 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 <tvar=plugins><code>plugins</code></tvar> folder
* 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 <tvar="plugins"><code>plugins</code></tvar> 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 <tvar=plugins><code>plugins</code></tvar> 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 <tvar="plugins"><code>plugins</code></tvar> folder
</translate>
</translate>
<translate>An example directory for a plugin affecting one game would be <tvar=luma_pl_path><code>luma</code> -> <code>plugins</code></tvar> -> <tvar=taiko_id><code>0004000000190E00</code></tvar> -> <tvar=pl3gx><code>plugin.3gx</code></tvar>.
<translate>An example directory for a plugin affecting one game would be <tvar="luma_pl_path"><code>luma</code> -> <code>plugins</code></tvar> -> <tvar="taiko_id"><code>0004000000190E00</code></tvar> -> <tvar="pl3gx"><code>plugin.3gx</code></tvar>.
An example directory for a plugin affecting all games would be <tvar=luma_pl_path><code>luma</code> -> <code>plugins</code></tvar> -> <tvar=def3gx><code>default.3gx</code></tvar>.</translate>
An example directory for a plugin affecting all games would be <tvar="luma_pl_path"><code>luma</code> -> <code>plugins</code></tvar> -> <tvar="def3gx"><code>default.3gx</code></tvar>.</translate>
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.
Launch <tvar="UU">Universal-Updater</tvar> from the HOME Menu, or from the Homebrew Launcher
Select the magnifying glass on the bottom screen, then search for Luma3DS
Press <tvar="A">A</tvar> while hovering over Luma3DS from the list of homebrew
Choose boot.firm and wait for the install to finish
Reboot your console
If you see the Luma3DS configuration menu, enable any options that you need, then press Start
Hint: If you don't know what the options are, you don't need them
What you need
The latest release of <tvar="luma3dslink">Luma3DS</tvar> (the Luma3DS .zip file)
Installation
Insert your SD card into your computer
Copy boot.firm from the Luma3DS .zip to the root of your SD card, replacing boot.firm if it is already there
Reinsert your SD card into your console and power on
If you see the Luma3DS configuration menu, 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 <tvar="luma_pl_path">luma -> plugins</tvar> 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 [<tvar="3dsdb_cart">http://3dsdb.com/</tvar> here] (cartridges), [<tvar="3dsdb">https://hax0kartik.github.io/3dsdb/</tvar> here] (digital games), or from the <tvar="fbi_tl_path">FBI -> Titles</tvar> menu. For example, <tvar="taikoname">Taiko no Tatsujin: Dokodon! Mystery Adventure</tvar>'s title ID is <tvar="taiko_id">0004000000190E00</tvar>, so if you wanted to use a plugin for that game, you'd create a folder named <tvar="taiko_id">0004000000190E00</tvar>
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 <tvar="plugins">plugins</tvar> 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 <tvar="plugins">plugins</tvar> folder
An example directory for a plugin affecting one game would be <tvar="luma_pl_path">luma -> plugins</tvar> -> <tvar="taiko_id">0004000000190E00</tvar> -> <tvar="pl3gx">plugin.3gx</tvar>.
An example directory for a plugin affecting all games would be <tvar="luma_pl_path">luma -> plugins</tvar> -> <tvar="def3gx">default.3gx</tvar>.
Launching 3GX plugins
Open the Rosalina menu <tvar="rlcombo">(Left Shoulder+D-Pad Down+SELECT</tvar> by default)
Scroll down to the plugin loader option, then press <tvar="A">A</tvar> to enable it
Press <tvar="B">B</tvar> to exit the Rosalina menu
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 opened by pressing <tvar="SELECT">SELECT</tvar> while the plugin is loaded
