This is a cache of https://vccplus.brianholman.com/manuals/users-handbook/controllers/. It is a snapshot of the page as it appeared on 2026-11-21T00:00:47.950+0000.
Connect a controller · The VCC Plus User’s Handbook · VCC Plus
← Manual LibraryVCC Plus 3.7.1 · Reading on the web

Try the exercises in VCC Plus. Example links download files here; open them in the app to work beside the emulator.

The complete book · PDF editionBook 4: The VCC Plus User’s Handbook

77 pages · VCC Plus 3.7.1 · Keep a copy to read or print.

Download PDF
Contents

Chapter 4 of 10

Connect a controller

A game can wait at its opening screen even while you are moving a perfectly good joystick. There are two places to look. First, does VCC Plus see movement from your Mac device? Second, is that movement reaching the CoCo port the game reads? You can check both without guessing or restarting the game.

Choose the port the game reads

Open Input → Keyboard and Joysticks…. In System view you can also click the illustrated joystick, or choose it from Devices. The input window shows Left CoCo joystick above Right CoCo joystick. These are the two sockets on the emulated computer. A controller's own left and right thumbsticks are parts of a single device.

Look for a port in the game's instructions, readme or manual. Choose the input source beside that port. None leaves it centered with buttons released. Keyboard, Mouse and Controller give you three ways to send movement into the socket. Changes apply immediately and are remembered. Note any previous assignment so you can put it back.

Keyboard and Joysticks shows separate CoCo ports. With fresh settings and one connected DualSense controller, Right selects that controller and Left remains None.

If you don't know which port a game reads, try one, then use Swap assignments to exchange the complete left and right setups, including their button choices. Click the live CoCo display before testing the game. Some games accept a keyboard command on the title screen and use the joystick only during play.

Follow a thumbstick and a fire button

  1. Connect your USB controller or pair it in the Mac's Bluetooth settings. For a Logitech F310 on USB, set its underside switch to D and reconnect it. Open Controller Test in the input window. The connected device name should appear.
  2. Move a stick and let it return to center. The Left and Right readings in Controller Test are the controller's two sticks. Watch one pair change and settle near zero. Press the physical button you want for firing; note which number appears under Buttons. This preview works before you assign the device to a CoCo port.
  3. In the chosen CoCo port card select Controller. Expand Options and pick the device by name. The left stick is the usual starting point; choose Use right stick if you prefer. Set Fire 1 to the number you just saw. If the software supports a second button, repeat for Fire 2.
  4. Look at the port card's X, Y and Fire readings. Display focus may be needed for delivery to the guest. Centered values are around 31. Moving left then right should take X toward 0 and 63; Fire 1 goes from up to down while held. This check follows the movement all the way to the configured port. Some games use only one fire button.
  5. If a resting stick jitters around the center, increase Dead zone a little. This ignores a small area around center. Too large a dead zone means you must push farther before movement begins. Test a small change, release the stick, and bring focus back to the game.

If the controller disappears, the assigned row can say Remembered controller — disconnected. The guest receives a centered stick with released buttons. Reconnect the device and check the readings again. A second device won't silently take over the missing one.

Play with a keyboard or mouse

With Keyboard chosen for a port, expand Options → Keys. The app offers the following layouts. The final two keys are Fire 1 and Fire 2, respectively.

Layout Up, down, left, right Fire buttons
Arrows Arrow keys in those directions Z, X
Letter keys W, S, A, D F, G
Numeric keypad Keypad 8, 2, 4, 6 Keypad 0, decimal

Focus the CoCo display. Hold a direction for full deflection; release it to center. Those keys are now serving as a joystick. If typing Z at the BASIC prompt seems to do nothing, check both port assignments before changing the keyboard mode. Select None or a different source for the port to give its keys back to ordinary guest typing. If mapping both ports to the keyboard, choose different groups of keys.

With Mouse chosen for a port, click the CoCo picture and move over its area. The pointer's position sets the axes. Left is low X and the bottom is high Y. A left click is Fire 1 and a right click is Fire 2. Leaving the display centers the input and releases the buttons. The pointer still operates the Mac controls when you move back to them.

For a game-independent check, Point the right-port scanner uses the tested RADAR example. Hold left, center or right and tap A. The CoCo reports WEST SIGNAL, CENTER SIGNAL or EAST SIGNAL. Use the arrow-key layout for this exercise so A stays available to the program. To see left and right readings side by side, use Find the joystick port a game reads.

Match the guest's CoCo interface

Options → CoCo interface tells the emulated software which joystick interface to read. Start with Standard for games. Software high resolution, Tandy high resolution and CoCoMax are for programs that expect those ways of measuring input. Choose a special interface when the program's instructions call for it. Pairing a modern gamepad over Bluetooth, by itself, gives you no reason to change this setting.

If the character on screen still stands still, check in order. A blank Controller Test suggests a connection problem. A moving device preview but a still port preview points to the selected source, device or stick. A moving port preview with no response in the game points to focus, the chosen port, the game's start command or its expected CoCo interface. Restore the previous source and interface when you finish experimenting.

Original VCC Plus manuals © 2026 Brian K. Holman. Third-party references retain their authors’ copyrights and licenses. Artwork notices. Edition 3.7.1; source and export identity. Printable edition: PDF source and export identity.

A closer look

Open original