Control

class SpaceCenter.Control

Used to manipulate the controls of a vessel. This includes adjusting the throttle, enabling/disabling systems such as SAS and RCS, or altering the direction in which the vessel is pointing. Obtained by calling SpaceCenter.Vessel.control.

Note

Control inputs (such as pitch, yaw and roll) are zeroed when all clients that have set one or more of these inputs are no longer connected.

source: SpaceCenter.ControlSource

The source of the vessels control, for example by a kerbal or a probe core.

Attribute:

Read-only, cannot be set

Return type:

SpaceCenter.ControlSource

state: SpaceCenter.ControlState

The control state of the vessel.

Attribute:

Read-only, cannot be set

Return type:

SpaceCenter.ControlState

sas: boolean

The state of SAS.

Attribute:

Can be read or written

Return type:

boolean

Note

Equivalent to SpaceCenter.AutoPilot.sas

sas_mode: SpaceCenter.SASMode

The current SpaceCenter.SASMode. These modes are equivalent to the mode buttons to the left of the navball that appear when SAS is enabled.

Attribute:

Can be read or written

Return type:

SpaceCenter.SASMode

Note

Equivalent to SpaceCenter.AutoPilot.sas_mode

speed_mode: SpaceCenter.SpeedMode

The current SpaceCenter.SpeedMode of the navball. This is the mode displayed next to the speed at the top of the navball.

Attribute:

Can be read or written

Return type:

SpaceCenter.SpeedMode

rcs: boolean

The state of RCS.

Attribute:

Can be read or written

Return type:

boolean

reaction_wheels: boolean

Returns whether all reactive wheels on the vessel are active, and sets the active state of all reaction wheels. See SpaceCenter.ReactionWheel.active.

Attribute:

Can be read or written

Return type:

boolean

gear: boolean

The state of the landing gear/legs.

Attribute:

Can be read or written

Return type:

boolean

legs: boolean

Returns whether all landing legs on the vessel are deployed, and sets the deployment state of all landing legs. Does not include wheels (for example landing gear). See SpaceCenter.Leg.deployed.

Attribute:

Can be read or written

Return type:

boolean

wheels: boolean

Returns whether all wheels on the vessel are deployed, and sets the deployment state of all wheels. Does not include landing legs. See SpaceCenter.Wheel.deployed.

Attribute:

Can be read or written

Return type:

boolean

lights: boolean

The state of the lights.

Attribute:

Can be read or written

Return type:

boolean

brakes: boolean

The state of the wheel brakes.

Attribute:

Can be read or written

Return type:

boolean

antennas: boolean

Returns whether all antennas on the vessel are deployed, and sets the deployment state of all antennas. See SpaceCenter.Antenna.deployed.

Attribute:

Can be read or written

Return type:

boolean

cargo_bays: boolean

Returns whether any of the cargo bays on the vessel are open, and sets the open state of all cargo bays. See SpaceCenter.CargoBay.open.

Attribute:

Can be read or written

Return type:

boolean

intakes: boolean

Returns whether all of the air intakes on the vessel are open, and sets the open state of all air intakes. See SpaceCenter.Intake.open.

Attribute:

Can be read or written

Return type:

boolean

parachutes: boolean

Returns whether all parachutes on the vessel are deployed, and sets the deployment state of all parachutes. Cannot be set to False. See SpaceCenter.Parachute.deployed.

Attribute:

Can be read or written

Return type:

boolean

radiators: boolean

Returns whether all radiators on the vessel are deployed, and sets the deployment state of all radiators. See SpaceCenter.Radiator.deployed.

Attribute:

Can be read or written

Return type:

boolean

resource_harvesters: boolean

Returns whether all of the resource harvesters on the vessel are deployed, and sets the deployment state of all resource harvesters. See SpaceCenter.ResourceHarvester.deployed.

Attribute:

Can be read or written

Return type:

boolean

resource_harvesters_active: boolean

Returns whether any of the resource harvesters on the vessel are active, and sets the active state of all resource harvesters. See SpaceCenter.ResourceHarvester.active.

Attribute:

Can be read or written

Return type:

boolean

solar_panels: boolean

Returns whether all solar panels on the vessel are deployed, and sets the deployment state of all solar panels. See SpaceCenter.SolarPanel.deployed.

Attribute:

Can be read or written

Return type:

boolean

abort: boolean

The state of the abort action group.

Attribute:

Can be read or written

Return type:

boolean

throttle: number

The state of the throttle. A value between 0 and 1.

Attribute:

Can be read or written

Return type:

number

input_mode: SpaceCenter.ControlInputMode

Sets the behavior of the pitch, yaw, roll and translation control inputs. When set to additive, these inputs are added to the vessels current inputs. This mode is the default. When set to override, these inputs (if non-zero) override the vessels inputs. This mode prevents keyboard control, or SAS, from interfering with the controls when they are set.

Attribute:

Can be read or written

Return type:

SpaceCenter.ControlInputMode

pitch: number

The state of the pitch control. A value between -1 and 1. Equivalent to the w and s keys.

Attribute:

Can be read or written

Return type:

number

yaw: number

The state of the yaw control. A value between -1 and 1. Equivalent to the a and d keys.

