training_machine

Machine that runs around wildly so people can practice clickin on things

Can have a mob buckled on or a obj/item/target attached. Movement controlled by SSFastProcess, movespeed controlled by cooldown macros. Can attach obj/item/target, obj/item/training_toolbox, and can buckle mobs to this.

Vars
attached_item	Reference to a potentially attached object, either a target, trainer toolbox, or syndicate toolbox
attack_cooldown	Helper for timing attacks when emagged
move_cooldown	Cooldown macro to control how fast this will move. Used in process()
move_speed	Delay between process() calls. Cannot be higher than MAX_SPEED. Smaller value represents faster movement.
moving	Is the machine moving? Setting this to FALSE will automatically call stop_moving()
range	The distance the machine is allowed to roam from its starting point
starting_turf	The turf the machine was on when it was activated
target_position	A random spot within range that the trainer is trying to reach
Procs
Destroy	Called on qdel(), so we don't want a cool explosion to happen
atom_destruction	Called on a normal destruction, so we have a cool explosion and toss whatever's attached
attach_item	Attach an item to the machine
attackby	Called when the machien is attacked by something
emag_act	Emagging causes a deadly, unremovable syndicate toolbox to be attached to the machine
find_target_position	Find a suitable turf to move towards
handle_density	Make sure the machine can't be walked through if something is attached
on_attached_delete	Called when the attached item is deleted.
process	Main movement method for the machine
remove_attached_item	Remove the attached item from the machine
start_moving	Start the machine's movement
stop_moving	Stop the machine's movement
toggle	Toggle the machine's movement
try_attack	Try to attack a nearby mob
ui_act	Control the attached variables.
ui_data	Send data to the UI

Var Details

var
attached_item
– /obj

Reference to a potentially attached object, either a target, trainer toolbox, or syndicate toolbox

var
attack_cooldown
–

Helper for timing attacks when emagged

var
move_cooldown
–

Cooldown macro to control how fast this will move. Used in process()

var
move_speed
–

Delay between process() calls. Cannot be higher than MAX_SPEED. Smaller value represents faster movement.

var
moving
–

Is the machine moving? Setting this to FALSE will automatically call stop_moving()

var
range
–

The distance the machine is allowed to roam from its starting point

var
starting_turf
– /turf

The turf the machine was on when it was activated

var
target_position
– /turf

A random spot within range that the trainer is trying to reach

Proc Details

↑
Destroy
()

Called on qdel(), so we don't want a cool explosion to happen

↑
atom_destruction
(damage_flag)

Called on a normal destruction, so we have a cool explosion and toss whatever's attached

proc
attach_item
(/obj/target)

Attach an item to the machine

This proc technically works with any obj. Currently is only used for objects of type item/target and item/training_toolbox Will make the attached item appear visually on the machine Arguments

target - The object to attach

↑
attackby
(/obj/item/target, /mob/living/user)

Called when the machien is attacked by something

Meant for attaching an item to the machine, should only be a training toolbox or target. If emagged, the machine will gain an auto-attached syndicate toolbox, so in that case we shouldn't be able to swap it out

↑
emag_act
(/mob/user, /obj/item/card/emag/emag_card)

Emagging causes a deadly, unremovable syndicate toolbox to be attached to the machine

proc
find_target_position
()

Find a suitable turf to move towards

proc
handle_density
()

Make sure the machine can't be walked through if something is attached

proc
on_attached_delete
()

Called when the attached item is deleted.

Cleans up behavior for when the attached item is deleted or removed.

↑
process
()

Main movement method for the machine

Handles movement using SSFastProcess. Moves randomly, point-to-point, in an area centered around wherever it started. Will only move if the move_cooldown cooldown macro is finished. If it can't find a place to go, it will stop moving.

proc
remove_attached_item
(/mob/user, throwing)

Remove the attached item from the machine

Called when a user removes the item by hand or by swapping it out with another, when the machine breaks, or when the machine is emagged. Arguments

user - The peson , if any, removing the attached item
throwing - If we should make the item fly off the machine

proc
start_moving
()

Start the machine's movement

Says a message, plays a sound, then starts processing

proc
stop_moving
(message)

Stop the machine's movement

Will call STOP_PROCESSING, play a sound, and say an appropriate message Arguments

Message - the message the machine says when stopping

proc
toggle
()

Toggle the machine's movement

proc
try_attack
()

Try to attack a nearby mob

Called whenever the machine moves, this will look for mobs adjacent to the machine to attack. Will attack with either a training toolbox (if attached), or a much more deadly syndicate toolbox (if emagged). A cooldown macro (attack_cooldown) ensures it doesn't attack too quickly

↑
ui_act
(action, /list/params, /datum/tgui/ui, /datum/ui_state/state)

Control the attached variables.

Will not respond if moving and emagged, so once you set it to go it can't be stopped!

↑
ui_data
(/mob/user)

Send data to the UI

Include's the machine's movement range, speed, and whether or not it's active

training_machine /obj/structure/training_machine

Vars

Procs

Var Details

var attached_item – /obj

var attack_cooldown –

var move_cooldown –

var move_speed –

var moving –

var range –

var starting_turf – /turf

var target_position – /turf

Proc Details

↑Destroy()

↑atom_destruction(damage_flag)

proc attach_item(/obj/target)

↑attackby(/obj/item/target, /mob/living/user)

↑emag_act(/mob/user, /obj/item/card/emag/emag_card)

proc find_target_position()

proc handle_density()

proc on_attached_delete()

↑process()

proc remove_attached_item(/mob/user, throwing)

proc start_moving()

proc stop_moving(message)

proc toggle()

proc try_attack()

↑ui_act(action, /list/params, /datum/tgui/ui, /datum/ui_state/state)

↑ui_data(/mob/user)