tether

Creates a tether between two objects that limits movement range. Tether requires LOS and can be adjusted by left/right clicking its

Vars
cur_dist	Current extension distance
embed_target	Embedded item that the tether "should" originate from
force_moving_target	Are we currently attempting to forcefully shorten the tether?
max_dist	Maximum (and initial) distance that this tether can be adjusted to
no_target_trait	If TRUE, only add TRAIT_TETHER_ATTACHED to our parent
parent_module	Tether module if we were created by one
tether_beam	Beam effect
tether_name	What the tether is going to be called
tether_target	Other side of the tether
tether_trait_source	Ref of source, if any, for TRAIT_TETHER_ATTACHED we add
Procs
check_line	Check LOS availibility of a tile, returns a blocking atom, if any turf_cache could be used to reduce the amount of calculations if multiple lines are cast and expected to have multiple shared turfs by sharing located results
try_adjust_position	Try adjust the anchor's position to move closer to the target or regain LOS true_source is an optional argument in case we're looking for a LOS/closer turf to a new location rather than the actual owner, and need to ignore them

Var Details

var
cur_dist

Current extension distance

var
embed_target
– /atom

Embedded item that the tether "should" originate from

var
force_moving_target

Are we currently attempting to forcefully shorten the tether?

var
max_dist

Maximum (and initial) distance that this tether can be adjusted to

var
no_target_trait

If TRUE, only add TRAIT_TETHER_ATTACHED to our parent

var
parent_module
– /obj/item/mod/module/tether

Tether module if we were created by one

var
tether_beam
– /datum/beam

Beam effect

var
tether_name

What the tether is going to be called

var
tether_target
– /atom

Other side of the tether

var
tether_trait_source

Ref of source, if any, for TRAIT_TETHER_ATTACHED we add

Proc Details

proc
check_line
(/atom/start, /atom/end, /list/to_ignore, /list/turf_cache)

Check LOS availibility of a tile, returns a blocking atom, if any turf_cache could be used to reduce the amount of calculations if multiple lines are cast and expected to have multiple shared turfs by sharing located results

proc
try_adjust_position
(/atom/movable/anchor, /atom/target, /atom/true_source)

Try adjust the anchor's position to move closer to the target or regain LOS true_source is an optional argument in case we're looking for a LOS/closer turf to a new location rather than the actual owner, and need to ignore them

tether /datum/component/tether

Vars

Procs

Var Details

var cur_dist

var embed_target – /atom

var force_moving_target

var max_dist

var no_target_trait

var parent_module – /obj/item/mod/module/tether

var tether_beam – /datum/beam

var tether_name

var tether_target – /atom

var tether_trait_source