C ABI Entry point called by crystal_bridge when game library is loaded

Global convenience helper to load resources from Godot VFS

Global convenience helper to preload resources from Godot VFS

Top-level math constructors

Convenience macro to designate a class as abstract in Godot.

Top-level await macro for intuitive GDScript-like calling syntax Usage: await(enemy.died) await(enemy.died, timeout_sec: 2.0) await(enemy, "died") await(enemy, "died", timeout_sec: 2.0) await(timer.timeout) await(timer) await(1.5) await(2.seconds)

Categories group top-level inspector sections in Godot.

May be used standalone or as a block scoping exported properties:

export_category "Combat" do
  @[Export]
  property health : Int32 = 100
end

Groups exported properties in the Godot inspector.

May be used standalone or as a block scoping exported properties:

export_group "Movement", prefix: "move_" do
  @[Export]
  property move_speed : Float32 = 5.0_f32
end

Subgroups exported properties under the current inspector group.

May be used standalone or as a block scoping exported properties:

export_subgroup "Advanced", prefix: "adv_" do
  @[Export]
  property adv_friction : Float32 = 0.1_f32
end

Declares a custom RefCounted or generic Godot engine class registered with ClassDB. Defaults to inheriting RefCounted when no parent is specified. Can be called with or without a block (e.g. gdclass MyState).

gdclass StateMachine < RefCounted do
  @[Export]
  property current_state : String = "idle"
end

gdclass SimpleState

Declaratively assigns the node to one or more scene tree groups upon _ready.

node Player < CharacterBody3D do
  group "players", "flammable"
end

Convenience macro to set a custom icon path in the editor.

The primary node macro: Usage: node MyNode node MyNode do # defaults to Godot::Node end

node Player < CharacterBody3D node Player < CharacterBody3D do # inherits Godot::CharacterBody3D end

Creates a compile-time verified Godot::NodePath

Declares an @onready node property initialized from the scene tree during _ready.

Declares a lazy-cached node property matching Godot's @onready pattern.

Supports:

1. Auto-inferred path: onready sprite_2d, Sprite2D (fetches "Sprite2D")
2. Scene Unique Node: onready camera, Camera2D, "%MainCamera"
3. Explicit path: onready sprite, Sprite2D, "Visuals/Sprite2D"

Declares a custom Godot Resource class registered with ClassDB and EditorHelp. Supports @[Export] properties, custom signals, and serialization to .tres.

resource ItemData < Resource do
  @[Export]
  property item_name : String = "Health Potion"

Declares a custom Resource subclass registered with ClassDB.
Defaults to inheriting `Resource` when no parent is specified.
Can be called with or without a block (e.g. `resource MyItem`).

```crystal
resource CustomPotion do
  @[Export]
  property item_name : String = "Health Potion"

  @[Export]
  property value : Int32 = 50
end

resource ShortItem

Declares a custom Godot signal and generates a type-safe emit_<signal_name> helper method.

class Player < Godot::CharacterBody3D
  signal health_changed(new_health : Int32, max_health : Int32)
  signal died

  def take_damage(amount : Int32)
    emit_health_changed(50, 100)
    emit_died if amount >= 100
  end
end

Convenience macro to mark extension library unloading behavior.

Declares a lazy-cached Scene Unique Node property (Godot 4 %Node syntax).

Examples:

unique_node health_bar, ProgressBar # fetches "%HealthBar"
unique_node main_hud, CanvasLayer, "HUD" # fetches "%HUD"

Convenience macro to suppress compiler warnings.