RustedWarfare Wiki - 用户贡献 [zh-cn]

单位引用

2026-02-25T05:43:26Z

GMBOX：

'''单位引用'''（Unit References，缩写：unitref）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()

getOffsetAbsolute()

createMarker()
|-
|变量引用
|thisActionTarget
eventSource
|-
|函数引用
|attachment()
transporting()

nearestUnit()

globalSearchForFirstUnit()

self

attacking

lastDamagedBy

parent

activeWaypointTarget

|-
|存储引用
|customTarget1
customTarget2
|-
|空引用
|nullUnit
|}
==标记==
你可立即创建一个临时标记，可用来反映位置（Position）、朝向（Direction）、高度（Height）、队伍编号（Team ID），且不需要用到时会自动销毁，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式（注：方括号参数为选填）===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
[hiddenAction_teleport]
# 传送到以该单位朝向角为基础再偏移自定义计时器数量角度的方向纵轴为十的位置。
teleportTo: getOffsetRelative( y = 10, dirOffset = self.customTimer )

[hiddenAction_strike]
# 炮弹发射到以路径点为中心最近标签为前哨的我方单位。
fireXTurretAtGround: 1
fireXTurretAtGround_withTarget: createMarker( activeWaypointTarget.x, activeWaypointTarget.y, teamId = self.teamId ).nearestUnit( withinRange = 1500, withTag = "outpost", relation = "own" )
</pre>}}

==变量引用==
变量引用只能存在于'''行动链'''（Action Chain），可用'''也触发行动'''（<code>alsoTriggerAction</code>）或'''也加入队列（'''<code>alsoQueueAction</code>）将其传递下去，连续<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>只允许十层，但可交替使用绕过限制，可存储在<code>Unit</code>类型的[[自定义内存]]或[[数组]]。'''当前行动目标'''（<code>thisActionTarget</code>）在不同情况下所指代的单位不同，与'''事件来源'''（<code>eventSource</code>）不同，后者只与'''自动触发事件'''（<code>autoTriggerOnEvent</code>）绑定，触发的事件不同所指代单位也不同。

===thisActionIndex的用法===
'''当前行动索引'''<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，'''索引'''（<code>index</code>）为其缩略形式。受'''重复触发'''（<code>alsoTriggerActionRepeat</code>）与'''提取资源为每个触发行动（'''<code>takeResources_triggerActionForEach</code>）影响。值为<code>Int</code>（整数）类型，从0开始，用于遍历数组。<pre>eg:
[core]
# 定义类型为Number的数组。
@memory array: number[]
[hiddenAction_1]
# 触发行动2数组长度次（1次）。
alsoTriggerAction: 2
alsoTriggerActionRepeat: memory.array.size
[hiddenAction_2]
# 如果m.array[i]为0，则赋值在第i个元素赋0，否则减1。
setUnitMemory: array[index] = select( memory.array[index] == 0,0, memory.array[index] - 1 )</pre>

===对应的情况===
{| class="wikitable sortable mw-collapsible mw-collapsed"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|被添加路径点的单位（没明确指定某个单位时则为在那个位置的标记，如move等）
|}

{| class="wikitable sortable mw-collapsible mw-collapsed"
|+eventSource用处
|tookDamage
|攻击方
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
# 发射时触发行动。
onShoot_triggerActions: idol
[hiddenAction_idol]
# 当前行动目标指代击中的单位。
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
# 事件来源指代攻击方。
autoTriggerOnEvent: tookDamage( withTag = "APCR" )
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==函数引用==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，可填入参数。

===选填参数部分（注：方括号为选填参数）===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation], [incompleteBuildings], [withoutTag])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation], [incompleteBuildings])</code>

===='''<big>请慎重使用默认参数。</big>'''====
*附属
不填参数则返回行数最高的附属。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围550的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。'''自身（<code>self</code>）'''一般情况下指向单位自己，也用于指代前面的单位引用，在涉及复杂单位引用逻辑时，请慎重使用<code>self</code>，请在初始化处定义个内存赋值'''<code>self</code>'''，选择使用存储自身的内存。'''攻击目标'''（<code>attacking</code>）为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式，相当于<code>Attack</code>类型的路径点。'''最后伤害源'''<code>lastDamagedBy</code>在事件来源为'''受击（'''<code>tookDamage</code>）时的快捷引用方式。'''父单位'''（<code>parent</code>）在单位自身为他人附属或乘员时可使用，<code>unitref.hasParent( [withTag] )</code>为其快捷方式。'''当前路径点'''（<code>activeWaypointTarget</code>）能够实时监控路径点情况，如果没明确指定某个单位则返回在那个位置的标记（Marker），但似乎不能获取该路径点的类型，路径点类型可[https://docs.google.com/spreadsheets/d/1aeP3pUic0IutZlgGix_cM8xR7LEH44gS4itAxETK954/htmlview 详见]代码<code>addWaypoint_type</code>。

{{折叠|函数引用的例子|<pre>
[decal_1]
# 父单位的名为5的附属为自己则显示贴花。（注：UI世界与单位所在世界不同，请使用发送消息。）
isVisible: if parent.attachment( slot= 5 ) == self

[hiddenAction_repair]
# 在玩家创建新路径点时触发。
autoTriggerOnEvent: newWaypointGivenByPlayer
# 过滤，只允许类型为”修复“的路径点时触发，
requireConditional: if self.hasActiveWaypoint( type = "repair" )
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储引用==
与[[自定义内存]]相比，虽然'''自定义目标1'''<code>customTarget1</code>'''自定义目标2'''<code>customTarget2</code>与<code>@memory x:unit</code>（<code>Unit</code>类型的内存）用途相当，都可用于存储单位，但与内存不同，自定义目标在单位死亡、删除的情况下会自动清除。内存需要手动管理，而自定义目标会自动管理。
内存可以用高频触发行动复现。

<nowiki>{{折叠|复现CustomTarget的例子|<pre>[core]# 高频，一秒六十次。autoTriggerCooldownTime: 1autoTriggerCooldownTime_allowDangerousHighCPU: true# 不推荐使用关键字命名内存。@memory customTarget1: unit[hiddenAction_update]# 高频触发检测单位是否死亡或删除。autoTrigger: if substring( str(memory.customTarget1), length(str(memory.customTarget1)) - 7, length(str(memory.customTarget1)) - 1 ) == "[dead]" or substring( str(memory.customTarget1), length(str(memory.customTarget1)) - 10, length(str(memory.customTarget1)) - 1 ) == "[deleted]"# 清空内存。setUnitMemory: customTarget1 = nullUnit</pre>}}</nowiki>

单位生产（<code>canBuild</code>)、产生(<code>produceUnits</code><code>spawnUnit(s)</code>）出来时，该出厂单位的'''自定义目标1'''默认为工厂。工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉出厂单位谁是工厂。

==空引用==
单位引用中，'''空'''（<code>null</code>）指向不存在的单位引用。逻辑布尔值（<code>Logic Boolean</code>，类似条件判断）中，可搭配不等式避免返回<code>Unit</code>类型。[[自定义内存]]中，也可作为空值赋值，也可用于清空[[数组]]。'''空单位引用'''<code>nullUnit</code>与前者不同，不可用于清空数组。

单位引用

2026-02-25T04:40:14Z

GMBOX：/* 标记的用法 */

'''单位引用'''（Unit References，缩写：unitref）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()

getOffsetAbsolute()

createMarker()
|-
|变量引用
|thisActionTarget
eventSource
|-
|函数引用
|attachment()
transporting()

nearestUnit()

globalSearchForFirstUnit()

self

attacking

lastDamagedBy

parent

activeWaypointTarget

|-
|存储引用
|customTarget1
customTarget2
|-
|空引用
|nullUnit
|}
==标记==
你可立即创建一个临时标记，可用来反映位置（Position）、朝向（Direction）、高度（Height）、队伍编号（Team ID），且不需要用到时会自动销毁，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式（注：方括号参数为选填）===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
[hiddenAction_teleport]
# 传送到以该单位朝向角为基础再偏移自定义计时器数量角度的方向纵轴为十的位置。
teleportTo: getOffsetRelative( y = 10, dirOffset = self.customTimer )

[hiddenAction_strike]
# 炮弹发射到以路径点为中心最近标签为前哨的我方单位。
fireXTurretAtGround: 1
fireXTurretAtGround_withTarget: createMarker( activeWaypointTarget.x, activeWaypointTarget.y, teamId = self.teamId ).nearestUnit( withinRange = 1500, withTag = "outpost", relation = "own" )
</pre>}}

==变量引用==
变量引用只能存在于'''行动链'''（Action Chain），可用'''也触发行动'''（<code>alsoTriggerAction</code>）或'''也加入队列（'''<code>alsoQueueAction</code>）将其传递下去，连续<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>只允许十层，但可交替使用绕过限制，可存储在<code>Unit</code>类型的[[自定义内存]]或[[数组]]。'''当前行动目标'''（<code>thisActionTarget</code>）在不同情况下所指代的单位不同，与'''事件来源'''（<code>eventSource</code>）不同，后者只与'''自动触发事件'''（<code>autoTriggerOnEvent</code>）绑定，触发的事件不同所指代单位也不同。

===thisActionIndex的用法===
'''当前行动索引'''<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，'''索引'''（<code>index</code>）为其缩略形式。受'''重复触发'''（<code>alsoTriggerActionRepeat</code>）与'''提取资源为每个触发行动（'''<code>takeResources_triggerActionForEach</code>）影响。值为<code>Int</code>（整数）类型，从0开始，用于遍历数组。<pre>eg:
[core]
# 定义类型为Number的数组。
@memory array: number[]
[hiddenAction_1]
# 触发行动2数组长度次（1次）。
alsoTriggerAction: 2
alsoTriggerActionRepeat: memory.array.size
[hiddenAction_2]
# 如果m.array[i]为0，则赋值在第i个元素赋0，否则减1。
setUnitMemory: array[index] = select( memory.array[index] == 0,0, memory.array[index] - 1 )</pre>

===对应的情况===
{| class="wikitable sortable mw-collapsible mw-collapsed"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|被添加路径点的单位（没明确指定某个单位时则为在那个位置的标记，如move等）
|}

{| class="wikitable sortable mw-collapsible mw-collapsed"
|+eventSource用处
|tookDamage
|攻击方
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
# 发射时触发行动。
onShoot_triggerActions: idol
[hiddenAction_idol]
# 当前行动目标指代击中的单位。
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
# 事件来源指代攻击方。
autoTriggerOnEvent: tookDamage( withTag = "APCR" )
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==函数引用==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，可填入参数。

===选填参数部分（注：方括号为选填参数）===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation], [incompleteBuildings], [withoutTag])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation], [incompleteBuildings])</code>

