Trigger event

Revision as of 02:51, 18 July 2012

Trigger event (verb to trigger) is most useful event. It allows interaction between game objects.

Many entities can trigger other entities, or be triggered. For example you could open and close a door with a button, so here the button triggers the door. Not only buttons can trigger things, for example enemy could trigger a door when dies.

For Blood Omnicide, trigger event was extended to allow custom instructions.

Event input

• self - entity trigger event is being processed on
• activator - who lets event go (usually player)
• parameters - instructions for trigger event, fetched from "targetparm" field of self.

Event rules

• Instructions are case insensative
• ';' is the separator between instructions
• If trigger instructions not begin with "SELECT ", scripts automatically executes "SELECT TARGETS" at beginning.
• Empty instructions defaults to "SELECT TARGETS;CALL"

Instructions

SELECT/ADD

Starts (select) or expands (add) selection of entities.

• SELECT TARGETS - select entity to which i'm targeted
• SELECT TARGETERS - select entities which are targeted to me
• SELECT BYID <id1> <id2> <id3> ... <idX> - select entities by their save id's
• SELECT BYTARGETNAME <targetname1> <targetname2> ... <targetnameX> - select entities by their targetnames

INFOPORTION OPERATOR

Manipulate infoportions on activator.

• INFO SET infoportion - add/update infoportion
• INFO DEL infoportion - delete infoportion
• INFO INC infoportion increase_by - increase infoportion value by 1 or by custom value (of presented)
• INFO DEC infoportion decrease_by - increase infoportion value by 1 or by custom value (of presented)

CALL

This triggers all selected entities with their default action.

Can prefix this instruction with <classname:>. In this case trigger event will only be processed on entities with matching class name.

Template:Hidden begin : Examples

select targets;effect_light:call

select byid 145;call

</div></div>

CUSTOM ACTION

One of object's supported custom trigger actions. Classname filter is supported.

Template:Hidden begin : Examples

select targets;effect_light:on

select byid 145;trigger_puzzle:toggle 2 1 3

</div></div>

BREAK or NOCALL

Immediately exit trigger event.

Event keys

Trigger event have general keys that is used for it.

Sometimes this keys are used by other kind of events too. This special behavior is defined in particular class reference.

See also

• Pattern script
• Zone event