big_manipulator

Vars
current_task	The task we're currently working on.
held_object	The object inside the manipulator.
id_lock	Weakref to the ID that locked this manipulator.
interaction_point_limit	How many tasks total we can have.
manipulator_arm	The manipulator's arm.
master_tasking	Tasking strategy instance.
monkey_worker	The chimp worker that uses the manipulator (handles USE cases).
next_cycle_scheduled	Was the next cycle already scheduled?
on	Is the manipulator turned on?
power_access_wire_cut	Is the power access wire cut? Disables the power button if `TRUE`.
signal_turfs	Turfs we registered enter/exit signals on while waiting.
speed_multiplier	How quickly the manipulator will process it's actions.
stopping	Is the manipulator in the process of stopping?
task_disk	Inserted manipulator task disk.
tasking_strategy	Which tasking scenario we use for iterating tasks.
tasks	A list of tasks for the manipulator.
use_in_progress	Is a use interaction currently in progress? Prevents timer recursion.
waiting_for_signal	Is the manipulator waiting for a turf signal to retry?
Procs
complete_stopping_task	Completes the stopping task and transitions to idle
create_manipulator_arm	Attaching the arm effect to the core.
create_new_task	Attempts to create a new task and assign it to the list.
cycle_value	Cycles the given value in the given list.
do_step_rotation	Does a 45 degree step, animating the claw
drop_held_atom	Drop the held atom.
find_suitable_turf	Attempts to find a suitable turf near the manipulator for creating a cargo task.
finish_manipulation	Completes the current manipulation action and schedules the next step.
maybe_wake	Retries the task loop if we're waiting for a signal and the machine is on.
nothing_ever_happens	We have no tasks to execute for some reason. Waits for a turf signal to retry.
on_task_turf_changed	Fires when something enters or leaves a watched task turf.
process_upgrades	Checks the component tiers, adjusting the properties of the manipulator.
register_task_turf_signals	Registers enter/exit signals on all unique cargo task turfs.
remove_invalid_task	Removes an invalid task from the list.
restore_monkey_tracking	Restores monkey tracking after a temporary move outside src cleared it via Exited.
rotate_to_point	Rotates the manipulator arm to face the target task's turf.
schedule_next_cycle	Safely schedules the next step to prevent overlapping.
something_happened	A signal ran or some settings changed; checking if we can run the tasks now.
step_tasks	Runs the next task. Or doesn't.
try_kickstart	Attempts to launch the work cycle. Should only be ran on pressing the "Run" button.
try_press_on	Attempts to press the power button.
unregister_task_turf_signals	Unregisters all previously registered turf signals.
validate_all_tasks	Validates all cargo tasks, removing those on closed turfs.

Var Details

var
current_task
– /datum/manipulator_task

The task we're currently working on.

var
held_object
– /datum/weakref

The object inside the manipulator.

var
id_lock
– /datum/weakref

Weakref to the ID that locked this manipulator.

var
interaction_point_limit

How many tasks total we can have.

var
manipulator_arm
– /obj/effect/big_manipulator_arm

The manipulator's arm.

var
master_tasking
– /datum/tasking_strategy

Tasking strategy instance.

var
monkey_worker
– /datum/weakref

The chimp worker that uses the manipulator (handles USE cases).

var
next_cycle_scheduled

Was the next cycle already scheduled?

var
on

Is the manipulator turned on?

var
power_access_wire_cut

Is the power access wire cut? Disables the power button if TRUE.

var
signal_turfs
– /list

Turfs we registered enter/exit signals on while waiting.

var
speed_multiplier

How quickly the manipulator will process it's actions.

var
stopping

Is the manipulator in the process of stopping?

var
task_disk
– /obj/item/disk/manipulator

Inserted manipulator task disk.

var
tasking_strategy

Which tasking scenario we use for iterating tasks.

var
tasks
– /list

A list of tasks for the manipulator.

var
use_in_progress

Is a use interaction currently in progress? Prevents timer recursion.

var
waiting_for_signal

Is the manipulator waiting for a turf signal to retry?

Proc Details

