const MyNode = preload("my_node.gd")
const MyScene = preload("my_scene.tscn")

var a = MyNode.new()        # 脚本：直接 .new()
var b = MyScene.instantiate() # 场景：用 .instantiate()

# game.gd
class_name Game
extends RefCounted  # 不会出现在节点创建对话框里

const MyScene = preload("my_scene.tscn")

# 使用方：
func _ready():
    add_child(Game.MyScene.instantiate())

# 不推荐：从 Autoload 拿音效
SoundManager.play("res://sounds/jump.wav")

# 推荐：场景自己有 AudioStreamPlayer 节点
$AudioStreamPlayer.stream = preload("res://sounds/jump.wav")
$AudioStreamPlayer.play()

# my_manager.gd
class_name MyManager

static var score: int = 0  # 无需实例化，全局共享

class_name TreeNode
extends Object

var _parent: TreeNode = null
var _children := []

func _notification(p_what):
    match p_what:
        NOTIFICATION_PREDELETE:
            for child in _children:
                child.free()  # 必须手动释放！

class_name MyData
extends RefCounted

var value: int = 0
# 引用归零时自动释放，无需手动 free()

class_name CharacterStats
extends Resource

@export var max_hp: int = 100
@export var attack: int = 10
# 可以保存为 .tres 文件，Inspector 可直接编辑

# 1. @export — 编辑器拖拽，最直观
@export var player: CharacterBody2D

# 2. @onready — 场景树就绪时缓存
@onready var health_bar = $HUD/HealthBar

# 3. get_node() / $ 简写 — 硬编码路径，脆弱
var label = get_node("UI/Label")
var label = $UI/Label

# 4. 组（Group）— 一对多广播
get_tree().call_group("enemies", "stun")
var enemies = get_tree().get_nodes_in_group("enemies")

# 5. Autoload 单例 — 全局可访问
GameManager.start_level(1)

# 鸭子类型访问（直接访问，无类型检查）
node.velocity = Vector2.ZERO  # 如果没有这个属性会报错

# 安全检查方式 1：has_method()
if node.has_method("take_damage"):
    node.take_damage(10)

# 安全检查方式 2：is 关键字
if node is Enemy:
    (node as Enemy).take_damage(10)

# 安全检查方式 3：as 强转（失败返回 null）
var enemy = node as Enemy
if enemy:
    enemy.take_damage(10)

# 所有"可伤害"的节点加入 "damageable" 组
# 不需要共同基类，任何节点都能加入
for body in get_tree().get_nodes_in_group("damageable"):
    if body.has_method("take_damage"):
        body.take_damage(10)

# 错误示范：在 _process 里检测输入
func _process(delta):
    if Input.is_action_pressed("jump"):  # 可以，但浪费
        jump()

# 正确做法：用专门的输入回调
func _unhandled_input(event):
    if event.is_action_pressed("jump"):
        jump()

func _notification(what):
    match what:
        NOTIFICATION_PARENTED:
            # 节点被添加到任何父节点时触发
            # 适合：运行时动态创建的节点连接信号
            var parent = get_parent()
            if parent.has_signal("some_signal"):
                parent.some_signal.connect(_on_some_signal)
        
        NOTIFICATION_UNPARENTED:
            # 节点从父节点移除时触发
            pass
        
        NOTIFICATION_PREDELETE:
            # 引擎删除对象前触发（等同于析构函数）
            pass

func _ready():
    var timer = Timer.new()
    add_child(timer)
    timer.wait_time = 0.5
    timer.autostart = true
    timer.timeout.connect(_on_timer_timeout)

func _on_timer_timeout():
    # 每 0.5 秒执行一次
    pass

# int 枚举：比较快，但打印出来是数字
enum State { IDLE = 0, RUNNING = 1, JUMPING = 2 }
print(State.IDLE)  # 输出：0

# string 枚举（GDScript @export_enum 支持）：直接可读
@export_enum("IDLE", "RUNNING", "JUMPING") var state: String
print(state)  # 输出："IDLE"

# 错误：加入场景树后再改属性，可能触发多次 setter 或慢速更新
var node = MyNode.new()
add_child(node)
node.position = Vector2(100, 100)  # setter 可能触发不必要的更新

# 正确：加入前先设好属性
var node = MyNode.new()
node.position = Vector2(100, 100)
add_child(node)

# preload：固定资源，编译期确定
const EnemyScene = preload("res://enemy.tscn")

# load：动态路径，或需要按需卸载的大资源
var level_path = "res://levels/level_%d.tscn" % level_id
var level_scene = load(level_path)
# 用完后可释放：
level_scene = null