LAND
Keywords: LAND
=== USER MANUAL ===
Usage: land
land <planet>
land <planet> <location>
land <ship>
Description:
Set your ship down on a planet, moon, station, or inside a
friendly ship's hanger bay. Landing is a gradual sequence
(not instant) -- the ship coasts to a stop, begins its
approach, and finally docks.
With no arguments, land prints every valid destination in
the current starsystem plus your own coordinates.
Forms:
land .................... List landing destinations and your
own position.
land <planet> ........... Land at a planet, moon, or station.
Auto-picks the landing pad if only one
exists; otherwise prompts for a choice.
land <planet> <spot> .... Land at a specific named pad (e.g.
land mars lancaster).
land <ship> ............. Dock inside the hanger bay of
another ship (carriers, stations).
Landing on a Planet:
The target must be a stellar object with at least one zone and
must be within 200 units of your ship. If the zone has rooms
flagged LANDING-PAD, only those rooms count; otherwise every
room in the planet's zones is a valid pad.
If only one pad matches, the command lands you there
automatically. If multiple, you'll see the prompt:
Please type the location after the name.
Possible choices for <planet>:
followed by every valid pad name.
Landing in a Ship:
To dock inside another ship's hanger:
- The target can't be your own ship.
- For non-station targets, your ship must be smaller than
the target and smaller than the LARGE_SHIP class.
Stations accept any size.
- The target must have hangers ("That ship has no hanger").
- At least one hanger must be open (baydoors) and able
to hold your size ("That ship's hangers are either full
or closed.").
- Must be within 200 units.
Requirements:
Pilot seat ......... Must be at the ship's helm.
Pilot access ....... Must own the ship or be a listed pilot.
Spacecraft ......... Stations cannot land ("You can't land
space stations.").
Drive intact ....... "The ships drive is disabled. Unable
to land."
Not already docked .. "The ship is already docked!"
Real space ......... Cannot land from hyperspace.
Ready state ........ No maneuver in progress.
Manual control ..... Autopilot must be disengaged.
Echo:
Landing sequence initiated. (pilot)
<n> begins the landing sequence. (cockpit room)
The ship slowly begins its landing aproach. (ship-wide)
The ship then coasts to zero speed, transitions to SHIP_LAND
state, and docks after the arrival tick.
Errors Listing:
That <planet> doesn't have any landing areas.
-- Planet has no zone configured. Staff fix via
sysedit -> Stellar Object -> Zones.
That <planet> is too far away! You'll have to fly
a little closer.
-- Approach within 200 units.
This ship is too large to land there.
-- Your hull exceeds the target's size.
That ship has no hanger.
-- Target has no hanger compartments at all.
That ship's hangers are either full or closed.
-- Pilot of the target ship needs to run
baydoors to open up.
There's nowhere to land around here.
-- You are not currently in a starsystem (e.g.,
mid-jump transition).
I don't see that here.
-- Name did not match any planet or ship.
Notes:
- Land refuses to start if another maneuver is in progress
-- finish or abort the current action first.
- Landing zeroes your speed; you don't need to accelerate 0
manually.
- After landing, your ship can be boardship'd by anyone
standing in the pad room, assuming the hatch is open
(openhatch).
Strategic Notes:
- Landing inside a friendly carrier is fast interstellar
travel -- the carrier can then hyperspace with your ship
parked in its bay.
- Landing pads on planets are exactly what LANDING-PAD
room flags designate; builders can limit landings to
specific rooms.
- You can see every valid planetary pad before committing
by running bare land first, then land <planet> to see
per-planet options.
Related Helpfiles: LAUNCH, BOARDSHIP, OPENHATCH, BAYDOORS, ORBITALINSERTION, SCANPLANET, RADAR, AUTOPILOT
=== END MANUAL ===