gatos.debug_control

tool Debug and rendering

Use gatOS game-manipulation, cheat, cosmetic, and IVA operations.

Use when: The user explicitly asks to manipulate the world beyond ordinary vehicle control.
Availability: debug_namespace, plus feature-specific gates such as IVA physics.

Input

Field	Type	Requirement	Description
`operation`	`string`	Required	Debug operation below or a dotted canonical action.
`vessel_id`	`string`	Optional · ""	Raw vessel id when the operation is vessel-scoped.
`ordinal`	`integer`	Optional · -1	Part, subpart, weld, or entity ordinal where required.
`value`	`number`	Optional · 0	Operation-specific scalar.
`values`	`number[] \| null`	Optional · null	Operation-specific numeric vector.
`token`	`string \| null`	Optional · null	Operation-specific named value.
`aux`	`string \| null`	Optional · null	Operation-specific secondary value.

Operation call shapes

Choose an operation below. Its required payload and a complete call stay together—there is no second table to cross-reference.

`warp`

Canonical action: debug.warp

Set the game time-warp factor.

Arguments for this operation

{ operation: "warp", value: multiplier }

Example

gatos.debug_control({"operation":"warp","value":10})

`teleport`

Canonical action: debug.teleport

Set a CCI state vector about the vessel's current parent body; this does not change SOI.

Arguments for this operation

{ operation: "teleport", vessel_id, values: [px_m, py_m, pz_m, vx_mps, vy_mps, vz_mps] }

Example

gatos.debug_control({"operation":"teleport","vessel_id":"Hunter","values":[6578100,0,0,0,7784,0]})

`impulse`

Canonical action: debug.impulse

Apply an impulse; defaults are parent-body CCI and newton-seconds. aux="dv" changes the vector to m/s delta-v.

Arguments for this operation

{ operation: "impulse", vessel_id, values: [x, y, z], token?: "cci" | "body", aux?: "ns" | "dv" }

Example

gatos.debug_control({"operation":"impulse","vessel_id":"Hunter","values":[10,0,0],"token":"body","aux":"dv"})

`refill_fuel | refill_battery`

Canonical action: debug.refill_fuel | debug.refill_battery

Refill one vessel's relevant resources on the solver phase.

Arguments for this operation

{ operation, vessel_id }

Example

gatos.debug_control({"operation":"refill_fuel","vessel_id":"Hunter"})

`control_vessel | always_render_iva`

Canonical action: debug.control_vessel | debug.always_render_iva

Change the player-controlled vessel or globally force IVA meshes to render.

Arguments for this operation

{ operation: "control_vessel", vessel_id } OR { operation: "always_render_iva", value: 0 | 1 }

Example

gatos.debug_control({"operation":"control_vessel","vessel_id":"Hunter"})

`weld_create`

Canonical action: debug.weld_create

Create an explicit runtime weld from a source vessel to a target part/subpart.

Arguments for this operation

{ operation: "weld_create", vessel_id: source, token: target, values: [part_iid, x, y, z, pitch, yaw, roll, lock] }

Example

gatos.debug_control({"operation":"weld_create","vessel_id":"Tug","token":"Station","values":[42,0,0,0,0,0,0,1]})

`weld_here`

Canonical action: debug.weld_here

Capture the current relative pose and weld there.

Arguments for this operation

{ operation: "weld_here", vessel_id: source, token: target, values: [part_iid, lock] }

Example

gatos.debug_control({"operation":"weld_here","vessel_id":"Tug","token":"Station","values":[42,1]})

`weld_remove | weld_clear`

Canonical action: debug.weld_remove | debug.weld_clear

Remove one source weld or every weld.

Arguments for this operation

{ operation: "weld_remove", vessel_id: source } OR { operation: "weld_clear" }

Example

gatos.debug_control({"operation":"weld_remove","vessel_id":"Tug"})

`weld_enable`

Canonical action: debug.weld_enable

