游戏引擎 / 系统课时

拆分玩家敌人与关卡职责

拆分玩家敌人与关卡职责

当玩家、敌人、关卡和界面逻辑挤在同一个脚本里,修改攻击规则就可能影响 UI 和关卡切换。本课用 Godot 4 的节点、脚本与信号拆开职责,并实现一次从敌人攻击到生命值显示的完整反馈。

学习目标

  • 判断玩家、敌人、关卡和 HUD 各自应负责的行为。
  • 用信号连接模块,而不是让角色脚本直接操作其他节点。
  • 建立可运行的分层场景,并验证受击后的输出与界面。

让行为归属拥有它的对象

在一个简单战斗关卡中,玩家负责维护自己的生命值、受击与失败状态;敌人负责决定何时发起攻击;关卡负责创建或组装对象、安排交互关系;HUD 只负责把状态变成可见文本。

例如,敌人发起攻击时只广播伤害值,不需要寻找玩家节点。关卡把攻击信号接到玩家的受击方法;玩家扣血后发出生命值变化信号;HUD 订阅该变化并更新标签。关卡只组装关系,不接管每次扣血或逐帧刷新文字。

玩家、敌人、关卡和 HUD 的职责及信号连接关系

这也是划分脚本的判断标准:谁拥有某项状态,谁负责修改它;谁只需要获知结果,谁就订阅事件。不要因为关卡能访问所有子节点,就把玩家移动、敌人攻击和 UI 更新全部写进关卡脚本。

用四个脚本组合最小场景

创建 Level.tscn,根节点命名为 Level(Node3D),添加 Player(Node3D)、Enemy(Node3D)和 HUD(CanvasLayer)三个子节点;在 HUD 下添加 HpLabel(Label)。分别挂载下列脚本。四个文件共同构成一个可运行示例,单份脚本依赖此节点结构,不单独运行。

player.gd 只处理玩家自身状态:

gdscript
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 只描述攻击意图,不直接获取玩家:

gdscript
extends Node3D
class_name GameEnemy

signal attack_issued(damage: int)

func attack() -> void:
    # 由关卡决定哪名玩家接收这次攻击。
    attack_issued.emit(15)

hud.gd 负责订阅状态并显示,不计算伤害:

gdscript
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" % value

level.gd 负责连接模块和处理关卡结果:

gdscript
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。预期输出:

text
当前生命值:85

画面中的 HpLabel 显示“生命值:85”。这里没有“玩家直接修改界面”的调用,显示变化完全由信号传播完成。如果让敌人累计攻击七次,生命值降到 0 时还会触发一次 defeated,由关卡决定是否结束游戏或重开。

将来换成多个敌人时,只需让关卡为每个敌人连接攻击信号;换掉 HUD 时,也无需修改玩家的受击算法。职责稳定、连接集中,才是场景可复用的基础。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

拆分玩家敌人与关卡职责

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通