Introduction

Installation

Configuring Objects

Spacecalls

Events

Coordinates

Tips & Tricks

Spacecalls: Navigation Console Calls

Spacecall	Return Value	Object	Ship
nav_close_doors()			X
	This command closes the bay doors on the ship object.
nav_dock(Integer contact)			X
	This command attempts to dock the space object with the specified contact. The contact must have openned the bay doors, and lowered shields.
nav_door_status()	String status		X
	This function returns the current state of the bay doors on the ship object. The possible return values are NONE, OPEN and CLOSED.
nav_heading()	String heading		X
	This function returns the current heading of the ship object in the standard order of bearing then elevation. The elevation is always preceeded by a + or - sign.
nav_land(Integer contact)			X
	This command attempts to land the ship on the specified contact. The ship must have the CAN_LAND flag set, and the contact the must have the PLANET flag set.
nav_launch(dbref ship)
	This command attempts to launch the ship. The ST_DOCKED_AT attribute on the ship should be set to a valid planet already in space for this command to succeed.
nav_odometer()	Integer distance		X
	This function returns the distance travelled by the ship. The odometer function is a compile-time option, and hence may not be available.
nav_odometer_set(Integer distance)			X
	This command changes the current value of the odometer on the ship to the specified value. The odometer function is a compile-time option, and hence may not be available.
nav_open_doors()			X
	This command opens the bay doors on the ship object (if present).
nav_orbit(Integer contact)			X
	This command puts the ship into orbit around the specified contact. The ship must be within docking range, and the contact must be a planet. The ship's ST_DOCKED_AT attribute is set, and EV_ORBIT_* events triggered.
nav_roll()	Integer roll		X
	This function returns the current roll angle for the ship. Roll is defined as a rotation around the direction of travel. A roll of 0 indicates the ship is parallel to the X-Y plane.
nav_set_course(Float bearing, String +/-, Float elevation)			X
	This command specifies a new heading and elevation for the ship. Bearing should be between 0 and 360, and elevation between 0 and 90.
nav_set_roll(Integer roll)			X
	This command specifies a new roll angle for the ship. Roll is defined as a rotation around the direction of travel.
nav_set_warp(Float speed)			X
	This command specifies a new speed for the ship.
nav_speed()	Float speed		X
	This function returns the current speed of the ship.
nav_time_active()	Integer seconds		X
	This function returns the current amount of time that the ship has been in space. This value is cumulative, and so is not reset to zero then a ship launches or undocks. Time tracking is a compile-time option, and this function may therefore not be available.
nav_time_active_set(Integer seconds)			X
	This command sets the time tracker for the ship to the specified value. Time tracking is a compile-time option, and this function may therefore not be available.
nav_undock(dbref ship)
	This command attempts to undock the specified object and add it to space. The ST_DOCKED_AT attribute on the ship object should be set to a valid object which is already active in space.