drone

Maintenance Drone

Small player controlled fixer-upper

The maintenace drone is a ghost role with the objective to repair and maintain the station.

Featuring two dexterous hands, and a built in toolbox stocked with tools.

They have laws to prevent them from doing anything else.

Vars
built_in_camera	The camera built into the drone which allows it to be seen through cameras.
can_unhack	Whether this drone can be un-hacked. Used for subtypes that cannot be meaningfully "fixed".
colour	Stored drone color, restored when unhacked
default_headwear	Default /mob/living/basic/drone/var/head item
hacked	Hacked state, see /mob/living/basic/drone/proc/update_drone_hack
head	Headwear slot
heavy_emp_damage	Amount of damage sustained if hit by a heavy EMP pulse
internal_storage	Internal storage slot. Fits any item
l_store	Left pocket item reference
listener	Alarm listener datum, handes caring about alarm events and such
picked	`TRUE` if we have picked our visual appearance, `FALSE` otherwise (default)
r_store	Right pocket item reference
visualAppearance	icon_state of drone from icons/mobs/drone.dmi
Procs
alert_drones	Wraps /proc/_alert_drones with defaults
can_user_interact_with	Returns TRUE if the user is the same player as the target, an admin ghost, or otherwise authorized to act for them.
check_laws	Echoes drone laws to the user
check_menu	check_menu: Checks if we are allowed to interact with a radial menu
drone_chat	Wraps /mob/living/basic/drone/proc/alert_drones as a Drone Chat
drone_ping	Creates an alert to drones in the same network
get_armor_effectiveness	Returns a multiplier for any head armor you wear as a drone.
handle_alt_click	Handles Alt+Click interactions with drone restrictions.
handle_click	Handles general click interactions, including pocket access and drone restrictions.
liberate	Makes the drone into a Free Drone, who have no real laws and can do whatever they like. Only currently used for players wabbajacked into drones.
pickVisualAppearance	Prompt for user to pick /mob/living/basic/drone/var/visualAppearance
screwdriver_act	Screwdrivering repairs the drone to full hp, if it isn't dead.
try_reactivate	Called when a drone attempts to reactivate a dead drone
update_drone_hack	Hack or unhack a drone
update_drone_icon_hacked	Changes the icon state to a hacked version
wrench_act	Wrenching un-hacks hacked drones.

Var Details

var
built_in_camera
– /obj/machinery/camera/silicon

The camera built into the drone which allows it to be seen through cameras.

var
can_unhack

Whether this drone can be un-hacked. Used for subtypes that cannot be meaningfully "fixed".

var
colour

Stored drone color, restored when unhacked

var
default_headwear
– /obj/item

Default /mob/living/basic/drone/var/head item

var
hacked

Hacked state, see /mob/living/basic/drone/proc/update_drone_hack

var
head
– /obj/item

Headwear slot

var
heavy_emp_damage

Amount of damage sustained if hit by a heavy EMP pulse

var
internal_storage
– /obj/item

Internal storage slot. Fits any item

var
l_store
– /obj/item

Left pocket item reference

var
listener
– /datum/alarm_listener

Alarm listener datum, handes caring about alarm events and such

var
picked

TRUE if we have picked our visual appearance, FALSE otherwise (default)

var
r_store
– /obj/item

Right pocket item reference

var
visualAppearance

icon_state of drone from icons/mobs/drone.dmi

Possible states are:

Proc Details

proc
alert_drones
(msg, dead_can_hear)

Wraps /proc/_alert_drones with defaults

source - src
faction_check_atom - src
dead_can_hear - TRUE

proc
can_user_interact_with
(/mob/user)

Returns TRUE if the user is the same player as the target, an admin ghost, or otherwise authorized to act for them.

verb
check_laws
()

Echoes drone laws to the user

See [/mob/living/basic/drone/var/laws]

proc
check_menu
()

check_menu: Checks if we are allowed to interact with a radial menu

proc
drone_chat
(message, /list/spans, /list/message_mods)

Wraps /mob/living/basic/drone/proc/alert_drones as a Drone Chat

Shares the same radio code with binary

verb
drone_ping
()

Creates an alert to drones in the same network

Prompts user for alert level of:

Low
Medium
High
Critical

Attaches area name to message

proc
get_armor_effectiveness
()

Returns a multiplier for any head armor you wear as a drone.

proc
handle_alt_click
(/datum/source, /atom/clicked_atom, location, control, params)

Handles Alt+Click interactions with drone restrictions.

proc
handle_click
(/datum/source, /atom/clicked_atom, location, control, params)

Handles general click interactions, including pocket access and drone restrictions.

proc
liberate
()

Makes the drone into a Free Drone, who have no real laws and can do whatever they like. Only currently used for players wabbajacked into drones.

proc
pickVisualAppearance
()

Prompt for user to pick /mob/living/basic/drone/var/visualAppearance

Does nothing if there is no user

Called on [/mob/proc/Login]

↑
screwdriver_act
(/mob/living/user, /obj/item/tool)

Screwdrivering repairs the drone to full hp, if it isn't dead.

proc
try_reactivate
(/mob/living/user)

Called when a drone attempts to reactivate a dead drone

If the owner is still ghosted, will notify them. If the owner cannot be found, fails with an error message.

Arguments:

user - The /mob/living attempting to reactivate the drone

proc
update_drone_hack
(hack)

Hack or unhack a drone

This changes the drone's laws to destroy the station or resets them to normal.

Some debuffs are applied like slowing the drone down and disabling vent crawling

Arguments

hack - Boolean if the drone is being hacked or unhacked

proc
update_drone_icon_hacked
()

Changes the icon state to a hacked version

↑
wrench_act
(/mob/living/user, /obj/item/tool)

Wrenching un-hacks hacked drones.

drone /mob/living/basic/drone

Vars

Procs

Var Details

var built_in_camera – /obj/machinery/camera/silicon

var can_unhack

var colour

var default_headwear – /obj/item

var hacked

var head – /obj/item

var heavy_emp_damage

var internal_storage – /obj/item

var l_store – /obj/item

var listener – /datum/alarm_listener

var picked

var r_store – /obj/item

var visualAppearance

Proc Details

proc alert_drones(msg, dead_can_hear)

proc can_user_interact_with(/mob/user)

verb check_laws()

proc check_menu()

proc drone_chat(message, /list/spans, /list/message_mods)

verb drone_ping()

proc get_armor_effectiveness()

proc handle_alt_click(/datum/source, /atom/clicked_atom, location, control, params)

proc handle_click(/datum/source, /atom/clicked_atom, location, control, params)

proc liberate()

proc pickVisualAppearance()

↑screwdriver_act(/mob/living/user, /obj/item/tool)

proc try_reactivate(/mob/living/user)

proc update_drone_hack(hack)

proc update_drone_icon_hacked()

↑wrench_act(/mob/living/user, /obj/item/tool)