|
|
| Line 1: |
Line 1: |
| The Luma3DS configuration menu is a menu that can be accessed by holding (Select) while turning on your 3DS. In the menu, you can:
| | <languages/> |
| * See what version of Luma3DS is currently installed
| | <translate> |
| * Modify Luma3DS's 'optional' settings (settings that will, in general, not affect the overall functionality of your 3DS)
| | <!--T:1--> |
| * See where Luma3DS is booting from
| | This is an add-on section for formatting an SD card to FAT32. |
|
| |
|
| By default, [[3dsguide:index|our custom firmware installation guide]] uses the default configuration that is generated when Luma3DS is first run. This page will contain explanations for the various options contained in Luma3DS configuration.
| | <!--T:3--> |
| | This page is for Windows users only. If you are not on Windows, check out the [[Special:MyLanguage/Formatting an SD card/Linux|Linux]] or [[Special:MyLanguage/Formatting an SD card/Mac|Mac]] pages. |
| | </translate> |
|
| |
|
| Luma3DS configuration will be often be set back to their default settings if:
| | == Choose your SD card size == |
| * You are upgrading to a newer version of Luma3DS that has a breaking change
| | <tabber> |
| * You are switching between Luma3DS forks
| | |-|<translate><!--T:40--> 64GB or larger</translate>= |
|
| |
|
| Luma3DS also keeps separate configuration for the SD card and CTRNAND (internal memory). The human-readable configuration file is located at <code>SD:/luma/config.ini</code> and <code>CTRNAND:/rw/luma/config.ini</code>, respectively.
| | === What You Need === |
| | *<translate><!--T:4--> The latest version of <tvar name="sdformatter">[https://www.sdcard.org/downloads/formatter/sd-memory-card-formatter-for-windows-download/ SD Memory Card Formatter]</tvar></translate> |
| | *<translate><!--T:5--> The latest version of <tvar name="guiformat">[http://ridgecrop.co.uk/index.htm?guiformat.htm guiformat]</tvar></translate> |
|
| |
|
| == Navigating Luma3DS configuration == | | <translate> |
| | === Instructions === <!--T:39--> |
| | </translate> |
|
| |
|
| {{info|If your (Select), (Start), (D-Pad Up), (D-Pad Down), or (A) keys are broken, you will be unable to perform most functions in Luma3DS configuration. As an alternative, you can manually modify all options that are in the Luma3DS configuration by modifying the <code>config.ini</code> file in the <code>luma</code> folder (as of Luma3DS v11.0).}}
| | <ol> |
| | <li><translate><!--T:22--> Insert your SD card into your computer</translate></li> |
| | <li><translate><!--T:23--> If the SD card has any files and folders on it, copy everything to a folder on your computer</translate></li> |
| | <li><translate><!--T:43--> Run <code>SD Card Formatter Setup</code> (the <code>.exe</code> file) in the downloaded .zip file with Administrator privileges, then install the program</translate></li> |
| | <li><translate><!--T:44--> Run <code>SD Card Formatter</code> from the Start Menu</translate></li> |
| | <li><translate><!--T:45--> Select your SD card’s drive letter for "Select card"</translate>{{warning|<translate nowrap><!--T:46--> Make sure you choose the correct drive letter, otherwise you might accidentally erase the wrong drive!</translate>}}</li> |
| | <li><translate><!--T:47--> Ensure that "Quick Format" is selected</translate></li> |
| | <li><translate><!--T:48--> Click "Format"</translate></li> |
| | <li><translate><!--T:49--> Click "OK"</translate></li> |
| | <li><translate><!--T:50--> Wait for the format to finish</translate></li> |
| | <li><translate><!--T:51--> Click "OK"</translate></li>{{info|<translate nowrap><!--T:52--> '''You're not done yet!''' Your SD card will be formatted to exFAT at this point. The following steps will format it to FAT32.</translate>}} |
| | <li><translate><!--T:53--> Close SD Card Formatter</translate></li> |
| | <li><translate><!--T:24--> Run <code>guiformat.exe</code></translate></li> |
| | <li><translate><!--T:25--> Select your SD card’s drive letter for "Drive"</translate>{{warning|<translate nowrap><!--T:26--> Make sure you choose the correct drive letter, otherwise you might accidentally erase the wrong drive!</translate>}}</li> |
| | <li><translate><!--T:27--> Select a size for "Allocation unit size"</translate> |
| | <ul> |
| | <li><translate><!--T:28--> If the SD card is 64GB, choose 32768</translate></li> |
| | <li><translate><!--T:29--> If the SD card is larger than 64GB, choose 65536</translate></li> |
| | </ul></li> |
| | <li><translate><!--T:31--> Ensure that "Quick Format" is selected</translate></li> |
| | <li><translate><!--T:32--> Click "Start"</translate></li> |
| | <li><translate><!--T:33--> Click "OK"</translate></li> |
| | <li><translate><!--T:34--> Wait for the format to finish</translate></li> |
| | <li><translate><!--T:35--> Click "Close"</translate></li> |
| | <li><translate><!--T:36--> If the SD card had any files and folders on it before the format, copy everything back from your computer</translate></li> |
| | </ol> |
|
| |
|
| You can access Luma3DS configuration by holding (Select) while powering on your device.
| | <translate> |
| | === Common errors with guiformat === <!--T:37--> </translate> |
| | ==== Failed to open device: GetLastError()=32 ==== |
| | <translate> |
| | <!--T:38--> |
| | Close everything that may be using the SD card, such as any File Explorer windows. If it does not resolve the issue, try formatting the card to NTFS, then run GUIFormat again. |
| | </translate> |
|
| |
|
| When in the Luma3DS configuration menu, you can use the (Up) and (Down) D-Pad buttons to highlight different options. Press (A) to enable, disable, or cycle through the options. The currently selected option will be indicated with <code>(x)</code>. For example, <code>(x) Show NAND or user string in System Settings</code> indicates that the "Show NAND or user string in System Settings" option is enabled.
| | ==== GetLastError()=1117 ==== |
| | <translate> |
| | <!--T:41--> |
| | Your SD card write-protection switch may be [https://3ds.hacks.guide/images/sdlock.png enabled]. The lock must be flipped upwards to allow writing to the SD card (including formatting). |
| | </translate> |
|
| |
|
| Once you are done configuring Luma3DS, press the (Start) button to save your configuration. If you have enabled a PIN, you will be told to set it; otherwise, the 3DS will reboot into the HOME Menu.
| | |-|<translate><!--T:42--> 32GB or smaller</translate>= |
|
| |
|
| | === What You Need === |
| | *<translate><!--T:56--> The latest version of <tvar name="sdformatter">[https://www.sdcard.org/downloads/formatter/sd-memory-card-formatter-for-windows-download/ SD Memory Card Formatter]</tvar></translate> |
|
| |
|
| == Luma3DS configuration options == | | <translate> |
| | === Instructions === <!--T:55--> |
| | </translate> |
|
| |
|
| ==== Screen brightness ====
| | <ol> |
| | <li><translate><!--T:7--> Insert your SD card into your computer</translate></li> |
| | <li><translate><!--T:8--> If the SD card has any files and folders on it, copy everything to a folder on your computer</translate></li> |
| | <li><translate><!--T:9--> Run <code>SD Card Formatter Setup</code> (the <code>.exe</code> file) in the downloaded .zip file with Administrator privileges, then install the program</translate></li> |
| | <li><translate><!--T:10--> Run <code>SD Card Formatter</code> from the Start Menu</translate></li> |
| | <li><translate><!--T:11--> Select your SD card’s drive letter for "Select card"</translate>{{warning|<translate nowrap><!--T:12--> Make sure you choose the correct drive letter, otherwise you might accidentally erase the wrong drive!</translate>}}</li> |
| | <li><translate><!--T:14--> Ensure that "Quick Format" is selected</translate></li> |
| | <li><translate><!--T:15--> Click "Format"</translate></li> |
| | <li><translate><!--T:16--> Click "OK"</translate></li> |
| | <li><translate><!--T:17--> Wait for the format to finish</translate></li> |
| | <li><translate><!--T:18--> Click "OK"</translate></li> |
| | <li><translate><!--T:19--> Close SD Card Formatter</translate></li> |
| | <li><translate><!--T:20--> If the SD card had any files and folders on it before the format, copy everything back from your computer</translate></li> |
| | </ol> |
| | </tabber> |
|
| |
|
| Changes the brightness of the Luma3DS configuration screen. Takes effect instantly.
| | ==SD Card not formatting or has some other issue.== |
| | Refer to the [[SD Clean/Windows|SD Clean]] guide. |
|
| |
|
| ==== Splash ====
| | {{hg imported|Guide_3DS}} |
|
| |
|
| Determines whether Luma3DS will attempt to display a splash screen (a custom boot image) while booting your 3DS. This option will not do anything unless you have splash images in the <code>luma</code> folder. For more information, see [[3DS:Splash screens]].
| | [[Category:General guides]] |
| | |
| ==== PIN lock ====
| |
| | |
| Determines whether Luma3DS will require a PIN to be entered when powering on your device. You will be prompted to set the PIN after pressing (Start) to save the configuration. For more information, see [[3DS:Luma3DS/PIN lock]].
| |
| | |
| ==== New 3DS CPU (New 3DS only) ====
| |
| | |
| Determines whether to use the New 3DS's enhanced clock speed and L2 cache in games intended for Old 3DS. This may improve performance for some games, but it may also break other games. This is the same option as the one that can be found in the [[3DS:Luma3DS/Rosalina|Rosalina menu]].
| |
| | |
| ==== Enable loading external FIRMs and modules ====
| |
| | |
| Determines whether Luma3DS will attempt to load customized FIRMs and system modules (basically, for modifying non-game elements on the 3DS). This option will not do anything unless you have the necessary files in <code>luma</code> or <code>/luma/sysmodules</code>.
| |
| | |
| You will most likely only use this option for specific applications like TWPatch (for widescreen DS games) and
| |
| rverse (a custom Miiverse server). For more information, consult their respective installation guides.
| |
| | |
| ==== Enable game patching ====
| |
| | |
| Determines whether Luma3DS will attempt to load modded game files. This option will not do anything unless you have the necessary files in <code>/luma/titles/(title ID of game)</code>.
| |
| | |
| You will also need this option if you need to manually specify the locale for games that aren't cooperating with Luma3DS's region-free patch. For more information, see [[3DS:Setting game locales]].
| |
| | |
| ==== Show NAND or user string in System Settings ====
| |
| | |
| Determines whether Luma3DS will show its own (or a user-specified) version string in System Settings. For example, the default version string of an unmodded 3DS on 11.16.0-49U would be <code>Ver. 11.16.0-49U</code>. With this option enabled, the version string would instead show <code>Sys. 11.16.0-49U</code>. This serves as a decent custom firmware check, but it is not comprehensive since the option can be disabled at will.
| |
| | |
| A custom version string of up to '''19 characters''' can also be manually specified by creating a file with the custom string called <code>customversion_sys.txt</code> and putting it inside the <code>luma</code> folder.
| |
| | |
| ==== Show GBA boot screen in patched AGB_FIRM ====
| |
| | |
| Determines whether Luma3DS will show the [https://www.youtube.com/watch?v=6_ZD3FxMcvQ GBA boot screen] when loading a GBA game through the built-in GBA firmware of the 3DS (such as through virtual console).
| |
| | |
| == EmuNAND/RedNAND only ==
| |
| | |
| {{info|These options will only appear if your currently inserted SD card has an [[3DS:EmuNAND and RedNAND|EmuNAND/RedNAND]] set up.}}
| |
| | |
| ==== Default EmuNAND ====
| |
| | |
| It is possible to have multiple EmuNANDs on one SD card. This option changes which one to boot into by default. If you only have one EmuNAND, this option will not do anything.
| |
| | |
| You can also manually specify which EmuNAND to boot into by holding a D-Pad button while booting (Up for 1, Right for 2, Down for 3, Left for 4).
| |
| | |
| ==== Autoboot EmuNAND ====
| |
| | |
| Determines whether EmuNAND will automatically boot when you turn on your 3DS without holding any buttons. If this option is disabled, you will boot into SysNAND by default. You can force the 3DS to boot into SysNAND, even with this option enabled, by holding (Left Shoulder) on boot, and vice versa.
| |
| | |
| ==== Use EmuNAND FIRM if booting with R ====
| |
| | |
| If this option is enabled, you will be able to use EmuNAND's NATIVE_FIRM instead of SysNAND's NATIVE_FIRM by booting with the (Right Shoulder) button held.
| |
| | |
| You probably don't need to touch this option unless you have very specific use cases that won't be covered here.
| |
| | |
| == Configuration options in config.ini ==
| |
| | |
| As of Luma3DS v11.0, certain options have been moved to exclusively the <code>config.ini</code> file in <code>SD:/luma/config.ini</code> or <code>CTRNAND:/rw/luma/config.ini</code>. This section documents those options.
| |
| | |
| ==== config_version_major, config_version_minor ====
| |
| | |
| {{warning|Don't touch this one.}}
| |
| | |
| Luma3DS uses these lines to determine what revision of <code>config.ini</code> is being used to prevent inconsistencies between Luma3DS updates. '''Do not touch these options''' - otherwise, you may accidentally reset your Luma3DS configuration.
| |
| | |
| ==== splash_duration_ms ====
| |
| | |
| Determines for how many milliseconds the splash screen should be displayed, up to 2,147,483,647 milliseconds. For more information, see [[3DS:Splash screens]].
| |
| | |
| === Rosalina menu options ===
| |
| | |
| The following options can also be changed via the [[3DS:Luma3DS/Rosalina|Rosalina menu]].
| |
| | |
| ==== hbldr_3dsx_titleid ====
| |
| | |
| The title ID that is input here will launch the Homebrew Launcher instead of whatever application is actually run. In most cases, this will be set to the Homebrew Launcher application installed in the guide (000400000d921e00).
| |
| | |
| ==== rosalina_menu_combo ====
| |
| | |
| Determines what key(s) you need to press to open the Rosalina menu. By default, this is set to (Left Shoulder) + (Down D-Pad) + (Select).
| |
| | |
| For example, if one of the default keys is broken, you can set it to <code>X+Y</code> to change the menu combination to <code>(X)</code> + <code>(Y)</code>.
| |
| | |
| ==== screen_filters_cct ====
| |
| | |
| This value (between 1000 and 25100) determines how strong the blue light filter is. Lower is more orange (and thus, normally, less eye-straining). The dfeault value is 6500.
| |
| | |
| ==== ntp_tz_offset_min ====
| |
| | |
| Determines your timezone for the purpose of setting the correct time. This configuration option is based on UTC.
| |
| | |
| For example, Eastern Standard Time (EST) in the United States is UTC-5, so the offset would be 60 * -5 = -240.
| |
| | |
| === Options you shouldn't touch ===
| |
| | |
| You shouldn't touch these options unless you know what you're doing.
| |
| | |
| ==== use_dev_unitinfo ====
| |
| | |
| {{warning|This option will break most retail features while enabled (including online play, eShop, amiibo, and retail games)!}}
| |
| | |
| When set to 1, this option changes a flag in the 3DS firmware so that it thinks it is a development unit, allowing you to run development applications.
| |
| | |
| ==== disable_arm11_exception_handlers ====
| |
| | |
| {{warning|This option normally does not stop errors from happening! It just shows a black screen or generic error message instead of the detailed error message, which makes it harder to troubleshoot.}}
| |
| | |
| When set to 1, this option disables the "An exception occurred" message that occurs when an application crashes, normally replacing it with a black screen or a generic error message.
| |
| | |
| ==== enable_safe_firm_rosalina ====
| |
| | |
| When set to 1, this option does two things:
| |
| * Allows Rosalina to function when using [[3DS:Safe Mode|Safe Mode]] (for example, if you need to take screenshots of Safe Mode or perform whatever other functions Rosalina allows)
| |
| * Suppresses the <code>0xF96183FE</code> QTM error, which notably allows the New 2DS XL to work on firmwares below 11.3.0
| |
| | |
| This option won't do anything drastic, but there's not much reason to enable it unless you actually have a use for it.
| |
| | |
| == Troubleshooting with Luma3DS configuration ==
| |
| | |
| The Luma3DS configuration menu contains two pieces of information that can be used for troubleshooting: the currently installed Luma3DS version and the location from which Luma3DS is booting.
| |
| | |
| If you are starting fresh from a new SD card or upgrading from an old (2017 or older) custom firmware setup, you can follow the instructions [[3dsguide:checking-for-cfw|here]] to find out the correct course of action.
| |
| | |
| As of Luma3DS v9.1, the location from which Luma3DS is booting will be displayed in yellow on the bottom screen. The following lines are known to be possible:
| |
| * Booted from SD via B9S
| |
| ** Indicates that Luma3DS is being booted from the <code>boot.firm</code> file on the root of your SD card (or wherever else you may have it configured if you are using fastboot3DS).
| |
| * Booted from CTRNAND via B9S
| |
| ** Indicates that Luma3DS is being booted from the <code>boot.firm</code> file on the root of SYSNAND CTRNAND (or wherever else you may have it configured if you are using fastboot3DS). If an SD card is inserted and you still see this message, you are either missing <code>boot.firm</code> from the root of your SD card, or your SD card isn't being read.
| |
| * Booted from SD via B9S (ntrboot)
| |
| ** Indicates that Luma3DS is being booted from the <code>boot.firm</code> file on the root of your SD card, but that you are running B9S via ntrboot. If you're trying to install CFW, you should instead use SafeB9SInstaller as your <code>boot.firm</code> file.
| |
| * Booted from SD via FIRM0 or FIRM1
| |
| ** Indicates that Luma3DS has been installed to your FIRM partitions (where boot9strap or fastboot3DS would normally go). This is known to break some custom firmware functions, so unless you intended for this to happen, you should [[3dsguide:updating-b9s|follow these instructions]] to install boot9strap to your FIRM partitions.
| |
