节点与场景

[node name="Solar" type="Node2D"]
script = ExtResource("1")

[node name="Sun" type="Node2D" parent="." groups=["sun"]]
position = Vector2(480, 290)
script = ExtResource("2")
radius = 46.0
spin_speed = 20.0

[node name="Earth" type="Node2D" parent="Sun"]
position = Vector2(190, 0)
script = ExtResource("2")
kind = 1
radius = 20.0
spin_speed = 60.0
distance = 190.0

[node name="Moon" type="Node2D" parent="Sun/Earth"]
unique_name_in_owner = true
position = Vector2(58, 0)
script = ExtResource("2")
kind = 2
radius = 8.0
spin_speed = 90.0
distance = 58.0

## 场景名 -> [场景文件, 标题, 操作提示]
const SCENES := {
	"太阳系": ["res://solar/solar.tscn", "太阳系：父子节点与变换继承", "太阳 → 地球 → 月亮，每个节点只管自己转"],
	"信号实验室": ["res://signals/signal_lab.tscn", "信号实验室：谁连接了谁", "点按钮、点宝箱，看信号沿着连线流动"],
	"生命周期": ["res://lifecycle/lifecycle.tscn", "生命周期：回调的先后顺序", "点右上角的按钮增删节点，看日志和时间轴"],
}

func _load_scene() -> void:
	var info: Array = SCENES.get(scene, SCENES["太阳系"])
	if _current != null:
		_current.queue_free()          # 旧场景在这一帧结束时才真正删除
	var packed: PackedScene = load(info[0])
	_current = packed.instantiate()    # 实例化：照着"模板"造出一棵新的节点树
	stage.add_child(_current)          # 加进场景树后，它的 _ready() 才会被调用
	hud.set_title(info[1], info[2])
	tree_view.watch(_current)
	Tuning.stat("当前场景", scene)

## preload 在脚本编译时就加载好；路径必须是写死的字符串常量。
const SOLAR_SCENE := preload("res://solar/solar.tscn")

## 也可以在检查器里把 .tscn 拖到这个属性上，不用在代码里写路径。
@export var bullet_scene: PackedScene

func spawn_solar_system(at: Vector2) -> Node2D:
	var solar := SOLAR_SCENE.instantiate() as Node2D   # 造出一棵新的节点树（还不在场景树里）
	solar.position = at                                # 进树之前就可以设置属性
	add_child(solar)                                   # 进树：这之后它的 _ready() 才会执行
	return solar

func remove_it(node: Node) -> void:
	node.queue_free()        # 推荐：本帧结束时再删除，当前正在执行的代码不受影响
	# node.free()            # 立刻删除；如果别处还在用它，会出错

signal died

@export var max_health := 100
var health := max_health


func take_damage(amount: int) -> void:
	health = maxi(health - amount, 0)
	if health == 0:
		died.emit()

## 第 2 章片段：取得别的节点的几种写法。
## 假设场景结构是：
##   Level (本脚本)
##   ├─ Player
##   │   ├─ Sprite
##   │   └─ %HealthBar   （勾选了"作为唯一名称访问"）
##   └─ Enemies
##       ├─ Slime
##       └─ Bat

var player := get_node("Player")                  # 相对路径：从自己出发，找名叫 Player 的子节点
var sprite := get_node("Player/Sprite")           # 用 / 一层层往下走
var slime := $Enemies/Slime                       # $ 是 get_node() 的简写，效果完全一样
var quoted := $"Enemies/Bat"                      # 名字里有空格或特殊字符时，加引号

var level := player.get_parent()                  # 往上走一层
var bat := slime.get_node("../Bat")               # .. 表示父节点：从 Slime 出发 → Enemies → Bat
var root_window := get_node("/root")              # 以 / 开头是绝对路径，从场景树的根（一个 Window）开始
var tuning := get_node("/root/Tuning")            # 自动加载的单例就挂在 /root 下面

var bar_long := get_node("Player/HealthBar")      # 普通写法：要写全路径
var bar := %HealthBar                             # 唯一名称：不管藏在第几层，同一场景里直接拿到
var bar_same := get_node("%HealthBar")            # 和上一行等价

@onready var sun: CelestialBody = $Sun            # 直接子节点
@onready var earth: CelestialBody = $Sun/Earth    # 用路径往下找
@onready var moon: CelestialBody = %Moon          # 场景唯一名称，不管藏多深都能直接拿到

var boss := get_node_or_null("Enemies/Boss")      # 找不到时返回 null，不报错
if boss == null:
	print("这一关没有 Boss")
if has_node("Enemies/Bat"):
	print("有蝙蝠")
var deep := find_child("Sprite", true, false)     # 按名字递归搜索（慢，别每帧调用）

## owner 决定"这个节点属于哪个场景文件"。代码里新建的节点，owner 默认是 null，
## 用 PackedScene.pack() 保存时会被漏掉；想把它一起存下来，就要手动设置 owner。
func save_with_marker(path: String) -> Error:
	var root := Node2D.new()
	root.name = "Saved"
	var marker := Marker2D.new()
	marker.name = "SpawnPoint"
	root.add_child(marker)
	marker.owner = root                  # 不设这一行，保存出的场景里就没有 SpawnPoint
	var packed := PackedScene.new()
	packed.pack(root)                    # 只打包 root 本身和 owner == root 的节点
	root.free()
	return ResourceSaver.save(packed, path)

func move_under(node: Node2D, new_parent: Node) -> void:
	node.reparent(new_parent)            # 默认保持全局变换不变：屏幕上看位置不跳
	# node.reparent(new_parent, false)   # 保持本地变换：position 数值不变，屏幕位置会跳

func _ready() -> void:
	add_to_group("enemies")                          # 代码里加组；也可以在编辑器"节点 → 分组"里加
	if is_in_group("enemies"):
		print("我是敌人")


func freeze_all_enemies() -> void:
	for enemy in get_tree().get_nodes_in_group("enemies"):   # 拿到组里所有节点
		enemy.set_process(false)


func alert_everyone() -> void:
	get_tree().call_group("enemies", "on_alarm")     # 对组里每个节点调用 on_alarm()（没有这个方法的会被跳过）


func find_the_sun() -> Node2D:
	return get_tree().get_first_node_in_group("sun") as Node2D   # 组里的第一个；组是空的就返回 null