===='''<big>请慎重使用默认参数。</big>'''====
*附属
不填参数则返回行数最高的附属。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围550的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。'''自身（<code>self</code>）'''一般情况下指向单位自己，也用于指代前面的单位引用，在涉及复杂单位引用逻辑时，请慎重使用<code>self</code>，请在初始化处定义个内存赋值'''<code>self</code>'''，选择使用存储自身的内存。'''攻击目标'''（<code>attacking</code>）为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式，相当于<code>Attack</code>类型的路径点。'''最后伤害源'''<code>lastDamagedBy</code>在事件来源为'''受击（'''<code>tookDamage</code>）时的快捷引用方式。'''父单位'''（<code>parent</code>）在单位自身为他人附属或乘员时可使用，<code>unitref.hasParent( [withTag] )</code>为其快捷方式。'''当前路径点'''（<code>activeWaypointTarget</code>）能够实时监控路径点情况，如果没明确指定某个单位则返回在那个位置的标记（Marker），但似乎不能获取该路径点的类型，路径点类型可[https://docs.google.com/spreadsheets/d/1aeP3pUic0IutZlgGix_cM8xR7LEH44gS4itAxETK954/htmlview 详见]代码<code>addWaypoint_type</code>。

{{折叠|函数引用的例子|<pre>
[decal_1]
# 父单位的名为5的附属为自己则显示贴花。（注：UI世界与单位所在世界不同，请使用发送消息。）
isVisible: if parent.attachment( slot= 5 ) == self

[hiddenAction_repair]
# 在玩家创建新路径点时触发。
autoTriggerOnEvent: newWaypointGivenByPlayer
# 过滤，只允许类型为”修复“的路径点时触发，
requireConditional: if self.hasActiveWaypoint( type = "repair" )
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储引用==
与[[自定义内存]]相比，虽然'''自定义目标1'''<code>customTarget1</code>'''自定义目标2'''<code>customTarget2</code>与<code>@memory x:unit</code>（<code>Unit</code>类型的内存）用途相当，都可用于存储单位，但与内存不同，自定义目标在单位死亡、删除的情况下会自动清除。内存需要手动管理，而自定义目标会自动管理。
内存可以用高频触发行动复现。
单位生产（<code>canBuild</code>)、产生(<code>produceUnits</code><code>spawnUnit(s)</code>）出来时，该出厂单位的'''自定义目标1'''默认为工厂。工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉出厂单位谁是工厂。

==空引用==
单位引用中，'''空'''（<code>null</code>）指向不存在的单位引用。逻辑布尔值（<code>Logic Boolean</code>，类似条件判断）中，可搭配不等式避免返回<code>Unit</code>类型。[[自定义内存]]中，也可作为空值赋值，也可用于清空[[数组]]。'''空单位引用'''<code>nullUnit</code>与前者不同，不可用于清空数组。

单位引用

2026-02-25T04:05:23Z

GMBOX：错别字。

'''单位引用'''（Unit References，缩写：unitref）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()

getOffsetAbsolute()

createMarker()
|-
|变量引用
|thisActionTarget
eventSource
|-
|函数引用
|attachment()
transporting()

nearestUnit()

globalSearchForFirstUnit()

self

attacking

lastDamagedBy

parent

activeWaypointTarget

|-
|存储引用
|customTarget1
customTarget2
|-
|空引用
|nullUnit
|}
==标记==
你可立即创建一个临时标记，可用来反映位置（Position）、朝向（Direction）、高度（Height）、队伍编号（Team ID），且不需要用到时会自动销毁，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式（注：方括号参数为选填）===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
# 传送到以该单位朝向角为基础再偏移自定义计时器数量角度的方向纵轴为十的位置。
teleportTo: getOffsetRelative( y = 10, dirOffset = self.customTimer )

# 炮弹发射到以路径点为中心最近标签为前哨的我方单位。
fireXTurretAtGround: 1
fireXTurretAtGround_withTarget: createMarker( activeWaypointTarget.x, activeWaypointTarget.y, teamId = self.teamId ).nearestUnit( withinRange = 1500, withTag = "outpost", relation = "own" )
</pre>}}

==变量引用==
变量引用只能存在于'''行动链'''（Action Chain），可用'''也触发行动'''（<code>alsoTriggerAction</code>）或'''也加入队列（'''<code>alsoQueueAction</code>）将其传递下去，连续<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>只允许十层，但可交替使用绕过限制，可存储在<code>Unit</code>类型的[[自定义内存]]或[[数组]]。'''当前行动目标'''（<code>thisActionTarget</code>）在不同情况下所指代的单位不同，与'''事件来源'''（<code>eventSource</code>）不同，后者只与'''自动触发事件'''（<code>autoTriggerOnEvent</code>）绑定，触发的事件不同所指代单位也不同。

===thisActionIndex的用法===
'''当前行动索引'''<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，'''索引'''（<code>index</code>）为其缩略形式。受'''重复触发'''（<code>alsoTriggerActionRepeat</code>）与'''提取资源为每个触发行动（'''<code>takeResources_triggerActionForEach</code>）影响。值为<code>Int</code>（整数）类型，从0开始，用于遍历数组。<pre>eg:
[core]
# 定义类型为Number的数组。
@memory array: number[]
[hiddenAction_1]
# 触发行动2数组长度次（1次）。
alsoTriggerAction: 2
alsoTriggerActionRepeat: memory.array.size
[hiddenAction_2]
# 如果m.array[i]为0，则赋值在第i个元素赋0，否则减1。
setUnitMemory: array[index] = select( memory.array[index] == 0,0, memory.array[index] - 1 )</pre>

===对应的情况===
{| class="wikitable sortable mw-collapsible mw-collapsed"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|被添加路径点的单位（没明确指定某个单位时则为在那个位置的标记，如move等）
|}

{| class="wikitable sortable mw-collapsible mw-collapsed"
|+eventSource用处
|tookDamage
|攻击方
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
# 发射时触发行动。
onShoot_triggerActions: idol
[hiddenAction_idol]
# 当前行动目标指代击中的单位。
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
# 事件来源指代攻击方。
autoTriggerOnEvent: tookDamage( withTag = "APCR" )
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==函数引用==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，可填入参数。

===选填参数部分（注：方括号为选填参数）===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation], [incompleteBuildings], [withoutTag])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation], [incompleteBuildings])</code>

===='''<big>请慎重使用默认参数。</big>'''====
*附属
不填参数则返回行数最高的附属。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围550的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。'''自身（<code>self</code>）'''一般情况下指向单位自己，也用于指代前面的单位引用，在涉及复杂单位引用逻辑时，请慎重使用<code>self</code>，请在初始化处定义个内存赋值'''<code>self</code>'''，选择使用存储自身的内存。'''攻击目标'''（<code>attacking</code>）为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式，相当于<code>Attack</code>类型的路径点。'''最后伤害源'''<code>lastDamagedBy</code>在事件来源为'''受击（'''<code>tookDamage</code>）时的快捷引用方式。'''父单位'''（<code>parent</code>）在单位自身为他人附属或乘员时可使用，<code>unitref.hasParent( [withTag] )</code>为其快捷方式。'''当前路径点'''（<code>activeWaypointTarget</code>）能够实时监控路径点情况，如果没明确指定某个单位则返回在那个位置的标记（Marker），但似乎不能获取该路径点的类型，路径点类型可[https://docs.google.com/spreadsheets/d/1aeP3pUic0IutZlgGix_cM8xR7LEH44gS4itAxETK954/htmlview 详见]代码<code>addWaypoint_type</code>。

{{折叠|函数引用的例子|<pre>
[decal_1]
# 父单位的名为5的附属为自己则显示贴花。（注：UI世界与单位所在世界不同，请使用发送消息。）
isVisible: if parent.attachment( slot= 5 ) == self

[hiddenAction_repair]
# 在玩家创建新路径点时触发。
autoTriggerOnEvent: newWaypointGivenByPlayer
# 过滤，只允许类型为”修复“的路径点时触发，
requireConditional: if self.hasActiveWaypoint( type = "repair" )
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储引用==
与[[自定义内存]]相比，虽然'''自定义目标1'''<code>customTarget1</code>'''自定义目标2'''<code>customTarget2</code>与<code>@memory x:unit</code>（<code>Unit</code>类型的内存）用途相当，都可用于存储单位，但与内存不同，自定义目标在单位死亡、删除的情况下会自动清除。内存需要手动管理，而自定义目标会自动管理。
内存可以用高频触发行动复现。
单位生产（<code>canBuild</code>)、产生(<code>produceUnits</code><code>spawnUnit(s)</code>）出来时，该出厂单位的'''自定义目标1'''默认为工厂。工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉出厂单位谁是工厂。

==空引用==
单位引用中，'''空'''（<code>null</code>）指向不存在的单位引用。逻辑布尔值（<code>Logic Boolean</code>，类似条件判断）中，可搭配不等式避免返回<code>Unit</code>类型。[[自定义内存]]中，也可作为空值赋值，也可用于清空[[数组]]。'''空单位引用'''<code>nullUnit</code>与前者不同，不可用于清空数组。

单位引用

2026-02-25T04:04:50Z

GMBOX：错别字。

'''单位引用'''（Unit References，缩写：unitref）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()

getOffsetAbsolute()

createMarker()
|-
|变量引用
|thisActionTarget
eventSource
|-
|函数引用
|attachment()
transporting()

nearestUnit()

globalSearchForFirstUnit()

self

attacking

lastDamagedBy

parent

activeWaypointTarget

|-
|存储引用
|customTarget1
customTarget2
|-
|空引用
|nullUnit
|}
==标记==
你可立即创建一个临时标记，可用来反映位置（Position）、朝向（Direction）、高度（Height）、队伍编号（Team ID），且不需要用到时会自动销毁，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式（注：方括号参数为选填）===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
# 传送到以该单位朝向角为基础再偏移自定义计时器数量角度的方向纵轴为十的位置。
teleportTo: getOffsetRelative( y = 10, dirOffset = self.customTimer )

# 炮弹发射到以路径点为中心最近标签为前哨的我方单位。
fireXTurretAtGround: 1
fireXTurretAtGround_withTarget: createMarker( activeWaypointTarget.x, activeWaypointTarget.y, teamId = self.teamId ).nearestUnit( withinRange = 1500, withTag = "outpost", relation = "own" )
</pre>}}

==变量引用==
变量引用只能存在于'''行动链'''（Action Chain），可用'''也触发行动'''（<code>alsoTriggerAction</code>）或'''也加入队列（'''<code>alsoQueueAction</code>）将其传递下去，连续<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>只允许十层，但可交替使用绕过限制，可存储在<code>Unit</code>类型的[[自定义内存]]或[[数组]]。'''当前行动目标'''（<code>thisActionTarget</code>）在不同情况下所指代的单位不同，与'''事件来源'''（<code>eventSource</code>）不同，后者只与'''自动触发事件'''（<code>autoTriggerOnEvent</code>）绑定，触发的事件不同所指代单位也不同。

===thisActionIndex的用法===
'''当前行动索引'''<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，'''索引'''（<code>index</code>）为其缩略形式。受'''重复触发'''（<code>alsoTriggerActionRepeat</code>）与'''提取资源为每个触发行动（'''<code>takeResources_triggerActionForEach</code>）影响。值为<code>Int</code>（整数）类型，从0开始，用于遍历数组。<pre>eg:
[core]
# 定义类型为Number的数组。
@memory array: number[]
[hiddenAction_1]
# 触发行动2数组长度次（1次）。
alsoTriggerAction: 2
alsoTriggerActionRepeat: memory.array.size
[hiddenAction_2]
# 如果m.array[i]为0，则赋值在第i个元素赋0，否则减1。
setUnitMemory: array[index] = select( memory.array[index] == 0,0, memory.array[index] - 1 )</pre>

===对应的情况===
{| class="wikitable sortable mw-collapsible mw-collapsed"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|被添加路径点的单位（没明确指定某个单位时则为在那个位置的标记，如move等）
|}

{| class="wikitable sortable mw-collapsible mw-collapsed"
|+eventSource用处
|tookDamage
|攻击方
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
# 发射时触发行动。
onShoot_triggerActions: idol
[hiddenAction_idol]
# 当前行动目标指代击中的单位。
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
# 事件来源指代攻击方。
autoTriggerOnEvent: tookDamage( withTag = "APCR" )
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==函数引用==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，可填入参数。

===选填参数部分（注：方括号为选填参数）===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation], [incompleteBuildings], [withoutTag])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation], [incompleteBuildings])</code>

