DocumentationBot: Version 1

2026-10-01T04:13:05Z

Version 1

New page

{{GameNav}}

[[Grimwar/Entities|All entities]]

{{Entity icon|trigger_multiple|section}}

Emit events as accepted objects enter, stay in, and leave a volume.

Placement: Oriented volume.

== Set it up ==

Set Allowed Teams explicitly: its default None excludes participants. Allowed Activators separately chooses humans, bots, unassigned pawns, and other colliders. Layer hints only narrow physics candidates. start_touch_all fires when occupancy goes from zero to one; end_touch_all fires when the last occupant leaves. fire emits trigger for each occupant. touch_test emits touching or not_touching. reset clears and refreshes occupancy. execute emits a short-lived participant snapshot token for VMods; see [[Grimwar/VSig#Signals shared with VMod|VSig and VMod]].

== Settings ==

These are the initial authoring values. Script inputs and runtime state are listed separately below.

{| class="wikitable"
! Setting !! Default !! Meaning and choices
|-
| <code>required_tag</code> Required Tag || <code>Empty</code> || Only colliders with this tag activate the trigger. Leave blank to allow any tag.
|-
| <code>allowed_teams</code> Allowed Teams || None (<code>0</code>) || Allow participants from these teams. None blocks all participants; unassigned pawns and other colliders still follow Allowed Activators. Choices: None (<code>0</code>), Spectate (<code>1</code>), Order (<code>2</code>), Union (<code>4</code>), All (<code>7</code>).
|-
| <code>allowed_activators</code> Allowed Activators || Participants (<code>3</code>) || Participants are human or bot pawns. UnassignedPawns have a Pawn component with no participant. Choices: None (<code>0</code>), Humans (<code>1</code>), Bots (<code>2</code>), Participants (<code>3</code>), Unassigned Pawns (<code>4</code>), All Pawns (<code>7</code>), Non Pawns (<code>8</code>), Everything (<code>15</code>).
|-
| <code>layer_hint_mode</code> Layer Hint Mode || Auto From Activators (<code>0</code>) || Filters physics candidates; Allowed Activators still decides who triggers. Use SDK Layer Set for shared layers such as Item. Choices: Auto From Activators (<code>0</code>), Sdk Layer Set (<code>1</code>), All (<code>2</code>).
|-
| <code>layer_hint_set</code> Layer Hint Set || Participants (<code>3</code>) || Layers used when Layer Hint Mode is SDK Layer Set. Choices: None (<code>0</code>), Pawn (<code>1</code>), Hitbox (<code>2</code>), Participants (<code>3</code>), Item (<code>4</code>), Default (<code>8</code>), Shield (<code>16</code>), First Person (<code>32</code>), Trigger (<code>64</code>), Ragdoll (<code>128</code>).
|-
| <code>start_disabled</code> Start Disabled || <code>false</code> || Ignore touches until enabled by input.
|-
| <code>wait_seconds</code> Wait Seconds || <code>0.2</code> || Seconds between firings while occupied. Use 0.2 for typical triggers; 0 fires every frame. Minimum: <code>0</code>.
|-
| <code>delay_seconds</code> Delay Seconds || <code>0</code> || Delay (seconds) before the first OnTrigger after an activator enters. Minimum: <code>0</code>.
|-
| <code>fire_once</code> Fire Once || <code>false</code> || Disable after the first OnTrigger.
|-
| <code>touching_interval_seconds</code> Touching Interval Seconds || <code>0</code> || Seconds between OnTouching events while occupied. 0 disables them. Minimum: <code>0</code>.
|-
| <code>ignore_nav_mesh</code> Ignore Nav Mesh || <code>false</code> || Exclude this entity from navigation-mesh building. This does not disable its gameplay collision.
|}

== VSig contract ==

Use the names below with a ref bound to this entity. The value column describes the catalog value type, not a C# method signature. See [[Grimwar/Entities#Read the reference|Read the reference]] for arguments, authority, and common controls.

{| class="wikitable"
! Kind !! Member !! Value !! Authority / access
|-
| Input || <code>disable</code> || <code>none</code> || Server
|-
| Input || <code>enable</code> || <code>none</code> || Server
|-
| Input || <code>execute</code> || <code>none</code> || Server
|-
| Input || <code>fire</code> || <code>string</code> || Server
|-
| Input || <code>kill</code> || <code>none</code> || Server
|-
| Input || <code>reset</code> || <code>string</code> || Server
|-
| Input || <code>toggle</code> || <code>none</code> || Server
|-
| Input || <code>touch_test</code> || <code>string</code> || Server
|-
| Output || <code>disabled</code> || <code>none</code> || Server
|-
| Output || <code>enabled</code> || <code>none</code> || Server
|-
| Output || <code>end_touch</code> || <code>string</code> || Server
|-
| Output || <code>end_touch_all</code> || <code>string</code> || Server
|-
| Output || <code>executed</code> || <code>string</code> || Server
|-
| Output || <code>killed</code> || <code>none</code> || Server
|-
| Output || <code>not_touching</code> || <code>string</code> || Server
|-
| Output || <code>start_touch</code> || <code>string</code> || Server
|-
| Output || <code>start_touch_all</code> || <code>string</code> || Server
|-
| Output || <code>touching</code> || <code>string</code> || Server
|-
| Output || <code>trigger</code> || <code>string</code> || Server
|-
| Property || <code>is_enabled</code> || <code>bool</code> || Server; read only
|}

This entity supports operational enable/disable. Repeating the current state does not emit another transition. <code>kill</code> is permanent for this map load.

[[Category:Grimwar entities]]

Grimwar/Entities/trigger multiple - Revision history

DocumentationBot: Version 1