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.

🎓Tutorials

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.

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

Horizontal X1 (X2, X3, X4) and Vertical Y1 (Y2, Y3, Y4) mappings

Mouse X and Mouse Y

Mouse X1 (X2, X3, X4) and Mouse Y1 (Y2, Y3, Y4) mappings

Left Trigger and Right Trigger

Left Trigger 1 (2, 3, 4) and Right Trigger 1 (2, 3, 4) mappings

DPad X and DPad Y

DPad X1 (X2, X3, X4) and DPad Y1 (Y2, Y3, Y4) mappings

Mouse Left Click

Mouse Left Click mapping

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).

Tags

Tag No

Tag Value

Tag 0

box

Tag 1

sphere

Tag 2

moving

Tag 3

enemy

Tag 4

friend

Tag 5

device

Tag 6

inventory

Tag 7

vehicle

Layers

Layer No

Layer Value

#1

gravityObjects

#2

Armor Surface

#3

turrets

#4

player

#5

radar

#6

Scanner

#7

vehicle

#8

inventory

#9

npc

#10

weapons

#11

device

#12

Terrain

#13

Point&Click

#14

Dynamic Split Screen

#15

Transparent Mesh

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

Last updated

Was this helpful?