游戏引擎 / 系统课时
拆分玩家敌人与关卡职责
拆分玩家敌人与关卡职责
当玩家、敌人、关卡和界面逻辑挤在同一个脚本里,修改攻击规则就可能影响 UI 和关卡切换。本课用 Godot 4 的节点、脚本与信号拆开职责,并实现一次从敌人攻击到生命值显示的完整反馈。
学习目标
- 判断玩家、敌人、关卡和 HUD 各自应负责的行为。
- 用信号连接模块,而不是让角色脚本直接操作其他节点。
- 建立可运行的分层场景,并验证受击后的输出与界面。
让行为归属拥有它的对象
在一个简单战斗关卡中,玩家负责维护自己的生命值、受击与失败状态;敌人负责决定何时发起攻击;关卡负责创建或组装对象、安排交互关系;HUD 只负责把状态变成可见文本。
例如,敌人发起攻击时只广播伤害值,不需要寻找玩家节点。关卡把攻击信号接到玩家的受击方法;玩家扣血后发出生命值变化信号;HUD 订阅该变化并更新标签。关卡只组装关系,不接管每次扣血或逐帧刷新文字。

这也是划分脚本的判断标准:谁拥有某项状态,谁负责修改它;谁只需要获知结果,谁就订阅事件。不要因为关卡能访问所有子节点,就把玩家移动、敌人攻击和 UI 更新全部写进关卡脚本。
用四个脚本组合最小场景
创建 Level.tscn,根节点命名为 Level(Node3D),添加 Player(Node3D)、Enemy(Node3D)和 HUD(CanvasLayer)三个子节点;在 HUD 下添加 HpLabel(Label)。分别挂载下列脚本。四个文件共同构成一个可运行示例,单份脚本依赖此节点结构,不单独运行。
player.gd 只处理玩家自身状态:
extends Node3D
class_name GamePlayer
signal health_changed(value: int)
signal defeated
var hp: int = 100
func receive_damage(amount: int) -> void:
# 无效伤害和已失败状态不再触发事件。
if amount <= 0 or hp == 0:
return
hp = maxi(0, hp - amount)
health_changed.emit(hp)
if hp == 0:
defeated.emit()enemy.gd 只描述攻击意图,不直接获取玩家:
extends Node3D
class_name GameEnemy
signal attack_issued(damage: int)
func attack() -> void:
# 由关卡决定哪名玩家接收这次攻击。
attack_issued.emit(15)hud.gd 负责订阅状态并显示,不计算伤害:
extends CanvasLayer
class_name HealthHud
@onready var hp_label: Label = $HpLabel
func bind(player: GamePlayer) -> void:
# 先建立订阅,再同步已有状态,避免初始 UI 为空。
player.health_changed.connect(_update_hp)
_update_hp(player.hp)
func _update_hp(value: int) -> void:
hp_label.text = "生命值:%d" % valuelevel.gd 负责连接模块和处理关卡结果:
extends Node3D
@onready var player: GamePlayer = $Player
@onready var enemy: GameEnemy = $Enemy
@onready var hud: HealthHud = $HUD
func _ready() -> void:
# 关卡只组装依赖,实际扣血和显示由各自模块完成。
enemy.attack_issued.connect(player.receive_damage)
player.defeated.connect(_on_player_defeated)
hud.bind(player)
enemy.attack()
print("当前生命值:", player.hp)
func _on_player_defeated() -> void:
print("玩家已失败")验证运行结果与扩展边界
把 Level.tscn 设为主场景并运行。关卡先连接信号,再触发一次 15 点伤害;玩家生命值由 100 变成 85。预期输出:
当前生命值:85画面中的 HpLabel 显示“生命值:85”。这里没有“玩家直接修改界面”的调用,显示变化完全由信号传播完成。如果让敌人累计攻击七次,生命值降到 0 时还会触发一次 defeated,由关卡决定是否结束游戏或重开。
将来换成多个敌人时,只需让关卡为每个敌人连接攻击信号;换掉 HUD 时,也无需修改玩家的受击算法。职责稳定、连接集中,才是场景可复用的基础。