===='''<big>请慎重使用默认参数。</big>'''====
*附属
不填参数则返回行数最高的附属。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围550的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。'''自身（<code>self</code>）'''一般情况下指向单位自己，也用于指代前面的单位引用，在涉及复杂单位引用逻辑时，请慎重使用<code>self</code>，请在初始化处定义个内存赋值'''<code>self</code>'''，选择使用存储自身的内存。'''攻击目标'''（<code>attacking</code>）为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式，相当于<code>Attack</code>类型的路径点。'''最后伤害源'''<code>lastDamagedBy</code>在事件来源为'''受击（'''<code>tookDamage</code>）时的快捷引用方式。'''父单位'''（<code>parent</code>）在单位自身为他人附属或乘员时可使用，<code>unitref.hasParent( [withTag] )</code>为其快捷方式。'''当前路径点'''（<code>activeWaypointTarget</code>）能够实时监控路径点情况，如果没明确指定某个单位则返回在那个位置的标记（Marker），但似乎不能获取该路径点的类型，路径点类型可[https://docs.google.com/spreadsheets/d/1aeP3pUic0IutZlgGix_cM8xR7LEH44gS4itAxETK954/htmlview 详见]代码<code>addWaypoint_type</code>。

{{折叠|h函数引用的例子|<pre>
[decal_1]
# 父单位的名为5的附属为自己则显示贴花。（注：UI世界与单位所在世界不同，请使用发送消息。）
isVisible: if parent.attachment( slot= 5 ) == self

[hiddenAction_repair]
# 在玩家创建新路径点时触发。
autoTriggerOnEvent: newWaypointGivenByPlayer
# 过滤，只允许类型为”修复“的路径点时触发，
requireConditional: if self.hasActiveWaypoint( type = "repair" )
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储引用==
与[[自定义内存]]相比，虽然'''自定义目标1'''<code>customTarget1</code>'''自定义目标2'''<code>customTarget2</code>与<code>@memory x:unit</code>（<code>Unit</code>类型的内存）用途相当，都可用于存储单位，但与内存不同，自定义目标在单位死亡、删除的情况下会自动清除。内存需要手动管理，而自定义目标会自动管理。
内存可以用高频触发行动复现。
单位生产（<code>canBuild</code>)、产生(<code>produceUnits</code><code>spawnUnit(s)</code>）出来时，该出厂单位的'''自定义目标1'''默认为工厂。工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉出厂单位谁是工厂。

==空引用==
单位引用中，'''空'''（<code>null</code>）指向不存在的单位引用。逻辑布尔值（<code>Logic Boolean</code>，类似条件判断）中，可搭配不等式避免返回<code>Unit</code>类型。[[自定义内存]]中，也可作为空值赋值，也可用于清空[[数组]]。'''空单位引用'''<code>nullUnit</code>与前者不同，不可用于清空数组。

单位引用

2026-02-23T20:04:20Z

GMBOX：/* 无参数部分 */

'''单位引用'''（Unit References，缩写：unitref）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()

getOffsetAbsolute()

createMarker()
|-
|变量引用
|thisActionTarget
eventSource
|-
|函数引用
|attachment()
transporting()

nearestUnit()

globalSearchForFirstUnit()

self

attacking

lastDamagedBy

parent

activeWaypointTarget

|-
|存储引用
|customTarget1
customTarget2
|-
|空引用
|nullUnit
|}
==标记==
你可立即创建一个临时标记，可用来反映位置（Position）、朝向（Direction）、高度（Height）、队伍编号（Team ID），且不需要用到时会自动销毁，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式（注：方括号参数为选填）===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
# 传送到以该单位朝向角为基础再偏移自定义计时器数量角度的方向纵轴为十的位置。
teleportTo: getOffsetRelative( y = 10, dirOffset = self.customTimer )

# 炮弹发射到以路径点为中心最近标签为前哨的我方单位。
fireXTurretAtGround: 1
fireXTurretAtGround_withTarget: createMarker( activeWaypointTarget.x, activeWaypointTarget.y, teamId = self.teamId ).nearestUnit( withinRange = 1500, withTag = "outpost", relation = "own" )
</pre>}}

==变量引用==
变量引用只能存在于'''行动链'''（Action Chain），可用'''也触发行动'''（<code>alsoTriggerAction</code>）或'''也加入队列（'''<code>alsoQueueAction</code>）将其传递下去，连续<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>只允许十层，但可交替使用绕过限制，可存储在<code>Unit</code>类型的[[自定义内存]]或[[数组]]。'''当前行动目标'''（<code>thisActionTarget</code>）在不同情况下所指代的单位不同，与'''事件来源'''（<code>eventSource</code>）不同，后者只与'''自动触发事件'''（<code>autoTriggerOnEvent</code>）绑定，触发的事件不同所指代单位也不同。

===thisActionIndex的用法===
'''当前行动索引'''<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，'''索引'''（<code>index</code>）为其缩略形式。受'''重复触发'''（<code>alsoTriggerActionRepeat</code>）与'''提取资源为每个触发行动（'''<code>takeResources_triggerActionForEach</code>）影响。值为<code>Int</code>（整数）类型，从0开始，用于遍历数组。<pre>eg:
[core]
# 定义类型为Number的数组。
@mmeory array: number[]
[hiddenAction_1]
# 触发行动2数组长度次（1次）。
alsoTriggerAction: 2
alsoTriggerActionRepeat: memory.array.size
[hiddenAction_2]
# 如果m.array[i]为0，则赋值在第i个元素赋0，否则减1。
setUnitMemory: array[index] = select( memory.array[index] == 0,0, memory.array[index] - 1 )</pre>

===对应的情况===
{| class="wikitable sortable mw-collapsible mw-collapsed"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|被添加路径点的单位（没明确指定某个单位时则为在那个位置的标记，如move等）
|}

{| class="wikitable sortable mw-collapsible mw-collapsed"
|+eventSource用处
|tookDamage
|攻击方
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
# 发射时触发行动。
onShoot_triggerActions: idol
[hiddenAction_idol]
# 当前行动目标指代击中的单位。
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
# 事件来源指代攻击方。
autoTriggerOnEvent: tookDamage( withTag = "APCR" )
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==函数引用==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，可填入参数。

===选填参数部分（注：方括号为选填参数）===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation], [incompleteBuildings], [withoutTag])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation], [incompleteBuildings])</code>

===='''<big>请慎重使用默认参数。</big>'''====
*附属
不填参数则返回行数最高的附属。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围550的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。'''自身（<code>self</code>）'''一般情况下指向单位自己，也用于指代前面的单位引用，在涉及复杂单位引用逻辑时，请慎重使用<code>self</code>，请在初始化处定义个内存赋值'''<code>self</code>'''，选择使用存储自身的内存。'''攻击目标'''（<code>attacking</code>）为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式，相当于<code>Attack</code>类型的路径点。'''最后伤害源'''<code>lastDamagedBy</code>在事件来源为'''受击（'''<code>tookDamage</code>）时的快捷引用方式。'''父单位'''（<code>parent</code>）在单位自身为他人附属或乘员时可使用，<code>unitref.hasParent( [withTag] )</code>为其快捷方式。'''当前路径点'''（<code>activeWaypointTarget</code>）能够实时监控路径点情况，如果没明确指定某个单位则返回在那个位置的标记（Marker），但似乎不能获取该路径点的类型，路径点类型可[https://docs.google.com/spreadsheets/d/1aeP3pUic0IutZlgGix_cM8xR7LEH44gS4itAxETK954/htmlview 详见]代码<code>addWaypoint_type</code>。

{{折叠|h函数引用的例子|<pre>
[decal_1]
# 父单位的名为5的附属为自己则显示贴花。（注：UI世界与单位所在世界不同，请使用发送消息。）
isVisible: if parent.attachment( slot= 5 ) == self

[hiddenAction_repair]
# 在玩家创建新路径点时触发。
autoTriggerOnEvent: newWaypointGivenByPlayer
# 过滤，只允许类型为”修复“的路径点时触发，
requireConditional: if self.hasActiveWaypoint( type = "repair" )
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储引用==
与[[自定义内存]]相比，虽然'''自定义目标1'''<code>customTarget1</code>'''自定义目标2'''<code>customTarget2</code>与<code>@memory x:unit</code>（<code>Unit</code>类型的内存）用途相当，都可用于存储单位，但与内存不同，自定义目标在单位死亡、删除的情况下会自动清除。内存需要手动管理，而自定义目标会自动管理。
内存可以用高频触发行动复现。
单位生产（<code>canBuild</code>)、产生(<code>produceUnits</code><code>spawnUnit(s)</code>）出来时，该出厂单位的'''自定义目标1'''默认为工厂。工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉出厂单位谁是工厂。

==空引用==
单位引用中，'''空'''（<code>null</code>）指向不存在的单位引用。逻辑布尔值（<code>Logic Boolean</code>，类似条件判断）中，可搭配不等式避免返回<code>Unit</code>类型。[[自定义内存]]中，也可作为空值赋值，也可用于清空[[数组]]。'''空单位引用'''<code>nullUnit</code>与前者不同，不可用于清空数组。

单位引用

2026-02-23T20:02:36Z

GMBOX：/* 对应的情况 */

'''单位引用'''（Unit References，缩写：unitref）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()

getOffsetAbsolute()

createMarker()
|-
|变量引用
|thisActionTarget
eventSource
|-
|函数引用
|attachment()
transporting()

nearestUnit()

globalSearchForFirstUnit()

self

attacking

lastDamagedBy

parent

activeWaypointTarget

|-
|存储引用
|customTarget1
customTarget2
|-
|空引用
|nullUnit
|}
==标记==
你可立即创建一个临时标记，可用来反映位置（Position）、朝向（Direction）、高度（Height）、队伍编号（Team ID），且不需要用到时会自动销毁，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式（注：方括号参数为选填）===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
# 传送到以该单位朝向角为基础再偏移自定义计时器数量角度的方向纵轴为十的位置。
teleportTo: getOffsetRelative( y = 10, dirOffset = self.customTimer )

# 炮弹发射到以路径点为中心最近标签为前哨的我方单位。
fireXTurretAtGround: 1
fireXTurretAtGround_withTarget: createMarker( activeWaypointTarget.x, activeWaypointTarget.y, teamId = self.teamId ).nearestUnit( withinRange = 1500, withTag = "outpost", relation = "own" )
</pre>}}

==变量引用==
变量引用只能存在于'''行动链'''（Action Chain），可用'''也触发行动'''（<code>alsoTriggerAction</code>）或'''也加入队列（'''<code>alsoQueueAction</code>）将其传递下去，连续<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>只允许十层，但可交替使用绕过限制，可存储在<code>Unit</code>类型的[[自定义内存]]或[[数组]]。'''当前行动目标'''（<code>thisActionTarget</code>）在不同情况下所指代的单位不同，与'''事件来源'''（<code>eventSource</code>）不同，后者只与'''自动触发事件'''（<code>autoTriggerOnEvent</code>）绑定，触发的事件不同所指代单位也不同。

===thisActionIndex的用法===
'''当前行动索引'''<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，'''索引'''（<code>index</code>）为其缩略形式。受'''重复触发'''（<code>alsoTriggerActionRepeat</code>）与'''提取资源为每个触发行动（'''<code>takeResources_triggerActionForEach</code>）影响。值为<code>Int</code>（整数）类型，从0开始，用于遍历数组。<pre>eg:
[core]
# 定义类型为Number的数组。
@mmeory array: number[]
[hiddenAction_1]
# 触发行动2数组长度次（1次）。
alsoTriggerAction: 2
alsoTriggerActionRepeat: memory.array.size
[hiddenAction_2]
# 如果m.array[i]为0，则赋值在第i个元素赋0，否则减1。
setUnitMemory: array[index] = select( memory.array[index] == 0,0, memory.array[index] - 1 )</pre>

===对应的情况===
{| class="wikitable sortable mw-collapsible mw-collapsed"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|被添加路径点的单位（没明确指定某个单位时则为在那个位置的标记，如move等）
|}

{| class="wikitable sortable mw-collapsible mw-collapsed"
|+eventSource用处
|tookDamage
|攻击方
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
# 发射时触发行动。
onShoot_triggerActions: idol
[hiddenAction_idol]
# 当前行动目标指代击中的单位。
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
# 事件来源指代攻击方。
autoTriggerOnEvent: tookDamage( withTag = "APCR" )
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==函数引用==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，可填入参数。

===选填参数部分（注：方括号为选填参数）===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation], [incompleteBuildings], [withoutTag])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation], [incompleteBuildings])</code>

