Configuring Controllers: Difference between revisions

Updated this page (and its images) to its recent revision (5.0-11816)
mNo edit summary
(Updated this page (and its images) to its recent revision (5.0-11816))
Line 7: Line 7:




In the first half, you can configure or disable the emulated GameCube controller ports. The GameCube controllers themselves are referred to as '''"Standard Controller"''' in the dropdown menu. The controller order on the PC does not have to equal to GameCube controller port order. They will be handled entirely in the GameCube Controller Configuration window. It is within each port's own '''"Configure"''' button.
In the Gamecube Controllers config area, you can configure or disable the emulated GameCube controller ports. The emulated GameCube controllers themselves are referred to as '''"Standard Controller"''' in the dropdown menu. The controller order on the PC does not have to equal to GameCube controller port order. They will be handled entirely in the GameCube Controller Configuration window. It is within each port's own '''"Configure"''' button.




In the second half, you have options to use real, emulated Wii Remotes, or hybrid of two in the same slot. The Wii Remotes are referred to as "Wiimotes" in Dolphin settings. Select '''"Real Wiimote"''' in the dropdown for a Wiimote slot to use a real-world Wii Remote connected to your PC via bluetooth for that slot. Dolphin supports up to four Wii Remotes at once, along with any peripherals you have attached to them. The Balance Board is in the fifth slot in Wiimote settings and it is meant to enable with a real-world Balance Board.
In the Wii Controllers config area, you have the option to use real or emulated Wii Remotes, as well as choosing to passthrough a Bluetooth Adapter (see [[Bluetooth Passthrough]]) or emulating the Wii's adapter. You can also assign the Wii Remote to connect it as an emulated controller by selecting '''"Connect Wii Remotes for Emulated Controllers"'''. Select '''"Real Wii Remote"''' in the dropdown for a Wii Remote slot to use a real-world Wii Remote connected to your PC via bluetooth for that slot. Dolphin supports up to four Wii Remotes at once, along with any peripherals you have attached to them. Although the Balance Board cannot be emulated, Dolphin allows the use of a real-world Balance Board by selecting '''"Real Balance Board"'''. '''Enable Speaker Data''' controls whether the Wii Remote speaker can produce sound. When using a real Wii Remote, the audio will come out of the Wii Remotes' speakers; with emulated Wii Remotes, it will come out of the system speakers. Some games, like [[Metroid Prime 3]], have lag issues when '''Enable Speaker Data''' is enabled on some systems.
 
 
In the Common config area, you can choose options that would both affect Gamecube and Wii controllers. '''Background Input''' lets you use the controller or keyboard even if Dolphin isn't in focus. '''Alternate Input Sources''' allows the use of capturing motion data from other hardware inputs into Dolphin. See [[DSU Client]] for more details.
 




Line 31: Line 35:
If you controller supports it, '''Rumble''' will allow your controller to experience the GameCube controller's rumble functionality. Within the rumble configuration window, click on the motor pattern you wish to use (sine, cosine, etc), and press '''"Select"''' to apply it. If you wish to add a second pattern, click another pattern and press '''"| OR"'''. Hit '''"OK"''' to accept the changes and exit the window.
If you controller supports it, '''Rumble''' will allow your controller to experience the GameCube controller's rumble functionality. Within the rumble configuration window, click on the motor pattern you wish to use (sine, cosine, etc), and press '''"Select"''' to apply it. If you wish to add a second pattern, click another pattern and press '''"| OR"'''. Hit '''"OK"''' to accept the changes and exit the window.


'''Background Input''' lets you use the controller or keyboard even if Dolphin isn't in focus. This option will enable or disable symmetrically with '''Background Input''' in Wii Remote settings. This option has been moved to the main configuring controller window as of {{Revision|5.0-3019}}.
'''Control Stick Calibration''' limits the radius of the joystick input. This is used to map the dimensions of the input source.
 
With '''Iterative Input''' checked, it will turn the configuration window into sequence mode (I.E. once you click on a slot to set a button/key for it, it will start a sequence). As soon as you press a input on your device and it gets assigned, it will jump to the next slot for you to assign another input to, and it will keep going until the sequence is done.


'''Radius''' limits the radius of the joystick input. Since the GameCube controller does not use 100% of its radius, a radius of 70-75 is appropriate for most controllers. Those using an unofficial GameCube adapter should set the radius to 100.
'''Always Connected''' forces the emulated controller to stay connected to the emulated Gamecube.


'''Profile''' allows you to save/load input configs.
'''Profile''' allows you to save/load input configs.
Line 41: Line 43:
After setting up everything that you want, click '''"OK"''' and the changes will save.
After setting up everything that you want, click '''"OK"''' and the changes will save.


'''NOTE:''' If the controller is significantly off center in Dolphin but nowhere else, check all controller axis to see if one has a "+-" on it.  This is not supposed to happen and is the source of your bug.
'''NOTE:''' If the controller is significantly off center in Dolphin but nowhere else, check all controller axis to see if one has a "+-" on it .  This is not supposed to happen and is the source of your bug.


== Wii Remote "Wiimote" ==
== Wii Remote ==
<!-- "Wiimote" when referring to the Dolphin settings and "Wii Remote" when referring to actual remote for Wii. -->


=== Real Wiimote ===
To connect a Wii Remote, press '''"Refresh"''' then press the '''1''' + '''2''' buttons on your Wii Remote simultaneously (Sync button for -TR models). '''Continuous Scanning''' allows you to connect a Wii Remote without having to open the Wiimote window and press refresh every time. As long as a game is running or the Wiimote configuration window is up, just press '''1''' + '''2''' or the sync button on your Wii Remote simultaneously and it will connect.


After several minutes of inactivity, Wii titles will attempt to disconnect the Wii Remote. The Wii Remote will remain on and connected to Dolphin, but the game will believe it is disconnected. To "reconnect" the Wii Remote, go to Tools -> Connect Wiimotes -> Connect Wiimote # or use a hotkey corresponding to it (example - the Windows default for Wiimote 1 is Alt-F5), or simply press a button on the Wiimote.
=== Real Wii Remote ===
To connect a Wii Remote, press '''"Refresh"''' then press the '''1''' + '''2''' buttons on your Wii Remote simultaneously (Sync button for -TR models). '''Continuous Scanning''' allows you to connect a Wii Remote without having to open the Wii Remote window and press refresh every time. As long as a game is running or the Wii Remote configuration window is up, just press '''1''' + '''2''' or the sync button on your Wii Remote simultaneously and it will connect.
 
After several minutes of inactivity, Wii titles will attempt to disconnect the Wii Remote. The Wii Remote will remain on and connected to Dolphin, but the game will believe it is disconnected. To "reconnect" the Wii Remote, go to Tools -> Connect Wii Remotes -> Connect Wii Remote # or use a hotkey corresponding to it (example - the Windows default for Wii Remote 1 is Alt-F5), or simply press a button on the Wii Remote.


Dolphin does not automatically turn off Wii Remotes as the Wii will (except on Linux). Remember to turn off controllers on your own to save battery power, simply by holding the power button on Wii Remote for a second as you would to turn off the Wii. It will also tell Dolphin that it's disconnected instead of stopping the game emulation.
Dolphin does not automatically turn off Wii Remotes as the Wii will (except on Linux). Remember to turn off controllers on your own to save battery power, simply by holding the power button on Wii Remote for a second as you would to turn off the Wii. It will also tell Dolphin that it's disconnected instead of stopping the game emulation.


==== Couldn't Connect ====
==== Couldn't Connect ====
Wii Remotes use the Bluetooth interface, make sure your PC supports Bluetooth. Do not pair the Wii Remote to your computer through its native Bluetooth settings. The operating system may interfere with Dolphin's ability to connect with the Wii Remote. In addition, Wii Remote connectivity will only work if one of the Wiimote slots is set to Real Wiimote or Hybrid Wiimote and it's not claimed by another Wii Remote.
Wii Remotes use the Bluetooth interface, make sure your PC supports Bluetooth. Do not pair the Wii Remote to your computer through its native Bluetooth settings. The operating system may interfere with Dolphin's ability to connect with the Wii Remote. In addition, Wii Remote connectivity will only work if one of the Wii Remote slots is set to Real Wii Remote and it's not claimed by another Wii Remote.


If the remote does not seem to want to connect, '''make sure that any real Wiis in proximity are switched off for the duration of the pairing process.'''
If the remote does not seem to want to connect, '''make sure that any real Wiis in proximity are switched off for the duration of the pairing process.'''
Line 60: Line 62:
<samp>RVL-CNT-01-TR</samp> Wii Remote Pluses may need extra configuration for older versions of Windows, see the [[Wii Remote Plus (RVL-CNT-01-TR) Connection Guide]].
<samp>RVL-CNT-01-TR</samp> Wii Remote Pluses may need extra configuration for older versions of Windows, see the [[Wii Remote Plus (RVL-CNT-01-TR) Connection Guide]].


=== Emulated Wiimote ===
=== Emulated Wii Remote ===
The configuration window for emulated Wii Remote works in the same way as the GameCube controller settings.
The configuration window for emulated Wii Remote works in the same way as the GameCube controller settings.


Line 72: Line 74:




'''Extension''' Allows you to add an emulated Nunchuk, Guitar, or other Wii Remote peripheral. Select the extension you want to emulate in the dropdown, and press configure to open a window with slots just like the Emulated Wiimote window. Select buttons and axes as you wish, and press OK to save.
'''Extension''' Allows you to add an emulated Nunchuk, Guitar, or other Wii Remote peripheral. Select the extension you want to emulate in the dropdown, and press configure to open a window with slots just like the Emulated Wii Remote window. Select buttons and axes as you wish, and press OK to save. If you wish to attach a MotionPlus to the emulated Wii Remote, select '''"Attach MotionPlus"'''.


'''Background Input''' lets you use the controller or keyboard even if Dolphin isn't in focus. This option will enable or disable symmetrically with '''Background Input''' in GameCube Controller settings. This option has been moved to the main configuring controller window as of {{Revision|5.0-3019}}.
If you controller supports it, '''Rumble''' will allow your controller to experience the Wii Remote's rumble functionality. Within the rumble configuration window, click on the motor pattern you wish to use (sine, cosine, etc), and press '''"Select"''' to apply it. If you wish to add a second pattern, click another pattern and press '''"| OR"'''. Hit '''"OK"''' to accept the changes and exit the window.


'''Sideways Wiimote''' changes the emulated Wii Remote controls to allow you to play games as though the Wii Remote is sideways, without actually changing your controls. It is useful for games such as [[New Super Mario Bros. Wii]] that are designed for it.
'''Speaker Pan''' allows you to shift the emulated Wii Remote audio to the left or the right on your system speakers, if '''Enable Speaker Data''' is checked. -100% is left, 0 is centered, and +100% is right.


'''Upright Wiimote''' alters the base swinging and tilting orientation of the emulated wiimote to the upright position.
'''Battery''' allows you to change the battery level of the emulated Wii Remote.


With '''Iterative Input''' checked, it will turn the configuration window into sequence mode (I.E. once you click on a slot to set a button/key for it, it will start a sequence). As soon as you press a input on your device and it gets assigned, it will jump to the next slot for you to assign another input to, and it will keep going until the sequence is done.
'''Upright Wii Remote''' alters the base swinging and tilting orientation of the emulated Wii Remote to the upright position.


'''Speaker Pan''' allows you to shift the emulated Wii Remote audio to the left or the right on your system speakers, if '''Enable Speaker Data''' is checked. -127 is left, 0 is centered, and +127 is right.
'''Sideways Wii Remote''' changes the emulated Wii Remote controls to allow you to play games as though the Wii Remote is sideways, without actually changing your controls. It is useful for games such as [[New Super Mario Bros. Wii]] that are designed for it.
 
If you controller supports it, '''Rumble''' will allow your controller to experience the Wii Remote's rumble functionality. Within the rumble configuration window, click on the motor pattern you wish to use (sine, cosine, etc), and press '''"Select"''' to apply it. If you wish to add a second pattern, click another pattern and press '''"| OR"'''. Hit '''"OK"''' to accept the changes and exit the window.


'''Profile''' allows you to save/load input configs.
'''Profile''' allows you to save/load input configs.
Line 92: Line 92:


=== General Settings ===
=== General Settings ===
These settings apply to both Emulated and Real Wiimotes.
These settings apply to both Emulated and Real Wii Remotes.


'''Sensor Bar Position''', '''IR Sensitivity''', '''Speaker Volume''', and '''Wiimote Motor''' are duplicates of Wii settings. They do exactly what they say they do, and work exactly like the same settings on the Wii itself.
'''Sensor Bar Position''', '''IR Sensitivity''', '''Speaker Volume''', and '''Wii Remote Motor''' are duplicates of Wii settings. They do exactly what they say they do, and work exactly like the same settings on the Wii itself.
 
'''Enable Speaker Data''' controls whether the Wii Remote speaker can produce sound. When using a real Wii Remote, the audio will come out of the Wii Remotes' speakers; with emulated Wii Remotes, it will come out of the system speakers. Some games, like [[Metroid Prime 3]], have lag issues when '''Enable Speaker Data''' is enabled on some systems.


== Hotkey Settings ==
== Hotkey Settings ==
Dolphin has preloaded user-configurable hotkeys only found under Options > '''Hotkey Settings'''. This has great use for Hotkey and Tool-Assisted Speedrun users, and it is required for '''Free Look''' (if enabled under Utility section in Configure... > Graphics Settings > "Advanced" tab) and a way to exit Fullscreen.
Dolphin has preloaded user-configurable hotkeys only found under Options > '''Hotkey Settings'''. This has great use for Hotkey and Tool-Assisted Speedrun users, and it is required for '''Free Look''' (if enabled under Utility section in Options > Graphics Settings > "Advanced" tab) and a way to exit Fullscreen.




Line 107: Line 105:
*Right click a slot to show more input options. See [[Input Syntax]] for documentation and examples.
*Right click a slot to show more input options. See [[Input Syntax]] for documentation and examples.


'''Background Input''' lets you use the controller or keyboard even if Dolphin isn't in focus. This option will enable or disable symmetrically with '''Background Input''' in GameCube Controller and Wii Remote settings.
With '''Iterative Input''' checked, it will turn the configuration window into sequence mode (I.E. once you click on a slot to set a button/key for it, it will start a sequence). As soon as you press a input on your device and it gets assigned, it will jump to the next slot for you to assign another input to, and it will keep going until the sequence is done.


There is no way to map hotkeys on the native controllers.
There is no way to map hotkeys on the native controllers.


[[Category:Tutorials]]
[[Category:Tutorials]]