Importing GKC

It's really easy to setup Game Kit Controller in your project! Follow the steps below to import the package and get started!

Step #1: New Project or Existing Project

New Project

If you are importing GKC into a new project then all you need to do is import the package and leave everything checked. That's it, you can skip the rest of this page, you're good to start making the game of your dreams!👾You can move onto the next section using the button below.

🎓pageTutorials

Existing Project

If you are importing GKC into an existing project then you'll need to uncheck the option to import the project settings and then continue onto Step #2.

Step #2: Add Key Mappings to the Input Manager

When importing GKC into an existing project, or if you imported GKC without the project settings then you'll need to add the axes below into the Unity Input Manager (Edit > Project Settings > Input Manager) if you want to support using a gamepad.

These are the key mappings for four players when using local multiplayer (i.e. same screen multiplayer), but you can add just one if you are not going to use the local multiplayer functionality in your game.

Don't overwrite or remove the default axes set by Unity when adding the above axes - because these are also used and will be needed by GKC.

The key mapping values for each input above are identical for each the variant (i.e. player/input), only the variant names and the joystick number are different. For example Horizontal X1 has the same values as Horizontal X2, X3 and X4 with only the input "Name" and "Joy Num" being different. On Horizontal X1 the Joy Num is Joystick 1, whereas on Horizontal X2 the Joy Num is Joystick 2 etc. For the full breakdown of input values, you can check out the "Full Breakdown" tab of each section below.

Horizontal X and Vertical Y

Mouse X and Mouse Y

Left Trigger and Right Trigger

DPad X and DPad Y

Mouse Left Click

After finishing adding the above key mappings then you will have the input for four players configured. This will allow up to four players to use the local multiplayer system.

This step will no longer be necessary in the future and adding the key mappings will be handled by an in-editor setup wizard🧙‍♂️

Step #3: Add Tags and Layers

When importing GKC into an existing project, or if you imported GKC without the project settings then you'll need to add the tags and layers used by this asset.

You can add the below tags and layers by going into the Unity Tags and Layers settings (Edit > Project Settings > Tags and Layers).