3DS:Luma3DS/Configuration: Difference between revisions

The Luma3DS configuration menu is a menu that can be accessed by holding (Select) while turning on your 3DS. In the menu, you can:

Luma3DS configuration will be often be set back to their default settings if:

{{info|If your {{B|Select}}, {{B|Start}}, {{B|D-Pad Up}}, {{B|D-Pad Down}}, or {{B|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).}}

You can access Luma3DS configuration by holding (Select) while powering on your device.<br>

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 highlighted option will be coloured a different colour from the rest of the configuration menu and an option that is currently enabled 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.<br>

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.

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]].

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 reveal hidden bugs in games when the Clock+L2 setting is enabled - this can result in anything up to a crash. This option is the same as the one found in the [[3DS:Luma3DS/Rosalina|Rosalina menu]].

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>.

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>.<br>

You will also need this option if you need to manually specify the locale for games that don't work despite 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.

====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. These are almost entirely unneeded by now, however, and should instead be [[3dsguide:move-emunand|moved into the SysNAND]] unless you are dealing with CHN/KOR regioned fonts.}}

====Default EmuNAND====

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).

 

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 {{B|L}} 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.

==Configuration options in config.ini==

As of Luma3DS v11.0, certain options have been moved and can only be edited in 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====

====splash_duration_ms====

===Rosalina menu options===

The following options can also be changed via the [[3DS:Luma3DS/Rosalina|Rosalina menu]].

====hbldr_3dsx_titleid====

====rosalina_menu_combo====

Determines what keys you need to press to open the Rosalina menu. By default, this is set to {{B|L}} + {{B|D-Pad Down}} + {{B|Select}}.<br>

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 {{B|X}} + {{B|Y}}.

====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.

===Options you shouldn't touch===

====use_dev_unitinfo====

{{warning|This option will break most retail features while enabled - this includes online play, eShop, amiibo, and retail games.}}

====disable_arm11_exception_handlers====

{{warning|This option normally does not stop errors from happening - it only makes them 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====

{{info|1=Luma3DS should not touch SAFE_FIRM since SAFE_FIRM is meant as a 'rescue mode' - it's relatively unlikely anything bad will happen, but don't enable this option without a specific good reason.}}

==Troubleshooting with Luma3DS configuration==