===='''<big>请慎重使用默认参数。</big>'''====
*附属
不填参数则返回行数最高的附属。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围550的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。'''自身（<code>self</code>）'''一般情况下指向单位自己，也用于指代前面的单位引用，在涉及复杂单位引用逻辑时，请慎重使用<code>self</code>，请在初始化处定义个内存赋值'''<code>self</code>'''，选择使用存储自身的内存。'''攻击目标'''（<code>attacking</code>）为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式，相当于<code>Attack</code>类型的路径点。'''最后伤害源'''<code>lastDamagedBy</code>在事件来源为'''受击（'''<code>tookDamage</code>）时的快捷引用方式。'''父单位'''（<code>parent</code>）在单位自身为他人附属或乘员时可使用，<code>unitref.hasParent( [withTag] )</code>为其快捷方式。'''当前路径点'''（<code>activeWaypointTarget</code>）能够实时监控路径点情况，如果没明确指定某个单位则返回在那个位置的标记（Marker），但似乎不能获取该路径点的类型，路径点类型可[https://docs.google.com/spreadsheets/d/1aeP3pUic0IutZlgGix_cM8xR7LEH44gS4itAxETK954/htmlview 详见]代码<code>addWaypoint_type</code>。

{{折叠|全局单位引用的例子|<pre>
[decal_1]
# 父单位的名为5的附属为自己则显示贴花。（注：UI世界与单位所在世界不同，请使用发送消息。）
isVisible: if parent.attachment( slot= 5 ) == self

[hiddenAction_repair]
# 在玩家创建新路径点时触发。
autoTriggerOnEvent: newWaypointGivenByPlayer
# 过滤，只允许类型为”修复“的路径点时触发，
requireConditional: if self.hasActiveWaypoint( type = "repair" )
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储引用==
与[[自定义内存]]相比，虽然'''自定义目标1'''<code>customTarget1</code>'''自定义目标2'''<code>customTarget2</code>与<code>@memory x:unit</code>（<code>Unit</code>类型的内存）用途相当，都可用于存储单位，但与内存不同，自定义目标在单位死亡、删除的情况下会自动清除。内存需要手动管理，而自定义目标会自动管理。
内存可以用高频触发行动复现。
单位生产（<code>canBuild</code>)、产生(<code>produceUnits</code><code>spawnUnit(s)</code>）出来时，该出厂单位的'''自定义目标1'''默认为工厂。工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉出厂单位谁是工厂。

==空引用==
单位引用中，'''空'''（<code>null</code>）指向不存在的单位引用。逻辑布尔值（<code>Logic Boolean</code>，类似条件判断）中，可搭配不等式避免返回<code>Unit</code>类型。[[自定义内存]]中，也可作为空值赋值，也可用于清空[[数组]]。'''空单位引用'''<code>nullUnit</code>与前者不同，不可用于清空数组。

单位引用

2026-02-23T18:58:02Z

GMBOX：/* 存储 */

'''单位引用'''（Unit Reference）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()
getOffsetAbsolute()
createMarker()
|-
|局内
|thisActionTarget
eventSource
|-
|全局
|attachment()
transporting()
attacking
lastDamagedBy
parent
activeWaypointTarget
nearestUnit()
globalSearchForFirstUnit()
|-
|存储
|customTarget1
customTarget2
|-
|其他
|nullUnit
|}
==标记==
临时、快速地创建一个标记，可用来反映位置、朝向、高度、队伍编号，且不需要用到时会自动移除，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
teleportTo: getOffsetRelative(y= 10, dirOffset= self.customTimer)

fireXTurretAtGround_withTarget: createMarker(activeWaypointTarget.x, activeWaypointTarget.y, teamId= self.teamId).nearestUnit(withinRange= 1500, withTag= "outpost", relation= "own")
</pre>}}

==局内==
局内只能在行动内使用，可用<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>延长“寿命”，你也可以用内存将其存储。<code>thisActionTarget</code>在不同情况下所指代的单位不同，与<code>eventSource</code>不同，后者只与<code>autoTriggerOnEvent</code>绑定，触发的事件不同所指代的单位也不同。
===thisActionIndex的用法===
<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，<code>index</code>为其缩略形式。受<code>alsoTriggerActionRepeat</code>与<code>takeResources_triggerActionForEach</code>影响。值为int（整数）类型，从0开始，用于遍历数组。
<pre>eg:
[hiddenAction_1]
alsoTriggerAction:2
alsoTriggerActionRepeat:memory.array.size
[hiddenAction_2]
setUnitMemory:array[index]=select(memory.array[index]==0,0,memory.array[index]-1)</pre>

===对应的情况===
{| class="wikitable"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|被添加路径点的单位（没明确指定某个单位时则为在那个位置的标记，如move等）
|}

{| class="wikitable"
|+eventSource用处
|tookDamage
|攻击你的单位
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
onShoot_triggerActions: idol
[hiddenAction_idol]
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
autoTriggerOnEvent: tookDamage(withTag="APCR")
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==全局==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，与'''局内'''相对。

===选填参数部分===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation], [incompleteBuildings], [withoutTag])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation], [incompleteBuildings])</code>

====参数都为选填，默认情况就很有趣了。====
*附属
不填参数则返回行数最高的单位。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围约为500内的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。
<code>attacking</code>为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式。<code>lastDamagedBy</code>在事件来源为tookDamage时的快捷引用方式。<code>parent</code>在单位自身为他人附属时可使用。<code>activeWaypointTarget</code>能够实时监控路径点情况，如果没明确指定某个单位则返回在那个位置的标记（Marker），但似乎不能获取该路径点的类型，路径点类型可[https://docs.google.com/spreadsheets/d/1aeP3pUic0IutZlgGix_cM8xR7LEH44gS4itAxETK954/htmlview 详见]代码<code>addWaypoint_type</code>。

{{折叠|全局单位引用的例子|<pre>
isVisible: if parent.attachment(slot= 5) == self

[hiddenAction_repair]
autoTriggerOnEvent: newWaypointGivenByPlayer
requireConditional: if self.hasActiveWaypoint(type= "repair")
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储引用==
与[[自定义内存]]相比，虽然'''自定义目标1'''<code>customTarget1</code>'''自定义目标2'''<code>customTarget2</code>与<code>@memory x:unit</code>（<code>Unit</code>类型的内存）用途相当，都可用于存储单位，但与内存不同，自定义目标在单位死亡、删除的情况下会自动清除。内存需要手动管理，而自定义目标会自动管理。
内存可以用高频触发行动复现。
单位生产（<code>canBuild</code>)、产生(<code>produceUnits</code><code>spawnUnit(s)</code>）出来时，该出厂单位的'''自定义目标1'''默认为工厂。工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉出厂单位谁是工厂。

==空引用==
单位引用中，'''空'''（<code>null</code>）指向不存在的单位引用。逻辑布尔值（<code>Logic Boolean</code>，类似条件判断）中，可搭配不等式避免返回<code>Unit</code>类型。[[自定义内存]]中，也可作为空值赋值，也可用于清空[[数组]]。'''空单位引用'''<code>nullUnit</code>与前者不同，不可用于清空数组。

单位引用

2026-02-23T18:38:40Z

GMBOX：/* 其他 */

'''单位引用'''（Unit Reference）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()
getOffsetAbsolute()
createMarker()
|-
|局内
|thisActionTarget
eventSource
|-
|全局
|attachment()
transporting()
attacking
lastDamagedBy
parent
activeWaypointTarget
nearestUnit()
globalSearchForFirstUnit()
|-
|存储
|customTarget1
customTarget2
|-
|其他
|nullUnit
|}
==标记==
临时、快速地创建一个标记，可用来反映位置、朝向、高度、队伍编号，且不需要用到时会自动移除，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
teleportTo: getOffsetRelative(y= 10, dirOffset= self.customTimer)

fireXTurretAtGround_withTarget: createMarker(activeWaypointTarget.x, activeWaypointTarget.y, teamId= self.teamId).nearestUnit(withinRange= 1500, withTag= "outpost", relation= "own")
</pre>}}

==局内==
局内只能在行动内使用，可用<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>延长“寿命”，你也可以用内存将其存储。<code>thisActionTarget</code>在不同情况下所指代的单位不同，与<code>eventSource</code>不同，后者只与<code>autoTriggerOnEvent</code>绑定，触发的事件不同所指代的单位也不同。
===thisActionIndex的用法===
<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，<code>index</code>为其缩略形式。受<code>alsoTriggerActionRepeat</code>与<code>takeResources_triggerActionForEach</code>影响。值为int（整数）类型，从0开始，用于遍历数组。
<pre>eg:
[hiddenAction_1]
alsoTriggerAction:2
alsoTriggerActionRepeat:memory.array.size
[hiddenAction_2]
setUnitMemory:array[index]=select(memory.array[index]==0,0,memory.array[index]-1)</pre>

===对应的情况===
{| class="wikitable"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|被添加路径点的单位（没明确指定某个单位时则为在那个位置的标记，如move等）
|}

{| class="wikitable"
|+eventSource用处
|tookDamage
|攻击你的单位
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
onShoot_triggerActions: idol
[hiddenAction_idol]
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
autoTriggerOnEvent: tookDamage(withTag="APCR")
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==全局==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，与'''局内'''相对。

===选填参数部分===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation], [incompleteBuildings], [withoutTag])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation], [incompleteBuildings])</code>

====参数都为选填，默认情况就很有趣了。====
*附属
不填参数则返回行数最高的单位。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围约为500内的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。
<code>attacking</code>为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式。<code>lastDamagedBy</code>在事件来源为tookDamage时的快捷引用方式。<code>parent</code>在单位自身为他人附属时可使用。<code>activeWaypointTarget</code>能够实时监控路径点情况，如果没明确指定某个单位则返回在那个位置的标记（Marker），但似乎不能获取该路径点的类型，路径点类型可[https://docs.google.com/spreadsheets/d/1aeP3pUic0IutZlgGix_cM8xR7LEH44gS4itAxETK954/htmlview 详见]代码<code>addWaypoint_type</code>。

{{折叠|全局单位引用的例子|<pre>
isVisible: if parent.attachment(slot= 5) == self

[hiddenAction_repair]
autoTriggerOnEvent: newWaypointGivenByPlayer
requireConditional: if self.hasActiveWaypoint(type= "repair")
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储==
与[[自定义内存]]相比，虽然<code>customTarget1</code>与<code>customTarget2</code>与<code>@memory x:unit</code>功能相当，但前者能实时清理使用不了的单位。
单位生产、产生出来时，它的'''自定义目标1'''默认为工厂（把你生成出来的单位），这很有用，工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉产物''把你生产出来的是谁''。

==空引用==
单位引用中，'''空'''（<code>null</code>）指向不存在的单位引用。逻辑布尔值（<code>Logic Boolean</code>，类似条件判断）中，可搭配不等式避免返回<code>Unit</code>类型。[[自定义内存]]中，也可作为空值赋值，也可用于清空[[数组]]。'''空单位引用'''<code>nullUnit</code>与前者不同，不可用于清空数组。

单位引用

2025-07-20T05:28:55Z

GMBOX：/* 全局 */

'''单位引用'''（Unit Reference）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()
getOffsetAbsolute()
createMarker()
|-
|局内
|thisActionTarget
eventSource
|-
|全局
|attachment()
transporting()
attacking
lastDamagedBy
parent
activeWaypointTarget
nearestUnit()
globalSearchForFirstUnit()
|-
|存储
|customTarget1
customTarget2
|-
|其他
|nullUnit
|}
==标记==
临时、快速地创建一个标记，可用来反映位置、朝向、高度、队伍编号，且不需要用到时会自动移除，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
teleportTo: getOffsetRelative(y= 10, dirOffset= self.customTimer)

fireXTurretAtGround_withTarget: createMarker(activeWaypointTarget.x, activeWaypointTarget.y, teamId= self.teamId).nearestUnit(withinRange= 1500, withTag= "outpost", relation= "own")
</pre>}}

==局内==
局内只能在行动内使用，可用<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>延长“寿命”，你也可以用内存将其存储。<code>thisActionTarget</code>在不同情况下所指代的单位不同，与<code>eventSource</code>不同，后者只与<code>autoTriggerOnEvent</code>绑定，触发的事件不同所指代的单位也不同。
===thisActionIndex的用法===
<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，<code>index</code>为其缩略形式。受<code>alsoTriggerActionRepeat</code>与<code>takeResources_triggerActionForEach</code>影响。值为int（整数）类型，从0开始，用于遍历数组。
<pre>eg:
[hiddenAction_1]
alsoTriggerAction:2
alsoTriggerActionRepeat:memory.array.size
[hiddenAction_2]
setUnitMemory:array[index]=select(memory.array[index]==0,0,memory.array[index]-1)</pre>

===对应的情况===
{| class="wikitable"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|被添加路径点的单位（没明确指定某个单位时则为在那个位置的标记，如move等）
|}

{| class="wikitable"
|+eventSource用处
|tookDamage
|攻击你的单位
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
onShoot_triggerActions: idol
[hiddenAction_idol]
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
autoTriggerOnEvent: tookDamage(withTag="APCR")
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==全局==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，与'''局内'''相对。

===选填参数部分===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation], [incompleteBuildings], [withoutTag])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation], [incompleteBuildings])</code>

