Name of the value that will receive the result Name of the group to which the result will be added (group will be created if it does not exist yet) Group of objects Object Object or a list of objects Destructible Entity Faction or Object Ship Station Containing space (zone, sector, cluster, or galaxy) Containing space (zone, sector, cluster, or galaxy) or a list of containing spaces Cluster Room Sector Zone HoloMap Actor object (NPC) Actor entity (NPC) or list containing context and NPC template Target object Target component Target component slot Asteroid Recyclable Weapon Source object Killer object Killed object Attacker object Attacked object Attacked component object Damaged component Dismantled component Repaired component Build module Build processor Dismantle processor Production module Buyer object Seller object Buyer object (attribute must be present if seller not supplied) Seller object (attribute must be present if buyer not supplied) Trade Offer Trade offer to match. All other attributes and amount check nodes are ignored. Build Task Ware Ware (paired with min-max/exact attributes) or ware amount table where the key is the ware and value is the amount SignalLeak object Object which performs the scanning, or group of objects (attribute must be present if scanned not supplied) Object which is scanned, or group of objects (attribute must be present if scanner not supplied) Object which performs the hacking, or group of objects (attribute must be present if hacked not supplied) Object which is hacked, or group of objects (attribute must be present if hacker not supplied) Attacker object (ship or station) which is doing the locking (attribute must be present if target not supplied) The attacker's lock target object (attribute must be present if attacker not supplied) The attacker's lock target component (either the whole target object or a contained component) Object which performs the observation, or group of objects (attribute must be present if observed not supplied) Object which is observed, or group of objects (attribute must be present if observer not supplied) Object which is attacking the target (attribute must be present if target not supplied) Object which is attacked, or group of objects (attribute must be present if attacker not supplied) Object which is claimed, or group of objects (attribute must be present if pilot not supplied) The claiming entity, or group of entities (attribute must be present if claimed not supplied) Minimal required number of free slots for actor NPCs Is a free slot for a mission actor NPC required? Cutscene key name List Table Source for fixed random number seed (either a numerical value or an object with a generation seed provided by their spawner). NOTE: When using a numerical seed value, the value does not get updated automatically. In order to generate a sequence of random numbers based on the same numerical seed, use <advance_seed> after each random number generation. Takes priority over autoadvanceseed attribute in cases where both can be used. Source for auto-advance random number seed (either a numerical value or an object with a generation seed provided by their spawner). NOTE: The seed value is updated automatically in all cases. When providing a variable with a numerical value, it will receive the updated seed. There is no need to use <advance_seed> after each random number generation with this attribute. Ignored if seed attribute is provided in cases where both can be used. AI order Start this order immediately? If true, the order is inserted as the current order. If there is an active current order, it will be interrupted, so that it restarts when the new order is completed. If the current order cannot be interrupted (i.e. it's in the critical state) the new order is inserted right after it. This attribute has no effect when creating a default order. If true then the found objects are appended to the value used as the result (not the groupname result value). Should the value used as the result not be a list, it will become one, losing its previous value (default false) If true then the result is a list of all found objects, otherwise the result is a single object or null (default is true for count_ conditions, false for find_ actions). In case of multiple=false, the single result is the first object according to the sort criteria, or randomly selected from all matching objects if no sort criteria are specified. If true then an error message will be produced if no result is found (default is false) If true then the search does not stop at contained objects, but these objects and their sub-components are searched recursively as well (default is false) If true then the search will include contained objects (of class object, e.g. docked ships). Sub-components of these objects are not included, unless the recursive attribute is set. The recursive attribute takes precedence over includeobjects. Default is false. Comment for documentation purposes only Container (ship or station) Crate (on first-person platform) Macro Macro name (either a plain macro string or a script expression that evaluates to a string or macro) Construction plan Module type limit. Integer or a script expression that evaluates to an integer Ship is docked or parked at another object, including internal storage and piers Known to player? Is the station connected to a mass traffic network? Text page ID Text page ID (defaults to the speaker's voice page if not supplied) Line ID in a text page Optional short delay before the speech. Note that the delay is technically treated like a part of the actual speech, except for the display of subtitles and for the time value of a speak timer. Optional emotion description: Either a single emote ID string (triggered at the start of the speak) or a list [ offset1, emote1, offset2, emote2, ... ], with pairs of relative offsets and emote ID strings. Each offset is a value between 0.0 and 1.0, relative to the duration of the speak. NOTE: time offsets are not supported. A value of null is allowed and has no effect. Optional timer value to request an <event_speak_timer_triggered> event at a certain time while a speak voice sample is played: Specify either a value of type time as an absolute real-time offset (e.g. 500ms to trigger the event after half a second), or a value of type float, relative to the duration of the speak (e.g. 0.5 to trigger the event after 50 percent of the speak duration). A negative value of either type is interpreted as the time before the end of the speak (e.g. -500ms to trigger half a second before the speak ends). The timer event is guaranteed to be triggered before <event_speak_finished>. If the speak fails or gets interrupted for any reason (possibly even before the requested time), both <event_speak_timer_triggered> and <event_speak_finished> will be triggered in this order, each with param3 indicating the failure reason. The event timing accuracy is about 50ms. It is not possible to trigger more than one timer event per speak. See also attribute interruptontimer. When used together with the timer attribute, should the speak be interrupted automatically when the timer is triggered? If used, it is guaranteed that param3 of <event_speak_finished> will not be 0. Defaults to false. Line ID or a list of line IDs on a text page (list may include time values within the line ID sequence, to insert delays/pauses between lines) Conversation section name Conversation name Negate condition? Negate filter outcome? The negation applies to the whole element, e.g. <match_content negate="true"> matches objects which do NOT have the specified content. Colour Value (0 - 255) Mass traffic network ID Discount/commission amount as percentage of a ware's price variation range, valid range from 1 to 100. NOTE: This is not the actual discount/commission percentage, which depends on the ware that the price modifier is applied to. Discounts/Commissions apply to all sell/buy offers of object/faction respectively. Single result value if multiple="false", otherwise list of result values Group of event objects (can be supplied instead of a single event object). The check attribute does not apply. The group is required to exist but may be empty. Adding/removing group members is possible even after the event is set up. Produce an error message if the provided event object does not exist? Default is true. NOTE: If the event object is a variable or a changeable property, changing it at a later time has no direct effect on this event condition, i.e. it is not re-enabled automatically. It is only updated under certain conditions, e.g. when loading a savegame or when the event condition is restarted explicitly (resetting MD cue or starting AI script). Notification text to be displayed, either a single string with possible line breaks (left-aligned), or a list of strings. In a list, each pair of strings defines a single row (left-aligned and right-aligned text). In the list you can use [ string, r, g, b ] instead of a simple string to specify an RGB text color, with color values between 0 and 255. The default color is determined by the notification priority (a priority above 1 will turn the color red). Numbers are also accepted instead of strings. The maximum number of rows is 4 in the message ticker (<show_notification>), and 7 in the target monitor (<show_interactive_notification>) Is the receiving container allowed to receive the people as person templates? Takes precidence over 'receiveworkforce'. Defaults to true. Is the receiving container allowed to receive the people as workforce? (defaults to false) Is the providing container allowed to provide people from their own people? Takes precidence over 'provideworkforce'. Defaults to true. Is the providing container allowed to provide people from their own workforce? (defaults to true) Notification type. Must be a 'notification' datatype. (see notificationtypes.xml) Version status Proof of concept only Under development Test version Release candidate Released Waiting for other assets Selection type (used with select sub-nodes) One Random Random, excluding an item that can be optionally specified by code Choose Weight which determines the chance of this node being selected Operation to perform (default is set) Set value (default operation if not supplied, default action is to set to 1 if no random range supplied) Add to value (default is to add 1 if no random range supplied) Subtract from value (default is to subtract 1 if no random range supplied) Insert value into the list as the specified list element, moving all following elements. Insertion at list count + 1 is allowed. (Default value is null if no random range supplied) Kill method Unknown Collected Collided Context killed Detached (used for bombs that are turned into floating collectables) Hit by area damage Hit by bomb Hit by bullet Hit by mine Hit by missile Attacked in low attention Removed Self-destructed Suffocated Target point discarded Timed out Weapon swap Argon Boron Split Drone Kha'ak Paranid Teladi Terran Xenon Argon Boron Drone Kha'ak Split Paranid Teladi Terran Xenon Race (species) Alliance of the Word Antigone Republic Argon Federation Boron (only valid if Kingdom End extension is active) Duke's Buccaneers Court of Curbs (only valid if Split Vendetta extension is active) Civilian Criminal Free Families (only valid if Split Vendetta extension is active) Hatikvah Free League Holy Order of the Pontifex Holy Order Faithful Quettanauts (only valid if Timelines extension is active) Kha'ak Loanshark / Vigor syndicate (only valid if Tides of Avarice extension is active) Ministry of Finance Ownerless Paranid Pioneers (only valid if Cradle of Humanity extension is active) Player Scale Plate Pact Scavengers (only valid if Tides of Avarice extension is active) Smuggler Zyarth Patriarchy (only valid if Split Vendetta extension is active) Teladi Company Terran main faction (only valid if either Cradle of Humanity extension or Timelines extension is active) Realm of the Trinity Yaki (only valid if Cradle of Humanity extension is active) Xenon Alliance of the Word Antigone Republic Argon Federation Boron (only valid if Kingdom End extension is active) Duke's Buccaneers Court of Curbs (only valid if Split Vendetta extension is active) Civilian Criminal Free Families (only valid if Split Vendetta extension is active) Hatikvah Free League Holy Order of the Pontifex Holy Order Faithful Quettanauts (only valid if Timelines extension is active) Kha'ak Loanshark / Vigor syndicate (only valid if Tides of Avarice extension is active) Ministry of Finance Ownerless Paranid Pioneers (only valid if Cradle of Humanity extension is active) Player Scale Plate Pact Scavengers (only valid if Tides of Avarice extension is active) Smuggler Zyarth Patriarchy (only valid if Split Vendetta extension is active) Teladi Company Terran main faction (only valid if either Cradle of Humanity extension or Timelines extension is active) Realm of the Trinity Yaki (only valid if Cradle of Humanity extension is active) Xenon Faction Station type Station type Owner faction Owner faction, or list of owner factions Directional Quadrant Room type Agent experience type Agent risk All weapons (including mining or repair lasers!) Combat weapons (default) Mining weapons Repair weapons Any mode applies Attack all enemies Attack only capital ships (All ships of size class L or XL) Attack only non-capital ships (All ships of size class XS, S, or M) Defend against attackers (default for non-mining weapons) Mining asteroids (default for mining weapons) Attempt to shoot down missiles Attack all enemies, but prioritize capital ships (Ships of size class L or XL) Attack all enemies, but prioritize fighters (Ships of size class XS, S, or M) Attack all enemies, but prioritize missiles Attempt to tow scrap Automatically target the current target (player only) Do not shoot Dock is either empty or the docked ship is stationary A ship is in its final docking manoeuvre A ship is currently being retrieved A ship is currently being retrieved, it will undock as soon as this is done A ship is currently being stored A ship is currently undocking Ship type Align so that refpos/refobj is on the left side Align so that refobj-bounding-box is on the left side (requires valid refobject!) Align so that refpos/refobj is on the right side Align so that refobj-bounding-box is on the right side (requires valid refobject!) Orientation that looks directly at refpos/refobj-center Orientation that looks directly at refobj-bounding-box (requires valid refobject!) Orientation that looks away from refpos/refobj-center Orientation that looks away from refobj-bounding-box (requires valid refobject!) Player activity No activity Long-Range Scanning activity Object Scanning activity Travel drive No alert Red alert Yellow alert Component Build processor Accessory Bullet Countermeasure Crate Positional Ad Sign (child of an object) Build Module Cargo Bay Construction Control Panel Destructible Dock Area Engine Habitation Module Interior Launcher Lock Module Nav Context Pier Processing Module Production Radar Scanner Shield Generator Storage Module Turret Venture Platform Module Walkable Module (DockArea or Build Module) Welfare Module Weapon Ad Sign Object (child of a zone) Asteroid Bomb Checkpoint Collectable Container Controllable Data Vault Defensible Drop Explosive Gate Highway Entry Gate Highway Exit Gate Lockbox Mine Missile Nav Beacon Nebula Object Recyclable Resource Probe Satellite Ship Spacesuit XS sized ship S sized ship M sized ship L sized ship XL sized ship Station Area Cluster Galaxy Highway Sector Zone Entity Player Non-player Computer NPC Room Cockpit Control Room Docking bay Transporter room Fully locked Partially unlocked Fully unlocked Actor (entity) type Actor (entity) role Skill type Control post Defends commander. If commander is a ship, responds to attacks on the commander and other members of the fleet but stays within 20km of the commander. If assigned to a station, guards the space around the commander out to the subordinate's maxradarrange. Attacks with the commander. If commander is AI, inherits commander's Attack orders. If commander is the player, attacks whatever the player hits with weapons fire. Only available to ship subordinates. Detects and pre-emptively attacks any hostile S or M ships detected in gravidar. Only available to ship subordinates. Detects and pre-emptively attacks any hostile L or XL ships detected in gravidar. Only available to ship subordinates. Exclusively available to subordinates of carriers. Defends an area potentially remote from their fleet, but is able to detect attacks and respond to attacks to the rest of their fleet and go back to the carrier for repairs. Inherits the commander's default order. In cases where default order functionality is skill-limited, they try to do it to the best of their own ability. Only available to ship subordinates. Mines for their commander. Only available to station subordinates. Trades for their commander. Only available to subordinates of stations or fleet auxiliary ships. Makes itself available to provide repair and supplies for its fleet, and tries to make sure it maintains ample stores for those activities. Trades for a station's buildstorage. Only available to station subordinates. Collects salvage and delivers it to their commander. Only available to station subordinates. Follows their commander. Will only respond to attacks directed at this subordinate. Defends commander. If commander is a ship, responds to attacks on the commander and other members of the fleet but stays within 20km of the commander. If assigned to a station, guards the space around the commander out to the subordinate's maxradarrange. Attacks with the commander. If commander is AI, inherits commander's Attack orders. If commander is the player, attacks whatever the player hits with weapons fire. Only available to ship subordinates. Detects and pre-emptively attacks any hostile S or M ships detected in gravidar. Only available to ship subordinates. Detects and pre-emptively attacks any hostile L or XL ships detected in gravidar. Only available to ship subordinates. Exclusively available to subordinates of carriers. Defends an area potentially remote from their fleet, but is able to detect attacks and respond to attacks to the rest of their fleet and go back to the carrier for repairs. Inherits the commander's default order. In cases where default order functionality is skill-limited, they try to do it to the best of their own ability. Only available to ship subordinates. Mines for their commander. Only available to station subordinates. Trades for their commander. Only available to subordinates of stations or fleet auxiliary ships. Makes itself available to provide repair and supplies for its fleet, and tries to make sure it maintains ample stores for those activities. Trades for a station's buildstorage. Only available to station subordinates. Collects salvage and delivers it to their commander. Only available to station subordinates. Follows their commander. Subordinate assignment Control position lookup Flat (linear) distribution, default if no profile specified Higher numbers are more likely Lower numbers are more likely Numbers in the middle of the range are more likely Higher and lower numbers are more likely than those in the middle Position in conversation menu (a free position is selected if not supplied). This can be either a fixed named value, or a variable script expression (providing the option number between 1 and 6). Hidden player choice that is selected when the player presses the "close conversation" button Top left corner (default) Middle of screen (targeting) Near weapon monitor Near event monitor Near speedbar Difficulty level Trivial difficulty level Very easy difficulty level Easy difficulty level Medium difficulty level Hard difficulty level Very hard difficulty level Impossible difficulty level Upkeep alert level Low upkeep alert level Medium upkeep alert level High upkeep alert level Logbook category Logbook interaction type Starts guidance to the object from the logbook UI Opens the map focused on the object from the logbook UI Opens the map at a specified location from the logbook UI (requires sector as interaction object and a position relative to the sector) Behaviour to compare the relation range Relation is in range (default) Relation is greater than or equal Relation is greater than Relation is less than or equal Relation is less than Relation is not in range unsupported - Dummy, no param param = radius param = radius param = radius param = radius unsupported unsupported param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance param = distance Implicitly defines the interactions and the icon this target point should have Faction mood type Faction mood level Order is in the parameter setup process, not all parameters have been provided yet. In this state the order cannot be enabled. Order is disabled (this state is automatically entered when parameter setup is complete) Order is enabled but not running yet. In this state, an order in the queue is started when it becomes the current order (which is always the first order, except in order loops). A default order is started if no order in the queue is ready. Order script has started and has not entered the critical state or the finish state. Order script has entered its critical state. In this state, the order cannot be cancelled directly any more, and parameters can only be edited if allowed by the order definition. Moving or disabling the order is not possible any more. Requests to cancel the order can be made, but they are not necessarily processed immediately; the cancelling behaviour is order-specific. To handle a cancel request in the critical state, the order script stack has to listen to <event_object_order_cancelled> with immediate="false". If not cancelled, the order can optionally leave the critical state by entering the finish state. Optional state that can be entered by the order script for finalisation actions. Disabling, moving and editing the order is not possible any more. The critical state cannot be entered any more. The order script can be cancelled instantly at any time (unlike in the critical state, cancel requests are not passed to the script stack and cannot fail). The order will be treated as finished even if the script gets cancelled. The script will be cancelled automatically as soon as a new queue order is ready to be started. This state could e.g. be useful if the actual order is already completed but the ship should move "out of the way" before continuing with the default order. Engines. Weapons. Shields. Turrets. Shield groups. Turret groups. Ammunition. Units (drones). Software. Thrusters. Crew (only used when applying player-created loadouts or when people data is not supplied) Ability drones. Add loadout elements (not used for loadout generation). Remove loadout elements (not used for loadout generation). Do not allow differing items to enhabit slots flagged as symmetrical. May allow one of the slots to remain empty if a suitable item can not be found. Loadout flag bitmask (use as many as required). Object has ship production facilities Object does not have ship production facilities Object does not have ship equiping facilities Object has faction leader on board Object has ship equipping facilities but no ship production Allow the definition to be selected as a fallback if no other suitable definitions are selected, ignoring all other flags Prop flag bitmask (use as many as required). Allow Player Blueprint Blueprint Clothing Mod Crafting Economy Equipment Illegal Inventory Gift Rare Allow Drop Equipment Mod Lockbox Mission Only Module Paint Mod Personal Upgrade Resource Scanner Ship Single Craft Trade Only Trade Ware Unbundle Ammo User Item Volatile Ware flag (use as many as required). Object has been destroyed. Object has been damaged. Param = string describing the severity: low, medium, high Object has acquired loot. Param = string describing the value: low, medium, high Defined price value is in Credits, not to be scaled. Defined price value is a percentage applied to the player's current account. Price scales with the world's current population. Defined value is for 100k inhabitants. Universal Insufficient resources for construction. Insufficient storage for recycled resources. No container object for construction. Container unable to construct object macro. Container unable to construct equipment. Assigned module is hacked. Assigned module is paused. Required construction vessel is not present. Build issue flag bitmask (use as many as required). everybody is allowed only objects belonging to the same owner faction are allowed everybody except objects belonging to the player are allowed object: inherit from owner faction setting, faction: equivalent to freeforall Macro or list of macros Treat owner, trueowner or coverowner as "not"-list? Connection tag Component, list of components or a group to exclude from being found Connection group tag State of component Is integrated to the parent? (built-in component) Is either hull or shield invulnerable, i.e it cannot take damage? Note: An object can be vulnerable but still indestructible. Is hull invulnerable, i.e it cannot take take damage? Is shield invulnerable, i.e it cannot take damage? Can the object not be destroyed through damage? Should the search be restricted to operational objects? If yes, this is equivalent to state="componentstate.operational". This is implicitly enabled in action elements (e.g. <find_...>) or condition elements (e.g. <count_...>), so it is true by default and can be disabled by supplying checkoperational="false". On any sub-elements (e.g. <match...>) it is false by default, so also non-operational objects are matched by default (unless already filtered out elsewhere). If the state attribute is present on a node, checkoperational is ignored. Is functional? Is a surface element? Is a module? Known to player? Known to faction? (Faction or list of factions) Is the object visible on the player's gravidar or by any player-owned object Suspicious? Leads to this destination? (could be space, gate or highway exit gate) Component contains a trade offer? Does the provided faction have knowledge of trade offers of the container? Can a dynamic interior be created on the object? Offer tag Is a free mission offer location available at the container? Is a free signal leak location available at the object? Is object from mass traffic? Is object from a region? Is object an online object? If the object is on a venture, match by a venture ID string or a list of ID strings Is the apparent owning faction a member of the coalition with this ID? Is the true owning faction a member of the coalition with this ID? Is object a visitor? Is the room walkable, i.e. accessible to the player and NPCs? Does the controllable object, walkable module or room contain any walkable rooms (includes the room itself in the room case), i.e. accessible to the player and NPCs? Room population type Is build module currently building Is build module or build processor currently busy Does the object have a build task assigned for it? Can be built by this object? Can be built by any of these objects? (list or group) Does the object allow the provided faction to build Can build class? If null, filter is not applied. Can build ships? (finds containers, not build modules) Can equip class? If null, filter is not applied. Can supply class? If null, filter is not applied. Can equip ships? (finds containers, not build modules) Can supply ships? (finds containers, not build modules) Can build equipment ware (or list of wares)? Can build macro? Can carry this waretransport type or list of waretransport types (can find containers or storage modules) Weapon mode Weapon type Primary purpose Is a deployable object Is a data vault object Is a landmark object Deployable category Does this object's relation and fire authorisation override allow it to attack supplied object or faction. Unless active fire authorisation override indicates otherwise, true if relation is 'kill', or if relation is 'killmilitary' and supplied object has primarypurpose.fight. May this object be attacked by supplied object or faction based on that faction's relation and fire authorisation override. Unless supplied object's active fire authorisation override indicates otherwise, true if relation is 'kill', or if relation is 'killmilitary' and this object has primarypurpose.fight Do mutual object relations and fire authorisations allow either side to attack (see mayattack and maybeattackedby). Can object be picked up by another object? Is the object commandeerable Is the object a unit Does the object have a commander Does the object have a control entity of the specified post Is the object capturable, either via signalleak (S sized) or via boarding (M+ sized) Is the gate an accelerator Is the highway gate connected to a super highway? Otherwise is it connected to a local highway? Is the object 'active'? Is the object 'paused' for any reason? Applicable for production modules. Is the object manually 'paused'? Applicable for production modules. Signal Leak type Source extension id (standard extension) Source extension id (personal extension) Is the object covered? Can the component currently be dismantled? Can the component be towed? Is the component reachable from this component via a path through the galaxy? (note: this component does not have to be mobile) Are all collision meshes for this component are loaded and ready? Is the object currently suitable to be featured in a live stream? Is the object internally stored in a dockingbay? Is the actor a control entity? Is the actor a mission actor? Is the actor a faction representative? Is the actor temporary? Is the station capable of claiming ownership of a space? Is the station a trade station Is the station a shipyard (i.e. it can build capital ships) Is the station a wharf (i.e. it can build non-capital ships) Is the station an equipment dock (i.e. it can change loadouts, but not build ships from scratch) Is the station a defence station Is the station a recycling facility with a processing module Is the station a faction headquarters Is the station a planned defence station, taking future modules into accounts Is the station a planned recycling facility with a processing module, taking future modules into accounts Is the station a planned equipment dock, taking future modules into accounts Is the station a planned faction headquarters Is the station a planned headquarters Is the station a planned piratebase Is the station a planned shipyard, taking future modules into accounts Is the station a planned trade station Is the station a planned wharf, taking future modules into accounts Is the station a headquarters Is the station a pirate base Does the ship have a job Job identification string or list of job ID strings Is the ship and those in its command structure organised correctly, as defined by their jobs? Tag or list of tags to compare with the defined job category tags Is the ship a requested job ship? Is the ship's job a subordinate job? Encounter identification string or list of encounter ID strings Is the ship an encounter job ship? Room has a control panel of the specified type Include only permanently normal zones (not temporary, not gate zone and not highway)? Include only currently normal zones (not temporary, not gate zone and not highway)? If originally a temporary zone this zone may revert back to a tempzone or be removed, depending on its contents. Include temporary zones? Is the sector contested? Is the sector contested by provided faction? Does the sector contain a gravidar obscuring region? Does the sector contain a hazardous region? Include only normal clusters (not presentation cluster, not venturer cluster)? Does the sector owner currently grant access to the provided faction? Does the sector owner currently restrict access to the provided faction? Is this space suitable for a job ship to be based in? (jobship or job ID) Tag or list of tags that this space or its parent spaces must have as location tags Tag or list of tags that this space or its parent spaces must have at least one as location tags Wrecked components that can be restored (exclusive with 'repairable' and 'needsrepair') Damaged components that can be repaired but may still be functional (exclusive with 'restorable' and 'needsrepair') Damaged components that are no longer functional and can be repaired (exclusive with 'restorable' and 'repairable') Class or list of classes (do not use in conjunction with 'exactclass' attribute) Exact class or list of exact classes, not taking subclasses into account (do not use in conjunction with 'class' attribute) Entity class or list of classes (do not use with 'exactclass') Entity's exact class (or list of classes), not taking subclasses into account (do not use with 'class') God object entry identification string or list of god object entry ID strings Tag or list of tags to compare with the defined god entry category tags Object class or list of classes (do not use with 'exactclass') Object's exact class (or list of classes), not taking subclasses into account (do not use with 'class') God station entry identification string or list of god station entry ID strings God production entry identification string or list of god production entry ID strings Station class Ship class God ship entry identification string or list of god ship entry ID strings Room class or list of classes (do not use in conjunction with 'exactclass' attribute) Room's exact class or list of exact classes, not taking subclasses into account (do not use in conjunction with 'class' attribute) Sort matching objects by distance to provided object (only one sortby* attribute can be used; see also sortdescending and sortlimit, if applicable) Sort matching objects by number of gate jumps from provided object (only one sortby* attribute can be used; see also sortdescending and sortlimit, if applicable). This automatically excludes any objects without a valid gate distance (i.e. objects to which there is no path through the galaxy from the provided object) from the result. Sort matching objects by number of gate jumps to provided object (only one sortby* attribute can be used; see also sortdescending and sortlimit, if applicable). This automatically excludes any objects without a valid gate distance (i.e. objects from which there is no path through the galaxy to the provided object) from the result. Sort matching objects by a numeric value per object, provided by this script expression, which is evaluated for each object and can access the current object via 'loop.element' (only one sortby* attribute can be used; see also sortdescending and sortlimit, if applicable) Should the objects be sorted in descending order? In this case the first object will have the highest associated value (e.g. largest distance when sorting by distance). This has no effect if no sort criteria are defined. Optional maximum for the number of provided results after sorting. This has no effect if multiple="false" or if no sort criteria are defined. Object from which to obtain blacklist filter Default faction blacklist group (civilian, military) to use if object doesn't have a blacklist of its own of the specified type Ship group for random macro selection Reference to ShipDB entry (either a plain ID string or a script expression that evaluates to an ID string) Is the ship capturable, either via signalleak (S sized) or via boarding (M+ sized). The default is based on macro, usually true with some exceptions like XS/Spacesuit/Xenon/Khaak. Additionally, for S-ships the pilot will not eject if it's not capturable . Note: For S-ships, when capturable is false, no capture signalleak will be created, but you can add/remove this leak afterwards by calling set_object_capturable. Keep in mind that such leaks only exist in nearby-attention! Is the ship sellable? (default is true) Character group for random macro selection Existing actor to be used instead of creating a new NPC (only useful with variable expressions in scripts) Reference to CharacterDB entry (either a plain ID string or a script expression that evaluates to an ID string) Module group for random macro selection Reference to ModuleDB entry (either a plain ID string or a script expression that evaluates to an ID string) The base construction plan (Optional. Either a plain ID string or a script expression that evaluates to an ID string) Room group for random macro selection Reference to RoomDB entry (either a plain ID string or a script expression that evaluates to an ID string) Prop group for random macro selection Reference to PropDB entry (either a plain ID string or a script expression that evaluates to an ID string) Station group for random construction plan selection A station macro (either a plain macro string or a script expression that evaluates to a string or macro) to place instead of a construction plan. This station macro MUST have a moduleset defined for it. Reference to StationDB entry (either a plain ID string or a script expression that evaluates to an ID string) An object macro (either a plain macro string or a script expression that evaluates to a string or macro). Exact value (takes priority over min/max/profile/scale) List of values, from which one value will be selected randomly (takes priority over min/max/profile/scale, ignored if exact is set) Minimum random number (ignored if exact is set) Maximum random number (ignored if exact is set) Random number profile (ignored if exact is set) Scale of random number profile (ignored if exact is set or if profile is flat) Fixed seed used for random number evaluation. Auto-advance seed used for random number evaluation. Name of loop counter variable If true then loop counter counts from the max value down to 1 List, group or table that should be traversed. It is stored internally during the traversal, so the expression is evaluated only once. In general, avoid insertion and removal of list/group elements during the traversal; however, it is supported according to these rules: - In lists and groups, insertion and removal is allowed at an index greater than the current one, but not allowed at a lower index. - In lists and groups, insertion and removal at the current index is only allowed if reverse="true". - In tables, keys may be inserted or removed at any time, even the current one (but note that newly inserted keys in the already traversed range will not be reached by the traversal). Name of loop counter variable, which will be set to the current index in the list or group. Cannot be used when traversing a table. Name of the element/key variable, which will be set to the current element in the list or group, or the current table key, respectively. Name of the table value variable, which will be set to the value of the current table key. Can only be used when traversing a table. Set to true to traverse the list, group or table in reverse order, starting with the last element or key, respectively. In list/group cases, the index counter counts from the highest index down to 1. Exact match value (takes priority over list and min/max) List of matching values (takes priority over min/max, ignored if exact is set) Minimum matching number (ignored if exact is set) Maximum matching number (ignored if exact is set) Event object (required if group attribute not supplied) Cluster, used as event object (required if group attribute not supplied) Percentage chance of condition being checked (condition fails if not) Chance percentage of action being performed (action is skipped if not -- in case of a conditional action such as <do_if>, any following <do_elseif>/<do_else> actions will still be performed as if the condition had failed) Weight of action which determines its chance of being selected (integer value, only evaluated in <do_any> blocks, default is 1 if omitted) Value to match (checked for non-zero if no comparison range or list is specified) X coordinate Y coordinate Z coordinate Position value (can be combined with coordinate attributes, but cannot be used in combination with randomoffset attribute) Random offset from provided object (given as length or vector value - can be combined with coordinate attributes, but cannot be used in combination with value attribute). When a length is given, it specifies the maximal offset distance from the object in any direction (equivalent to a vector with identical X/Y/Z extents). When a vector is given, it specifies an ellipsoid with given X/Y/Z extents around the object - the random offset is a vector to a random point inside the ellipsoid. NOTE: Using the same randomoffset value with the same object multiple times will always yield the same random offset. NOTE: In order to retrieve only the random offset (relative to the object itself), the space attribute value has to set to the object. An object (or any positional). Requires a space context to which its relative position is calculated. If also coordinates and/or a position value are supplied, they are interpreted as relative to the object. Reference space to be used if the object attribute is supplied. Defaults to the space supplied by the parent XML node, if applicable, otherwise to the object's parent space. Distance from specified position Vector value (can be combined with coordinate attributes) Yaw rotation Pitch rotation Roll rotation Rotation value, used in preference to angles if supplied Allow the generated position to also use the up/down axis, defaults to true Radius to indicate necessary space required for a safe position (optional, typically defaults to the radius of the bounding box if an object or macro is supplied) Angle tolerance from the specified direction Direction for safepos checks. Based on the orientation of the 'directionobject' if provided. Can be combined with 'direction2' Direction for safepos checks. Based on the orientation of the 'directionobject' if provided. Can be combined with 'direction' but ignored if opposing Direction object for safepos checks. If direction is not specified, the direction is considered to be from the base position to this object Avoid the firing range of turrets Avoid the plot box of stations Ignore dangerous regions (defaults to false) Allow the generated position to also use the up/down axis, defaults to true Radius to indicate necessary space required for a safe position (defaults to created object radius if null) Avoid the firing range of turrets Avoid the plot box of stations Ignore dangerous regions (defaults to false) Position of this object will be used as refposition, for boundingbox orientations the box of this object will be used. Position the orientation refers to (e.g. look_at means look from position to refposition), ignored if refobject is set Red. Green. Blue. Choice text Optional, set to true to highlight the option and to indicate that it is mission-related (defaults to false) Optional, determines whether the option is selectable. Defaults to true if not supplied. Optional, specifies the tooltip displayed for this option. Interactive notification data Text displayed during interactive notification to prompt player to interact Interactive notification parameter passed to <event_player_interaction> Secondary interactive notification parameter passed to <event_player_interaction> Should the flashing effect of the target monitor be suppressed? Conversation actor entity (use attribute context and template instead to provide an NPC template instead of an entity as conversation actor) Controllable object context of the provided NPC template (when using template attribute instead of the actor attribute) Conversation actor NPC template (can be used instead of actor attribute to provide an NPC template, requires context attribute) Position of help text (defined in parameters.xml) - defaults to 0 Duration of help text display. If not provided, a suitable duration will be calculated. Add help text to logbook? Default is false Pause keeps the help text open (default is true) Factor to modify help text width in percent (default is 200, minimum is 50) Whether the player is allowed to close the hint, use with care (default is false) Whether the hint will timeout after duration (default is true); use with care, if allowclose is false (its default) Defines the text color in the format [r, g, b, a] - default is white Horizontal alignment of the hint text (default is 'left') Whitelist this help text in menus which normally forbid them (e.g. the options menu) - format 'MenuA MenuB MenuC' Optional name of the value that will be set to true if successful, false in case of failure (e.g. because it's a non-forced hint that was already shown, or one that references an unmapped input) Name of the group to which all spawned ware containers will be added (optional, group will be created if it does not exist yet) Name of the value that will receive a list of all spawned ware types (optional) Name of the value that will receive a list of ware amounts, corresponding to the wares result list. Should the ware be unbundled (turn ware into ammo/units) on transfer? (optional, defaults to false) Do the wares to be dropped come from ammo/unit storage? (optional, defaults to false) Object the boost is towards, using the object's apparent owner (takes preference over 'faction') Faction the boost is towards ('otherobject' takes preference if provided) Decay rate Decay delay Is the relation boost silent, i.e. without player notification? See <event_player_relation_changed> List of NPC templates (size must match with other lists) List of roles to reassign people (size must match with other lists) List of amounts (size must match with other lists) List of roles currently assigned to help identify people (size must match with other lists) List of roles to reassign people (size must match with other lists) List of races to help identify people (size must match with other lists) List of skills to help identify people (size must match with other lists) Are the skills exact or used to find a suitable tier (defaults to false) Is there a custom comm handler for player-initiated comm.? If so, this suppresses the generic <event_conversation_started> handler to avoid interference. Set whether currently in transit or not? In transit actors do not activly control objects. Set whether currently busy or not? Busy actors do not activly control objects. Set whether the actor is a mission actor or not. Set whether the actor is remote commable or not. (only relevant for NPC actors, not NPC templates and is automatically set when NPC is instanced and unset when creating a template) Set whether the actor is temporary or not. Set whether the actor hidden in their room. Set trades to visible or invisible. Trades are hidden unless explicitly made visible. (e.g. Shady Guy) Set whether the actor name should be included in subtitles when this entity speaks (optional) single ware or list of wares to set, add or remove, omitting this will clear the list if append and remove are false (default) Should the specified ware(s) be added to the existing list? (defaults to false which will replace or remove existing entries) Should the specified ware(s) be removed from the existing list? (defaults to false which will add or replace existing entries) Cutscene key name (ignored if cutscene attribute is supplied) Cutscene identifier as returned by <play_cutscene> (takes precedence over key attribute) General userdata value name (when setting, 'value' can contain any numeric value) Money state name (when setting, 'value' must contain a positive money value, 'money_' prefix recommended) Known state name (when setting, 'value' must contain a positive integer, 'known_' prefix recommended) Relation state name (when setting, 'value' must contain a positive integer, 'relation_' prefix recommended) People state name (when setting, 'value' must contain a positive integer, 'people_' prefix recommended) Story state name (when setting, 'value' must contain a positive integer, 'story_' prefix recommended) Set value in signed userdata file? (ingored except when used with 'name' attribute in an unmodified game) Set value only in signed userdata file? (implies 'signed' set to true, action is silently skipped in modified games where signed userdata is not accessible) Stat ID (see terraforming.xml for valid values) or "population" (optional) Time in seconds after which the launched object should self-destruct (only when not visible) [if omitted or null] non-player objects self-destruct after time set in launched class defaults, see deployabletimeout [negative] never self-destruct [0s or greater] self-destruct after the specified time (also applies to player property) Station or BuildStorage of which the plot will be extended Extension of the plot length on the negative X axis Extension of the plot length on the negative Y axis Extension of the plot length on the negative Z axis Extension of the plot length on the positive X axis Extension of the plot length on the positive Y axis Extension of the plot length on the positive Z axis Should the build plot be allowed to reduce in size if necessary. Defaults to false. Author details Author name Author alias Author contact details File reference File name File description Internal version number Date of current version Status of current version Match filter Match any of the specified filters (attributes and sub-elements) Match filter for the parent of the object Match filter for the context of the object Match filter for the children of the objects Match filter for the contained objects of the objects Match filter for amount of children defined in the macro of the objects Match hull percentage Match max hull percentage Match shield percentage Match object secrecy level Match attention level Min attention level (not compared if not supplied) Max attention level (not compared if not supplied) Exact attention level (not compared if not supplied) Match by reveal percentage filter Match filter for the ship's pilot Match by distance filter. Distance can be checked either to an object or to a position. The reference space, if supplied, must contain the searched objects. min and/or max must be set. X coordinate Y coordinate Z coordinate Position value, used in preference to coordinates if supplied Object, used in preference to coordinates if supplied. If no space context is supplied, the object's sector is used, so the searched objects are required to be in the same sector. Reference space which has to contain both the reference (object or position) and the searched objects. Minimal distance (min distance is not compared if not supplied) Maximal distance (max distance is not compared if not supplied) Match by distance by jumpgates. Calculation based on the sectors of the objects. Checking distance of clusters will check between two random sectors within them. Use specified sector travel blacklist when calculating distance Min distance by jumpgates (not compared if not supplied) Max distance by jumpgates (not compared if not supplied) Origin object for the distance calculation. Passing cluster will base the check on a random sector. Match only items that are not in the specified blacklist. Blacklist type (e.g. sectoractivity) to use Match by size filter. Size is based on diameter of the bounding box. min and/or max must be set. Minimal size of the bounding box (min size is not compared if not supplied) Maximal size (max size is not compared if not supplied) Match by view angle filter. Can be checked either to an object or to a position AND rotation. The reference space, if supplied, must contain the searched objects. X coordinate Y coordinate Z coordinate Pitch (rotation around x axis) Yaw (rotation around y axis) Roll (rotation around Z axis) Object, used in preference to coordinates if supplied. If no space context is supplied, the object's sector is used, so the searched objects are required to be in the same sector. Reference space which has to contain both the reference (object or position/rotation) and the searched objects. The vertical viewing angle (full range from top to bottom) The horizontal viewing angle (full range from left to right) Match filter for available buy offers Match filter for available sell offers Match filter for build tasks Match filter for products of a Container or Production Module. The match is valid if the object produces any of the supplied wares, even if there are no current sell offers. Match filter for resources of a Container or Production Module. The match is valid if the object consumes any of the supplied wares, even if there are no current buy offers. Match filter for the cargo wares of a container class object (e.g. Ships, Stations) Match filter for the non-cargo wares of an object (e.g. Collectable Ware Drops, Asteroids, Recyclables) Match filter for the basket wares of a job ship Match by relation filter. Relation of 'faction' or 'object' is checked against filtered object. Object to reference (takes preference over 'faction') Faction to reference ('object' takes preference if provided) Relation range Match by relation filter. Relation of filtered object is checked against 'faction' or 'object'. Object to reference (takes preference over 'faction') Faction to reference ('object' takes preference if provided) Relation range Match filter for whether a licence is required to access to an object or area of space. Type of licence (can be faction to match any licence for that faction, licence type to match licence type for any faction, or licence for exact match) Match filter for a dock. Can be used on a Walkable Module, Container object or a Docking Bay itself. Note: If finding or counting contained components be wary that there may be multiple positive results, even if there is only one dockingbay. e.g. matching contents for a station will include the dockingbay but also its containing walkable module. To only account for docking bays, also filter by dockingbay class. Is dock free? Dock compatibility size tag or list of size tags (matching 'any'). Is the docking bay an internal storage bay? (defaults to false, i.e. internal storage bays are ignored by default) Is it required that the dock allows building? Is it required that the dock allows trading? Allow finding a dock that is exclusive for player-controlled ship? (defaults to false, i.e. player-exclusive docks are ignored by default) Is the dockingbay walkable, i.e. accessible to the player and NPCs? Is dock exclusive for venturers? Can be used in combination with ventureplatform attribute. (Defaults to false, i.e. venturer-exclusive docks are ignored by default) Specific venture platform with which venture dock must be associated (optional, can be null). Only takes effect if ventureronly is set to true. Match filter for stored units on a Defensible object (including both available and unavailable) Match filter for available units on a Defensible object Match filter for unavailable units on a Defensible object Match filter for the cargo of a storage module or container class objects (e.g. Ships, Stations) Match filter for the non-cargo wares of an object (e.g. Collectable Ware Drops, Asteroids, Recyclables) Match filter for loadout installed on defensible class objects (e.g. Ships, Stations) Match filter for weapon mods installed on defensible class objects (e.g. Ships, Stations) Match filter for engine mods installed on objects (e.g. Ships, Stations) Match filter for shield mods installed on defensible class objects (e.g. Ships, Stations) Match filter for ship mods installed on ships Match filter for paint mods installed on ships Match filter for any equipmentmod installed on defensible class objects Match filter for the buyer of the trade Match filter for the seller of the trade Ware or list of wares Ware or list of wares Exact number (takes priority over min/max) Minimum number (ignored if exact is set) Maximum number (ignored if exact is set) Secrecy level (omit for all) Unit Category to match Range for the total amount of the trade offer wares Range for the min amount of the trade offer wares Range for the total price of the trade offer Range for the min price of the trade offer Filter by the amount in the trade, not including reservations Filter by the amount in the trade in addition to the amount reserved, additionally this will use the desired amount if money would NOT change hands for this trade Filter by the volume of the trade in addition to the volume reserved, additionally this will use the volume calculated from the desired amount if money would NOT change hands for this trade Filter by price Filter by relative price Filter by total price (optional) single ware or list of wares to filter offers for Should the ware be unbundled (turn ware into ammo/units) on transfer? Should the ware be bundled (convert ammo/unit -> ware) on transfer? A list of wares or table of ware amounts that the loadout should contain. List may contain repeats if more than one of an item is required. A list of macros or table of macro amount that the loadout should contain. List may contain repeats if more than one of an item is required. Weapon group context on which weapon mod should be installed (grouped weapon mods only, macro path as string) Weapon group on which weapon mod should be installed (grouped weapon mods only) Weapon macro of weapon on which weapon mod should be installed (individual weapon mods only, any if not specified) Weapon mod ware (from equipmentmods.xml, defines a quality level and primary property of weapon mod, any if not specified) Engine mod ware (from equipmentmods.xml, defines a quality level and primary property of engine mod, any if not specified) Shield group context on which shield mod should be installed (macro path as string, object's primary shield group if not specified) Shield group on which shield mod should be installed (object's primary shield group if not specified) Shield mod ware (from equipmentmods.xml, defines a quality level and primary property of shield mod, any if not specified) Ship mod ware (from equipmentmods.xml, defines a quality level and primary property of ship mod, any if not specified) Paint mod ware (from equipmentmods.xml, defines a quality level and primary property of paint mod, any if not specified) Position relative to a given space or object Rotation in space Bounding box relative to a given space or object Safe position relative to a given space or object Create the object using a safe position Orientation in space Component Offset Exact number (takes priority over min/max) Minimum number (ignored if exact is set) Maximum number (ignored if exact is set) (optional) tradepartner container that will do the trading. If specified this MUST be the object that does ware reservations. (optional) tradepartner container that will do the trading, used to determine discounts. If specified this MUST be the object that does ware reservations. Faction or list of factions Specification tag or list of tags Ship size Faction or list of factions Specification tag or list of tags Ship size If true then an error message will be produced if no matching ship entry is found (default is true). Note that no ship will be created in either case. Faction or list of factions Specification tag or list of tags Character race (species) Faction or list of factions Specification tag or list of tags Character race or list of races If true then an error message will be produced if no matching character entry is found (default is true). Note that no NPC will be created in either case. Faction or list of factions Race Specification tag or list of tags Production ware Criteria for selecting a suitable module from the ModuleDB. If combined with a static ModuleDB reference in the ref attribute, the nodes of the referenced type take precedence. <select> cannot be combined with a variable ModuleDB reference. Faction or list of factions Module race Specification tag or list of tags Production ware If true then an error message will be produced if no matching module entry is found (default is true). Note that no module will be created in either case. Base station module limits to be respected when initially constructing (Defaults to 20. Modules in defined base construction plans can exceed the limits) Maximum station module limits to be respected when expanding a station (Defaults to the base limits defined in the definition or parameters.xml) Module reference Respect the god.xml quota definitions for this ware for the station's owner and location (defaults to true) Faction or list of factions (defaults to the owner of the station if omitted) Race Specification tag or list of tags Race Specification tag or list of tags Security level (not available from scripts) Minimum security level Maximum security level Economy level (not available from scripts) Minimum economy level Maximum economy level Maintenance level (not available from scripts) Minimum maintenance level Maximum maintenance level Specification tag or list of tags Macro that props can be attached to Prop flags. Not available from scripts. If no flags are defined then prop entry is allowed for any object (matching other criteria). Faction or list of factions Race Specification tag or list of tags Production ware Faction or list of factions Station race Specification tag or list of tags Production ware If true then an error message will be produced if no matching station entry is found (default is true). Note that no station will be created in either case. Source of discount/commission, can be an object or a faction Required type of discount/commission source Source is an object (ship or station) Source is a faction Loadout id Loadout name Loadout icon name Can be used for building? Can be used by jobs? Can be used by player? Loadout was generated? Macro name Macro path Optional item? Ammunition type (missile launchers/turrets only, uses default if ommitted) Weapon mode (turrets only, uses default if ommitted) Debug-only item? Macro name Macro path Connection group Exact number/percentage of slots to fill (takes priority over min/max) Minimum number/percentage of slots to fill (ignored if exact is set) Maximum number/percentage of slots to fill (ignored if exact is set) Exact/min/max values are percentages? Optional item? Ammunition type (missile launchers/turrets only, uses default if ommitted) Weapon mode (turrets only, uses default if ommitted) Macro name Exact number of ammunution units (takes priority over min/max) Minimum number of ammunution units (ignored if exact is set) Maximum number of ammunution units (ignored if exact is set) Percentage chance of being present Optional item? Ware name Percentage chance of being present Macro name Optional item? Crew role Exact number of crew (takes priority over min/max) Minimum number of crew (ignored if exact is set) Maximum number of crew (ignored if exact is set) Percentage chance of being present Optional item? Stat ID (see terraforming.xml for valid values) or "population" The minimum state of the stat. Ignored if minvalue is set. Defaults to no minimum. The maximum state of the stat. Ignored if maxvalue is set. Defaults to no maximum. The minimum value of the stat. Defaults to no minimum. The maximum value of the stat. Defaults to no maximum. Project conditions Override text (optional if a stat is defined) Stat ID (see terraforming.xml for valid values) or "population" Stat change that will be applied The minimum value of the stat after applying the change. Defaults to no minimum. Ignored if stat is "population" The maximum value of the stat after applying the change. Defaults to no maximum. Ignored if stat is "population" Stat value that will be set, used if change if 0. min/max do not apply. Ignored if stat is "population" Whether this effect also happens on failure. Defaults to false. Ignored if stat is "population" Whether this effect is beneficial. Defaults to true. Only required if it's not a stat change or a setback, in which case the code determines it. ID of the project that blocks progress if this side-effect is triggered Percentage of progress lost on current project if side-effect is triggered The chance in percent of this effect to occur. The ware group this rebate applies to (see waregroups.xml). The rebate amount in percent. Ware ID Amount. Defaults to 1. Required resources. The amounts will be scaled, using the average prices, to reach the defined total price. If no resource wares are given this is a direct payment instead. The total cost Whether and how the price should scale. Defaults to 'absolute'. The payout of this project upon successful completion, as a percentage of the price. Defaults to 0. The minimum amount of wares to randomly choose from the list. Defaults to the total amount. The maximum amount of wares to randomly choose from the list. Defaults to the total amount. Ship macro Amount Build duration override per ship Ships to be built for delivery of resources Projects that will be removed when this one is completed (usually used for mutually exclusive choices) ID of the project to remove when this one completes successfully. The predecessor projects that must be completed before this one can be started. Either id or group must be supplied. The ID of the predecessor project. Must include the postfix, if there is one. The group ID of the predecessors. Whether only one of the specified projects in this group is required instead of all of them. Defaults to true. Whether only one of the specified projects is required instead of all of them. Defaults to false. The ID of the project. The name of this project that is shown to the player (text reference). The description of this project that is shown to the player (text reference). The time between all resources being delivered and the project completing. The minimum time between a project completing successfully and it becoming available again. The project is not repeatable if this is not set. The success chance of this project in percent. Defaults to 100. The price of this project in Credits. Is used to calculate the full ware amounts, using the maximum possible prices, if a ware list is supplied. The price scaling method. Defaults to 'absolute'. The time this project was started. If supplied, the effects are already assumed to have taken effect. Defaults to "never". Selection element (used if selection attribute present) Equipment mods The percentage chance that an equipment mod may be installed on this ship. Also the chance that additional equipment mods may be installed. Given as a float between 0 and 1. Engine mod specification Engine mod ware (from equipmentmods.xml, defines a quality level and primary property of engine mod) Weapon mod specification Weapon mod ware (from equipmentmods.xml, defines a quality level and primary property of weapon mod) Weapon macro of weapon on which weapon mod should be installed Weapon group context on which weapon mod should be installed (grouped weapon mods only, macro path as string) Weapon group on which weapon mod should be installed (grouped weapon mods only) Shield mod specification Shield group context on which shield mod should be installed (macro path as string, object itself if not specified) Shield group context (main ship context if not specified) Shield group on which shield mod should be installed (context's null group if not specified) Ship mod specification Ship mod ware (from equipmentmods.xml, defines a quality level and primary property of ship mod) Equipment mod specification list List containing equipment mod wares Criteria for selecting a suitable ship from the ShipDB. If combined with a static ShipDB reference in the ref attribute, the nodes of the referenced type take precedence. <select> cannot be combined with a variable ShipDB reference. Owner faction selection (if missing and a pilot node is present, the pilot's faction will be used) Override the owner faction of the generated NPCs to the owner defined in this node (otherwise the owner may be random based on the character reference) Pilot The loadout that the ship should be given. Can be defined as a reference to a loadout definition or as a level to which the ship should be outfitted. The percentage level to which this ship should be fitted out with randomly generated equipment. Given as a float between 0 and 1. Note that this level is modified by the variation which defaults to the value from parameters unless explicitly specified as well. The faction to use for selecting equipment. Has no effect without valid level also specified. (defaults to owner faction) The variation in level (ignored if level not supplied). Given as a float between 0 and 1 (uses default from parameters if not supplied). A reference to a loadout definition as defined in loadouts.xml A reference to a loadout created by a script The overriding purpose of the object, considered when generating a loadout (ignored if 'ref' or 'loadout' is defined) Loadout flags for elements to apply Paint mod specification Paint mod ware (from paintmods.xml, defines a quality level and visual properties of a paint mod) Default ware basket to select wares to be added from. This basket definition is required when neither basket nor list are defined in a wares element. When used in the JobDB or referenced from it, this basket is optional and overrides the job's basket. Ammo the ship is spawned with Fill percentage Fill amount Cargo the ship is spawned with Maximum cargo space fill percent of the ware(s) added from this ware node. If specified together with fillvalue, the lower amount is used. Maximum credit value of the ware(s) added from this ware node. If specified together with fillpercent, the lower amount is used. Chance that the node will be processed. Ware basket to select wares to be added from. Takes priority over wares defined in list attribute, and over any default basket. If no default basket is provided via the <basket> element or via the job definition, either basket or list attribute must be supplied. List of wares to be chosen from ( script-list syntax using [] !) If this is set to true, ALL wares in the basket/list will be added, evenly distributred according to fillpercent/fillvalue, otherwise a single ware will be randomly selected. By default cargo nodes are skipped for ships that are RE-spawned by the Job Engine. If this is set to true, this node will be processed every time this ship is spawned for a job. Wares nodes are always processed for non-job related ship creation. Inventory the ship is spawned with Fill amount Fill value Chance that the node will be processed. Ware basket to select wares to be added from. Takes priority over wares defined in list attribute, and over any default basket. If no default basket is provided via the <basket> element or via the job definition, either basket or list attribute must be supplied. List of wares to be chosen from ( script-list syntax using [] !) If this is set to true, ALL wares in the basket/list will be added, evenly distributred according to fillpercent/fillvalue, otherwise a single ware will be randomly selected. Drop object DropDB reference Drone Units. Currently interferes with loadouts. People on board the ship (as npc templates) PeopleDB reference. Child element <fillpercent> can override the fill percentage of the referenced definition. Child elements <person> are ignored in favour of the referenced definition. When passing in a variable expression, an empty string is allowed (however, <person> child elements are also ignored in that case). Criteria for selecting a suitable character from the CharacterDB. If combined with a static CharacterDB reference in the ref attribute, the nodes of the referenced type take precedence. <select> cannot be combined with a variable CharacterDB reference. NPC name (random name will be chosen if not supplied) Name string (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) Owner faction selection (if the NPC is used as pilot it will override the ship's owner) Voice page ID. Instead of directly supplying a page ID, the tags attribute can be used to specify requirements for the random page selection. Either a single tag or a list of tags which are required for the voice page. Character skills Skill (value between 0 and 15, representing steps of 1/3 of a star, up to 5 stars) Skill type Stock definition. The ID of the stock entry that the character should use. Clothing mod specification Clothing mod ware (from clothingmods.xml, defines a quality level and visual properties of a clothing mod) Production compatibilities Production compatibilities Criteria for selecting a suitable station from the StationDB. If combined with a static StationDB reference in the ref attribute, the nodes of the referenced type take precedence. <select> cannot be combined with a variable StationDB reference. Station name (default name will be used if not supplied) Name string (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) Owner faction selection The values used to generate the loadout for the station modules. The percentage level to which this station should be fitted out with randomly generated equipment. Given as a float between 0 and 1. The faction to use for selecting equipment. Has no effect without valid level also specified. (defaults to owner faction) The variation in level (ignored if level not supplied). Given as a float between 0 and 1 (uses default from parameters if not supplied). Use the loadout of the selected construction plan instead of generating a new one? (defaults to false) Station name (default name will be used if not supplied) Name string (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) Owner faction selection Fill percentage Person Weight of this role selection Loadout elements cannot contain script expressions Macro elements Engines Weapons Shields (ungrouped) Turrets (ungrouped) Group elements Shield groups Turret groups Ammunition elements Ammunition Units (drones) Software elements Software Value elements (currently unused) Virtual macro elements Thrusters Crew elements (only used when applying player-created loadouts or when people data is not supplied) Crew Allow a chance for experienced crew with wider skill range (default is false) Construction sequence elements cannot contain script expressions Sequence entry Entry in sequence to which this entry is connected Predecessor entry index Connection on predecessor module to which this module is connected Offset for this entry Position of entry Rotation of entry Upgrades (loadout) for this entry Loadout definition Entry index Macro name for this module Connection on this module by which the module is connected to its predecessor Entry is fixed and cannot be changed once the station is built Add a TextDB line to the texts to be spoken. Cannot be combined with attributes 'page' and 'line' in parent element. Adds the name of a value to the texts to be spoken. Requires that a name has been defined in the correct format. Cannot be combined with attributes 'page' and 'line' in parent element. A component, object, macro, faction, race, or ware Adds the description of a value to the texts to be spoken. Requires that a description has been defined in the correct format. Cannot be combined with attributes 'page' and 'line' in parent element. A component, object, macro, faction, race, or ware Event for when repair of a component has been requested (object = the object containing the damaged component - e.g. a ship or station, param = the damaged component, param2 = whether to make the damaged component a priority for repair) Event for when a UI control is triggered (param = screen ID, param2 = control ID, param3 = screen parameters) Screen ID Control ID Event for when a unit has been destroyed (object = the object owning the unit, param = the unit's category, param2 = the unit's mk) The destroyed unit's category Event for when a unit has started building/welding (object = the object on which the unit operates, param = the unit's mk) Event for when a unit has stopped building/welding (object = the object on which the unit operates, param = the unit's mk) Event for when a unit has started repairing/welding (object = the object on which the unit operates, param = the unit's mk) Event for when a unit has stopped repairing/welding (object = the object on which the unit operates, param = the unit's mk) Event for when a boarding operation has been created (param = boarding operation id) Event for when a boarding operation has been started (param = boarding operation id) Operation ID Event for when a boarding operation has been removed (param = boarding operation id) Operation ID Event for when a boarding operation has had its phase changed (param = boarding operation id, param2 = new boardingphase, param3 = old boardingphase) Operation ID Event for when a boarding support mission was NOT successful (object = boarding commander) Event for when a boarding support mission was successful (object = boarding commander) Event for when an object aborts charging boost (object = boosting object) Event for when an object starts charging boost (object = boosting object) Event for when an object starts boosting (object = boosting object) Event for when an object stops boosting (object = boosting object) Event for when a build related to the object begins (object = buildprocessor/buildmodule/buildingobject/buildingobjectcommander/buildobject, param = buildprocessor, param2 = constructionsequence, param3 = buildtask) Event for when a build related to the object finishes (object = buildprocessor/buildmodule/buildingobject/buildingobjectcommander/buildobject, param = buildprocessor, param2 = unused, param3 = buildtask) Event for when a build related to the object partially finishes construction. List of completed components is provided. (object = buildprocessor/buildmodule/buildingobject/buildingobjectcommander/buildobject, param = buildprocessor, param2 = list, param3 = buildtask) Event for when a build related to the object is cancelled (object = buildingobject, param = buildtask) Event for when a build task is added (object = building object, param = build task) Event for when a ship is constructed to operational state (object = buildingobject, param = ship, param2 = buildtask) Event for when a station is constructed to operational state (object = buildingobject, param = station, param2 = buildtask) Event for when a build storage has been moved (object = build storage or the base station) Event for when a build related to the object has applied a loadout to the build component. List of added components is provided. (object = buildprocessor/buildmodule/buildingobject/buildingobjectcommander/buildobject, param = buildprocessor, param2 = new components, param3 = buildtask) Event for when an object has been dismantled by a dismantling processor. (object = dismantled object, param = dismantling object) Event for when a dismantle process has been finished by an object. (object = object performing the dismantling, param = dismantled object) Event for when a dismantle process failed. (object = object performing the dismantling, param = dismantling processor) Event for when a component has been dismantled by a dismantling processor. (object = dismantled object, param = dismantled component, param2 = dismantling object) Event for when an object has dismantled a component. (object = object performing the dismantling, param = dismantled component) Event for when an object has been claimed successfully for salvage (either for dismantling or towing). (object = the claimed object, param = the successful claiming object) Event for when an object has lost its salvage claim on an object (either for dismantling or towing). (object = object performing the salvaging, param = the claimed object, param2 = the successful claiming object if any) Event for when a control entity is set on a controllable (object = controllable or entity, param = entity) Event for when a control entity is removed from a controllable (object = controllable or entity, param = entity, param2 = kill method) Event for when a conversation is finished (object = actor (entity or list containing context and template), param = outcome, param2 = outcome parameter) Conversation outcome (the name of the last section chosen by the player, or the conversation name in case of a non-interactive conversation) The outcome parameter (the last choice parameter as provided by <add_player_choice>, <add_player_choice_sub>, or a menu selection), or the conversation parameter in case of a non-interactive conversation (as provided by <start_conversation>) Event for when the next section in a conversation is triggered (object = actor (entity or list containing context and template), param = section name, param2 = choice parameter) Prefix of conversation section name that has to be matched The parameter associated with the player choice, as provided by <add_player_choice>, <add_player_choice_sub>, or a menu selection Event for when a sub-conversation returns to the previous section (object = actor (entity or list containing context and template), param = section name, param2 = base parameter, param3 = return parameter) Prefix of conversation section name that has to be matched The value provided by this previous section when it started the sub-conversation (baseparam of <add_player_choice_sub>, <add_player_choice_subconv>, or of the menu selection). The value provided by the player choice that returned to this previous section (returnparam of <add_player_choice_return> or of the menu selection). Event for when a conversation is started (object = actor (entity or list containing context and template), param = conversation name, param2 = conversation parameter) Prefix of conversation name that has to be matched The parameter associated with the conversation, as provided by <start_conversation> Event for when the player shuold be warned, e.g. on station explosion (param = component, param2 = text line) Component that is the reason for the warning Text line Event for when the camera of a cutscene is created (param = cutscene key string, param2 = cutscene ID) Event for when a cutscene sends a signal (param = cutscene key string) Signal ID name Event for when a cutscene starts (param = cutscene key string, param2 = cutscene ID, param3 = true if letterboxed, false otherwise) Event for when a cutscene has been started and loading of required assets for playing the cutscene, e.g. an NPC body, is completed (param = cutscene key string, param2 = cutscene ID) Event for when a cutscene ends (param = cutscene key string, param2 = cutscene ID, param3 = true if the cutscene was aborted, e.g. via the "timeout" attribute, or the stop_cutscene action, or by the player pressing Esc in a full screen cutscene) Event for when an object is pinged by a long range scan. (object = scanned object, param = true iff the result was 'identified') Was the result 'identified'? Event for when an object sends out a long range scan wave. (object = scanning object or player, param = scan progress between 0 and 1) Event for when a character starts an animation. (object = player/npc, param = animation ID) Animation ID Event for when a character finishes an animation. (object = player/npc, param = animation ID, param2 = remaining time for blending to the next animation) Animation ID Event for when a npc finishes their walk. (object = npc) Event for when npc slots are validated in an interior which could have blocked slots (object = interior or object of interior, param = interior, param2 = was this a recalculation of an already validated interior?) Was this validation a recalculation of a previously validated interior? Event for when a target lock is acquired (requires attribute attacker and/or target) (object = attacker if supplied, otherwise target object, param = the other object, param2 = locking weapon, param3 = target component) Event for when a target lock attempt is initiated (requires attribute attacker and/or target) (object = attacker if supplied, otherwise target object, param = the other object, param2 = locking weapon, param3 = target component) Event for when a target lock is lost (requires attribute attacker and/or target) (object = attacker if supplied, otherwise target object, param = the other object, param2 = locking weapon, param3 = target component) Event for when a mass traffic ship is removed from a zone. If zone is provided then it is the event object (object = zone, param = mass traffic ship), otherwise object or group must be provided (object = mass traffic ship) Event for when an object has been caught doing an illegal activity (see <report_illegal_activity>), like hacking or certain types of scanning (param = caught object, param2 = victim of the activity [optional]) The object doing the illegal activity (attribute must be present if victim not supplied) The victim of the activity (attribute must be present if object not supplied) Event for when a target waypoint is approached (but not necessarily yet reached) by a flying object (object = approaching object, param = remaining time) Event for when a flying object arrives at a target waypoint (object = arriving object) Event fired when the gravidar of an object has performed a scan (object = object of gravidar) Event for the specified object being attacked (object = attacked object, param = attacker, param2 = kill method, param3 = attacked component) Event for when the specified object attacks an object (object = attacker, param = attacked object, param2 = kill method, param3 = [attacked component, weapon]) Event for the specified object's shield being damaged (object = event source, param = damaged component, param2 = new shield value, param3 = damage) Event for the specified object's hull being damaged - includes hulls of children (object = event source, param = damaged component, param2 = new hull value, param3 = damage) Event for the specified object's hull being repaired - includes hulls of children (object = event source, param = repaired component, param2 = new hull value, param3 = repaired value) Event for the specified components's hull climbing above the function threshold, rendering the object functional again - includes hulls of children (object = parent object, param = affected component) Event for the specified components's hull falling below the function threshold, rendering the object non-functional - includes hulls of children (object = parent object, param = affected component) Event for the specified object being abandoned by its NPCs (object = abandoned object) Event for the specified object changing attention level (object = attention changing object, param = new attention level, param2 = previous attention level) New attention level Previous attention level Event for the specified object changing cluster (object = cluster changing object, param = new cluster, param2 = previous cluster) Event for the specified object changing its contested state. (object = cluster changing object, param = is the component now contested) Event for the specified object changing object (object = object changing object, param = new object, param2 = previous object) Event for the specified object changing owner (object = owner changing object, param = new owner faction, param2 = previous owner faction) Event for the specified object changing sector (object = sector changing object, param = new sector, param2 = previous sector) Event for the specified object changing true owner (object = owner changing object, param = new true owner faction, param2 = previous true owner faction) Event for the specified object changing room (object = room changing object, param = new room, param2 = previous room) Event for the specified object changing zone (object = zone changing object, param = new zone, param2 = previous zone) Event for the specified object changing state (object = state changing object, param = new state, param2 = previous state, param3 = perform transition?) Event for the specified object changing drone modes for its defence drones (object = object that launches drones, param = new drone mode) Event for the specified object changing drone modes for its mining drones (object = object that launches drones, param = new drone mode) Event for the specified object changing drone modes for its transport drones (object = object where drones are based, param = new drone mode) Event for the specified object authorizing defence drone use (object = object that launches drones) Event for the specified object unauthorizing defence drone use (object = object that launches drones) Event for the specified object authorizing mining drone use (object = object that launches drones) Event for the specified object unauthorizing mining drone use (object = object that launches drones) Event for the specified object changing relation range (object = the object changing relation, param = faction with which relation has changed) Event for the specified object authorizing transport drone use (object = object that launches drones) Event for the specified object unauthorizing transport drone use (object = object that launches drones) Event for any object within the specified space changing owner (object = space or container which contains the object, param = object changing ownership, param2 = new owner faction, param3 = previous owner faction) Space which contains the object (i.e. zone, sector or cluster), or direct container context (ship or station) Event for any object within the specified space changing true owner (object = space or container which contains the object, param = object changing ownership, param2 = new true owner faction, param3 = previous true owner faction) Space which contains the object (i.e. zone, sector or cluster), or direct container context (ship or station) Event for any entity within the specified space changing owner (object = space or container which contains the entity, param = entity changing ownership, param2 = new owner faction, param3 = previous owner faction) Space which is contains the entity (i.e. zone, sector or cluster), or direct container context (ship or station) Event for any entity within the specified space changing true owner (object = space or container which contains the entity, param = entity changing ownership, param2 = new true owner faction, param3 = previous true owner faction) Space which is contains the entity (i.e. zone, sector or cluster), or direct container context (ship or station) Event for any sector within the specified space changing owner (object = space which contains the sector, param = sector changing ownership, param2 = new owner faction, param3 = previous owner faction) Space which is contains the sector (i.e. cluster or galaxy) Event for any sector within the specified space changing true owner (object = space which contains the sector, param = sector changing ownership, param2 = new true owner faction, param3 = previous true owner faction) Space which is contains the sector (i.e. cluster or galaxy) Event for any object within the specified space changing relation range (object = space or container which contains the object, param = object changing relation, param2 = faction with which relation has changed) Space which contains the object (i.e. zone, sector or cluster) Event for when an object is claimed or a NPC claims an object (requires attribute claimed and/or pilot) (do not use with player.entity) (object = claimed if supplied, otherwise pilot, param = the other object) Event for the specified object collecting ammo (object = collecting object, param = weapon macro, param2 = amount) Ammo amount Event for the specified object collecting a powerup (object = collecting object) Event for the specified object collecting a resource (object = collecting object, param = ware, param2 = amount) Ware amount Event for when a region related asteroid has been mined in the specified sector, usually on destruction (object = sector containing the region, param = mined asteroid, param2 = mining object) Sector (required if group attribute not supplied) The mined asteroid Event for a resource in sector being depleted by a certain amount (object = sector, param = resource ware, param2 = depletion amount, param3 = [sector position, killed object, was depleted by player owned]) Sector (required if group attribute not supplied) Ware amount Event for the specified object collecting a ware drop (object = collecting object, param = ware, param2 = amount, param3 = collected object) Ware amount The collected object Event for when the specified object collides (object = colliding object, param = other colliding object, param2 = impulse of the colliding object in N*s, param3 = speed of the colliding object in m/s) The other object involved in the collision Event for when the construction sequence for a station has been created, e.g. requested via <create_construction_sequence> (object = station, param = constructionsequence if successful, param2 = true if successful) Event for when an object is triggered (object = trigger object, param = triggerer) The triggering object Event for when a subordinate receives a new commander (object = subordinate, param = new commander, param2 = previous commander, param3 = new assignment) Previous commander (can be null) Event for when a subordinate changes assignments without changing commander (object = source player/entity/subordinate/commander, param = subordinate, param2 = previous assignment, param3 = new assignment) Previous assignment Event for when a subordinate changes subordinate groups (object = subordinate/commander, param = subordinate, param2 = previous group, param3 = new group) Previous subordinate group New subordinate group Event for when a Controllable object activates a weapon (object = Controllable, param = Weapon, param2 = ammo type (null if unlimited), param3 = ammo amount (not set if unlimited)) Ammo type macro Ammo amount Event for when a Controllable object activates a weapon (object = Controllable, param = Weapon) Event for when a Controllable object activates a weapon group (object = Controllable, param = weapongroup index, param2 = true for primary, false for secondary group) Event for when a Controllable object deactivates a weapon group (object = Controllable, param = weapongroup index, param2 = true for primary, false for secondary group) Event for the specified object being destroyed (object = destroyed object, param = killer, param2 = kill method, param3 = was parent killed) Event for the specified object docking (object = docking object, param = dock object, param2 = zone, param3 = docking bay) Event for the specified object starting to dock (object = docking object, param = dock, param2 = zone, param3 = docking bay) Event for an object docking at the specified container (object = container object, param = docking object, param2 = new context, param3 = old context) Container object (station or ship, required if group attribute not supplied) Event for an object starting to dock at the specified container (object = container object, param = docking object, param2 = new context, param3 = old context) Container object (station or ship, required if group attribute not supplied) If object is a ship: Event for the specified object getting a free docking bay assigned for docking (object = docking ship, param = docking bay) If object is a docking bay: Event for the specified object getting a ship assigned to it (object = assigned docking bay, param = ship) If object is the player entity: Event for the player's ship context getting a free docking bay assigned (object = player, param = docking bay) Event for a ship being assigned to a dock of the specified container (object = container object, param = dock, param2 = assigned ship) If object is a ship: Event for the specified object getting the dock unassigned for a docking bay (object = ship getting dock unassigned, param = docking bay) If object is a docking bay: Event for the specified object getting a ship unassigned from it (object = unassigned docking bay, param = ship) If object is the player entity: Event for the player's ship context getting the dock unassigned (object = player, param = docking bay) Event for an unassigned dock of an object from the specified container (object = container object, param = dock unassigned object) Container object (station or ship, required if group attribute not supplied) Event for the specified object being denied docking (object = docking object, param = object that docking was requested at) Event for the specified object being incapable of docking (object = docking object, param = object that docking was requested at) Event for the specified object being too far from the docking target (object = docking object, param = object that docking was requested at) Event for the specified object being put into the queue for a free docking bay (object = docking object) Event for the specified object having aborted a docking process (object = docking object, param = previously assigned docking bay) Event for the specified object being cleared to undock (object = docked object) Event for the specified object having been moved into internal storage (object = stored object, param = old docking bay, param2 = internal docking bay) Event for the specified object having been retrieved from internal storage (object = retrieved object, param = new docking bay, param2 = internal docking bay) Event for the specified object having been removed from a formation (object = removed object) Event for when a formation action for the specified object has been successfully performed (object = formation wingman and/or leader, depending on the formation action) Event for when a formation action for the specified object has failed to perform (object = formation wingman and/or leader, depending on the formation action) Event for the specified object dropping objects (object = dropping object, param = list of dropped objects) Event for the specified object finding drops on its Gravidar scanner (object = scanning object, param = list of drops found) Event for the specified object finding an enemy on its Gravidar scanner (object = scanning object, param = enemy) Event for the specified object entering an anomaly (object = entering object, param = entry anomaly, param2 = exit anomaly) Event for a venture mission being completed (param = venture detail list: [mission name, mission type, raw mission name, was mission successful], param2 = list of ships involved, param3 = duration) Event for a venture mission being aborted (param = the ship of the aborted venture) Event for when a venture ship is added to the universe or an existing ship becomes one (param = ship) Event for when a venture ship is removed from the universe or an existing ship is no longer one (param = ship) Event for the specified object entering a gate (object = entering object, param = entry gate, param2 = exit gate) Event for when the object becomes visible on the gravidar of any player-owned object (object = entering object) Event for when the object is no longer visible on the gravidar of any player-owned object (object = leaving object) Event for when a player alert is triggered (object = location (sector), param = alert message, param2 = sound id, param3 = object list) Location (sector) in which the alert was raised Event for when the alert level of an object changes (object = object changing the alert level, param = new alert level string, param2 = old alert level string) Alert level string Previous alert level string Event for when the traffic level of an object changes (object = object changing the traffic level, param = new traffic level string, param2 = old traffic level string) Traffic level string Previous traffic level string Event for when a missile is launched at the specified object (object = target object, param = target component, param2 = missile, param3 = missile source) Event for when the specified object kills an object/component (object = killer, param = killed object/component, param2 = kill method) Event for when an object becomes known to the player (object = object that is becoming known to the player) Event for the specified object launching a missile (object = missile launching object, param = target component, param2 = missile) Event for when the objects' money gets updated (object = container of the account, param = oldamount, param2 = newamount) Event for when an AI order in an object's order queue gets enabled (entering the ready state), when the default order gets enabled, or when there is an order in the queue that should be started (either current or next order), even if it was already enabled before (object = the object receiving the order, param = order) Event for when the a running AI order is cancelled (object = the order's owner object, param = order, param2 = true iff the order is not in the critical state and is cancelled immediately). NOTE: If param2 is true then the order (event.param) was already cancelled and was either reset or does not exist any more. Is the order cancelled immediately? This is true except for orders in the critical state. Orders in the critical state can handle cancel requests by listening to this event with immediate="false". Event for when the running AI order is finished (object = the order's owner object, param = order). Note that it is possible that the order no longer exists. Event for when a parameter of a running AI order in the critical state is edited (object = the order's owner object, param = order, param2 = order param name, param3 = order param value) Order param name string New order param value Event for when the sync point of an infinite AI order in an object's order queue gets released, indicating that the order should finish (object = the order's owner object, param = order) Event for when the specified object is picked up by another object (object = pickup, param = collector) Event for when the specified object picks up another object (object = collector, param = pickup) Event for the specified object being signalled (object = signalled object, param = custom, usually to specify type of signal, param2 = custom, param3 = custom) Event for when a new subordinate is added to a commander (object = new commander, param = subordinate, param2 = new assignment) Event for when a new subordinate is promoted in place of the old commander (object = old commander, param = promoted subordinate) Previous commander Event for when a subordinate is removed from a commander (object = old commander, param = subordinate, param2 = old commander) Previous commander Event for when an object's target is invalid, e.g. went through a jump gate, does not exist any more etc. (object = object with an invalid target, param = invalid target, param2 = true iff the target is actually not reachable) Invalid target Is the target unreachable? Event for the specified object undocking (object = undocking object, param = dock, param2 = zone, param3 = docking bay) Event for the specified object starting to undock (object = undocking object, param = dock, param2 = zone, param3 = docking bay) Event for an object undocking from the specified container (object = container object, param = undocking object, param2 = new context, param3 = old context) Container object (station or ship, required if group attribute not supplied) Event for an object starting to undock from the specified container (object = container object, param = undocking object, param2 = new context, param3 = old context) Container object (station or ship, required if group attribute not supplied) Event for god creating a station (object = containing space, param = station) Space which contains the created station Event for god creating a base factory with the modules to be constructed (object = containing space, param = station, param2 = list of module macros, param3 = base construction sequence) Space which contains the created factory Event for god creating a ship (object = containing space, param = ship) Space which contains the created ship Event for god creating an object (object = containing space, param = object) Space which contains the created object Event for the specified object changing a weapon mode (object = object changing the weapon mode, param = weapon, param2 = new weapon mode) Weapon for which the mode will be changed (optional) New weapon mode in which the weapon will be changed (optional) Event on an object or a space, e.g. zone, for when any object enters it or is created in it (object = entered space/container, param = entering object, param2 = new context of entering object, param3 = old context of entering object). Space which is entered (i.e. zone, sector or cluster), or direct container context which is entered (ship or station) Event on an object or a space, e.g. zone, for when any object leaves it or is removed (object = left space/container, param = leaving object, param2 = new context of leaving object, param3 = old context of leaving object). Space which is left (i.e. zone, sector or cluster), or direct container context which is left (ship or station) Event on an object or a space, e.g. zone, for when any entity enters it or is created in it (object = entered space/room/container, param = entering entity, param2 = new context of entering entity, param3 = old context of entering entity). Space or room which is entered (i.e. room, zone, sector or cluster), or direct container context which is entered (ship or station) Event on an object or a space, e.g. zone, for when any entity leaves it or is removed (object = left space/room/container, param = leaving entity, param2 = new context of leaving entity, param3 = old context of leaving entity). Space or room which is left (i.e. room, zone, sector or cluster), or direct container context which is left (ship or station) Event for when an entity has finished moving via a transporter room (object = entity, param = previous room, param2 = true if triggered by this entity) Entity that was transported (required if group attribute not supplied) Previous room of the entity Was this entity the one to activate the transporter? Event is raised when a bomb has been successfully attached to a target - if you want to listen to it being detached, use event_object_killed with killmethod.detached (object = target that the bomb is attached to, param = bomb that was attached) Event is raised when a bomb has been successfully defused (object = the bomb that was defused, the bomb's zone or the object that did the defusing, param = bomb that was defused) Event for when the player attacks an object from their currently controlled object (param = attacked object, param2 = kill method, param3 = [attacked component, weapon]) Event for when the player aborts charging boost Event for when the player starts charging boost Event for when the player starts boosting Event for when the player stops boosting Event for when a build task for the player is added to a container (param = buildtask, param2 = building container) Building container Event for when a player-owned station's build plot is resized or repositioned (param = station, param2 = old build plot max, param3 = old build plot center) Station for which build plot changed Event for when a player-owned station's paid build plot is resized or repositioned (param = station, param2 = old paid build plot size) Station for which build plot changed Event for when a player-owned build starts (param = buildprocessor, param2 = constructionsequence, param3 = buildtask) Event for when a player-owned build finishes (param = buildprocessor, param2 = unused, param3 = buildtask) Event for when a player-owned build partially finishes. List of completed components is provided. (param = buildprocessor, param2 = list of completed components, param3 = buildtask) Event for when a player-owned build is cancelled (param = buildtask) Event for when a player-owned ship is constructed to operational state (param = ship, param2 = buildtask) Event for when a player-owned station is constructed to operational state (param = station, param2 = buildtask) Event for when a player-owned build has applied a loadout to the build component. List of added components is provided. (param = buildprocessor, param2 = new components, param3 = buildtask) Event for when a player-owned productionmodule has started production of a ware (param = productionmodule, param2 = product ware, param3 = whether this is a research project) (see also event_player_production_finished) Event for when a player-owned productionmodule has finished production of a ware (param = productionmodule, param2 = product ware, param3 = whether this was a research project) (see also event_player_production_started) Event for when a player-owned productionmodule has cancelled its production queue (param = productionmodule, param2 = whether a research project was cancelled, param3 = list of cancelled product wares) Event for when the player has unlocked an item of research (param = research ware) Event for when the player changes activity (param = new activity, param2 = old activity) Event for when the player changes target (param = new target. null if player deselects target.) Event for when a player responds to an interactive notification (param = interaction param, param2 = secondary interaction param, param3 = ID of cutscene or notification in which the interaction was defined - can be used for <stop_cutscene> or <stop_interactive_notification>, respectively) Interaction parameter Secondary interaction parameter Event for when the player successfully teleports. (param = new room, param2 = old room, param3 = is shortcut instead of real teleport) Is this a shortcut instead of a real teleport? Event for when the player failed to teleport. (param = destination room, param2 = is shortcut instead of real teleport) Is this a shortcut instead of a real teleport? Player is emergency ejecting from ship. Player was emergency ejected from ship. Event for when a player owned object is attacked (object = attacked object, param = attacker, param2 = kill method, param3 = attacked component) Event for when a player owned object, including the player, attacks another object (param = attacker, param2 = attacked object, param3 = kill method) Event for when the player faction claims an object (param = claimed object, param2 = pilot) Event for when a player owned object drops objects (object = dropping object, param2 = list of dropped objects) Event for when the player controlled ship or ship context is hit by a projectile (param = attacked object, param2 = attacker, param3 = projectile) Event for when the player collects ammo (param = weapon macro, param2 = amount) Ammo amount Event for when the player crafts ammo from inventory wares (param = weapon macro, param2 = amount) Ammo amount Event for when the player collects a powerup Event for when the player collects a ware drop (param = ware, param2 = amount, param3 = collected object) Ware amount The collected object Event for when the player unsuccessfully attempts to collect a ware drop on collision (param = ware, param2 = amount, param3 = crate object that cannot be collected) Ware amount The crate object that cannot be collected Event for when a commission for the player is added (object = source object or source faction, param = display name, param2 = commission amount, param3 = end time) Event for when a trader commission for the player is added (object = source object or source faction, param = display name, param2 = commission amount, param3 = end time) Event for when a discount for the player is added (object = source object or source faction, param = display name, param2 = discount amount, param3 = end time) Event for when a trader discount for the player is added (object = source object or source faction, param = display name, param2 = discount amount, param3 = end time) Event for when a hiring discount for the player is added (object = source object or source faction, param = display name, param2 = discount amount, param3 = end time) Event for when a modding discount for the player is added (object = source object or source faction, param = display name, param2 = discount amount, param3 = end time) Event for when a repair discount for the player is added (object = source object or source faction, param = display name, param2 = discount amount, param3 = end time) Event for when the player ship activates a weapon (param = Weapon, param2 = ammo type (null if unlimited), param3 = ammo amount (not set if unlimited)) Ammo type macro Ammo amount Event for when the player ship deactivates a weapon (param = Weapon) Event for when the player ship activates a weapon group (param = weapongroup index, param2 = true for primary, false for secondary group) Event for when the player ship deactivates a weapon group (param = weapongroup index, param2 = true for primary, false for secondary group) Event for when the player is created (no parameters) Event for when an object (station module, station, ship, ...) is discovered or scanned by the player and added to the scan memory (param = object, param2 = scan level) Scan level (0 if object was discovered, positive if object was actively scanned) Event for when an object is detected by the player and added to the long range scan memory (param = object) Event for when a mission offer is discovered by the player and added to the mission offer memory (param = mission offer cue) Mission offer MD cue Event for when an object is hacked by the player (param = hacked, param2 = hacker, param3 = control panel type) Event for when a missile is launched at the player (param = target component, param2 = missile, param3 = missile source) Event for when the player kills an object from their currently controlled object (param = killed object, param2 = kill method) Event for when the player launches a missile (param = target component, param2 = missile) Event for when the player is granted a licence for another faction (param = licenceref, use .type or .faction) Event for when the player has lost a licence for another faction (param = licenceref, use .type or .faction) Event for when the player money gets updated (param = oldamount, param2 = newamount) Event for when the player influence gets updated (param = oldamount, param2 = newamount) Event for when a player owned object has collected a resource (object = collecting object, param = ware, param2 = amount) Ware amount Event for when a player owned object was killed (param = killed object, param2 = killer object, param3 = kill method) Event for when a player owned object, including player, kills an object (param = killer object, param2 = killed object, param3 = kill method) Event for when a player-owned object's money gets updated (object = account holder, param = oldamount, param2 = newamount) Event for when the player opens a crate and claims all its content (param = crate) Event for when the player opens a lockbox (param = lockbox) Event for when the player's current weapon runs out of ammo (param = weapon macro, param2 = ranout of ammo due to the shot) When true, then we fired and ran out of ammo, otherwise we didn't have ammo in the first place. Event for when a faction or an object's control entity changes the relation towards the player (object = entity or null, param = faction or null, param2 = [new relation, old relation], param3 = relationchangereason). NOTE: On permanent faction changes, object is null. On relation boosts, object is non-null, and param is either null (silent boost) or faction.player (non-silent boost). See <set_relation_boost> and <add_relation_boost>. The reason for relationship change Event for when the player starts control (param = controlled object) Event for when the player stops control (param = controlled object) Event for when the player adds a new subordinate to squad (param = subordinate, param2 = new assignment) Event for when a subordinate of the player's current ship is promoted in place of the old commander (param = old commander, param2 = promoted subordinate) Previous commander Event for when the player removes a subordinate from squad (param = subordinate, param2 = old commander) Previous commander Event for when a trade is discovered by the player and added to the trade memory (param = tradeoffer) Event for when a player trade is cancelled (param = tradeoffer) Event for when the player completes a trade (param = tradeoffer) Event for when the player starts a trade (param = tradeoffer) Event for when volatile wares in the player's inventory self-destruct (param = table of lost volatile wares with corresponding amounts) Event is raised when the player ship travel mode begins charging (param = time when the mode is fully charged) Event is raised when the player ship travel mode aborts an ongoing charging process Event is raised when the player ship travel mode is done charging Event is raised when the player ship travel mode has stopped Event is raised when the player begins unlocking a signal leak (param = signal leak being unlocked) Event is raised when the player fails to unlock a signal leak (param = signal leak being unlocked) Event is raised when the player has successfully unlock a signal leak (param = signal leak being unlocked, param2 = object that the signal leak was attached to) Event is raised when the player is not currently able to unlock a signal leak (param = signal leak being unlocked) Event is raised when the player has repaired a signal leak (param = signal leak that was repaired, param2 = object that the signal leak was attached to) Event is raised when the player has repaired an object (param = destructible that was repaired (can be the object), param2 = object that the destructible was attached to) Event is raised when the player has successfully unlocked a platform trigger (e.g. a button, panel, door) that required wares to be consumed in order to activate (param = trigger component, param2 = trigger group tag) Event is raised when the player has manually activated a platform trigger (e.g. a button or panel) (param = trigger component, param2 = trigger group tag) Event is raised when the player has manually deactivated a platform trigger (e.g. a button or panel) (param = trigger component, param2 = trigger group tag) Event is raised when the player or a player-owned object has successfully attached a bomb (param = bomb that was attached) Event is raised when the player has successfully defused a bomb (param = bomb that was defused) Event is raised when the player has unlocked a blueprint (param = blueprint's module macro, param2 = blueprint's ware) Event is raised when the player has created signal leaks (param = list of signal leaks) Event for the player entering an anomaly (param = entry anomaly, param2 = exit anomaly) Event for the player entering a gate (param = entry gate, param2 = exit gate) Event for the player setting the camera to cockpit view (also triggered if the camera was already in this view) Event for the player setting the camera to external view (also triggered if the camera was already in this view) Event for the player setting the camera to external target view (also triggered if the camera was already in this view) Event for the player setting the camera to floating view (also triggered if the camera was already in this view) Event for the player toggling HUD rendering Event for the player toggling cockpit rendering Event for the player cycling the ammunition of active weapons Event for the player attempting to fire a weapon group that has no active weapons in it (param = true if it's a primary, false if it's a secondary weapon group) Event filter for whether the weapon group being fired was a primary (true) or secondary (false) one Event for when the player assigns an actor (entity or template) to a control post or a role (param = actor (entity or list containing context and template), param2 = target object, param3 = post or role). NOTE: The actual assignment happens as a result of this event. Event for when the player has engaged the autopilot (param = target, param2 = next target on the way to target which may be identical to target, param3 = estimated travel time or negative if no path) Event for when the player has disengaged the autopilot Event for when the game has completed loading a savegame (param = gameversion, param2 = build number, param3 = original gameversion of savegame). WARNING: When using in a non-root MD cue that is newly added when loading the savegame, the event will be missed on the first time. In order to handle a loaded game also in a newly added cue reliably, use <event_universe_generated> instead. Game version number of the loaded save, multiplied by 100. e.g. 251 for version 2.51 Build number of the loaded save, e.g. 187332 Game version number this save was started with, multiplied by 100. e.g. 125 for version 1.25 Event for when the game has completed saving a savegame (param = success) Event filter for whether saving was successful Event for when a new game has been started and the universe populated (param = list of selected gamestart options) Event for when a (deep)scan is aborted (requires attribute scanner and/or scanned) (object = scanner if supplied, otherwise scanned, param = the other object, param2 = true iff object is scanner) Event for when a (deep)scan is finished (requires attribute scanner and/or scanned) (object = scanner if supplied, otherwise scanned, param = the other object, param2 = true iff object is scanner) Event for when a (deep)scan is started (requires attribute scanner and/or scanned) (object = scanner if supplied, otherwise scanned, param = the other object, param2 = true iff object is scanner) Event for when an object is hacked (requires attribute hacker and/or hacked) (object = hacker if supplied, otherwise hacked, param = the other object, param2 = true iff object is hacker) Event for when an object starts an observation (requires attribute observer and/or observed) (object = observer or observed, param = observer, param2 = observed, param3 = range length) Event for when an observation is stopped (requires attribute observer and/or observed) (object = observer or observed, param = observer, param2 = observed) Event for when an object signals it will attack a target (requires attribute attacker and/or target) (object = attacker or target, param = attacker, param2 = target) Event for when an object signals it will stop an attack (requires attribute attacker and/or target) (object = attacker or target, param = attacker, param2 = target) Event for when an actor has finished speaking (object = actor, param = page, param2 = line, param3 = interrupted - 0 if fully finished, 1 if interrupted, 2 if not even started). NOTE: The page and line parameters match the text entry that was passed to the speak system before resolving any text references. The event is fired even if the speak fails due to priority being too low or if it is interrupted. In case of a sequence of multiple text entries, page and line match the first provided page/line pair, not the last one. Event for when a speak timer was triggered in a <speak> or <add_npc_line> via the timer attribute (object = actor, param = page, param2 = line, param3 = interrupted - 0 if speak is continuing after the event, 1 if interrupted, 2 if not even started). NOTE: The page and line parameters match the text entry that was passed to the speak system before resolving any text references. The event is fired even if the speak fails due to priority being too low or if it is interrupted before the trigger time. In case of a sequence of multiple text entries, only one text entry may specify a timer event. The page and line parameters of the event match the first provided page/line pair, not necessarily the one which defines the timer. Event for when an actor has finished speaking a single text line, possibly a part of a speech with multiple lines (object = actor, param = page, param2 = line). NOTE: Unlike <event_speak_finished>, this event requires the actor to be specified, and the parameters page and line match the exact spoken text entry after the resolution of text references. WARNING: The event is not fired if the speech cannot start or if it gets interrupted before the end of the line. Combine with <event_speak_finished> in a <check_any> block to handle those cases as well. Event for when a trade is cancelled, (object = either buyer, seller or space - see following documentation, param = tradeoffer) (If tradeoffer is provided, listened object = tradeoffer owner) : (otherwise buyer and/or seller are preferred where listened object = seller if supplied, otherwise buyer) : (otherwise space must be provided where listened object = space) Space which contains the cancelled trade (can not be used with buyer/seller) Event for when a trade is completed (object = either buyer, seller or space - see following documentation, param = tradeoffer, param2 = tradeorder) (If tradeoffer is provided, listened object = tradeoffer owner) : (otherwise buyer and/or seller are preferred where listened object = seller if supplied, otherwise buyer) : (otherwise space must be provided where listened object = space) Space which contains the completed trade (can not be used with buyer/seller) Event for when a trade is started (object = either buyer or seller - see following documentation, param = tradeoffer, param2 = tradeorder) (If tradeoffer is provided, listened object = tradeoffer owner) : (otherwise buyer and/or seller must be provided, listened object = seller if supplied, otherwise buyer) Event for when an object has been detached from all mass traffic networks that restrict its movement (object = detached object) Event for when a mass traffic network has been removed (object = the zone that owned the network, param = the removed network's ID) Event for the specified weapon firing (object = the weapon, param = fired bullet/missile/bomb) Event for the specified weapon overheating (object = the weapon) Event for an object launching a countermeasure (object = the launching defensible, param = launched countermeasure) Event for countermeasure being launched (object = the space which the countermeasure was launched in, param = the launching defensible, param2 = launched countermeasure) Space which the countermeasure was launched in The object which launched the countermeasure Event for an object launching a mine (object = the launching defensible, param = launched mine) Event for an object launching a lasertower (object = the launching defensible, param = launched lasertower) Event for lasertower being launched (object = the space which the laser tower was launched in, param = the launching defensible, param2 = launched lasertower) Space which the lasertower was launched in The object which launched the lasertower Event for mine being launched (object = the space which the mine was launched in, param = the launching defensible, param2 = launched mine) Space which the mine was launched in The object which launched the mine Event for an object launching a navigation beacon (object = the launching defensible, param = launched navigation beacon) Event for navbeacon being launched (object = the space which the navbeacon was launched in, param = the launching defensible, param2 = launched navbeacon) Space which the navbeacon was launched in The object which launched the navbeacon Event for an object launching a satellite (object = the launching defensible, param = launched satellite) Event for satellite being launched (object = the space which the satellite was launched in, param = the launching defensible, param2 = launched satellite) Space which the satellite was launched in The object which launched the satellite Event for an object launching a resourceprobe (object = the launching defensible, param = launched resourceprobe) Event for resourceprobe being launched (object = the space which the resource probe was launched in, param = the launching defensible, param2 = launched resourceprobe) Space which the resourceprobe was launched in The object which launched the resourceprobe Event for an object launching a distress drone (object = the launching defensible, param = launched distress drone) Event for a distress drone being launched (object = the space which the distress drone was launched in, param = the launching distress drone, param2 = launched distress drone) Space which the distress drone was launched in The object which launched the distress drone Event for when inventory wares were added to entity (object = entity, param = table of wares with corresponding amounts) Event for when inventory wares were removed from entity (object = entity, param = table of wares with corresponding amounts) Event for when supply wares were added to container object (object = container, param = table of wares with corresponding amounts) Event for when supply wares were removed from container object (object = container, param = table of wares with corresponding amounts) Event for when supply orders(as wares) were added to container object (object = container, param = table of wares with corresponding amounts) Event for when supply orders(as wares) were removed from container object (object = container, param = table of wares with corresponding amounts) Event for when an object has started production of a ware (object = container or productionmodule, param = productionmodule, param2 = product ware, param3 = whether this is a research project) (see also event_object_production_finished) Event for when an object has finished production of a ware (object = container or productionmodule, param = productionmodule, param2 = product ware, param3 = whether this was a research project) (see also event_object_production_started) Event for when an object has cancelled its production queue (object = container or productionmodule, param = productionmodule, param2 = whether a research project was cancelled, param3 = list of cancelled product wares) Event for when an object has had props generated (object = the populated component or its container, param = component which was populated) Event for when an object has props about to be despawned (object = the populated component or its container, param = component which was populated) Event for when an object has interiors about to be despawned (object = the populated controllable) Event for when a player-owned object has discovered a previously undiscovered area (param = sector, param2 = center position of discovered hex in sector) Event for when the universe generation process has been completed (all stations have been built) at game start or when loading a savegame. Event for when a job ship has been activated in the galaxy, either spawned directly in space or when being finished at a shipyard (param = jobship) Event for when a faction changes the relation towards another faction (param = faction, param2 = other faction, param3 = [new relation, old relation, relationchangereason]}. Event for faction changing relation range with another faction (param = faction, param2 = other faction) Event for when a faction is activated (param = faction) Event for when a faction is deactivated (param = faction) Event for when a faction's police faction has been changed (param = faction, param2 = new police faction, param3 = old police faction) Event for when a faction headquarters has been changed (param = faction, param2 = new faction headquarters station, param3 = old faction headquarters station) Event for when a faction representative has been changed (param = faction, param2 = new faction representative, param3 = old faction representative) Event for when an object has opened a lockbox (object = object opening the lockbox, param = lockbox which was opened) Event for when a lockbox has been opened (object = opened lockbox, param = the object opening the lockbox) Event for when a repeatable terraforming project has become available again (object = cluster in which terraforming is taking place, param = project ID) ID of the project that has become available Event for when a terraforming project has started production - not triggered if the project has no deliveries (object = cluster in which terraforming is taking place, param = project ID) ID of the project that started production Event for when a terraforming project has started after finishing production - also triggered if the project has no duration and succeeds or fails immediately (object = cluster in which terraforming is taking place, param = project ID) ID of the project that has started Event for when a terraforming project has been completed (object = cluster in which terraforming is taking place, param = project ID) ID of the project that has completed Event for when a terraforming project has been completed successfully (object = cluster in which terraforming is taking place, param = project ID, param2 = [were there positive side-effects?, were there negative side-effects?], param3 = payout in Credits) ID of the project that has succeeded Event for when a terraforming project has been completed unsuccessfully (object = cluster in which terraforming is taking place, param = project ID, param2 = [were there positive side-effects?, were there negative side-effects?]) ID of the project that has failed Event for when a terraforming event has started (object = cluster in which terraforming is taking place, param = project ID) ID of the project that has started Event for when a terraforming event has been completed (object = cluster in which terraforming is taking place, param = project ID) ID of the project that has completed Event for when a terraforming stat has been added to the list of relevant stats (object = cluster in which terraforming is taking place, param = stat ID) ID of the stat that was added Event for when a terraforming stat has been removed from the list of relevant stats (object = cluster in which terraforming is taking place, param = stat ID) ID of the stat that was removed Event for when a terraforming stat has changed (object = cluster in which terraforming is taking place, param = stat ID) ID of the stat that was changed Event for when a terraforming world's habitability has changed (object = cluster in which terraforming is taking place) ID of the stat that was changed Event for when a recyclable object is near a furnace that can process it (object = tug ship, param = processing module, param2 = recyclable object) Processing module Event for when an animation phase has started (object = object that the phase started on, param = phase string) Phase Event for when an animation phase has started (param = phase string, param2 = object that the phase started on) Phase string Event for when an object's gravidar factor has changed (object = gravidar object, param = new factor, param2 = old factor) New factor Old factor Event for when a weapon has changed its ammo (object = weapon, param = new ammo macro, can be null) Ammo type macro Event for when a weapon on an object has changed its ammo (object = object with weapon, param = weapon, param2 = new ammo macro, can be null) Ammo type macro Event for when a player-towed recyclable object is near a furnace that can process it (param = processing module, param2 = recyclable object) Processing module Event for when a processing module starts processing a recyclable as result of the player delivering the recyclable object (param = processing module) Processing module Event for when a processing module completes processing a recyclable as result of the player delivering the recyclable object (param = processing module) Processing module Event for when the player object's gravidar factor has changed (param = new factor, param2 = old factor) New factor Old factor Event for when a processing module is ready to accept new material (object = station the processing module belongs to, param = processing module) Processing module Event for when an object has taken area damage (object = damaged object, param = damage source) Damage source Value is in specified range (both value and range can use expressions) Value to match (checked for non-zero if no comparison range or list is specified) Game age value is in specified range (both value and range can use time expressions) Time value range Check an object against filters Check whether the weapon is currently active Check whether the weapon is installed/available Check if a production for a specified ware is allowed to be added to an object based on the definition in modules.xml Check against the max limits defined in the module definition, otherwise use the base limits. (defaults to true) Check if the specified job is currently active Check if a matching animated part is currently in the specified animation state Animation state name The group ID (which may be a string or a tag) of the animated part A tag (which may be a string or a tag) to help find the part connection Count matching clusters and check if count is in specified range Number of clusters Count matching gates Number of gates Count matching rooms in a container or walkable module Number of rooms Count matching dockingbays Number of dockingbays Count matching contacts found via a gravidar Scanning object Number of objects Count matching modules in a defensible object Number of modules Count matching components contained in an object Parent object for component search Number of components Count matching objects Number of objects Count matching sectors Number of sectors Count matching ships Number of ships Count matching stations Number of stations Count matching highways Number of highways Count matching zones - excludes highways Number of zones Output debug text (dummy condition that is always met, so it can be used like an action) Text Percentage chance of the debug text being displayed (used this instead of the condition chance, so that the condition does not fail) Include the source of this debug_text (defaults to true) Debug output filter (optional, default is scripts) check that the object matches the criteria check that an object in the group matches the criteria check that all objects in the group match the criteria (empty group returns true) Remove a variable (dummy condition that is always met, so it can be used like an action) Set a variable value (dummy condition that is always met, so it can be used like an action) Abort the current player scan Abort all running AI scripts on an entity. Set alert level Activate the ship's landing gears Deactivate the ship's landing gears Animate a chair to suit the using NPC The NPC slot related to the chair The NPC using or set to use the chair Activation state for the chair (defaults to 'invalid') Have the chair animate to its active position Have the chair animation to its inactive position Have the chair remain in its current activation state (optional) delay the animation by the specified amount of time Trigger an animation The component to trigger the animation on The tag list to find specific parts to trigger the animation on (if neither this nor a group is supplied, the animation is triggered on the entire component) The group ID (which may be a string or a tag) used to find specific parts to trigger the animation on (if neither this nor tags are supplied, the animation is triggered on the entire component; has no effect if tags are also specified) The animation trigger (optional) delay the animation by the specified amount of time Set to true if the new animation should start immediately instead of being queued. Check if a matching animated part is currently in the specified animation state Animation state name The group ID (which may be a string or a tag) of the animated part A tag (which may be a string or a tag) to help find the part connection Whether the actor was successfully added Activate weapon group Set to true if it's a primary, false if it's a secondary group Resets weapon groups of the specified object, setting lasers to the first primary weapon group and missile launchers to the first secondary weapon group. Adds a weapon to the specified weapon group. Set to true if it's a primary, false if it's a secondary group. Removes a weapon from the specified weapon group. Set to true if it's a primary, false if it's a secondary group. Removes a weapon from all weapon groups. Add NPC actor to a room. This action fails if the actor could not be connected to that room. Room (or object with valid 'position') in which to place the actor (Not to be combined with 'slot') The slot to place the actor (Takes precedence over 'room') Set the roomslot of the actor to the provided slot if it is a valid NPC slot (defaults to true) Trigger the default animations for this room slot on the actor (defaults to true) Allow the NPC to blend their current animation to the triggered one (defaults to false) Activation state for the chair if the slot is a chair slot (defaults to 'activate_chair'. Using 'invalid' will keep the chair in it current activation state) Have the chair animate to its active position Have the chair animation to its inactive position Have the chair remain in its current activation state Whether the actor was successfully added Set the ammo type and ammount of a collectable ammo crate Amount to be added (negative will result in an empty crate) Add ammo to a defensible object (see also <remove_ammo> and <deplete_ammo>) NOTE: when used with unit macros storage limits are ignored! Use <add_units> instead! Amount to be added (can be negative) Removes ammo from a defensible object (see also <add_ammo> and <deplete_ammo>) Amount to be removed (can be negative) Depletes ammo of a defensible object (see also <add_ammo> and <remove_ammo>). If macro is not supplied then ammo will be removed from all weapons. Evaluates the ammo storage of the given object. Returns lists containing amounts, wares and macros for the used ammo types. Indices of the lists are in sync. Also returns total ammo capacity from launchers (excludes base object ammo capacity) Result list of max amounts for the ware/macro types (see other result lists, indices match) Result list of macro names for the ammo types (see other result lists, indices match) Result list of wares for the ammo types (see other result lists, indices match) Resulting total ammo capacity for this type provided by launchers (excludes ammo capacity of base object) Evaluates the habitation storage needed to store workforce resources for the specified amount of workers and time. Returns cargo volume of required container storage. The race that the workforce resources are for. The time for which to calculate the resource needs. (defaults to the production time of the workunit ware, typically 1h) The number of workers the resource needs are calculated for. (defaults to the product amount of the workunit ware, typically 300) Whether the workunit_busy ware should be used to calculate necessary resources (workunit_idle applies when station production is dormant and uses considerably fewer resources) (defaults to true) Whether secondary workforce resources(not required to maintain workforce, but increase efficiency if present) should be considered. (defaults to true) Resulting volume of container storage required. Evaluates the default unit storage of the given object. Returns lists containing unit categories, mks, macros and amounts. Indices of the lists are in sync. The percentage level to which this object should be fitted out with randomly generated units. Given as a float between 0 and 1. (special value: -1 means stick to whatever was last set with <set_loadout_level /> Result list of amounts for the unit types (see other result lists, indices match) Result list of unit categories the unit types (see other result lists, indices match) Result list of macro names for the unit types (see other result lists, indices match) Result list of mks for the unit types to be used together with the respective category (see other result lists, indices match) Evaluates the default deployable storage of the given object. Returns lists containing deployable categories, mks, macros and amounts. Indices of the lists are in sync. The percentage level to which this object should be fitted out with randomly generated deployables. Given as a float between 0 and 1. (special value: -1 means stick to whatever was last set with <set_loadout_level /> Result list of amounts for the deployable types (see other result lists, indices match) Result list of deployable categories the deployable types (see other result lists, indices match) Result list of macro names for the deployable types (see other result lists, indices match) Result list of mks for the deployable types to be used together with the respective category (see other result lists, indices match) Evaluates the default missile storage of the given object. Returns lists containing missile macros and amounts. Indices of the lists are in sync. The percentage level to which this object should be fitted out with randomly generated units. Given as a float between 0 and 1. (special value: -1 means stick to whatever was last set with <set_loadout_level /> Result list of amounts for the missile types (see other result lists, indices match) Result list of macro names for the missile types (see other result lists, indices match) Add cargo to an object The resulting amount that was successfully added Remove cargo from an object The resulting amount that was successfully removed Add wares to a container Whether everything was added successfully Remove wares from a container Whether everything was removed successfully Add price commission for target faction to object/faction(=target gets bonus pay for sales), if object and faction are specified, object takes precedence! Name of commission, only required if target is faction.player How long this commission lasts. Will last forever if omitted! Add price commission for player faction to object/faction(=target gets bonus pay for sales), if object and faction are specified, object takes precedence! Identifier string for the discount Name of commission, only required if target is faction.player How long this commission lasts. Will last forever if omitted! Remove price commission for target faction from object/faction, if object and faction are specified, object takes precedence! Remove price commission for player faction from object/faction, if object and faction are specified, object takes precedence! Identifier string for the discount Add default wares to a ship or station based on its productions and buildmodules Minimum percentage of storage filled Maximum percentage of storage filled Chance per ware that an extreme (0 or max) value will be added (ignoring the lower/upper limits) (optional) Add skill value to either 'entity' or a npctemplate on 'object' Add supplies to an object. NOTE: if the supplies are not needed to fulfill any current supply orders an attempt will be made to transfer them to storage, respecting stock limits! Remove supplies from an object Add supply orders to an object Remove supply order from an object Add trade ware (use only on trading stations) Allow buying this tradeware (optional, defaults to true) Allow selling this tradeware (optional, defaults to false) Lock price to average price of ware, otherwise price is calculated based on storage amounts (optional, defaults to false) Remove trade ware (-> trading stations) Generate reports of wares which are either in short supply, insufficient or overflowing Reports related to build modules Reports related to habitation modules and workforce Reports related to production modules Enable debug logging of the reports (debug, optional, defaults to false) Include processed wares like raw scrap (only relevant for report type 'class.production', optional, defaults to false) Threshold factor of cargo level of an insufficient ware to be included in the result. Cargo level is calculated from the current amount in storage vs the target amount e.g. 0.7 means object must hold less than 70% of the target amount of this insufficient ware for it to appear in the result Time value that a ware has to be flagged as insufficient for to dismiss the 'insufficientthreshold' filled cargo factor. When time is exceeded the ware will be included in the report regardless of cargo level. If omitted the threshold will always be respected. Threshold factor of cargo level of an shortage ware to be included in the result. Cargo level is calculated from the current amount in storage vs the target amount e.g. 0.7 means object must hold less than 70% of the target amount of this shortage ware for it to appear in the result Time value that a ware has to be flagged as in shortage for to dismiss the 'shortagethreshold' filled cargo factor. When time is exceeded the ware will be included in the report regardless of cargo level. If omitted the threshold will always be respected. Ware or list of wares to filter the resulting tables by, removing any other ware. Resulting insufficient ware report table (ware is the key and the value is the amount of time this ware has been insufficient) Resulting shortage ware report table (ware is the key and the value is the amount of time this ware has been in short supply) Resulting overflow ware report table (ware is the key and the value is the amount of time this product has been at max capacity) Clear the object's reports of wares which are either in short supply, insufficient or overflowing Add research for the player Remove completed research from the player Add price discount for target faction to object/faction(=target gets stuff cheaper), if object and faction are specified, object takes precedence! Name of discount, only required if target is faction.player How long this discount lasts. Will last forever if omitted! Add price discount for player faction to object/faction(=target gets stuff cheaper), if object and faction are specified, object takes precedence! Identifier string for the discount Name of discount, only required if target is faction.player How long this discount lasts. Will last forever if 0 or omitted! Remove price discount for target faction from object/faction, if object and faction are specified, object takes precedence! Remove price discount for player faction from object/faction, if object and faction are specified, object takes precedence! Identifier string for the discount Add watchdogs units of a station to its zone's masstraffic Query the earliest time at which this unlock may be triggered again. Set the earliest time at which this unlock may be triggered again. Add a dummy conversation action (<add_npc_line> without NPC voice) to trigger the conversation manager. Legacy, used only to prevent a small delay if a conversation ends without voice (e.g. when cancelled). Add global faction relation Relation boost value The reason for relationship change Get factions by matching relation (object or faction attribute required) Object to reference (takes preference over 'faction') Faction to reference ('object' takes preference if provided) Get factions by matching tag (tag required) Set a faction's identity (any combination of name, shortname, description and icon) to new values New faction name (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) New faction short name (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) New faction prefix name (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) New faction space name (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) New faction home space name (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) New faction description (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) New faction icon (shown in the UI). Will also change the decals if no image is provided. For the player faction please use the image attribute. New faction logo image (decals on ships). For the player faction this will also change the icon (shown in the UI). New faction logo image is in personal folder? (default is false) Set a faction's mood to a certain level Reset a faction's mood to its default level Set a faction to active/inactive. Faction to set active/inactive Set a faction to known/unknown to the player. Does not add encyclopedia entry for faction - see documentation for add_encyclopedia_entry. Faction to set known/unknown Set a faction's police faction to the specified faction. Will fail if the police faction is not a police faction. Police faction (defaults to self for police factions or none for non-police factions if not supplied) Set a faction's headquarters to the specified station. Will fail if the station's owner is not the correct faction. Is the faction headquarters? Set a component to known/unknown to the player. Does not add encyclopedia entry for component (except for spaces) - see documentation for add_encyclopedia_entry. Component to set known/unknown Stations only. Update the snapshot of the station's current configuration for use in the map? (De)Activates the loot magnet of the playership Add inventory to an entity (entity defaults to player, amount defaults to 1) Remove inventory from an entity (entity defaults to player, amount defaults to 1) Add licence to a faction (defaults to player faction) Licence to add (takes precedence over 'licencefaction' and 'type' pair) The licence issuing faction. Ignored if 'licence' is provided Type of licence. Ignored if 'licence' is provided Remove licence from a faction (defaults to player faction) Licence to remove (takes precedence over 'licencefaction' and 'type' pair) The licence issuing faction. Ignored if 'licence' is provided Type of licence. Ignored if 'licence' is provided Add an NPC voice line to the conversation Speaker (optional, either an entity or a list [controllable_context, npc_template], defaults to the conversation actor if not supplied) Look in the direction of the specified component Recipient of the line, i.e. the character being spoken to (optional). Pass an NPC if this is a background speech between two NPCs. Default is the player (if omitted or null). Topic of the line, i.e. the character being spoken about (optional). Pass an NPC or the player if the person being spoken about may have a grammatical effect on the sentence. Hide the player's conversation choices until after the NPC line has been spoken? Default is false (don't hide). This has no effect if the choices were already visible before the start of this line. Check for errors resolving an object name or description? Default is true If multiple text IDs are provided (either in sub-nodes or as a script list), should they be treated as a single NPC line? Otherwise they are treated as individual lines, as if they were added in separate <add_npc_line> actions. When the player skips a conversation line with a hotkey, this flag determines whether all of the contained lines are skipped instead of just a single line. Default is false. Add a player choice text to the conversation. When chosen, <event_conversation_next_section> will be triggered but the conversation stack will not be changed. Name of next conversation section Optional parameter that is passed to <event_conversation_next_section>. Can be of any data type. Add a player choice text to the conversation. When chosen, <event_conversation_next_section> will be triggered, and a sub-conversation will be started which can return to this section (see <add_player_choice_return>). Name of next conversation section Optional parameter that is passed to <event_conversation_next_section>. Can be of any data type. Optional parameter that is evaluated immediately, but stored until the sub-conversation returns and <event_conversation_returned_to_section> is triggered. Can be of any data type. Add a player choice text to the conversation. When chosen, <event_conversation_started> will be triggered, and a sub-conversation with a different actor will be started which will return to this section when it ends (unless the player aborts the conversation as a whole). Name of next conversation section Optional parameter that is passed to <event_conversation_started>. Can be of any data type. Optional parameter that is evaluated immediately, but stored until the sub-conversation returns and <event_conversation_returned_to_section> is triggered. Can be of any data type. Add a player choice text to the conversation. When chosen, the current sub-conversation will return to the previous section that started it (see <add_player_choice_sub> and <add_player_choice_subconv>), and <event_conversation_returned_to_section> will be triggered. This action also defines the behaviour of the "Back" button. Optional parameter that is passed to <event_conversation_returned_to_section>. Can be of any data type. Set the section to which the conversation returns when the player selects an <add_player_choice_return> option without any sub-section active. The default return section is "g_finish". This action can be performed only once per conversation and only if no sub-section is already active. Name of conversation section to return to Optional value that is passed as param2 to <event_conversation_returned_to_section>. Add relation boost (otherobject or faction attribute required) Relation boost value The reason for relationship change Add an object or a list/group of objects to a group (the group is created if it does not exist yet) Object to add to the group (cannot be used with attributes list or group) List of objects to add to the group (cannot be used with attributes object or group) Group of objects to add to the group (cannot be used with attributes object or list) Produce an error message if an inserted object or list element is not an existing object? (default is true) Add tolerance boost (otherobject or faction attribute required) Tolerance boost value Aim turret at target Turret Add units to an object (either 'macro' is to be provided or both 'category' and 'mk') The faction that made the units - defaults to the owner of the object if not provided Add the unit as currently unavailable (default = false) Remove units from an object (either 'macro' is to be provided or both 'category' and 'mk') Remove the unit from currently unavailable units (default = false) Request units from an object and make them unavailable (either 'macro' is to be provided or both 'category' and 'mk') Return units from an object and make them available Changes the numerical seed value for fixed random number generation in a consistent way, based on the previous seed value. Can be used to generate a sequence of random numbers starting with a single numerical seed value. NOTE: This should only be used for numerical seeds, not when using an object as seed source. An object seed is advanced automatically when using it to generate a random number. The numerical seed value to be updated Allows or disallows escaping from the current conversation section (e.g. with Esc). Only the current section is affected, default is allow. Should Escape be possible in current conversation section? Append elements from list 'other' or component group 'group' at the end of a list Name of the list to which the elements of the other list (or group) will be appended (if the 'create' attribute is true and the list does not exist yet, then this value will receive the newly created list) Should the list be created if it does not exist yet? (Default is false) List whose elements will be appended (cannot be used together with 'group') Group whose members will be appended (cannot be used together with 'other') If true then the elements of the other list are appended in reverse order (defaults to false) Append an element at the end of a list Name of the list to which the element should be added (if the 'create' attribute is true and the list does not exist yet, then this value will receive the newly created list) Should the list be created if it does not exist yet? (Default is false) Should the element not be appended if it is already contained in the list? In that case, the existing list will remain unchanged. (Default is false) Value to be appended to the list Appends a construction plan to a station that already exists. The construction plan for the station can be empty. The station to which the construction sequence should be attached. This station must already be connected to the gamegraph, otherwise use create_station action. A construction sequence or construction plan ID Remove any existing module that is not part of the provided sequence (defaults to false) Evaluate needed storage modules based on production requirements Macro or list of macros of production modules used to evaluate needed storage Macro or list of macros of storage modules already present List of storage module macros which can be selected Result list of storage module macros Apply damage from an attack to target, returns if target was killed Result of attack including which component was hit. True if the object or module has been destroyed. The module that has been attacked (if one exists). Will match the passed-in module, provided it was a valid module of the object. NOTE: the returned module can already be destroyed! The surface element that has been attacked (if one exists). Will match the passed-in surface element, provided it was a valid surface element of the object. NOTE: the returned surface element can already be destroyed! Is the damage explosive? Uses different low attention parameters such as 'surfaceelementexplosivechance' and equally damages a selected surface element and object hull. Approximate total attack strength as a single value (individual values ignored if supplied). Attack strength to be applied to hull and shields (ignored if total supplied). Attack strength to be applied to hull only (ignored if total supplied). Attack strength to be applied to shields only (ignored if total supplied). Attack strength to be applied to hull only if no shields are present (ignored if total supplied). Attack a specific module of the object (optional, defaults to a random operational module, if there are any, or the object as a whole otherwise.) Attack a specific surface element of the object (optional, defaults to a random operational surface element of the module/object, if there are any.) Evaluates the value and prints an error message if it does not match. This requires the script debug filter to be enabled, both at game start and on the assert. (In developer builds a modal message box will pop up, and there is no filter requirement.) Message text to be displayed on assertion failure Determines on how many assertion failures the message box may pop up (default is 1). Note that resetting or refreshing the MD resets the counter. Assign NPC actor as the control entity for the specified control post of the specified object Move the actor to the object's control room instantly. (defaults to false) Start the suitable AI scripts on the actor. (defaults to true) Was the NPC sucessfully assigned? Move the NPC actor to its default location for its control post Start suitable AI scripts on a control entity which has not been initialised yet (Re-)Start suitable AI scripts on all control entities of object Remove NPC actor the control entity of its type of the specified object Set restriction against assigning NPCs to the controllable object Get all control entities of the specified object If true then the result is a list of control entities, otherwise the result is a random control entity or null (default is true) Remove the pilot control entity of the specified object Assign NPC actor (hired by player) as the control entity for the specified control post, or as a crew member with the specified role, on the specified player-owned object. If the assignment is possible, <event_player_assigned_hired_actor> is triggered and a success is indicated, otherwise a failure reason is provided. The actual assignment logic is implemented in an MD event handler. If the check value is set to true, the assignment via the event is skipped, so this action has no effect and only indicates success or failure. Player-owned controllable target object on which the actor is assigned to a control post or role (may be the actor's currently assigned object) Control post (either post or role must be specified) Actor (entity) role (either post or role must be specified) Only check for expected outcome (with attributes success and/or failed), without actually performing the assignment? Defaults to false. Optional name of the value that will be set to true if successful, false in case of failure Optional name of the value that will receive the failure reason string, or null if successful Sets scheduled time of arrival for an actor (hired by the player) at the current object via a crew transfer pod, indicating that the actor has not arrived at the current location yet. Actors that are being transferred via pod can already exist at their target location, but should be treated as hidden and unavailable. Arrival time (must be in the future) Clears the scheduled time of arrival for an actor (hired by the player). If an arrival time was previously set on the actor, this triggers the arrival at the current object. See <set_actor_pod_arrival_time>. Attach an object to the target using the 'limpet' connection (only supported on ships so far) Whether the currect offset of object relative to target should be kept, uses target center otherwise (defaults: true) Detach an object and connect it to its current zone Whether the object's rotation speed should be constant unless a force acts on it (default: false, meaning it slows down over time) Abort the innermost <do_while>, <do_for_each> or (counted) <do_all> loop. Break formation as a formation leader. No effect if the object is not a formation leader Cease fire All weapons/turrets in this mode should stop firing. (defaults to any) All weapons/turrets should stop firing except when in this mode (if omitted, there is no exception) If weaponmode specifies one particular mode it has precedence over excludedweaponmode unless weaponmode and excludedweaponmode are identical in which case this action does nothing. Should weapons/turrets stay deployed if they already are? (defaults to false) Change relation of the attacked object towards the attacker This value will be set to true if there was an effect on the relation (or at least the relation boost decay), otherwise it is set to false. The action can fail in several cases, e.g. if attacker and victim are of the same faction. Change relation of the boarded object towards the boarder Is this a boarding attempt or the end of a successful boarding operation? Allow the faction reputation between the boarded and boarder factions to change if possible (defaults to true) This value will be set to true if there was an effect on the relation (or at least the relation boost decay), otherwise it is set to false. The action can fail in several cases, e.g. if attacker and victim are of the same faction. Change relation of the killed object towards the killer This value will be set to true if there was an effect on the relation (or at least the relation boost decay), otherwise it is set to false. The action can fail in several cases, e.g. if attacker and victim are of the same faction. Check if object has line of sight to the target (uses ray casts) Offset relative to the object from where the line of sight check is performed. Offset relative to the target to which the line of sight is checked. If set to true, an object's aim targets (or the bounding box center if there are none) will be used as the raycast target, consistent with weapon aiming. If false, the coordinate center will be used. Defaults to false. Exclude object from raycast check. True by default. Can be used in conjunction with objectoffset or targetoffset to check if specific relative position has line of sight. Check if a ship is inside the designated area. Ignores mass traffic (as long as it's in the lane) and ships that have collision avoidance currently disabled (due to docking or parking). Check if a build location is free. Takes highways and objects like stations and gates into account, but ignores ships or asteroids. Notify the game that a target is being observed by this entity now (target: the observed object; range: the distance in which observation is actually happening) The observer object The observed object The distance in which observation is actually happening Notify the game that a target is no longer being observed by this entity The observer object The previously observed object Notify the game that a target is being attacked by this entity now The attacker object The attacked object Notify the game that a target is no longer being attacked by this entity The attacker object The previously attacked object Report illegal activity The object doing the illegal activity The victim of the activity Claim the target ship using pilot. ATTENTION: this moves 'this' to $target! All further this.* calls will correspond to $target! Ship that will be claimed. Must be ownerless. Pilot that will do the claiming. Will be moved from its current controllable to target. Faction that will take owership of ship. Will default to ownership of pilot controllable if omitted. Clamp wares and amounts of ordered ammunition, units, and deployables depending on resources available to the builder The object that is getting the new equipment The object that is building the new equipment Table of ammunition or deployable wares with assigned amounts to be clamped Table of unit wares with assigned amounts to be clamped Resulting table of ammo wares and amounts clamped to what the builder has enough resources to build. Will return null if attribute ammo is not populated. Resulting table of unit wares and amounts clamped to what the builder has enough resources to build. Will return null if attribute units is not populated. Clamp trade amount value based on buyer/seller storage situation (bundle/unbundle states are taken into account and the appropriate storages - cargo, ammo or units - are checked) The trade to check Initial amount to clamp based on buyer/seller storage limits (optional, defaults to 2147483647) The buyer to look at for free storage limitations (optional, either buyer or seller must be specified) The seller to look at for stored item limitations (optional, either buyer or seller must be specified) Should the ware be bundled (convert ammo/unit -> ware) on transfer? (optional, defaults to the trade offer bundle flag) Should the ware be unbundled (turn ware into ammo/units) on transfer? (optional, defaults to the trade offer unbundle flag) Should the passed-in tradedeal amount be updated if the clamp results in a reduction of amount? (optional, defaults to false, DO NOT USE FOR TRADE OFFERS!) Amount clamped so it matches how much seller has and how much buyer can store and afford. If amount was reduced, contains a string indicating which restriction reduced it to the lowest value. Possible values are 'seller_cargo', 'buyer_cargo' or 'buyer_money'. Null if amount remains unchanged. Clear the list of objects for which collisions are disabled Clear a group, i.e. remove all members from it Clear a list (equivalent to resizing to 0 elements) Clear a table, i.e. remove all keys and values from it Get buildership position outside of the stations boundaries, requires using 'position', 'space' and 'macro' OR an already placed 'construction' Assign a construction vessel to work for a build module of a build storage. Construction vessel is not yet deployed to aid in building. Deploy a construction vessel to begin work for a build module of a build storage. Disengage a construction vessel from a build module Build Module or Construction Vessel Connect a ship to a trade location (= reserve parking space) If result is null then the operation failed. Trade Location ComponentSlot (find using <find_tradeoffer_parking_slot>) Disconnect a ship from a trade location (= free up parking space) (optional) the Trade Location ComponentSlot to disconnect from. (if supplied, additional validation will be performed) Add a build task to construct a ship Define override resources and build duration Overriding build duration (note that the duration may still be affected by build efficiency and minimum build step times) Ware amount table of overriding resources (wares must be tagged as 'economy') Container object that has a build module Macro to build (overriden by the macro of buildobject if provided) Existing object to be built as a new object Specific faction to be used (optional) Loadout value or Loadout ID (must be valid in 'macro' or the macro of 'buildobject') Price of the constructed object Add a build task to recycle a ship Container object that has a build module Ship to be recycled Owner of the build task (optional) Price of the constructed object Add a build task to rebuild a fleet ship Container object that has a build module Fleet unit to be rebuilt Add a build task to expand a station Container object that has a build module Existing object to be expanded Construction plan ID string or constructionsequence value Price of the expansion Add a build task to upgrade or restock a ship People definitions People to be added to the object from NPC templates existing on the building object People to be added to the object from matching people or workforce on the building object (or from nowhere otherwise) Force the people to be added regardless of available matching NPCs on the providing object (defaults to false) People to be added to the object from NPC templates existing on the building object People to be added to the object from matching people or workforce on the building object (or from nowhere otherwise) Force the people to be removed, regardless of available free space on the receiving object (defaults to true) Container object that has a build module Existing object to be upgraded or restocked Loadout ID (must be valid in the macro of 'buildobject') Table of ammo types (ware or macro) with assigned amounts Table of unit types (ware or macro) with assigned amounts Price of the upgrade Get build people definitions in the form of a set of lists, either to be removed or added Result list of amounts Result list of roles used to identify people Result list of roles to reassign people Result list of races used to identify people Result list of skills used to identify people Result list of people (if 'removed' == true, then these people are currently on the built object, otherwise, the building object) Get the people set to be removed (defaults to false) Reassign people's roles Reassign people's roles Transfer people as defined in a build order, or by this definition Result values for the cost of people which were unable to be transferred Money value of people who were unable to be added during the transfer Money value of people who were unable to be removed during the transfer People to be added to the object from NPC templates existing on the building object People to be added to the object from matching people or workforce on the building object (or from nowhere otherwise) Build containing the people definition Object recieving the people Object providing the people Force the transfer, ignoring people capacities. Defaults to false. Result list of people successfully transferred from otherobject to object Remove a build task from an object Begin processing a build task Returns true if the build was successfully processed, otherwise false. Container object that has a build processor Specific build module to be used (optional, ignored if build processor is supplied) Specific build processor to be used (optional, overrides build module if supplied) Allow the build processor to work on the build immediately? Defaults to true. (false currently only functional for station expansion builds) Reserve a build plot, creating the base station and build storage Initial build plot dimensions, with the base station in the centre Length of the plot on the X axis Length of the plot on the Y axis Length of the plot on the Z axis Mission cue build plot belongs to (default is none) Created build storage Set the build plot of an object to be a given size. Station or BuildStorage of which the plot will be extendedm Should the build plot be allowed to be reduced from its current size? Defaults to false. Is this plot size paid for (defaults to false) Extend the length of a build plot (potentially shifing the BuildStorage's position) Can the build plot be extended without encroaching on other plots or static objects? Attempt to abort a build task. Only succeedes if task is currently abortable. Can provide either a build processor or container. Container requires a build task. Build processor. Takes precedence over 'container' If 'buildtask' is provided, it must be the current build for this processor. If not provided, the current build is aborted. Container. 'buildtask' must also be provided. Make a claim on an object to dismantle (also related to dismantle/tow claims from other object) The object to dismantle Start dismantling the currently assigned wreck The object to dismantle Clear the dismantling target of an object The object set to be dismantled Abort the current dismantling activity Commandeer an object to be used by faction logic Release a commandeered object (job ships restart their orders) Releases a subordinate group detached to protect a position, reverting it to its prior assignment. Commander of the subordinate group Subordinate group ID whose assignment will be changed. Integer from 1 to 10. Release a ship from its job Find waiting job ship(s) Find waiting subordinate(s) Get the possible subordinate jobs and the number of missing desired ships Commander job ship whose job and current subordinates are checked for the missing subordinates (either 'commander' or 'job' must be provided) Job ID to get the subordinate data from (ignored if 'commander' is provided) Is the commander initialising (defaults to false)? If false, subordinates flagged to not rebuild are ignored Result list of job IDs (paired with amount) Result list of desired ship amounts (paired with jobs) Get the possible subordinate macro(s) of a job ship, taking subordinate job quotas into account Is the commander initialising? If false, subordinates flagged to not rebuild are ignored (defaults to false) If true, consider the maximum possible subordinate quota variation, otherwise the variation is based on the persistent seed of the commander (defaults to false) Organise a job ship's subordinate hierarchy based on job definitions Get suitable job(s) by their category and basket data Faction or list of factions Specification tag or list of tags Ship size Ware to be matched to job basket Find suitable jobs even if the Job Engine is deactivated? Include jobs which are currently exceeding their maxgalaxy quota (defaults to false) Include jobs which are currently inactive (defaults to false) Include only jobs which are commandeerable (defaults to false) Find multiple definitions? If true, the result values return a list. If false (default), the results returns a single value. Result job id or list of job id's Check if the specified job is currently active Request a new job ship for a purpose Object requesting the ship to be created (can also be a space) Zone to become the ship's main job zone Ware requested to be transported by the job ship. Result ship (may not be connected to universe) Remove the request for a job ship (ship is removed if it does not exist in the universe) Set the time after which a job ship will be unregistered as a requested ship (will not happen at the exact time) Find requested job ship(s). Allows specialised filtering by 'requester', 'ware', 'includeexisting' and 'includewaiting'. The object which requested the ship (if null, the ships are not filtered by requester) The ware associated with the ship request (if null, the ships are not filtered by ware) Include ships which are in the universe (defaults to true) Include ships which are waiting to be created in the universe (defaults to true. do not use with groups) Spawn a waiting job ship into an area of space or a dock Either a DockingBay, Container or WalkableModule component or a Dockslot to spawn in (takes precedence from zone or sector) Zone to spawn in (used if dock is omitted or invalid, take precedence from sector) Sector to spawn the ship in using position in the sector space. Creates a tempzone if a zone does not exist at the coordinates Was the ship successfully spawned? Create needed subordinates which can be built by buildobject. The resulting ships will be disconnected as waiting subordinates. The builder object. Used to check what types of ships which can be built. Is the commander initialising (defaults to false)? If false, subordinates flagged to not rebuild are ignored Maximum amount of requested subordinates (if omitted, no limit) Trigger the orders for this ship's job to start Inform the job engine that a waiting ship is ready for use Set a job ship's start location to a zone (sector will be set implicitly) Set a job ship's start location to a sector (zone will be set implicitly, and may be a random zone within the sector) Set the time at which a job ship is treated as expired When set to false, the ship will no longer be moved to a safe position when it enters visible attention. Skip the current iteration of the innermost <do_while>, <do_for_each> or (counted) <do_all> loop, and continue with the next iteration. Create an AI unit from the provided object Create an empty group Name of the group to be created Create a list of given element count (default is 0), filled with null values. Use [] syntax instead for lists with fixed size/content. Note that the list variable name has to be provided in the name attribute, not the list attribute. Number of elements Create formation on a object. If that object has already a formation, it only changes the shape. Nested formations supported. Object for which this formation should be created (can be any member of an existing formation or a new leader) Object for which this formation should be created (can be any member of an existing formation or a new leader) Formation shape Parameter for formation shape, see formation shape documentation Whether the entire formation shape should roll with the leader (optional, defaults to false) Whether individual members should mimic the roll orientation of the leader (optional, defaults to true) Maximum number of ships per line of formation shape (optional, defaults to 20). If the amount of ships exceed this number, the formation will split creating lines up to this maximum amount. Does not affect the following formation shapes: wshape, eagle, twin, triangle, dartvertical and darthorizontal. Create a crate in a room Room slot to place the crate Create a Lockbox (wrapped inside its own object) Angular velocity (values in radians/s) Zone to create the lockbox in. (takes precedence from sector) Sector to create the lockbox in using position in the sector space. Creates a tempzone if a zone does not exist at the coordinates Mission cue lockbox belongs to (default is none) Create a bomb attached to a target Create an Object Zone to create the object in. (takes precedence from sector) Sector to create the object in using position in the sector space. Creates a tempzone if a zone does not exist at the coordinates Mission cue object belongs to (default is none) Is the ship commandeerable by faction logic (defaults to false) Should the object be spinning? Only works for asteroids, lockboxes, drops, mines, and ships. Defaults to true if not supplied. Create a Cluster Background Object Sector to create the object in Create a signal leak on an object or in space Specify voice pageID and a text ID or a list of text IDs for this signal leak. A random one will be chosen if multiple are provided. Only valid and required for type signalleaktype.voice! List of line IDs or single line ID in a text page Object (or zone) to create the signal leak in. (takes precedence from sector) Sector to create the signal leak in using position in the sector space. Creates a tempzone if a zone does not exist at the coordinates Slot to connect the signal leak to (only works for 'info' or 'mission' slots on objects, ignored for zone signal leaks) Specify voice pageID and a text ID or a list of text IDs for an existing signal leak. A random one will be chosen if multiple are provided. Only valid and required for type signalleaktype.voice! The signal leak to update Creates an AI order and adds it to an object's order queue AI order parameter Parameter name Parameter value Order ID Create as default order of the object? Instead of being added to the order queue, the order will replace the previous default order. Is this an override order? Creates an AI trade order and adds it to an object's order queue. A trade deal is created based on the given trade offer, so the trade can be performed in the future even if the trade offer changes or disappears in the meantime. The trade order ID is hard-coded. The trade deal is associated with the order (accessible via $order.trade) and is passed to the order as the "trade" parameter. Price per piece (defaults to the trade offer price) Should the ware be bundled (convert ammo/unit -> ware) on transfer? (optional, defaults to the trade offer bundle flag) Should the ware be unbundled (turn ware into ammo/units) on transfer? (optional, defaults to the trade offer unbundle flag) Was the trade order created by another order? (optional, defaults false) Does the trade order involve delivering salvaged resources to a processing module? (optional, defaults false) Create an orientation(rotation) value. refobject takes priority over refposition if both are supplied Position the orientation originates at (e.g. look_at means look from position towards refposition) If set to true, the refobject's aim targets (or the bounding box center if there are none) will be used as the reference point, consistent with weapon aiming. Requires refobject to be set. Defaults to false. The maximum pitch angle to be returned, in positive degrees (default: 90deg, i.e. no restriction) Create a construction sequence for a station randomly, connecting station modules with each other (but not applying the result to the station automatically). Since it takes a lot of CPU time to calculate the result, the action is completed instantly and the result will be provided later via <event_object_construction_sequence_created>. To retrieve the result immediately as part of the action, use the child element <immediate>, but be aware that it will block the rest of the game until the result is available. Provide the construction sequence immediately. The action will block the game until the result is available. Name of the variable that will receive the resulting construction sequence. In case of failure the result will be null. The station for which the construction sequence should be created. Its plot bounding box will be used as a constraint, and the station will receive the event <event_object_construction_sequence_created>. List of macros of functional modules to be added to the construction sequence List of macros of connector modules that are allowed in the construction sequence to connect functional modules. The algorithm may use a connector macro multiple times; it is not necessary to have duplicates in the list. Construction direction bias (omit or set to 0.0 to use default, or use range 0.1 to 10.0 where less than 1.0 prefers vertical connections, 1.0 is balanced, and greater than 1.0 prefers horizontal connections) Optional existing construction sequence that should be extended (null is allowed) Time limit for the computationally intensive part of the generation algorithm (default is no limit). See also the failsafe attribute. Prevent failure of the sequence generation (default is true), in case the generator fails to connect all modules. Normally a failure only occurs by reaching the timeout (if timeout attribute is present) or if the input to the generator does not allow for enough flexibility (e.g. if no connectors are supplied or the plot size is too small). To prevent failure, the remaining unconnected modules will be added in free space without any connections. This additional step can only fail if the plot size is too limited to allow adding the missing modules. Remove entries from the construction sequence that use the provided macros, also detaching all descendant entries in the connection tree. It is possible that more entries get removed than requested in the macro list. Element for defining variable names that will receive the results Resulting construction sequence List of existing components that are associated with input sequence entries but are removed in the result sequence (only returned if object is supplied) Total removal cost Object that the construction sequence belongs to (if supplied, it affects attribute 'costs' and result attribute 'removed') Existing construction sequence from which entries should be removed List of macros of functional modules to be removed from the construction sequence. In order to remove multiple entries of the same macro, provide the macro multiple times. List of macros of connector modules which may be removed in addition to the functional modules, except for the ones that are still required to keep the remaining sequence connected. It is not necessary to have duplicates in the list. Optional table of existing station components, with numeric cost values assigned to them. The action seeks to minimise the total cost of removed functional modules. For all sequence entries for which no cost is defined, a cost of 1.0 will be assumed for functional modules, and 0.0 for connectors. If object is provided, a cost of 0.0 will be assumed for all functional modules that do not exist in the object (i.e. have not been built yet). Generate a loadout for a given object A construction sequence for which loadouts should be generated. Loadouts will be generated an entry at a time. A macro (ship or station) for which a loadout should be generated. Loadout will be returned as a single entry. Ignored if a sequence is provided. A module macro (station module) for which a loadout should be generated. Loadout will be returned as a single entry. Optional, ignored unless macro is provided. Faction to use for selecting equipment. Additional faction to use for selecting equipment, where licences for both selling and buying are required. Ignored if wares or macros are supplied. A list of wares or table of ware amounts, from which the loadout should be generated. If neither wares nor macros are provided, default items for faction will be used. A list of macros or table of macro amounts, from which the loadout should be generated. Ignored if wares are provided. If neither wares nor macros are provided, default items for faction will be used. If a list of wares or macros is supplied, use repeated entries to indicate quantity, otherwise quantity is unlimited. Default is false (unlimited). Ignored if wares or macros are specified as a table, or if neither are specified. The level of the loadout that should be generated. This should be a value between 0 and 1. If variation is non-zero, it will add variation to this number. Defaults to value defined in parameters.xml. Allows an amount of variation on both the number of slots filled on a given entry in the sequence and what the slots can be filled with. Defaults to value defined in parameters.xml. When generating a default loadout with no supplied ware or macro lists, select only items for which the supplied faction has blueprints. Has no effect for non-player factions. Defaults to false. Loadout flags for elements to generate (add/remove flags not used in this case). Invert the loadout flags provided in 'flags' attribute. A list of loadouts that have been generated for the given construction sequence. The index of each loadout refers to the index of the construction plan entry in the sequence. Optional variable to receive used items. Contents will follow the format of data supplied, i.e. wares if wares were supplied, macros if macros were supplied, and repeated if repeat parameter is true. Not populated if no ware/macro list is provided at all. Optional variable to receive remaining items. Contents will follow the format of data supplied, i.e. wares if wares were supplied, macros if macros were supplied. If repeat is false then the remaining items will be the same as the originally-supplied list because quantities are unlimited. Not populated if no ware/macro list is provided at all. Get a loadout via an ID ID string of the loadout Macro of which the loadout is defined for Result loadout Create a loadout using a fixed loadout definition Result loadout Export the loadout to the local loadouts.xml file Object macro The loadout that should be exported ID to export the loadout as Name of the loadout Description of the loadout Apply the specified loadout to an object or construction sequence at the specified index. The loadout that should be applied. Object to apply the loadout to. Either a ship, or a station module. A sequence to which the loadout should be applied. If sequence is given, index must also be given, as a loadout is applied to a specific entry in the sequence. The index of the entry in the sequence to which the loadout that should be applied. Must be supplied if sequence is also supplied. Loadout flags for elements to apply, and operations (add/remove) to perform. Add one or more equipment mods to a ship Ship to add the equipment mods to. Add paint mod to a ship Ship to add the paint mod to. Paint mod ware (from paintmods.xml, defines a quality level and visual properties of a paint mod) Set the specified loadout level for an object. Allowed range: 0.0 to 1.0. This loadout level will be used as the default for subsequent functions working with it (e.g. <evaluate_unit_storage />) Object loadout level applies to. Either a ship or station. Create a random position value within the bounding box of a component (the resulting value is relative to the component) Create a random position value outside the bounding box of a component (the resulting value is relative to the component) The minimum distance the generated point will have from the edge of the component's bounding box in each axis. The maximum distance the generated point will have from the edge of the component's bounding box in each axis. Create a trade offer and if provided, add it to an object Setting the seller object makes this a Sell type offer. Also setting buyer negates this. Setting the buyer object makes this a Buy type offer. Also setting seller negates this. Object for the offer to be localiased on The price of a single item The real amount we desire if available funds would not matter (optional, defaults to amount) Is the ware amount fixed? Ignored if minamount is set Should the ware be unbundled (turn ware into ammo/units) on transfer? (optional, defaults to false) Should the ware be bundled (convert ammo/unit -> ware) on transfer? (optional, defaults to false) Is cargo virtual (does not take up cargo space)? (optional, defaults to true) Is money virtual (no transaction takes place)? (optional, defaults to false) Should this tradeoffer only be available to the player faction? (defaults to true, will allow *all* factions to trade if set to false) Mission cue trade belongs to (default is none) Remove a trade offer from an object Create a position value just outside the bounding box of a component, in the direction of the given position (the resulting value is relative to the component). If the given position is inside the bounding box, it will be used as the result. The distance the generated point will have from the edge of the component's bounding box. Check if a position is inside an object's bounding box Create a position value directly on the surface of an object, in the direction of the given position (the resulting value is relative to the space, or the object if no space was supplied). The rotation value will be set from the surface normal. If no position is supplied, it will be randomized in a sphere around the object. If the position return value is null, no valid surface position was found. This may happen if the object's physics were not ready (use .isphysicsready). Position to aim the raycast at (otherwise 'component' if provided, object center if not) (optional) Optional rotation that will be applied to the result in addition to the rotation based on the surface normal. Criteria that the hit component must pass Sub component of object to aim the raycast at (otherwise object center) (optional) If specified, the result will be moved by this distance along the surface normal. Can also be negative. Allow positions which are obstructed by other objects (defaults to true, primarily for legacy reasons) Create a position value Create a position value Reference position Rotation at the reference position Create a rotation value Create a ship Either a DockingBay, Container or WalkableModule component or a Dockslot to spawn in (takes precedence from zone or sector). Spawning will fail if the ship.owner is below docking relations towards the dock.owner. If relations can change, consider spawning as dock.owner and set_owner afterwards. State of the new ship. Defaults to operational Mission cue ship belongs to (default is none) Is the ship commandeerable by faction logic (defaults to false) Zone to spawn in (used if dock is omitted or invalid, take precedence from sector) Sector to create the ship in using position in the sector space. Creates a tempzone if a zone does not exist at the coordinates Fixed seed used for ship generation. Auto-advance seed used for ship generation. Create a station Construction plan ID string or constructionsequence value Zone to create the station in. (takes precedence from sector) Sector to create the station in using position in the sector space. Creates a tempzone if a zone does not exist at the coordinates State of the new station. Defaults to construction Mission cue station belongs to (default is none) Raw name for the station to be named to (in case of a fixed text reference, use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) Raw description for the station (in case of a fixed text reference, use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) Override build method to set upon creation (for station and build storage). (defaults is no override) Should this station be displayed in the encyclopedia? Create a factory Result list of module macros to be incorporated into a generated sequence Result construction sequence which is the base which the resulting 'modules' will be added to (can be null if no base sequence is defined and the modules should be incorporated into an empty plan) Zone to create the station in. (takes precedence from sector) Sector to create the station in using position in the sector space. Creates a tempzone if a zone does not exist at the coordinates Race of the factory, used to get a valid set (overridden by 'set') Mission cue factory belongs to (default is none) Module set ID used to construct this factory Define the ware that the station identifies as its original product State of the new station. Defaults to construction Base the module limits against the max limits defined in the module definition, otherwise use the base limits. (defaults to false) Fixed seed value used for construction plan generation. Auto-advance seed value used for construction plan generation. Create a build storage for the station Create and add a module to an object Object to add the module to Create and a factory based on a god production entry State of the new station. God entry default used if ommitted. Create and an object based on a god object entry State of the new object. God entry default used if ommitted. Create and a station based on a god station entry State of the new station. God entry default used if ommitted. Create and a ship based on a god ship entry State of the new ship. God entry default used if ommitted. Create a prop Prop slot Fixed seed for prop selection. Auto-advance seed for prop selection. Create and add a dynamic interior to an object Object to add the interior to Optional module within the object where the interior should be added Corridor macro Door macro slot or connection name within corridor (random door is selected if not supplied) Room macro Name to be applied to new interior (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) Fixed seed used for interior generation. Auto-advance seed used for interior generation. Is the interior persistent in low attention? (defaults to false) Are the dynamic interior rooms private? (defaults to false) Is this interior also rendered when the player is outside of it? (defaults to false) ID of the navmesh generation parameter overrides as defined in parameters.xml in the <navmesh_overrides>/<by_id> nodes Add a new room to a dynamic interior Interior to add the room to Door macro slot or connection name within corridor Room macro Check that any created room is suitable to be added to an interior which can support multiple rooms (e.g. the room has has no window connections). Set to false if the assets are assured to work together. Defaults to true. Remove a dynamic interior from an object Object to remove the interior from (any one of interior, corridor or room component can be supplied) Interior to remove Corridor to remove (ignored if interior provided) Room to remove (ignored if interior or corridor provided) Set the rooms of a dynamic interior to private so contained NPC slots and waypoints can only be found by querying the rooms specifically, not via their contexts Object containing the interior (any one of interior, corridor or room component can be supplied) Interior to set privacy for Corridor used to find interior to set privacy for (ignored if interior provided) Room used to find interior to set privacy for (ignored if interior or corridor provided) Are the dynamic interior rooms private? (default is true) Set a dynamic interior to be persistent so that it won't be cleaned up when the player leaves its vicinity Object containing the interior (any one of interior, corridor or room component can be supplied) Interior to set persistence for Corridor used to find interior to set persistence for (ignored if interior provided) Room used to find interior to set persistence for (ignored if interior or corridor provided) Should the dynamic interior rooms be persistent? (default is true) Create a control entity for the specified object Create a NPC from a NPC template on an object Object containing the NPC template. If 'slot' and 'placementobject' not provided, NPC will attempt to be placed on 'object' Object or room to place the new actor if 'slot' not provided Room slot Set the roomslot of the actor to the provided slot if it is a valid NPC slot (defaults to true) Trigger the default animations for this room slot on the actor (defaults to true) Activation state for the chair if the slot is a chair slot (defaults to 'activate_chair'. Using 'invalid' will keep the chair in it current activation state) Have the chair animate to its active position Have the chair animation to its inactive position Have the chair remain in its current activation state Is the npc required to be successfully created and placed in a room? (defaults to false) Cancel a scheduled crew transfer for this person Object containing the NPC template Create a NPC template and place it on an object Other object to contain an existing template if 'template' is prodived. If 'otherobject' is not provided, default to 'object' NPC to use as a base when creating the template - Must be provided if 'template' or 'macro' is not Existing NPC template to base when creating the template (taken from either 'object' or 'otherobject' if provided) - Must be provided if 'entity' or 'macro' is not Macro of the new NPC template - Must be provided if 'entity' or 'template' is not Entity role this template will be set to Force the template to be added even if there is no available space Remove a NPC template from an object Send an event to a running cutscene Event string that is sent to the cutscene Output debug text Text Include the context of this debug_text (defaults to true) Debug output filter (optional, default is scripts) Output debug text to logfile in game\logs folder under My Documents\Egosoft. Text will only be logged to a file if the game has been started with parameter -scriptlogfiles ! Text Filename (required, allowed extensions: .txt, .csv, .log and .xml - otherwise .txt is appended automatically.) Sub-Directory of logs folder (optional, defaults to blank) Controls whether the text should be appended to an existing logfile of the same name or overwrite and create a new file (optional, defaults to true) Controls whether the text should also be written to the regular 'scripts' debug output (optional, defaults to false) Deplete yield for a certain ware in a zone of a specific region. If container is provided, attempt to add the wares to it (which may affect the deleted amount) If provided, the wares will attempt to be added to the container object. The wares successfully transferred will then be depleted from the region Amount to be drained from the region, this value will contain the actual amount that was drained after the command has been executed Get the highest local resource yield in a sector The ware for which to get the highest yield The name of the yield definition (see libraries/regionyields.xml for valid values) Where to look for the resource in. The highest yield value (total amount in a box with 64km long edges) Determine rate at which the refobject can drain resources from the supplied region in the specified zone (averaged using available colletector drones) The time this ship spends scanning for a mineable object (only applies to mineral mining, defaults to 0s) Rate at which the specified resource can be drained from the region by the refobject (float) Add an anomaly as a set destination of another. The destination will be picked at random on transition. Remove an anomaly as a set destination of another. Enable or disable transition to an anomaly. Set the enabled state for transition to an anomaly. (defaults to true) Reset enabled state for transition to an anomaly to default value. Enable or disable transition from an anomaly. Set the enabled state for transition from an anomaly. (defaults to true) Reset enabled state for transition from an anomaly to default value. Destroy specified object (NOTE: The destruction does not take place instantly and the object may still appear operational at the end of the action. Subsequent actions may not be able to tell whether the object is being destroyed. See also <remove_actor_from_room>.) Show explosion effect? Default is false Destroy specified group Show explosion effect? Default is false Restore specified object from the wreck state The hull value to set after restoring the object Recursively repair contained components (default = false) Perform transition, if any, between states (default = false) Disable collisions between the object and the target Does all collision checks but disables all reaction to the checks = no collision. Only works for objects in visible attention. Re-enables reaction to collision. Only works for objects in visible attention. Remove all procedurally created Cluster Background Objects Sector to remove the objects from Aborts travel mode and boost of ship and disables usage for specified duration Duration in which travel mode and boost cannot be activated. If 0s is specified, possible to immediately reactivate travel mode or boost. Dock ship instantly at the pre-selected docking bay (<request_docking> must have been performed successfully before!) Drop ware from cargo bay (if possible) Drop all illegal cargo from cargo bay Faction to check ware legality against (optional, if omitted only wares that are globally illegal will be dropped) Drop all illegal wares from entity inventory Faction to check ware legality against (optional, if omitted only wares that are globally illegal will be dropped) Lockbox macro (optional, if omitted wares will spawn as ordinary drops) Drop ware from inventory (if possible) Lockbox macro (optional, if omitted wares will spawn as ordinary drops) Eject all NPCs from the object (they will use escape pods. Cannot be used for ship_xs!) Have the entity eject into their defined spacesuit, otherwise the pod defined in script parameter crewtransfer.podmacro (defaults to false) Force the pods to spawn even if the object is not capturable? Ejects NPCs immediately. Only needed if NPC will otherwise be queued for destruction in the same frame. Action rejected if used in AI scripts on the affected entity. (defaults to false) Eject all people (passengers) from the object (they will use escape pods. Cannot be used for ship_xs!) Attacker that causes people to eject (optional) Maximum number of people to eject (eject all if not supplied) Skill level to match people with others of their tier. Only valid when used with attribute 'role' Have the entity eject into their defined spacesuit, otherwise the pod defined in script parameter crewtransfer.podmacro (defaults to false) Force the pods to spawn even if the object is not capturable? Ejects people immediately. Only needed if people will otherwise be queued for destruction in the same frame. (defaults to false) Re-enables collisions between the object and the target Find a suitable NPC position near an object to interact with it. Slot to connect the NPC to - returned offset is relative to this slot Find asteroid in cluster near specified position Cluster Reference object or space (defaults to cluster if not supplied) Whether this should return a rock that can be collected or an asteroid that needs to be broken up first (defaults to false) If true the command will return a list of asteroids and will automatically do a view check, see viewangle and maxdistance attributes! If multiple is true this controls the forward angle to see if asteroids are in range (defaults to 360deg) If multiple is true this controls the maximum distance at which asteroids can be found (defaults to 3000m) Only include asteroids that contain the specified ware as resource (ignored by default) Find recyclable in cluster near specified position Cluster Reference object or space (defaults to cluster if not supplied) Whether this should return a recyclable that can be towed (defaults to false, mutually exclusive with candismantle) Whether this should return a recyclable that can be dismantled (defaults to false, mutually exclusive with cantow) If true the command will return a list of recyclables and will automatically do a view check, see viewangle and maxdistance attributes! If multiple is true this controls the forward angle to see if recyclables are in range (defaults to 360deg) If multiple is true this controls the maximum distance at which recyclables can be found (defaults to 3000m) Only include recyclables that contain the specified ware as resource (ignored by default) Find matching buy offer(s) object that will do the trading (usually a trade ship) (optional) only find buy offers on this buyer (optional) filter for wares that the seller produces (and does not need itself) (optional) zone or sector in which to look for offers, defaults to zone of tradepartner (optional) exclude empty trade offers (amount = 0, desired amount > 0)? (defaults to true) (optional) exclude mission trade offers? (defaults to true) (optional) take reservations into account when checking if a trade is empty? (defaults to true) Find closest object that has an octree Reference object for distance check Find closest resource After evaluation this position will be treated as relative to refobject. a single ware or list of wares that needs to be available as a resource in the region (optional) minimum resource yield that the region/zone needs to provide Reference object for distance check (optional) Whether resources not yet discovered by the player are allowed to be found (defaults to true) (optional) Whether resources inside dangerous regions are allowed to be found (defaults to false) (optional, resultvalue) list of all the resources that can be gathered in the found zone (resultvalue) the zone where the requested resource can be found (mutually exclusive with sector) (resultvalue) the sector where the requested resource can be found (mutually exclusive with zone) (resultvalue) distance from the refposition to to the result position (resultvalue) the position relative to the returned space (sector or zone) where the requested resource can be found Find closest part of a station Reference object for distance check Find the closest position in a sector that the player hasn't uncovered yet. May return null if none exists. The reference position in sector coordinates. The center of the valid range in sector coordinates. Required if and only if range is valid. The sector in which to look for undiscovered areas. (optional) The range in which to look for undiscovered hexes. Also requires rangecenter to be valid. The center of the nearest undiscovered hex in sector coordinates if there is one within range, null if there is none. Find the closest position in a sector that obscures the gravidar. May return null if none exists. The reference position in sector coordinates. The sector in which to look for gravidar obscuring positions. The center of the nearest gravidar obscuring position in sector coordinates if there is one, null if there is none. Find the closest position in a sector that is inside a dangerous region. May return null if none exists. The reference position in sector coordinates. The sector in which to look for undiscovered areas. (optional) The minimum size of the dangerous region at the returned position. Defaults to no minimum. The center of the nearest position inside a dangerous region in sector coordinates if there is one within range, null if there is none. Find matching cluster(s) Find matching cluster(s) within 'maxdistance' jumps of 'object' If true then the found clusters are appended to 'name' list and 'distances' table. Should the values 'name' or 'distances' not be a list or table respectively, they will become one, losing their previous value (default false) Minimum number of Jump Gates or Orbital Accelerators to 'object' Maximum number of Jump Gates or Orbital Accelerators to 'object' (omit to have no jump distance limit) Object or Cluster to check jump distances to Result table of clusters and distances (key = cluster, value = jump distance) Find matching sector(s) within 'maxdistance' jumps of 'object' If true then the found sectors are appended to 'name' list and 'distances' table. Should the values 'name' or 'distances' not be a list or table respectively, they will become one, losing their previous value (default false) Minimum number of Jump Gates, Orbital Accelerators or Super Highway Entry Gates to 'object' Maximum number of Jump Gates, Orbital Accelerators or Super Highway Entry Gates to 'object' (omit to have no jump distance limit) Object or Sector to check jump distances to Result table of sectors and distances (key = sector, value = jump distance) Search a macro for a connected macro or macros, optionally of a certain type. Add a class filter to the search so that only children of a certain class are returned. If not provided, all children will be returned. Find matching room(s) in a container, walkable module or navcontext Find matching dock(s) Find dockingbay for trade Trader ship Find dockingbay for trade Dock object (Container, DockArea or BuildModule) Whether the dock to be found must be free, defaults to false Whether the dock to be found must support docking, defaults to false Whether the dock to be found must support undocking, defaults to false Whether the dock to be found must support building, defaults to false Whether the dock to be found must support trading, defaults to false Whether the dock to be found may also be one that only allows the player to dock, defaults to false Whether the dock to be found must be exclusively meant for venturing, defaults to false Specific venture platform with which venture dock must be associated (can be null) Whether to find a high priority dock, defaults to false (will fall back to the other kind of dock if no matching ones exist) Find gravidar contact(s) Scanning object Find matching modules(s) in a defensible object Find signal leak locations at an object Do not include slots currently filled by a signal leak (defaults to false) Find npc slot in a controllable object, walkable module, nav context or room Controllable, walkable module, nav context or room Search for tag or list of tags (any matching), mutually exclusive with attribute 'tags' Search for tag or list of tags (all must match), mutually exclusive with attribute 'anytag' Do not include slots currently reserved by a NPC (defaults to true) Do not include slots which are blocked by obstacles such as props (defaults to true) Find npc waypoint in a controllable object, walkable module, nav context or room Controllable, walkable module, nav context or room Do not include slots which are blocked by obstacles such as props (defaults to true) Get the closest valid floor position for a NPC (requires the object to have active physics) The component which is used for entity navigation at the 'position' result value The floor position relative to the 'context' result value The room related to the result floor position. Result position is not necessarily relative to it. List of floor tag at the result position Find a crate slot in a walkable module or room Container or room Slot group tag Do not include slots currently taken by a crate (defaults to true) Find a prop slot in a room The group ID (which may be a string or a tag) Find player transporter slot in a ship or room. Note that such slots are distinct from NPC waypoint/transport slots. Ship or room (e.g. cockpit, dockingbay). A ship should only be provided if the cockpit is virtual, i.e. if the cockpit slots are actually on the ship instead of the cockpit. It is safe to provide a cockpit even if it's virtual - in this case, the matching slot will be found on the ship itself. Find ship workbench slot in an object. Note that such slots are distinct from NPC waypoint/transport slots. Connection group tag Find inventory workbench slot in an object. Note that such slots are distinct from NPC waypoint/transport slots. Connection group tag Find ship console slot in an object. Note that such slots are distinct from NPC waypoint/transport slots. Connection group tag Find venture console slot in an object. Note that such slots are distinct from NPC waypoint/transport slots. Connection group tag Find inventory console slot in an object. Note that such slots are distinct from NPC waypoint/transport slots. Connection group tag Find hack console slot in an object. Note that such slots are distinct from NPC waypoint/transport slots. Connection group tag Find airlock console slot in an object. Note that such slots are distinct from NPC waypoint/transport slots. Connection group tag Find map console slot in an object. Note that such slots are distinct from NPC waypoint/transport slots. Connection group tag Find station editor console slot in an object. Note that such slots are distinct from NPC waypoint/transport slots. Connection group tag Find scenario console slot in an object. Note that such slots are distinct from NPC waypoint/transport slots. Connection group tag Find matching component(s) contained in an object Find resource (random location in cluster) a single ware or list of wares that needs to be available as a resource in the region (optional) minimum resource yield that the region/zone needs to provide Reference object for distance check or a cluster for all contained regions (optional) snap result position to the size of a region grid (defaults to true) (optional) Whether resources not yet discovered by the player are allowed to be found (defaults to true) (optional) Whether resources inside dangerous regions are allowed to be found (defaults to false) (optional, resultvalue) list of all the resources that can be gathered in the found zone. If used with multiple="true", gives a list of lists of resources synchronized with the zone list from $zone. (resultvalue) the zone where the requested resource can be found (mutually exclusive with sector) (resultvalue) the sector where the requested resource can be found (mutually exclusive with zone) (resultvalue) the position relative to the returned space (sector or zone) where the requested resource can be found Check an object against filters Ends all repair mass traffic networks for an object The time the network should end (defaults to 'as soon as possible' if not supplied) Find a repair mass traffic network for an object that doesn't have an end time set already The ID of the mass traffic network - IMPORTANT: this will become invalid if a savegame is loaded Find position in mass traffic network where the object would be at the specified time (only works for ships originating from mass traffic!) Find random position in mass traffic network Minimal time after beginning of path Minimal time until end of path Find matching object(s) Find matching sector(s) Find matching sell offer(s) object that will do the trading (usually a trade ship) (optional) filter for wares that the buyer can use(and does not produce itself) (optional) only find sell offers on this seller (optional) zone or sector in which to look for offers, defaults to zone of tradepartner (optional) exclude empty trade offers (amount = 0, desired amount > 0)? (defaults to true) (optional) exclude mission trade offers? (defaults to true) (optional) take reservations into account when checking if a trade is empty? (defaults to true) Find matching ship(s) Find matching ship(s) by true owner faction. More efficient than using find_ship with 'trueowner' filter. 'space' must be of class Space. True owner faction Find matching station(s) Find matching station(s) by true owner faction. More efficient than using find_station with the 'trueowner' filter. 'space' must be of class Space. True owner faction Find matching gate(s) Find matching highway entry gate(s) Find matching highway exit gate(s) Find tradeoffer location parking ComponentSlot Object (container) that has the tradeoffer locations. (optional) If supplied the list of slots will be sorted by distance to refobject. (optional) If supplied the slot for this trade will be preferred. Include slots that are marked as occupied (defaults to false) Find matching highways(s) Find matching zone(s) - excludes highways Fire turret Turret Get attack strength against target Resulting damage calculated for per-second usage. If 'missileresult' node is ommitted then this also includes approximate missile dps which may misrepresent burst damage. Approximate total attack strength as a single value Attack strength applied to hull and shields Attack strength applied to hull only Attack strength applied to shields only Attack strength applied to hull only if no shields are present Resulting missile specific damage and ammo usage, expected to be applied in a single salvo as 'explosive'. Resulting table of ammo macros and amounts which have been fired (not yet deducted) Resulting table of ammo macros and amounts which are deemed to be successful in hitting the target and their damage accounted for in the damage result values (damage not yet applied) Approximate total attack strength as a single value Attack strength applied to hull and shields Attack strength applied to hull only Attack strength applied to shields only Attack strength applied to hull only if no shields are present Allow any turret to attack the target, regardless of weapon system suitablility (defaults to false) Include damage of defence drones (defaults to true) Include damage of forward main weapons (defaults to true) Get character macro or reference by filtering via category parameters Faction or list of factions Specification tag or list of tags Race Find multiple definitions? If true, the result values return a list. If false (default), the results returns a single value. Result macro (list if 'multiple' is true. Less performant than 'reference') Result character reference (list if 'multiple' is true) Get the lists of people to be exchanged between the "trader" and the "tradepartner" of a ship-to-ship crew exchange trade. Result list of people on the object to be transferred to the tradepartner ship Result list of people on the tradepartner ship to be transferred to the object The ship (trader) that performs the crew exchange to and from the other ship (tradepartner) The crew exchange trade deal Get docking approach pos Docking bay component slot (find using <find_dockingbay>) Get gate approach pos Jumpgate Get global path from start to end (multiple=0 returns first value. multiple=1 returns whole path as lists) Result list of components if attribute multiple is used, otherwise first value Result list of positions if attribute multiple is used, otherwise first value Result estimated length of the whole path (or negative length if no path exists). Return the whole path or the first pair of Component and offset? 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) Reference object for blacklist or known sectors (required if useblacklist or useknownpath supplied) Whether the path should only include sectors known to the refobject's owner faction (defaults to false) Whether the path should include local highway entrance/exit points or not (defaults to true) Get jump path from start to end (multiple=0 returns first value. multiple=1 returns whole path as lists) Result list of components if attribute multiple is used, otherwise first value Result list of positions if attribute multiple is used, otherwise first value Return the whole path or the first pair of Component and offset? 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) Reference object for blacklist or known sectors (required if useblacklist or useknownpath supplied) Whether the path should only include sectors known to the refobject's owner faction (defaults to false) Whether the path should include local highway entrance/exit points or not (defaults to true) Get the internal highway offset which is closest to this position Co-ordinate space for the position (can be a space or object) Get a safe position in a zone or sector Required if using zone coordinates (takes precedence over sector if both are specified), result will be in zone coordinates relative to this zone. Required if using sector coordinates (ignored if zone is specified), result will be in sector coordinates relative to this sector. Get the percentage of hexes in an area that are being covered by player-owned satellites The center of the target area. The radius of the target area The sector the position is relative to Get ship macro or reference by filtering via category parameters Faction or list of factions Specification tag or list of tags Ship size or list of sizes Find multiple definitions? If true, the result values return a list. If false (default), the results returns a single value. Result macro (list if 'multiple' is true. Less performant than 'reference') Result ship reference (list if 'multiple' is true) Get list of ship macros of a ship definition ID Ship definition ID Result list (null if reference ID is not valid) Get module macro or reference by filtering via category parameters Faction or list of factions Race Specification tag or list of tags Production ware The set from which the module should be taken. If used with reference (as opposed to macro), this attribute will have no effect. Find multiple definitions? If true, the result values return a list. If false (default), the results returns a single value. Result macro (list if 'multiple' is true. Less performant than 'reference') Result module reference (list if 'multiple' is true) Get station macro of a module set Module set race Module set type string Module set ID (takes preference over 'race' or 'type') Result macro Check if a production for a specified ware is allowed to be added to an object Check against the max limits defined in the module definition, otherwise use the base limits. (defaults to true) Get construction plan from stations.xml by filtering via category parameters Faction or list of factions Race Specification tag or list of tags Find multiple definitions? If true, the result values return a list. If false (default), the results returns a single value. Result construction plan (list if 'multiple' is true) Result raw name string of the construction plan (list if 'multiple' is true) Get construction plan from matching station entry god.xml Space to filter for a suitable god entry by location (no location filter if null) Module set type Find multiple definitions? If true, the result values return a list. If false (default), the results returns a single value. Result construction plan (list if 'multiple' is true) Result raw name string of the construction plan (list if 'multiple' is true) Get station macros from stations.xml by filtering via category parameters Faction or list of factions Race Specification tag or list of tags Find multiple? If true, the result values return a list. If false (default), the results returns a single value. Result macro (list if 'multiple' is true) Get room macro or reference by filtering via category parameters Race Specification tag or list of tags Fixed seed used for room selection where multiple are available. Auto-advance seed used for room selection where multiple are available. Find multiple definitions? If true, the result values return a list. If false (default), the results returns a single value. Result macro (list if 'multiple' is true. Less performant than 'reference') Result doors (list of macroslots for a single macro, a list of lists of macroslots for multiple macros, nothing if only references are returned) Result module reference (list if 'multiple' is true) Get position list of matching target points from a macro Either a single tag or a list of tags which are required for the target points Get the threat score of the provided class Get position list of matching waypoints from a component, starting from a start waypoint and progressing along the links until the end is reached 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 (matched in addition to the other required tags, if they are defined) Group tag Get list of text IDs in given range on a TextDB page Lower bound of text ID range (default is 0) Upper bound of text ID range (default is no upper bound). Note that text IDs outside the signed integer range cannot be found. Factor used as a filter for found text IDs. The list will contain only text IDs that are multiples of this factor. Default is no factor. Get trade parking position (for L and XL trade ships that cannot dock directly), optionally gets the quadrant of the ship where the traffic lanes are. Trade dock component slot (find using <find_tradeoffer_parking_slot>) Return "approach" position (defaults to false). If false, this is the position at which masstraffic lanes snap to the tradeoffer location for optimal connection. Space that the resulting position and rotation should be relative to (optional, defaults to the tradeoffercomponent) Get a single or multiple definitions for wares from the WareDB. Filter wares by the owner of the trade licence Licence ref (takes precedence over 'licencefaction' and 'type' pair) The licence issuing faction. Ignored if 'licence' is provided. Can be used without defining 'type'. Type of licence. Ignored if 'licence' is provided The faction or factions for which the wares should be defined - this will filter the result down to what this faction can produce. Ware flags for filtering wares Group ID string A filtered list of wares. Reserve space for selling ware to an object. The container where the reserver(object) wants to reserve space for an amount of ware. Buy or sell? We want to buy, this will reduce sell-offer amounts. We want to sell, this will reduce buy-offer amounts. Which object to reserve this amount for. Positive number of units to reserve. Duration of this reservation (optional, defaults to 1 hour) Whether the reservation is for a mission trade (optional, defaults to false) Whether amount should be added to any existing reservation or replace it. (optional, defaults to false) Whether to check reservations for "supplies" (optional, defaults to false) Whether to look at the "real" or the "virtual" dataset - virtual reservations are IGNORED for trades. (optional, defaults to false) The amount that is now reserved for this reserver. Can be different from amount if there already was a reservation. (optional) Remove a space reservation that was previously added with <add_ware_reservation> (fails silently if there was no matching reservation) The container from which to remove the reservation. Type of reservation to remove (optional, defaults to all) Remove buy reservations only. Remove sell reservations only. Whose reservation to remove (optional, all reservations for ware (if specified) will be removed if omitted!) What reservations to remove (optional, all reservations for reserver (if specified) will be removed if omitted!) How many units from the reservation to remove (optional, will remove all units if omitted, only has an effect if reserver and ware are specified!) Whether the reservation is for a mission trade (optional, defaults to false) Whether the reservation is for a supplies trade (optional, defaults to false) Whether to look at the "real" or the "virtual" dataset - virtual reservations are IGNORED for trades. (optional, defaults to false) Get reserved space for ware (optionally object specific) on an object. The container to query for reserved amounts of the specified ware. Reservation type Buy reservations only. Sell reservations only. Only count reservations for a specific object. If 'mission' is true, the object must be player owned and will return all player owned mission reservations (optional) Whether the reservation is for a mission trade (optional, defaults to false) Whether the reservation is for a supply trade (optional, defaults to false) Whether to look at the "real" or the "virtual" dataset - virtual reservations are IGNORED for trades. (optional, defaults to false) The amount that is reserved for this reserver (or all reservers). Get list of wares illegal to a faction The faction to which wares are illegal. A filtered list of wares. Get equipment wares this object can build The other faction which may have restrictions on which wares they can use from this object Select only items for which the supplied faction has blueprints. Has no effect for non-player objects. Defaults to false. A filtered list of wares. Get ship wares this object can build The other faction which may have restrictions on which wares they can use from this object Select only items for which the supplied faction has blueprints. Has no effect for non-player objects. Defaults to false. Only include ship wares the object is allowed to build. Defaults to false. Only include ship wares the object is allowed to equip. Defaults to false. Only include ship wares the object is allowed to supply. Defaults to false. A filtered list of wares. Get a safe position for leaving a zone towards a destination (destination must be in same sector!) Radius to indicate necessary space required for a safe position Get the zone at this sector position (may return null if none exists) Allows temp zone creation if there is none at position. WARNING: only set to true if zone will immediately be used to avoid creation of too many temp zones. (defaults to false) Hint a target to precaching its assets. Can be an object or a space. Target to prehint. Only includes contained components if 'includechildren' is true or exceptions such as station components for their child module components. Include the child components of the target component and their children (defaults to false). Note: May be expensive. Hint the high quality level assets of the target component? (Defaults to false) Hint an actor's animation sequence (precaching of assets), requires either 'behavior' or 'slot' attribute Animation sequence type Animation sequence behavior (ignored if 'slot' is provided) Room slot to query for the NPC's default animation at that location (takes precidence over 'behavior') Interpolate a value. Use the subnodes to select the method and provide arguments. Linearly interpolate 'result' within the defined output range, based on the location of the 'value' within the input range Lower end of the input range Upper end of the input range (must be higher than 'mininput') Lower end of the output range (may be higher than 'maxoutput') Upper end of the output range (may be lower than 'minoutput') Input value Check if target object is in all specified quadrants of object, returns false if target is not detected at all Scanning object The object to look for Join formation. No effect if there is no formation in the object. Object joining the formation Formation leader Request a countermeasure to be launched against enemy missile locks or incoming missiles. May not launch due to already queued countermeasures. If true no actual countermeasure object is created but the ammo is consumed. For use in low attention. Whether a new batch of countermeasures has been queued for launch Launch distress drone Attacker that causes distress drone launch (optional) Launch crew transfer pod. Crew being transferred is independent of this action. Container that will receive crew transfer pod Time that the pod is expected to arrive. (Optional) Launch laser tower Deployable category from which macro will be selected if not supplied (optional, defaults to lasertower) Launch mine Deployable category from which macro will be selected if not supplied (optional, defaults to mine) Launch navigation beacon Deployable category from which macro will be selected if not supplied (optional, defaults to navbeacon) Launch resource probe Deployable category from which macro will be selected if not supplied (optional, defaults to resourceprobe) Launch satellite Deployable category from which macro will be selected if not supplied (optional, defaults to satellite) Launch drone Unit category from which macro will be selected if not supplied Launch a ship of the specified ship group from masstraffic docks. Will attempt to avoid docks that are in use (e.g. while trading) The drone that was launched as a result (if any) The object launching the drone. Unit category from which the used macro will be selected The target which is to be picked up by the drone (optional, used to determine ideal launch direction) Ware to be transported, used to find best matching macro from shipgroup (optional, ignored if pickup=true) Is this a pickup run? If true, an empty transport ship will be launched (optional, defaults to false) Launch war drones. This uses mass traffic, so both objects need to be stationary for the whole duration. Ensure that you kill the resulting mass traffic network when you're done with it, and wait until it's finished before moving away. The newly created mass traffic network. The object launching the drones. The target which is to be attacked by drones. Must have a nav mesh. The amount of drones to be launched. If undefined, all available units will be used. Launch repair drones. This uses mass traffic, so both objects need to be stationary for the whole duration. Ensure that you kill the resulting mass traffic network when you're done with it, and wait until it's finished before moving away. The ID of the newly created mass traffic network - IMPORTANT: this will become invalid if a savegame is loaded The object launching the drones. The target which is to be repaired by repair drones. Must have a nav mesh. List of components that need to be repaired The amount of drones to be launched. If undefined, all available units will be used. Set the drone armed status for a specific unit category of an object to true or false Set the drone mode for a specific unit category of an object Leave formation as a formation WingMan. No effect if the object is not a formation WingMan Open a menu as part of a conversation, which will be suspended until the menu is closed Name of menu to be opened as part of the conversation First menu parameter Second menu parameter Open a menu Name of menu to be opened First menu parameter Second menu parameter Pick up a target object (connect it to the ship) Ship to which the picked up object will be connected Prepare the pickup process, this makes sure the target stops rotating and is properly aligned for pickup (optional, defaults to false) Sort a list of collectables by price value. Note: Sorting collectables with identical price values will retain their relative order from the input list. Consider shuffling the collectables list first. Collecting object, used to filter out collectables which can't be stored List of collectables Result list of sorted collectables Start playing a cutscene Player interaction event Parameter referenced by the cutscene, must have either object or number attribute Parameter name Reference object Numeric value Show cutscene in target monitor? Sound ID (either a plain name string or a script expression that evaluates to a string - default is no sound) Optional caption text string. May be null. Requires targetmonitor="true". No caption is displayed if caption is null or an empty string. Black letterbox bars at the top/botton, true=enabled, false=disabled (when attribute not present, will default to auto / based on UI) Sets the CutsceneManager into Cinematic Mode. Moves sound listener to cutscene location and allows HUD toggle. Defaults to false. Moves sound camera to cutscene location. Defaults to false. Maximal duration of target monitor cutscene. If supplied, the cutscene will end after the timeout. Requires targetmonitor="true". Name of render target on which the cutscene should be played (ignored for target monitor cutscenes) Whether the cutscene is abortable by the player, default is true (ignored for target monitor cutscenes) Name of the value that will receive the cutscene ID as result. If <play_cutscene> fails the result may be null in some cases. Raise an event to a registered callback in a lua script. Name of the event Optional parameter. Has to be a string, number or component. Removes an account from the object if any, so the object will use the faction's account instead. Optionally the remaining money can be transferred to the faction account. Transfer remaining money to faction account? Defaults to false. Remove NPC actor from the room it is in (e.g. landing platform) and clear room and chair slots where set Should the actor also be destroyed, as if used in combination with <destroy_object>? Default is false (so the actor may continue to exist even after disconnecting, e.g. as MD cue actor). NOTE: Unlike <destroy_object>, using destroy="true" on this action makes sure that the removal of this actor is not delayed but already happens as part of this action. This may be required by subsequent script actions. Using this attribute should be preferred over the combination of <remove_actor_from_room> with <destroy_object> since it makes sure that the removal and destruction happen in the correct order. NOTE: Even if destroy="false" is used or the attribute is omitted, the actor may still be destroyed implicitly as result of being removed from the universe. In order to be able to work with disconnected actors, they should be associated with an MD cue via the MD action <create_cue_actor> (passing an existing actor if necessary). If the actor gets destroyed either way, it is still highly recommended to use destroy="true" to make the action self-documenting (indicating to the reader that the destruction is desired and expected). Remove an object from a group Remove one or all elements from a list that match the specified value or are in the specified range. It is not an error if no matching list element can be found. Note that the list to be updated is provided in the name attribute, not the list attribute. The list attribute can be used for matching values. (In order to remove a single element at a known list index, <remove_value> can be used instead.) If true (default), all matching elements are removed from the list. Set to false to remove only the first matching value Remove the commander of an object Remove faction representative Remove a variable, a userdata value, an element from list or a key from a table. It is not an error if the variable/entry does not exist. Return to caller (supported in AI scripts, as well as MD libraries with purpose="run_actions"). In global interrupts and actions of <on_abort>, <patch> or <editable> elements, this action does not return to the caller and just aborts the current actions in those elements. Named return value (only supported for non-order AI scripts) Return value name Return value Unnamed return value Check whether a NPC can walk do a destination Addional offset to the start position, either the 'start' slot/component or the NPCs position if 'start' was not provided Addional offset to the end slot/component position Object or component slot to start from. Combined with 'start' position. (optional, NPC uses current position if not provided) Object or component slot destination. Combined with 'end' position. Check if the NPC is currently able to move. NPCs can not move if in low attention or are hidden. (defaults to true) The ultimate destination component. Used to judge which surfaces the NPC may be alowed to walk on. (if 'end' is the the destination, this is not necessary) Known floor tags at the destination position. Used to judge which surfaces the NPC may be alowed to walk on. Check whether the weapon is currently active Check whether the weapon is installed/available Request docking procedure for ship, result is true if the request was queued. Check this.ship.assigneddock to see if the request was granted. Whether the ship should be using a high priority dock (e.g. a launchtube), defaults to false (will fall back to the other kind of dock if no matching ones exist) Whether the ship must use a dock that supports building, defaults to false Whether the ship must use a dock that supports trading, defaults to false Whether the ship may also use a dock that only allows the player to dock, defaults to false Whether the ship must use a dock that is only meant for venturing, defaults to false Specific venture platform with which venture dock must be associated (can be null) Request undocking procedure for ship, result is true if the request was queued. If the ship is docked, this is always either granted or queued. Whether the ship should be using a high priority dock (e.g. a launchtube), defaults to false (will fall back to the other kind of dock if no matching ones exist) Whether the ship may also use a dock that only allows the player to dock, defaults to false Whether the ship must use a dock that is exclusively meant for venturing (only applies when ship is coming out of storage), defaults to false Specific venture platform with which venture dock must be associated (can be null) Request this ship to be taken out of internal ship storage, result is true if the request was queued. If the ship is docked, this is always either granted or queued. Whether the ship should be using a high priority dock (e.g. a launchtube), defaults to false (will fall back to the other kind of dock if no matching ones exist) Whether the ship may also use a dock that only allows the player to dock, defaults to false Whether the ship must use a dock that is exclusively meant for venturing (only applies when ship is coming out of storage), defaults to false Specific venture platform with which venture dock must be associated (can be null) Reference object to sort docks by distance and attempt to retrieve a ship on the closest suitable dock (optional) Request that a ship docked at the object be stored away to free up room. Dock object (Container, DockArea or BuildModule) If this ship is not docked at the object, take size and faction from this ship when trying to free up a dock by storing another ship away. (takes precedence over 'size' and 'faction'). If this ship is currently docked at the object, request to store it Dock compatibility size (also requires that faction be defined, ignored if ship is specified) Faction to try and avoid storing a ship for (also requires that size be defined, ignored if ship is specified) Whether the ship should be using a high priority dock (e.g. a launchtube), defaults to false (will fall back to the other kind of dock if no matching ones exist) Whether to ignore interal docking storage capacity, always true when player-controlled ship or ship that is already docked internally is passed as ship attribute, otherwise defaults to false Whether the dock to be freed must support docking, defaults to false Whether the dock to be freed must support undocking, defaults to false Whether the dock to be freed must support building, defaults to false Whether the dock to be freed must support trading, defaults to false Whether the dock to be freed may also be one that only allows the player to dock, defaults to false Whether the dock to be freed must be exclusively meant for venturing (only applies when ship is coming out of storage), defaults to false Specific venture platform with which venture dock must be associated (can be null) Whether the timeout to store a ship after it was retrieved should be ignored, defaults to false Reference object to sort docks by distance and attempt to store away a ship on the closest suitable dock (optional) Remove assigned dock or docking request for ship (the latter only works if the container is specified) Whether the request should be processed immediately (defaults to false). If not instant the assignment will be removed as soon as the ship is at a safe distance, which is defined in the dockingbay macro. Remove undocking request for ship Remove retrieval request for ship Add a quota to a zone's main mass traffic network. Must supply either a macro, a ship group, or a job ID. If no end time is supplied you need to store it and stop the quota when you no longer need it. (optional result) ID of the created quota The station where the mass traffic ships should start The station where the mass traffic ships should end The time the quota should start (defaults to now if not supplied) The time the quota should end (defaults to never if not supplied) Ship group for random macro selection Job ID for random macro selection and ship setup The amount of ships in this quota Make a mass traffic quota stop The time the quota should end at the earliest (defaults to now if not supplied) Get all macros currently active in a zone's main mass traffic network The result list of macros in the network The result list of ship amounts corresponding to each macro in the network Get all units of a category currently active in a mass traffic network The category of units to get Result list with the index being the 'mk' of the unit Request a ship to be spawned in a zone's mass traffic network The station where the mass traffic ship should start The station where the mass traffic ship should end Minimum flight time Ship group for random macro selection (taken from zone's master quota if not supplied) Request boarding support by the player (triggers an MD cue to select a mission) Forced mission type, prevents random selection (see md/BoardingSupport.xml) Request from a ship to lock the gate for going through (Use unlock="true" to unlock) Ship requesting the gate Gate to lock (or unlock if unlock="true") for the ship Unlock the gate for this ship. Safe to perform if not requested before (optional, default is false) Name of the value that will be set to whether or not the gate request was successful Notify the boarder that boarding support by the player failed Notify the boarder that boarding support by the player was successful Notify interested parties that universe generation is complete Create a boarding operation and add it as an inbound operation on the target Threshold value to launch boarding pods (0 - 100) - Actual behaviour of this value depends on the boarding handler Threshold value to begin insertion into the hull (0 - 100) - Actual behaviour of this value depends on the boarding handler Result operation Add an attacker to the boarding operation and configure their behaviour and use of marines Amount of marines by skill level to match against role tiers List of amounts (size must match with other lists) List of skills to help identify people (size must match with other lists) Add an approaching boarding pod to the boarding operation Remove an approaching boarding pod from the boarding operation Inform the boarding operation that an attacker has dispatched a number of marines to board the target (the creation of marines and activation of their AI behaviour is not handled by this action) Amount of marines by skill level to match against role tiers List of amounts (size must match with other lists) List of skills to help identify people (size must match with other lists) List of marine npc templates Object which currently contains the marines Transfer a list of marines from a boarding operation to an object Object to transfer the marines to List of NPC templates List of people successfully transferred from otherobject to object Transfer a marine from an object to the internals of a boarding operation Object containing the marine to transfer Set the status of a marine taking part in a boarding operation Trigger the boarding operation to start, adding AI orders to related ships and firing the 'event_boarding_operation_started' event Force the boarding operation to end, removing it from the target's list of inbound boarding operations Set the phase of the boarding operation Request a component to be repaired (only listened to from scripts) The component to be repaired Whether repairing another component should wait and this one should start immediately Reset relation boost (otherobject or faction attribute required) Reset tolerance boost (otherobject or faction attribute required) Reset turret Turret Resize a list (if the list grows, it will contain new null values at the end) New number of elements Reward the player Money reward Set player influence value New influence value (will be restricted to valid range) Apply change to player influence value Influence value change (can be positive or negative, result will be restricted to valid range) Save the state of the current AI script blocking action on the blackboard of an entity that is going to take over control when restarting a script (can be the same entity). The AI script actions <wait_for_prev_script> and <finalize_prev_script> will process the information to make sure that the current AI action (e.g. trade) ends in a clean way. Entity that will receive the AI action state information. To be used when a new script is supposed to start on the entity, aborting the previous entity's script. The new script should perform <wait_for_prev_script> and <finalize_prev_script>. Entity from which the AI action state information is retrieved, basically immediately before the entity's script is aborted. Assigns an account to the object if the object does not have an own account yet. Tells this object to use the account of otherobject. Optionally can transfer the money in the account to the object supplied as transferto (may be the same as otherobject). If otherobject and transferto are invalid / omitted this behaves like <remove_object_account /> (optional) The object whose account to share, will default to faction account of transferto object if omitted! (optional) The object to which any money in the actors account should be transferred. (money will be lost if omitted) Assigns a max budget to an object Amount max budget is set to Assigns a min budget Amount min budget is set to Reserve the roomslot for this actor Component slot to reserve as the ultimate destination Clear the current roomslot of this actor Set a chair slot as the current chair for this actor (NPC actors only) Component slot to set as the chair slot Clear the current chair of this actor (NPC actors only) Lets the actor walk to the target (as long as the player can watch it) Speed of the character in m/s Component slot to walk to Component slot to reserve as the ultimate destination (NPC's current roomslot cleared if invalid) Trigger the default animations for the destination room slot on the actor when they arrive (defaults to true) Stop the actor's current walk behaviour Start an actor's animation sequence Animation sequence type Animation sequence behavior (if omitted, uses roomslot tags to decide behaviour) Perform a transition to the next sequence (defaults to false) Perform an immediate transition to the next sequence (default is false) Allow blending to the next sequence from the current animation (default is true) Set an actor's emotion morph target Emotion name Clear an actor's emotion morph target Set an actor's lookat target component Target component Clear an actor's lookat target Have an actor touch something with hand Specification tag or list of tags false to use right hand (default), true to use left hand Have an actor untouch something false to use right hand (default), true to use left hand Attach a tool to an actor Tool Name false to use right hand (default), true to use left hand Remove a currently held tool from the actor false to use right hand (default), true to use left hand Transfers amount from one entity to another, if possible Amount to be transferred Resulting amount that was actually transferred Set a buildanchor to the specified buildprocessor Build processor to set the buildanchor of Build anchor to be used Clear the buildanchor of the specified buildprocessor Build processor to clear the buildanchor of Sets the cockpit boarder tint for use in certain activities Frequency as light pulses per second (Requires 'amplitude' to be specified as well. Setting either 'frequency' or 'amplitude' to a value >= 0 will disable the pulse.) Frequency at the end of the activity spoolup as light pulses per second (Requires 'amplitude' and 'frequency' to be specified as well. If not specified, use continuous frequency.) Amplitude fluctuation range for light pulses (Range 0 to 1. Requires 'frequency' to be specified as well. Setting either 'frequency' or 'amplitude' to a value >= 0 will disable the pulse.) Duration is needed if endfrequency is specified to calculate the tint values. Color library color to use instead of r, g and b Resets colors to their default values, can be combined with "sethudcolors", any other attributes are ignored Also set the HUD colors to match (defaults to false, done automatically for mode selection) Set whether a space is exclusive for job ships of its own extension. Affects potential spawn location and jobmainsector/zone selection. The space is considered as exclusive for extension jobs if the exclusivity flag is set on the space itself or any parent space (sector, cluster, galaxy). Set whether the god-system is allowed to act in the specified space. When explicitly allowed or disallowed, this setting supersedes the permission of the parent spaces. Use reset_space_god_allowed to return to the default. Set whether faction logic is allowed to act in the specified space. When explicitly allowed or disallowed, this setting supersedes the permission of the parent spaces. Use reset_space_faction_logic_allowed to return to the default. Set whether the job-system is allowed to use the specified space, primarily affecting ship operating space. When explicitly allowed or disallowed, this setting supersedes the permission of the parent spaces. Use reset_space_job_allowed to return to the default. Set the economy value of the specified space. When explicitly set, this value supersedes the values of the parent spaces. Use reset_space_economy to return to the default. Set the security value of the specified space. When explicitly set, this value supersedes the values of the parent spaces. Use reset_space_security to return to the default. Set the sunlight value of the specified space. When explicitly set, this value supersedes the values of the parent spaces. Use reset_space_sunlight to return to the default. Reset the god-system permissions of the specified space Reset the faction logic permissions of the specified space Reset the job-system permissions of the specified space Reset the job exclusivity by extension permissions of the specified space Reset the economy value of the specified space Reset the security value of the specified space Reset the sunlight value of the specified space Add a location tag to the specified space Remove a location tag from the specified space Set the object to activated or deactivated Activate object? (default is true) Skip to the end of the animation immediately? (default is false) Set licence restriction for access to object or space Licence required to access object or space Clear licence restriction for access to object or space Set the object to be capturable or not. This can happen via a signalleak (S sized, leak exists when capturable and in nearby attention) or via boarding (M+ sized). Additionally, for S-ships the pilot will not eject if it's not capturable Is the object capturable? (default is based on class). The capture signal-leak will be added in the next frame in nearby attention, and removed in the next frame when leaving nearby attention. Set docking at the object to be enabled or not Are any ships allowed to dock at the object? (default is true) Set friend list of a mine that supports this (mine will treat everyone else as foe, regardless of faction relations) The mine whose friend list should be set Faction or list of factions to be set as friends Set foe list of a mine that supports this (mine will treat everyone else as friend, regardless of faction relations) The mine whose foe list should be set Faction or list of factions to be set as foes Clea friend/foe list of a mine that supports this (mine will revert to using faction relations) The mine whose foe list should be cleared Set the object to be visible in the map or in the UI or not Is the object visible? (default is true) Set the object to be forced to be visible in the map or in the UI or not Is the object forced to be visible? (default is true) Set the object to be sellable Is the object sellable? (default is true) Set the commander of an object (use 'remove_object_commander' to remove commander). If 'assignment' nor 'subordinategroupid' is supplied, the object will be added with its default assignment. Object to be the commander (null not allowed) Assignment for this subordinate on the commander. Mutually exclusive with subordinategroupid. Subordinate group ID for this subordinate on the commander. Integer from 1 to 10. (ignored if assignment is supplied) Inform the Fleet Manager system about this assignment? (defaults to true) The Fleet Manager is responsible for remembering the assignments of lost fleet ships and rebuilding them. If true, the manager will drop all references to this object as the in-game situation is now the intended hierarchy. Set the assignment of a commander's subordinate group. Subordinate to be assigned Commander of the subordinate group (null not allowed) Subordinate group ID whose assignment will be changed. Integer from 1 to 10. Assignment to set to specified subordinate group. Set the protected position of a commander's subordinate group if assigned to defend a position. Commander of the subordinate group Subordinate group ID whose assignment will be changed. Integer from 1 to 10. Set the protected sector of a commander's subordinate group if assigned to defend a position. Commander of the subordinate group Subordinate group ID whose assignment will be changed. Integer from 1 to 10. Sector in which subordinate group will operate. Restore the ships position within the fleet's command structure, as best as it can be with the currently existing objects (object or fleetunit must be provided) Controllable to be restored Fleetunit of an existing controllable to be restored Clear build issue flags for the fleetunit Fleetunit of an existing controllable to be restored Set build issue flags for the fleetunit. Flags will be set in addition to any existing build issue flags. Fleetunit of an existing controllable to be restored Build issue flags to set Ware or list of wares of equipment which have been identified as problematic for rebuilding this fleetunit Enable the fleet ship replacement feature to be accessable by the player (can not be disabled) Mark a currently running AI order as failed. If the order is on a player-owned ship, this also creates a failure record in the order system UI. Note: A failure record can persist even after the AI order has ended. Player-visible failure message text (only for orders on player-owned objects) Is the order a recurring queue order, i.e. was it created by a default order which creates this order repeatedly? Default is false. Only one failure record of a recurring queue order exists in the order system UI at any time, so adding this record will clear any previous matching record. Mark a currently running AI order as not failed, if it has previously failed via <set_order_failed>. If there is a failure record for the order in the order system UI, it is removed as well. If the order is a default order, any failure record of a previously running default order on the object is also cleared, no matter if the current default order has failed or not. Note: If the order was restarted after failing, it does not count as failed any more, and a recorded failure from before the restart cannot be removed with this action, except for default orders. Removes the failure record for a failed recurring queue order of the provided order ID from the order system UI, if there is one. In case the matching failed AI order is still currently running, it is marked as not failed. This action has no effect on recorded failures of non-recurring or non-queue orders. Order ID Set the state of a running AI order to the specified state, if the state transition is supported. Explicit state changes with this action are optional. See orderstate documentation in scriptproperties.html. Order state Enter critical state of order script. This requires the order to be in the active state. Enter finish state of order script. This requires the order to be in the active or critical state. Mark the sync point of a running AI order as reached. This action is a requirement for all infinite orders. Once the sync point of such an order is reached, the sync point is ready to be released by a signal, which will terminate the order (<event_object_order_syncpoint_released>). For player orders, the signal behaviour can be controlled in the UI. On queued infinite orders that do not use the sync point signalling system, the sync point is released (the order ends) as soon as the next order is ready in the queue. On default orders, this action only affects the UI display. There is no effect on finite orders. Changes an order parameter, as if edited by the player in the UI. Note that this has side effects for already running orders and can fail in some cases. If the order is in the started state (non-critical), it will be reset and start over. If in the critical state, any <editable> actions will be performed and <event_order_param_edited> will be triggered. You can check with "$order.isparameditable.<param>" whether a param is currently editable. Editing a param fails if: (1) the order is in the critical state and the param has no <editable> node that allows editing, or (2) the order is the default order or in a critical state and the param decides whether the order is infinite (i.e. it has an infinitevalue), or (3) the order is in the finish state. Parameter name as string New parameter value Moves an order to a new position in the order queue (or checks whether moving is possible). Note that this can have side effects for already running orders and can fail in some cases. If the movement changes the first order in the queue that was in the started state (non-critical), the running order will be reset and start over once it reaches the front of the queue. Moving an order fails if: (1) the order is a default order, (2) the newindex value is not a valid index in the order queue, (3) the order is a running order in the critical state or the finish state (except in an order loop), or (4) the movement would replace a running order in the critical state or the finish state (except in an order loop). NOTE: If the order is in an order loop, this action will not affect the currently running order. Moving a running order (at index 1) works, but the order indices will be rotated so that the order remains the current order at index 1. Moving another order to index 1 will actually move it to the last position instead (which is the position right before the current order in the loop). For actually changing the currently running order in a loop, <set_current_loop_order> is required. New index of order within the order queue (moving the order to its current index is allowed and has no effect). In an order loop, the index is relative to the current order, so the current order is always at index 1. Check if moving the order is possible but do not actually move it (defaults to false) Name of the value that will indicate whether the move operation was successful Sets an order in an order loop as the currently executed order. This will rotate the order indices in the loop so that this order appears at index 1. To set a non-loop order as the current order, use <move_order> instead with newindex="1". The <move_order>action may also be necessary for a loop order before performing <set_current_loop_order>, so that, when the new current order is completed, the loop will resume at the same position as before. Setting the current loop order can fail if: (1) the order is a default order or not in an order loop, (2) the order loop has not started yet, i.e. the currently running order is not part of the order loop, or (3) the currently running loop order is in the critical state or the finish state. Check if setting the current loop order is possible, but do not actually set it (defaults to false) Name of the value that will indicate whether the operation was successful Create an AI-controlled sync point that is owned by an AI order. The AI order must be an infinite order in the queue (not a default order), and it may not have entered the critical state or the finish state yet. The sync point is automatically assigned to the owning AI order, and remains assigned as long as the order exists. The sync point is removed completely (including all order assignments) when either the owning order is completed/removed or the sync point gets unassigned from it (see <unassign_order_syncpoint_from_order>). AI order that should become the owner of the sync point Assign a sync point to an AI order. Sync point must have been created previously with <create_order_syncpoint>. The AI order must be an infinite order in the queue (not a default order), and it may not have entered the critical state or the finish state yet. AI order that is the owner of the sync point AI order to which the existing sync point should be assigned Unassign an AI-controlled sync point from an AI order. If the AI order is the owner of the sync point, the sync point is removed completely. Set an object's minimum hull value (percentage) Set an object's minimum shield value (percentage) Set an object's hull value (percentage) Set an object's name (use page and line for full localisation support, including support for saving and loading with a different language - otherwise use name attribute. Note that an object of either class "object" or "space" requires a name on a ship computer voice page when using page and line.) New object name (takes precedence over page and line) Clear an object's name and revert to default Set an object's description (use page and line for full localisation support, including support for saving and loading with a different language - otherwise use description attribute) New object description (takes precedence over page and line) Clear an object's description and revert to default Set a controllable object's fleet name New fleet name (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) Set relation change behaviour for an object when attacked or killed Object Disable relation change? (true = disabled; false = default behaviour) Set signal response behaviour for an object Object Signal ID Response ID Ask? (only applicable to player-owned objects, default is false) Set an object's shield value (percentage) Sets the scanned level of an object to the maximum level of the player's scanner Sets an object to be long range scanned or not If set to false, the long range scan result will be removed (default: true) Sets an object as able to be hacked Should object be hackable? (default is true) Sets an object as hacked If this is a ship or station, all content in the given build stage is set as hacked. If this is a subcomponent, it and *all* content is set as hacked. Duration of the hack The object performing the hacking Name of the value that will receive the list of hacked components Name of the value that will receive the list of ejected drops Sets an object's hidden state, which turns off rendering as well as collisions Should object be hidden? Sets an object's hull to be unrepairable Should object's hull be unrepairable? (default is true) Sets an object's shield to be unrepairable Should object's shield be unrepairable? (default is true) Sets the object's velocity The new linear velocity (linear velocity will not be changed if this is omitted) The new angular velocity (angular velocity will not be changed if this is omitted) If set to true, the object will keep the new velocity indefinitely without accelerating/decelerating. Adds to the object's velocity The new linear velocity (linear velocity will not be changed if this is omitted) The new angular velocity (original angular velocity will not be changed if this is omitted) If set to true, the object will keep the new velocity indefinitely without accelerating/decelerating. Sets whether an object is affected by the forces of effects Is the object affected by the forces? (default is true) Set the unlock state of an object (currently Datavault only) Set the NPC slots in a room to be private and only findable by querying the room directly Are the contained NPC slots private? (default is true) Set the room to be locked or not Is the room locked? (default is true) Set triggers on platforms (e.g. doors and buttons) with optional matching group or tags in the room to be locked or not. Note: Internally this increments/decrements a counter, and only when the counter is 0, the trigger is unlocked! (e.g. when locking twice, means you also need to unlock twice!) Room or Ship Group tag Are the triggers locked? (default is true) How long this lock should last. Unlimited duration if omitted. (optional) Set platform triggers with optional matching group or tags in the room to require certain inventory wares for activation Group tag Specification tag or list of tags The required inventory ware The required inventory ware amount (default is 1) Are the wares consumed on use? If true, there is also an event when the trigger was "unlocked" by the player. (default is false) Whether the object (which can be any destructible subcomponent of an object!) can drop something Whether this setting should be propagated to all child destructibles Sets the drop for the object Drop string identifier (drop is cleared if not supplied) Attempt to spawn an existing ship in a dock (bypassing dock request checks) Spawn the drop defined for the object Drop string identifier (will drop whatever is currently defined in the object if not supplied) Have a drop be instantly collected by an object Have an asteroid be instantly collected by a ship Have a deployable be instantly collected by a ship Have a unit be instantly collected by an object Open the specified lockbox Object that opens the lockbox Lockbox Sets/changes the page of an actor (entity) Sets/changes the type of an actor (entity) Sets/changes the role of an actor (entity) Sets/changes the role of a npc template Clear the role of an actor (entity) Sets/changes the role object of an actor (entity) Clear the role object of an actor (entity) Clear the role of a npc template Set global faction relation Relation boost value The reason for relationship change Reset faction relation to base value in factions.xml Set faction relations to be locked Whether the faction's relations towards others should be able to change Reason why relations cannot change (shown to player, defaults to empty string and player is just told it's not currently possible, use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) Set faction diplomacy to be active Whether diplomacy is active for this faction (defaults to true) Set faction diplomacy to be locked between this faction and another faction Whether diplomacy is locked between this faction and the other faction (defaults to true) Set this dropped objects persistance in the game (setting to false restores the default despawn time) Should object be persistent? (default is true) Set this mass traffic objects persistance in the game Should object be persistent? (default is true) Set this region objects persistance in the game Should object be persistent? (default is true) Set this wrecks persistance in the game (setting to false restores the default despawn time) Should object be persistent? (default is true) Set this mass traffic network's end time. Note that the time will be adjusted so that no ships are underway when the network is removed. The end time (default is the current time) Sets the owner faction of an object (No owner is set if null or not supplied) Set the owner faction of the control entities (defaults to false) Sets the cover owner faction of an object (cover owner is cleared if faction is null or not supplied) Set player activity (mode mission) Set player position in room Set last player docking request to persistent. If persistent, the request will not be cancelled if the player moves too far or takes too long to dock. Docking request will still be cancelled if relations drop to below those that allow docking. Should the player's last docking request be persistent until used? (defaults to true) Trigger a teleport to a object Have the player take control if it is free (defaults to true) Instant teleportation (defaults to false) Allow the teleportation, even if the research criteria is not fulfilled (defaults to false) Activate a transporter to schedule the movement of the contained entities, as well as the entities in the destination transporter Start transporter room slot Destination transporter room slot The entity who is intended to be transported. If not present in the transporter, the action will fail. This entity is also flagged as the 'triggerer' of the transport process. (optional) List of all entities successfully scheduled to move from the start transporter to the destination Set the player emergency eject feature to active/inactive. Active state can be set at any time but may have no effect if the player does not have emergency effect capability (player.hasemergencyeject) or has disabled it in their game options. Set relation boost (otherobject or faction attribute required) Relation boost value The reason for relationship change Set faction representative Entity to be assigned to the sector as faction representative Set the player's current scan target Set skill value to either 'entity' or a npctemplate on 'object' Set the oxygen level (in % of maximum oxygen supply) for specified spacesuit Pause the consumption of oxygen for the specified spacesuit Resume the consumption of oxygen for the specified spacesuit Apply experience to either individual 'entity' or crew aboard 'object' (identified by npctemplate for an individual crew member or role for a group ) Experience (from libraries/experiences.xml) Set the traits of an entity Set the traits of a npc template Set override data for an entity Title override (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) Icon override Glow value (applies to characters with dynamic glow only, given as a float between 0 and 1, default is 1) Set tolerance boost (otherobject or faction attribute required) Tolerance boost value Set allowed weapon systems (weapon system not listed will keep current state) Specifically allow the use of certain weapon types (separated by space) Specifically disallow the use of certain weapon types (separated by space) Optional, set to true to make disallowed weapon systems stop firing immediately (defaults to false, weapons will shoot until they lose their current target) Set trade restrictions for an object and/or faction Define an override for the trade restrictions per ware (only applicable for objects) Affected ware (DEPRECATED) Restriction to only trade ware with own faction. Overrides buy, sell and supply settings. (default: freeforall) Restriction to only buy ware from own faction (default: freeforall, only applied to objects) Restriction to only sell ware to own faction (default: freeforall, only applied to objects) Restriction to only accept supplies from own faction (default: freeforall, only applied to objects) Object for which the restrictions will be set. (object and/or faction must be provided) Faction for which the restrictions will be set. (faction and/or object must be provided) (DEPRECATED) Restriction to only trade with own faction. Overrides buy, sell, supply and build settings. (default: freeforall) Restriction to only buy from own faction (default behaviour: inherit from owner / unrestricted) Restriction to only sell to own faction (default behaviour: inherit from owner / unrestricted) Restriction to only accept supplies from own faction (default behaviour: inherit from owner / unrestricted) Restriction to only build ships for own faction (default behaviour: inherit from owner / unrestricted) Set trade offers to enabled/disabled for the object. Note: Setting enabled to false will cancel any active/planned trade orders for other parties buying/selling at the object but will not affect trade orders of the object itself! Object for which the trade offers will be enabled/disabled. Set the enabled state for trade offers of the object. (defaults to true) Set turret targets Note: this action will not process targets in low attention, but it will set applicable turrets to deployed status Priority target for each turret. If it can't attack, it will choose from the target list If preferredtarget is not provided, clear the existing preferred target (defaults to true) List of target objects for turrets (ignored in low attention) Stop shooting old targets which are not provided in the new target list (defaults to true) Turrets in the specified mode will choose from these targets (defaults to any) Set a variable, userdata, a list element or a table entry to an exact or random value. The operation attribute affects how the value is applied. Set the weapon mode of a weapon or group of weapons. When weaponmode is omitted, it is reset to default. Weapon mode, or null to reset to default Set the current ammo (missile type) for one or more weapons (missile launcher and/or missile turrets). Object (defensible or module) for which weapon ammo should be set (should not be set if weapon and/or group attributes are supplied) Specific individual weapon to set ammo for (should not be set if object attribute is supplied) Group of weapons to set ammo for (should not be set if object attribute is supplied) Set ammo only for weapons of this macro type (with object attribute only, all weapons if omitted) Set ammo only for weapons set to this weapon mode (with object attribute only, all weapons if omitted) Set ammo only for weapons in this weapon group (with object attribute only, missile launchers on defensibles only, all weapon groups if omitted, used in conjuction with primary attribute) Set ammo only for weapons primary/secondary weapon group (with object attribute only, missile launchers on defensibles only, ignored if weapongroup attribute is not supplied, default is primary) Set ammo only for weapons in this connection group (with object attribute only, missile turrets only, all connection group if omitted) Ammo macro to set Set the turret armed status for all turrets of an object to true or false Start shooting a weapon without a target (requires object on visible attention level and a suitable weapon selection) 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. Only weapons/turrets set to the specified mode will shoot at the target, defaults to any. Stop shooting without a target Select between lasers and missile launchers. False for lasers to stop shooting, true for missile launchers to stop shooting. Defaults to false. Stop shooting weapons in active primary weapon group. Defaults to true. Stop shooting weapons in active secondary weapon group. Defaults to true. Only weapons/turrets set to the specified mode will stop shooting, defaults to any. Show text from help text page if it was not shown before (when using line attribute), or show custom text (when using custom attribute) Line (text ID) on help text page. Text will be shown if not shown before, or if force attribute value is true Always show help text? If true, the help is shown even if the help text ID was already used before (ignored when using custom attribute) Custom help text, takes precedence over line attribute Suppress sound effect? Remove display of a help text Set to true to remove all help texts from display queue. Takes precedence over line attribute. Specific line (text ID), or list of lines, to be removed from display queue (removing custom texts specifically is not supported). If attribute is not supplied, the currently displayed hint is removed. Show help text for input function (e.g. INPUT_ACTION_QUICKSAVE or INPUT_STATE_ROLL_LEFT). Keyboard/controller use is detected automatically. Input function name (see inputmap.xml) Show multiple texts from help text page if it was not shown before, or if force attribute value is true Definition of the individual help texts. Line (text ID) on help text page. Defines the text color in the format [r, g, b, a] - default is white Defines whether this line is logged. Is overriden by the log attribute of the show_help_multi action. Default is false Always show help text? If true, the help is shown even if the help text ID was already used before. Default is false. Suppress sound effect? Default is false Position of help text (defined in parameters.xml) - defaults to 0 Add help text to logbook? Overrides individual line settings. Default is false Factor to modify help text width in percent (default is 200, minimum is 50) Whether the player is allowed to close the hint, use with care (default is false) Horizontal alignment of the hint text (default is 'left') Whitelist this help text in menus which normally forbid them (e.g. the options menu) - format 'MenuA MenuB MenuC' Show a help overlay The ID of the help overlay. Only highlight the element (default is false) Show a help overlay The ID of the help overlay to be removed. Set to true to remove all help overlays created by scripts. Takes precedence over id attribute. Show fullscreen overlay texts, e.g. for cutscenes Definition of overlay rows. Definition of overlay cells. Defines which column is used. Defines how many columns this col should span. Defines the text in this cell Defines the text color with a colormap ID (or in the format [r, g, b, a] [legacy]) - default is white Defines the text size in this cell Whether the text is wrapped at the end of the line - default is true Defines whether text should be shown letter by letter - default is false Defines whether and which icon is used in this cell Defines the icon color with a colormap ID (or in the format [r, g, b, a] [legacy]) - default is white Defines the width of the icon Defines the height of the icon Defines the offset of the cell content from the left and right border - defaults to 3 Defines the offset of the cell content from the top and bottom border - defaults to 3 Defines the height of the cell Defines the horizontal alignment of the text/icon - default is left Defines the vertical alignment of the text/icon - default is top Defines the background color with a colormap ID (or in the format [r, g, b, a] [legacy]) - default is transparent Defines a color for flashing text and/or icon with a colormap ID (or in the format [r, g, b, a] [legacy]) - default is white Defines a duration for flashing text and/or icon in seconds - default is 0s Defines the interval for flashing text and/or icon in seconds - default is 1s Defines how much relative offset the row has from the left border (see fromright). If not specified the x offset of the previous row or the global offset is used - defaults to -1.0 Defines how much relative offset the row has from the bottom border (see fromtop). If not specified the y offset below the previous row or the global offset is used - defaults to -1.0 Defines whether reloffsetx is defined from the right or left border - default is false Defines whether reloffsety is defined from the top or bottom border - default is false Defines duration of fade-in Defines duration of fade-out Defines how much relative screen space the overlay uses - defaults to 0.8 Defines how much relative offset the overlay has from the left border - defaults to 0.1 Defines how much relative offset the overlay has from the bottom border - defaults to 0.1 Defines whether reloffsetx is defined from the right or left border - default is false Defines whether reloffsety is defined from the top or bottom border - default is false Remove fullscreen overlay texts Defines whether the overlay is removed without any fade-out - default is false Show a non-interactive notification in the message ticker Maximal duration of notification. If not supplied, the notification will end after a default timeout (currently 5s). The priority, an integer between 0 and 9 (default is 1). Unqueued notifications can only be aborted and replaced by unqueued notifications of same or higher priority, or by cutscenes. The queue for queued notifications is also sorted by priority. NOTE: Non-silent interactive events (notifications and cutscenes with flashing target monitor) are generally treated as having a higher priority than any non-interactive events. Sound ID (either a plain name string or a script expression that evaluates to a string - default is "notification_generic" if omitted or empty) Show an interactive notification in the target monitor Player interaction event Caption text string Maximal duration of notification. If not supplied, the notification will end after a default timeout (currently 5s). The priority, an integer between 0 and 9 (default is 1). Unqueued notifications can only be aborted and replaced by unqueued notifications of same or higher priority, or by cutscenes. The queue for queued notifications is also sorted by priority. NOTE: Non-silent interactive events (notifications and cutscenes with flashing target monitor) are generally treated as having a higher priority than any non-interactive events. Sound ID (either a plain name string or a script expression that evaluates to a string - default is "notification_generic" if omitted or empty) The faction for which the notoriety ladder should be displayed (optional) The object for which the notoriety ladder should be displayed (optional). Takes precedence if both faction and object are supplied. true iff a relation effect (blinking effect in faction bar) should be shown (optional) ID of resulting notification object Stop an interactive notification in the target monitor, or cancel a queued notification before it is started (NOTE: For interactive cutscenes, use <stop_cutscene> instead) Identifier of an interactive notification as returned by <show_interactive_notification> Shuffle components in a group randomly Fixed seed used for shuffling. Auto-advance seed used for shuffling. Shuffle elements of a list randomly Fixed seed used for shuffling. Auto-advance seed used for shuffling. Signal an object and/or a group of objects using param and param2, each object will receive this signal as if it were an event. NOTE: When used in MD without a delay, make sure that the signal does not activate the current cue again (directly or indirectly), which could lead to an infinite recursion. (optional) delay this signal by the specified amount of time Play (speak) text Speech priority. Speeches of lower priority will be interrupted. Default is 0. The priority is capped at 99, since 100 or higher is reserved for conversations. Allow interrupting a speech of the same priority? Default is true. Speech recipient, i.e. the character being spoken to (optional). Pass an NPC if this is a background speech between two NPCs, which affects the voice style of the speech. Default is the player (if omitted or null). Speech topic, i.e. the character being spoken about (optional). Pass an NPC or the player if the person being spoken about may have a grammatical effect on the sentence. Is this a background speech and is the player able to hear this over comm? Note that a speech in background and a speech over comm are two separate properties, and this flag primarily indicates a preference, which can be partially or fully ignored. This flag also allows exceeding the maximum background comm distance as specified in parameters.xml. - If the player is the speaker or this is a broadcast, the speech is always in foreground. - If a recipient is specified, the speech is in background depending on whether the recipient is an NPC or the player. - If the speech is in background and the recipient is in hearing range of the speaker, the speech will be over comm only if backgroundcomm is enabled and the player is not within hearing range. (Otherwise it is assumed that the player is required to be close to the speaker to hear the speech.) Is this a broadcast speech of an entity to a group of people over comm? This implies background speech, but may cause a different comm filter to be applied. Default is false. Is this a voiceover speech in a cinematic scene? The entity will speak with maximal volume even if not near the player. Default is false. Check for errors resolving an object name or description? Default is true Interrupt an actor's current speak Any current speech of this priority or lower will be interrupted. Start engine booster Start a conversation on this actor Optional parameter that is passed to <event_conversation_started>. Can be of any data type. Type that affects how the conversation is started Default conversation type Unqueued conversation (start conversation only if there is no conversation already running) Take over a previous conversation. When using this type, the player does not automatically return to the default position when the previous conversation ends. Priority of conversation for the case of multiple simultaneous requests (min=0, max=100, default=0) Cancel an active conversation (if providing a conversation actor, the conversation is only cancelled if the actor matches) Optional conversation name. If supplied then the conversation is only aborted if the conversation name matches. Should conversation be aborted even if Escape was explicitly disabled via <allow_conversation_escape>? Cancels all existing AI orders in the object's order queue Cancels an AI order and removes it from the owner object's order queue. NOTE: If the order is in the critical state, it will not be cancelled. Instead, a <event_object_order_cancelled> will be sent with immediate="false", which is a request that may or may not be handled by the order script (see documentation of orderstate.critical). In case of a cancelled loop order, keep the cancelled order in the loop instead of removing it? This only has an effect if the order is part of an order loop and is not temporary. Any other order is not affected by the attribute and will be removed anyway. This attribute is useful for cancelling the current order, for the purpose of finishing its execution in a safe way and proceeding to the next order. Starts a long range scan for the object Stops a long range scan for the object Start an AI script, aborting previously running scripts AI script parameter Parameter name Parameter value Script name Stop engine booster Stop a running cutscene, or cancel a queued targetmonitor cutscene before it is started Stop firing at a specific target Turret in the specified mode will stop shooting at the target(s), defaults to any. Read converted text string from TextDB, including support for variant text (for non-variant text use readtext property or the short notation {123,456} directly) Speaker of the line (optional). Pass an NPC or the player if the person speaking may have a grammatical effect on the sentence. Recipient of the line, i.e. the character being spoken to (optional). Pass an NPC or the player if the person being spoken to may have a grammatical effect on the sentence. Topic of the line, i.e. the character being spoken about (optional). Pass an NPC or the player if the person being spoken about may have a grammatical effect on the sentence. Fallback text string for testing during development, used when text id is not found. Suppress error output in case the text does not exist? Default is false Name of the value that will receive the result text. Search in a text for sub-strings and substitutes them Definition of a sub-string in the text and a replacement string. All occurrences of the sub-string will be replaced. Sub-string which is expected to occur in the text New text which will replace the occurrences of the sub-string Name of the value that will receive the result text. If source is not supplied then this value is also used as text source. Source text. If not supplied, the text attribute is used instead. Trigger an autosave Trigger a boarding process via an MD cue, including mission guidance for the player The marine commander that controls the boarding operation The target object to be boarded The boarder faction, which is trying to take ownership of the target (default is the player faction) Undock ship Sets the state of the ship's dockingbay to 'undocking' Resets the state of the ship's dockingbay from 'undocking'. Has no effect if the current state is different. Move a ship from an internal dock to a specified dock, if free Receives true if the retrieval from storage was successfully initiated, otherwise false. The dockingbay to move the ship to (must be of the same object as the ship's storing object) Unlock an achievement (no effect if it was already unlocked) Achievement name Can the achievement be unlocked in a scenario gamestart? Default is false Indicate achievement progress (no effect if it was already unlocked). This does not unlock the achievement when max progress is reached (100%), use <unlock_achievement> instead in this case. Achievement name Integer value of current progress Integer value of maximal progress Initiate a trade between an object and the player's primary ship. Returns true if the trade was successfully initiated, otherwise false. The trade to be initiated. Optionally, override the amount of the ware to be traded (This could have changed since the deal was made). Update certain parameters of a trade The trade to update New amount for the trade (optional, should already be adjusted to be the amount we can afford) New desiredamount for the trade (optional, how much we *really* want, ignoring financial constraints) New price (per unit) for the trade (optional) Get the credit value of an object Object of which to base resource prices. Takes precedence over 'pricetable' Table of resource wares with the buy price Calculate the sell price of the object? Default is false Retrieve the dockslot that a pilot entity is currently using for docking. NOTE: This action is not supposed to be used normally, it only exists for fixing a bug that appears in early game versions. Pilot Warp object to different location Zone to warp to (take precedence from sector) Sector to warp the object in using position in the sector space. Creates a tempzone if a zone does not exist at the coordinates Sort components in a group by a provided criterion Suppress error if group contains components that cannot be sorted, e.g. disconnected or unreachable objects? Such members remain in the group but will be placed at the end. Sort elements in a list either by their values or by a provided criterion Optionally sort values by a sort criterion provided by this script expression, which is evaluated for each element and can access the current value and index via 'loop.element' and 'loop.index', respectively Should the values be sorted in descending order (from highest to lowest)? Sort trade list. Note: Sorting trades with identical sort values will retain their relative order from the input list. Consider shuffling the trade list first. List of trades to sort Reference object to sort trades by distances or offeramounts (required for sorter="distance", optional for sorter="offeramount" or sorter="offervolume") Sort people list. Note: Sorting people with identical sort values will retain their relative order from the input list. Consider shuffling the templatelist first. List of NPC templates to sort Skill to sort by (required for sorter="skill", ignored otherwise) Post to sort for potential skill by (required for sorter="potentialskillforpost", ignored otherwise) Role to sort for potential skill by (required for sorter="potentialskillforrole", ignored otherwise) Add experience progress points Set experience progress points Add an effect object. If the effect's duration is infinite (value of -1), you need to remove it yourself with remove_effect. Should state change effects be applied to the object? (default is false) Object to attach the effect to Effect definition (from libraries/effects.xml) Effect strength factor (default is 1.0) Remove an existing effect object. Object the effect is attached to Effect definition (from libraries/effects.xml) Flicker the lights of an object Object to flicker the lights on (not propagating to sub-components) Brightness of the lights in between flickers (0.0 to 1.0, default is 0.5) Base brightness factor for the flickering light (0.0 to 1.0, default is 'base') Range of the flickering around the 'strength' value (0.0 to 1.0, default is 0.2) Duration for the flickering Base interval for the flickering (default is 0.02, i.e. 1/50th second, variance is fixed at 50%) Fade in duration back to normal brightness (default is 0.2s) Have the fade occur before the end of the flicker 'duration', otherwise after (defaults to false) Play a sound. Does not support looping sounds yet. Object to act as the sound source (required unless type="ui" is specified) Sound ID (from libraries/sound_library.xml) Sound type (default is "effect" - NOTE: The player can adjust the volume for each sound type individually in the settings) Effect sound UI sound (NOTE: The sound source object is ignored in this case) Ambient sound Play a music track, interrupting regular music handling for the duration. An infinitely repeating track (where the 'repeat' property of its entry in libraries/sound_library.xml is negative) must be aborted manually by calling <stop_music>. Sound ID of music track (from libraries/sound_library.xml) This is a looping track and I will take care of calling <stop_music> (default:false, must correspond to the 'repeat' property of the music track in libraries/sound_library.xml, if it's negative this must be true, otherwise this must be false). Stop a manually started music track Activate/deactivate ambient sounds Set ambient sounds to active (defaults to true) Override an object's default sound. Currently only room ambient sounds are supported. Object to set override for Sound type (default is "ambient") Ambient sound Sound ID (from libraries/sound_library.xml, uses default if not supplied) Sound volume factor (0.0 to 1.0, 1.0 if not supplied) Clear an object's override sound. Currently only room ambient sounds are supported. Object to clear override for Sound type (default is "ambient") Ambient sound Write an entry into the logbook Logbook entry text, either a single string with possible line breaks, or a list of strings in notification format (see <show_notification>). When using the notification format and both left and right columns of a row contain text, the texts will be concatenated with a single space as separator, if no custom separator is provided in the separator attribute. Separator to be used between left and right texts of a notification row, in case the notification format is used in the text attribute (default is a single space) Interaction object, depending on the interaction type Interaction position, depending on the interaction type Logbook entry title Optional source entity for logbook entry (either a real entity, in which case the entity name will be used, or an arbitrary name as text) Optional source faction logbook entry (either a real faction, in which case the faction name will be used, or an arbitrary name as text) Optional amount of money associated with the logbook entry (if not supplied, or 0, then will not be shown in the logbook) Optional bonus amount of money associated with the logbook entry (if not supplied, or 0, then will not be shown in the logbook) Optional flag specifying whether the logbook entry should be highlighted. Write a message that is received by the player Cutscene data to be passed to UI when message is displayed Optional cutscene parameter Message source, either a string or an object. If an object is provided, the message will be deleted automatically in case the source object is killed. Message title Message text High priority message? Interaction object, depending on the interaction type Should the message be auto-deleted when the interaction object is destroyed? Default is false. (NOTE: This flag only refers to the interaction object. The autodelete handling for a supplied source object is not adjustable.) Interaction position, depending on the interaction type Should the message already be marked as read by the player? Default is false. ID of the incoming message Remove a message ID of the to-be-removed message Add permanent player subscription to trade offer updates of the specified object. This also immediately adds the current trade offers to the trade memory. How long this subscription is valid for. Unlimited duration if omitted. (optional) Remove permanent player subscription to trade offer updates of the specified object. Offers remain known as long as live view coverage exists. Forget that there ever was information about trade offers at the specified object (defaults to false) Store a snapshot of the current trade offers on the specified object in the player trade memory. Add an entry to the encyclopedia (blueprints and spaces are not supported) Encyclopedia entry type (must be used together with item attribute, cannot be used together with value attribute) Encyclopedia entry item ID (must be used together with type attribute, cannot be used together with value attribute) Value from which encyclopedia type and item are derived (cannot be used together with type and item attributes) Remove an entry from the encyclopedia (blueprints and spaces are not supported) Encyclopedia entry type (must be used together with item attribute, cannot be used together with value attribute) Encyclopedia entry item ID (must be used together with type attribute, cannot be used together with value attribute) Value from which encyclopedia type and item are derived (cannot be used together with type and item attributes) Set whether an object is to be presented in the encyclopdia as a special object (only supported for script spawned objects) Produce an error message if the object can not have its encyclopedia visibility changed (defaults to false) Add blueprints to player's blueprint library Ware or list of wares for which to add blueprints (can be combined with macros and object in a single call) Macro or list of macros for which to add blueprints (can be combined with wares and object in a single call) Object (station or ship) for which to add blueprints (can be combined with wares and macros in a single call) Production method for blueprint(s) (will be the same for all added blueprints, uses default method if not supplied) Cycle efficiency for blueprint(s) (will be the same for all added blueprints, uses 1.0 if not supplied) Resource efficiency for blueprint(s) (will be the same for all added blueprints, uses 1.0 if not supplied) Product efficiency for blueprint(s) (will be the same for all added blueprints, uses 1.0 if not supplied) Include blueprints for modules (used only with object attribute, default is true) Include blueprints for equipment in specific loadout elements (used only with object attribute, default is all loadout elements) Start playership autopilot to the selected destination (follow for moving targets) Whether gates and superhighways not known to the player may be used (defaults to false) Stop playership autopilot Toggle time warp (SETA). NOTE: Activation requires that SETA is in the player's inventory and the activation conditions are met. For example, SETA is not possible during a conversation. Activate a platform trigger (e.g. a button or certain doors) True if the activation succeeded or is not necessary, false if it failed (this can happen if the deactivating animation is currently running; wait a short time and retry) Deactivate a platform trigger (e.g. a button or certain doors) True if the deactivation succeeded or is not necessary, false if it failed (this can happen if the activating animation is currently running; wait a short time and retry) Patch an object based on its macro, to add components that may be missing when loading a savegame. This action is only required by extensions and should normally only be used when loading a savegame in which the extension was not active yet. The script is responsible for finding the objects, usually ships or stations, that need patching. Finds objects with given filter criteria and patches them based on their macro (see <patch_macro>) Space in which to find objects to be patched. The galaxy is used if no space is supplied. Installs the given software on object. If the software is not compatible with object this will fail silently! Uninstalls the given software (and all previous versions) from object. If the software to be uninstalled (or any of its previous versions) are part of the default software, these will remain installed! Uninstalls all newer versions of software from object. If any of the software versions about to be removed are part of the default software, they will remain installed! Set the throttle value of the playership. Value for throttle setting between full reverse (-1) and full forward (1) Add inventory to a given entity using the entity's stock ID, as defined in the character definition. The entity that should receive some stock. Set the stock entry the given entity should use The entity that gets the stock reference. The stock reference. Add clothing mod to an NPC or the player The NPC or player that should receive clothing mod. Clothing mod ware (from clothingmods.xml, defines a quality level and visual properties of a clothing mod) Set time warp factor (game time that passes during a real-time second, 1.0s if not in time warp) Time warp factor (value will be limited to between 0.1 and 6.0, resets to default value if not supplied) Add workforce of the specified race to a given object. (will not add more than can fit, see $container.workforce.{$race}.capacity) Remove workforce of the specified race from a given object. Create and add a region The region definition (from libraries/region_definitions.xml) The newly added region Add a scenario stat to be shown in the debriefing menu The ID string for this stat, must be unique inside a scenario The name of this stat for display in the UI, preferably as a text ID string The value of this stat, formatted for display in the UI (omit if you don't want to show a numerical score and progress bar, also needs score if this is set) The description, shown as a tooltip - useful to explain how the score is calculated if it's not completely obvious This stat's contribution to the total score - can be negative (omit if you don't want to show a numerical score and progress bar, also needs uivalue if this is set) The "maximum" value for this stat's score (it's allowed to exceed it, the UI will show that state correctly) - if not set, the maximum value will be the total score required to reach 5 stars Define an absolute list of equipment wares that should be available for construction, ignoring any defaults for the object owners' faction (only applies to objects with build modules such as shipyards or equipment docks). Can not be combined with included or excluded lists and will clear those. Define equipment wares from the default equipment for the object owners' faction that should not be available for construction (only applies to objects with build modules such as shipyards or equipment docks). Define equipment wares outside the default equipment for the object owners' faction that should be available for construction regardless (only applies to objects with build modules such as shipyards or equipment docks). Define an absolute list of ship wares that should be available for construction, ignoring any defaults for the object owners' faction (only applies to objects with build modules such as shipyards or equipment docks). Can not be combined with included or excluded lists and will clear those. Define ship wares from the default ships for the object owners' faction that should not be available for construction (only applies to objects with build modules such as shipyards or equipment docks). Define ship wares outside the default ships for the object owners' faction that should be available for construction regardless (only applies to objects with build modules such as shipyards or equipment docks). Report that the object had an encounter which should be tracked and submitted to the server as potentially relevant for transmission to original owner. Will fail silently if the object does not originate from another universe. Creates a trade computer entity on the specified object that will attempt to perform the first trade order in the current order queue, provided the tradepartner is the container the object is currently docked at. After completion of the order the trade computer will remove itself. (see orders.base.tradecomputer) The trade computer entity, if one was created. Estimate the time it takes to fly to a target location (takes highways and travel mode into account). Either the ship, the ship macro or all engine parameters have to be supplied. Start position relative to the start component. Target position relative to the target component. The ship from which to get the engine parameters. This cannot be used in conjunction with the macro attribute. Engine parameters can be provided individually to override the ship values. If neither ship nor macro are provided, all engine parameters must be defined. A ship macro from which to get the engine parameters. This cannot be used in conjunction with the ship attribute. A custom loadout with an engine macro can be provided in the loadout attribute, otherwise a default loadout is required to exist for this macro. Engine parameters can be provided individually to override the macro values. If neither ship nor macro are provided, all engine parameters must be defined. Custom loadout with an engine macro to provide engine parameters. This can only be used together with the macro attribute, and it has no effect when the ship attribute is provided. If a ship macro is provided without this attribute, the default loadout is required to exist and will be used to get the engine parameters. Whether local highways are to be included in time estimations. The maximum forward speed without using boost or travel mode. The travel drive's thrust factor. Multiplies the forward speed. The time it takes to charge travel mode. The time it takes to reach maximum travel speed after charging has finished. The estimated travel time (or a negative time value if no path exists). Result estimated length of the path (or negative length if no path exists). Set a production module to be manually paused or resume production if it has been manually paused before. (see also .ispausedmanually property) ProductionModule which should be paused/unpaused. Pause the production if it is not already manually paused. (defaults to true) Fades the screen to black and back to normal. The duration over which the screen should fade out, in seconds. (must be non-negative) The duration over which the screen should fade in, in seconds. (must be non-negative) The time at which the fade out should start. (defaults to the current time) The duration over which the screen should remain faded. (defaults to zero seconds) Color to fade to (defaults to black) Perform fade in realtime (ignore game paused state). Cannot be used together with starttime Blurs the screen to a certain strength over time. The blur value at the end of the interpolation duration (1.0 is maximum blur) The duration of the interpolation period from the current blur value to the specified 'strength' The duration over which the screen should remain blured. (defaults to indefinite) Muffles the sound to a certain strength over time. The muffle strength at the end of the interpolation duration (1.0 is maximum muffling, 0.0 is no muffling) The duration of the interpolation period from the current muffling value to the specified 'strength' Suppresses the display of control mode messages, no matter whether or not they're enabled in the user config. Resets the display of control mode messages to what has been configured by the user. Forces the use of adaptive steering, no matter whether or not it's enabled in the user config. Resets the use of adaptive steering to what has been configured by the user. Sets a userdata value. The value to set the userdata value to. Removes a userdata value. Initialises the terraforming data in this cluster. The template part name of the world Tells the cluster that a terraforming mission for it has been activated. Mission cue Tells the cluster that its terraforming mission has been completed. Tells the cluster that its terraforming mission has been deactivated. Adds a new terraforming project. Optional ID postfix, must be used when adding multiple projects based on the same library entry. Removes a terraforming project. The ID of the project. Changes the properties of a previously added terraforming project. Adds a new terraforming event. Removes a terraforming event. The ID of the event. Sets a terraforming stat to the given value. The value to set the stat to. Removes a terraforming stat - it will no longer be displayed or be an effect or condition projects. Renames all planets and moons in the cluster that don't have unique names of their own and use the cluster's name plus a letter. Use this after renaming a cluster if you want the planet names to match. Sets a planet's atmosphere text in the encyclopedia. The template part name of the world Sets a planet's geology text in the encyclopedia. The template part name of the world Sets a planet's name text in the encyclopedia. The template part name of the world Sets a planet's population text and amount in the encyclopedia. If you just want to display the number use page 1042 and line 10021. The template part name of the world The new population amount. Only shown if the population text contains the '$POPULATION$' placeholder. If omitted the number is not changed. Sets a planet's settlements text in the encyclopedia. The template part name of the world Make a claim on an object to tow (also related to dismantle/tow claims from other object) Clear the tow target of a ship, releasing its claim on the target object The object set to be towed Makes a ship start towing an object (sets connection, arms ship's tug weapons and gives the towed object a special movement controller) Makes a ship stop towing an object (removes connection, disarms ship's tug weapons and resets the towed object's movement controller; no effect if nothing is being towed) Checks whether a recyclable object can be processed in a processing module Processing module The trade(offer or deal) associated with selling recyclables to a station with a processing module. Will receive true if processing is possible, otherwise false Starts processing a recyclable object in a processing module Processing module The trade(offer or deal) associated with selling recyclables to a station with a processing module. Will receive true if processing was successful, otherwise false Starts an animation phase on an object Phase ID Sets a time-based density profile for certain fields in a region. Region Profile source object (must have a valid Phase setup for this to work) Override the default build method used on an object (e.g. for ship construction or assembling drones). If the chosen method is not available for an item the default method will be used. Build method to use (if possible) Clear any build method override on an object, the object will revert to inheriting the default settings. Clear the fog of war in a radius around a given position. Does not reveal any objects. The reference position in sector coordinates. The sector in which to reveal the fog of war. The revealed radius. Disables combat alarms for a time. The time in seconds that combat alarms will be disabled. Sound volume factor (0.0 to 1.0, 1.0 if not supplied) Sound volume factor (0.0 to 1.0, 1.0 if not supplied) Sound volume factor (0.0 to 1.0, 1.0 if not supplied) Sets a TextDisplay object's text string Text to be displayed on the object (use format '{page,line}' as string for full localisation support, including support for saving and loading with a different language) Forces an object's travel mode to activate, skipping the charge time and optionally the acceleration time Whether the ship should be instantly set to maximum travel speed (defaults to true) Warps an object's entire wingmen hierarchy to their respective formation positions, optionally setting speeds to match as well Whether the entire formation, including the leader, should be set to the speed of the slowest member (defaults to false) Reloads all envmap probes on the given object. WARNING: This is very expensive! Use with caution and sparingly! Makes an object transit through a jumpgate, anomaly or highway gate Can be a jumpgate, anomaly or highway gate Attach a component to an interior (for internal use only) Suitable macro of class positional Interor to attach to (must be of class room or navcontext) Set amount override for buying a ware (ignored if ware is not bought) Amount (must be positive) Remove amount override for buying a ware Set amount override for selling a ware (ignored if ware is not sold) Amount (must be positive) Remove amount override for selling a ware Add a request for access to the object's gravidar access to be granted to the player Remove a request for access to the object's gravidar access to be granted to the player