mecha

WELCOME TO MECHA.DM, ENJOY YOUR STAY

Mechs are now (finally) vehicles, this means you can make them multicrew They can also grant select ability buttons based on occupant bitflags

Movement is handled through vehicle_move() which is called by relaymove Clicking is done by way of signals registering to the entering mob NOTE: MMIS are NOT mobs but instead contain a brain that is, so you need special checks AI also has special checks becaus it gets in and out of the mech differently Always call remove_occupant(mob) when leaving the mech so the mob is removed properly

For multi-crew, you need to set how the occupants recieve ability bitflags corresponding to their status on the vehicle(i.e: driver, gunner etc) Abilities can then be set to only apply for certain bitflags and are assigned as such automatically

Clicks are wither translated into mech_melee_attack (see mech_melee_attack.dm) Or are used to call action() on equipped gear Cooldown for gear is on the mech because exploits

Vars
active_thrusters	/Action vars Ref to any active thrusters we might have
allow_diagonal_movement	Whether this mech is allowed to move diagonally
bumpsmash	Whether or not the mech destroys walls by running into it.
cabin_air	Internal air mix datum
capacitor	Keeps track of the mech's capacitor
cell	Keeps track of the mech's cell
completely_disabled	Just stop the mech from doing anything
connected_port	The connected air port, if we have one
construction_state	Whether the mechs maintenance protocols are on or off
defense_mode	Bool for energy shield on/off
deflect_chance	chance to deflect the incoming projectiles, hits, or lesser the effect of ex_act.
destruction_sleep_duration	Time you get slept for if you get forcible ejected by the mech exploding
dir_in	What direction will the mech face when entered/powered on? Defaults to South.
dna_lock	Stores the DNA enzymes of a carbon so tht only they can access the mech
enclosed	Whether outside viewers can see the pilot inside
equipment_disabled	if we cant use our equipment(such as due to EMP)
exit_delay	TIme taken to leave the mech
facing_modifiers	Modifiers for directional armor
internal_damage	Bitflags for internal damage
internal_damage_threshold	health percentage below which internal damage is possible
internal_tank	The internal air tank obj of the mech
internal_tank_valve	The setting of the valve on the internal tank
internals_req_access	required access to change internal components
is_currently_ejecting	Currently ejecting, and unable to do things
lavaland_only	Bool for whether this mech can only be used on lavaland
leg_overload_coeff	Energy use modifier for leg overload
leg_overload_mode	Bool for leg overload on/off
lights_power	How powerful our lights are
max_equip	Maximum amount of equipment we can have
mecha_flags	Contains flags for the mecha
melee_cooldown	Cooldown duration between melee punches
melee_energy_drain	How much energy we drain each time we mechpunch someone
normal_step_energy_drain	How much energy the mech will consume each time it moves. This variable is a backup for when leg actuators affect the energy drain.
operation_req_access	required access level for mecha operation
overload_step_energy_drain_min	The minimum amount of energy charge consumed by leg overload
phase_state	icon_state for flick() when phazing
phasing	check for phasing, if it is set to text (to describe how it is phasing: "flying", "phasing") it will let the mech walk through walls.
phasing_energy_drain	Power we use every time we phaze through something
radio	Special version of the radio, which is unsellable
scanmod	Keeps track of the mech's scanning module
selected	Current active equipment
silicon_icon_state	In case theres a different iconstate for AI/MMI pilot(currently only used for ripley)
smashcooldown	Cooldown length between bumpsmashes
smoke_charges	Remaining smoke charges
smoke_cooldown	Cooldown between using smoke
spark_system	Spark effects are handled by this datum
step_energy_drain	How much energy the mech will consume each time it moves. this is the current active energy consumed
step_silent	Whether our steps are silent due to no gravity
stepsound	Sound played when the mech moves
strafe	Wether we are strafing
turnsound	Sound played when the mech walks
use_internal_tank	////////ATMOS Whether we are currrently drawing from the internal tank
wreckage	Typepath for the wreckage it spawns when destroyed
Procs
Topic	Topic
add_capacitor	Adds a capacitor, for use in Map-spawned mechs, Nuke Ops mechs, and admin-spawned mechs. Mechs built by hand will replace this.
add_cell	Updates the values given by scanning module and capacitor tier, called when a part is removed or inserted.
add_scanmod	Adds a scanning module, for use in Map-spawned mechs, Nuke Ops mechs, and admin-spawned mechs. Mechs built by hand will replace this.
ai_enter_mech	Hack and From Card interactions share some code, so leave that here for both to use.
aimob_enter_mech	Handles an actual AI (simple_animal mecha pilot) entering the mech
aimob_exit_mech	Handles an actual AI (simple_animal mecha pilot) exiting the mech
ammo_resupply	Ammo stuff
attack_ai	AI piloting
check_for_internal_damage	Internal damage
disconnect_air	Disconnects air tank- air port connection on mecha move
display_speech_bubble	Displays a special speech bubble when someone inside the mecha speaks
generate_action_type	MECHA ACTIONS
get_actions	Returns HTML for mech actions. Ideally, this proc would be empty for the base mecha. Segmented for easy refactoring.
get_commands	HTML for commands.
get_equipment_list	HTML for list of equipment.
get_stats_html	Rendering stats window
get_stats_part	Returns the status of the mech.
has_charge	Power stuff
on_light_eater	Special light eater handling
on_mouseclick	// Action processing ////
operation_allowed	Access stuff
play_stepsound	///// Movement procs ////////
remove_air	Atmospheric stuff
report_internal_damage	HTML for internal damage.
return_pressure	fetches pressure of the gas mixture we are using
return_temperature	fetches temp of the gas mixture we are using
stationary_repair	Repairs internal damage if the mech hasn't moved.

