Skip to content

User Guide

Jump to bottom
ZadenRB edited this page Apr 26, 2025 · 4 revisions

Overview

Welcome to the OpenGCC user guide! This page will walk you through setting up a new controller and provide information on the configuration options offered by OpenGCC. All of the button combinations listed in the user guide must be held for 3 seconds. Upon activating a combination, both triggers will output values as if they are fully depressed for 1.5 seconds. While you can simply connect your controller to a console running a game where trigger presses are visible, I recommend using a tool like SmashScope's "Controller Test" for an easier time.

Profiles (START+A/B on connect)

OpenGCC controllers support two separate configuration profiles, A & B, on a controller. Each profile has separate button mappings and trigger configurations, so that you can use different button layouts or trigger options in different games, or on different consoles. When your controller is connected to power, it will by default use the same profile that was last used. To choose a different profile, hold START and the desired profile button (A or B) while plugging in your controller.

First-time Setup

In order to get a new controller to a fully functional state, the sticks simply need to be calibrated. Perform the following steps:

  1. Connect the controller to a console or adapter
  2. Toggle safe mode off (Hold START+X+Y+A+Z for 3 seconds)
  3. Configure the left stick (Hold START+X+LT for 3 seconds, see Configure Stick for details)
  4. Configure the right stick (Hold START+X+RT for 3 seconds, see Configure Stick for details)
  5. Perform any desired additional configuration
  6. Disconnect and reconnect the controller to confirm that your configuration was saved
  7. Optional: Reconnect while holding Start+B to load your secondary profile & configure it

Toggle Safe Mode (START+Y+A+Z)

Every time an OpenGCC controller is powered on, it is in safe mode. This, along with the requirement to hold configuration combinations for 3 seconds, prevents accidentally entering configuration modes. Before any of the button combinations below will work, you must toggle safe mode off by holding START+X+Y+A+Z for 3 seconds.

Swap Button Mapping (START+X+A)

OpenGCC supports one-to-one swapping of button outputs. By performing multiple swaps, you can set any button layout you'd like. The only caveat is that if a trigger's digital press is swapped with another button, it will no longer output analog values. For example, In order to have the following remappings:

Physical Button Controller Output
A B
B X
X A

I could first swap the A and B buttons, and then swap B and X. The important point here is that when performing a button swap, you are swapping the buttons' current mappings. If a button has already been remapped (after our first swap, B outputs A), swapping it with another button (X) will pass along it's mapping (A) rather than the physical button (B).

The procedure for performing a swap is:

  1. Hold START+X+A for 3 seconds
  2. Press the first button you want to swap, then release
  3. Press the second button you want to swap, then release The two buttons' mappings will be swapped

Configure Triggers (START+X+Z)

Each trigger has two settings, a mode and a configured value. The mode determines the triggers' general behavior, while the configured value tweaks the behavior of the chosen mode. The configured value is restricted to 49-209 inclusive.

Trigger Modes

OEM (0)

This is the default mode, and behaves the same as an OEM GameCube controller. The controller outputs an analog value based on how far the trigger is pressed, as well as a digital output when fully pressed.

Digital only (1)

The analog output for the trigger is disabled. The digital output is enabled.

Analog only (2)

The digital output for the trigger is disabled. The analog output is enabled.

Capped analog (3)

The analog output for the trigger is capped at the configured value. Pressing the trigger beyond that value will not increase the analog output, but when fully pressed the digital output will occur.

Fixed analog on digital press (4)

The digital output is disabled. The normal analog output for the trigger is disabled. When the trigger is fully pressed, the analog output will be set to the configured value.

Fixed analog and digital on digital press (5)

The normal analog output for the trigger is disabled. The digital output is enabled. When the trigger is fully pressed, the analog output will be set to the configured value along with the digital output.

Multiplied analog (6)

The analog output will scale based on the configured value, allowing higher values to be reached with a lighter press. The analog output multiplier is calculated with the formula (value * .0125) + .3875. With the minimum value of 49, this multiplier is 1, and the analog output will be unaffected. At the maximum value of 209, this multiplier is 3.

The procedure to configure the triggers is:

  1. Hold START+X+Z for 3 seconds to enter trigger configuration mode
  2. Hold the trigger you want to configure
    • The left trigger will output the held trigger's mode, and the right trigger will output the held trigger's configured value
    • Press A/B to increase/decrease the trigger mode by 1
    • Press DPAD-UP/DPAD-DOWN to increase/decrease the configured value by 1
    • Press DPAD-RIGHT/DPAD-LEFT to increase/decrease the configured value by 10
  3. Release all buttons and press START to save and exit, or X to exit without saving

Configure Stick (START+X+LT/RT)

The procedure to configure a stick is:

  1. Hold START+X+LT/RT for 3 seconds to enter stick configuration mode
    • Use LT to configure the left stick, and RT to configure the right stick
  2. Configure the stick's range
    • The left trigger will output the stick's range
    • Press DPAD-UP/DPAD-DOWN to increase/decrease the range by 1
    • Press DPAD-RIGHT/DPAD-LEFT to increase/decrease the range by 10
  3. Release all buttons and press Z to continue to calibration, START to save and exit, or X to exit without saving
  4. Calibrate the stick
    • The stick that is not being configured will display where to place the stick for measurement
    • Move the stick to the appropriate position and press Z to measure
    • Press A to skip a measurement
    • Press B to undo a measurement
  5. When calibration is complete, the configuration will automatically save and exit
    • During calibration, release all buttons and press START to save and exit, or X to exit without saving

Factory Reset (START+Y+B)

Hold START+Y+B for 3 seconds to clear all configuration data

Clone this wiki locally