3DS:Rehid: Difference between revisions

| version = 4.0

| releasedate = 2023-07-20

| githubtag = v4.0

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

|-|Universal Updater=

* [[3DS:Universal-Updater|Universal Updater]] installed on your console

# Launch '''Universal Updater'''

# Close '''Universal Updater'''

== 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">{"keys":[{"press":"ZR","get":"R"},{"press":"ZL","get":"L"}]}</syntaxhighlight>

*: 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)</p>

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

*::<syntaxhighlight lang="json">{"keys":[{"press":"X+Y","get":"R"},{"press":"SELECT","get":"L+R"}]}</syntaxhighlight>

*: 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>"cpad":</code> Maps a key press to the given XY coordinates on the Circle Pad, between -190 and 190.</p>

** Syntax: <syntaxhighlight lang="json">{"cpad":[{"press":"CUP","get":[0,190]},{"press":"CDOWN","get":[0,-190]},{"press":"CLEFT","get":[-190,0]},{"press":"CRIGHT","get":[190,0]}]}</syntaxhighlight>

* <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">{"touch":[{"press":"LEFT+UP","get":[0,0]},{"press":"RIGHT+DOWN","get":[320,240]}]}</syntaxhighlight>

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

** Syntax: <syntaxhighlight lang="json">{"touchtokeys":[{"press":[10,20,50,100],"get":"A"}]}</syntaxhighlight>

*: 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).</p>

* All of the above options can be used at once in one remapping. For example:</p>

*: <syntaxhighlight lang="json">{"keys":[{"press":"ZR","get":"R"},{"press":"ZL","get":"L"}],"cpad":[{"press":"CUP","get":[0,190]},{"press":"CDOWN","get":[0,-190]}],"touch":[{"press":"LEFT+UP","get":[0,0]},{"press":"RIGHT+DOWN","get":[320,240]}],"touchtokeys":[{"press":[10,20,50,100],"get":"A"}],"cpadtodpad":true,"dpadtocpad":true,"overridecpadpro":true,"homebutton":"ZR+ZL"}</syntaxhighlight>

=== SD file layout ===

**** {{Tree icon|f}} 0004013000001D02.cxi

== Troubleshooting ==

=== An exception occurred ===