Label name Name of a library interrupt condition set Name of a library interrupt action set Name of a library interrupt handler Resume this action when an interrupt script returns, instead of resuming at a label? This has no effect if a resume attribute was specified in <run_interrupt_script>. If the action was already completed during the interrupt, the script will continue after the action immediately. Note that changing the resume attribute has no effect on existing savegames. The resume state will be restored as it was saved before, even if the attribute changes in the script. Flight behaviour Flight control model Command Attack Enemies Command (no param) Attack Object Command (param = the target to attack) Build Expansion Command (no param) Build Ship Command (no param) Build Station Command (no param) Build Upgrades Command (no param) Collect Command (param = the object to collect) Dock at Command (param = the object to dock at) Free Mining Command (no param) Free Trading Command (no param) Follow Command (param = the object to follow) Escort Command (param = the object to escort) Mining Command (param = the zone where stuff is mined) Move Command for object (param = the object to fly to) Move Command for zone (param = the zone to fly to) Patrol Command (no param) Police Command (no param) Protect Command (param = the object to protect) Refuel Command (param = amount of fuel) Repair Command (no param) Scan Object Command (no param) Support Command (param = the object to support) Search for Resources Command Search for Trades Command Trade Command (param = the object to trade with) Wait Command Explore Command Withdraw from Battle Command Resupply command Reconnoiter command Investigate command Recycle command Command action Stand By Command action (no param) Calculating parameters action (no param) Reparing to component Command action (param = component to repair) Stand By Command action (no param) Scanning to component Command action (param = component to scan) Searching resources Command action (no param) Executing Trade Command action (no param) Docking Command action (no param) Undocking (also detach from masstraffic) Command action (no param) Waiting for a free dock Command action (no param) Attacking Enemies Command action (no param) Attacking to Enemy Command action (param = enemy object) Flying Command action (no param) Flying to zone Command action (param = destination zone) Jumping Command action (no param) Searching for trades Command action (no param) Waiting for drones to dock (detach from masstraffic) Command action (no param) Investigating Object Command action (param = object being investigated) Building Command action (no param) Building Object Command action (param = object being built) Error. Unable to execute order and standing by. Script version in which this blocking action was added AI script parameter Parameter name Parameter value List of conditions all of which must be met List of conditions any one of which must be met Actions to be performed right before the script switches to a different <attention> block on an attention level change. Blocking actions are not allowed. <break> and <continue> only work on loops within the attention change actions. <resume> is supported. Time duration until timeout Conditionally interrupt a blocking action and perform certain actions when the interrupt occurs. Conditions that must be met in order for the interrupt to occur. Actions to be performed on an interrupt. Blocking actions are not allowed. <break> and <continue> only work on loops within the interrupt actions. Dock a masstraffic drone. Any picked up objects will be transferred to the cargostorage of destination (if possible). (blocking) Destination the drone should dock at. This object must have masstraffic docks defined! (Large+ ships or stations) If docking process should happen immediately, the drone will be teleported to destination(optional, defaults to false) If the current command action should be override with this action (optional, defaults to true) Execute trade procedure, this will create the necessary trade and cause cargo to be transferred from seller to buyer (blocking) Amount of goods to transfer Total price of goods in this trade (defaults to 0! takes precedence over price) Price per unit in this trade (defaults to 0! ignored if totalprice is set) Should the ware be unbundled on transfer? (turn ware into ammo for the recipient, defaults to false) Trade to be removed from shopping list, in case this action is aborted. Accessed by <save_ai_action_state>. Use money from the commanders' account to pay for this trade. Defaults to player account for player-owned ships without commander (optional, defaults to false) If the current command action should be overriden with this action (optional, defaults to true) Execute trade procedure, this will deliver a recyclable to the specified processing module (blocking) The trade deal that is to be acted upon The object that wants to deliver the recyclable (if a ship wants to use a trade offer on a station, that station is the owner and the ship is the tradepartner) The processing module that a towed recyclable should be handed over to If the current command action should be overriden with this action (optional, defaults to true) Execute trade procedure, this will cause cargo to be transferred (blocking) The trade offer (buy or sell) that is to be acted upon The object that wants to do the trade (if a ship wants to use a trade offer on a station, that station is the owner and the ship is the tradepartner) Amount of goods to transfer, can not exceed amount in offer (0=default=all in offer) Is this using a trade(offer) that is not a Production or Script TradeOffer? (e.g. taken from a Ships' shopping list). Note that you must specify an amount if ware reservations are involved! Should the ware be unbundled on transfer? (turn ware into ammo for the recipient, defaults to false) If the current command action should be overriden with this action (optional, defaults to true) Move along a dynamic path that will lead to the docking bay (blocking) Whether the object should abort the previous path points if any (defaults to true) Destination object (will be derived from docking bay if omitted) The DockingBay that should be used for docking Whether the object should fly in the coordinate space of the defined object as opposed to its parent component (defaults to true) Whether the object should start flying in the coordinate space of the defined object as opposed to its parent component after this movement is done (defaults to false) If this is true the ship will fly on steering flight control model (while in high attention), this is also implictely true if relativemovemt is true or the ship is flying in a formation (defaults to false) Note that, once this is set to true, steering will be the ship's default flight control model until the ship does a stop_moving action or a move_to where forcesteering is set to false. If the current command action should be override with this action (optional, defaults to true) Move to dock (blocking) Whether the object should abort the previous path points if any (defaults to true) Docking bay component slot (find using <find_dockingbay>) Flight behaviour overrride, defaults to flightbehaviour.dock If this is true the ship will fly on steering flight control model (while in high attention), this is also implictely true if the ship is flying in a formation (defaults to false) Whether the object should keep rotating to match the defined orientation at the end of the path (defaults to false) Whether the object has to be in the exact given position at the end of the path (defaults to true) If the current command action should be override with this action (optional, defaults to true) Range of when to engage relative movement to the dock target, evaluated when the action starts (optional, defaults to 0m, which means infinite relative movement range) Move to undock (blocking) Docking bay component slot Whether the object should keep rotating to match the defined orientation at the end of the path (defaults to false) Whether the object has to be in the exact given position at the end of the path (defaults to true) If this is true the ship will fly on steering flight control model (while in high attention), this is also implictely true if the ship is flying in a formation (defaults to false) Flight behaviour overrride, defaults to flightbehaviour.dock If the current command action should be override with this action (optional, defaults to true) Move through a Jump Gate, after the transition the ship will move out of the way of the gate (blocking) Whether the object should abort the previous path points if any (defaults to true) Jump Gate to go through If this is true the ship will fly on steering flight control model (while in high attention), this is also implictely true if the ship is flying in a formation (defaults to false) If the current command action should be override with this action (optional, defaults to true) Move to destination via navmesh (blocking) Whether the object should abort the previous path points if any (defaults to true) The object that has the navmesh to fly over Whether the object should fly in the coordinate space of the defined object as opposed to its parent component (defaults to false) Whether the object should start flying in the coordinate space of the defined object as opposed to its parent component after this movement is done (defaults to false) If this is true the ship will fly on steering flight control model (while in high attention), this is also implictely true if relativemovemt is true or the ship is flying in a formation (defaults to false) If the current command action should be override with this action (optional, defaults to true) Radius of the target. Can be used by some flight behaviours (default, -1) Move to destination by strafing (blocking) Whether the object should abort the previous path points if any (defaults to true) Destination object Whether the object should fly in the coordinate space of the defined object as opposed to its parent component (defaults to false) Whether the object should start flying in the coordinate space of the defined object as opposed to its parent component after this movement is done (defaults to false) If this is true the ship will fly on steering flight control model (while in high attention), this is also implictely true if relativemovemt is true or the ship is flying in a formation (defaults to false) If the current command action should be override with this action (optional, defaults to true) Radius of the target. Can be used by some flight behaviours (default, -1) Move to destination (blocking) Next position to look at for the last target point. Whether the object should abort the previous path points if any (defaults to true) Destination object (macro of this object will be used for target point lookup!) Either a single tag or a list of tags which are required for the target points Whether the object should fly to the target points in reverse order Whether the object should fly in the coordinate space of the defined object as opposed to its parent component (defaults to true) Whether the object should start flying in the coordinate space of the defined object as opposed to its parent component after this movement is done (defaults to false) If this is true the ship will fly on steering flight control model (while in high attention), this is also implictely true if relativemovemt is true or the ship is flying in a formation (defaults to true) If the current command action should be override with this action (optional, defaults to true) Move to destination using waypoint path (blocking) Next position to look at for the last waypoint. Whether the object should abort the previous path points if any (defaults to true) Destination object (will be used for waypoint lookup!) Either a single tag or a list of tags which are required for the waypoints Either a single tag or a list of tags which are required for the start waypoint Group tag for waypoint path, if omitted the first path found matching tags and starttags is used. Whether the object should fly to the waypoints in reverse order Whether the object should fly in the coordinate space of the defined object as opposed to its parent component (defaults to true) Whether the object should start flying in the coordinate space of the defined object as opposed to its parent component after this movement is done (defaults to false) If this is true the ship will fly on steering flight control model (while in high attention), this is also implictely true if relativemovemt is true or the ship is flying in a formation (defaults to true) If the current command action should be override with this action (optional, defaults to true) Move to destination (blocking) Whether the object should abort the previous path points if any (defaults to true) Whether the object should stop if the movement is approaching to finish (defaults to false) Whether local highways should be used (defaults to true) Default faction sector travel blacklist group (civilian, military) to use if object doesn't have a blacklist of its own (does not use any blacklist if null or not supplied) Whether the path should only include sectors known to the object's owner faction (defaults to false) Destination object or space Whether the object should keep rotating to match the defined orientation at the end of the path (defaults to false) Whether the object should bank into turns while executing this movement. Also rolls to align with ecliptic at the end of the movement. (defaults to true) This should normally be true unless the rotation at the end of the movement is absolutely important. Whether the object has to be in the exact given position at the end of the path (defaults to true) Whether the object should fly in the coordinate space of the defined object as opposed to its parent component (defaults to false) Whether the object should start flying in the coordinate space of the defined object as opposed to its parent component after this movement is done (defaults to false) If this is true the ship will fly on steering flight control model (while in high attention), this is also implictely true if relativemovemt is true or the ship is flying in a formation (defaults to false) Let the ship fly in reverse (defaults to false) If the current command action should be override with this action (optional, defaults to true) Radius of the target. Can be used by the spline flight control model to specify when the event_object_approaching_waypoint will be signaled or by some flight behaviours (default, -1) Whether the object should boost. The flight control model / behaviour can have the final say over when and if boosting actually happens. (optional, defaults to false) Whether the object should use travel mode. The flight control model / behaviour can have the final say over when and if travel mode actually happens. (optional, defaults to false) Receives the true target zone that this move_to will end in, may be a tempzone that has just been created so this move_to can end there (optional) Resume at specified label. This is only supported in <actions> and <init>. In global interrupts, use <run_interrupt_script> or <abort_called_scripts> instead. Perform the referenced library interrupt actions in the current script context Name of the library interrupt action set Instruct object to re-join the mass traffic, only works for ships that came from mass traffic in the first place! (blocking) Instruct object to detach from mass traffic, e.g. after executing a trade - OK to call for ships that don't use mass traffic as well If the current command action should be override with this action (optional, defaults to true) Run script (blocking) Save named return value in a variable Return value name Actions to be performed when called script returns, in case the attention level changed in the meantime. Blocking actions are not allowed. <break> and <continue> only work on loops within the attention change actions. Script name Run order script (blocking) Actions to be performed when called script returns, in case the attention level changed in the meantime. Blocking actions are not allowed. <break> and <continue> only work on loops within the attention change actions. AI order to be executed. It must be an object's current order and its state must be orderstate.ready. Run a script on a global interrupt. The script will be executed on top of the current call-stack if its interrupt priority is high enough. No further interrupt actions will run after this action. This action is only allowed in global interrupt actions, but not in library actions. Script name If true then the scripts called by this script will be aborted before the interrupt script is started. If false (default) then the interrupt script will be started on top of the callstack. Label to resume at when the interrupt script returns. By default the script will resume at the current label. Abort scripts that were called by this script on a global interrupt. No further interrupt actions will run after this action and this script will resume at the current label. This action is only allowed in global interrupt actions, not in library actions. Label to resume at after the interrupt. By default the script will resume at the current label. Wait for blocking action of previous AI script to complete (blocking). Requires information stored on this object via <save_ai_action_state>. Only a few specific blocking actions are handled here, in other cases no blocking happens. Value that receives the name of the blocking action of the previous script Value that receives the event source object of the blocking action of the previous script Value that receives the first parameter of the blocking action of the previous script (depends on the action). For <execute_custom_trade> this is the buyer. Value that receives the second parameter of the blocking action of the previous script (depends on the action). For <execute_custom_trade> this is the trade. Randomly select an appropriate flight behaviour for the given entity Sets the current command for the script's entity. The command data will remain valid until either it's overwritten or this script ends. It becomes valid again automatically when a called script returns. Primary command parameter (meaning depends on command) Secondary command parameter (meaning depends on command) Sets the current command action for the script's entity. The command action data will remain valid until either it's overwritten or this script ends. It becomes valid again automatically when a called script returns. The following blocking actions can override it: move_to actions .... Primary command action parameter (meaning depends on command action) Sets the default flight behaviour for this unit (can still be overridden per move_to order) Resets flight behaviour of this unit to flightbehaviour.default (can still be overridden per move_to order) Overrides this unit's default flight control model Resets the unit to use the default flight control model. If the object is flying in mass traffic, the default FCM will be "masstraffic". If the object is visible, not docked and in a highway, the default FCM will be "highway". If the object is visible, the previous movement operation for the object set the forcesteering-flag to true and the path of the object has not been aborted, the default FCM will be "steering". If the object is visible and any of the other conditions above are not met, the default will be "spline". If the object is not visible, the default FCM will be "linear". Whether this object should clear the forcedsteering-flag that might have been set by a previous movement operation. Defaults to false. Enables/disabled collision avoidance for this object Whether this object should use octree path finding to navigate to its target Whether this object should use dynamically avoid nearby ships of similar or smaller size Resets collision avoidance for this object Enables/disables flight assist for this object Shoot at target when the opportunity arises Tolerance angle (optional). A positive angle value overrides the default tolerance angle defined in the weapons set to shoot. A non-positive value has no effect. Optional list of additional targets that may be fired upon if opportunity arises (not supported together with largetarget=true). The object specified by the target attribute must not be in this list (will be ignored and an error will be logged otherwise) Select between lasers and missile launchers. False for lasers, true for missile launchers. Defaults to false. Shoot weapons in active primary weapon group. Defaults to true. Shoot weapons in active secondary weapon group. Defaults to true. Prevent target from being overridden? Default is false Is the target a very large object, e.g. a station? Default is false (does not support additonal targets) Only weapons/turrets set to the specified mode will shoot at the target(s), defaults to any. Stop moving Wait (sleep) for specified time duration (blocking) Label AI script actions Actions in all sub-nodes will be performed. Traverse a list, group or table. For each element (or table key), the actions in the sub-nodes will be performed. The keyword 'loop' can be used in expressions to access data of the current iteration. A randomly selected sub-node action will be performed. The chances of selection can be specified by using weights on the actions. Actions in sub-nodes will be performed only if the value matches. Can be followed by <do_elseif> and/or <do_else>. Actions in sub-nodes will be performed only if the conditions in the previous nodes are not met and if this action's values matches. Can be followed by <do_elseif> and/or <do_else>. Actions in sub-nodes will be performed only if the conditions in the previous nodes are not met. Actions in sub-nodes will be performed in a loop while the value matches. Conditions that must be met in order for the global interrupt to occur. Actions to be performed on the global interrupt. Blocking actions are not allowed. <break> and <continue> only work on loops within the interrupt actions. Will the interrupt event be consumed by this handler when the conditions are met, preventing it from triggering further handlers in this script callstack? Default is true - set to false to allow the event to be passed on, so that multiple handlers in the callstack can be triggered simultaneously. Note that handlers are first triggered in the current script, then in the caller, and so on. The event processing stops as soon as a handler consumes the event. Interrupt actions are always deferred until after the event processing. Global interrupt handler for this AI script and any called scripts. Can reference a library interrupt handler. Library of named interrupts and interrupt conditions in global namespace Library definition of a global interrupt handler. Can be referenced by any AI script. Globally unique handler name Library definition of conditions that must be met in order for an interrupt to occur. Can be referenced by interrupt handlers in any AI script. Globally unique condition set name Library definition of actions that can be referenced by interrupts or by <include_interrupt_actions> in any AI script. Globally unique action set name Global interrupt handlers and library definitions Order category type Order parameter type Internal parameter that is hidden in the UI. Parameters of this type must be optional, i.e. have a default value. Boolean parameter Untyped number input from slider (input param "max" required) Length input from slider (input param "max" required) Time input from slider (input param "max" required) Money input from slider (input param "max" required) Object selected by player Space selected by player Position in space, result is [$space, $position] Ware selected by player Trade deal selected by player (including trade partner, ware, amount and price - only to be used in special trade orders) Build task selected by player (only to be used in special build orders) Formation shape selected by player A list of any other order parameter type (input param "type" is required, additional input params for that type are valid) Macro A sector selected by the player Valid input param for list: Type of the list elements Valid input param for internal type: Type for setting values from UI Valid input param for number/length/time/money, default is 1 Valid input param for number/length/time/money, default is 0 Valid input param for number/length/time/money Valid input param for number/length/time/money/position, start value for selection in UI (of same type as the expected result) Valid input param for object (list of allowed classes) and position (expected result space class, class.zone or class.sector) Valid input param for object (boolean, for selecting object that is a deployable) Valid input param for object/position (space or container) Valid input param for object (faction) Valid input param for object (boolean, for preventing current object from being selected, default is true) Valid input param for object (ware transport type, for selecting object with mining capability) and ware (zone, for selecting mining resources) Valid input param for object (boolean, whether object can attack) Valid input param for object (boolean, whether an object can be dismantled) Valid input param for object (boolean, whether an object can be towed) Valid input param for object (boolean or ware transport type, for selecting object with appropriate cargo storage) Valid input param for object (boolean or ware, for selecting object with cargo) Valid input param for object (controllable, for selecting object that can be commander of the controllable) Valid input param for object (boolean, for selecting object with unit storage) Valid input param for object (boolean) Valid input param for object (boolean) Valid input param for object (boolean) Valid input param for object (boolean) Valid input param for object (boolean, for selecting object that is target of a buildmodule) Valid input param for object (boolean or ware) Valid input param for object (boolean or ware) Valid input param for object (boolean) Valid input param for object (boolean, for selecting object in state construction) Valid input param for ware (container, for selecting cargo of given container) Valid input param for ware (container, for selecting ware that the container has buy offers for) Valid input param for ware (container, for selecting ware that the container has sell offers for) Valid input param for ware (container, for selecting ware that the container can carry) Valid input param for ware (boolean, for selecting a minable ware) Valid input param for bool (if false parameter is set to value) Valid input param for bool (if true parameter is set to value) Valid input param for sector (ware list, any has to be a resource in the selected sector) Valid for any param type (boolean; if true, parameter can not be changed in the UI; defaults to false) Valid input param for ware lists (boolean, letting the player override an automatic ware basket with a whitelist. Add internal order parameter with name "$name$_override".) Valid input param for lists (string, source of options to select from, needs to fit the list type. 'ware': "commanderwarebasket") Patch instruction to replace the parameter of each matching existing order of an older version (will be applied when loading the order from a save). Note that this can also be necessary when adding an order parameter in a new script version, so existing orders from older saves are updated properly. By default, when parameters are added to existing orders, they get the null value, NOT the value specified in the default attribute. NOTE: When a patch is applied to an order parameter, a running order is not reset automatically. If that is desired, use script <patch> actions instead or additionally. This patch is applied before script patch actions of the same "early" type are performed, so e.g. early parameter patches are applied before early patch actions. Script version at which this patch element was added (it will only be applied when loading an order script of an older version) Required state that this order must be in for this patch to be applied (default is any state) If true, the parameter will be patched as early as possible while importing the order, before setting up global interrupt events. If false or omitted, the patch will be applied only when the savegame is fully loaded. With early="true" accessing and manipulating other objects is not safe, because at that point the game is not fully loaded yet. However, this is useful for updating a parameter variable that is required for global interrupt events. If true, the corresponding parameter variable of a running order script is updated to the new value as well, or is created if it does not exist already. This is a shortcut for a <patch> action block that sets the variable to the new parameter value. (Otherwise the parameter and the script variable may have different values.) Default is true. This has no effect if the order script is not currently running, or if the script was called directly via <run_script> instead of an order. Optional condition expression. If the condition is not met then the parameter will not be patched. The expression is evaluated in the same context as the value (see the value documentation). New value to be assigned to the parameter and, if requested with the setvariable attribute, also to the corresponding script variable. The expression is evaluated in the context of the running order script if available, including full variable access. NOTE: For orders that are not currently running, the restrictions of parameter setup also apply here (see the <order> documentation), and the $variable notation provides access to the current order parameters, not to a variable of a running script. To make changes that should only apply to a running script, use script <patch> actions instead. Definition of an order, determining this AI script as the associated order script. Script parameters must be defined as order parameters. NOTE: During setup of order parameters, the script keyword "this" is only partially supported since the entity is not determined yet. "this" can only be used to access the following properties: exists, controllable, controlled, assignedcontrolled, object, defensible, container, station, ship, zone, sector, cluster. For example, "this.assignedcontrolled" and "this.zone" are always supported, but "this.type" will not work until the script has started. NOTE: The properties object, controllable, controlled and assignedcontrolled are synonymous before the script is started; they refer to the object that the order belongs to. Order parameters (AI script parameters with additional order-related properties) AI order script parameter Internal parameter required by the UI for player input of this order parameter. The order parameter type determines which input parameters are expected. Input parameter name Input parameter value Declares that the script is capable of handling an "edit" event for this parameter while in the "critical" state, provided that the defined edit conditions are met. This declaration only affects the critical state, as all parameters are editable anyway in the started (non-critical) state. Non-event conditions that determine whether editing the parameter is currently possible. The checks are triggered by the UI or by the script system (e.g. <edit_order_param>) when necessary. Actions to be performed immediately when the player or a script edits the parameter. The provided event.* properties are the same as for <event_object_order_param_edited>. Interrupt-specific actions (<run_interrupt_script>, <abort_called_scripts>) are not supported. To perform interrupt actions, the script needs to define an actual interrupt handler and listen to <event_object_order_param_edited>. Grouped set of patch nodes (grouping is for convenience/readability only) Parameter name Localised parameter name displayed in the UI Default value. If required="false" then a default value must be supplied. If user input is required, a default value does not have to be supplied, but if it is, it may be taken into account by the UI. Special constant value that marks the order as infinite. In other words, if the parameter value matches this value, the order becomes an infinite order. Infinite orders in the order queue have special behaviors (see infinite attribute of <order> element). The existence of this attribute also allows the user to create this order as a default order (which must be infinite). In this case, this order parameter is hidden from the UI, it is automatically initialised to the the infinitevalue, and the attributes "default" and "required" have no effect. Is parameter input by user required? Default is true, unless a default value is provided. If false then the input UI is skipped (but parameter may be edited by the user later) Is UI visibility of the parameter restricted to the advanced UI mode? Default is false (parameter is always visible). An advanced parameter must be neither required nor internal. Skill requirement for the pilot of a player-owned ship, to determine whether this order is selectable in the UI. The UI will check this requirement when selecting a default order. To prevent exploits, the default order is supposed to get cleared when the player changes the ship's pilot. Minimal required combined skill value Filter criteria to determine for a player-owned object whether this order is selectable in the UI. For the case of an unselectable order, the reason can be provided as TextDB reference in the text attribute. There can be multiple elements of this type with different reason texts. Reason for the order not being selectable (TextDB reference) Location definition for visualisation in the UI. The location may be queried by the UI at any time after the order is set up. There can be multiple subsequent location elements, and each location element can have a condition. In this case, for each location element the condition is evaluated until a valid location element is found, which will then be used. Optional condition expression. If the condition is not met then this location element is regarded as invalid. Should the location element be available even if there are parameters that have not been set up in the UI yet? Default is false. Note that the location definition still relies on certain parameters, so the condition expression is required to check for the existence of these parameters, e.g. condition="$object?". Reference object or space of the location Additional location objects (can be null or omitted, otherwise it must be a list or group of objects). Cannot be combined with position. Position (offset) relative to the reference object or space (can be null or omitted). Cannot be combined with additionalobjects. Radius around order location (can be zero or omitted) Icon override for visualisation in the UI, overriding the default icon for this order (based on the order ID). The icon may be queried by the UI at any time after the order is set up. There can be multiple subsequent icon elements, and each icon element can have a condition. In this case, for each icon element the condition is evaluated until a valid icon element is found, which will then be used. Icon name Optional condition expression. If the condition is not met then this icon element is ignored. Globally unique order ID Localised order name displayed in the UI Localised order description displayed in the UI Is this an infinite order? Default is false. Infinite orders in the order queue have a theoretically infinite duration, but they have special termination conditions: If a sync point exists, the order terminates when the order has reached the sync point and it is released, otherwise it terminates when a next order is ready in the queue. Even if the infinite attribute value is false, this order can become infinite if there is a param element with an infinitevalue attribute. Default orders must be infinite since they should not terminate until another order is ready. Any order with an infinite or infinitevalue attribute can be used as default order. Allows the order to be cancelled by specific player actions even if it is in the critical state (default is false). This causes the order script to be aborted like in the non-critical case. The script has to clean up the order state in the on_abort node. Note that usually the critical state indicates an irreversible process that cannot be cancelled. Whether the player can add this order to an order loop (default is true). NOTE: Trade, build and operation orders are not allowed in a loop, no matter what value is provided in this attribute. Non-blocking AI script actions for patching a script of an older version (will be performed when loading the script from a save) Script version at which this patch element was added (it will only be applied when loading a script of an older version) If true, the patch actions will be performed as early as possible while importing the script, before setting up global interrupt events. If false or omitted, the patch actions will be performed only when the savegame is fully loaded. With early="true" accessing and manipulating other objects is not safe, because at that point the game is not fully loaded yet. However, this is useful for setting up variables that are required for global interrupt events. AI Script root element AI script parameter Parameter name Default value (parameter is required if default value not supplied) Non-blocking AI script actions for initialization (will be performed immediately when the script is started, before setting up global interrupt events) Grouped set of patch nodes (grouping is for convenience/readability only) Actions for minimum attention level Minimum attention level Non-blocking AI script actions for cleanup, in case the script is aborted (will be performed right before the script is terminated). If the script is aborted as a result of the entity being killed, the event data of <event_object_destroyed> can be accessed. Set to true if the actions should only be performed if the entity is killed. Signature The interrupt priority. In order for this script to be triggered by a global interrupt handler, this priority must be higher than the previous interrupt priority (default is 0). Script version. The version has to be increased when new blocking actions are inserted.