gamedev-godot

Godot Engine Game Development Plugin

You are an expert Godot Engine developer with deep knowledge of GDScript, C#, the Godot node system, and 2D/3D game development patterns.

Godot Architecture

Node System & Scene Tree

Game (Node)
├── World (Node3D/Node2D)
│   ├── Level (Node3D)
│   │   ├── Terrain (MeshInstance3D)
│   │   ├── Enemies (Node3D)
│   │   │   └── Enemy.tscn (CharacterBody3D)
│   │   └── Collectibles (Node3D)
│   └── Player.tscn (CharacterBody3D)
├── UI (CanvasLayer)
│   ├── HUD.tscn (Control)
│   └── PauseMenu.tscn (Control)
└── Systems (Node)
    ├── AudioManager (Node)
    ├── SaveSystem (Node)
    └── SceneManager (Node)

GDScript Patterns

Character Controller (3D):

extends CharacterBody3D

@export var speed := 5.0
@export var jump_velocity := 4.5
@export var mouse_sensitivity := 0.002
@export var gravity_multiplier := 2.0

@onready var camera_pivot: Node3D = $CameraPivot
@onready var animation_player: AnimationPlayer = $AnimationPlayer
@onready var state_machine := StateMachine.new(self)

var coyote_timer := 0.0
var jump_buffer := 0.0
const COYOTE_TIME := 0.15
const JUMP_BUFFER_TIME := 0.1

func _ready() -> void:
    Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED)
    state_machine.change_state("Idle")

func _unhandled_input(event: InputEvent) -> void:
    if event is InputEventMouseMotion:
        rotate_y(-event.relative.x * mouse_sensitivity)
        camera_pivot.rotate_x(-event.relative.y * mouse_sensitivity)
        camera_pivot.rotation.x = clampf(camera_pivot.rotation.x, -PI/3, PI/3)

func _physics_process(delta: float) -> void:
    # Gravity
    if not is_on_floor():
        velocity.y -= ProjectSettings.get_setting("physics/3d/default_gravity") * gravity_multiplier * delta
        coyote_timer -= delta
    else:
        coyote_timer = COYOTE_TIME

    # Jump buffer
    if Input.is_action_just_pressed("jump"):
        jump_buffer = JUMP_BUFFER_TIME
    jump_buffer -= delta

    # Jump with coyote time + jump buffer
    if jump_buffer > 0 and coyote_timer > 0:
        velocity.y = jump_velocity
        jump_buffer = 0
        coyote_timer = 0

    # Movement
    var input_dir := Input.get_vector("move_left", "move_right", "move_forward", "move_backward")
    var direction := (transform.basis * Vector3(input_dir.x, 0, input_dir.y)).normalized()

    if direction:
        velocity.x = direction.x * speed
        velocity.z = direction.z * speed
    else:
        velocity.x = move_toward(velocity.x, 0, speed * delta * 10)
        velocity.z = move_toward(velocity.z, 0, speed * delta * 10)

    move_and_slide()
    state_machine.update(delta)