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: Object Calls

SpacecallReturn ValueObjectShip
add_object(dbref object)   
This command attempts to add the specified object to space. The PSE will attempt to read the attributes from the object, and create the internal structures needed. Any errors are logged to the space_debug_char and to the server log file.
objlist(Integer space, Boolean show_ships, Boolean show_other)   
This command emits a table of space objects which match the selection criteria to the enactor.
rm_object(dbref object) X 
This command flags the specified object for removal from space. The actual cleanup is done at the end of the next update cycle.
run_cycle(Integer space)   
This command sets the update flag on the space specified, or all spaces if -1 was passed. This optional spacecall is enabled using the turn-based option in spaceconf.h
set_objflag(String [!]flag) X 
This command sets or clears the specified object flag on the space object. The valid flags are listed in the flags section of the manual.
set_shipflag(String [!]flag)  X
This command sets or clears the specified ship flag on the space object. The valid flags are listed in the flags section of the manual.
space_lock(Integer space, Boolean lock)   
This command sets or clears the lock on the specified space. A locked space cannot have additional space objects added to it without first being unlocked.
write_all_objects(Int Space)   
This command updates the attributes on all of the space objects in the given space. It can be called periodically to keep the state of the server database synchronized with the Portable Space Engine state. Normally this is only done when an object is added or removed from space for efficiency reasons.
write_object() X 
This command updates the attributes on the space object. It can be called periodically to keep the state of the server database synchronized with the Portable Space Engine state. Normally this is only done when an object is added or removed from space for efficiency reasons.


Last modified: 15th March 1998