A third person player controller with touchscreen support for Godot 3.
Note: This project is for Godot 3 only. For the Godot 4 version please see selgesel/godot4-third-person-controller
This is a complementary code repository for my YouTube video series and it gets updated with each new video I post.
This means that the master branch always contains the latest changes, and is in sync with my latest video. If you're interested in a subset of the features or the history of the project in tandem with the corresponding videos, you can view the repo at an older tag (e.g. tag 0.0.1 corresponds to Video Part 1, tag 0.0.2 to Video Part 2 etc.).
For a list of changes you might want to see the CHANGELOG.md, and also the Releases page for each individual release (e.g. a new tag).
| Keys | Action Name | Description |
|---|---|---|
W |
move_forward |
Move/swim forward |
S |
move_backwards |
Move/swim backwards |
A |
move_left |
Move/swim to the left |
D |
move_right |
Move/swim to the right |
Esc |
ui_cancel |
(Built-in) Toggle between captured and visible mouse modes |
Mouse Wheel Up |
zoom_in |
Move the camera closer to the player |
Mouse Wheel Down |
zoom_out |
Move the camera further away from the player |
| Keys | Action Name | Description |
|---|---|---|
Q |
dash |
(Hold) Dash in the current movement direction. Hold to dash periodically |
Shift |
sprint |
(Hold) Run faster |
Ctrl |
crouch |
(Hold) Crouch. While crouching the player moves more slowly and can't jump or dash |
Space |
jump |
Jump. The player can jump multiple times |
When swimming underwater the movement direction is affected both by the horizontal and vertical angles of the camera. The player can only swim horizontally when on the water surface
| Keys | Action Name | Description |
|---|---|---|
Q |
surge |
(Hold to charge) After charging for a brief duration, surge in the current movement direction |
Ctrl |
swim_down |
(Hold) Swim downwards. When on surface, this forces the player to dive back in |
Space |
swim_up |
(Hold) Swim upwards |
Space |
jump |
(When on surface) Jump out of the water |
In touchscreen devices some actions are performed through gestures, and some are performed simply by pressing the corresponding on-screen button.
Each button displays an icon that (hopefully) explains the action that they perform, and they also appear or disappear based on whether or not they're available.
| Gesture | Context | Description |
|---|---|---|
| Drag | Thumb Stick (Left) | Move/swim in the current look direction with a speed relative to the drag distance |
| Drag | Screen | Rotate the camera |
| Pinch In (Two Fingers) | Screen | Move the camera further away from the player |
| Pinch Out (Two Fingers) | Screen | Move the camera closer to the player |
MIT