proc
complete_stopping_task
()

Completes the stopping task and transitions to idle

proc
create_manipulator_arm
()

Attaching the arm effect to the core.

proc
create_new_task
(/mob/user, task_type, /turf/new_turf)

Attempts to create a new task and assign it to the list.

proc
cycle_value
(current_value, /list/possible_values)

Cycles the given value in the given list.

proc
do_step_rotation
(/datum/manipulator_task/cargo/target_task, callback_object, callback, current_angle, target_angle, rotation_step)

Does a 45 degree step, animating the claw

proc
drop_held_atom
()

Drop the held atom.

proc
find_suitable_turf
()

Attempts to find a suitable turf near the manipulator for creating a cargo task.

proc
finish_manipulation
()

Completes the current manipulation action and schedules the next step.

proc
maybe_wake
()

Retries the task loop if we're waiting for a signal and the machine is on.

proc
nothing_ever_happens
()

We have no tasks to execute for some reason. Waits for a turf signal to retry.

proc
on_task_turf_changed
(/datum/source)

Fires when something enters or leaves a watched task turf.

proc
process_upgrades
()

Checks the component tiers, adjusting the properties of the manipulator.

proc
register_task_turf_signals
()

Registers enter/exit signals on all unique cargo task turfs.

proc
remove_invalid_task
(/datum/manipulator_task/task)

Removes an invalid task from the list.

proc
restore_monkey_tracking
(/mob/living/carbon/human/species/monkey/monkey)

Restores monkey tracking after a temporary move outside src cleared it via Exited.

proc
rotate_to_point
(/datum/manipulator_task/cargo/target_task, callback_object, callback)

Rotates the manipulator arm to face the target task's turf.

proc
schedule_next_cycle
(time_seconds)

Safely schedules the next step to prevent overlapping.

proc
something_happened
()

A signal ran or some settings changed; checking if we can run the tasks now.

proc
step_tasks
()

Runs the next task. Or doesn't.

proc
try_kickstart
(/mob/user)

Attempts to launch the work cycle. Should only be ran on pressing the "Run" button.

proc
try_press_on
(/mob/living/carbon/human/user)

Attempts to press the power button.

proc
unregister_task_turf_signals
()

Unregisters all previously registered turf signals.

proc
validate_all_tasks
()

Validates all cargo tasks, removing those on closed turfs.

big_manipulator /obj/machinery/big_manipulator

Vars

Procs

Var Details

var current_task – /datum/manipulator_task

var held_object – /datum/weakref

var id_lock – /datum/weakref

var interaction_point_limit

var manipulator_arm – /obj/effect/big_manipulator_arm

var master_tasking – /datum/tasking_strategy

var monkey_worker – /datum/weakref

var next_cycle_scheduled

var on

var power_access_wire_cut

var signal_turfs – /list

var speed_multiplier

var stopping

var task_disk – /obj/item/disk/manipulator

var tasking_strategy

var tasks – /list

var use_in_progress

var waiting_for_signal

Proc Details

proc complete_stopping_task()

proc create_manipulator_arm()

proc create_new_task(/mob/user, task_type, /turf/new_turf)

proc cycle_value(current_value, /list/possible_values)

proc do_step_rotation(/datum/manipulator_task/cargo/target_task, callback_object, callback, current_angle, target_angle, rotation_step)

proc drop_held_atom()

proc find_suitable_turf()

proc finish_manipulation()

proc maybe_wake()

proc nothing_ever_happens()

proc on_task_turf_changed(/datum/source)

proc process_upgrades()

proc register_task_turf_signals()

proc remove_invalid_task(/datum/manipulator_task/task)

proc restore_monkey_tracking(/mob/living/carbon/human/species/monkey/monkey)

proc rotate_to_point(/datum/manipulator_task/cargo/target_task, callback_object, callback)

proc schedule_next_cycle(time_seconds)

proc something_happened()

proc step_tasks()

proc try_kickstart(/mob/user)

proc try_press_on(/mob/living/carbon/human/user)

proc unregister_task_turf_signals()

proc validate_all_tasks()