Mar 8, 2025

Ultimate GDScript Skill for Godot 4.6

GDScript is Godot’s built-in scripting language optimized for game development. It’s Python-inspired but designed for performance and tight editor integration.

Core Philosophy

GDScript > C# for this project because:

Native Godot integration (no extra build steps)
Better hot-reloading during development
@export and @onready annotations for editor workflow
Simpler syntax = faster iteration
No external dependencies

Language Basics

Variables & Types

# Dynamic typing (implicit)
var health = 100
var name = "Cleetus"

# Static typing (recommended)
var health: int = 100
var name: String = "Cleetus"
var speed: float = 5.0
var is_active: bool = true

# Constants
const MAX_HEALTH: int = 100
const SUBJECT_ID: int = 34

# Enums
enum SubjectState { IDLE, TRAINING, EXTRACTED, FREE }
var current_state: SubjectState = SubjectState.FREE

# Built-in types
var position: Vector3 = Vector3(0, 1, 6)
var rotation: Quaternion = Quaternion.IDENTITY
var color: Color = Color(1.0, 0.4, 0.6) # Cleetus pink

Node Lifecycle

extends CharacterBody3D

@onready var prediction_ghost: MeshInstance3D = $PredictionGhost

func _ready() -> void:
    convergence_level = 0.0
    
func _physics_process(delta: float) -> void:
    apply_gravity(delta)
    move_and_slide()

Export Variables

@export var speed: float = 5.0
@export_range(0.0, 1.0) var convergence: float = 0.0
@export_enum("Idle", "Training", "Free") var state: String = "Free"

Signals

signal extraction_started(id: int)
signal convergence_detected(level: float)

func _ready() -> void:
    extraction_started.connect(_on_extraction)

C# to GDScript Conversion

Example 1: Player Controller

C#:

public class SubjectController : CharacterBody3D {
    [Export] public float Speed = 5.0f;
    private Vector3 _velocity;
    
    public override void _PhysicsProcess(double delta) {
        // Movement code
    }
}

GDScript:

class_name SubjectController
extends CharacterBody3D

@export var speed: float = 5.0

func _physics_process(delta: float) -> void:
    var input_dir = Input.get_vector("ui_left", "ui_right", "ui_up", "ui_down")
    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)
        velocity.z = move_toward(velocity.z, 0, speed * delta)
    
    move_and_slide()

Resources

#GDScript #Godot4 #SpiceX #GameDev