Pattern script

Introduction

Pattern scripts is special kind of expressions that returns 1 or 0 used to determine availability of some functionality or event. This scripts can check for very wide range of conditions (gametime, special parms of entities, infoportions etc.).

Usage examples:

• Enemy appearance (some enemies are only active at night, some only at day etc.)
• Gamemodels damage masks (checks if could be damaged by certain weapon)
• Checking if trigger could be touched

Basic syntax:

 // this script check if its a night or if there is an enemy within 300 units
 night | enemy<300>.found

 // this scripts check if gametime is between 12 and 14 hours
 hour =><= 12 14

 // this script check if it's fullmoon night or raining 
 (night & fullmoon) | raining

Operators

Link expressions together.

Operator	Example	Description
Logical operators (only applicable between expressions)
( )	( expression )	Expression
&	x & y	Logical 'And'
|	x | y	Logical 'Or'
not	x & not y	Logical Not
Comparison operators
=	x = y	Equal
!=	x != y	Not equal
>	x > y	Greater
>=	x >= y	Greater or equal
<	x < y	Lesser
<=	x <= y	Lesser or equal
><	x >< start end	x > start And x < end
=><	x =>< start end	x >= start And x < end
><=	x ><= start end	x > start And x <= end
=><=	x =><= start end	x >= start And x <= end

Functions

Set of functions is determined by pattern implementation. There is two pattern implementations as of yet.

GenericPattern

This is generic appearance pattern. It used on enemies appearance, zone appearance.

Operator	Description
true	Always returns 1
false	Always returns 0
self.field	Checks one of the field of script owner. Fields could be: found - entity exists. touchable - entity is touchable trigger or zone. fired - trigger is deactivated. This is only applicable to: trigger_once, trigger_redirect, trigger_multi. solved - puzzle trigger is solved. This is only applicable to: trigger_puzzle. killed - entity was killed (deadflag is set). dist x operator - check distance to activator. deadtime x operator - check time enemy being dead.
enemy.field	Check field of script owner enemy. See fields list above.
target<name>.field	Find entity by targetname (return first match). See fields list above.
enemy<radius>.field	Find enemy of script owner within given radius. See fields list above.
sid<name>.field	Find entity by SaveId. See fields list above.

GamemodelHitPattern

Used on misc_gamemodel when model is hit.

  GamemodelHitPattern functions  

Operator	Description
true	Always returns 1
false	Always returns 0
pushonly	System word. Allows to push object but not destroy. This should be the first operator in expression if used.
tag_tagname	Returns 1 if model tag closest to hit position matches this tag. Otherwise 0.
number%	Randomly returns 1 with this chance percentage. Typical values are 25%, 50%, 90% etc.
damagetype	Check if weapon have this damage type. Damagetype should be one of following constants: slash - sword crush - mace crushblow - mace special hit hack - axe impale - throwing knifes, arrows teeth - animals claw - animals, wolf form water - water damage energy - energy bolts, magic missiles spikes - spike zones flame - fire, flame sword flaying - flay artefact imploding - implode artefact soulreaver - soul reaver magic attack