Skip to content

33 — Selected by player

Satisfied when the local player selects the tagged object and a house that player controls owns it.

Editor data
Numeric ID
33
Engine ID
TEVENT_SELECTED
Editor name
Selected by player
Need token
NEED_NONE
Parameters
None
Attachment
object
INI example
[Events]
<TriggerID>=1,33,0,0

The event is offered when the local player selects the object and all of these hold, in this order:

  1. the object is out of limbo, is not already selected, and its type is Selectable=yes;
  2. it is not a loaner that the player can currently move;
  3. no structure is waiting to be placed on the map;
  4. a house under the local player’s control owns it;
  5. selection responses are on, as described below.

An object of a computer house therefore never offers the event, and an object of another human player’s house never offers it on this computer.

When one action selects several objects, the event is offered for each object that plays a selection response:

  • A band box and the Select View hotkey offer the event for the first object they select only.
  • The Select Team, Add Select Team, Add To Team and Center Team hotkeys offer it for the first team member they newly select only.
  • The Select Same Type hotkey offers it for every object it adds to the selection.

Select Team always leaves selection responses off afterwards. Add Select Team and Add To Team leave them off when they newly select a team member. Until responses are turned back on, selecting an object by clicking it plays no response and offers nothing, and so does the next team hotkey.

These actions turn responses back on:

  • issuing an order by clicking on the map;
  • the Deploy Object and Guard hotkeys, when something is selected;
  • a band box and the Select View hotkey;
  • the Select Same Type hotkey, when the selection holds an object of the player’s;
  • the Center Team hotkey.
Caveats
  • The event is offered only on the selecting player's computer. Use it in single-player missions. In a multiplayer game the trigger fires on that one computer only, so any action that changes the game can desynchronize it.
  • The event is offered on exactly the selections that play the object's selection response, whether or not its type has a response sound. [Responses to a group selection](#responses-to-a-group-selection) explains when a selection plays none.
  • Only an object that was not already selected offers the event. A band box or hotkey that covers an already selected object again offers nothing for it.
  • On a persistent tag, the event stays marked once it is satisfied. A persistent trigger holding only this event therefore fires on every later offer the tag receives, such as damage to the object, not only on later selections.