跳转至

GFProjectile2D

API Reference / Combat / 类索引

  • 路径：addons/gf/extensions/combat/projectiles/gf_projectile_2d.gd
  • 模块：Combat
  • 继承：GFHitBox2D
  • API：public
  • 类别：运行时句柄 (runtime_handle)
  • 首次版本：3.17.0

可组合移动策略的 2D 发射体命中节点。 它继承 GFHitBox2D，命中仍通过 GFCombatHitContext 发送给 receive_hit()。 节点只负责移动、寿命和碰撞触发，不解释伤害、阵营或生命值规则。

成员概览

类型 名称 签名
信号 projectile_launched signal projectile_launched(projectile: GFProjectile2D)
信号 projectile_finished signal projectile_finished(projectile: GFProjectile2D, reason: StringName)
属性 auto_launch_on_ready var auto_launch_on_ready: bool = true
属性 motion var motion: Resource = null
属性 lifetime_policy var lifetime_policy: Resource = null
属性 finish_on_impact var finish_on_impact: bool = true
属性 queue_free_on_finish var queue_free_on_finish: bool = true
方法 launch func launch(projectile_context: Dictionary = {}) -> void:
方法 finish func finish(reason: StringName = &"finished") -> void:
方法 is_projectile_active func is_projectile_active() -> bool:
方法 get_elapsed_seconds func get_elapsed_seconds() -> float:
方法 get_projectile_context func get_projectile_context() -> Dictionary:
方法 send_impact_to func send_impact_to(candidate: Object) -> void:

信号

projectile_launched

  • API：public
signal projectile_launched(projectile: GFProjectile2D)

发射体启动时发出。

参数：

名称 说明
projectile 当前发射体。

projectile_finished

  • API：public
signal projectile_finished(projectile: GFProjectile2D, reason: StringName)

发射体结束时发出。

参数：

名称 说明
projectile 当前发射体。
reason 结束原因。

属性

auto_launch_on_ready

  • API：public
var auto_launch_on_ready: bool = true

ready 后是否自动启动本次发射。

motion

  • API：public
var motion: Resource = null

移动策略。应实现 setup(projectile, context) 与 step(projectile, delta, context)。

lifetime_policy

  • API：public
var lifetime_policy: Resource = null

生命周期策略。应实现 setup(projectile, context) 与 should_finish(projectile, elapsed, context)。

finish_on_impact

  • API：public
var finish_on_impact: bool = true

命中任意 receive_hit() 接收器后是否结束。

queue_free_on_finish

  • API：public
var queue_free_on_finish: bool = true

结束时是否 queue_free。使用对象池时通常应关闭。

方法

launch

  • API：public
func launch(projectile_context: Dictionary = {}) -> void:

启动或重置本次发射。

参数：

名称 说明
projectile_context 本次发射的上下文字典。

结构：

  • projectile_context: Dictionary，本次发射上下文；会复制后传给 motion、lifetime_policy 和命中记录。

finish

  • API：public
func finish(reason: StringName = &"finished") -> void:

结束本次发射。

参数：

名称 说明
reason 结束原因。

is_projectile_active

  • API：public
func is_projectile_active() -> bool:

判断发射体是否处于已启动状态。

返回：已启动且未结束时返回 true。

get_elapsed_seconds

  • API：public
func get_elapsed_seconds() -> float:

获取本次发射经过的秒数。

返回：经过的秒数。

get_projectile_context

  • API：public
func get_projectile_context() -> Dictionary:

获取本次发射上下文副本。

返回：上下文字典副本。

结构：

  • return: Dictionary，本次发射上下文副本，包含调用方上下文、发射器写入字段和 impact 计数。

send_impact_to

  • API：public
func send_impact_to(candidate: Object) -> void:

向碰撞候选对象发送一次发射体命中。

参数：

名称 说明
candidate 碰撞候选对象，可为接收器或其子节点。