In order to edit this wiki, you must register and verify your account.

Motion controls: Difference between revisions

From Cemu Wiki
Jump to:navigation Jump to:search
m (Removed steam controller compatibility segment, as it isn't)
 
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
===Motion Data in Wii U and Cemu===
This article provides a list of methods to achieve motion controls within Cemu.
The Wii U provides motion data to games either with the Wii U GamePad or a Wiimote (MotionPlus model). In order to have that in Cemu we can:


a) Use a UDP-based motion server application to send the motion data of a real motion-support controller (that [[Cemuhook]]'s GamePad Motion Source API listens to.)<br>
Cemu is capable of emulating '''motion controls''' within the Wii U GamePad or a Wiimote (MotionPlus model). In order to accomplish that in Cemu, various methods can be attempted, including setting up a UDP-based motion server application to send the motion data of a real motion-support controller (that [[Cemuhook]]'s GamePad Motion Source API listens to), using the emulated Wiimote Controller API in Cemu's input menu in combination with a real Wiimote (MotionPlus model), or using a hacky workaround that involves right clicking and dragging within the Cemu window.
b) Use the emulated Wiimote Controller API in Cemu's Input Menu in combination with a real Wiimote (MotionPlus model.)<br>
c) Use a hacky workaround that involves right-click & dragging within the Cemu window, which isn't recommended if it can be avoided.<br>


Cemu 1.18.0 or later supports the [[Cemuhook]] motion API natively (Input Options > API > DSUClient) and it also adds native motion for the emulated Wiimote Controller API.<br>
Cemu 1.18.0 and later support the Cemuhook motion API natively (<code>Input Options > API > DSUClient</code>) and adds native motion for the emulated Wiimote Controller API.
Note: '''Cemu's DSUClient API option should not yet be used due to some inconsistencies.''' The Wiimote Controller API should still be fine, however.


=== Motion via the Cemuhook GamePad Motion Source API===
{{Note|'''Cemu's DSUClient API option should not yet be used due to some inconsistencies.''' The Wiimote Controller API should still be fine, however.}}


The Wii U GamePad and the Wiimote MotionPlus include a gyroscope and accelerometer which are used to provide full motion data to several games (including Shrines in Breath of the Wild).<br>
==Full-motion solutions==
In order to emulate that on Cemu we have several options based on either Native Cemu support or [[Cemuhook]]'s GamePad Motion Source API.
The following solutions are full-motion because they provide a three-axis gyroscope and three-axis accelerometer.
 
= Full-motion Solutions =
The following solutions are full-motion because they provide a 3-axis gyroscope and 3-axis accelerometer.


===DualShock 4 (DS4) or DualSense (DS5)===
===DualShock 4 (DS4) or DualSense (DS5)===
'''Note''': This is a very feature-rich solution because the device also includes a touchpad which can be very useful at games that do heavy usage of the GamePad touchscreen (e.g. SM3DW)
{{Note|This is a very feature-rich solution because the device also includes a touchpad which can be very useful at games that do heavy usage of the GamePad touchscreen, such as [[Super Mario 3D World]]}}
 
Installation and details:
 
