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
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
obj_destruction	Called on a normal destruction, so we have a cool explosion and toss whatever's 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

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/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)

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

↑
obj_destruction
(damage_flag)

Called on a normal destruction, so we have a cool explosion and toss whatever's 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, params)

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()

proc attach_item(/obj/target)

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

↑emag_act(/mob/user)

proc find_target_position()

proc handle_density()

↑obj_destruction(damage_flag)

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, params)

↑ui_data(/mob/user)