Scripting functions

This page explains all the functions mentioned in the scripting.html file, including their syntax, remarks on their use and common errors modders may encounter when they use them.

Script Output - FSO v3.6.13 (FS2_Open Scripting)

Conditional Hooks

Conditions

State
Campaign
Mission
Object Type
Ship
Ship class
Ship type
Weapon class
KeyPress
Version
Application
- Usually: $Application: FS2_Open

Actions

On Game Init
On Splash Screen
On State Start
On Frame
On Key Pressed
On Key Released
On Mouse Moved
On Mouse Pressed
On Mouse Released
On State End
On Mission Start
On HUD Draw
On Ship Collision
On Weapon Collision
On Debris Collision
On Asteroid Collision
On Object Render
On Warp In
On Warp Out
On Death
On Mission End
On Weapon Delete
On Weapon Equipped
On Weapon Fired
On Weapon Selected
On Weapon Deselected
On Gameplay Start
On Turret Fired
On Primary Fire
On Secondary Fire

Types

vector

Vector object

number [] x,y,z or 1-3

Vector component
Returns: Value at index, or 0 if vector handle is invalid

vector + number/vector

Adds vector by another vector, or adds all axes by value
Returns: Final vector, or null vector if error occurs

vector - number/vector

Subtracts vector from another vector, or subtracts all axes by value
Returns: Final vector, or null vector if error occurs

vector * number/vector

Scales vector object (Multiplies all axes by number), or multiplies each axes by the other vector's axes.
Returns: Final vector, or null vector if error occurs

vector / number/vector

Scales vector object (Divide all axes by number), or divides each axes by the dividing vector's axes.
Returns: Final vector, or null vector if error occurs

string (string)

Converts a vector to string with format "(x,y,z)"
Returns: Vector as string, or empty string if handle is invalid

orientation getOrientation()

Returns orientation object representing the direction of the vector. Does not require vector to be normalized.
Returns: Orientation object, or null orientation object if handle is invalid

number getMagnitude()

Returns the magnitude of a vector (Total regardless of direction)
Returns: Magnitude of vector, or 0 if handle is invalid

number getDistance(Vector)

Distance
Returns: Returns distance from another vector

number getDotProduct(vector OtherVector)

Returns dot product of vector object with vector argument
Returns: Dot product, or 0 if a handle is invalid

vector getCrossProduct(vector OtherVector)

Returns cross product of vector object with vector argument
Returns: Cross product, or null vector if a handle is invalid

number,number getScreenCoords()

Gets screen cordinates of a world vector
Returns: X (number), Y (number), or false if off-screen

vector getNormalized()

Returns a normalized version of the vector
Returns: Normalized Vector, or NIL if invalid

orientation

Orientation matrix object

               number [] p,b,h or 1-9
                   Orientation component - pitch, bank, heading, or index into 3x3 matrix (1-9)
                   Returns: Number at the specified index, or 0 if index is invalid.

               orientation * orientation
                   Multiplies two matrix objects)
                   Returns: matrix, or empty matrix if unsuccessful

               string (string)
                   Converts a matrix to a string with format "[r1c1 r2c1 r3c1 | r1c2 r2c2 r3c2| r1c3 r2c3 r3c3]"
                   Returns: Formatted string or "

               orientation getInterpolated(orientation Final, number Factor)
                   Returns orientation that has been interpolated to Final by Factor (0.0-1.0)
                   Returns: Interpolated orientation, or null orientation on failure

               orientation getTranspose()
                   Returns a transpose version of the specified orientation
                   Returns: Transpose matrix, or null orientation on failure

               vector rotateVector(vector Input)
                   Returns rotated version of given vector
                   Returns: Rotated vector, or empty vector on error

               vector unrotateVector(vector Input)
                   Returns unrotated version of given vector
                   Returns: Unrotated vector, or empty vector on error

enumeration

