lift_master

coordinate and control movement across linked industrial_lift's. allows moving large single multitile platforms and many 1 tile platforms. also is capable of linking platforms across linked z levels

Vars
allowed_travel_directions	what directions we're allowed to move
controls_locked	if true, the lift cannot be manually moved.
create_multitile_platform	taken from our lift platforms. if true we go through each z level of platforms and attempt to make the lowest left corner platform into one giant multitile object the size of all other platforms on that z level.
ignored_smashthroughs	Typepath list of what to ignore smashing through, controls all lifts
lift_id	lift_id taken from our base lift platform, used to put us into GLOB.active_lifts_by_type
lift_platforms	the lift platforms we consider as part of this lift. ordered in order of lowest z level to highest z level after init. (the sorting algorithm sucks btw)
multitile_platform	whether the lift handled by this lift_master datum is multitile as opposed to nxm platforms per z level
specific_lift_id	overridable ID string to link control units to this specific lift_master datum. created by placing a lift id landmark object somewhere on the tram, if its anywhere on the tram we'll find it in init and set this to whatever it specifies
z_sorted	lift platforms have already been sorted in order of z level.
Procs
Check_lift_move	Check destination turfs
MoveLift	Moves the lift UP or DOWN, this is what users invoke with their hand. This is a SAFE proc, ensuring every part of the lift moves SANELY. It also locks controls for the (miniscule) duration of the movement, so the elevator cannot be broken by spamming. Arguments: going - UP or DOWN directions, where the lift should go. Keep in mind by this point checks of whether it should go up or down have already been done. user - Whomever made the lift movement.
MoveLiftHorizontal	Moves the lift, this is what users invoke with their hand. This is a SAFE proc, ensuring every part of the lift moves SANELY. It also locks controls for the (miniscule) duration of the movement, so the elevator cannot be broken by spamming.
Rebuild_lift_plaform	Collect all bordered platforms via a simple floodfill algorithm. allows multiz trams because its funny
check_for_landmarks	check for any landmarks placed inside the locs of the given lift_platform
create_multitile_platform_for_z_level	goes through all platforms in the given list and finds the one in the lower left corner
get_platforms_on_level	returns all industrial_lifts associated with this tram on the given z level or given atoms z level
order_platforms_by_z_level	orders the lift platforms in order of lowest z level to highest z level.
reset_lift_contents	resets the contents of all platforms to their original state in case someone put a bunch of shit onto the tram. intended to be called by admins. passes all arguments to reset_contents() for each of our platforms.
return_closest_platform_to	returns the closest lift to the specified atom, prioritizing lifts on the same z level. used for comparing distance
set_controls	Sets all lift parts's controls_locked variable. Used to prevent moving mid movement, or cooldowns.
set_info_from_id_landmark	set vars and such given an overriding lift_id landmark

Var Details

var
allowed_travel_directions
–

what directions we're allowed to move

var
controls_locked
–

if true, the lift cannot be manually moved.

var
create_multitile_platform
–

taken from our lift platforms. if true we go through each z level of platforms and attempt to make the lowest left corner platform into one giant multitile object the size of all other platforms on that z level.

var
ignored_smashthroughs
– /static/list

Typepath list of what to ignore smashing through, controls all lifts

var
lift_id
–

lift_id taken from our base lift platform, used to put us into GLOB.active_lifts_by_type

var
lift_platforms
– /list/obj/structure/industrial_lift

the lift platforms we consider as part of this lift. ordered in order of lowest z level to highest z level after init. (the sorting algorithm sucks btw)

var
multitile_platform
–

whether the lift handled by this lift_master datum is multitile as opposed to nxm platforms per z level

var
specific_lift_id
–

overridable ID string to link control units to this specific lift_master datum. created by placing a lift id landmark object somewhere on the tram, if its anywhere on the tram we'll find it in init and set this to whatever it specifies

var
z_sorted
–

lift platforms have already been sorted in order of z level.

