GFSkillTargetingRule

API Reference / Combat / 类索引

• 路径：addons/gf/extensions/combat/skills/gf_skill_targeting_rule.gd
• 模块：Combat
• 继承：Resource
• API：public
• 类别：资源定义 (resource_definition)
• 首次版本：3.17.0

技能索敌规则资源。 使用纯数据结构描述目标筛选时的空间范围、 朝向约束、排序规则与标签过滤条件。

成员概览

类型	名称	签名
枚举	Shape	enum Shape
枚举	SortRule	enum SortRule
属性	shape	var shape: Shape = Shape.CIRCLE
属性	radius	var radius: float = 100.0
属性	rectangle_size	var rectangle_size: Vector2 = Vector2(200.0, 200.0)
属性	max_count	var max_count: int = 1
属性	forward_direction	var forward_direction: Vector2 = Vector2.RIGHT
属性	sector_angle_degrees	var sector_angle_degrees: float = 90.0
属性	sort_rule	var sort_rule: SortRule = SortRule.DISTANCE_CLOSEST
属性	sort_attribute_name	var sort_attribute_name: StringName = &"HP"
属性	require_tags	var require_tags: Array[StringName] = []
属性	ignore_tags	var ignore_tags: Array[StringName] = []

枚举

Shape

• API：public

enum Shape { ## 轴对齐矩形范围。 RECTANGLE, ## 圆形范围。 CIRCLE, ## 扇形范围。 SECTOR, ## 单体目标。 SINGLE, }

索敌形状。

SortRule

• API：public

enum SortRule { ## 距离最近优先。 DISTANCE_CLOSEST, ## 距离最远优先。 DISTANCE_FURTHEST, ## 属性值最低优先。 ATTRIBUTE_LOWEST, ## 属性值最高优先。 ATTRIBUTE_HIGHEST, ## 随机顺序。 RANDOM, }

排序规则。

属性

shape

• API：public

var shape: Shape = Shape.CIRCLE

索敌形状。

radius

• API：public

var radius: float = 100.0

圆形、扇形与单体规则使用的最大半径。

rectangle_size

• API：public

var rectangle_size: Vector2 = Vector2(200.0, 200.0)

矩形范围尺寸，使用轴对齐包围盒判断。

max_count

• API：public

var max_count: int = 1

最多选中的目标数量。

forward_direction

• API：public

var forward_direction: Vector2 = Vector2.RIGHT

扇形朝向；为零向量时回退到 Vector2.RIGHT。

sector_angle_degrees

• API：public

var sector_angle_degrees: float = 90.0

扇形夹角，单位为角度。

sort_rule

• API：public

var sort_rule: SortRule = SortRule.DISTANCE_CLOSEST

目标排序逻辑。

sort_attribute_name

• API：public

var sort_attribute_name: StringName = &"HP"

按属性排序时使用的属性名。

require_tags

• API：public

var require_tags: Array[StringName] = []

目标必须拥有的标签列表。

ignore_tags

• API：public

var ignore_tags: Array[StringName] = []

目标禁止拥有的标签列表。