| Latest revision |
Your text |
| Line 1: |
Line 1: |
| − | {{TOCRIGHT}}
| + | Call event is most useful event. |
| − | Trigger event (verb '''''to trigger''''') is most useful event. It allows interaction between game objects.
| + | It happens when trigger get touched, on monster dies, each object can have it's own behavior and launch call even under it's own circumstances. |
| | + | But structure of event is same all the time. |
| | | | |
| − | 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.
| + | Call event takes input: |
| | | | |
| − | In Blood Omnicide, trigger event can have custom instructions which is used to control the way entities react to the event.
| + | * activator entity - who lets event go |
| | + | * call entity - entity call is being processed on |
| | + | * call parameters - instructions for call event, fetched from "targetparm" field of call entity. |
| | | | |
| − | ===Event input===
| + | After input got fetches, |
| | | | |
| − | * self - entity trigger event is being processed on | + | * "nocall" parameter breaks call event |
| − | * activator - who lets event go (usually player) | + | * If targetparm not begins with "select", "SELECT TARGETS;" is automatically added |
| − | * parameters - instructions for trigger event, fetched from "targetparm" field of self.
| + | * Empty targetparm defaults to "select targets;call" |
| | | | |
| − | ===Event rules=== | + | == SELECT / ADD == |
| | | | |
| − | * Instructions are case insensative
| + | Starts and expands selection of entities, which will be called. |
| − | * Instruction keywords are separated by space and TAB (except for braces)
| + | |
| − | * ';' 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 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 save id's |
| | | | |
| − | '''SELECT/ADD'''
| + | == INFOPORTION == |
| − | :Starts (select) or expands (add) selection of [[Entity | 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. |
| − | :Manipulate [[Infoportions | 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''' | + | * INFOPORTION SET ''infoportion'' - adds/update infoportion |
| − | :This triggers all selected entities with their default action.
| + | * INFOPORTION DEL ''infoportion'' - delete infoportion |
| − | :Can prefix this instruction with <classname:>. In this case trigger event will only be processed on entities with matching class name.
| + | * INFOPORTION INC ''infoportion'' ''[increase_by]'' - increase infoportion value by 1 or by custom value (of presented) |
| − | :Examples:
| + | * INFOPORTION DEC ''infoportion'' ''[decrease_by]'' - increase infoportion value by 1 or by custom value (of presented) |
| − | ::select targets;effect_light:call
| + | |
| − | ::select byid 145;call
| + | |
| | | | |
| − | '''''CUSTOM ACTION''''' | + | == ''[mask:]action'' == |
| − | :One of object's supported custom trigger actions. Classname filter is supported.
| + | |
| − | :Examples:
| + | |
| − | ::select targets;effect_light:on
| + | |
| − | ::select byid 145;trigger_puzzle:toggle 2 1 3
| + | |
| | | | |
| − | '''BREAK or NOCALL'''
| + | Call all selected entities with parameter. |
| − | :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 (if presented) is defined in particular class reference.
| + | |
| − | | + | |
| − | {{entity fields}}
| + | |
| − | |-
| + | |
| − | | Target
| + | |
| − | | target
| + | |
| − | | All entities with matching targetname will be triggered.
| + | |
| − | |-
| + | |
| − | | Target parameters
| + | |
| − | | targetparm
| + | |
| − | | When entity is triggered, this is instructions for trigger event (see instructions above);
| + | |
| − | |-
| + | |
| − | | Targetname
| + | |
| − | | targetname
| + | |
| − | | Entities with matching target will trigger this entity.
| + | |
| − | {{entity fields end}}
| + | |
| − | | + | |
| − | == See also ==
| + | |
| − | * [[Pattern script]]
| + | |
| − | | + | |
| − | {{finished}}
| + | |