Var Details

var
active_thrusters
– /obj/item/mecha_parts/mecha_equipment/thrusters

/Action vars Ref to any active thrusters we might have

var
allow_diagonal_movement
–

Whether this mech is allowed to move diagonally

var
bumpsmash
–

Whether or not the mech destroys walls by running into it.

var
cabin_air
– /datum/gas_mixture

Internal air mix datum

var
capacitor
– /obj/item/stock_parts/capacitor

Keeps track of the mech's capacitor

var
cell
– /obj/item/stock_parts/cell

Keeps track of the mech's cell

var
completely_disabled
–

Just stop the mech from doing anything

var
connected_port
– /obj/machinery/atmospherics/components/unary/portables_connector

The connected air port, if we have one

var
construction_state
–

Whether the mechs maintenance protocols are on or off

var
defense_mode
–

Bool for energy shield on/off

var
deflect_chance
–

chance to deflect the incoming projectiles, hits, or lesser the effect of ex_act.

var
destruction_sleep_duration
–

Time you get slept for if you get forcible ejected by the mech exploding

var
dir_in
–

What direction will the mech face when entered/powered on? Defaults to South.

var
dna_lock
–

Stores the DNA enzymes of a carbon so tht only they can access the mech

var
enclosed
–

Whether outside viewers can see the pilot inside

var
equipment_disabled
–

if we cant use our equipment(such as due to EMP)

var
exit_delay
–

TIme taken to leave the mech

var
facing_modifiers
– /list

Modifiers for directional armor

var
internal_damage
–

Bitflags for internal damage

var
internal_damage_threshold
–

health percentage below which internal damage is possible

var
internal_tank
– /obj/machinery/portable_atmospherics/canister/air

The internal air tank obj of the mech

var
internal_tank_valve
–

The setting of the valve on the internal tank

var
internals_req_access
– /list

required access to change internal components

var
is_currently_ejecting
–

Currently ejecting, and unable to do things

var
lavaland_only
–

Bool for whether this mech can only be used on lavaland

var
leg_overload_coeff
–

Energy use modifier for leg overload

var
leg_overload_mode
–

Bool for leg overload on/off

var
lights_power
–

How powerful our lights are

var
max_equip
–

Maximum amount of equipment we can have

var
mecha_flags
–

Contains flags for the mecha

var
melee_cooldown
–

Cooldown duration between melee punches

var
melee_energy_drain
–

How much energy we drain each time we mechpunch someone

var
normal_step_energy_drain
–

How much energy the mech will consume each time it moves. This variable is a backup for when leg actuators affect the energy drain.

var
operation_req_access
– /list

required access level for mecha operation

var
overload_step_energy_drain_min
–

The minimum amount of energy charge consumed by leg overload

var
phase_state
–

icon_state for flick() when phazing

var
phasing
–

check for phasing, if it is set to text (to describe how it is phasing: "flying", "phasing") it will let the mech walk through walls.

var
phasing_energy_drain
–

Power we use every time we phaze through something

var
radio
– /obj/item/radio/mech

Special version of the radio, which is unsellable

var
scanmod
– /obj/item/stock_parts/scanning_module

Keeps track of the mech's scanning module

var
selected
– /obj/item/mecha_parts/mecha_equipment

Current active equipment

var
silicon_icon_state
–

In case theres a different iconstate for AI/MMI pilot(currently only used for ripley)

var
smashcooldown
–

Cooldown length between bumpsmashes

var
smoke_charges
–

Remaining smoke charges

var
smoke_cooldown
–

Cooldown between using smoke

var
spark_system
– /datum/effect_system/spark_spread

Spark effects are handled by this datum

var
step_energy_drain
–

How much energy the mech will consume each time it moves. this is the current active energy consumed

var
step_silent
–

Whether our steps are silent due to no gravity

var
stepsound
–

Sound played when the mech moves

var
strafe
–

Wether we are strafing

var
turnsound
–

Sound played when the mech walks

var
use_internal_tank
–

////////ATMOS Whether we are currrently drawing from the internal tank

var
wreckage
–

Typepath for the wreckage it spawns when destroyed