Enumeration object

               enumeration = enumeration
                   Sets enumeration to specified value (if it is not a global
                   Returns: enumeration

               string (string)
                   Returns enumeration name
                   Returns: Enumeration name, or "" if invalid

event

Mission event handle

               string Name = string
                   Mission event name
                   Value: (null)

               string DirectiveText = string
                   Directive text
                   Value: (null)

               string DirectiveKeypressText = string
                   Raw directive keypress text, as seen in FRED.
                   Value: (null)

               number Interval = number
                   Time for event to repeat (in seconds)
                   Value: Repeat time, or 0 if invalid handle

               number ObjectCount = number
                   Number of objects left for event
                   Value: Repeat count, or 0 if invalid handle

               number RepeatCount = number
                   Event repeat count
                   Value: Repeat count, or 0 if invalid handle

               number Score = number
                   Event score
                   Value: Event score, or 0 if invalid handle

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

file

File handle

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

               nil close()
                   Instantly closes file and invalidates all file handles
                   Returns: Nothing

               boolean flush()
                   Flushes file buffer to disk.
                   Returns: True for success, false on failure

               string getPath()
                   Determines path of the given file
                   Returns: Path string of the file handle, or an empty string if it doesn't have one, or the handle is invalid

               number or string, ... read(number or string, ...)
                   Reads part of or all of a file, depending on arguments passed. Based on basic Lua file:read function.Returns nil when the end of the file is reached.

                       * "*n" - Reads a number.
                       * "*a" - Reads the rest of the file and returns it as a string.
                       * "*l" - Reads a line. Skips the end of line markers.
                       * (number) - Reads given number of characters, then returns them as a string.

                   Returns: Requested data, or nil if the function fails

               number seek([string Whence="cur", number Offset=0])
                 # Changes position of file, or gets location.Whence can be:"set" - File start.
                 # "cur" - Current position in file.
                 # "end" - File end.
                   Returns: new offset, or false or nil on failure

               number write(string or number, ...)
                   Writes a series of Lua strings or numbers to the current file.
                   Returns: Number of items successfully written.

font

font handle

               string (string)
                   Filename of font
                   Returns: Font filename, or an empty string if the handle is invalid

               string Filename = string
                   Filename of font (including extension)
                   Value: (null)

               number Height = number
                   Height of font (in pixels)
                   Value: Font height, or 0 if the handle is invalid

               boolean isValid()
                   True if valid, false or nil if not
                   Returns: Detects whether handle is valid

gameevent

Game event

               string (string)
                   Game event name
                   Returns: Game event name, or empty string if handle is invalid

               string Name = string
                   Game event name
                   Value: Game event name, or empty string if handle is invalid

gamestate

Game state

string (string)

Game state name
Value: Game state name, or empty string if handle is invalid

string Name = string

Game state name
Value: Game state name, or empty string if handle is invalid

HudGauge

HUD Gauge handle

string Name = string

Custom HUD Gauge name
Returns: Custom HUD Gauge name, or nil if handle is invalid

string Text = string

Custom HUD Gauge text
Returns: Value: Custom HUD Gauge text, or nil if handle is invalid

eyepoint

Eyepoint handle

               vector Normal = vector
                   Eyepoint normal
                   Value: Eyepoint normal, or null vector if handle is invalid

               vector Position = vector
                   Eyepoint location (Local vector)
                   Value: Eyepoint location, or null vector if handle is invalid

               boolean IsValid()
                   Detect whether this handle is valid
                   Returns: true if valid false otherwise

model

3D Model (POF) handle

               modeltextures_h Textures = modeltextures_h
                   Model textures
                   Value: Model textures, or an invalid modeltextures handle if the model handle is invalid

               thrusters Thrusters = thrusters
                   Model thrusters
                   Value: Thrusters of the model or invalid handle

               eyepoints Eyepoints = eyepoints
                   Model eyepoints
                   Value: Array of eyepoints or invalid handle on error

               vector BoundingBoxMax = vector
                   Model bounding box maximum
                   Value: Model bounding box, or an empty vector if the handle is invalid

               vector BoundingBoxMin = vector
                   Model bounding box minimum
                   Value: Model bounding box, or an empty vector if the handle is invalid

               string Filename = string
                   Model filename
                   Value: Model filename, or an empty string if the handle is invalid

               number Mass = number
                   Model mass
                   Value: Model mass, or 0 if the model handle is invalid

               orientation MomentOfInertia = orientation
                   Model moment of inertia
                   Value: Moment of Inertia matrix or identity matrix if invalid

               number Radius = number
                   Model radius (Used for collision & culling detection)
                   Value: Model Radius or 0 if invalid

               boolean isValid()
                   True if valid, false or nil if not
                   Returns: Detects whether handle is valid

modeltextures_h

Array of materials

               number #
                   Number of textures on model
                   Returns: Number of model textures

               texture [] texture
                   number Index/string TextureName
                   Returns: Model textures, or invalid modeltextures handle if model handle is invalid

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

eyepoints

Array of model eye points

               number #
                   Gets the number of eyepoints on this model
                   Returns: Number of eyepoints on this model or 0 on error

               eyepoint [] eyepoint
                   Gets en eyepoint handle
                   Returns: eye handle or invalid handle on error

               boolean isValid()
                   Detects whether handle is valid or not
                   Returns: true if valid false otherwise

thrusters

The thrusters of a model

               number #
                   Number of thruster banks on the model
                   Returns: Number of thrusterbanks

               thrusterbank [] number Index
                   Array of all thrusterbanks on this thruster
                   Returns: Handle to the thrusterbank or invalid handle if index is invalid

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

thrusterbank

A model thrusterbank

               number #
                   Number of thrusters on this thrusterbank
                   Returns: Number of thrusters on this bank or 0 if handle is invalid

               glowpoint [] number Index
                   Array of glowpoint
                   Returns: Glowpoint, or invalid glowpoint handle on failure

               boolean isValid()
                   Detectes if this handle is valid
                   Returns: true if this handle is valid, false otherwise

glowpoint

A model glowpoint

               vector Position
                   The (local) vector to the position of the glowpoint

               number Radius
                   The radius of the glowpoint

               boolean isValid()
                   Returns wether this handle is valid or not
                   Returns: True if handle is valid, false otherwise

order

order handle

               boolean remove()
                   Removes the given order from the ship's priority queue.
                   Returns: True if order was successfully removed, otherwise false or nil.

shiporders

Ship orders

               number #
                   Number of textures on ship
                   Returns: Number of textures on ship, or 0 if handle is invalid

               order [] number Index/string TextureFilename
                   Array of ship orders
                   Returns: Order, or invalid texture handle on failure

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

physics

Physics handle

               number AfterburnerAccelerationTime = number
                   Afterburner acceleration time
                   Value: Afterburner acceleration time, or 0 if handle is invalid

               vector AfterburnerVelocityMax = vector
                   Afterburner max velocity (Local vector)
                   Value: Afterburner max velocity, or null vector if handle is invalid

               number BankingConstant = number
                   Banking constant
                   Value: Banking constant, or 0 if handle is invalid

               number ForwardAccelerationTime = number
                   Forward acceleration time
                   Value: Forward acceleration time, or 0 if handle is invalid

               number ForwardDecelerationTime = number
                   Forward deceleration time
                   Value: Forward decleration time, or 0 if handle is invalid

               number ForwardThrust = number
                   Forward thrust amount (0-1), used primarily for thruster graphics
                   Value: Forward thrust, or 0 if handle is invalid

               number Mass = number
                   Object mass
                   Value: Object mass, or 0 if handle is invalid

               vector RotationalVelocity = vector
                   Rotational velocity (Local vector)
                   Value: Rotational velocity, or null vector if handle is invalid

               number RotationalVelocityDamping = number
                   Rotational damping, ie derivative of rotational speed
                   Value: Rotational damping, or 0 if handle is invalid

               number RotationalVelocityDesired = lvector
                   Desired rotational velocity
                   Value: Desired rotational velocity, or 0 if handle is invalid

               vector RotationalVelocityMax = vector
                   Maximum rotational velocity (Local vector)
                   Value: Maximum rotational velocity, or null vector if handle is invalid

               number ShockwaveShakeAmplitude = number
                   How much shaking from shockwaves is applied to object
                   Value: Shockwave shake amplitude, or 0 if handle is invalid

               number SideThrust = number
                   Side thrust amount (0-1), used primarily for thruster graphics
                   Value: Side thrust amount, or 0 if handle is invalid

               number SlideAccelerationTime = number
                   Time to accelerate to maximum slide velocity
                   Value: Sliding acceleration time, or 0 if handle is invalid

               number SlideDecelerationTime = number
                   Time to decelerate from maximum slide speed
                   Value: Sliding deceleration time, or 0 if handle is invalid

               vector Velocity = vector
                   Object world velocity (World vector)
                   Value: Object velocity, or null vector if handle is invalid

               vector VelocityDesired = vector
                   Desired velocity (World vector)
                   Value: Desired velocity, or null vector if handle is invalid

               vector VelocityMax = vector
                   Object max local velocity (Local vector)
                   Value: Maximum velocity, or null vector if handle is invalid

               number VerticalThrust = number
                   Vertical thrust amount (0-1), used primarily for thruster graphics
                   Value: Vertical thrust amount, or 0 if handle is invalid

               boolean AfterburnerActive = boolean
                   Specifies if the afterburner is active or not
                   Value: true if afterburner is active false otherwise

               boolean isValid()
                   True if valid, false or nil if not
                   Returns: Detects whether handle is valid

               number getSpeed()
                   Gets total speed as of last frame
                   Returns: Total speed, or 0 if handle is invalid

               number getForwardSpeed()
                   Gets total speed in the ship's 'forward' direction as of last frame
                   Returns: Total forward speed, or 0 if handle is invalid

               boolean isAfterburnerActive()
                   True if Afterburners are on, false or nil if not
                   Returns: Detects whether afterburner is active

               boolean isGliding()
                   True if glide mode is on, false or nil if not
                   Returns: Detects if ship is gliding

sexpvariable

SEXP Variable handle

               enumeration Persistence = enumeration
                   SEXP Variable persistance, uses SEXPVAR_*_PERSISTENT enumerations
                   Value: SEXPVAR_*_PERSISTENT enumeration, or invalid numeration if handle is invalid

               enumeration Type = enumeration
                   SEXP Variable type, uses SEXPVAR_TYPE_* enumerations
                   Value: SEXPVAR_TYPE_* enumeration, or invalid numeration if handle is invalid

               string Value = number/string
                   SEXP variable value
                   Value: SEXP variable contents, or nil if the variable is of an invalid type or the handle is invalid

               string (string)
                   Returns SEXP name
                   Returns: SEXP name, or empty string if handle is invalid

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

               boolean delete()
                   Deletes a SEXP Variable
                   Returns: True if successful, false if the handle is invalid

shields

Shields handle

               number [] enumeration/number
                   Gets or sets shield quadrant strength. Use "SHIELD_*" enumeration or 1-4 for a specific quadrant, or NONE for the entire shield
                   Returns: Quadrant/shield strength, or 0 if handle is invalid

               number CombinedLeft = number
                   Total shield hitpoints left (for all quadrants combined)
                   Value: Combined shield strength, or 0 if handle is invalid

               number CombinedMax = number
                   Maximum shield hitpoints (for all quadrants combined)
                   Value: Combined maximum shield strength, or 0 if handle is invalid

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

shiptype

Ship type handle

               string Name = string
                   Ship type name
                   Value: Ship type name, or empty string if handle is invalid

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

species

Species handle

               string Name = string
                   Species name
                   Value: Species name, or empty string if handle is invalid

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

team

Team handle

               boolean == team, team
                   Checks whether two teams are the same team
                   Returns: true if equal

               string Name = string
                   Team name
                   Value: Team name, or empty string if handle is invalid

               number, number, number getColor()
                   Gets the IFF color of the specified Team
                   Returns: rgb color for the specified team or nil if invalid

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

texture

Texture handle

               nil __gc
                   Auto-deletes texture
                   Returns: Nothing

               boolean == texture, texture
                   Checks if two texture handles refer to the same texture
                   Returns: True if textures are equal

               texture [] number
                   Returns texture handle to specified frame number in current texture's animation.This means that [1] will always return the first frame in an animation, no matter what frame an animation is.You cannot change a texture animation frame.
                   Returns: Texture handle, or invalid texture handle if index is invalid

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

               nil unload()
                   Unloads a texture from memory
                   Returns: Nothing

               string getFilename()
                   Returns filename for texture
                   Returns: Filename, or empty string if handle is invalid

               number getWidth()
                   Gets texture width
                   Returns: Texture width, or 0 if handle is invalid

               number getHeight()
                   Gets texture height
                   Returns: Texture height, or 0 if handle is invalid

               number getFPS()
                   Gets frames-per-second of texture
                   Returns: Texture FPS, or 0 if handle is invalid

               number getFramesLeft()
                   Gets number of frames left, from handle's position in animation
                   Returns: Frames left, or 0 if handle is invalid

material

Texture map, including diffuse, glow, and specular textures

               texture BaseMap = texture
                   Base texture
                   Value: Base texture, or invalid texture handle if material handle is invalid

               texture GlowMap = texture
                   Glow texture
                   Value: Glow texture, or invalid texture handle if material handle is invalid

               texture SpecularMap = texture
                   Specular texture
                   Value: Texture handle, or invalid texture handle if material handle is invalid

weaponclass

Weapon class handle

               string (string)
                   Weapon class name
                   Returns: Weapon class name, or an empty string if handle is invalid

               string Name = string
                   Weapon class name
                   Value: Weapon class name, or empty string if handle is invalid

               string Title = string
                   Weapon class title
                   Value: Weapon class title, or empty string if handle is invalid

               string Description = string
                   Weapon class description string
                   Value: Description string, or empty string if handle is invalid

               string TechTitle = string
                   Weapon class tech title
                   Value: Tech title, or empty string if handle is invalid

               string TechAnimationFilename = string
                   Weapon class animation filename
                   Value: Filename, or empty string if handle is invalid

               string TechDescription = string
                   Weapon class tech description string
                   Value: Description string, or empty string if handle is invalid

               model Model = model
                   Model
                   Value: Weapon class model, or invalid model handle if weaponclass handle is invalid

               number ArmorFactor = number
                   Amount of weapon damage applied to ship hull (0-1.0)
                   Value: Armor factor, or empty string if handle is invalid

               number Damage = number
                   Amount of damage that weapon deals
                   Value: Damage amount, or 0 if handle is invalid

               number FireWait = number
                   Weapon fire wait (cooldown time) in seconds
                   Value: Fire wait time, or 0 if handle is invalid

               number FreeFlightTime = number
                   The time the weapon will fly before turing onto its target
                   Value: Free flight time or emty string if invalid

               number LifeMax = number
                   Life of weapon in seconds
                   Value: Life of weapon, or 0 if handle is invalid

               number Range = number
                   Range of weapon in meters
                   Value: Weapon Range, or 0 if handle is invalid

               number Mass = number
                   Weapon mass
                   Value: Weapon mass, or 0 if handle is invalid

               number ShieldFactor = number
                   Amount of weapon damage applied to ship shields (0-1.0)
                   Value: Shield damage factor, or 0 if handle is invalid

               number SubsystemFactor = number
                   Amount of weapon damage applied to ship subsystems (0-1.0)
                   Value: Subsystem damage factor, or 0 if handle is invalid

               number TargetLOD = number
                   LOD used for weapon model in the targeting computer
                   Value: LOD number, or 0 if handle is invalid

               number Speed = number
                   Weapon max speed, aka $Velocity in weapons.tbl
                   Value: Weapon speed, or 0 if handle is invalid

               boolean Bomb = boolean
                   Is weapon class flagged as bomb
                   Value: New flag

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

               number getWeaponClassIndex()
                   Gets the index value of the weapon class
                   Returns: index value of the weapon class

               boolean isLaser()
                   Return true if the weapon is a laser (this includes balistic primaries)
                   Returns: true if the weapon is a laser, false otherwise

               boolean isMissile()
                   Return true if the weapon is a missile
                   Returns: true if the weapon is a missile, false otherwise

               boolean isBeam()
                   Return true if the weapon is a beam
                   Returns: true if the weapon is a beam, false otherwise

collision info

Information about a collision

               nil __gc
                   Removes the allocated reference of this handle
                   Returns: Nothing

               model Model = model
                   The model this collision info is about
                   Value: The model

               number getCollisionDistance()
                   The distance to the closest collision point
                   Returns: distance or -1 on error

               vector getCollisionPoint([boolean local])
                   The collision point of this information (local to the object if boolean is set to true)
                   Returns: The collision point or nil of none

               vector getCollisionNormal([boolean local])
                   The collision normal of this information (local to object if boolean is set to true)
                   Returns: The collision normal or nil of none

               boolean isValid()
                   Detects if this handle is valid
                   Returns: true if valid false otherwise

object

Object handle

               boolean == object, object
                   Checks whether two object handles are for the same object
                   Returns: True if equal, false if not or a handle is invalid

               string (string)
                   Returns name of object (if any)
                   Returns: Object name, or empty string if handle is invalid

               object Parent = object
                   Parent of the object. Value may also be a deriviative of the 'object' class, such as 'ship'.
                   Value: Parent handle, or invalid handle if object is invalid

               vector Position = vector
                   Object world position (World vector)
                   Value: World position, or null vector if handle is invalid

               vector LastPosition = vector
                   Object world position as of last frame (World vector)
                   Value: World position, or null vector if handle is invalid

               orientation Orientation = orientation
                   Object world orientation (World orientation)
                   Value: Orientation, or null orientation if handle is invalid

               orientation LastOrientation = orientation
                   Object world orientation as of last frame (World orientation)
                   Value: Orientation, or null orientation if handle is invalid

               physics Physics = physics
                   Physics data used to move ship between frames
                   Value: Physics data, or invalid physics handle if object handle is invalid

               number HitpointsLeft = number
                   Hitpoints an object has left
                   Value: Hitpoints left, or 0 if handle is invalid

               shields Shields = shields
                   Shields
                   Value: Shields handle, or invalid shields handle if object handle is invalid

               number getSignature()
                   Gets the object's unique signature
                   Returns: Returns the objects unique numeric signature, or -1 if invalid. useful for creating a metadata sytem

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

               string getBreedName()
                   Gets object type
                   Returns: Object type name, or empty string if handle is invalid

               number CollisionGroups = number
                   Collision group data
                   Value: Current collision group signature. NOTE: This is a bitfield, NOT a normal number.

               vector getfvec([boolean normalize])
                   Returns the objects' current fvec.
                   Returns: Objects' forward vector, or nil if invalid. If called with a true argument, vector will be normalized.

               vector getuvec([boolean normalize])
                   Returns the objects' current uvec.
                   Returns: Objects' up vector, or nil if invalid. If called with a true argument, vector will be normalized.

               vector getrvec([boolean normalize])
                   Returns the objects' current rvec.
                   Returns: Objects' rvec, or nil if invalid. If called with a true argument, vector will be normalized.

               vector, collision info checkRayCollision(vector Start Point, vector End Point, [boolean Local])
                   Checks the collisions between the polygons of the current object and a ray
                   Returns: World collision point (local if boolean is set to true) and the specific collsision info, nil if no collisions

asteroid:object

Asteroid handle

               object Target = object
                   Asteroid target object; may be object derivative, such as ship.
                   Value: Target object, or invalid handle if asteroid handle is invalid

               boolean kill([ship killer=nil, wvector hitpos=nil])
                   Kills the asteroid. Set "killer" to designate a specific ship as having been the killer, and "hitpos" to specify the world position of the hit location; if nil, the asteroid center is used.
                   Returns: True if successful, false or nil otherwise

shipclass

Ship class handle

               string (string)
                   Ship class name
                   Returns: Ship class name, or an empty string if handle is invalid

               string Name = string
                   Ship class name
                   Value: Ship class name, or an empty string if handle is invalid

               string ShortName = string
                   Ship class short name
                   Value: Ship short name, or empty string if handle is invalid

               string TypeString = string
                   Ship class type string
                   Value: Type string, or empty string if handle is invalid

               string ManeuverabilityString = string
                   Ship class maneuverability string
                   Value: Maneuverability string, or empty string if handle is invalid

               string ArmorString = string
                   Ship class armor string
                   Value: Armor string, or empty string if handle is invalid

               string ManufacturerString = string
                   Ship class manufacturer
                   Value: Manufacturer, or empty string if handle is invalid

               string Description = string
                   Ship class description
                   Value: Description, or empty string if handle is invalid

               string TechDescription = string
                   Ship class tech description
                   Value: Tech description, or empty string if handle is invalid

               number AfterburnerFuelMax = number
                   Afterburner fuel capacity
                   Value: Afterburner capacity, or 0 if handle is invalid

               number CountermeasuresMax = number
                   Maximum number of countermeasures the ship can carry
                   Value: Countermeasure capacity, or 0 if handle is invalid

               model Model = model
                   Model
                   Value: Ship class model, or invalid model handle if shipclass handle is invalid

               model CockpitModel = model
                   Model used for first-person cockpit
                   Value: Cockpit model

               number HitpointsMax = number
                   Ship class hitpoints
                   Value: Hitpoints, or 0 if handle is invalid

               species Species = Species
                   Ship class species
                   Value: Ship class species, or invalid species handle if shipclass handle is invalid

               shiptype Type = shiptype
                   Ship class type
                   Value: Ship type, or invalid handle if shipclass handle is invalid

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

               boolean isInTechroom()
                   Gets whether or not the ship class is available in the techroom
                   Returns: Whether ship has been revealed in the techroom, false if handle is invalid

               boolean renderTechModel(X1, Y1, X2, Y2, [Rotation %, Pitch %, Bank %, Zoom multiplier])
                   Draws ship model as if in techroom
                   Returns: Whether ship was rendered

               boolean renderTechModel2(X1, Y1, X2, Y2, orientation Orientation=null, [Zoom multiplier])
                   Draws ship model as if in techroom
                   Returns: Whether ship was rendered

               boolean isModelLoaded([boolean Load = false])
                   Checks if the model used for this shipclass is loaded or not and optionally loads the model, which might be a slow operation.
                   Returns: If the model is loaded or not

               number getShipClassIndex()
                   Gets the index valus of the ship class
                   Returns: index value of the ship class

debris:object

Debris handle

               boolean IsHull = boolean
                   Whether or not debris is a piece of hull
                   Value: Whether debris is a hull fragment, or false if handle is invalid

               shipclass OriginClass = shipclass
                   The shipclass of the ship this debris originates from
                   Value: The shipclass of the ship that created this debris

               number getDebrisRadius()
                   The radius of this debris piece
                   Returns: The radius of this debris piece or -1 if invalid

               boolean isValid()
                   Return if this debris handle is valid
                   Returns: true if valid false otherwise

waypoint:object

waypoint handle

waypointlist

waypointlist handle

               waypoint [] number Index
                   Array of waypoints that are part of the waypoint list
                   Returns: Waypoint, or invalid handle if the index or waypointlist handle is invalid

               number #
                   Number of waypoints in the list. Note that the value returned cannot be relied on for more than one frame.
                   Returns: Number of waypoints in the list, or 0 if handle is invalid

               string Name = string
                   Name of WaypointList
                   Value: Waypointlist name, or empty string if handle is invalid

weaponbank

Ship/subystem weapons bank handle

               weaponclass WeaponClass = weaponclass
                   Class of weapon mounted in the bank
                   Value: Weapon class, or an invalid weaponclass handle if bank handle is invalid

               number AmmoLeft = number
                   Ammo left for the current bank
                   Value: Ammo left, or 0 if handle is invalid

               number AmmoMax = number
                   Maximum ammo for the current bank
                   Value: Ammo capacity, or 0 if handle is invalid

               boolean Armed = boolean
                   Weapon armed status. Does not take linking into account.
                   Value: True if armed, false if unarmed or handle is invalid

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

weaponbanktype

Ship/subsystem weapons bank type handle

               weaponbank [] number Index
                   Array of weapon banks
                   Returns: Weapon bank, or invalid handle on failure

               boolean Linked = boolean
                   Whether bank is in linked or unlinked fire mode (Primary-only)
                   Value: Link status, or false if handle is invalid

               boolean DualFire = boolean
                   Whether bank is in dual fire mode (Secondary-only)
                   Value: Dual fire status, or false if handle is invalid

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

               number #
                   Number of weapons in the mounted bank
                   Returns: Number of bank weapons, or 0 if handle is invalid

subsystem

Ship subsystem handle

               string (string)
                   Returns name of subsystem
                   Returns: Subsystem name, or empty string if handle is invalid

               string ArmorClass = string
                   Current Armor class
                   Value: Armor class name, or empty string if none is set

               number AWACSIntensity = number
                   Subsystem AWACS intensity
                   Value: AWACS intensity, or 0 if handle is invalid

               number AWACSRadius = number
                   Subsystem AWACS radius
                   Value: AWACS radius, or 0 if handle is invalid

               orientation Orientation = orientation
                   Orientation of subobject or turret base
                   Value: Subsystem orientation, or null orientation if handle is invalid

               orientation GunOrientation = orientation
                   Orientation of turret gun
                   Value: Gun orientation, or null orientation if handle is invalid

               number HitpointsLeft = number
                   Subsystem hitpoints left
                   Value: Hitpoints left, or 0 if handle is invalid. Setting a value of 0 will disable it - set a value of -1 or lower to actually blow it up.

               number HitpointsMax = number
                   Subsystem hitpoints max
                   Value: Max hitpoints, or 0 if handle is invalid

               vector Position = vector
                   Subsystem position with regards to main ship (Local Vector)
                   Value: Subsystem position, or null vector if subsystem handle is invalid

               vector GunPosition = vector
                   Subsystem gun position with regards to main ship (Local vector)
                   Value: Gun position, or null vector if subsystem handle is invalid

               string Name = string
                   Subsystem name
                   Value: Subsystem name, or an empty string if handle is invalid

               string getModelName()
                   Returns the original name of the subsystem in the model file
                   Returns: name or empty string on error

               weaponbanktype PrimaryBanks = weaponbanktype
                   Array of primary weapon banks
                   Value: Primary banks, or invalid weaponbanktype handle if subsystem handle is invalid

               weaponbanktype SecondaryBanks = weaponbanktype
                   Array of secondary weapon banks
                   Value: Secondary banks, or invalid weaponbanktype handle if subsystem handle is invalid

               object Target = object
                   Object targetted by this subsystem. If used to set a new target, AI targeting will be switched off.
                   Value: Targeted object, or invalid object handle if subsystem handle is invalid

               boolean TurretResets = boolean
                   Specifies wether this turrets resets after a certain time of inactivity
                   Value: true if turret resets, false otherwise

               number TurretResetDelay = number
                   The time (in milliseconds) after that the turret resets itself
                   Value: Reset delay

               number TurnRate = number
                   The turn rate
                   Value: Turnrate or -1 on error

               boolean TurretLocked = boolean
                   Whether the turret is locked. Setting to true locks the turret, setting to false frees it.
                   Value: True if turret is locked, false otherwise

               number NextFireTimestamp = number
                   The next time the turret may attempt to fire
                   Value: Mission time (seconds) or -1 on error

               boolean targetingOverride(boolean)
                   If set to true, AI targeting for this turret is switched off. If set to false, the AI will take over again.
                   Returns: Returns true if successful, false otherwise

               boolean hasFired()
                   Determine if a subsystem has fired
                   Returns: true if if fired, false if not fired, or nil if invalid. resets fired flag when called.

               boolean isTurret()
                   Determines if this subsystem is a turret
                   Returns: true if subsystem is turret, false otherwise or nil on error

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

               nil fireWeapon([Turret weapon index = 1, Flak range = 100])
                   Fires weapon on turret
                   Returns: Nothing

               boolean rotateTurret(vector Pos[, boolean reset=false)
                   Rotates the turret to face Pos or resets the turret to its original state
                   Returns: true on success false otherwise

               vector getTurretHeading()
                   Returns the turrets forward vector
                   Returns: Returns a normalized version of the forward vector or null vector on error

               number, number, number getFOVs()
                   Returns current turrets FOVs
                   Returns: Standard FOV, maximum barrel elevation, turret base fov.

               matrix getTurretMatrix()
                   Returns current subsystems turret matrix
                   Returns: Turret matrix.

shiptextures

Ship textures handle

               number #
                   Number of textures on ship
                   Returns: Number of textures on ship, or 0 if handle is invalid

               texture [] number Index/string TextureFilename
                   Array of ship textures
                   Returns: Texture, or invalid texture handle on failure

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

ship:object

Ship handle

               subsystem [] string Name/number Index
                   Array of ship subsystems
                   Returns: Subsystem handle, or invalid subsystem handle if index or ship handle is invalid

               number #
                   Number of subsystems on ship
                   Returns: Subsystem number, or 0 if handle is invalid

               string ShieldArmorClass = string
                   Current Armor class of the ships' shield
                   Value: Armor class name, or empty string if none is set

               string ArmorClass = string
                   Current Armor class
                   Value: Armor class name, or empty string if none is set

               string Name = string
                   Ship name
                   Value: Ship name, or empty string if handle is invalid

               number AfterburnerFuelLeft = number
                   Afterburner fuel left
                   Value: Afterburner fuel left, or 0 if handle is invalid

               number AfterburnerFuelMax = number
                   Afterburner fuel capacity
                   Value: Afterburner fuel capacity, or 0 if handle is invalid

               shipclass Class = shipclass
                   Ship class
                   Value: Ship class, or invalid shipclass handle if ship handle is invalid

               number CountermeasuresLeft = number
                   Number of countermeasures left
                   Value: Countermeasures left, or 0 if ship handle is invalid

               weaponclass CountermeasureClass = weaponclass
                   Weapon class mounted on this ship's countermeasure point
                   Value: Countermeasure hardpoint weapon class, or invalid weaponclass handle if no countermeasure class or ship handle is invalid

               number HitpointsMax = number
                   Total hitpoints
                   Value: Ship maximum hitpoints, or 0 if handle is invalid

               number WeaponEnergyLeft = number
                   Current weapon energy reserves
                   Value: Ship current weapon energy reserve level, or 0 if invalid

               number WeaponEnergyMax = number
                   Maximum weapon energy
                   Value: Ship maximum weapon energy reserve level, or 0 if invalid

               boolean PrimaryTriggerDown = boolean
                   Determines if primary trigger is pressed or not
                   Value: True if pressed, false if not, nil if ship handle is invalid

               weaponbanktype PrimaryBanks = weaponbanktype
                   Array of primary weapon banks
                   Value: Primary weapon banks, or invalid weaponbanktype handle if ship handle is invalid

               weaponbanktype SecondaryBanks = weaponbanktype
                   Array of secondary weapon banks
                   Value: Secondary weapon banks, or invalid weaponbanktype handle if ship handle is invalid

               weaponbanktype TertiaryBanks = weaponbanktype
                   Array of tertiary weapon banks
                   Value: Tertiary weapon banks, or invalid weaponbanktype handle if ship handle is invalid

               object Target = object
                   Target of ship. Value may also be a deriviative of the 'object' class, such as 'ship'.
                   Value: Target object, or invalid object handle if no target or ship handle is invalid

               subsystem TargetSubsystem = subsystem
                   Target subsystem of ship.
                   Value: Target subsystem, or invalid subsystem handle if no target or ship handle is invalid

               team Team = team
                   Ship's team
                   Value: Ship team, or invalid team handle if ship handle is invalid

               shiptextures Textures = shiptextures
                   Gets ship textures
                   Value: Ship textures, or invalid shiptextures handle if ship handle is invalid

               boolean FlagAffectedByGravity = boolean
                   Checks for the "affected-by-gravity" flag
                   Value: True if flag is set, false if flag is not set and nil on error

               boolean Disabled = boolean
                   The disabled state of this ship
                   Value: true if ship is diabled, false otherwise

               boolean kill([object Killer])
                   Kills the ship. Set "Killer" to the ship you are killing to self-destruct
                   Returns: True if successful, false or nil otherwise

               boolean addShipEffect(string name, int duration (in milliseconds))
                   Activates an effect for this ship. Effect names are defined in Post_processing.tbl, and need to be implemented in the main shader. This functions analogous to the ship-effect sexp. NOTE: only one effect can be active at any time, adding new effects will override effects already in progress. 
                   Returns: Returns true if the effect was successfully added, false otherwise

               number hasShipExploded()
                   Checks if the ship explosion event has already happened
                   Returns: Returns 1 if first explosion timestamp is passed, 2 if second is passed, 0 otherwise

               boolean fireCountermeasure()
                   Launches a countermeasure from the ship
                   Returns: Whether countermeasure was launched or not

               number firePrimary()
                   Fires ship primary bank(s)
                   Returns: Number of primary banks fired

               number fireSecondary()
                   Fires ship secondary bank(s)
                   Returns: Number of secondary banks fired

               number getAnimationDoneTime(number Type, number Subtype)
                   Gets time that animation will be done
                   Returns: Time (seconds), or 0 if ship handle is invalid

               boolean clearOrders()
                   Clears a ship's orders list
                   Returns: True if successful, otherwise false or nil

               boolean giveOrder(enumeration Order, [object Target=nil, subsystem TargetSubsystem=nil, number Priority=1.0])
                   Uses the goal code to execute orders
                   Returns: True if order was given, otherwise false or nil

               boolean doManeuver(number Duration, number Heading, number Pitch, number Bank, boolean Force Rotation, number Vertical, number Horizontal, number Forward, boolean Force Movement)
                   Sets ship maneuver over the defined time period
                   Returns: True if maneuver order was given, otherwise false or nil

               boolean triggerAnimation(string Type, [number Subtype, boolean Forwards])
                   Triggers an animation. Type is the string name of the animation type, Subtype is the subtype number, such as weapon bank #, and Forwards is boolean.
                   IMPORTANT: Function is in testing and should not be used with official mod releases
                   Returns: True if successful, false or nil otherwise

               boolean warpIn()
                   Warps ship in
                   Returns: True if successful, or nil if ship handle is invalid

               boolean warpOut()
                   Warps ship out
                   Returns: True if successful, or nil if ship handle is invalid

               boolean isWarpingIn()
                   Checks if ship is warping in
                   Returns: True if the ship is warping in, false or nil otherwise

               number getEMP()
                   Returns the current emp effect strength acting on the object
                   Returns: Current EMP effect strength or NIL if object is invalid

               number getTimeUntilExplosion()
                   Returns the time in seconds until the ship explodes
                   Returns: Time until explosion or -1, if invalid handle or ship isn't exploding

weapon:object

Weapon handle

               weaponclass Class = weaponclass
                   Weapon's class
                   Value: Weapon class, or invalid weaponclass handle if weapon handle is invalid

               boolean DestroyedByWeapon = boolean
                   Whether weapon was destroyed by another weapon
                   Value: True if weapon was destroyed by another weapon, false if weapon was destroyed by another object or if weapon handle is invalid

               number LifeLeft = number
                   Weapon life left (in seconds)
                   Value: Life left (seconds) or 0 if weapon handle is invalid

               number FlakDetonationRange = number
                   Range at which flak will detonate (meters)
                   Value: Detonation range (meters) or 0 if weapon handle is invalid

               object Target = object
                   Target of weapon. Value may also be a deriviative of the 'object' class, such as 'ship'.
                   Value: Weapon target, or invalid object handle if weapon handle is invalid

               subsystem ParentTurret = subsystem
                   Turret which fired this weapon.
                   Value: Turret subsystem handle, or an invalid handle if the weapon not fired from a turret

               object HomingObject = object
                   Object that weapon will home in on. Value may also be a deriviative of the 'object' class, such as 'ship'
                   Value: Object that weapon is homing in on, or an invalid object handle if weapon is not homing or the weapon handle is invalid

               vector HomingPosition = vector
                   Position that weapon will home in on (World vector)
                   Value: Homing point, or null vector if weapon handle is invalid

               subsystem HomingSubsystem = subsystem
                   Subsystem that weapon will home in on.
                   Value: Homing subsystem, or invalid subsystem handle if weapon is not homing or weapon handle is invalid

               team Team = team
                   Weapon's team
                   Value: Weapon team, or invalid team handle if weapon handle is invalid

               boolean isArmed([boolean Hit target])
                   Checks if the weapon is armed.
                   Returns: boolean value of the weapon arming status

               collision info getCollisionInformation()
                   Returns the collision information for this weapon
                   Returns: The collision information or invalid handle if none

beam:object

Beam handle

               weaponclass Class = weaponclass
                   Weapon's class
                   Value: Weapon class, or invalid weaponclass handle if beam handle is invalid

               vector LastShot = vector
                   End point of the beam
                   Value: vector or null vector if beam handle is not valid

               vector LastStart = vector
                   Start point of the beam
                   Value: vector or null vector if beam handle is not valid

               object Target = object
                   Target of beam. Value may also be a deriviative of the 'object' class, such as 'ship'.
                   Value: Beam target, or invalid object handle if beam handle is invalid

               subsystem TargetSubsystem = subsystem
                   Subsystem that beam is targeting.
                   Value: Target subsystem, or invalid subsystem handle if beam handle is invalid

               object ParentShip = object
                   Parent of the beam.
                   Value: Beam parent, or invalid object handle if beam handle is invalid

               subsystem ParentSubsystem = subsystem
                   Subsystem that beam is fired from.
                   Value: Parent subsystem, or invalid subsystem handle if beam handle is invalid

               number getCollisionCount()
                   Get the number of collisions in frame.
                   Returns: Number of beam collisions

               vector getCollisionPosition(number)
                   Get the position of the defined collision.
                   Returns: World vector

               collision info getCollisionInformation(number)
                   Get the collision information of the specified collision
                   Returns: handle to information or invalid handle on error

               object getCollisionObject(number)
                   Get the target of the defined collision.
                   Returns: Object the beam collided with

               boolean isExitCollision(number)
                   Checks if the defined collision was exit collision.
                   Returns: True if the collision was exit collision, false if entry, nil otherwise

               vector getStartDirectionInfo()
                   Gets the start information about the direction. The vector is a normalized vector from LastStart showing the start direction of a slashing beam
                   Returns: The start direction or null vector if invalid

               vector getEndDirectionInfo()
                   Gets the end information about the direction. The vector is a normalized vector from LastStart showing the end direction of a slashing beam
                   Returns: The start direction or null vector if invalid

wing

Wing handle

               ship [] number Index
                   Array of ships in the wing
                   Returns: Ship handle, or invalid ship handle if index is invawing handle is invalid

               number #
                   Number of wings in mission
                   Returns: Number of wings in mission

player

Player handle

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

               string getName()
                   Gets current player name
                   Returns: Player name, or empty string if handle is invalid

               string getCampaignFilename()
                   Gets current player campaign filename
                   Returns: Campaign name, or empty string if handle is invalid

               string getImageFilename()
                   Gets current player image filename
                   Returns: Player image filename, or empty string if handle is invalid

               number getMainHall()
                   Gets player's main hall number
                   Returns: Main hall index, or 1 if handle is invalid

               string getSquadronName()
                   Gets current player squad name
                   Returns: Squadron name, or empty string if handle is invalid

camera

Camera handle

               string (string)
                   Camera name
                   Returns: Camera name, or an empty string if handle is invalid

               boolean isValid()
                   True if valid, false or nil if not
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

               string Name = string
                   New camera name
                   Value: Camera name

               number FOV = number
                   New camera FOV (in radians)
                   Value: Camera FOV (in radians)

               orientation Orientation = orientation
                   New camera orientation
                   Value: Camera orientation

               vector Position = vector
                   New camera position
                   Value: Camera position

               object Self = object
                   New mount object
                   Value: Camera object

               subsystem SelfSubsystem = subsystem
                   New mount object subsystem
                   Value: Subsystem that the camera is mounted on

               object Target = object
                   New target object
                   Value: Camera target object

               subsystem TargetSubsystem = subsystem
                   New target subsystem
                   Value: Subsystem that the camera is pointed at

               boolean setFOV([number FOV, number Zoom Time, number Zoom Acceleration Time, number Zoom deceleration Time])
                   Sets camera FOV
                   FOV is the final field of view, in radians, of the camera.
                   Zoom Time is the total time to take zooming in or out.
                   Acceleration Time is the total time it should take the camera to get up to full zoom speed.
                   Deceleration Time is the total time it should take the camera to slow down from full zoom speed.
                   Returns: true if successful, false or nil otherwise

               boolean setOrientation([world orientation Orientation, number Rotation Time, number Acceleration Time, number Deceleration time])
                   Sets camera orientation and velocity data.
                   Orientation is the final orientation for the camera, after it has finished moving. If not specified, the camera will simply stop at its current orientation.
                   Rotation time is how long total, including acceleration, the camera should take to rotate. If it is not specified, the camera will jump to the specified orientation.
                   Acceleration time is how long it should take the camera to get 'up to speed'. If not specified, the camera will instantly start moving.
                   Deceleration time is how long it should take the camera to slow down. If not specified, the camera will instantly stop moving.
                   Returns: true if successful, false or nil otherwise

               boolean setPosition([wvector Position, number Translation Time, number Acceleration Time, number Deceleration Time])
                   Sets camera position and velocity data.
                   Position is the final position for the camera. If not specified, the camera will simply stop at its current position.
                   Translation time is how long total, including acceleration, the camera should take to move. If it is not specified, the camera will jump to the specified position.
                   Acceleration time is how long it should take the camera to get 'up to speed'. If not specified, the camera will instantly start moving.
                   Deceleration time is how long it should take the camera to slow down. If not specified, the camera will instantly stop moving.
                   Returns: true if successful, false or nil otherwise

soundentry

sounds.tbl table entry handle

               number DefaultVolume = number
                   The default volume of this game sound
                   Value: Volume in the range from 1 to 0 or -1 on error

               string getFilename()
                   Returns the filename of this sound
                   Returns: filename or empty string on error

               number getDuration()
                   Gives the length of the sound in seconds.
                   Returns: the length, or -1 on error

               number, number get3DValues(vector Postion[, number radius=0.0])
                   Computes the volume and the panning of the sound when it would be played from the specified position.
                   If range is given then the volume will diminish when the listener is withing that distance to the source.
                   The position of the listener is always the the current viewing position.
                   Returns: The volume and the panning, in that sequence, or both -1 on error

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

sound

sound instance handle

               number Pitch = number
                   Pitch of sound, from 100 to 100000
                   Value: Pitch, or 0 if handle is invalid

               number getRemainingTime()
                   The remaining time of this sound handle
                   Returns: Remaining time, or -1 on error

               boolean setVolume(number)
                   Sets the volume of this sound instance
                   Returns: true if succeeded, false otherwise

               boolean setPanning(number)
                   Sets the panning of this sound. Argument ranges from -1 for left to 1 for right
                   Returns: true if succeeded, false otherwise

               boolean setPosition(number[,boolean = true])
                   Sets the absolute position of the sound. If boolean argument is true then the value is given as a percentage
                   Returns: true if successfull, false otherwise

               boolean rewind(number)
                   Rewinds the sound by the given number of seconds
                   Returns: true if succeeded, false otherwise

               boolean skip(number)
                   Skips the given number of seconds of the sound
                   Returns: true if succeeded, false otherwise

               boolean isPlaying()
                   Specifies if this handle is currently playing
                   Returns: true if playing, false if otherwise

               boolean stop()
                   Stops the sound of this handle
                   Returns: true if succeeded, false otherwise

               boolean isValid()
                   Detects whether handle is valid
                   Returns: true if valid, false if handle is invalid, nil if a syntax/type error occurs

3Dsound:sound

3D sound instance handle

               boolean updatePosition(vector Position[, number radius = 0.0])
                   Updates the given 3D sound with the specified position and an optional range value
                   Returns: true if succeesed, false otherwise

control info

control info handle

               number Pitch = number
                   Pitch of the player ship
                   Value: Pitch

               number Heading = number
                   Heading of the player ship
                   Value: Heading

               number Bank = number
                   Bank of the player ship
                   Value: Bank

               number Vertical = number
                   Vertical control of the player ship
                   Value: Vertical control

               number Sideways = number
                   Sideways control of the player ship
                   Value: Sideways control

               number Forward = number
                   Forward control of the player ship
                   Value: Forward

               number ForwardCruise = number
                   Forward control of the player ship
                   Value: Forward

               number PrimaryCount = number
                   Number of primary weapons that will fire
                   Value: Number of weapons to fire, or 0 if handle is invalid

               number SecondaryCount = number
                   Number of secondary weapons that will fire
                   Value: Number of weapons to fire, or 0 if handle is invalid

               number CountermeasureCount = number
                   Number of countermeasures that will launch
                   Value: Number of countermeasures to launch, or 0 if handle is invalid

               nil clearLuaButtonInfo()
                   Clears the lua button control info
                   Returns: Nothing

               number, number, number,number getButtonInfo()
                   Access the four bitfields containing the button info
                   Returns: Four bitfields

               number, number, number,number accessButtonInfo(number, number, number, number)
                   Access the four bitfields containing the button info
                   Returns: Four bitfields

               nil useButtonControl(number, string)
                   Adds the defined button control to lua button control data, if number is -1 it tries to use the string
                   Returns: Nothing

               string getButtonControlName(number)
                   Gives the name of the command corresponding with the given number
                   Returns: Name of the command

               number getButtonControlNumber(string)
                   Gives the number of the command corresponding with the given string
                   Returns: Number of the command

               boolean AllButtonPolling = boolean
                   Toggles the all button polling for lua
                   Value: If the all button polling is enabled or not

               number, number, number,number pollAllButtons()
                   Access the four bitfields containing the button info
                   Returns: Four bitfields

particle

Handle to a particle

               vector Position = vector
                   The current position of the particle (world vector)
                   Value: The current position

               vector Velocity = vector
                   The current velocity of the particle (world vector)
                   Value: The current velocity

               number Age = number
                   The time this particle already lives
                   Value: The current age or -1 on error

               number MaximumLife = number
                   The time this particle can live
                   Value: The maximal life or -1 on error

               number Radius = number
                   The radius of the particle
                   Value: The radius or -1 on error

               number TracerLength = number
                   The tracer legth of the particle
                   Value: The radius or -1 on error

               object AttachedObject = object
                   The object this particle is attached to. If valid the position will be relativ to this object and the velocity will be ignored.
                   Value: Attached object or invalid object handle on error

               boolean isValid()
                   Detects whether this handle is valid
                   Returns: true if valid false if not

Libraries

Audio (ad)

Sound/Music Library

               soundentry getSoundentry(string/number)
                   Return a sound entry matching the specified index or name. If you are using a number then the first valid index is 1
                   Returns: soundentry or invalid handle on error

               sound playSound(soundentry)
                   Plays the specified sound entry handle
                   Returns: A handle to the playing sound

               sound playLoopingSound(soundentry)
                   Plays the specified sound as a looping sound
                   Returns: A handle to the playing sound or invalid handle if playback failed

               3Dsound play3DSound(soundentry[, vector source[, vector listener]])
                   Plays the specified sound entry handle. Source if by default 0, 0, 0 and listener is by default the current viewposition
                   Returns: A handle to the playing sound

               boolean playGameSound(Sound index, [Panning (-1.0 left to 1.0 right), Volume %, Priority 0-3, Voice Message?])
                   Plays a sound from #Game Sounds in sounds.tbl. A priority of 0 indicates that the song must play; 1-3 will specify the maximum number of that sound that can be played
                   Returns: True if sound was played, false if not (Replaced with a sound instance object in the future)

               boolean playInterfaceSound(Sound index)
                   Plays a sound from #Interface Sounds in sounds.tbl
                   Returns: True if sound was played, false if not

               number playMusic(string Filename, [float volume = 1.0, bool looping = true])
                   Plays a music file using FS2Open's builtin music system. Volume should be in the 0.0 - 1.0 range, and is capped at 1.0. Files passed to this function are looped by default.
                   Returns: Audiohandle of the created audiostream, or -1 on failure

               nil stopMusic(int audiohandle, [bool fade = false])
                   Stops a playing music file, provided audiohandle is valid
                   Returns: Nothing

Base (ba)

Base FreeSpace 2 functions

               nil print(string Message)
                   Prints a string
                   Returns: Nothing

               nil warning(string Message)
                   Displays a FreeSpace warning (debug build-only) message with the string provided
                   Returns: Nothing

               nil error(string Message)
                   Displays a FreeSpace error message with the string provided
                   Returns: Nothing

               orientation createOrientation([p/r1c1, b/r1c2, h/r1c3, r2c1, r2c2, r2c3, r3c1, r3c2, r3c3])
                   Given 0, 3, or 9 arguments, creates an orientation object with that orientation.
                   Returns: New orientation object, or null orientation on failure

               vector createVector([x, y, z])
                   Creates a vector object
                   Returns: Vector object

               number getFrametime([Do not adjust for time compression (Boolean)])
                   Gets how long this frame is calculated to take. Use it to for animations, physics, etc to make incremental changes.
                   Returns: Frame time (seconds)

               state getCurrentGameState([Depth (number)])
                   Gets current FreeSpace state; if a depth is specified, the state at that depth is returned. (IE at the in-game options game, a depth of 1 would give you the game state, while the function defaults to 0, which would be the options screen.
                   Returns: Current game state at specified depth, or invalid handle if no game state is active yet

               string getCurrentMPStatus(NIL)
                   Gets this computers current MP status
                   Returns: Current MP status

               string setControlMode(NIL or enumeration LE_*_CONTROL)
                   Sets the current control mode for the game.
                   Returns: Current control mode

               string setButtonControlMode(NIL or enumeration LE_*_BUTTON_CONTROL)
                   Sets the current control mode for the game.
                   Returns: Current control mode

               control info getControlInfo()
                   Gets the control info handle.
                   Returns: control info handle

               boolean postGameEvent(gameevent Event)
                   Sets current game event. Note that you can crash FreeSpace 2 by posting an event at an improper time, so test extensively if you use it.
                   Returns: True if event was posted, false if passed event was invalid

               gameevent GameEvents[] number Index/string Name
                   Array of game events
                   Returns: Game event, or invalid gameevent handle if index is invalid

                   number #
                       Number of events
                       Returns: Number of events

               gamestate GameStates[] number Index/string Name
                   Array of game states
                   Returns: Game state, or invalid gamestate handle if index is invalid

                   number #
                       Number of states
                       Returns: Number of states

CFile (cf)

CFile FS2 filesystem access

               boolean deleteFile(string Filename, string Path)
                   Deletes given file. Path must be specified. Use a slash for the root directory.
                   Returns: True if deleted, false

               boolean fileExists(string Filename, [string Path = "", boolean CheckVPs = false])
                   Checks if a file exists. Use a blank string for path for any directory, or a slash for the root directory.
                   Returns: True if file exists, false or nil otherwise

               file openFile(string Filename, [string Mode="r", string Path = ""])
                   Opens a file. 'Mode' uses standard C fopen arguments. Use a blank string for path for any directory, or a slash for the root directory.Be EXTREMELY CAREFUL when using this function, as you may PERMANENTLY delete any file by accident
                   Returns: File handle, or invalid file handle if the specified file couldn't be opened

               file openTempFile()
                   Opens a temp file that is automatically deleted when closed
                   Returns: File handle, or invalid file handle if tempfile couldn't be created

               boolean renameFile(string CurrentFilename, string NewFilename, string Path)
                   Renames given file. Path must be specified. Use a slash for the root directory.
                   Returns: True if file was renamed, otherwise false

Controls (io)

Controls library

               number getMouseX()
                   Gets Mouse X pos
                   Returns: Mouse x position, or 0 if mouse is not initialized yet

               number getMouseY()
                   Gets Mouse Y pos
                   Returns: Mouse y position, or 0 if mouse is not initialized yet

               boolean isMouseButtonDown({MOUSE_*_BUTTON enumeration}, [..., ...])
                   Returns whether the specified mouse buttons are up or down
                   Returns: Whether specified mouse buttons are down, or false if mouse is not initialized yet

               nil setCursorImage(Image filename, [LOCK or UNLOCK])
                   Sets mouse cursor image, and allows you to lock/unlock the image. (A locked cursor may only be changed with the unlock parameter)
                   Returns: Nothing

               nil setCursorHidden(True to hide mouse, false to show it)
                   Shows or hides mouse cursor
                   Returns: Nothing

               boolean forceMousePosition(number, number (coordinates))
                   function to force mouse position
                   Returns: if the operation succeeded or not

               boolean MouseControlStatus = boolean
                   Gets and sets the retail mouse control status
                   Value: if the retail mouse is on or off

               boolean updateTrackIR()
                   Updates Tracking Data. Call before using get functions
                   Returns: Checks if trackir is available and updates variables, returns true if successful, otherwise false

               number getTrackIRPitch()
                   Gets pitch axis from last update
                   Returns: Pitch value -1 to 1, or 0 on failure

               number getTrackIRYaw()
                   Gets yaw axis from last update
                   Returns: Yaw value -1 to 1, or 0 on failure

               number getTrackIRRoll()
                   Gets roll axis from last update
                   Returns: Roll value -1 to 1, or 0 on failure

               number getTrackIRX()
                   Gets x position from last update
                   Returns: X value -1 to 1, or 0 on failure

               number getTrackIRY()
                   Gets y position from last update
                   Returns: Y value -1 to 1, or 0 on failure

               number getTrackIRZ()
                   Gets z position from last update
                   Returns: Z value -1 to 1, or 0 on failure

HUD (hu)

HUD library

               boolean HUDDrawn = boolean
                   Current HUD draw status
                   Value: If the HUD is drawn or not

               boolean setHUDGaugeColor(number (index number of the gauge), [number red, number green, number blue, number alpha])
                   Color used to draw the gauge
                   Returns: If the operation was successful

               number, number, number, number getHUDGaugeColor(number (index number of the gauge))
                   Color used to draw the gauge
                   Returns: Red, green, blue, and alpha of the gauge

               HudGauge getHUDGaugeHandle(string Name)
                   Returns a handle to a specified HUD gauge
                   Returns: HUD Gauge handle, or nil if invalid

Graphics (gr)

Graphics Library

               camera Cameras[] number Index/string Name
                   Gets camera
                   Returns: Ship handle, or invalid ship handle if index was invalid

                   number #
                       Gets number of cameras
                       Returns: Number of cameras

               font Fonts[] number Index/string Filename
                   Array of loaded fonts
                   Returns: Font handle, or invalid font handle if index is invalid

                   number #
                       Number of loaded fonts
                       Returns: Number of loaded fonts

               font CurrentFont = font
                   Current font
                   Value: (null)

               enumeration CurrentOpacityType = enumeration
                   Current alpha blending type; uses ALPHABLEND_* enumerations
                   Value: (null)

               texture CurrentRenderTarget = texture
                   Current rendering target
                   Value: Current rendering target, or invalid texture handle if screen is render target

               nil clearScreen([number Red, number green, number blue, number alpha])
                   Clears the screen to black, or the color specified.
                   Returns: Nothing

               camera createCamera(string Name, [wvector Position, orientation Orientation])
                   Creates a new camera using the specified position and orientation (World)
                   Returns: Camera handle, or invalid camera handle if camera couldn't be created

               number getScreenWidth()
                   Gets screen width
                   Returns: Width in pixels, or 0 if graphics are not initialized yet

               number getScreenHeight()
                   Gets screen height
                   Returns: Height in pixels, or 0 if graphics are not initialized yet

               vector getVectorFromCoords([number X=center, number Y=center, number Depth, boolean normalize = false])
                   Returns a vector through screen coordinates x and y. If depth is specified, vector is extended to Depth units into spaceIf normalize is true, vector will be normalized.
                   Returns: Vector, or zero vector on failure

               boolean setTarget([texture Texture])
                   If texture is specified, sets current rendering surface to a texture.Otherwise, sets rendering surface back to screen.
                   Returns: True if successful, false otherwise

               boolean setCamera([camera handle Camera])
                   Sets current camera, or resets camera if none specified
                   Returns: true if successful, false or nil otherwise

               nil setColor(number Red, number Green, number Blue, [number Alpha])
                   Sets 2D drawing color; each color number should be from 0 (darkest) to 255 (brightest)
                   Returns: Nothing

               nil drawCircle(number Radius, number X, number Y)
                   Draws a circle
                   Returns: Nothing

               nil drawCurve(number X, number Y, number Radius)
                   Draws a curve
                   Returns: Nothing

               nil drawGradientLine(number X1, number Y1, number X2, number Y2)
                   Draws a line from (x1,y1) to (x2,y2) with the CurrentColor that steadily fades out
                   Returns: Nothing

               nil drawLine(number X1, number Y1, number X2, number Y2)
                   Draws a line from (x1,y1) to (x2,y2) with CurrentColor
                   Returns: Nothing

               nil drawPixel(number X, number Y)
                   Sets pixel to CurrentColor
                   Returns: Nothing

               nil drawPolygon(texture Texture, [vector Position={0,0,0}, orientation Orientation=null, number Width=1.0, number Height=1.0])
                   Draws a polygon
                   Returns: Nothing

               nil drawRectangle(number X1, number Y1, number X2, number Y2, [boolean Filled=true])
                   Draws a rectangle with CurrentColor
                   Returns: Nothing

               boolean drawSphere([number Radius = 1.0, vector Position])
                   Draws a sphere with radius Radius at world vector Position
                   Returns: True if successful, false or nil otherwise

               int drawModel(model, position, orientation)
                   Draws the given model with the specified position and orientation - Use with extreme care, may not work properly in all scripting hooks.
                   Returns: Zero if successful, otherwise an integer error code

               int drawModelOOR(model Model, vector Position, matrix Orientation, integer Flags)
                   Draws the given model with the specified position and orientation - Use with extreme care, designer to operate properly only in On Object Render hook.
                   Returns: Zero if successful, otherwise an integer error code

               number,number,number,number drawTargetingBrackets(object Object, [boolean draw=true, int padding=5])
                   Gets the edge positions of targeting brackets for the specified object. The brackets will only be drawn if draw is true or the default value of draw is used. Brackets are drawn with the current color. The brackets will have a padding (distance from the actual bounding box); the default value (used elsewhere in FS2) is 5.
                   Returns: Left, top, right, and bottom positions of the brackets, or nil if invalid

               number drawString(string Message, [number X1, number Y1, number X2, number Y2])
                   Draws a string. Use x1/y1 to control position, x2/y2 to limit textbox size.Text will automatically move onto new lines, if x2/y2 is specified.Additionally, calling drawString with only a string argument will automaticallydraw that string below the previously drawn string (or 0,0 if no stringshave been drawn yet
                   Returns: Number of lines drawn, or 0 on failure

               number getStringWidth(string String)
                   Gets string width
                   Returns: String width, or 0 on failure

               texture createTexture([number Width=512, number Height=512, enumeration Type=TEXTURE_DYNAMIC])
                   Creates a texture for rendering to.Types are TEXTURE_STATIC - for infrequent rendering - and TEXTURE_DYNAMIC - for frequent rendering.
                   Returns: New texture handle, or invalid texture handle if texture couldn't be created

               texture loadTexture(string Filename, [boolean LoadIfAnimation, boolean NoDropFrames])
                   Gets a handle to a texture. If second argument is set to true, animations will also be loaded.If third argument is set to true, every other animation frame will not be loaded if system has less than 48 MB memory.
                   IMPORTANT: Textures will not be unload themselves unless you explicitly tell them to do so.When you are done with a texture, call the Unload() function to free up memory.
                   Returns: Texture handle, or invalid texture handle if texture couldn't be loaded

               boolean drawImage(string Filename/texture Texture, [number X1=0, Y1=0, number X2, number Y2, number UVX1 = 0.0, number UVY1 = 0.0, number UVX2=1.0, number UVY2=1.0, number alpha=1.0])
                   Draws an image or texture. Any image extension passed will be ignored.The UV variables specify the UV value for each corner of the image. In UV coordinates, (0,0) is the top left of the image; (1,1) is the lower right.
                   Returns: Whether image was drawn

               boolean drawMonochromeImage(string Filename/texture Texture, number X1, number Y1, [number X2, number Y2, number alpha=1.0])
                   Draws a monochrome image using the current color
                   Returns: Whether image was drawn

               number getImageWidth(string Filename)
                   Gets image width
                   Returns: Image width, or 0 if filename is invalid

               number getImageHeight(Image name)
                   Gets image height
                   Returns: Image height, or 0 if filename is invalid

               nil flashScreen(number Red, number Green, number Blue)
                   Flashes the screen
                   Returns: Nothing

               model loadModel(string Filename)
                   Loads the model - will not setup subsystem data, DO NOT USE FOR LOADING SHIP MODELS
                   Returns: Handle to a model

               boolean hasViewmode(enumeration)
                   Specifies if the current viemode has the specified flag, see VM_* enumeration
                   Returns: true if flag is present, false otherwise

HookVariables (hv)

Hook variables repository

               string Globals[] number Index
                   Array of current HookVariable names
                   Returns: Hookvariable name, or empty string if invalid index specified

                   number #
                       Number of HookVariables
                       Returns: Number of HookVariables

Mission (mn)

Mission library

               object getObjectFromSignature(number Signature)
                   Gets a handle of an object from its signature
                   Returns: Handle of object with signaure, invalid handle if signature is not in use

               boolean evaluateSEXP(string)
                   Runs the defined SEXP script
                   Returns: if the operation was successful

               boolean runSEXP(string)
                   Runs the defined SEXP script
                   Returns: if the operation was successful

               asteroid Asteroids[] number Index
                   Gets asteroid
                   Returns: Asteroid handle, or invalid handle if invalid index specified

                   number #
                       Number of asteroids in mission. Note that the value returned is only good until an asteroid is destroyed, and so cannot be relied on for more than one frame.
                       Returns: Number of asteroids in the mission, or 0 if asteroids are not enabled

               debris Debris[] number Index
                   Array of debris in the current mission
                   Returns: Debris handle, or invalid debris handle if index wasn't valid

                   number #
                       Number of debris pieces in the mission. Note that the value returned is only good until a piece of debris is destroyed, and so cannot be relied on for more than one frame.
                       Returns: Current number of debris particles

               ship EscortShips[] number Index
                   Gets escort ship at specified index on escort list
                   Returns: Specified ship, or invalid ship handle if invalid index

                   number #
                       Current number of escort ships
                       Returns: Current number of escort ships

               event Events[] number Index/string Name
                   Indexes events list
                   Returns: Event handle, or invalid event handle if index was invalid

                   number #
                       Number of events in mission
                       Returns: Number of events in mission

               sexpvariable SEXPVariables[] number Index/string Name
                   Array of SEXP variables. Note that you can set a sexp variable using the array, eg 'SEXPVariables[1] = "newvalue"'
                   Returns: Handle to SEXP variable, or invalid sexpvariable handle if index was invalid

                   number #
                       Current number of SEXP variables
                       Returns: Counts number of loaded SEXP Variables. May be slow.

               ship Ships[] number Index/string Name
                   Gets ship
                   Returns: Ship handle, or invalid ship handle if index was invalid

                   number #
                       Number of ships in the mission. This function is somewhat slow, and should be set to a variable for use in looping situations. Note that the value returned is only good until a ship is destroyed, and so cannot be relied on for more than one frame.
                       Returns: Number of ships in the mission, or 0 if ships haven't been initialized yet

               waypoint Waypoints[] number Index
                   Array of waypoints in the current mission
                   Returns: Waypoint handle, or invalid waypoint handle if index was invalid

                   number #
                       Gets number of waypoints in mission. Note that this is only accurate for one frame.
                       Returns: Number of waypoints in the mission

               waypointlist WaypointLists[] number Index/string WaypointListName
                   Array of waypoint lists
                   Returns: Gets waypointlist handle

                   number #
                       Number of waypoint lists in mission. Note that this is only accurate for one frame.
                       Returns: Number of waypoint lists in the mission

               weapon Weapons[] number Index
                   Gets handle to a weapon object in the mission.
                   Returns: Weapon handle, or invalid weapon handle if index is invalid

                   number #
                       Number of weapon objects in mission. Note that this is only accurate for one frame.
                       Returns: Number of weapon objects in mission

               beam Beams[] number Index
                   Gets handle to a beam object in the mission.
                   Returns: Beam handle, or invalid beam handle if index is invalid

                   number #
                       Number of beam objects in mission. Note that this is only accurate for one frame.
                       Returns: Number of beam objects in mission

               wing Wings[] number Index/string WingName
                   Wings in the mission
                   Returns: Wing handle, or invalid wing handle if index or name was invalid

                   number #
                       Number of wings in mission
                       Returns: Number of wings in mission

               ship createShip([string Name, shipclass Class=Shipclass[1], orientation Orientation=null, vector Position={0,0,0}])
                   Creates a ship and returns a handle to it using the specified name, class, world orientation, and world position
                   Returns: Ship handle, or invalid ship handle if ship couldn't be created

               waypoint createWaypoint([vector Position, waypointlist List])
                   Creates a waypoint
                   Returns: Waypoint handle, or invalid waypoint handle if waypoint couldn't be created

               weapon createWeapon([weaponclass Class=WeaponClass[1], orientation Orientation=null, world vector Position={0,0,0}, object Parent = nil, number Group = -1)
                   Creates a weapon and returns a handle to it. 'Group' is used for lighting grouping purposes; for example, quad lasers would only need to act as one light source.
                   Returns: Weapon handle, or invalid weapon handle if weapon couldn't be created.

               string getMissionFilename()
                   Gets mission filename
                   Returns: Mission filename, or empty string if game is not in a mission

               boolean startMission([Filename or MISSION_* enumeration, Briefing = true])
                   Starts the defined mission
                   Returns: True, or false if the function fails

               number getMissionTime()
                   Game time in seconds since the mission was started; is affected by time compression
                   Returns: Mission time (seconds), or 0 if game is not in a mission

               boolean loadMission(Mission name)
                   Loads a mission
                   Returns: True if mission was loaded, otherwise false

               nil unloadMission()
                   Stops the current mission and unloads it
                   Returns: Nothing

               nil simulateFrame()
                   Simulates mission frame
                   Returns: Nothing

               nil renderFrame()
                   Renders mission frame, but does not move anything
                   Returns: Nothing

BitOps (bit)

Bitwise Operations library

               number AND(number, number)
                   Values for which bitwise boolean AND operation is performed
                   Returns: Result of the AND operation

               number OR(number, number)
                   Values for which bitwise boolean OR operation is performed
                   Returns: Result of the OR operation

               number XOR(number, number)
                   Values for which bitwise boolean XOR operation is performed
                   Returns: Result of the XOR operation

               number toggleBit(number, number (bit))
                   Toggles the value of the set bit in the given number for 32 bit integer
                   Returns: Result of the operation

               boolean checkBit(number, number (bit))
                   Checks the value of the set bit in the given number for 32 bit integer
                   Returns: Was the bit true of false

               number addBit(number, number (bit))
                   Performs inclusive or (OR) operation on the set bit of the value
                   Returns: Result of the operation

Tables (tb)

Tables library

               ship ShipClasses[] number Index/string Name
                   Array of ship classes
                   Returns: Ship handle, or invalid ship handle if index is invalid

                   number #
                       Number of ship classes
                       Returns: Number of ship classes, or 0 if ship classes haven't been loaded yet

               weapon WeaponClasses[] number Index/string WeaponName
                   Array of weapon classes
                   Returns: Weapon class handle, or invalid weaponclass handle if index is invalid

                   number #
                       Number of weapon classes
                       Returns: Number of weapon classes, or 0 if weapon classes haven't been loaded yet

Testing (ts)

Experimental or testing stuff

               nil avdTest()
                   Test the AVD Physics code
                   Returns: Nothing

               particle createParticle(vector Position, vector Velocity, number Lifetime, number Radius, enumeration Type, [number Tracer length=-1, boolean Reverse=false, texture Texture=Nil, object Attached Object=Nil])
                   Creates a particle. Use PARTICLE_* enumerations for type.Reverse reverse animation, if one is specifiedAttached object specifies object that Position will be (and always be) relative to.
                   Returns: Handle to the created particle

               string getStack()
                   Generates an ADE stackdump
                   Returns: Current Lua stack

               boolean isCurrentPlayerMulti()
                   Returns whether current player is a multiplayer pilot or not.
                   Returns: Whether current player is a multiplayer pilot or not

               boolean isPXOEnabled()
                   Returns whether PXO is currently enabled in the configuration.
                   Returns: Whether PXO is enabled or not

Enumerations

       ALPHABLEND_FILTER
       ALPHABLEND_NONE
       CFILE_TYPE_NORMAL
       CFILE_TYPE_MEMORY_MAPPED
       MOUSE_LEFT_BUTTON
       MOUSE_RIGHT_BUTTON
       MOUSE_MIDDLE_BUTTON
       ORDER_ATTACK
       ORDER_ATTACK_ANY
       ORDER_DEPART
       ORDER_DISABLE
       ORDER_DISARM
       ORDER_DOCK
       ORDER_EVADE
       ORDER_FLY_TO
       ORDER_FORM_ON_WING
       ORDER_GUARD
       ORDER_IGNORE_SHIP
       ORDER_KEEP_SAFE_DISTANCE
       ORDER_PLAY_DEAD
       ORDER_REARM
       ORDER_STAY_NEAR
       ORDER_STAY_STILL
       ORDER_UNDOCK
       ORDER_WAYPOINTS
       ORDER_WAYPOINTS_ONCE
       PARTICLE_DEBUG
       PARTICLE_BITMAP
       PARTICLE_FIRE
       PARTICLE_SMOKE
       PARTICLE_SMOKE2
       PARTICLE_PERSISTENT_BITMAP
       SEXPVAR_CAMPAIGN_PERSISTENT
       SEXPVAR_NOT_PERSISTENT
       SEXPVAR_PLAYER_PERSISTENT
       SEXPVAR_TYPE_NUMBER
       SEXPVAR_TYPE_STRING
       TEXTURE_STATIC
       TEXTURE_DYNAMIC
       LOCK
       UNLOCK
       NONE
       SHIELD_FRONT
       SHIELD_LEFT
       SHIELD_RIGHT
       SHIELD_BACK
       MISSION_REPEAT
       NORMAL_CONTROLS
       LUA_STEERING_CONTROLS
       LUA_FULL_CONTROLS
       NORMAL_BUTTON_CONTROLS
       LUA_ADDITIVE_BUTTON_CONTROL
       LUA_OVERRIDE_BUTTON_CONTROL
       VM_INTERNAL
       VM_EXTERNAL
       VM_TRACK
       VM_DEAD_VIEW
       VM_CHASE
       VM_OTHER_SHIP
       VM_EXTERNAL_CAMERA_LOCKED
       VM_WARP_CHASE
       VM_PADLOCK_UP
       VM_PADLOCK_REAR
       VM_PADLOCK_LEFT
       VM_PADLOCK_RIGHT
       VM_WARPIN_ANCHOR
       VM_TOPDOWN
       VM_FREECAMERA