3DS:Rehid: Difference between revisions

== Features ==

* '''Remapping Buttons''' - Rehid allows you to remap buttons or combinations of buttons to different buttons or combos.

* '''Remapping Directional Input''' - Rehid also lets you remap the circle pad, remap the C stick, and/or map the circle pad and D-pad to each other.

* '''Remapping Touch''' - You can assign button inputs to points on the touchscreen, or map specific parts of the touchscreen to buttons.

* '''Per-Game Remaps''' - Rehid allows you to choose between applying a remap to only one specific title or applying it to all titles at once.

* '''RehidHelper''' - Rehid features an app to help you download its sysmodules, scan QR codes to install remaps, or disable rehid entirely.

== Installation ==

== Usage ==

=== Adding configs ===

# Open the [https://mikahjc.github.io/3dsRemapBuilder/config 3DS Remap Builder] and configure your key mappings

# When finished, click on '''Show as QR code'''

#* If you are unable to scan QR codes on your console, instead click '''Build this remap''' and place the downloaded <code>rehid.json</code> into the folder <code>sd:/rehid</code>, or <code>sd:/rehid/<title ID>/</code> if you only want to remap a specific game. You can find the title ID of your game using [https://3dsdb.com/ 3dsdb]

# Power on your console and launch '''RehidHelper'''

# Select '''Scan QR Code''' and scan the generated QR code from the website

# Press {{B|A}} to proceed

# Select a title from the list for the remap to be applied to, or select global to apply it to the entire console

# Press {{B|START}} to exit

=== Disabling Rehid ===

# Launch '''RehidHelper''' from the HOME Menu

# Select '''Toggle Rehid State'''

# Press {{B|B}} to reboot

=== Removing configs ===

* For global configurations, delete <code>sd:/rehid/rehid.json</code> or, for a configuration set to a title delete <code>sd:/rehid/<title ID>/rehid.json</code>

== Configuration ==

=== Config file ===

: <code>"keys":</code> Maps one or more keys to press different key(s).

:: Syntax: <syntaxhighlight lang="json">{

:: With the above, any time you press the {{B|ZR}} key, {{B|R}} key would be triggered, and any time you press the {{B|ZL}} key, {{B|L}} key would be triggered.

::: The keys you can use for this are: <code>A</code>, <code>B</code>, <code>X</code>, <code>Y</code>, <code>SELECT</code>, <code>START</code>, <code>ZL</code>, <code>ZR</code>, <code>L</code>, <code>R</code>, <code>LEFT</code>, <code>RIGHT</code>, <code>UP</code>, <code>DOWN</code>, <code>CLEFT</code>(CPAD), <code>CRIGHT</code>(CPAD), <code>CUP</code>(CPAD), <code>CDOWN</code>(C-PAD), <code>CSLEFT</code>(C-STICK), <code>CSRIGHT</code>(C-STICK), <code>CSUP</code>(C-STICK), <code>CSDOWN</code>(C-STICK)

:: You can use this to do custom key combos, such as the following:

:: With this, pressing {{B|X+Y}} will trigger {{B|R}} instead, and pressing {{B|SELECT}} will trigger both {{B|L}} and {{B|R}} at the same time.

: <code>"turbo":</code> Maps one or more key(s) to toggle different key(s) to be repeatedly triggered with a given delay.

:: Syntax: <syntaxhighlight lang="json">{

:: With the above, any time you press the {{B|ZL+ZR}} key, {{B|A}} key would be repeatedly triggered, with a HID-frame delay of 5.

: <code>"cpad":</code> Maps a key press to the given XY coordinates on the Circle Pad, between -190 and 190.

:: Syntax: <syntaxhighlight lang="json">{

: <code>"touch":</code> Maps a key press to the given XY coordinates on the touchscreen, from 0,0 (top-left corner) to 320,240 (bottom-right corner).

:: Syntax: <syntaxhighlight lang="json">{

: <code>"touchtokeys":</code> Maps the given area on the touch screen at the given XY coordinates to output a key press when tapped.

:: Syntax: <syntaxhighlight lang="json">{

:: The above example creates a box starting at x=10 y=20 that has a height of 50 and a width of 100.  

: Other options include:

:: <code>"cpadtodpad":true</code> Automatically redirects all C-Pad inputs to the D-Pad.<br>

:: <code>"dpadtocpad":true</code> Automatically redirects all D-Pad inputs to the C-Pad.<br>

:: <code>"overidecpadpro":true</code> Stops games from recognizing the Circle Pad Pro.<br>

:: <code>"homebutton":</code> Remaps the HOME button to one or more key press(es).

: All of the above options can be used at once in one remapping. For example:

:: <syntaxhighlight lang="json">{

=== SD file layout ===

== Troubleshooting ==

=== An exception occurred ===