3DS:Game plugins/3GX: Difference between revisions
From Hacks Guide Wiki
More actions
re-organize translation tags |
Marked this version for translation |
||
| Line 1: | Line 1: | ||
<languages/>{{shortcut|3DS:3GX|3GX}} | <languages/>{{shortcut|3DS:3GX|3GX}} | ||
<translate> | <translate> | ||
<!--T:1--> | |||
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. | 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. | ||
== Installation == | == Installation == <!--T:2--> | ||
</translate> | </translate> | ||
| Line 9: | Line 10: | ||
|-|Universal-Updater= | |-|Universal-Updater= | ||
<translate> | <translate> | ||
==== What you need ==== | ==== What you need ==== <!--T:3--> | ||
</translate> | </translate> | ||
| Line 15: | Line 16: | ||
<translate> | <translate> | ||
==== Installation ==== | ==== Installation ==== <!--T:4--> | ||
</translate> | </translate> | ||
<ol> | <ol> | ||
<li><translate>Power on your console</translate></li> | <li><translate><!--T:5--> Power on your console</translate></li> | ||
<li><translate>Launch <tvar name="1">'''Universal-Updater'''</tvar> from the HOME Menu, or from the Homebrew Launcher</translate></li> | <li><translate><!--T:6--> Launch <tvar name="1">'''Universal-Updater'''</tvar> from the HOME Menu, or from the Homebrew Launcher</translate></li> | ||
<li><translate>Select the magnifying glass on the bottom screen, then search for '''Luma3DS'''</translate></li> | <li><translate><!--T:7--> Select the magnifying glass on the bottom screen, then search for '''Luma3DS'''</translate></li> | ||
<li><translate>Press <tvar name="2">{{B|A}}</tvar> while hovering over '''Luma3DS''' from the list of homebrew</translate></li> | <li><translate><!--T:8--> Press <tvar name="2">{{B|A}}</tvar> while hovering over '''Luma3DS''' from the list of homebrew</translate></li> | ||
<li><translate>Choose <code>boot.firm</code> and wait for the install to finish</translate></li> | <li><translate><!--T:9--> Choose <code>boot.firm</code> and wait for the install to finish</translate></li> | ||
<li><translate>Reboot your console</translate></li> | <li><translate><!--T:10--> Reboot your console</translate></li> | ||
<li><translate>If you see the Luma3DS configuration menu, enable any options that you need, then press Start</translate></li> | <li><translate><!--T:11--> If you see the Luma3DS configuration menu, enable any options that you need, then press Start</translate></li> | ||
<ul><li><translate>Hint: If you don't know what the options are, you don't need them</translate> | <ul><li><translate><!--T:12--> Hint: If you don't know what the options are, you don't need them</translate> | ||
</li></ul> | </li></ul> | ||
</ol> | </ol> | ||
|-|<translate>Manually</translate>= | |-|<translate><!--T:13--> Manually</translate>= | ||
<translate> | <translate> | ||
==== What you need ==== | ==== What you need ==== <!--T:14--> | ||
</translate> | </translate> | ||
* <translate>The latest release of <tvar name="3">[https://github.com/LumaTeam/Luma3DS/releases/latest Luma3DS]</tvar> (the Luma3DS <code>.zip</code> file)</translate> | * <translate><!--T:15--> The latest release of <tvar name="3">[https://github.com/LumaTeam/Luma3DS/releases/latest Luma3DS]</tvar> (the Luma3DS <code>.zip</code> file)</translate> | ||
<translate> | <translate> | ||
==== Installation ==== | ==== Installation ==== <!--T:16--> | ||
</translate> | </translate> | ||
<ol> | <ol> | ||
<li><translate>Insert your SD card into your computer</translate></li> | <li><translate><!--T:17--> Insert your SD card into your computer</translate></li> | ||
<li><translate>Copy <code>boot.firm</code> from the Luma3DS <code>.zip</code> to the root of your SD card, replacing <code>boot.firm</code> if it is already there</translate></li> | <li><translate><!--T:18--> Copy <code>boot.firm</code> from the Luma3DS <code>.zip</code> to the root of your SD card, replacing <code>boot.firm</code> if it is already there</translate></li> | ||
<li><translate>Reinsert your SD card into your console and power on</translate></li> | <li><translate><!--T:19--> Reinsert your SD card into your console and power on</translate></li> | ||
<li><translate>If you see the Luma3DS configuration menu, enable any options that you need, then press Start</translate></li> | <li><translate><!--T:20--> If you see the Luma3DS configuration menu, enable any options that you need, then press Start</translate></li> | ||
<ul><li><translate>Hint: If you don't know what the options are, you don't need them</translate> | <ul><li><translate><!--T:21--> Hint: If you don't know what the options are, you don't need them</translate> | ||
</li></ul> | </li></ul> | ||
</ol> | </ol> | ||
| Line 53: | Line 54: | ||
<translate> | <translate> | ||
== Using 3GX plugins == | == Using 3GX plugins == <!--T:22--> | ||
</translate> | </translate> | ||
<translate> | <translate> | ||
=== Plugin location === | === Plugin location === <!--T:23--> | ||
</translate> | </translate> | ||
<translate> | <translate> | ||
<!--T:24--> | |||
The 3GX plugin loader will look for plugins in the <tvar name="4"><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 name="4"><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 name="5">http://3dsdb.com/</tvar> here] (cartridges), [<tvar name="6">https://hax0kartik.github.io/3dsdb/</tvar> here] (digital games), or from the <tvar name="7"><code>FBI -> Titles</code></tvar> menu. For example, <tvar name="8">Taiko no Tatsujin: Dokodon! Mystery Adventure</tvar>'s title ID is <tvar name="9"><code>0004000000190E00</code></tvar>, so if you wanted to use a plugin for that game, you'd create a folder named <tvar name="10"><code>0004000000190E00</code></tvar> | * You can get the game's title ID from [<tvar name="5">http://3dsdb.com/</tvar> here] (cartridges), [<tvar name="6">https://hax0kartik.github.io/3dsdb/</tvar> here] (digital games), or from the <tvar name="7"><code>FBI -> Titles</code></tvar> menu. For example, <tvar name="8">Taiko no Tatsujin: Dokodon! Mystery Adventure</tvar>'s title ID is <tvar name="9"><code>0004000000190E00</code></tvar>, so if you wanted to use a plugin for that game, you'd create a folder named <tvar name="10"><code>0004000000190E00</code></tvar> | ||
| Line 66: | Line 68: | ||
</translate> | </translate> | ||
<translate>An example directory for a plugin affecting one game would be <tvar name="13"><code>luma</code> -> <code>plugins</code></tvar> -> <tvar name="14"><code>0004000000190E00</code></tvar> -> <tvar name="15"><code>plugin.3gx</code></tvar>. | <translate><!--T:25--> | ||
An example directory for a plugin affecting one game would be <tvar name="13"><code>luma</code> -> <code>plugins</code></tvar> -> <tvar name="14"><code>0004000000190E00</code></tvar> -> <tvar name="15"><code>plugin.3gx</code></tvar>. | |||
<!--T:26--> | |||
An example directory for a plugin affecting all games would be <tvar name="16"><code>luma</code> -> <code>plugins</code></tvar> -> <tvar name="17"><code>default.3gx</code></tvar>.</translate> | An example directory for a plugin affecting all games would be <tvar name="16"><code>luma</code> -> <code>plugins</code></tvar> -> <tvar name="17"><code>default.3gx</code></tvar>.</translate> | ||
<translate> | <translate> | ||
=== Launching 3GX plugins<tvar name="anchor"><span class="anchor" id="Using 3GX plugins"></span></tvar> === | === Launching 3GX plugins<tvar name="anchor"><span class="anchor" id="Using 3GX plugins"></span></tvar> === <!--T:27--> | ||
</translate> | </translate> | ||
<ol> | <ol> | ||
<li><translate>Open the Rosalina menu <tvar name="18">({{B|Left Shoulder|D-Pad Down|SELECT}}</tvar> by default)</translate></li> | <li><translate><!--T:28--> Open the Rosalina menu <tvar name="18">({{B|Left Shoulder|D-Pad Down|SELECT}}</tvar> by default)</translate></li> | ||
<li><translate>Scroll down to the plugin loader option, then press <tvar name="19">{{B|A}}</tvar> to enable it</translate></li> | <li><translate><!--T:29--> Scroll down to the plugin loader option, then press <tvar name="19">{{B|A}}</tvar> to enable it</translate></li> | ||
<li><translate>Press <tvar name="20">{{B|B}}</tvar> to exit the Rosalina menu </translate></li> | <li><translate><!--T:30--> Press <tvar name="20">{{B|B}}</tvar> to exit the Rosalina menu </translate></li> | ||
<li><translate>Open your game of choice</translate></li> | <li><translate><!--T:31--> Open your game of choice</translate></li> | ||
<ul><li><translate>The screen should flash another color to indicate that the plugin has successfully loaded</translate> | <ul><li><translate><!--T:32--> The screen should flash another color to indicate that the plugin has successfully loaded</translate> | ||
</li></ul> | </li></ul> | ||
<li><translate>Look at the information on the plugin's webpage/README for usage instructions - usage will differ for each plugin</translate></li> | <li><translate><!--T:33--> Look at the information on the plugin's webpage/README for usage instructions - usage will differ for each plugin</translate></li> | ||
</ol> | </ol> | ||
<translate> | <translate> | ||
=== Usage notes === | === Usage notes === <!--T:34--> | ||
</translate> | </translate> | ||
* <translate>Most plugins have a menu that can be opened by pressing <tvar name="21">{{B|SELECT}}</tvar> while the plugin is loaded</translate> | * <translate><!--T:35--> Most plugins have a menu that can be opened by pressing <tvar name="21">{{B|SELECT}}</tvar> while the plugin is loaded</translate> | ||