Pilot Input¶

This is not, strictly speaking, a method of controlling the craft. “Pilot” controls are a way to read the input from the pilot. Most of these controls share the same name as their flight control, prefixed with PILOT (eg YAW and PILOTYAW) the one exception to this is the PILOTMAINTHROTTLE. This suffix has a setter and allows you to change the behavior of the throttle that persists even after the current program ends:

SET SHIP:CONTROL:PILOTMAINTHROTTLE TO 0.

Will ensure that the throttle will be 0 when execution stops. These suffixes allow you to read the input given to the system by the user.

structure Control¶

Suffix	Type, Range	Equivalent Key
PILOTMAINTHROTTLE	scalar [0,1]	`LEFT-CTRL`, `LEFT-SHIFT`
PILOTYAW	scalar [-1,1]	`D`, `A`
PILOTPITCH	scalar [-1,1]	`W`, `S`
PILOTROLL	scalar [-1,1]	`Q`, `E`
PILOTROTATION	`Vector`	`(YAW,PITCH,ROLL)`
PILOTYAWTRIM	scalar [-1,1]	`ALT+D`, `ALT+A`
PILOTPITCHTRIM	scalar [-1,1]	`ALT+W`, `ALT+S`
PILOTROLLTRIM	scalar [-1,1]	`ALT+Q`, `ALT+E`
PILOTFORE	scalar [-1,1]	`N`, `H`
PILOTSTARBOARD	scalar [-1,1]	`L`, `J`
PILOTTOP	scalar [-1,1]	`I`, `K`
PILOTTRANSLATION	`Vector`	`(STARBOARD,TOP,FORE)`
PILOTWHEELSTEER	scalar [-1,1]	`A`, `D`
PILOTWHEELTHROTTLE	scalar [-1,1]	`W`, `S`
PILOTWHEELSTEERTRIM	scalar [-1,1]	`ALT+A`, `ALT+D`
PILOTWHEELTHROTTLETRIM	scalar [-1,1]	`ALT+W`, `ALT+S`
PILOTNEUTRAL	Boolean	Is kOS Controlling?

SHIP:CONTROL:PILOTMAINTHROTTLE: Returns the pilot’s input for the throttle. This is the only PILOT variable that is settable and is used to set the throttle upon termination of the current kOS program.

SHIP:CONTROL:PILOTYAW: Returns the pilot’s rotation input about the “up” vector as the pilot faces forward. Essentially left \((-1)\) or right \((+1)\).

SHIP:CONTROL:PILOTPITCH: Returns the pilot’s rotation input about the starboard vector up \((+1)\) or down \((-1)\).

SHIP:CONTROL:PILOTROLL: Returns the pilot’s rotation input about the logintudinal axis of the ship left-wing-down \((-1)\) or left-wing-up \((+1)\).

SHIP:CONTROL:PILOTROTATION: Returns the pilot’s rotation input as a Vector object containing (YAW, PITCH, ROLL) in that order.

SHIP:CONTROL:PILOTYAWTRIM: Returns the pilot’s input for the YAW of the rotational trim.

SHIP:CONTROL:PILOTPITCHTRIM: Returns the pilot’s input for the PITCH of the rotational trim.

SHIP:CONTROL:PILOTROLLTRIM: Returns the pilot’s input for the ROLL of the rotational trim.

SHIP:CONTROL:PILOTFORE: Returns the the pilot’s input for the translation of the ship forward \((+1)\) or backward \((-1)\).

SHIP:CONTROL:PILOTSTARBOARD: Returns the the pilot’s input for the translation of the ship to the right \((+1)\) or left \((-1)\) from the pilot’s perspective.

SHIP:CONTROL:PILOTTOP: Returns the the pilot’s input for the translation of the ship up \((+1)\) or down \((-1)\) from the pilot’s perspective.

SHIP:CONTROL:PILOTTRANSLATION: Returns the the pilot’s input for translation as a Vector (STARBOARD, TOP, FORE).

SHIP:CONTROL:PILOTWHEELSTEER: Returns the the pilot’s input for wheel steering left \((-1)\) or right \((+1)\).

SHIP:CONTROL:PILOTWHEELTHROTTLE: Returns the the pilot’s input for the wheels to move the ship forward \((+1)\) or backward \((-1)\) while on the ground.

SHIP:CONTROL:PILOTWHEELSTEERTRIM: Returns the the pilot’s input for the trim of the wheel steering.

SHIP:CONTROL:PILOTWHEELTHROTTLETRIM: Returns the the pilot’s input for the trim of the wheel throttle.

SHIP:CONTROL:PILOTNEUTRAL: Returns true or false if the pilot is active or not.

Be aware that kOS can’t control a control at the same time that a player controls it. If kOS is taking control of the yoke, then the player can’t manually control it. Remember to run:

SET SHIP:CONTROL:NEUTRALIZE TO TRUE.

after the script is done using the controls, or the player will be locked out of control.