execFSM

From Bohemia Interactive Community
Revision as of 23:28, 10 February 2019 by killzone_kid (talk | contribs)
Jump to navigation Jump to search
Introduced with Arma 2 version 1.00
  

Click on the images for descriptions

Introduced in

Game:
Arma 2
Version:
1.00

Description

Description:
Executes scripted FSM and returns the FSM handle or 0 when failed. The FSM file is first searched in the mission folder, then in the campaign scripts folder and finally in the global scripts folder. Argument (if any) are available in _this variable inside FSM. In Arma 3 FSM handle is also available in _thisFSM variable. Variables set inside FSMs can be read/modified externally, using setFSMVariable and getFSMVariable commands.

The scripted FSM structure normally consists of one init state, one or more conditional links, one or more normal states and one or more final states. Each state has init and precondition section, while each conditional link has precondition, condition and action sections. The order of execution is:
  • State: init->precondition
  • Conditional link (condition is true): precondition->condition->action
  • Conditional link (condition is false): precondition->condition
Scripted FSMs are added into the scheduler just like exec scripts, execVM scripts and spawn scripts. While the code placed into any of the sections of FSM cannot be suspended (canSuspend is false) the FSM itself is suspended every simulation between the state's init and the state's precondition (exception is the init state). Normally the difference between the state's init and precondition is 1 frame but if the scheduler is busy it can take longer. This is the only place where scripted FSM is suspended/resumed.

To see what FSMs are currently in the scheduler, use diag_activeMissionFSMs command

Syntax

Syntax:
arguments execFSM filename
Parameters:
arguments: Anything - Arguments accessible as _this in the FSM
filename: String - file with FSM code
Return Value:
Number - FSM handle, can be used to determine (via completedFSM) when the execed FSM has finished. In Arma 3, the handle is also available inside the FSM in _thisFSM variable.

Alternative Syntax

Syntax:
execFSM filename
Parameters:
filename: String - file with FSM code String
Return Value:
Number - FSM handle, can be used to determine (via completedFSM) when the execed FSM has finished. In Arma 3, the handle is also available inside the FSM in _thisFSM variable.

Examples

Example 1:
_id = player execFSM "test.fsm";
Example 2:
_handle = [_a, _b, _c] execFSM "test.fsm";
Example 3:
_handle = execFSM "test.fsm";

Additional Information

Multiplayer:
-
See also:
FSMFSM Editor ManualexecVMcallspawnexeccommandFSMcompletedFSMdoFSMgetFSMVariablesetFSMVariable

Notes

Only post proven facts here. Report bugs on the feedback tracker. Use the talk page or the forums for discussions.
Add New Note | How To

Notes

Bottom Section