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: Engineering Console Calls

SpacecallReturn ValueObjectShip
eng_alloc_batts()Integer  X
This function returns the current energy allocation to the batteries.
eng_alloc_nav()Integer  X
This function returns the total energy allocation to navigation.
eng_alloc_shields()Integer  X
This function returns the total energy allocation to shields.
eng_alloc_tac()Integer  X
This function returns the total energy allocation to tactical. This total is subdivided to phasers, torpedoes and tractor beam.
eng_allocate(Integer tactical, Integer navigation, Integer shields, Integer batteries)  X
This command allocates energy between tactical, navigation, shields and batteries. If the total allocated energy is greater than the available energy, the values are scaled down automatically.
eng_batt_disch()Integer  X
This function returns the current discharge rate for the batteries. If no batteries are present on the ship object, a zero is returned.
eng_batt_level()Integer  X
This function returns the current capacity for the batteries. If no batteries are present on the ship object, a zero is returned.
eng_batt_max()Integer  X
This function returns the maximum capacity for the batteries. If no batteries are present on the ship object, a zero is returned.
eng_batt_max_disch()Integer  X
This function returns the maximum discharge rate for the batteries. If no batteries are present on the ship object, a zero is returned.
eng_batt_status()String status  X
This function returns the current status of the batteries. The possible return values are OFF, ON and DAMAGED.
eng_battery_off()  X
This command switches the batteries off.
eng_battery_on()  X
This command switches the batteries on. Additional power, upto the battery maximum discharge rate is available per turn when batteries are on.
eng_output()Integer output  X
This function returns the current amount of energy being produced by the reactor.
eng_reactor_setting()Integer setting  X
This function returns the current reactor setting, as a percentage setting.
eng_set_reactor(Integer setting)  X
This command changes the current reactor setting. The setting is given as a percentage. The minimum percentage is 5%, and the maximum is configurable using the CF_REACTOR_LEVEL_STRESS ship attribute.
eng_shutdown_reactor()  X
This command shuts down a reactor. It is not allowed for objects in real space. For objects in simulated space, it removes the object from space.
eng_start_reactor(dbref ship)   
This command starts a ship reactor. It is not allowed for objects in real space, where objects should be launching or undocking. For objects in simulated space, it sets the reactor output to 5%, and adds the object to space.
eng_stress()Integer stress  X
This function returns the current level of stress for the reactor. Once 100% stress is reached, the engine will begin to suffer damage. Automatic warnings and safeties can be enabled and disabled using the eng_toggle_safe and eng_toggle_warn spacecalls.
eng_toggle_safe()  X
This command toggles the current setting of the reactor safety features. If enabled, the reactor will automatically reduce output when stress reaches 100% to prevent damage. It is enabled automatically when a ship object is added to space.
eng_toggle_warn()  X
This command toggles the current setting of the reactor warning features. If enabled, warning messages will be sent to engineering consoles as the reactor approaches 100% stress. This feature is automatically enabled when the ship object is added to space.


Last modified: 15th March 1998