/atom/movable

Vars
affected_dynamic_lights	Lazylist to keep track on the sources of illumination.
affecting_dynamic_lumi	Highest-intensity light affecting us, which determines our visibility.
blocks_emissive	Either FALSE, EMISSIVE_BLOCK_GENERIC, or EMISSIVE_BLOCK_UNIQUE
buckle_lying	Bed-like behaviour, forces mob.lying = buckle_lying if not set to NO_BUCKLE_LYING.
can_be_unanchored	Used for the calculate_adjacencies proc for icon smoothing.
demo_last_loc	Last location of the atom for demo recording purposes
em_block	Internal holder for emissive blocker object, do not use directly use blocks_emissive
generic_canpass	If false makes CanPass call CanPassThrough on this type instead of using default behaviour
movement_type	In case you have multiple types, you automatically use the most useful one. IE: Skating on ice, flippers on water, flying over chasm/space, etc. Should only be changed through setMovetype()
Procs
CanPassThrough	Returns true or false to allow src to move through the blocker, mover has final say
CanReach	A backwards depth-limited breadth-first-search to see if the target is logically "in" anything adjacent to us.
Process_Spacemove	Called whenever an object moves and by mobs when they attempt to move themselves through space And when an object or action applies a force on src, see newtonian_move
add_blocked_language	Adds a language to the blocked language list. Use this over remove_language in cases where you will give languages back later.
attacked_by	Called from /obj/item/proc/attack_obj and /obj/item/proc/attack if the attack succeeds
can_speak_language	Checks if atom can speak the language.
copy_languages	Copies all languages into the supplied atom/language holder. Source should be overridden when you do not want the language overwritten by later atom updates or want to avoid blocked languages.
could_speak_language	Returns the result of tongue specific limitations on spoken languages.
get_language_holder	Gets or creates the relevant language holder. For mindless atoms, gets the local one. For atom with mind, gets the mind one.
get_random_spoken_language	Gets a random spoken language, useful for forced speech and such.
get_random_understood_language	Gets a random understood language, useful for hallucinations and such.
get_selected_language	Returns selected language, if it can be spoken, or finds, sets and returns a new selected language if possible.
grant_all_languages	Grants every language.
grant_language	Grants the supplied language and sets omnitongue true.
has_language	Checks if atom has the language. If spoken is true, only checks if atom can speak the language.
is_buckle_possible	Simple helper proc that runs a suite of checks to test whether it is possible or not to buckle the target mob to src.
is_user_buckle_possible	Simple helper proc that runs a suite of checks to test whether it is possible or not for user to buckle target mob to src.
newtonian_move	Only moves the object if it's under no gravity
on_enter_storage	called when this atom is added into a storage item, which is passed on as S. The loc variable is already set to the storage item.
on_exit_storage	called when this atom is removed from a storage item, which is passed on as S. The loc variable is already set to the new destination before this is called.
relay_container_resist_act	called when a mob resists while inside a container that is itself inside something.
remove_all_languages	Removes every language and sets omnitongue false.
remove_blocked_language	Removes a language from the blocked language list.
remove_language	Removes a single language.
setGrabState	Updates the grab state of the movable
setMovetype	Proc to modify the movement_type and hook behavior associated with it changing.
set_anchored	Sets the anchored var and returns if it was sucessfully changed or not.
set_light_range_power_color	Helper to change several lighting overlay settings.
set_pulledby	Reports the event of the change in value of the pulledby variable.
throw_at	If this returns FALSE then callback will not be called.
update_atom_languages	Empties out the atom specific languages and updates them according to the current atoms language holder. As a side effect, it also creates missing language holders in the process.
update_dynamic_luminosity	Keeps track of the sources of dynamic luminosity and updates our visibility with the highest.

Var Details

var
affected_dynamic_lights
– /list

Lazylist to keep track on the sources of illumination.

var
affecting_dynamic_lumi
–

Highest-intensity light affecting us, which determines our visibility.

var
blocks_emissive
–

Either FALSE, EMISSIVE_BLOCK_GENERIC, or EMISSIVE_BLOCK_UNIQUE

var
buckle_lying
–

Bed-like behaviour, forces mob.lying = buckle_lying if not set to NO_BUCKLE_LYING.

var
can_be_unanchored
–

Used for the calculate_adjacencies proc for icon smoothing.

var
demo_last_loc
– /atom

Last location of the atom for demo recording purposes

var
em_block
– /atom/movable/emissive_blocker

Internal holder for emissive blocker object, do not use directly use blocks_emissive

var
generic_canpass
–

If false makes CanPass call CanPassThrough on this type instead of using default behaviour

var
movement_type
–

In case you have multiple types, you automatically use the most useful one. IE: Skating on ice, flippers on water, flying over chasm/space, etc. Should only be changed through setMovetype()

Proc Details

proc
CanPassThrough
(/atom/blocker, /turf/target, blocker_opinion)

Returns true or false to allow src to move through the blocker, mover has final say

proc
CanReach
(/atom/ultimate_target, /obj/item/tool, view_only)

A backwards depth-limited breadth-first-search to see if the target is logically "in" anything adjacent to us.

proc
Process_Spacemove
(movement_dir)

Called whenever an object moves and by mobs when they attempt to move themselves through space And when an object or action applies a force on src, see newtonian_move

Return 0 to have src start/keep drifting in a no-grav area and 1 to stop/not start drifting

Mobs should return 1 if they should be able to move of their own volition, see /client/Move

Arguments:

movement_dir - 0 when stopping or any dir when trying to move

proc
add_blocked_language
(language, source)

Adds a language to the blocked language list. Use this over remove_language in cases where you will give languages back later.

proc
attacked_by
()

Called from /obj/item/proc/attack_obj and /obj/item/proc/attack if the attack succeeds