Proc Details

proc
Check_lift_move
(check_dir)

Check destination turfs

proc
MoveLift
(going, /mob/user)

Moves the lift UP or DOWN, this is what users invoke with their hand. This is a SAFE proc, ensuring every part of the lift moves SANELY. It also locks controls for the (miniscule) duration of the movement, so the elevator cannot be broken by spamming. Arguments: going - UP or DOWN directions, where the lift should go. Keep in mind by this point checks of whether it should go up or down have already been done. user - Whomever made the lift movement.

proc
MoveLiftHorizontal
(going)

Moves the lift, this is what users invoke with their hand. This is a SAFE proc, ensuring every part of the lift moves SANELY. It also locks controls for the (miniscule) duration of the movement, so the elevator cannot be broken by spamming.

proc
Rebuild_lift_plaform
(/obj/structure/industrial_lift/base_lift_platform)

Collect all bordered platforms via a simple floodfill algorithm. allows multiz trams because its funny

proc
check_for_landmarks
(/obj/structure/industrial_lift/new_lift_platform)

check for any landmarks placed inside the locs of the given lift_platform

proc
create_multitile_platform_for_z_level
(/list/obj/structure/industrial_lift/platforms_in_z)

goes through all platforms in the given list and finds the one in the lower left corner

proc
get_platforms_on_level
(/atom/atom_reference_OR_z_level_number)

returns all industrial_lifts associated with this tram on the given z level or given atoms z level

proc
order_platforms_by_z_level
()

orders the lift platforms in order of lowest z level to highest z level.

proc
reset_lift_contents
(consider_anything_past, foreign_objects, foreign_non_player_mobs, consider_player_mobs)

resets the contents of all platforms to their original state in case someone put a bunch of shit onto the tram. intended to be called by admins. passes all arguments to reset_contents() for each of our platforms.

Arguments:

consider_anything_past - number. if > 0 our platforms will only handle foreign contents that exceed this number in each of their locs
foreign_objects - bool. if true our platforms will consider /atom/movable's that arent mobs as part of foreign contents
foreign_non_player_mobs - bool. if true our platforms consider mobs that dont have a mind to be foreign
consider_player_mobs - bool. if true our platforms consider player mobs to be foreign. only works if foreign_non_player_mobs is true as well

proc
return_closest_platform_to
(/atom/comparison, allow_multiple_answers)

returns the closest lift to the specified atom, prioritizing lifts on the same z level. used for comparing distance

proc
set_controls
(state)

Sets all lift parts's controls_locked variable. Used to prevent moving mid movement, or cooldowns.

proc
set_info_from_id_landmark
(/obj/effect/landmark/lift_id/landmark)

set vars and such given an overriding lift_id landmark

lift_master /datum/lift_master

Vars

Procs

Var Details

var allowed_travel_directions –

var controls_locked –

var create_multitile_platform –

var ignored_smashthroughs – /static/list

var lift_id –

var lift_platforms – /list/obj/structure/industrial_lift

var multitile_platform –

var specific_lift_id –

var z_sorted –

Proc Details

proc Check_lift_move(check_dir)

proc MoveLift(going, /mob/user)

proc MoveLiftHorizontal(going)

proc Rebuild_lift_plaform(/obj/structure/industrial_lift/base_lift_platform)

proc check_for_landmarks(/obj/structure/industrial_lift/new_lift_platform)

proc create_multitile_platform_for_z_level(/list/obj/structure/industrial_lift/platforms_in_z)

proc get_platforms_on_level(/atom/atom_reference_OR_z_level_number)

proc order_platforms_by_z_level()

proc reset_lift_contents(consider_anything_past, foreign_objects, foreign_non_player_mobs, consider_player_mobs)

proc return_closest_platform_to(/atom/comparison, allow_multiple_answers)

proc set_controls(state)

proc set_info_from_id_landmark(/obj/effect/landmark/lift_id/landmark)