Introduction

Installation

Configuring Objects

Spacecalls

Events

Coordinates

Tips & Tricks

Portable Space EngineBuilder's Guide

Please send comments to Mark Cooke <mpc@star.sr.bham.ac.uk> or vspace@geocities.com

>Spacecalls: Tactical Console Calls

SpacecallReturn ValueObjectShip
scan(Integer contact)  X
This command triggers a scan of the specified contact. The contact is scanned if it is within range, and scanners are undamaged.
scanner_status()String status  X
This function returns the status of the scanners. The possible return values are DAMAGED and OK.
sensor_status()String status  X
This function returns the status of the sensors. The possible return values are DAMAGED and OK.
tac_alloc_guns()Integer alloc  X
This function returns the amount of energy currently allocated to guns. The amount can be changed using the tac_allocate spacecall.
tac_alloc_torps()Integer alloc  X
This function returns the amount of energy currently allocated to torpedoes. The amount can be changed using the tac_allocate spacecall.
tac_alloc_tractor()Integer alloc  X
This function returns the amount of energy currently allocated to the tractor beam. The amount can be changed using the tac_allocate spacecall.
tac_allocate(Integer guns, Integer torps, Integer trator)  X
This command allocates energy to the guns, torpedoes and tractor beam. If the total energy allocated is greater than the total supplied to tactical, the values are scaled down.
tac_auto_charge()  X
This command toggles the setting of torpedo auto-arming. The default setting is disabled.
tac_auto_reload()  X
This command toggles the setting of torpedo auto-reloading. The default setting is enabled.
tac_charge_status()String status  X
This function returns the auto-arming status of the torpedoes. The possible return values are ON and OFF.
tac_fire_gun(Integer gun | all)  X
This command will fire the specified gun, or all guns if the parameter is 'all'. The weapons system must be locked onto a target, and the target must be in range before the guns will fire.
tac_fire_torp(Integer torp | String all, String NONE | Float bearing, String +/-, Float elevation, Integer range)  X
This command will fire the specified torpedo, or all armed torpedoes if the parameter is 'all'. If the second parameter is NONE, the torpedoes will be fired at the currently locked target. If the second parameter is not NONE, the second, third, fourth and fifth parameters are treated as bearing, elevation sign, elevation and range respectively. Torpedoes can only be fired when they are armed, and when the ship is not cloaked.
tac_gun_charge(Integer gun)Integer charge  X
This function returns the amount of charge in the specified gun.
tac_gun_offline(Integer gun)  X
This command takes the specified gun offline. Offline guns cannot be fired or charged.
tac_gun_online(Integer gun)  X
This command brings the specified gun online. Online guns can be fired and charged.
tac_gun_power(Integer gun)Integer power  X
This function returns the maximum charge that the specified gun can be charged with.
tac_gun_qty()Integer quantity  X
This function returns the number of guns available on the ship object.
tac_gun_status(Integer gun)String status  X
This function returns the status of the specified gun. Possible return values are ON, OFF and DAMAGED.
tac_lock(Integer contact)  X
This command attempts to lock weapons on the specified contact. Any existing weapons lock is broken.
tac_lock_status()String status  X
This function returns the current weapons lock status. Possible return values are LOCKED, PENDING and OFF.
tac_reload_status()String status  X
This function returns the auto-loading status of the torpedoes. The possible return values are ON and OFF.
tac_reload_torp(Integer torp)  X
This command starts reloading the specified torpedo if there is a free reloader.
tac_torp_ammo()Integer amount  X
This function returns the number of remaining torpedoes. This is decremented each time a torpedo is fired.
tac_torp_charge(Integer torp)Integer charge  X
This function returns the amount of charge in the specified torpedo. It returns zero if the torpedo is not online or charging.
tac_torp_offline(Integer torp)  X
This command takes the specified torpedo offline. Offline torpedos cannot be armed without first being brought online.
tac_torp_online(Integer torp)  X
This command brings the specified torpedo online. Online torpedos can be armed and fired.
tac_torp_power(Integer torp)Integer power  X
This function returns the total charge needed to arm a torpedo. Torpedos cannot be fired until they are fully charged, and cannot be disarmed. A charged torpedo will expire if it is not fired within a certain time frame.
tac_torp_qty()Integer quantity  X
This function returns the number of torpedo launchers present on the ship object.
tac_torp_status(Integer torp)Integer status  X
This function returns the status of the specified torpedo. The possible return values are EMPTY, RELOADING, LOADED, CHARGING, ARMED and DAMAGED.
tac_tractor_dock()  X
This command attempts to pull the object locked onto with the tractor beam into the docking bay of the ship object making this call. The object must be able to fit through the docking bay doors, facing shields must be lowered, and the docking bay doors must be open.
tac_tractor_draw(Boolean on)  X
This command changes the active state of the tractor beam. With draw mode engaged, the tractored object is drawn towards the ship.
tac_tractor_lock(Integer contact)  X
This command attempts to lock the tractor beam onto the specified target. The target must be within range, and set TRACTORABLE. The maximum tractor beam range is equivalent to the amount of power allocated to the beam. Any existing tractor lock is broken, and the EV_TRACTOR_* events are triggered.
tac_tractor_status()String status  X
This function returns the current tractor beam status. Possible return values are NONE, ON, OFF, DRAW, and DAMAGED.
tac_tractor_target()Integer contact  X
This function returns the contact number of the tractored object, if any. An emptry string is returned if no object is being tractored.
tac_tractor_unlock()  X
This command unlocks the tractor beam from it's current target, if any.
tac_unlock()  X
This command unlocks the weapon systems from the current target, if any.


Last modified: 15th March 1998