====参数都为选填，默认情况就很有趣了。====
*附属
不填参数则返回行数最高的单位。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围约为500内的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。
<code>attacking</code>为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式。<code>lastDamagedBy</code>在事件来源为tookDamage时的快捷引用方式。<code>parent</code>在单位自身为他人附属时可使用。<code>activeWaypointTarget</code>能够实时监控路径点情况，如果没明确指定某个单位则返回在那个位置的标记（Marker），但似乎不能获取该路径点的类型，路径点类型可[https://docs.google.com/spreadsheets/d/1aeP3pUic0IutZlgGix_cM8xR7LEH44gS4itAxETK954/htmlview 详见]代码<code>addWaypoint_type</code>。

{{折叠|全局单位引用的例子|<pre>
isVisible: if parent.attachment(slot= 5) == self

[hiddenAction_repair]
autoTriggerOnEvent: newWaypointGivenByPlayer
requireConditional: if self.hasActiveWaypoint(type= "repair")
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储==
与[[自定义内存]]相比，虽然<code>customTarget1</code>与<code>customTarget2</code>与<code>@memory x:unit</code>功能相当，但前者能实时清理使用不了的单位。
单位生产、产生出来时，它的'''自定义目标1'''默认为工厂（把你生成出来的单位），这很有用，工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉产物''把你生产出来的是谁''。

==其他==
<code>nullUnit</code>有另一种写法，也就是<code>null</code>，但后者更泛用且简略，前者更像是特指，特指'''空'''的是单位。

模块化蜘蛛

2025-07-17T15:54:21Z

GMBOX：/* 你知道吗 */

{{欢迎编辑}}

==基本信息==
'''模块化蜘蛛'''（modularSpider）是一种可以装备模块的强大实验单位。
{{Units|name=模块化蜘蛛|price=90000|hp=10000|mass=120000|turn_speed=0.4|move_speed=0.6|extra=* 由6个模块槽提供武器和功能
}}

==来源==
*在沙盒中建造
*作为开局单位

==优点==
*可以装载模块。
*能自己赚钱。
*血量非常高。
*拥有护盾功能。
*能极速的建造部分单位。
*死亡会核爆。
*能自动修复其他单位。

==缺点==
*无法反潜。
*被喷火机甲，轰炸机克制。
==模块介绍==
*此单位可以装备6个模块，每个模块都可以装备对应的武器。
*当装载了任何一个模块时，它的移动速度会降低。<s>速度模块</s>
*速度模块可以让搭载模块的模块蜘蛛速度恢复空装状态，多余的速度模块没有用
*模块有自己的血量，也可以被敌方单位直接集火攻击，但敌方单位无法绕过蜘蛛自身的盾
==单位设计==
（待补充）
==作用==
搭配飞行堡垒可以突袭敌人大后方（最好多带几架血厚的飞机抗伤）
==你知道吗==

* 在[[1.15|1.15p9]]更新后，选中模块化蜘蛛的槽位可以看到一个箭头指向选择的槽位，这个箭头是由贴花节实现的，也是官方单位首次使用贴花节。
* 官方单位首次使用<code>setUnitStats</code>代码是在模块化蜘蛛的速度模块。

==技术性==
{{折叠|1=单位数据|2=<table border="1">
<tr><th>名称</th><td>英文名：Modular Spider 参考译名：模块蜘蛛</td></tr>
<tr><th>类型</th><td>实验陆军</td></tr>
<tr><th>可建造</th><td>-建造者，成本：$500，耗时：1s -建造船，成本：$500，耗时：2.1s -战斗工程师，成本：$3500，耗时：8.3s -重型坦克，成本：$800，耗时：1.9s -登陆艇，成本：$600，耗时：0.7s -重型悬浮坦克，成本：$1000，耗时：2.1s -自行火炮，成本：$900，耗时：1.5s -侦察者，成本：$700，耗时：1.4s -枪塔-T1，成本：$500，耗时：2.6s -火炮-T1，成本：$2100，耗时：5.2s -导弹塔-T1，成本：$600，耗时：2.6s -抽取器-T1，成本：$700，耗时：2.1s -制造器-T1，成本：$2200，耗时：4.2s -陆军工厂-T1，成本：$700，耗时：2.1s -机甲工厂-T1，成本：$1000，耗时：2.1s -空军工厂-T1，成本：$1000，耗时：2.1s -海军工厂-T1，成本：$1000，耗时：3s -激光防御-T1，成本：$1200，耗时：2.1s -修复湾，成本：$1500，耗时：2.1s -轰炸机，成本：$4000，耗时：16.7s</td></tr>
<tr><th>资源</th><td>hp：10000，回复：6/s shield：5000，回复：18/s credits：+45/s</td></tr>
<tr><th>碰撞</th><td>半径：49 质量：120000 软碰撞：3</td></tr>
<tr><th>运输需</th><td>14格</td></tr>
<tr><th>纳米</th><td>范围：220，建造速度：8倍 维修：单位，建筑，速度：24/s 回收：单位，建筑，速度：122.4/s</td></tr>
<tr><th>技能</th><td>「核爆」： -被摧毁时核爆，对200半径内的所有地上和空中单位造成最高4400的中心扩散伤害</td></tr>
<tr><th>运动</th><td>最大移动速度：36/s 最大转向速度：24°/s</td></tr>
<tr><th rowSpan="12">模块</th><td>说明：共6个炮座，凡有一个炮台本体移动速度由36/s减到24/s，本体有护盾时对炮台的伤害都转移到护盾上(范围武器快速破盾!)，炮台50%原价3秒回收</td></tr>
<tr><td>可用武器：「等离子T1/T2」、「机枪T2/T3」、「电击」、「火炮」、「对空导弹T1/T3/高射炮」、「资源制造仪T1/T2」、「激光防御」、「护盾加速」、「移速增加」、「反核防御」、「瞬移」</td>
</table>}}

单位引用

2025-06-30T07:07:07Z

GMBOX：/* 无参数部分 */

'''单位引用'''（Unit Reference）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()
getOffsetAbsolute()
createMarker()
|-
|局内
|thisActionTarget
eventSource
|-
|全局
|attachment()
transporting()
attacking
lastDamagedBy
parent
activeWaypointTarget
nearestUnit()
globalSearchForFirstUnit()
|-
|存储
|customTarget1
customTarget2
|-
|其他
|nullUnit
|}
==标记==
临时、快速地创建一个标记，可用来反映位置、朝向、高度、队伍编号，且不需要用到时会自动移除，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
teleportTo: getOffsetRelative(y= 10, dirOffset= self.customTimer)

fireXTurretAtGround_withTarget: createMarker(activeWaypointTarget.x, activeWaypointTarget.y, teamId= self.teamId).nearestUnit(withinRange= 1500, withTag= "outpost", relation= "own")
</pre>}}

==局内==
局内只能在行动内使用，可用<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>延长“寿命”，你也可以用内存将其存储。<code>thisActionTarget</code>在不同情况下所指代的单位不同，与<code>eventSource</code>不同，后者只与<code>autoTriggerOnEvent</code>绑定，触发的事件不同所指代的单位也不同。
===thisActionIndex的用法===
<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，<code>index</code>为其缩略形式。受<code>alsoTriggerActionRepeat</code>与<code>takeResources_triggerActionForEach</code>影响。

===对应的情况===
{| class="wikitable"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|被添加路径点的单位（没明确指定某个单位时则为在那个位置的标记，如move等）
|}

{| class="wikitable"
|+eventSource用处
|tookDamage
|攻击你的单位
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
onShoot_triggerActions: idol
[hiddenAction_idol]
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
autoTriggerOnEvent: tookDamage(withTag="APCR")
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==全局==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，与'''局内'''相对。

===选填参数部分===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation])</code>

====参数都为选填，默认情况就很有趣了。====
*附属
不填参数则返回行数最高的单位。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围约为500内的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。
<code>attacking</code>为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式。<code>lastDamagedBy</code>在事件来源为tookDamage时的快捷引用方式。<code>parent</code>在单位自身为他人附属时可使用。<code>activeWaypointTarget</code>能够实时监控路径点情况，如果没明确指定某个单位则返回在那个位置的标记（Marker），但似乎不能获取该路径点的类型，路径点类型可[https://docs.google.com/spreadsheets/d/1aeP3pUic0IutZlgGix_cM8xR7LEH44gS4itAxETK954/htmlview 详见]代码<code>addWaypoint_type</code>。

{{折叠|全局单位引用的例子|<pre>
isVisible: if parent.attachment(slot= 5) == self

[hiddenAction_repair]
autoTriggerOnEvent: newWaypointGivenByPlayer
requireConditional: if self.hasActiveWaypoint(type= "repair")
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储==
与[[自定义内存]]相比，虽然<code>customTarget1</code>与<code>customTarget2</code>与<code>@memory x:unit</code>功能相当，但前者能实时清理使用不了的单位。
单位生产、产生出来时，它的'''自定义目标1'''默认为工厂（把你生成出来的单位），这很有用，工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉产物''把你生产出来的是谁''。

==其他==
<code>nullUnit</code>有另一种写法，也就是<code>null</code>，但后者更泛用且简略，前者更像是特指，特指'''空'''的是单位。

单位引用

2025-06-30T06:56:05Z

GMBOX：描述不全。

'''单位引用'''（Unit Reference）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()
getOffsetAbsolute()
createMarker()
|-
|局内
|thisActionTarget
eventSource
|-
|全局
|attachment()
transporting()
attacking
lastDamagedBy
parent
activeWaypointTarget
nearestUnit()
globalSearchForFirstUnit()
|-
|存储
|customTarget1
customTarget2
|-
|其他
|nullUnit
|}
==标记==
临时、快速地创建一个标记，可用来反映位置、朝向、高度、队伍编号，且不需要用到时会自动移除，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
teleportTo: getOffsetRelative(y= 10, dirOffset= self.customTimer)

fireXTurretAtGround_withTarget: createMarker(activeWaypointTarget.x, activeWaypointTarget.y, teamId= self.teamId).nearestUnit(withinRange= 1500, withTag= "outpost", relation= "own")
</pre>}}

==局内==
局内只能在行动内使用，可用<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>延长“寿命”，你也可以用内存将其存储。<code>thisActionTarget</code>在不同情况下所指代的单位不同，与<code>eventSource</code>不同，后者只与<code>autoTriggerOnEvent</code>绑定，触发的事件不同所指代的单位也不同。
===thisActionIndex的用法===
<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，<code>index</code>为其缩略形式。受<code>alsoTriggerActionRepeat</code>与<code>takeResources_triggerActionForEach</code>影响。

===对应的情况===
{| class="wikitable"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|被添加路径点的单位（没明确指定某个单位时则为在那个位置的标记，如move等）
|}

{| class="wikitable"
|+eventSource用处
|tookDamage
|攻击你的单位
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
onShoot_triggerActions: idol
[hiddenAction_idol]
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
autoTriggerOnEvent: tookDamage(withTag="APCR")
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==全局==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，与'''局内'''相对。

===选填参数部分===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation])</code>

====参数都为选填，默认情况就很有趣了。====
*附属
不填参数则返回行数最高的单位。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围约为500内的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。
<code>attacking</code>为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式。<code>lastDamagedBy</code>在事件来源为tookDamage时的快捷引用方式。<code>parent</code>在单位自身为他人附属时可使用。

{{折叠|全局单位引用的例子|<pre>
isVisible: if parent.attachment(slot= 5) == self

[hiddenAction_repair]
autoTriggerOnEvent: newWaypointGivenByPlayer
requireConditional: if self.hasActiveWaypoint(type= "repair")
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储==
与[[自定义内存]]相比，虽然<code>customTarget1</code>与<code>customTarget2</code>与<code>@memory x:unit</code>功能相当，但前者能实时清理使用不了的单位。
单位生产、产生出来时，它的'''自定义目标1'''默认为工厂（把你生成出来的单位），这很有用，工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉产物''把你生产出来的是谁''。

==其他==
<code>nullUnit</code>有另一种写法，也就是<code>null</code>，但后者更泛用且简略，前者更像是特指，特指'''空'''的是单位。

单位引用

2025-06-29T12:47:29Z

GMBOX：/* 局内 */错别字。

'''单位引用'''（Unit Reference）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()
getOffsetAbsolute()
createMarker()
|-
|局内
|thisActionTarget
eventSource
|-
|全局
|attachment()
transporting()
attacking
lastDamagedBy
parent
activeWaypointTarget
nearestUnit()
globalSearchForFirstUnit()
|-
|存储
|customTarget1
customTarget2
|-
|其他
|nullUnit
|}
==标记==
临时、快速地创建一个标记，可用来反映位置、朝向、高度、队伍编号，且不需要用到时会自动移除，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
teleportTo: getOffsetRelative(y= 10, dirOffset= self.customTimer)

fireXTurretAtGround_withTarget: createMarker(activeWaypointTarget.x, activeWaypointTarget.y, teamId= self.teamId).nearestUnit(withinRange= 1500, withTag= "outpost", relation= "own")
</pre>}}

==局内==
局内只能在行动内使用，可用<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>延长“寿命”，你也可以用内存将其存储。<code>thisActionTarget</code>在不同情况下所指代的单位不同，与<code>eventSource</code>不同，后者只与<code>autoTriggerOnEvent</code>绑定，触发的事件不同所指代的单位也不同。
===thisActionIndex的用法===
<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，<code>index</code>为其缩略形式。受<code>alsoTriggerActionRepeat</code>与<code>takeResources_triggerActionForEach</code>影响。

