PILOT
Keywords: PILOT, PIL
=== USER MANUAL ===
Usage: pilot <direction>
pilot into <ship>
pilot out
Description:
Drive a land vehicle you are piloting. The command specializes
in getting land vehicles into and out of other ships --
useful for loading ATVs into a carrier's garage for
interstellar transport, or disembarking them on the other side.
For spacecraft flight controls, this command is not the
right tool. Use accelerate, course, calculate, hyperspace,
and land directly from the cockpit instead.
Forms:
pilot <direction> ... Ground-vehicle directional movement.
Delegated to the classic drive handler when
you are mounted or not actually in a ship's
pilot seat. If you're sitting in a
LAND_VEHICLE-class ship specifically, this
branch is stubbed in the current port:
"Vehicle directional movement is not
wired up in this port."
pilot into <ship> ... Drive the land vehicle into a docked
ship's garage. Ship must have open
baydoors and a garage bay with capacity.
pilot out ........... Drive the land vehicle out of the
ship's garage back onto the pad. Only works
while the parent ship is properly docked and
its baydoors are open.
Delegation Rules:
The engine routes pilot based on context:
- Sitting on a mountable (vehicle mount, creature) ->
forwarded to drive handler.
- Not in any ship's pilot seat -> forwarded to drive.
- In a pilot seat of a ship whose class is not
LAND_VEHICLE -> "This vehicle isn't equiped for land-
travel."
Into a Ship:
You drive <vehicle> into <ship>. (you)
<n> drives into <ship>. (pad room)
<vehicle> enters <ship>. (pad room)
(auto-look at destination garage)
Failure cases:
Drive into what? No target named.
Nothing here by that name! Target ship not found.
That vehicle's baydoors are closed.
There are no garages in that.
That vehicle is full. All garage slots taken.
Out of a Ship:
<vehicle> exits <ship>. (garage)
<vehicle> drives out of <ship>. (pad)
You drive <vehicle> out of <ship>. (you)
Failure cases:
Nowhere to drive out of. Not in a ship at all.
Baydoors are closed, cannot drive out.
Maybe you should wait until the ship lands.
Please wait until the ship is properly docked.
Requirements:
Vehicle pilot seat .. For the into / out sub-commands,
must be in a LAND_VEHICLE pilot seat.
Otherwise the command falls through to
the classic drive handler.
Engine intact ...... Disabled drives return "The engine
has been disabled."
Fuel ................ At least 1 energy required:
"There is not enough fuel."
Notes:
- pilot is an alias for ground-vehicle driving with
ship-garage awareness bolted on. The actual low-level
handler is shared with the drive command.
- For space flight, every sub-command is separate --
accelerate, course, calculate, etc. -- and none of
them use pilot.
- Directional movement via pilot north etc. works for
standard land vehicles (via the fall-through) but is
stubbed for LAND_VEHICLE-class ships. Use drive as a
workaround for those hulls.
Related Helpfiles: DRIVE, BAYDOORS, LAND, LAUNCH, BOARDSHIP, ACCELERATE, COURSE
=== END MANUAL ===