proc
can_speak_language
(language)

Checks if atom can speak the language.

proc
copy_languages
(from_holder, source_override)

Copies all languages into the supplied atom/language holder. Source should be overridden when you do not want the language overwritten by later atom updates or want to avoid blocked languages.

proc
could_speak_language
(language)

Returns the result of tongue specific limitations on spoken languages.

proc
get_language_holder
(get_minds)

Gets or creates the relevant language holder. For mindless atoms, gets the local one. For atom with mind, gets the mind one.

proc
get_random_spoken_language
()

Gets a random spoken language, useful for forced speech and such.

proc
get_random_understood_language
()

Gets a random understood language, useful for hallucinations and such.

proc
get_selected_language
()

Returns selected language, if it can be spoken, or finds, sets and returns a new selected language if possible.

proc
grant_all_languages
(understood, spoken, grant_omnitongue, source)

Grants every language.

proc
grant_language
(language, understood, spoken, source)

Grants the supplied language and sets omnitongue true.

proc
has_language
(language, spoken)

Checks if atom has the language. If spoken is true, only checks if atom can speak the language.

proc
is_buckle_possible
(/mob/living/target, force, check_loc)

Simple helper proc that runs a suite of checks to test whether it is possible or not to buckle the target mob to src.

Returns FALSE if any conditions that should prevent buckling are satisfied. Returns TRUE otherwise. Arguments:

target - Target mob to check against buckling to src.
force - Whether or not the buckle should be forced. If TRUE, ignores src's can_buckle var.
check_loc - Whether to do a proximity check or not. The proximity check looks for target.loc == src.loc.

proc
is_user_buckle_possible
(/mob/living/target, /mob/user, check_loc)

Simple helper proc that runs a suite of checks to test whether it is possible or not for user to buckle target mob to src.

Returns FALSE if any conditions that should prevent buckling are satisfied. Returns TRUE otherwise. Arguments:

target - Target mob to check against buckling to src.
user - The mob who is attempting to buckle the target to src.
check_loc - Whether to do a proximity check or not when calling is_buckle_possible().

proc
newtonian_move
(direction)

Only moves the object if it's under no gravity

proc
on_enter_storage
(/datum/component/storage/concrete/master_storage)

called when this atom is added into a storage item, which is passed on as S. The loc variable is already set to the storage item.

proc
on_exit_storage
(/datum/component/storage/concrete/master_storage)

called when this atom is removed from a storage item, which is passed on as S. The loc variable is already set to the new destination before this is called.

proc
relay_container_resist_act
(/mob/living/user, /obj/O)

called when a mob resists while inside a container that is itself inside something.

proc
remove_all_languages
(source, remove_omnitongue)

Removes every language and sets omnitongue false.

proc
remove_blocked_language
(language, source)

Removes a language from the blocked language list.

proc
remove_language
(language, understood, spoken, source)

Removes a single language.

proc
setGrabState
(newstate)

Updates the grab state of the movable

This exists to act as a hook for behaviour

proc
setMovetype
(newval)

Proc to modify the movement_type and hook behavior associated with it changing.

proc
set_anchored
(anchorvalue)

Sets the anchored var and returns if it was sucessfully changed or not.

proc
set_light_range_power_color
(range, power, color)

Helper to change several lighting overlay settings.

proc
set_pulledby
(new_pulledby)

Reports the event of the change in value of the pulledby variable.

proc
throw_at
(/atom/target, range, speed, /mob/thrower, spin, diagonals_first, /datum/callback/callback, force, gentle, quickstart)

If this returns FALSE then callback will not be called.

proc
update_atom_languages
()

Empties out the atom specific languages and updates them according to the current atoms language holder. As a side effect, it also creates missing language holders in the process.

proc
update_dynamic_luminosity
()

Keeps track of the sources of dynamic luminosity and updates our visibility with the highest.

/atom/movable

Vars

Procs

Var Details

var affected_dynamic_lights – /list

var affecting_dynamic_lumi –

var blocks_emissive –

var buckle_lying –

var can_be_unanchored –

var demo_last_loc – /atom

var em_block – /atom/movable/emissive_blocker

var generic_canpass –

var movement_type –

Proc Details

proc CanPassThrough(/atom/blocker, /turf/target, blocker_opinion)

proc CanReach(/atom/ultimate_target, /obj/item/tool, view_only)

proc Process_Spacemove(movement_dir)

proc add_blocked_language(language, source)

proc attacked_by()

proc can_speak_language(language)

proc copy_languages(from_holder, source_override)

proc could_speak_language(language)

proc get_language_holder(get_minds)

proc get_random_spoken_language()

proc get_random_understood_language()

proc get_selected_language()

proc grant_all_languages(understood, spoken, grant_omnitongue, source)

proc grant_language(language, understood, spoken, source)

proc has_language(language, spoken)

proc is_buckle_possible(/mob/living/target, force, check_loc)

proc is_user_buckle_possible(/mob/living/target, /mob/user, check_loc)

proc newtonian_move(direction)

proc on_enter_storage(/datum/component/storage/concrete/master_storage)

proc on_exit_storage(/datum/component/storage/concrete/master_storage)

proc relay_container_resist_act(/mob/living/user, /obj/O)

proc remove_all_languages(source, remove_omnitongue)

proc remove_blocked_language(language, source)

proc remove_language(language, understood, spoken, source)

proc setGrabState(newstate)

proc setMovetype(newval)

proc set_anchored(anchorvalue)

proc set_light_range_power_color(range, power, color)

proc set_pulledby(new_pulledby)

proc throw_at(/atom/target, range, speed, /mob/thrower, spin, diagonals_first, /datum/callback/callback, force, gentle, quickstart)

proc update_atom_languages()

proc update_dynamic_luminosity()