Windows: [https://cemu.cfw.guide/controller-configuration Motion Control Guide]
 
Linux: [https://github.com/epigramx/ds4drv-cemuhook ds4drv-cemuhook] (rumble should also work with wine's xinput emulation by enabling it in cemu's options) or see section "Various controllers on Linux "
 
===Motion via the native support of Wiimotes (MotionPlus model)===
Motion for the emulated Wiimote Controller API option should be supported (or should be supported eventually) out of the box when the Wiimote API is used with a real Wiimote in Cemu's input options. This is necessary for games that absolutely require a Wiimote.
 
===3rd Party Alternative for Wiimotes (MotionPlus model)===
Installation and details:
 
Windows:
[https://epigramx.github.io/WiimoteHook WiimoteHook]<br>
[http://drive.google.com/uc?export=download&id=123Lq-uX2lwL2Y42iiYi6fUJVwTawiHU9 Download URL Mirror])
 
It may also run on Linux with wineconsole if .NET 4.5.2 or better is installed.
 
Linux Alternative: [https://github.com/v1993/linuxmotehook linuxmotehook]
 
===Steam Controller===
Installation and details: [https://cemu.cfw.guide/controller-configuration Motion Control Guide]
 
===Nintendo Switch Controllers===
 
Installation and details:
 
Windows: [https://cemu.cfw.guide/controller-configuration Motion Control Guide]
 
Linux: [https://github.com/joaorb64/joycond-cemuhook joycond-cemuhook] or see section "Various controllers on Linux"
 
===Various Controllers on Linux===
 
Since Linux allows its drivers to expose motion data to userspace, it is possible to read it from such modern drivers for multiple devices. This also means ever-expanding list of supported devices as drivers for them become available. Please note that only motion feature is provided, neither buttons nor touchscreen are mapped even if present. Supported devices currently include:
 
* Nintendo Switch JoyCons/ProCon
* DualShock 3/4 and DualSense controllers
 
Installation and details: [https://github.com/v1993/evdevhook evdevhook]
 
=== Phones/Tablets that include a gyroscope ===
 
Note: not all phones include a gyroscope; some include a magnetometer which is sluggish or even only an accelerometer in which case there will be no yaw motion at all.
 
[[File:Safair Iphone.png|thumb|left]]
 
===Iphone===
 
Download releases Gyro.exe (1.9) [https://github.com/hjmmc/WebGyroForCemuhook Gyro.exe]


Double click Gyro.exe
Cemu supports the motion control capabilities within the DualShock 4 and DualSense natively by setting the API to the SDLController API on Windows. On Linux, [https://github.com/epigramx/ds4drv-cemuhook ds4drv-cemuhook] is needed (rumble should also work with Wine's XInput emulation).


Run Cemu.exe and Checked Options->GamePad mation source->DSU1->By Slot
===Wiimotes===
{{Note|Original Wiimotes only contain an accelerometer, so their functionality is limited, e.g. as a "Wii Wheel" for [[Mario Kart 8]].}}
Motion for the emulated Wiimote Controller API option is supported out of the box when the Wiimote API is used with a real Wiimote in Cemu's input options. This is necessary for games that absolutely require a Wiimote.


Use your Iphone's browser (safair or chrome) open http://'''your.pc.ip''':8080 (example http://192.168.1.100:8080)
====Alternative methods====
Third-party alternatives exist for motion control support via Wiimotes (MotionPlus model), including [https://epigramx.github.io/WiimoteHook WiimoteHook] ([http://drive.google.com/uc?export=download&id=123Lq-uX2lwL2Y42iiYi6fUJVwTawiHU9 mirror]).


Load the game and enjoy it =)
On Linux, [https://github.com/v1993/linuxmotehook linuxmotehook] exists. WiimoteHook, depending on your setup, may work on Linux if wineconsole and .NET 4.5.2 or better are installed.


'''Tested on Iphone 6 IOS 12.4.5 and CEMU 1.18.0b'''
===Nintendo Switch controllers===
Cemu supports the motion control capabilities within Nintendo Switch controllers natively by setting the API to the SDLController API on Windows. On Linux, [https://github.com/joaorb64/joycond-cemuhook joycond-cemuhook] works.


===Installation and details: ===
===Various controllers on Linux===
Since Linux allows its drivers to expose motion data to userspace, it is possible to read it from such modern drivers for multiple devices. This also means ever-expanding list of supported devices as drivers for them become available. Please note that only motion feature is provided, neither buttons nor touchscreen are mapped even if present. Supported devices currently include the Nintendo Switch Joy-Cons and Pro Controller, as well as the DualShock 3, DualShock 4, and DualSense controllers via [https://github.com/v1993/evdevhook evdevhook].


Android: [https://cemuhook.sshnuke.net/padudpserver.html MotionSource]
===Mobile devices===
{{Note|Not all mobile devices include a gyroscope. Some only include a magnetometer, which runs slow within Cemu; certain devices only include an accelerometer, which does not allow for yaw motion}}


Any phone type via the browser: [https://github.com/hjmmc/WebGyroForCemuhook WebGyroForCemuhook]
===iOS===
Beginning with the iPhone 4, a gyroscope is included in every iPhone. The recommended method to utilize your iPhone for motion controls in Cemu is through [https://github.com/hjmmc/WebGyroForCemuhook WebGyroForCemuhook], which requires [[Cemuhook]]. Download the latest version, aand set the GamePad motion source to DSU1. Using your iPhone's browser, navigate to the URL provided by Gyro.exe.


Windows Phones: [https://www.reddit.com/r/cemu/comments/77ovce UWP MotionSource]
Alternatively, the [https://github.com/shiftinv/MotionSourceiOS MotionSourceiOS] app can be sideloaded to your iPhone.


iPhones via an app: [https://github.com/shiftinv/MotionSourceiOS MotionSourceiOS]
===Android===
The [https://files.sshnuke.net/net.sshnuke.dsu.MotionSource-1.1.2.apk MotionSource] app is capable of providing gyroscope data to Cemu via Cemuhook.


<br><br><br><br><br><br><br><br><br>
===Windows phones===
The only way to set up motion controls with Windows phones in Cemu is through the [https://mega.nz/file/doRQ3a6D#yB5CEL4GjCKkUhIwCdwH7BgHtvoSwAFR2CrH9ZkVNGw UWP MotionSource] app.


= Full-motion Solutions with Limitations =
==Full-motion solutions with limitations==


=== DualShock 3 ===
=== DualShock 3 ===
Note: This full-motion solution has the limitation that the ds3 gyroscope provides only yaw axis data; this makes it more responsive at yaw-turning when the device is at the standard orientation
{{Note|The DualShock 3 only provides yaw axis data.}}
 
Cemuhook's [https://cemuhook.sshnuke.net/padudpserver.html ScpToolkit patch] is capable of utilizing the gyroscope within the DualShock 3 to use in Cemu on Windows.
Windows: [https://cemuhook.sshnuke.net/padudpserver.html Cemuhook's ScpToolkit patch]
 
Linux: see section "Various controllers on Linux".
 
=== Phones/Tablets that have a magnetometer instead of a gyroscope ===
Note: these phones have full motion but it's sluggish at the yaw axis motion compared to hardware-gyroscope phones
 
Installation: Refer to the full-motion section URLs
 
= Partial solutions =
===Phones/Tablets that don't even have a magnetometer===
Note: Some low-end phones have only an accelerometer, making it impossible to have a yaw axis; that makes them unusable in several cases
 
Installation and details: Refer to the full-motion section URLs
 
===Wiimotes without MotionPlus===
Note: the original Wiimotes had only an accelerometer so they can be only useful partially, e.g. as a "Wii Wheel" for MK8
 
Installation and details: Refer to the full-motion section URLs
 
===Xbox controllers / Analog Stick motion emulation ===


Note: This solution emulates motion data with analog sticks of controllers; it is counter-intuitive in several cases; it is common to combine a phone with such controllers instead
==Partial solutions==
===Xbox controllers===
{{Note|This method emulates motion data using the analog stick on the Xbox controllers; it is counter-intuitive in several cases and not recommended}}


Installation and details: [https://github.com/quinton-ashley/cemu-no-gyro/blob/master/README.md cemu-no-gyro]
To set up an Xbox controller with motion data, download [https://github.com/quinton-ashley/cemu-no-gyro cemu-no-gyro] and Cemuhook and set the GamePad motion source to DSU1.


===Out of the box mouse solution===
===Mouse===
For this solution just right click on the game and move the mouse (including the wheel of the mouse). It is very counter-intuitive so you might want to avoid it.
Hold down the right button in a game and move the mouse allows for a full degree of movement. Control third axis scrolling the mouse wheel. This method is not recommended.


[[Category:List of tutorials]]
[[Category:List of tutorials]]

Latest revision as of 21:47, 26 January 2024

This article provides a list of methods to achieve motion controls within Cemu.

Cemu is capable of emulating motion controls within the Wii U GamePad or a Wiimote (MotionPlus model). In order to accomplish that in Cemu, various methods can be attempted, including setting up a UDP-based motion server application to send the motion data of a real motion-support controller (that Cemuhook's GamePad Motion Source API listens to), using the emulated Wiimote Controller API in Cemu's input menu in combination with a real Wiimote (MotionPlus model), or using a hacky workaround that involves right clicking and dragging within the Cemu window.

Cemu 1.18.0 and later support the Cemuhook motion API natively (Input Options > API > DSUClient) and adds native motion for the emulated Wiimote Controller API.

Note
Cemu's DSUClient API option should not yet be used due to some inconsistencies. The Wiimote Controller API should still be fine, however.

Full-motion solutions

The following solutions are full-motion because they provide a three-axis gyroscope and three-axis accelerometer.

DualShock 4 (DS4) or DualSense (DS5)

Note
This is a very feature-rich solution because the device also includes a touchpad which can be very useful at games that do heavy usage of the GamePad touchscreen, such as Super Mario 3D World

Cemu supports the motion control capabilities within the DualShock 4 and DualSense natively by setting the API to the SDLController API on Windows. On Linux, ds4drv-cemuhook is needed (rumble should also work with Wine's XInput emulation).

Wiimotes

Note
Original Wiimotes only contain an accelerometer, so their functionality is limited, e.g. as a "Wii Wheel" for Mario Kart 8.

Motion for the emulated Wiimote Controller API option is supported out of the box when the Wiimote API is used with a real Wiimote in Cemu's input options. This is necessary for games that absolutely require a Wiimote.

Alternative methods

Third-party alternatives exist for motion control support via Wiimotes (MotionPlus model), including WiimoteHook (mirror).

On Linux, linuxmotehook exists. WiimoteHook, depending on your setup, may work on Linux if wineconsole and .NET 4.5.2 or better are installed.

Nintendo Switch controllers

Cemu supports the motion control capabilities within Nintendo Switch controllers natively by setting the API to the SDLController API on Windows. On Linux, joycond-cemuhook works.

Various controllers on Linux

Since Linux allows its drivers to expose motion data to userspace, it is possible to read it from such modern drivers for multiple devices. This also means ever-expanding list of supported devices as drivers for them become available. Please note that only motion feature is provided, neither buttons nor touchscreen are mapped even if present. Supported devices currently include the Nintendo Switch Joy-Cons and Pro Controller, as well as the DualShock 3, DualShock 4, and DualSense controllers via evdevhook.

Mobile devices

Note
Not all mobile devices include a gyroscope. Some only include a magnetometer, which runs slow within Cemu; certain devices only include an accelerometer, which does not allow for yaw motion

iOS

Beginning with the iPhone 4, a gyroscope is included in every iPhone. The recommended method to utilize your iPhone for motion controls in Cemu is through WebGyroForCemuhook, which requires Cemuhook. Download the latest version, aand set the GamePad motion source to DSU1. Using your iPhone's browser, navigate to the URL provided by Gyro.exe.

Alternatively, the MotionSourceiOS app can be sideloaded to your iPhone.

Android

The MotionSource app is capable of providing gyroscope data to Cemu via Cemuhook.

Windows phones

The only way to set up motion controls with Windows phones in Cemu is through the UWP MotionSource app.

Full-motion solutions with limitations

DualShock 3

Note
The DualShock 3 only provides yaw axis data.

Cemuhook's ScpToolkit patch is capable of utilizing the gyroscope within the DualShock 3 to use in Cemu on Windows.

Partial solutions

Xbox controllers

Note
This method emulates motion data using the analog stick on the Xbox controllers; it is counter-intuitive in several cases and not recommended

To set up an Xbox controller with motion data, download cemu-no-gyro and Cemuhook and set the GamePad motion source to DSU1.

Mouse

Hold down the right button in a game and move the mouse allows for a full degree of movement. Control third axis scrolling the mouse wheel. This method is not recommended.

Retrieved from "https://wiki.cemu.info/index.php?title=Motion_controls&oldid=17411"