Player Controller

Implement 2D and 3D player character controllers in Godot 4 with GDScript.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/ftnilsson/agent-cli --skill player-controller
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Player Controller
Source: https://github.com/ftnilsson/agent-cli/tree/main/godot-development/skills/04-player-controller
Command: npx skills add https://github.com/ftnilsson/agent-cli --skill player-controller

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides robust and flexible implementations for player character controllers in Godot 4, covering both 2D and 3D game development.

Core Features & Use Cases

  • 2D & 3D Movement: Implement character movement, jumping, and gravity for various game genres.
  • State Machines: Integrate with state machines for complex character behaviors and animations.
  • Camera Systems: Includes examples for setting up camera follow systems.
  • Use Case: Quickly add responsive player movement to your Godot 4 platformer or third-person shooter.

Quick Start

Implement a 2D platformer controller using the provided GDScript example.

Frequently Asked Questions about Player Controller

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement player movement and jumping in Godot 4?

You can implement player movement and jumping in Godot 4 using GDScript with CharacterBody2D or CharacterBody3D nodes. This Skill provides ready-to-use implementations covering velocity, gravity, and jump mechanics for game development.

Can I use this Skill for both 2D and 3D Godot game development?

Yes, this Skill supports both 2D and 3D Godot game development. It provides specific GDScript implementations for CharacterBody2D and CharacterBody3D to handle character movement, jumping, and gravity across different dimensions.

Does the Godot player controller integrate with state machines for character animations?

Yes, the Godot player controller integrates with state machines to manage complex character behaviors and animations. This allows you to structure movement logic into distinct states for more flexible game development.

How do I set up a camera follow system for a 3D player character in Godot?

You can set up a camera follow system for a 3D player character using the provided GDScript examples. The Skill includes camera system configurations designed to track CharacterBody3D movements in Godot 4.

Do I need to configure input map actions before using this Godot 4 player controller?

Yes, you must configure Godot 4.3+ Input Map actions before using this player controller. The GDScript implementations rely on these predefined input actions to process character movement and jumping commands.

Player Controller for Godot 4: what limitations should I know before adding it to my project?

The primary limitation is that the Player Controller requires Godot 4.3 or higher to function correctly. Additionally, you must manually configure your project's Input Map actions for the GDScript character movement logic to work.