Attribute:

Can be read or written

Return type:

number

roll: number

The state of the roll control. A value between -1 and 1. Equivalent to the q and e keys.

Attribute:

Can be read or written

Return type:

number

forward: number

The state of the forward translational control. A value between -1 and 1. Equivalent to the h and n keys.

Attribute:

Can be read or written

Return type:

number

up: number

The state of the up translational control. A value between -1 and 1. Equivalent to the i and k keys.

Attribute:

Can be read or written

Return type:

number

right: number

The state of the right translational control. A value between -1 and 1. Equivalent to the j and l keys.

Attribute:

Can be read or written

Return type:

number

wheel_throttle: number

The state of the wheel throttle. A value between -1 and 1. A value of 1 rotates the wheels forwards, a value of -1 rotates the wheels backwards.

Attribute:

Can be read or written

Return type:

number

wheel_steering: number

The state of the wheel steering. A value between -1 and 1. A value of 1 steers to the left, and a value of -1 steers to the right.

Attribute:

Can be read or written

Return type:

number

custom_axis01: number

The state of CustomAxis01. A value between -1 and 1.

Attribute:

Can be read or written

Return type:

number

custom_axis02: number

The state of CustomAxis02. A value between -1 and 1.

Attribute:

Can be read or written

Return type:

number

custom_axis03: number

The state of CustomAxis03. A value between -1 and 1.

Attribute:

Can be read or written

Return type:

number

custom_axis04: number

The state of CustomAxis04. A value between -1 and 1.

Attribute:

Can be read or written

Return type:

number

current_stage: number

The current stage of the vessel. Corresponds to the stage number in the in-game UI.

Attribute:

Read-only, cannot be set

Return type:

number

activate_next_stage()

Activates the next stage. Equivalent to pressing the space bar in-game.

Returns:

A list of vessel objects that are jettisoned from the active vessel.

Return type:

List

Note

When called, the active vessel may change. It is therefore possible that, after calling this function, the object(s) returned by previous call(s) to SpaceCenter.active_vessel no longer refer to the active vessel. Throws an exception if staging is locked.

stage_lock: boolean

Whether staging is locked on the vessel.

Attribute:

Can be read or written

Return type:

boolean

Note

This is equivalent to locking the staging using Alt+L

get_action_group(group)

Returns True if the given action group is enabled.

Parameters:

group (number) – A number between 0 and 9 inclusive, or between 0 and 250 inclusive when the Extended Action Groups mod is installed.

Return type:

boolean

set_action_group(group, state)

Sets the state of the given action group.

Parameters:
  • group (number) –

    A number between 0 and 9 inclusive, or between 0 and 250 inclusive when the Extended Action Groups mod is installed.

  • state (boolean) –

toggle_action_group(group)

Toggles the state of the given action group.

Parameters:

group (number) –

A number between 0 and 9 inclusive, or between 0 and 250 inclusive when the Extended Action Groups mod is installed.

add_node(ut[, prograde = 0.0][, normal = 0.0][, radial = 0.0])

Creates a maneuver node at the given universal time, and returns a SpaceCenter.Node object that can be used to modify it. Optionally sets the magnitude of the delta-v for the maneuver node in the prograde, normal and radial directions.

Parameters:
  • ut (number) – Universal time of the maneuver node.

  • prograde (number) – Delta-v in the prograde direction.

  • normal (number) – Delta-v in the normal direction.

  • radial (number) – Delta-v in the radial direction.

Return type:

SpaceCenter.Node

nodes: List

Returns a list of all existing maneuver nodes, ordered by time from first to last.

Attribute:

Read-only, cannot be set

Return type:

List

remove_nodes()

Remove all maneuver nodes.

class SpaceCenter.ControlState

The control state of a vessel. See SpaceCenter.Control.state.

full

Full controllable.

partial

Partially controllable.

none

Not controllable.

class SpaceCenter.ControlSource

The control source of a vessel. See SpaceCenter.Control.source.

kerbal

Vessel is controlled by a Kerbal.

probe

Vessel is controlled by a probe core.

none

Vessel is not controlled.

class SpaceCenter.SASMode

The behavior of the SAS auto-pilot. See SpaceCenter.AutoPilot.sas_mode.

stability_assist

Stability assist mode. Dampen out any rotation.

maneuver

Point in the burn direction of the next maneuver node.

prograde

Point in the prograde direction.

retrograde

Point in the retrograde direction.

normal

Point in the orbit normal direction.

anti_normal

Point in the orbit anti-normal direction.

radial

Point in the orbit radial direction.

anti_radial

Point in the orbit anti-radial direction.

target

Point in the direction of the current target.

anti_target

Point away from the current target.

class SpaceCenter.SpeedMode

The mode of the speed reported in the navball. See SpaceCenter.Control.speed_mode.

orbit

Speed is relative to the vessel’s orbit.

surface

Speed is relative to the surface of the body being orbited.

target

Speed is relative to the current target.

class SpaceCenter.ControlInputMode

See SpaceCenter.Control.input_mode.

additive

Control inputs are added to the vessels current control inputs.

override

Control inputs (when they are non-zero) override the vessels current control inputs.