telecomms

The basic telecomms machinery type, implementing all of the logic that's shared between all of the telecomms machinery.

Vars
autolinkers	list of text/number values to link with
banned_frequencies	Illegal frequencies that can't be listened to by telecommunication servers.
hide	Is it a hidden machine?
id	identification string
links	list of machines this machine is linked to
links_by_telecomms_type	associative lazylist list of the telecomms_type of linked telecomms machines and a list of said machines. eg list(telecomms_type1 = list(everything linked to us with that type), telecomms_type2 = list(everything linked to us with THAT type)...)
long_range_link	Can you link it across Z levels or on the otherside of the map? (Relay & Hub)
netspeed	how much traffic to lose per second (50 gigabytes/second * netspeed)
network	the network of the machinery
on	Is it actually active or not?
soundloop	Looping sounds for any servers
telecomms_type	the relevant type path of this telecomms machine eg /obj/machinery/telecomms/server but not server/preset. used for links_by_telecomms_type
tempfreq	The current temporary frequency used to add new filtered frequencies options.
toggled	Is it toggled on, so is it /meant/ to be active?
traffic	value increases as traffic increases
Procs
add_act	Wrapper for adding another time of action for `ui_act()`, rather than having you override `ui_act` yourself.
add_automatic_link	Handles the automatic linking of another machine to this one.
add_new_link	Adds new_connection to src's links list AND vice versa. Also updates `links_by_telecomms_type`.
add_option	Wrapper for adding additional options to a machine's interface.
de_emp	Handles the machine stopping being affected by an EMP.
get_multitool	Returns a multitool from a user depending on their mobtype.
is_freq_listening	Checks whether the machinery is listening to that signal.
receive_information	Receive information from linked machinery
relay_direct_information	Sends a signal directly to a machine.
relay_information	relay signal to all linked machinery that are of type [filter]. If signal has been sent [amount] times, stop sending
remove_link	Removes old_connection from src's links list AND vice versa. Also updates `links_by_telecomms_type`.
update_power	Handles updating the power state of the machine, modifying its `on` variable based on if it's `toggled` and if it's either broken, has no power or it's EMP'd. Handles updating appearance based on that power change.

Var Details

var
autolinkers
– /list

list of text/number values to link with

var
banned_frequencies
– /list

Illegal frequencies that can't be listened to by telecommunication servers.

var
hide
–

Is it a hidden machine?

var
id
–

identification string

var
links
– /list

list of machines this machine is linked to

var
links_by_telecomms_type
– /list

associative lazylist list of the telecomms_type of linked telecomms machines and a list of said machines. eg list(telecomms_type1 = list(everything linked to us with that type), telecomms_type2 = list(everything linked to us with THAT type)...)

var
long_range_link
–

Can you link it across Z levels or on the otherside of the map? (Relay & Hub)

var
netspeed
–

how much traffic to lose per second (50 gigabytes/second * netspeed)

var
network
–

the network of the machinery

var
on
–

Is it actually active or not?

var
soundloop
– /datum/looping_sound/server

Looping sounds for any servers

var
telecomms_type
–

the relevant type path of this telecomms machine eg /obj/machinery/telecomms/server but not server/preset. used for links_by_telecomms_type

var
tempfreq
–

The current temporary frequency used to add new filtered frequencies options.

var
toggled
–

Is it toggled on, so is it /meant/ to be active?

var
traffic
–

value increases as traffic increases

Proc Details

proc
add_act
(action, params)

Wrapper for adding another time of action for ui_act(), rather than having you override ui_act yourself.

Returns TRUE if the action was handled, nothing if not.

proc
add_automatic_link
(/obj/machinery/telecomms/machine_to_link)

Handles the automatic linking of another machine to this one.

proc
add_new_link
(/obj/machinery/telecomms/new_connection, /mob/user)

Adds new_connection to src's links list AND vice versa. Also updates links_by_telecomms_type.

proc
add_option
()

Wrapper for adding additional options to a machine's interface.

Returns a list, or null if it wasn't implemented by the machine.

proc
de_emp
()

Handles the machine stopping being affected by an EMP.

proc
get_multitool
(/mob/user)

Returns a multitool from a user depending on their mobtype.

proc
is_freq_listening
(/datum/signal/signal)

Checks whether the machinery is listening to that signal.

Returns TRUE if found, FALSE if not.

proc
receive_information
(/datum/signal/signal, /obj/machinery/telecomms/machine_from)

Receive information from linked machinery

proc
relay_direct_information
(/datum/signal/signal, /obj/machinery/telecomms/machine)

Sends a signal directly to a machine.

proc
relay_information
(/datum/signal/subspace/signal, filter, copysig, amount)

relay signal to all linked machinery that are of type [filter]. If signal has been sent [amount] times, stop sending

proc
remove_link
(/obj/machinery/telecomms/old_connection, /mob/user)

Removes old_connection from src's links list AND vice versa. Also updates links_by_telecomms_type.

proc
update_power
()

Handles updating the power state of the machine, modifying its on variable based on if it's toggled and if it's either broken, has no power or it's EMP'd. Handles updating appearance based on that power change.

telecomms /obj/machinery/telecomms

Vars

Procs

Var Details

var autolinkers – /list

var banned_frequencies – /list

var hide –

var id –

var links – /list

var links_by_telecomms_type – /list

var long_range_link –

var netspeed –

var network –

var on –

var soundloop – /datum/looping_sound/server

var telecomms_type –

var tempfreq –

var toggled –

var traffic –