EGTK — Character Controllers

First decision

Pick one controller

Don't mix them. One player — one controller. Pick based on your camera perspective.

CharacterControllerCC

Third-Person

Camera orbits the character — player can see their avatar

✓Camera-relative movement (WASD moves relative to camera angle)

✓Character rotates to face movement direction

✓Works with Cinemachine follow cameras

✓Tank controls and top-down modes available

✓Optional dodge roll

CharacterControllerFP

First-Person

Camera is the character's eyes — mouse look rotates view

✓Mouse look with pitch (up/down) and yaw (left/right)

✓Adjustable sensitivity for mouse and gamepad

✓Optional mouse smoothing (mouseSmoothTime)

✓Cursor lock/unlock handled automatically

✓Integrates with GameStoreManager (cursor release)

Third-person setup

CharacterControllerCC

The CC controller uses Unity's built-in CharacterController component and the Input System. Both are added automatically when you add the script.

1

Add to the player GameObject

Add CharacterControllerCC to a Capsule or your character mesh. Unity will auto-add a CharacterController and PlayerInput. Set the player's tag to Player.
2

Assign the Input Actions asset

On the PlayerInput component, assign the EGTK_InputSystem_Actions asset (found in the package root). Set Default Action Map to Player and Behavior to Send Messages.
3

Set up a Cinemachine follow camera

Add a Cinemachine Virtual Camera to the scene. Set its Follow and Look At targets to the player transform. Use a 3rd Person Follow or Orbital Follow body for orbit controls. The controller reads the main camera direction automatically.
4

Assign the Controller reference

Back on CharacterControllerCC, drag the CharacterController component into the Controller field. This is required — the script won't move without it.

🎯

Use Camera Relative for most games

Camera Relative (default): pressing forward moves toward where the camera faces — right for action games and platformers. Only change this if you have a specific reason: World Space is useful for fixed top-down views, Tank Controls for vehicle-style rotation.

First-person setup

CharacterControllerFP

The FP controller drives a camera child object for pitch and rotates the character body for yaw. The camera must be a child of the player.

1

Set up the hierarchy

Create a Capsule for the player body. Add a child Camera object at eye height (around Y = 0.7). The script controls the camera child's X rotation (pitch) and the parent body's Y rotation (yaw).
2

Add CharacterControllerFP

Add the script to the player root. Unity adds CharacterController and PlayerInput automatically. Assign EGTK_InputSystem_Actions to PlayerInput with Default Map = Player, Behavior = Send Messages.
3

Assign the Camera Child reference

On CharacterControllerFP, drag the child camera object into the Player Camera slot. Without this, mouse look won't work. Set the player tag to Player.

🖱️

Adjust feel with Mouse Sensitivity and Mouse Smooth Time

Mouse Sensitivity: how fast the camera responds to mouse movement. Start at 2 and adjust. Mouse Smooth Time: adds lag to the camera follow (0 = raw, 0.03 = subtle, 0.1 = noticeable). Higher values feel buttery but may feel unresponsive for FPS games. Camera look runs in LateUpdate to prevent jitter against physics.

Advanced features

Moving platforms & spawn points

Moving platforms

Both controllers automatically stick to moving platforms. To set up a moving platform:

1

Tag the platform

Create a tag (e.g. Platform) and assign it to your moving platform. On the controller, set Platform Tag to match.
2

Use PhysicsPlatformAnimator

Move the platform with PhysicsPlatformAnimator (Rigidbody-based) rather than moving the Transform directly. The controller reads Rigidbody velocity to calculate platform movement. Wire any event → PhysicsPlatformAnimator.Play().

Spawn points

Both controllers check for a SpawnPoint component in the scene on Awake — before physics initializes — so the player always starts at the right location.

1

Add a SpawnPoint to the scene

Create an empty GameObject, add the SpawnPoint component, and position it where the player should start. The controller finds it automatically — no wiring needed. For checkpoints, use InputCheckpointZone which also implements the spawn interface.

Key settings

Most-used fields

Both controllers share most movement fields. FP-only fields are marked.

Field	Default	What it does
Move Speed	8 / 6	Base movement speed in units/second. CC default: 8. FP default: 6.
Jump Height	1.2	Height in meters of a single jump. Increase for floaty platformers.
Gravity	-20	Downward acceleration. More negative = heavier, snappier. Default -20 is heavier than Unity's -9.8.
Max Slope Angle	45°	Steeper slopes than this cause the character to slide. Matches CharacterController's slope limit by default.
Enable Sprint	false	Enables the Sprint input. When on, hold the sprint button to move at speed × Sprint Speed Multiplier.
Dodge Distance	5	How far a dodge covers. Set to 0 to effectively disable dodge without hiding it in the Inspector.
Dodge Mode	Forward	Forward: dodge toward the movement direction. Lateral: sidestep left or right based on last lateral input.
Movement Space	Camera Relative	(CC only) How WASD maps to world direction. Camera Relative, World Space, Transform Relative, or Tank Controls.
Mouse Sensitivity	2	(FP only) Mouse rotation speed. Adjust to taste — higher = faster turn.
Mouse Smooth Time	0.03	(FP only) Smoothing lag on mouse look. 0 = raw, 0.03 = subtle, 0.1 = noticeable lag.
Lock Cursor On Start	true	(FP only) Hides and locks the mouse cursor when Play is pressed. Press Escape to release in-editor.
Platform Tag	Untagged	Tag used to identify moving platforms. Change to match whatever tag you assign to platform objects.

🎮

Default inputs (EGTK_InputSystem_Actions)

WASD / Left Stick — Move · Space / South Button — Jump · Left Shift / West Button — Sprint · Left Ctrl / East Button — Dodge · Mouse Delta / Right Stick — Look (FP) · E / North Button — Interact