Issues using a controller, mouse or keyboard

If guests are having issues controlling when in Parsec, here are some things to try. Note that if the host is having issues controlling outside of Parsec, it's not a Parsec issue.

Keyboard and mouse issues

Issues with Arcade beta

Arcade does not give guests an actual keyboard or mouse. The guest's keyboard has a specific set of keys (shown below) that will act like a controller on the host, and the mouse has no function at all.

arcade_keyboard_layout.png

If the guests are having issues controlling with the keyboard on Arcade even using the correct keys shown above, look into the "Controller issues" part of this article instead. If you want guests to use the actual keyboard and mouse, use desktop sharing at the Computers tab.

People are controlling the same player

If one player is on keyboard and the other on controller, some games like Cuphead require the person on keyboard to join the game first, instead of the controller first.

If multiple people are using the keyboard or mouse, note that, unlike controllers, all keyboards and mouses are seen as one, because Windows and the game can't tell which belongs to who.

Some games (like Overcooked) let you use different keys for each player (e.g. player 1 uses WASD, player 2 uses arrows). It's not very common, but you can check the settings for your game to see if it allows for it.

If you absolutely must, you can check a tutorial on how to emulate a controller using the keyboard.

Guests weren't given permission to use the keyboard or mouse

The host needs to give permission by clicking the profile picture of the people connected at the bottom of Parsec.

give_permissions.png

Unable to control only in certain programs and situations

Parsec could be lacking permission. The person hosting should see this article. If that is not the case and you're playing a game with an anti-cheat, it might be blocking Parsec's inputs.

Some games are confirmed to have issues, like Valorant (anti-cheat), Resident Evil 7 and Mortal Kombat X.

 

Controller issues

People are controlling the same player

Some games will require you to do additional steps in order to split the controls. Keep in mind that if your game doesn't actually have a split-screen mode, you can't do anything about it.

  • Enter the Gungeon: You need to talk to the purple Cultist in the hub to enable coop
  • A Hat in Time: You need to enable coop in the pause menu
  • Cuphead: If one person is playing on keyboard, they must be the one that joins the game first, instead of the person with the controller joining first
  • Emulators: Make sure you haven't misconfigured the emulator. Everyone's controllers may be going to the same port in the console being emulated. If you've configured the emulator correctly, then there may be additional actions in-game just like the games listed above

As long as the inputs are working, Parsec is passing the controller, and it's up to your game/emulator to use them properly. Parsec's controllers don't do anything special, and they work as if an ordinary xbox controller was plugged on the host via USB. If you're confused about how to configure your game/emulator or whether the game has multiplayer, look it up online.

People can't control the game

The host should do the following to check whether Parsec is working correctly:

  • Open gamepad-tester.com on the host PC
  • Do the following on the host, depending on where the game is being hosted:
    • Arcade: Keep both the game and browser visible in the screen, and click on the game so that Parsec can send inputs
    • Desktop sharing: If Parsec settings > Approved apps is enabled, approve your internet browser there so that Parsec can send inputs
  • Ask the people who are connected to press buttons, then check if it shows on the website

 

It is working on the website

If it's working, then Parsec is passing the controller, and the rest is up to your game/emulator. Most emulators need you to configure the controllers in their settings. Some games require you to enable multiplayer somewhere, or configure it further.

Parsec's controllers don't do anything special, and work as if an ordinary xbox controller was plugged on the host via USB. If you're confused about how to configure your game/emulator or whether the game has multiplayer, look it up online.

Note for Arcade Beta: Some games don't detect controllers that got plugged in after the game was opened. This means you might only be able to play it with desktop sharing.

 

It is not working on the website

In case it's not working on the host's gamepad-tester, chances are the controller is not working properly on the guest, or the drivers on the host are not working properly. Check the things below for more details.

 

Check that the controller is working on the guest

The guests can go to Settings > Gamepad to check that Parsec recognizes the controller. If it's not showing up, check if the controller is properly plugged in. If the controller isn't working properly on the guest, then Parsec won't see any on the host.

controller_settings.png

If guests cannot see their controllers regardless, here's what can be attempted depending on their operating system.

Windows macOS Android Raspberry Pi  Linux

Most popular controllers should work just fine, especially Xbox controllers. However, guests can use a program below for non-Xbox controllers that will convert it to Xinput (the Xbox controller API), which should guarantee that it works.

  • Dualshock 4: DS4Windows
  • Dualshock 3: Scptoolkit
  • Steam Controller: See this article
  • Switch (Pro Controller and Joy-Cons): BetterJoy
  • Wii U Pro Controller: WiinUSoft
  • Wiimote: WiiUSoft or Wiimotehook

Reinstall the controller drivers on the host

In case you are certain things are working properly on the guest, the host can reinstall Parsec and restart the computer. That should reinstall the controller drivers, but if that didn't work, the host can also try to install the drivers directly from ViGEmBus' github releases and restart the computer.

 

Check if you have drivers that conflict with Parsec

On the host, go to Device Manager (Press Windows key + R, type devmgmt.msc, press Enter), and check if you see something named SCP Virtual Bus in the System devices section. This is used for Dualshock 3 controllers, but it may conflict with our drivers. If you have it, try uninstalling it, restart the computer, and test if your issue is fixed.

 

Controller is mapped wrong

The guests can go to Settings > Gamepad to remap it.

controller_settings.png

If things are mapped properly on the guest, the rest is up to how the host's game uses it. If it is not correctly mapped in Parsec's settings and you cannot remap it for whatever reason. Here's what you can look into.

Windows macOS

Most popular controllers should work just fine, especially Xbox controllers. However, guests can try using a program for non-Xbox controllers that will convert it to Xinput (the Xbox controller API), which should guarantee that the mapping works properly in case it's not already doing so.

  • Dualshock 4: DS4Windows
  • Dualshock 3: Scptoolkit
  • Steam Controller: See this article
  • Switch (Pro Controller and Joy-Cons): BetterJoy
  • Wii U Pro Controller: WiinUSoft
  • Wiimote: WiinUSoft or Wiimotehook
Controller is acting as a mouse/keyboard

Steam has an option that sets xbox controllers to desktop mode by default, making them act like a mouse and keyboard. Disable it here.