Suspend or resume a retained weld.

Arguments for this operation

{ operation: "weld_enable", vessel_id: source, value: 0 | 1 }

Example

gatos.debug_control({"operation":"weld_enable","vessel_id":"Tug","value":0})

`docking_pushoff`

Canonical action: debug.docking_pushoff

Set debug separation impulse for an indexed docking port.

Arguments for this operation

{ operation: "docking_pushoff", vessel_id, ordinal: docking_port_index, value: impulse_newton_seconds }

Example

gatos.debug_control({"operation":"docking_pushoff","vessel_id":"Hunter","ordinal":0,"value":250})

`thug_life_add`

Canonical action: debug.thug_life_add

Create a part-anchored sunglasses render entry.

Arguments for this operation

{ operation: "thug_life_add", token: vessel_id, values: [part_iid] | [part_iid, x, y, z, pitch, yaw, roll, width, height] }

Example

gatos.debug_control({"operation":"thug_life_add","token":"Hunter","values":[42]})

`thug_life_remove | visible | position | rotation | size | cameras`

Canonical action: debug.thug_life_*

Mutate one entry: flag in value, position/rotation/size in values, or camera mask in token. thug_life_clear needs only operation.

Arguments for this operation

{ operation, ordinal: entry_id, value? | values? | token? }

Example

gatos.debug_control({"operation":"thug_life_visible","ordinal":0,"value":1})

`iva_physics | iva_run_outside_iva`

Canonical action: debug.iva_physics | debug.iva_run_outside_iva

Enable cabin physics or its outside-IVA simulation policy.

Arguments for this operation

{ operation, value: 0 | 1 }

Example

gatos.debug_control({"operation":"iva_physics","value":1})

`iva_adopt`

Canonical action: debug.iva_adopt

Adopt an interior SubPart, optionally with assembly-frame starting velocity.

Arguments for this operation

{ operation: "iva_adopt", token: vessel_id, values: [subpart_iid] | [subpart_iid, vx, vy, vz] }

Example

gatos.debug_control({"operation":"iva_adopt","token":"Hunter","values":[4123]})

`iva_adopt_all`

Canonical action: debug.iva_adopt_all

Adopt the smallest eligible props, optionally filtered by template substring.

Arguments for this operation

{ operation: "iva_adopt_all", token: vessel_id, value?: max_count, aux?: template_substring }

Example

gatos.debug_control({"operation":"iva_adopt_all","token":"Hunter","value":4,"aux":"Sardine"})

`iva_nudge | iva_release | iva_clear`

Canonical action: debug.iva_*

Kick/release one floating object, or return every object to rest.

Arguments for this operation

{ operation: "iva_nudge", ordinal: object_id, values: [vx, vy, vz] } OR { operation: "iva_release", ordinal: object_id } OR { operation: "iva_clear" }

Example

gatos.debug_control({"operation":"iva_nudge","ordinal":0,"values":[0.3,0,0]})

`fx_spawn | fx_clear`

Canonical action: debug.fx_spawn | debug.fx_clear

Spawn a face/vehicle-anchored particle burst or stop all gatOS effects.

Arguments for this operation

{ operation: "fx_spawn", token: vessel_id, aux: profile, values?: [scale, off_x, off_y, off_z] } OR { operation: "fx_clear" }

Example

gatos.debug_control({"operation":"fx_spawn","token":"Valentina","aux":"sparkle","values":[1,0,0,0]})

Call example

gatos.debug_control({"operation":"teleport","vessel_id":"Hunter","values":[6578100,0,0,0,7784,0]})

Result

Canonical debug command outcome.

Errors

EACCES when debug_namespace is disabled; ENOENT for missing entities; EINVAL for unsafe or malformed values; EOPNOTSUPP when a feature is unavailable.

Operational notes

Teleport and default impulse coordinates use the vessel's current-parent CCI frame.
IVA must be enabled before adopting objects.