Proc Details

↑
Topic
(href, href_list)

Topic

proc
add_capacitor
(/obj/item/stock_parts/capacitor/cap)

Adds a capacitor, for use in Map-spawned mechs, Nuke Ops mechs, and admin-spawned mechs. Mechs built by hand will replace this.

proc
add_cell
(/obj/item/stock_parts/cell/C)

Updates the values given by scanning module and capacitor tier, called when a part is removed or inserted.

/// Helpers /////////

Adds a cell, for use in Map-spawned mechs, Nuke Ops mechs, and admin-spawned mechs. Mechs built by hand will replace this.

proc
add_scanmod
(/obj/item/stock_parts/scanning_module/sm)

Adds a scanning module, for use in Map-spawned mechs, Nuke Ops mechs, and admin-spawned mechs. Mechs built by hand will replace this.

proc
ai_enter_mech
(/mob/living/silicon/ai/AI)

Hack and From Card interactions share some code, so leave that here for both to use.

proc
aimob_enter_mech
(/mob/living/simple_animal/hostile/syndicate/mecha_pilot/pilot_mob)

Handles an actual AI (simple_animal mecha pilot) entering the mech

proc
aimob_exit_mech
(/mob/living/simple_animal/hostile/syndicate/mecha_pilot/pilot_mob)

Handles an actual AI (simple_animal mecha pilot) exiting the mech

proc
ammo_resupply
(/obj/item/mecha_ammo/A, /mob/user, fail_chat_override)

Ammo stuff

attack_ai
(/mob/living/silicon/ai/user)

AI piloting

proc
check_for_internal_damage
(/list/possible_int_damage, ignore_threshold)

Internal damage

proc
disconnect_air
()

Disconnects air tank- air port connection on mecha move

proc
display_speech_bubble
(/datum/source, /list/speech_args)

Displays a special speech bubble when someone inside the mecha speaks

↑
generate_action_type
()

MECHA ACTIONS

proc
get_actions
(/mob/user)

Returns HTML for mech actions. Ideally, this proc would be empty for the base mecha. Segmented for easy refactoring.

proc
get_commands
()

HTML for commands.

proc
get_equipment_list
()

HTML for list of equipment.

proc
get_stats_html
(/mob/user)

Rendering stats window

proc
get_stats_part
(/mob/user)

Returns the status of the mech.

proc
has_charge
(amount)

Power stuff

proc
on_light_eater
(/obj/vehicle/sealed/source, /datum/light_eater)

Special light eater handling

proc
on_mouseclick
(/mob/user, /atom/target, params)

// Action processing ////

Called when a driver clicks somewhere. Handles everything like equipment, punches, etc.

proc
operation_allowed
(/mob/M)

Access stuff

proc
play_stepsound
()

///// Movement procs ////////

Plays the mech step sound effect. Split from movement procs so that other mechs (HONK) can override this one specific part.

↑
remove_air
(amount)

Atmospheric stuff

proc
report_internal_damage
()

HTML for internal damage.

proc
return_pressure
()

fetches pressure of the gas mixture we are using

↑
return_temperature
()

fetches temp of the gas mixture we are using

proc
stationary_repair
(location)

Repairs internal damage if the mech hasn't moved.

mecha /obj/vehicle/sealed/mecha

Vars

Procs

Var Details

var active_thrusters – /obj/item/mecha_parts/mecha_equipment/thrusters

var allow_diagonal_movement –

var bumpsmash –

var cabin_air – /datum/gas_mixture

var capacitor – /obj/item/stock_parts/capacitor

var cell – /obj/item/stock_parts/cell

var completely_disabled –

var connected_port – /obj/machinery/atmospherics/components/unary/portables_connector

var construction_state –

var defense_mode –

var deflect_chance –

var destruction_sleep_duration –

var dir_in –

var dna_lock –

var enclosed –

var equipment_disabled –

var exit_delay –

var facing_modifiers – /list

var internal_damage –

var internal_damage_threshold –

var internal_tank – /obj/machinery/portable_atmospherics/canister/air

var internal_tank_valve –

var internals_req_access – /list

var is_currently_ejecting –

var lavaland_only –

var leg_overload_coeff –

var leg_overload_mode –

var lights_power –

var max_equip –

var mecha_flags –

var melee_cooldown –

var melee_energy_drain –

var normal_step_energy_drain –

var operation_req_access – /list

var overload_step_energy_drain_min –

var phase_state –

var phasing –

var phasing_energy_drain –

var radio – /obj/item/radio/mech

var scanmod – /obj/item/stock_parts/scanning_module

var selected – /obj/item/mecha_parts/mecha_equipment

var silicon_icon_state –

var smashcooldown –

var smoke_charges –

var smoke_cooldown –

var spark_system – /datum/effect_system/spark_spread

var step_energy_drain –

var step_silent –

var stepsound –

var strafe –

var turnsound –

var use_internal_tank –

var wreckage –