===对应的情况===
{| class="wikitable"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|添加路径的位置（攻击则为被攻击的单位）
|}

{| class="wikitable"
|+eventSource用处
|tookDamage
|攻击你的单位
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
onShoot_triggerActions: idol
[hiddenAction_idol]
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
autoTriggerOnEvent: tookDamage(withTag="APCR")
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==全局==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，与'''局内'''相对。

===选填参数部分===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation])</code>

====参数都为选填，默认情况就很有趣了。====
*附属
不填参数则返回行数最高的单位。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围约为500内的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。
<code>attacking</code>为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式。<code>lastDamagedBy</code>在事件来源为tookDamage时的快捷引用方式。<code>parent</code>在单位自身为他人附属时可使用。

{{折叠|全局单位引用的例子|<pre>
isVisible: if parent.attachment(slot= 5) == self

[hiddenAction_repair]
autoTriggerOnEvent: newWaypointGivenByPlayer
requireConditional: if self.hasActiveWaypoint(type= "repair")
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储==
与[[自定义内存]]相比，虽然<code>customTarget1</code>与<code>customTarget2</code>与<code>@memory x:unit</code>功能相当，但前者能实时清理使用不了的单位。
单位生产、产生出来时，它的'''自定义目标1'''默认为工厂（把你生成出来的单位），这很有用，工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉产物''把你生产出来的是谁''。

==其他==
<code>nullUnit</code>有另一种写法，也就是<code>null</code>，但后者更泛用且简略，前者更像是特指，特指'''空'''的是单位。

单位引用

2025-06-29T12:46:43Z

GMBOX：/* 标记的格式 */错别字。

'''单位引用'''（Unit Reference）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()
getOffsetAbsolute()
createMarker()
|-
|局内
|thisActionTarget
eventSource
|-
|全局
|attachment()
transporting()
attacking
lastDamagedBy
parent
activeWaypointTarget
nearestUnit()
globalSearchForFirstUnit()
|-
|存储
|customTarget1
customTarget2
|-
|其他
|nullUnit
|}
==标记==
临时、快速地创建一个标记，可用来反映位置、朝向、高度、队伍编号，且不需要用到时会自动移除，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [dirOffset])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
teleportTo: getOffsetRelative(y= 10, dirOffset= self.customTimer)

fireXTurretAtGround_withTarget: createMarker(activeWaypointTarget.x, activeWaypointTarget.y, teamId= self.teamId).nearestUnit(withinRange= 1500, withTag= "outpost", relation= "own")
</pre>}}

==局内==
局内只能在行动内使用，可用<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>延长“寿命”，你也可以用内存将其存储。<code>thisActionTarget</code>在不同情况下所指代的单位不同，与<code>eventSource</code>不同，后者只与<code>autoTriggerOnEvent</code>绑定，触发的事件不同所指代的单位也不同。
===thisActionIndex的用法===
<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，<code>index</code>为其缩略形式。受<code>alsoTriggerActionRepeat</code>与<code>takeResources_triggerActionForEach</code>影响。

===对应的情况===
{| class="wikitable"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|添加路径的位置（攻击则为被攻击的单位）
|}

{| class="wikitable"
|+eventSource用处
|tookDamage
|攻击你的单位
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
onShoot_triggerActions: idol
[hiddenAction_idol]
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
autoTriggerOnEvent: tookDamge(withTag="APCR")
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==全局==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，与'''局内'''相对。

===选填参数部分===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation])</code>

====参数都为选填，默认情况就很有趣了。====
*附属
不填参数则返回行数最高的单位。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围约为500内的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。
<code>attacking</code>为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式。<code>lastDamagedBy</code>在事件来源为tookDamage时的快捷引用方式。<code>parent</code>在单位自身为他人附属时可使用。

{{折叠|全局单位引用的例子|<pre>
isVisible: if parent.attachment(slot= 5) == self

[hiddenAction_repair]
autoTriggerOnEvent: newWaypointGivenByPlayer
requireConditional: if self.hasActiveWaypoint(type= "repair")
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储==
与[[自定义内存]]相比，虽然<code>customTarget1</code>与<code>customTarget2</code>与<code>@memory x:unit</code>功能相当，但前者能实时清理使用不了的单位。
单位生产、产生出来时，它的'''自定义目标1'''默认为工厂（把你生成出来的单位），这很有用，工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉产物''把你生产出来的是谁''。

==其他==
<code>nullUnit</code>有另一种写法，也就是<code>null</code>，但后者更泛用且简略，前者更像是特指，特指'''空'''的是单位。

单位引用

2025-06-29T09:39:29Z

GMBOX：/* thisActionIndex的用法 */

'''单位引用'''（Unit Reference）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()
getOffsetAbsolute()
createMarker()
|-
|局内
|thisActionTarget
eventSource
|-
|全局
|attachment()
transporting()
attacking
lastDamagedBy
parent
activeWaypointTarget
nearestUnit()
globalSearchForFirstUnit()
|-
|存储
|customTarget1
customTarget2
|-
|其他
|nullUnit
|}
==标记==
临时、快速地创建一个标记，可用来反映位置、朝向、高度、队伍编号，且不需要用到时会自动移除，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [offsetDir])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
teleportTo: getOffsetRelative(y= 10, dirOffset= self.customTimer)

fireXTurretAtGround_withTarget: createMarker(activeWaypointTarget.x, activeWaypointTarget.y, teamId= self.teamId).nearestUnit(withinRange= 1500, withTag= "outpost", relation= "own")
</pre>}}

==局内==
局内只能在行动内使用，可用<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>延长“寿命”，你也可以用内存将其存储。<code>thisActionTarget</code>在不同情况下所指代的单位不同，与<code>eventSource</code>不同，后者只与<code>autoTriggerOnEvent</code>绑定，触发的事件不同所指代的单位也不同。
===thisActionIndex的用法===
<code>thisActionIndex</code>能在遍历过程中同时知道每个元素的位置信息，<code>index</code>为其缩略形式。受<code>alsoTriggerActionRepeat</code>与<code>takeResources_triggerActionForEach</code>影响。

===对应的情况===
{| class="wikitable"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|添加路径的位置（攻击则为被攻击的单位）
|}

{| class="wikitable"
|+eventSource用处
|tookDamage
|攻击你的单位
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|-
|newMessage
|给这个单位发信的单位
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
onShoot_triggerActions: idol
[hiddenAction_idol]
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
autoTriggerOnEvent: tookDamge(withTag="APCR")
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==全局==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，与'''局内'''相对。

===选填参数部分===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation])</code>

====参数都为选填，默认情况就很有趣了。====
*附属
不填参数则返回行数最高的单位。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围约为500内的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。
<code>attacking</code>为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式。<code>lastDamagedBy</code>在事件来源为tookDamage时的快捷引用方式。<code>parent</code>在单位自身为他人附属时可使用。

{{折叠|全局单位引用的例子|<pre>
isVisible: if parent.attachment(slot= 5) == self

[hiddenAction_repair]
autoTriggerOnEvent: newWaypointGivenByPlayer
requireConditional: if self.hasActiveWaypoint(type= "repair")
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储==
与[[自定义内存]]相比，虽然<code>customTarget1</code>与<code>customTarget2</code>与<code>@memory x:unit</code>功能相当，但前者能实时清理使用不了的单位。
单位生产、产生出来时，它的'''自定义目标1'''默认为工厂（把你生成出来的单位），这很有用，工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉产物''把你生产出来的是谁''。

==其他==
<code>nullUnit</code>有另一种写法，也就是<code>null</code>，但后者更泛用且简略，前者更像是特指，特指'''空'''的是单位。

单位引用

2025-06-29T05:19:43Z

GMBOX：

'''单位引用'''（Unit Reference）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()
getOffsetAbsolute()
createMarker()
|-
|局内
|thisActionTarget
eventSource
|-
|全局
|attachment()
transporting()
attacking
lastDamagedBy
parent
activeWaypointTarget
nearestUnit()
globalSearchForFirstUnit()
|-
|存储
|customTarget1
customTarget2
|-
|其他
|nullUnit
|}
==标记==
临时、快速地创建一个标记，可用来反映位置、朝向、高度、队伍编号，且不需要用到时会自动移除，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [offsetDir])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
teleportTo: getOffsetRelative(y= 10, dirOffset= self.customTimer)

fireXTurretAtGround_withTarget: createMarker(activeWaypointTarget.x, activeWaypointTarget.y, teamId= self.teamId).nearestUnit(withinRange= 1500, withTag= "outpost", relation= "own")
</pre>}}

==局内==
局内只能在行动内使用，可用<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>延长“寿命”，你也可以用内存将其存储。<code>thisActionTarget</code>在不同情况下所指代的单位不同，与<code>eventSource</code>不同，后者只与<code>autoTriggerOnEvent</code>绑定，触发的事件不同所指代的单位也不同。
===thisActionIndex的用法===
<code>thisActionIndex</code>，<code>index</code>为其缩略形式。
...待补充

===对应的情况===
{| class="wikitable"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|添加路径的位置（攻击则为被攻击的单位）
|}

{| class="wikitable"
|+eventSource用处
|tookDamage
|攻击你的单位
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
onShoot_triggerActions: idol
[hiddenAction_idol]
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
autoTriggerOnEvent: tookDamge(withTag="APCR")
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==全局==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，与'''局内'''相对。

===选填参数部分===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation])</code>

====参数都为选填，默认情况就很有趣了。====
*附属
不填参数则返回行数最高的单位。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围约为500内的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。
<code>attacking</code>为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式。<code>lastDamagedBy</code>在事件来源为tookDamage时的快捷引用方式。<code>parent</code>在单位自身为他人附属时可使用。

{{折叠|全局单位引用的例子|<pre>
isVisible: if parent.attachment(slot= 5) == self

[hiddenAction_repair]
autoTriggerOnEvent: newWaypointGivenByPlayer
requireConditional: if self.hasActiveWaypoint(type= "repair")
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储==
与[[自定义内存]]相比，虽然<code>customTarget1</code>与<code>customTarget2</code>与<code>@memory x:unit</code>功能相当，但前者能实时清理使用不了的单位。
单位生产、产生出来时，它的'''自定义目标1'''默认为工厂（把你生成出来的单位），这很有用，工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉产物''把你生产出来的是谁''。

==其他==
<code>nullUnit</code>有另一种写法，也就是<code>null</code>，但后者更泛用且简略，前者更像是特指，特指'''空'''的是单位。

单位引用

2025-06-29T05:15:05Z

GMBOX：/* 其他 */

{{欢迎编辑}}
'''单位引用'''（Unit Reference）是铁锈战争[[1.15]]新加入的单位选择器，可引用符合条件的单位。

==查询==
{| class="wikitable"
|+单位引用
|标记
|getAsMarker()
getOffsetRelative()
getOffsetAbsolute()
createMarker()
|-
|局内
|thisActionTarget
eventSource
|-
|全局
|attachment()
transporting()
attacking
lastDamagedBy
parent
activeWaypointTarget
nearestUnit()
globalSearchForFirstUnit()
|-
|存储
|customTarget1
customTarget2
|-
|其他
|nullUnit
|}
==标记==
临时、快速地创建一个标记，可用来反映位置、朝向、高度、队伍编号，且不需要用到时会自动移除，不隶属任何单位也不受单位后续行为的影响。
标记可分为两种，照铁锈战争的说法，一种是'''获取'''（get...），另一种是'''创建'''(create...)。获取会在以单位的基础创建标记，而'''创建'''完全与创建它的单位无关。
===标记的格式===
获取：<code>getAsMarker()</code>
相对：<code>getOffsetRelative([x], [y], [height], [offsetDir])</code>
绝对：<code>getOffsetAbsolute([x], [y], [height])</code>
创建：<code>createMarker(x, y, [height], [teamId], [dir])</code>

===标记的用法===
想直接获取当前位置等信息可以使用<code>getAsMarker</code>。
铁锈战争为偏移提供了两种方案，一种是'''相对偏移'''，不止受单位位置、高度，还受朝向影响。通俗易懂就是你坐在一辆车上，你当然可以移动、旋转（<code>dirOffset</code>），但车移动、旋转你也必须移动、旋转。
另一种是'''绝对偏移'''，只受单位位置、高度影响，比如单位坐标(1000, 1000)，向左偏移5个单位（995, 1000）。
'''创建标记'''是直接在地图上创建一个标记，队伍编号可由自己决定，可以注意的是创建标记的(x, y)必须要填，但铁锈战争允许省略<code>(x=, y=)</code>。

{{折叠|标记的例子|<pre>
teleportTo: getOffsetRelative(y= 10, dirOffset= self.customTimer)

fireXTurretAtGround_withTarget: createMarker(activeWaypointTarget.x, activeWaypointTarget.y, teamId= self.teamId).nearestUnit(withinRange= 1500, withTag= "outpost", relation= "own")
</pre>}}

==局内==
局内只能在行动内使用，可用<code>alsoTriggerAction</code>或<code>alsoQueueAction</code>延长“寿命”，你也可以用内存将其存储。<code>thisActionTarget</code>在不同情况下所指代的单位不同，与<code>eventSource</code>不同，后者只与<code>autoTriggerOnEvent</code>绑定，触发的事件不同所指代的单位也不同。
===thisActionIndex的用法===
<code>thisActionIndex</code>，<code>index</code>为其缩略形式。
...待补充

===对应的情况===
{| class="wikitable"
|+thisActionTarget用处
|fireXTurretAtGround
|指向的位置
|-
|alsoTriggerAction
|与原行动的thisActionTarget相同
|-
|onShoot_triggerActions
|炮塔射击的单位
|-
|takeResources_triggerActionIfAnyCollected
|提取到的单位
|-
|takeResources_triggerActionForEach
|与上同理
|-
|addWaypoint_triggerActionIfMatched
|添加路径的位置（攻击则为被攻击的单位）
|}

{| class="wikitable"
|+eventSource用处
|tookDamage
|攻击你的单位
|-
|killedAnyUnit
|杀死的单位
|-
|transportingNewUnit
|新装载的单位
|-
|transportUnloadedOrRemovedUnit
|刚卸载的单位
|-
|queuedUnitFinished
|刚生产的单位
|-
|touchTargetSuccess
|碰到的单位（需配合路径点）
|}

{{折叠|thisActionTarget与eventSource的例子|<pre>
[turret_super]
onShoot_triggerActions: idol
[hiddenAction_idol]
showMessageToAllPlayers: %{thisActionTarget}的笑容。

[hiddenAction_tookDmg]
autoTriggerOnEvent: tookDamge(withTag="APCR")
showMessageToAllPlayers: 来自%{eventSource}的攻击！
</pre>}}

==全局==
铁锈战争提供了一些常见情况可能用到的单位选择器，且所以节都能使用，与'''局内'''相对。

===选填参数部分===
附属：<code>attachment([slot], [withTag])</code>
运输：<code>transporting([slot])</code>
最近单位：<code>nearestUnit([withinRange], [withTag], [relation])</code>
搜索首个单位<code>globalSearchForFirstUnit([withTag], [relation])</code>

====参数都为选填，默认情况就很有趣了。====
*附属
不填参数则返回行数最高的单位。
*运输
不填参数则返回最近运输的单位。
*最近单位
不填参数则返回范围约为500内的单位。
*搜索首个单位
不填参数则返回该地图最小id的单位。

===无参数部分===
这些单位引用的特点很明显，都是指向具体的某个单位。
<code>attacking</code>为<code>activeWaypointTarget</code>为攻击时套上单位的快捷引用方式。<code>lastDamagedBy</code>在事件来源为tookDamage时的快捷引用方式。<code>parent</code>在单位自身为他人附属时可使用。

{{折叠|全局单位引用的例子|<pre>
isVisible: if parent.attachment(slot= 5) == self

[hiddenAction_repair]
autoTriggerOnEvent: newWaypointGivenByPlayer
requireConditional: if self.hasActiveWaypoint(type= "repair")
showMessageToPlayer: 你正在治疗%{activeWaypointTarget}。
</pre>}}

==存储==
与[[自定义内存]]相比，虽然<code>customTarget1</code>与<code>customTarget2</code>与<code>@memory x:unit</code>功能相当，但前者能实时清理使用不了的单位。
单位生产、产生出来时，它的'''自定义目标1'''默认为工厂（把你生成出来的单位），这很有用，工厂不必通过<code>queuedUnitFinished</code>事件配合<code>sendMessageTo</code>告诉产物''把你生产出来的是谁''。

==其他==
<code>nullUnit</code>有另一种写法，也就是<code>null</code>，但后者更泛用且简略，前者更像是特指，特指'''空'''的是单位。

单位引用

2025-06-29T05:12:32Z

GMBOX：/* 存储 */

单位引用

2025-06-29T05:00:54Z

GMBOX：/* 全局 */添加例子。

单位引用

2025-06-29T04:55:55Z

GMBOX：/* 标记 */

单位引用

2025-06-28T18:08:13Z

GMBOX：/* 全局 */

单位引用

2025-06-28T17:18:56Z

GMBOX：/* thisActionIndex的用法 */

单位引用

2025-06-28T17:04:40Z

GMBOX：这个页面本来写好了结果忘保存没掉了，有时间补充。

单位引用

2025-06-28T16:59:52Z

GMBOX：/* 局内 */补充局内

单位引用

2025-06-28T16:42:22Z

GMBOX：创建页面，内容为“'''单位引用'''（Unit Reference）是铁锈战争1.15新加入的单位选择器，可引用符合条件的单位。 ==查询== {| class="wikitable" |+单位引用 |标记 |getAsMarker() getOffsetRelative() getOffsetAbsolute() createMarker() |- |局内 |thisActionTarget eventSource |- |全局 |attachment() transporting() attacking lastDamagedBy parent activeWaypointTarget nearestUnit() globalSearchForFirstUnit() |- |存储 |customTarget1 customTarget2…”

用户:GMBOX

2025-06-28T16:14:30Z

GMBOX：创建页面，内容为“无名小卒，为社区添砖加瓦的一员。 QQ<code>1154534825</code>”

无名小卒，为社区添砖加瓦的一员。
QQ<code>1154534825</code>

mod的坑

2025-06-28T14:00:23Z

GMBOX：/* 相关链接 */添加内容。

== 相关链接 ==
*基础
# [[变量|宏]]
# [[自定义内存]]
# [[数组]]
# [[注解|注释]]
# [[复制]]
# [[特殊值]]
# [[单位引用]]
...待补充
*特殊
# [[随机数]]
# [[概率与随机偏移]]
# [[多单位排序]]
# [[ai优先级]]
# [[重排序]]
# [[更新延迟]]
...待补充

== 产考 ==
*[https://cra.lanzouj.com/b0agtlmih 四向扩张] 密码：00
拼装插件

...待补充

==依赖==
# [https://cra.lanzouj.com/b0agtlmih 网盘] 密码：00
##rnd 随机数生成，用于修正rnd生成相同的问题。
##clipboard 多队伍剪贴板，便捷输入float/unit。
#学画画的十山月 bilibili
##RW-Engine rw引擎，文本图像化，碰撞箱等。
#Muella bilibili
##PCMOD 便捷输入字符串，游戏内聊天等。
...更多待补充

变量

2024-04-28T12:00:34Z

GMBOX：/* 数学运算 */错别字

{{InfoBox
|image=builder.png
|border= rgb(250,10,10)
|type=
|info='''该模板需要改进，请勿模仿此页面创立新页面'''}}

'''变量'''是铁锈中一种数据存储方式，于[[1.14]]被加入。

不同于[[自定义内存|内存]]，变量的值是固定的，在ini中定义后无法修改。

== 定义 ==
在非注释节，使用<code>@global 名称:值</code>可以定义'''全局变量'''，不过请注意它在复制时会出现bug，除一些特定节，因此请按照规范将它放在core节上。 <code>@define 名称:值</code>定义'''局部变量'''。
{{折叠|变量定义例子|<pre>
[core]
@global a:100
@global b:qwerty
[action_x]
@global c:10.0
</pre>}}

== 类型 ==
铁锈中，变量包含'''全局变量'''和'''局部变量'''两种，其作用域不同。全局变量在整个ini中都能进行引用，而局部变量只能在定义该变量的节引用。同一个单位中不同的节可以定义名称相同的局部变量，而互不影响。当全局变量和局部变量重名时，局部变量优先级更高，能够在该局部变量所处的节覆盖全局变量。'''变量本身并不存在“数据结构类型”，本质上变量只是一个替换工具，在加载时引用的变量被替换为定义的值。'''
{{折叠|局部变量和全局变量例子|<pre>
[core]
@global a:10
@global b:20
[action_a]
@define a:15
#此时 ${a} 为 15
[action_b]
#此时 ${a} 为 10
#此时 ${b} 为20
</pre>}}

== 引用 ==
通过<code>${变量名}</code>可以引用变量。任何代码的值中都可以进行变量引用，但是必须保证该代码值的类型在引用后不会错误。<code>%{}</code>中也可以嵌套变量引用。

通过${core.price}，可以引用core节的price键，若节为section则只向自己，并不是所有的键都可以引用，如：@开头的无法引用。

 引用支持多个值进行替换，不过值必须满足匹配式[aA-zZ_][aA0-zZ9_.]*，且不能为运算函数。

 请注意${\s*(.*)\s*}是它的有效范围，不要在外圈填充空格。{{折叠|变量引用例子|<pre>
[core]
price:6
[action_a]
pos:1
@define str1:测
@define str2:试
#${core.price}==6
#${section.pos}==1
text:${str1}${str2}
#此时text的值为“测试”
#${str1 str2}==“测试”
</pre>}}

==数学运算==
${}支持使用double进行以下数学运算，不过它存在运算优先级问题，建议运算式加上()。
#+-*/^
#sqrt()
#int()
*rad/弧度
#sin()
#cos()
*例子
#${1+(2*2)}==5
#${sqrt(4)}==2
#a=1,b=2 ${a+b}==3
请注意如果你不想进行数学运算，那么替换式不要包含“+-*/^()”其中的任何一个。
[[分类:模组制作]]
[[分类:急需改进的页面]]

变量

2024-04-28T11:59:59Z

GMBOX：/* 数学运算 */错别字

{{InfoBox
|image=builder.png
|border= rgb(250,10,10)
|type=
|info='''该模板需要改进，请勿模仿此页面创立新页面'''}}

'''变量'''是铁锈中一种数据存储方式，于[[1.14]]被加入。

不同于[[自定义内存|内存]]，变量的值是固定的，在ini中定义后无法修改。

== 定义 ==
在非注释节，使用<code>@global 名称:值</code>可以定义'''全局变量'''，不过请注意它在复制时会出现bug，除一些特定节，因此请按照规范将它放在core节上。 <code>@define 名称:值</code>定义'''局部变量'''。
{{折叠|变量定义例子|<pre>
[core]
@global a:100
@global b:qwerty
[action_x]
@global c:10.0
</pre>}}

== 类型 ==
铁锈中，变量包含'''全局变量'''和'''局部变量'''两种，其作用域不同。全局变量在整个ini中都能进行引用，而局部变量只能在定义该变量的节引用。同一个单位中不同的节可以定义名称相同的局部变量，而互不影响。当全局变量和局部变量重名时，局部变量优先级更高，能够在该局部变量所处的节覆盖全局变量。'''变量本身并不存在“数据结构类型”，本质上变量只是一个替换工具，在加载时引用的变量被替换为定义的值。'''
{{折叠|局部变量和全局变量例子|<pre>
[core]
@global a:10
@global b:20
[action_a]
@define a:15
#此时 ${a} 为 15
[action_b]
#此时 ${a} 为 10
#此时 ${b} 为20
</pre>}}

== 引用 ==
通过<code>${变量名}</code>可以引用变量。任何代码的值中都可以进行变量引用，但是必须保证该代码值的类型在引用后不会错误。<code>%{}</code>中也可以嵌套变量引用。

通过${core.price}，可以引用core节的price键，若节为section则只向自己，并不是所有的键都可以引用，如：@开头的无法引用。

 引用支持多个值进行替换，不过值必须满足匹配式[aA-zZ_][aA0-zZ9_.]*，且不能为运算函数。

 请注意${\s*(.*)\s*}是它的有效范围，不要在外圈填充空格。{{折叠|变量引用例子|<pre>
[core]
price:6
[action_a]
pos:1
@define str1:测
@define str2:试
#${core.price}==6
#${section.pos}==1
text:${str1}${str2}
#此时text的值为“测试”
#${str1 str2}==“测试”
</pre>}}

==数学运算==
${}支持使用double进行以下数学运算，不过它存在运算优先级问题，建议运算式加上()。
#+-*/^
#sqrt()
#int()
*rad/弧度
#sin()
#cos()
*例子
#${1+(2*2)}==5
#${sprt(4)}==2
#a=1,b=2 ${a+b}==3
请注意如果你不想进行数学运算，那么替换式不要包含“+-*/^()”其中的任何一个。
[[分类:模组制作]]
[[分类:急需改进的页面]]

变量

2024-04-28T11:28:06Z

GMBOX：/* 引用 */错别字

{{InfoBox
|image=builder.png
|border= rgb(250,10,10)
|type=
|info='''该模板需要改进，请勿模仿此页面创立新页面'''}}

'''变量'''是铁锈中一种数据存储方式，于[[1.14]]被加入。

不同于[[自定义内存|内存]]，变量的值是固定的，在ini中定义后无法修改。

== 定义 ==
在非注释节，使用<code>@global 名称:值</code>可以定义'''全局变量'''，不过请注意它在复制时会出现bug，除一些特定节，因此请按照规范将它放在core节上。 <code>@define 名称:值</code>定义'''局部变量'''。
{{折叠|变量定义例子|<pre>
[core]
@global a:100
@global b:qwerty
[action_x]
@global c:10.0
</pre>}}

== 类型 ==
铁锈中，变量包含'''全局变量'''和'''局部变量'''两种，其作用域不同。全局变量在整个ini中都能进行引用，而局部变量只能在定义该变量的节引用。同一个单位中不同的节可以定义名称相同的局部变量，而互不影响。当全局变量和局部变量重名时，局部变量优先级更高，能够在该局部变量所处的节覆盖全局变量。'''变量本身并不存在“数据结构类型”，本质上变量只是一个替换工具，在加载时引用的变量被替换为定义的值。'''
{{折叠|局部变量和全局变量例子|<pre>
[core]
@global a:10
@global b:20
[action_a]
@define a:15
#此时 ${a} 为 15
[action_b]
#此时 ${a} 为 10
#此时 ${b} 为20
</pre>}}

== 引用 ==
通过<code>${变量名}</code>可以引用变量。任何代码的值中都可以进行变量引用，但是必须保证该代码值的类型在引用后不会错误。<code>%{}</code>中也可以嵌套变量引用。

通过${core.price}，可以引用core节的price键，若节为section则只向自己，并不是所有的键都可以引用，如：@开头的无法引用。

 引用支持多个值进行替换，不过值必须满足匹配式[aA-zZ_][aA0-zZ9_.]*，且不能为运算函数。

 请注意${\s*(.*)\s*}是它的有效范围，不要在外圈填充空格。{{折叠|变量引用例子|<pre>
[core]
price:6
[action_a]
pos:1
@define str1:测
@define str2:试
#${core.price}==6
#${section.pos}==1
text:${str1}${str2}
#此时text的值为“测试”
#${str1 str2}==“测试”
</pre>}}

==数学运算==
${}支持使用double进行以下数学运算，不过它存在运算优先级问题，建议运算式加上()。
#+-*/^
#sprt()
#int()
*rad/弧度
#sin()
#cos()
*例子
#${1+(2*2)}==5
#${sprt(4)}==2
#a=1,b=2 ${a+b}==3
请注意如果你不想进行数学运算，那么替换式不要包含“+-*/^()”其中的任何一个。
[[分类:模组制作]]
[[分类:急需改进的页面]]

变量

2024-04-28T11:26:35Z

GMBOX：/* 引用 */错别字

{{InfoBox
|image=builder.png
|border= rgb(250,10,10)
|type=
|info='''该模板需要改进，请勿模仿此页面创立新页面'''}}

'''变量'''是铁锈中一种数据存储方式，于[[1.14]]被加入。

不同于[[自定义内存|内存]]，变量的值是固定的，在ini中定义后无法修改。

== 定义 ==
在非注释节，使用<code>@global 名称:值</code>可以定义'''全局变量'''，不过请注意它在复制时会出现bug，除一些特定节，因此请按照规范将它放在core节上。 <code>@define 名称:值</code>定义'''局部变量'''。
{{折叠|变量定义例子|<pre>
[core]
@global a:100
@global b:qwerty
[action_x]
@global c:10.0
</pre>}}

== 类型 ==
铁锈中，变量包含'''全局变量'''和'''局部变量'''两种，其作用域不同。全局变量在整个ini中都能进行引用，而局部变量只能在定义该变量的节引用。同一个单位中不同的节可以定义名称相同的局部变量，而互不影响。当全局变量和局部变量重名时，局部变量优先级更高，能够在该局部变量所处的节覆盖全局变量。'''变量本身并不存在“数据结构类型”，本质上变量只是一个替换工具，在加载时引用的变量被替换为定义的值。'''
{{折叠|局部变量和全局变量例子|<pre>
[core]
@global a:10
@global b:20
[action_a]
@define a:15
#此时 ${a} 为 15
[action_b]
#此时 ${a} 为 10
#此时 ${b} 为20
</pre>}}

== 引用 ==
通过<code>${变量名}</code>可以引用变量。任何代码的值中都可以进行变量引用，但是必须保证该代码值的类型在引用后不会错误。<code>%{}</code>中也可以嵌套变量引用。

通过${core.price}，可以引用core节的price键，诺节为section则只向自己，并不是所有的键都可以引用，如：@开头的无法引用。

 引用支持多个值进行替换，不过值必须满足匹配式[aA-zZ_][aA0-zZ9_.]*，且不能为运算函数。

 请注意${\s*(.*)\s*}是它的有效范围，不要在外圈填充空格。{{折叠|变量引用例子|<pre>
[core]
price:6
[action_a]
pos:1
@define str1:测
@define str2:试
#${core.price}==6
#${section.pos}==1
text:${str1}${str2}
#此时text的值为“测试”
#${str1 str2}==“测试”
</pre>}}

==数学运算==
${}支持使用double进行以下数学运算，不过它存在运算优先级问题，建议运算式加上()。
#+-*/^
#sprt()
#int()
*rad/弧度
#sin()
#cos()
*例子
#${1+(2*2)}==5
#${sprt(4)}==2
#a=1,b=2 ${a+b}==3
请注意如果你不想进行数学运算，那么替换式不要包含“+-*/^()”其中的任何一个。
[[分类:模组制作]]
[[分类:急需改进的页面]]

话题:Y1ihuysw4hixakjl

2024-03-23T05:26:18Z

GMBOX（留言 | 贡献）已评论"copyFrom的优先级更大，还是全单位模板"的话题(我怀疑了词条里面的优先级问题，全单位模板优先级高在这里却不成立，难不成有别的前提？)

话题:Y1ihuysw4hixakjl

2024-03-23T05:18:10Z

GMBOX（留言 | 贡献）已编辑于“copyFrom的优先级更大，还是全单位模板”的帖子

话题:Y1ihuysw4hixakjl

2024-03-23T05:16:58Z

GMBOX（留言 | 贡献）已编辑于“copyFrom的优先级更大，还是全单位模板”的帖子

话题:Y1ihuysw4hixakjl

2024-03-23T05:15:24Z

GMBOX（留言 | 贡献）已评论"copyFrom的优先级更大，还是全单位模板"的话题(a.ini [core] copyFrom: ROOT:all-units.template, CORE:scout/scout.ini @global num:0 本目录的全单位模板。 copyFrom: ROOT:all-units.template name: pawn_…)

自定义内存

2024-03-22T11:01:03Z

GMBOX：/* 修改 */添加注意事项。

'''自定义内存'''（memory）是铁锈[[1.15]]加入的一种数据存储方式。

''提示:这个页面专指自定义内存，而不包含[[数组|自定义内存数组]]([[1.15|1.15p11]]更新)的内容。''

==类型==
{| class="wikitable"
|+memory的类型
|boolean
|布尔值
|-
|float
|浮点数
|-
|number
|整数(float)
|-
|unit
|单位
|-
|string
|字符串
|}

==定义==
在[core]节中，可以使用<code>defineUnitMemory</code>和<code>@memory</code>来定义内存，内存名字可以是中文，但请注意，应避免使用特殊符号命名。

=== 通过defineUnitMemory定义 ===
在[core]节中添加: <code>defineUnitMemory:类型名称,类型名称......</code>
{{折叠|defineUnitMemory例子|<pre>
defineUnitMemory:boolean is_alive,float xp,unit c_target,unit father,string customText
或者
defineUnitMemory:"""
boolean is_alive,
float xp,
unit c_target,
unit father,
string customText
"""
</pre>}}

=== 通过@memory定义 ===
@memory是defineUnitMemory的快捷方式，通常由多行多个@memory组成。更推荐用于模板，defineUnitMemory可以被覆盖，致使定义的内容无法生效，@memory可以避免此种情况。

单个@memory的格式为: <code>@memory 名称:类型</code>
{{折叠|@memory的例子|<pre>
@memory dir:float
@memory amo:number
@memory armor_f:unit
</pre>}}

== 引用 ==
要引用单位内部的自定义内存，可以直接使用 <code>memory.名称</code> 。

要引用其他单位的内存，可以使用<code>readUnitMemory</code> ，格式为<code>单位引用.readUnitMemory('名称',type='类型')</code> 。
{{折叠|readUnitMemory例子|<pre>
self.customTarget1.readUnitMemory('a',type='number')
</pre>}}

== 修改 ==
在[action]中，可以通过<code>setUnitMemory</code>来直接修改内存的值，格式为<code>setUnitMemory:名称=值,名称=值...</code> 。
{{折叠|setUnitMemory例子|<pre>
# [action] 中
setUnitMemory:a=1,b=memory.b+1
</pre>}}
在[[1.15|1.15p10]]更新后，也可以通过<code>[core]updateUnitMemory</code>来维持内存更新，即每到达设定时间就进行一次内存更新，格式与<code>setUnitMemory</code>相同，但需要添加到[core]节。通过<code>[core]updateUnitMemoryRate</code>可以设置更新频率（单位为帧，填写0为不停的更新），但请不要填写NaN或NaNs，这使得<code>[core]updateUnitMemoryRate</code>不再更新。
[[分类:模组制作]]

自定义内存

2024-03-22T10:58:25Z

GMBOX：/* 通过@memory定义 */推荐使用方法。

自定义内存

2024-03-22T10:54:48Z

GMBOX：/* 定义 */添加注意事项。

'''自定义内存'''（memory）是铁锈[[1.15]]加入的一种数据存储方式。

''提示:这个页面专指自定义内存，而不包含[[数组|自定义内存数组]]([[1.15|1.15p11]]更新)的内容。''

==类型==
{| class="wikitable"
|+memory的类型
|boolean
|布尔值
|-
|float
|浮点数
|-
|number
|整数(float)
|-
|unit
|单位
|-
|string
|字符串
|}

==定义==
在[core]节中，可以使用<code>defineUnitMemory</code>和<code>@memory</code>来定义内存，内存名字可以是中文，但请注意，应避免使用特殊符号命名。

=== 通过defineUnitMemory定义 ===
在[core]节中添加: <code>defineUnitMemory:类型名称,类型名称......</code>
{{折叠|defineUnitMemory例子|<pre>
defineUnitMemory:boolean is_alive,float xp,unit c_target,unit father,string customText
或者
defineUnitMemory:"""
boolean is_alive,
float xp,
unit c_target,
unit father,
string customText
"""
</pre>}}

=== 通过@memory定义 ===
@memory是defineUnitMemory的快捷方式，通常由多行多个@memory组成。

单个@memory的格式为: <code>@memory 名称:类型</code>
{{折叠|@memory的例子|<pre>
@memory dir:float
@memory amo:number
@memory armor_f:unit
</pre>}}

== 引用 ==
要引用单位内部的自定义内存，可以直接使用 <code>memory.名称</code> 。

要引用其他单位的内存，可以使用<code>readUnitMemory</code> ，格式为<code>单位引用.readUnitMemory('名称',type='类型')</code> 。
{{折叠|readUnitMemory例子|<pre>
self.customTarget1.readUnitMemory('a',type='number')
</pre>}}

== 修改 ==
在[action]中，可以通过<code>setUnitMemory</code>来直接修改内存的值，格式为<code>setUnitMemory:名称=值,名称=值...</code> 。
{{折叠|setUnitMemory例子|<pre>
# [action] 中
setUnitMemory:a=1,b=memory.b+1
</pre>}}
在[[1.15|1.15p10]]更新后，也可以通过<code>[core]updateUnitMemory</code>来维持内存更新，即每到达设定时间就进行一次内存更新，格式与<code>setUnitMemory</code>相同，但需要添加到[core]节。通过<code>[core]updateUnitMemoryRate</code>可以设置更新频率（单位为帧，填写0为不停的更新）。
[[分类:模组制作]]