__DEFINES - This folder is full of #define statements. They are similar to constants,
but must come before any code that references them, and they do not take up
memory the way constants do.
research - Techweb names for new point types. Can be used to define specific point values for specific types of research (science, security, engineering, etc.)
render_plate - Custom rendering solution to allow for advanced effects
We (ab)use plane masters and render source/target to cheaply render 2+ planes as 1
if you want to read more read the _render_readme.md
materials - How material datums work
Materials are now instanced datums, with an associative list of them being kept in SSmaterials. We only instance the materials once and then re-use these instances for everything.
Learn AI - In ye olde days, we designed mob AI, and we built it into simple animals as they were the "non player controlled" mobs. Made sense at the time. But by coding AI directly into the mob, there was so little ability to make unique or complicated AI, and even when it was pulled off the code was hacky and non-reusable. the datum AI system was made to rectify these problems, and expand AI beyond just mobs.
edible - This component makes it possible to make things edible. What this means is that you can take a bite or force someone to take a bite (in the case of items).
These items take a specific time to eat, and can do most of the things our original food items could.
material_container - This datum should be used for handling mineral contents of machines and whatever else is supposed to hold minerals and make use of them.
swabbing - This component is used in vat growing to swab for microbiological samples which can then be mixed with reagents in a petridish to create a culture plate.
Contextual screentips (and when to not use this folder) - Contextual screentips provide information in the form of text at the top of your screen to inform you of the possibilities of an item. The "contextual" here refers to this being handled entirely through code, what it displays and when is completely up to you.
Progression Traitor Balance Guide - This guide will explain how the values for progression traitor works, how to balance progression traitors and what you should NOT do when balancing.
This guide will only explain progression values.
Preferences (by Mothblocks) - This does not contain all the information on specific values--you can find those as doc-comments in relevant paths, such as /datum/preference. Rather, this gives you an overview for creating most preferences, and getting your foot in the door to create more advanced ones.
In-code keypress handling system - This whole system is heavily based off of forum_account's keyboard library.
Thanks to forum_account for saving the day, the library can be found
here!
language/language_holder - Language holders will either exist in an atom/movable or a mind. Creation of language holders happens
automatically when they are needed, for example when something tries to speak.
Where a mind is available, the mind language holder will be the one "in charge". The mind holder
will update its languages based on the atom holder, and will get updated as part of
transformations and other events that cause new languages to become available.
Balistic gun icon states explained - For a unknown period of time, /obj/item/gun/ballistic used the wrong icon state for it's bolt_type and so, if you tried to copy how it worked to make your own gun, you'd get a broken sprite. This documentation is intended to explain in detail what some of the variables and functions do, and how to make your own gun subtypes that work properly.
screenshots - This folder contains the results for screenshot tests. Screenshot tests make sure an icon looks the same as it did before a change to prevent regressions.
security - When adding a new area to the security areas, make sure to add it to /datum/bounty/item/security/paperwork as well!
template_noop - Template noop (no operation) is used to skip a turf or area when the template is loaded this allows for template transparency
ex. if a ship has gaps in it's design, you would use template_noop to fill these in so that when the ship moves z-level, any
tiles these gaps land on will not be deleted and replaced with the ships (empty) tiles
atom - The base type for nearly all physical objects in SS13
plane_master_controller - Atom that manages and controls multiple planes. It's an atom so we can hook into add_filter etc. Multiple controllers can control one plane.
Of note: plane master controllers are currently not very extensively used, because render plates fill a semi similar niche
This could well change someday, and I'd like to keep this stuff around, so we use it for a few cases just out of convenience
colorblind - Exists for convienience when referencing all game render plates
game - Exists for convienience when referencing all game render plates
non_master - Exists for convienience when referencing all non-master render plates.
This is the whole game and the UI, but not the escape menu.
render_plane_relay - Render relay object assigned to a plane master to be able to relay it's render onto other planes that are not it's own
render_step - Internal atom that uses render relays to apply "appearance things" to a render source
Branch, subtypes have behavior
color - Render step that modfies an atom's color
Useful for creating coherent emissive blockers out of things like glass floors by lowering alpha statically using matrixes
Other stuff too I'm sure
emissive_blocker - Render step that makes the passed in render source block emissives
default - Plane master that byond will by default draw to
Shouldn't be used, exists to prevent people using plane 0
NOTE: If we used SEE_BLACKNESS on a map format that wasn't SIDE_MAP, this is where its darkness would land
This would allow us to control it and do fun things. But we can't because side map doesn't support it, so this is just a stub
emissive - Handles emissive overlays and emissive blockers.
floor - Contains just the floor
o_light_visual - This will not work through multiz, because of a byond bug with BLEND_MULTIPLY
Bug report is up, waiting on a fix
command_spiders - Sends a message to all currently living spiders.
consume - This action lets you consume the mob you're currently pulling. I'M GONNA CONSUUUUUME (this is considered one of the funny memes in the 2019-2020 era)
cooldown - Preset for an action that has a cooldown.
exquisite_bunch - spawns a plumb bunch of bananas imbued with mystical power.
fugu_expand - Action which inflates you, making you larger and stronger for the duration. Also invulnerable.
This is pretty much all just handled by a status effect.
Unfortunately the requirements here are specific enough that it kind of only works for the mob it is designed for.
gel_cocoon - This action lets you put a mob inside of a cacoon that will inject it with some chemicals.
globules - Ability that allows the owner to fire healing globules at mobs, targetting specific limbs.
grand_ritual - The Grand Ritual is the Wizard's alternate victory condition
and also a tool to make funny distractions and progress the round state.
lay_web - Make a sticky web under yourself for area fortification
genetic - Variant for genetics, created webs only allow the creator passage
sealer - Variant which allows webs to be stacked into walls
metabolicboost - This ability lets the gelatinious ooze speed up for a little bit
Magicarp Bolt - Holder ability simply for "firing a projectile with a cooldown".
Probably won't do anything if assigned via VV unless you also VV in a projectile for it.
monster_core_action - Boilerplate to set the name and icon of the cooldown action.
Makes it call 'ui_action_click' when the action is activated.
adrenal_boost - Action used by the rush gland
exhale_brimdust - Action used by the brimdust sac
regenerative_core - Action used by the regenerative core
regurgitate - This ability will let you fire one random item from your pouch,
riot - This action checks some nearby maintenance animals and makes them your minions.
If none are nearby, creates a new mouse.
rustle - drops peels around the mob when activated
The spell action - This is the base action for how many of the game's
spells (and spell adjacent) abilities function.
These spells function off of a cooldown-based system.
sanguine_strike - Enchants an item to deal either double damage, or +20 damage, whichever is less, and lifesteals for that amount + steals some blood.
multiplication can get a little instakill-y, so capping it at + 20 damage.
10 force weapon doesn't get the cap and gains 10 damage, 20 total
20 force weapon gets the cap of 20 damage added for a total of 40
35 force weapon still gets the cap of 20 for a total of 55 instead of a whopping 70 damage
Steals 50 blood if they have enough. Splattercasting has one second of cooldown worth 5 blood, so 50 seconds cooldown of blood added!
scream_for_me - Weaker smite, not outright gibbing your target, but a lot more bloody, and Sanguine school, so doesn't get affected by splattercasting.
sign_language - Allows a Carbon to toggle sign language on/off. The button is invisible for mute Carbons.
Theory of Operation:
A. If TRAIT_SIGN_LANG is added/removed, and the button is visible, then update the button.
B. React to presence of trait TRAIT_MUTE for quality/convenience purposes:
C. If TRAIT_MUTE is added, then activate and hide the Action.
D. If TRAIT_MUTE is then removed, then show the Action.
addiction - base class for addiction, handles when you become addicted and what the effects of that are. By default you become addicted when you hit a certain threshold, and stop being addicted once you go below another one.
alcohol - Alcohol
medicine - Makes you a hypochondriac - I'd like to call it hypochondria, but "I could use some hypochondria" doesn't work
carp/magic - Interrupt your attack chain if: you have a spell, it's not on cooldown, and it has a target
dog - Pursue the target, growl if we're close, and bite if we're adjacent
Dogs are actually not very aggressive and won't attack unless you approach them
Adds a floor to the melee damage of the dog, as most pet dogs don't actually have any melee strength
pet_follow_friend - Just keep following the target until the command is interrupted
pet_use_ability - Pet owners can't see their pet's ability cooldowns so we keep attempting to use an ability until we succeed
pick_up_item - Simple behaviour for picking up an item we are already in range of.
The blackboard storage key isn't very safe because it doesn't make sense to register signals in here.
Use the AI held item component to manage this.
spin_web - Move to an unwebbed nearby turf and web it up
Step towards turf - Moves a short distance towards a location repeatedly until you arrive at the destination.
You'd use this over travel_towards if you're travelling a long distance over a long time, because the AI controller has a maximum range.
Step towards turf in area - Moves a short distance towards a location in an area
Unlike step_towards_turf it will reacquire a new turf from the area if it loses its target
target_from_retaliate_list - Picks a target from a provided list of atoms who have been pissing you off
You will probably need /datum/element/ai_retaliate to take advantage of this unless you're populating the blackboard yourself
nearest - As above but targets have been filtered from the 'retaliate' blackboard list
Targeted Mob Ability - Attempts to use a mob's cooldown ability on a target
Try Mob Ability and clear target - Attempts to use a mob's cooldown ability on a target and releases the target when the action completes
Try Mob Ability and plan execute - Attempts to use a mob's cooldown ability on a target and then move the target into a special target blackboard datum
Doesn't need another subtype to clear BB_BASIC_MOB_EXECUTION_TARGET because it will be the target key for the normal action
tipped_reaction - type of tipped reaction that is akin to puppy dog eyes
Travel Towards - Moves towards the atom in the passed blackboard key.
Planning continues during this action so it can be interrupted by higher priority actions.
Travel Towards Atom - Travel towards an atom you pass directly from the controller rather than a blackboard key.
You might need to do this to avoid repeating some checks in both a controller and an action.
use_in_hand - Use in hand the currently held item
use_on_object - Use the currently held item, or unarmed, on a weakref to an object in the world
pet - Carp which bites back, but doesn't look for targets.
'Not hunting targets' includes food (and can rings), because they have been well trained.
ranged - AI for carp with a spell.
Flow is basically the same as regular carp, except it will try and cast a spell at its target whenever possible and not fleeing.
cow/moonicorn - stop killing my FRIENDS
dog/corgi - Same thing but with make tiny corgis and use access cards.
giant_spider - Attacks people it can see, spins webs if it can't see anything to attack.
pest - Retaliates, hunts other maintenance creatures, runs away from larger attackers, and spins webs.
retaliate - Used by Araneus, who only attacks those who attack first. He is house-trained and will not web up the HoS office.
weak - Giant spider which won't attack structures
mouse - The mouse AI controller
guaranteed_to_bite - Dummy mouse's ai controller that is guaranteed to find and bite a cable beneath it
rat - AI controller for rats, slightly more complex than mice becuase they attack people
wumborian_fugu - Cowardly when small, aggressive when big. Tries to transform whenever possible.
cursed item ai! - Haunted AI tries to not be interacted with, and will attack people who do.
Cursed AI instead tries to be interacted with, and will attempt to equip itself onto people.
Added by /datum/element/cursed, and as such will try to remove this element and go dormant when it finds a victim to curse
ai_module - The base module type, which holds info about each ability.
destructive - Modules causing destruction
blackout - Blackout: Overloads a random number of lights across the station. Three uses.
destroy_rcd - Destroy RCDs: Detonates all non-cyborg RCDs on the station.
lockdown - Hostile Station Lockdown: Locks, bolts, and electrifies every airlock on the station. After 90 seconds, the doors reset.
megahonk - HIGH IMPACT HONKING
nuke_station - Doomsday Device: Starts the self-destruct timer. It can only be stopped by killing the AI completely.
overload_machine - Overload Machine: Allows the AI to overload a machine, detonating it after a delay. Two uses per purchase.
override_machine - Override Machine: Allows the AI to override a machine, animating it into an angry, living version of itself.
upgrade - Modules that are improving AI abilities and assets
eavesdrop - Enhanced Surveillance: Enables AI to hear conversations going on near its active vision.
mecha_domination - Unlock Mech Domination: Unlocks the ability to dominate mechs. Big shocker, right?
upgrade_cameras - Upgrade Camera Network: EMP-proofs all cameras, in addition to giving them X-ray vision.
upgrade_turrets - AI Turret Upgrade: Increases the health and damage of all turrets.
utility - Modules with stealthy and utility uses
break_air_alarms - Air Alarm Safety Override: Unlocks the ability to enable flooding on all air alarms.
break_fire_alarms - Thermal Sensor Override: Unlocks the ability to disable all fire alarms from doing their job.
emergency_lights - Disable Emergency Lights
place_cyborg_transformer - Robotic Factory: Places a large machine that converts humans that go through it into cyborgs. Unlocking this ability removes shunting.
reactivate_cameras - Reactivate Camera Network: Reactivates up to 30 cameras across the station.
ai_movement - This datum is an abstract class that can be overriden for different types of movement
basic_avoidance - Uses Byond's basic obstacle avoidance movement
dumb - The most brain-dead type of movement, bee-line to the target with no concern of whats in front of us.
jps - This movement datum represents smart-pathing
ai_planning_subtree - A subtree is attached to a controller and is occasionally called by /ai_controller/SelectBehaviors(), this mainly exists to act as a way to subtype and modify SelectBehaviors() without needing to subtype the ai controller itself
attack_obstacle_in_path - If there's something between us and our target then we need to queue a behaviour to make it not be there
basic_melee_attack_subtree/magicarp - As basic attack tree but interrupt if your health gets low or if your spell is off cooldown
Carp Migration - Will try to plan a path between a list of locations for carp to travel through
dog_harassment - Find someone we don't like and annoy them
find_and_hunt_target - Tells the AI to find a certain target nearby to hunt.
If a target has been found, we will start to move towards it, and eventually attack it.
look_for_cables/guaranteed - Cable hunting subtree that's guarantee to hunt its target.
find_food - similar to finding a target but looks for food types in the
find_nearest_magicarp_spell_target - Find a target for the magicarp's spell
This gets weird because different spells want different targetting
but I didn't want a new ai controller for every different spell
find_nearest_thing_which_attacked_me_to_flee - Find the nearest thing on our list of 'things which have done damage to me' and set it as the flee target
find_unwebbed_turf - Search for a nearby location to put webs on
flee_target - Try to escape from your current target, without performing any other actions.
from_flee_key - Try to escape from your current target, without performing any other actions.
Reads from some fleeing-specific targetting keys rather than the current mob target.
mouse - Don't look for anything to run away from if you are distracted by being adjacent to cheese
Pet Planning - Perform behaviour based on what pet commands you have received. This is delegated to the pet command datum.
When a command is set, we blackboard a key to our currently active command.
The blackboard also has a weak reference to every command datum available to us.
We use the key to figure out which datum to run, then ask it to figure out how to execute its action.
simple_find_nearest_target_to_flee - Find the nearest thing which we assume is hostile and set it as the flee target
spin_web - Run the spin web behaviour if we have an ability to use for it
target_retaliate - Sets the BB target to a mob which you can see and who has recently attacked you
to_flee - Places a mob which you can see and who has recently attacked you into some 'run away from this' AI keys
Can use a different targetting datum than you use to select attack targets
Not required if fleeing is the only target behaviour or uses the same target datum
use_mob_ability - Simple behaviours which simply try to use an ability whenever it is available.
For something which wants a target try targetted_mob_ability.
enemy_of_the_revolution - When the revolution wins, any remaining heads and security become Enemies of the Revolution.
Previously being nonantagonists, they only have one simple objective: survive!
enemy_of_the_state - When the station wins, any remaining living headrevs become Enemies of the State, a small solo antagonist.
They either have the choice to fuck off and do their own thing, or try and regain their honor with a hijack.
shade_minion - This datum is for use by shades who have a master but are not cultists.
Cult shades don't get it because they get the cult datum instead.
They are bound to follow the orders of their creator, probably a chaplain or miner.
Technically they're not 'antagonists' but they have antagonist-like properties.
wizard_prank_vendetta - Antag datum to give to people who want to kill the wizard.
This doesn't preclude other people choosing to want to kill the wizard, just these people are rewarded for it.
armor - The armor datum holds information about different types of armor that an atom can have.
It also contains logic and helpers for calculating damage and effective damage
crate_syndicrate - if the crate takes damage it will explode 25% of the time
immune - A version of armor that cannot be modified and will always return itself when attempted to be modified
item_tank - Closes the tank if dropped while open.
suit_space - If this is FALSE the batery status UI will be disabled. This is used for suits that don't use bateries like the changeling's flesh suit mutation.
armour_dimensional_theme - Datum describing a 'theme' which transforms a 3x3 area's turfs when applied.
It also creates a number of themed barriers in that area.
dangerous - Dangerous themes can potentially impede the user as much as people pursuing them
body_zones - Spritesheet for body zones. Necessary if your tgui uses BodyZoneSelector
namespaced - Namespace'ed assets (for static css and html files)
When sent over a cdn transport, all assets in the same asset datum will exist in the same folder, as their plain names.
Used to ensure css files can reference files by url() without having to generate the css at runtime, both the css file and the files it depends on must exist in the same namespace asset datum. (Also works for html)
For example blah.css with asset blah.png will get loaded as namespaces/a3d..14f/f12..d3c.css and namespaces/a3d..14f/blah.png. allowing the css file to load blah.png by a relative url rather then compute the generated url with get_url_mappings().
The namespace folder's name will change if any of the assets change. (excluding parent assets)
antagonist_hud - An alternate appearance that will show all the antagonists this mob has
has_antagonist - An alternate appearance that will only show if you have the antag datum
autowiki - A representation of an automated wiki page.
auxtools_promise - Auxtools hooks act as "set waitfor = 0" procs. This means that whenever
a proc directly called from auxtools sleeps, the hook returns with whatever
the called proc had as its return value at the moment it slept. This may not
be desired behavior, so this datum exists to wrap these procs.
basketball_controller - The basketball controller handles the basketball minigame in progress.
It is first created when the first ghost signs up to play.
bodypart_overlay - Bodypart ovarlay datum. These can be added to any limb to give them a proper overlay, that'll even stay if the limb gets removed
This is the abstract parent, don't use it!!
mutant - Variant of bodypart_overlay meant to work synchronously with external organs. Gets imprinted upon Insert in on_species_gain
antennae - Moth antennae datum, with full burning functionality
pod_hair - Podperson bodypart overlay, with special coloring functionality to render the flowers in the inverse color
spines - Bodypart overlay for spines (wagging gets updated by tail)
tail - Tail parent type (which is MONKEEEEEEEEEEE by default), with wagging functionality
cat - Cat tail bodypart overlay
lizard - Lizard tail bodypart overlay datum
monkey - Monkey tail bodypart overlay
wings - Bodypart overlay of default wings. Does not have any wing functionality
functional - Bodypart overlay of function wings, including open and close functionality!
moth - Moth wing bodypart overlay, including burn functionality!
simple - For simple overlays that really dont need to be complicated. Sometimes icon_state and icon is enough
Remember to set the layers or shit wont work
centcom_announcer - Data holder for the announcers that can be used in a game, this can be used to have alternative announcements outside of the default e.g.the intern
metalgen - Random recipe for meme chem metalgen. Always requires wittel and resets every 3 days
slime - End example
surfactant - foam and foam precursor
virus_food - VIROLOGY
cinematic - Cinematic datum. Used to show an animation to everyone.
cult_arm - A blood cult summoned Nar'sie, and most of the station was harvested or converted!
cult_fail - A blood cult summoned Nar'sie, but some badass (or admin) managed to destroy Nar'sie themselves.
malf - A malfunctioning AI has activated the doomsday device and wiped the station!
nuke - Simple, base cinematic for all animations based around a nuke detonating.
clown - The clown operative nuclear bomb was activated and clowned the station!
cult - A blood cult summoned Nar'sie, but central command deployed a nuclear package to stop them.
fake - A fake version of the nuclear detonation, where it winds up, but doesn't explode.
far_explosion - The syndicate nuclear bomb was activated, but just missed the station by a whole z-level!
mutual_destruction - The syndicate nuclear bomb was activated, and the nuclear operatives failed to extract on their shuttle before it detonated on the station!
no_core - A fake version of the nuclear detonation, where it winds up, but doesn't explode as the nuke core within was missing.
ops_miss - The syndicate nuclear bomb was activated, but just barely missed the station!
ops_victory - The syndicate nuclear bomb was activated, and destroyed the station!
self_destruct - The self destruct, or another station-destroying entity like a blob, destroyed the station!
self_destruct_miss - The self destruct was activated, yet somehow avoided destroying the station!
circuit_composite_template - A template used to make composite datatypes for circuits.
Used so that we don't have to generate every single possible combination of types
circuit_datatype - A circuit datatype. Used to determine the datatype of a port and also handle any additional behaviour.
circuit_variable - A circuit variable that holds the name, the datatype and the colour of the variable (taken from the datatype).
client_colour - Client Colour Priority System By RemieRichards (then refactored by another contributor)
A System that gives finer control over which client.colour value to display on screen
so that the "highest priority" one is always displayed as opposed to the default of
"whichever was set last is displayed".
client_interface - This should match the interface of /client wherever necessary.
colorblind_tester - Used to test the game for issues with different types of color blindness
WARNING ASSHOLE: Because we can only apply matrixes, and can't preform gamma correction
https://web.archive.org/web/20220227030606/https://ixora.io/projects/colorblindness/color-blindness-simulation-research/
The results of this tool aren't perfect. It's way better then nothing, but IT IS NOT A PROPER SIMULATION
Please do not make us look like assholes by assuming it is. Thanks.
colored_assistant - Defines a style of jumpsuit/jumpskirt for assistants.
Jumpsuit and jumpskirt lists should match in colors, as they are used interchangably.
solid - Will pick one color, and stick with it
command_report_menu - Datum for holding the TGUI window for command reports.
action_item_overlay - Apply to an action to allow it to take an item
and apply it as an overlay of the action button
admin_popup - Applied to clients when they receive an admin popup, alerting them to
their ticket.
ai_retaliate_advanced - Attached to a mob with an AI controller, passes things which have damaged it to a blackboard.
The AI controller is responsible for doing anything with that information.
anti_magic - This provides different types of magic resistance on an object
aquarium_content - Allows movables to be inserted/displayed in aquariums.
area_sound_manager - Allows you to set a theme for a set of areas without tying them to looping sounds explicitly
areabound - Movables with this component will automatically return to their original turf if moved outside their initial area
atmos_reaction_recorder - Component for atmos-related atoms to be able to record and transmit their reaction_results data
Use this ONLY for atoms, gasmixtures will be accessed by calling return air on the object.
Add this component after gasmixes has been initialized.
aura_healing - Applies healing to those in the area.
Will provide them with an alert while they're in range, as well as
give them a healing particle.
Can be applied to those only with a trait conditionally.
bakeable - This component indicates this object can be baked in an oven.
blood_walk - Blood walk, a component that causes you to make blood wherever you walk.
bloodysoles - Component for clothing items that can pick up blood from decals and spread it around everywhere when walking, such as shoes or suits with integrated shoes.
feet - Like its parent but can be applied to carbon mobs instead of clothing items
boomerang - If an ojvect is given the boomerang component, it should be thrown back to the thrower after either hitting it's target, or landing on the thrown tile.
Thrown objects should be thrown back to the original thrower with this component, a number of tiles defined by boomerang_throw_range.
circuit_component_add_port - Helper component that handles users adding/removing ports from a circuit component.
cleaner - Component that can be used to clean things.
Takes care of duration, cleaning skill and special cleaning interactions.
A callback can be set by the datum holding the cleaner to add custom functionality.
Soap uses a callback to decrease the amount of uses it has left after cleaning for example.
clickbox - This component adds a near-invisible underlay to a movable target to expand the clickable surface of its icon without
resorting to MOUSE_OPACITY_OPAQUE.
The underlay ignores the parent's color and alpha and can be offset.
The name is a portmanteau of "click" and "hitbox", because technically this isn't an hitbox,
but it helps catch clicks, and I don't want to give it a loooong name like openspace_item_click_handler
clothing_fov_visor - An element to add a FOV trait to the wearer, removing it when an item is unequipped, but only as long as the visor is up.
codeword_hearing - Component that allows for highlighting of words or phrases in chat based on regular expressions.
connect_containers - This component behaves similar to connect_loc_behalf, but it's nested and hooks a signal onto all MOVABLES containing this atom.
connect_loc_behalf - This component behaves similar to connect_loc, hooking into a signal on a tracked object's turf
It has the ability to react to that signal on behalf of a separate listener however
This has great use, primarily for components, but it carries with it some overhead
So we do it separately as it needs to hold state which is very likely to lead to bugs if it remains as an element.
connect_mob_behalf - This component behaves similar to connect_loc_behalf, but working off clients and mobs instead of loc
To be clear, we hook into a signal on a tracked client's mob
We retain the ability to react to that signal on a seperate listener, which makes this quite powerful
connect_range - This component behaves similar to connect_loc_behalf but for all turfs in range, hooking into a signal on each of them.
Just like connect_loc_behalf, It can react to that signal on behalf of a seperate listener.
Good for components, though it carries some overhead. Can't be an element as that may lead to bugs.
container_item - Container item, an item which can be stored by specialized containers.
tank_holder - Tank holder item - Added to an object which can be added to a tank holder.
convey - Manages the loop caused by being on a conveyor belt
Prevents movement while you're floating, etc
Takes the direction to move, delay between steps, and time before starting to move as arguments
cracked - Tracks damage to add or remove crack overlays, when none are needed this components is qdeleted
crate_carrier - Component for simplemobs and basicmobs that allow them to carry crates.
curse_of_hunger - curse of hunger component; for very hungry items.
customizable_reagent_holder - check hp
poisoned food damages it
no food found, but you're dead: it bites you slightly, and doesn't regain health.
no food found: it bites you and regains some health.
dejavu - A component to reset the parent to its previous state after some time passes
timeline - differently themed dejavu for modsuits.
deployable - Deployable - Bring your big guns with you, and smack em' down where you want.
drift - Component that handles drifting
Manages a movement loop that actually does the legwork of moving someone
Alongside dealing with the post movement input blocking required to make things look nice
egg layer component! - Component that manages how many eggs to lay, what can be fed to the mob to make them lay more, and what is actually laid.
Since the only real interaction with the component is an attackby, the nice part is that we're able to make this an atom level proc.
egg_layer will loudly fail if you do not provide it the arguments, as to encourage explicicy(?)
electrified_buckle component: - attach it to any atom/movable that can be buckled to in order to have it shock mobs buckled to it. by default it shocks mobs buckled to parent every shock_loop_time.
the parent is supposed to define its behavior with arguments in AddComponent
engraved component! - component for walls that applies an engraved overlay and lets you examine it to read a story (+ art element yay)
new creations will get a high art value, cross round scrawlings will get a low one.
MUST be a component, though it doesn't look like it. SSPersistence demandeth
Experiment Handler - This is the component for interacting with experiments from a connected techweb. It is generic
and should be set-up to automatically work on any class it is attached to without outside code
(Excluding potential callbacks)
explodable - Component specifically for explosion sensetive things, currently only applies to heat based explosions but can later perhaps be used for things that are dangerous to handle carelessly like nitroglycerin.
food_storage - --Food storage component--
This component lets you slide one item into large foods, such as bread, cheese wheels, or cakes.
Consuming food storages with an item inside can cause unique interactions, such as eating glass shards.
force_move - Forced directional movement, but with a twist
Let's block pressure and client movements while doing it so we can't be interrupted
Supports spinning on each move, for lube related reasons
fov_handler - Component which handles Field of View masking for clients. FoV attributes are at /mob/living
gas_leaker - A component to leak gas over time from damaged objects with gas storage
geiger_sound - Atoms with this component will play sounds depending on nearby radiation
genetic_damage - Genetic damage, given by DNA consoles, will start to deal toxin damage
past a certain threshold, and will go down consistently.
Adding multiple of this component will increase the total damage.
Can turn monkeys into gorillas.
gps - GPS component. Atoms that have this show up on gps. Pretty simple stuff.
item - GPS component subtype. Only gps/item's can be used to open the UI.
haunted_item - Makes our item SUPER spooky!
Adds the haunted element and some other bonuses
hazard_area - This is a relatively simple component that attempts to deter the parent of the component away
from a specific area or areas. By default it simply applies a penalty where all movement is
four times slower than usual and any action that would affect your 'next move' has a penalty
multiplier of 4 attached.
Healing Touch component - A mob with this component will be able to heal certain targets by attacking them.
This intercepts the attack and starts a do_after if the target is in its allowed type list.
ice_cream_holder - Ice Cream Holder: Allows the edible parent object to be used as an ice cream cone (or cup... in a next future).
interaction_booby_trap - Attached to an atom, creates an explosion when it is interacted with
irradiated - This atom is irradiated, and will glow green.
Humans will take toxin damage until all their toxin damage is cleared.
itembound - When a movable has this component AND they are in the contents of a container, they will no longer be able to use their hands and be immobilized until they are removed from the container. So far, this is only useful for smites.
knockoff - Items with this component will have a chance to get knocked off
(unequipped and sent to the ground) when the wearer is disarmed or knocked down.
light_eater - Makes anything it attaches to capable of removing something's ability to produce light until it is destroyed
Living Heart Component - Applied to a heart to turn it into a heretic's 'living heart'.
The living heart is what they use to track people they need to sacrifice.
Mind Linker - A component that handles linking multiple player's minds
into one network which allows them to talk directly to one another.
Like telepathy but for multiple people at once!
mob_harvest - Harvesting component. Useful if you want to be able to harvest items from living mobs.
multiple_lives - A simple component that spawns a mob of the same type and transfers itself to it when parent dies.
For more complex behaviors, use the COMSIG_ON_MULTIPLE_LIVES_RESPAWN comsig.
Nuclear Bomb Operator - Component applied to handless non-carbon mobs to allow them to perform the function of a nuclear operative.
Effectively this means they need to be able to:
Obeys Commands Component - Manages a list of pet command datums, allowing you to boss it around
Creates a radial menu of pet commands when this creature is alt-clicked, if it has any
omen - omen.dm: For when you want someone to have a really bad day
quirk - The quirk omen. Permanent.
Has only a 50% chance of bad things happening, and takes only 25% of normal damage.
smite - The smite omen. Permanent.
onwear_mood - Add to clothing to give the wearer a mood buff and a unique examine text
overlay_lighting - Movable atom overlay-based lighting component.
palette - A component that stores colors for use by painting-related items like spraycans or palettes
which can be accessed through a radial menu by right clicking the item while it's held by the user mob.
Right-clicking a color will open a color input prompt to edit it. Left clicking will instead select it
and call set_painting_tool_color() on the parent for more specific object behavior.
payment - Handles simple payment operations where the cost of the object in question doesn't change.
pinata - Objects or mobs with this componenet will drop items when taking damage.
plane_hide_highest_offset - Component that takes a plane master, and will hide it if it's the highest offset of its kind
This allows us to not show PMs to clients if they're not actively doing anything
acidic_input - Special connect that we currently use for reaction chambers. Being used so we can keep certain inputs separate, like into a special internal acid container
alkaline_input - Special connect that we currently use for reaction chambers. Being used so we can keep certain inputs separate, like into a special internal base container
buffer - Baby component for the buffer plumbing machine
filter - The magical plumbing component used by the chemical filters. The different supply connects behave differently depending on the filters set on the chemical filter
hydroponics - Special demand connector that consumes as normal, but redirects water into the magical water space.
iv_drip - Component for IVs that tracks the current person being IV'd. Input received through plumbing is instead routed to the whoever is attached
simple_demand - has one pipe input that only takes, example is manual output pipe
simple_supply - has one pipe output that only supplies. example is liquid pump and manual input pipe
pry_open_door - Attached to a basic mob.
Causes attacks on doors to attempt to open them.
puzzgrid - Attaches a puzzgrid to the atom.
You are expected to pass in the puzzgrid, likely from create_random_puzzgrid().
This is so you can handle when a puzzgrid can't be generated, either because the
config does not exist, or because the config is not set up properly.
radiation_countdown - Begins the countdown before a target can be irradiated.
Added by the radiation subsystem when a pulse information has a minimum exposure time.
Will clear itself out after a while.
Radioactive Emitter - Simple component that you can attach to something to make it emit radiation pulses over time.
redirect_attack_hand_from_turf - Will redirect touching the turf it is on with your hand to the attack_hand of the parent object.
Regenerator component - A mob with this component will regenerate its health over time, as long as it has not received damage
in the last X seconds. Taking any damage will reset this cooldown.
religious_tool - Allows the parent to act similarly to the Altar of Gods with modularity. Invoke and Sect Selection is done via attacking with a bible. This means you cannot sacrifice Bibles (you shouldn't want to do this anyways although now that I mentioned it you probably will want to).
seclite_attachable - Component which allows you to attach a seclight to an item,
be it a piece of clothing or a tool.
seethrough - A component that lets you turn an object invisible when you're standing on certain relative turfs to it, like behind a tree
shell - Makes an atom a shell that is able to take in an attached circuit.
shielded - The shielded component causes the parent item to nullify a certain number of attacks against the wearer, see: shielded vests.
shuttle_cling - Gets added to all movables that enter hyperspace and are supposed to suffer from "hyperspace drift"
This lets people fly around shuttles during transit using jetpacks, or cling to the side if they got a spacesuit
Dumping into deepspace is handled by the hyperspace turf, not the component.
Not giving something this component while on hyperspace is safe, it just means free movement like carps
shy - You can't use items on anyone other than yourself if there are other living mobs around you
shy_in_room - You can't use items on anyone other than yourself if you stand in a blacklisted room
sign_language - Reactive Sign Language Component for Carbons. Allows Carbons to speak with sign language if they have the relevant traits.
Implements sign language by incrementally overriding several critical functions, variables, and argument lists.
simple_access - This component allows us to give a mob access without giving them an ID card.
subtype_picker - subtype picker component allows for an item to transform into its subtypes (this is not enforced and you can turn in whatever types, but
i used this name as it was incredibly accurate for current usage of the behavior)
traitor_objective_register - Helper component that registers signals on an object
This is not necessary to use and gives little control over the conditions
allow_admin_asaycolor - allows admins with relevant permissions to have a personalized asay color
allow_admin_ooccolor - allows admins with relevant permissions to have their own ooc colour
allow_rock_the_vote - allow players to vote to re-do the map vote
allow_vote_map - allow votes to change map
allow_vote_restart - allow votes to restart
autoadmin - if autoadmin is enabled
default_no_vote - If disabled, non-voters will automatically have their votes added to certain vote options
(For example: restart votes will default to "no restart", map votes will default to their preferred map / default map, rocking the vote will default to "no")
hub - if the game appears on the hub or not
log_access - log login/logout
log_admin - log admin actions
log_adminchat - log admin chat messages
log_asset - log assets
log_attack - log attack messages
log_econ - log economy actions
log_emote - log emotes
log_game - log game events
log_job_debug - log roundstart divide occupations debug information to a file
master - Start of queue linked list
End of queue linked list (used for appending to the list)
Are we loading in a new map?
for scheduling different subsystems for different stages of the round
deck_card - A basic interface for creating a card for a deck that isn't just a name.
of_type - A /datum/deck_card that just creates a card of the given type
decompose_matrix - Datum which stores information about a matrix decomposed with decompose().
demoralise_moods - Mood application categories for this objective
Used to reduce duplicate code for applying moods to players based on their state
design - Design Datums
All the data for building stuff.
adv_watering_can - Hydroponics
advmop - Janitor Designs
alienscalpel - Alien Surgical Tools
alienwrench - Alien Tools
basic_cell - Power
beacon - Bluespace
board - Computer Boards
aicore - AI Module Disks
electrolyzer - MISC Boards
ripley_main - Mecha Module Disks
subspace_receiver - Subspace Telecomms
borg_upgrade_rename - Borg Upgrades
c38/sec - Weapons
cargo_express - Mining
coffeepot - Coffeemaker Stuff
cyberimp_welding - Cybernetic Implants
design_disk - Disk Construction Disks
fire_extinguisher_advanced - Tools
fishing_rod_tech - Fishing Equipment
health_hud - HUDs
healthanalyzer - Medical Tools
holosign - Holobarriers
restaurant - Restaurant Equipment
implanter - Regular Implants
intellicard - Non-Board Computer Stuff
leftarm - Limb Grower Designs
mech_scattershot - Mecha Equpment
milk - Biogenerator Designs
plasteel_alloy - SMELTABLE ALLOYS
portabledrive/basic - Computer Parts
reactive_armour - Armour
rped - Stock Parts
seclite - Security
super_sticky_tape - Tape
surgery - Surgery Designs
tackle_dolphin - Tackle Gloves
welding_goggles - Misc
dimension_theme - Datum which describes a theme and replaces turfs and objects in specified locations to match that theme
discord_embed - Documentation for the embed object and all of its variables can be found at
https://discord.com/developers/docs/resources/channel#embed-object
It is recommended to read the documentation on the discord website, as the information below could become outdated in the future.
discord_link_record - Represents a record from the discord link table in a nicer format
trail_follow - ///// Attach a trail to any object, that spawns when it moves (like for the jetpack)
just pass in the object to attach it to in set_up
Then do start() to start it and stop() to stop it, obviously
and don't call start() in a loop that will be repeated otherwise it'll get spammed!
element - A holder for simple behaviour that can be attached to many different types
ai_control_examine - ai control examine; which gives the pawn of the parent the noticable organs depending on AI status!
ai_flee_while_injured - Attached to a mob with an AI controller, simply sets a flag on whether or not to run away based on current health values.
AI Held Item Element - Manages holding an item for a mob which doesn't have hands but needs to for AI purposes.
ai_retaliate - Attached to a mob with an AI controller, passes things which have damaged it to a blackboard.
The AI controller is responsible for doing anything with that information.
Animal variety element! - Element that picks an suffix to append onto the icon state from a list given on creation,
among some pixel shifting stuff. Basically you will see VARIETY in a batch of animals.
attack_equip - Attached to an item, when the item is used to attack a human, and the attacker isn't in combat mode, attempts to equip the item to the target after the normal delay.
backblast - When attached to a gun and the gun is successfully fired, this element creates a "backblast" of fire and pain, like you'd find in a rocket launcher or recoilless rifle
bane - Deals extra damage to mobs of a certain type, species, or biotype.
This doesn't directly modify the normal damage of the weapon, instead it applies it's own damage seperatedly ON TOP of normal damage
ie. a sword that does 10 damage with a bane elment attacthed that has a 0.5 damage_multiplier will do:
10 damage from the swords normal attack + 5 damage (50%) from the bane element
basic_body_temp_sensitive - When attached to a basic mob, it gives it the ability to be hurt by cold/hot body temperatures
beauty - Beauty element. It makes the indoor area the parent is in prettier or uglier depending on the beauty var value.
Clean and well decorated areas lead to positive moodlets for passerbies;
Shabbier, dirtier ones lead to negative moodlets EXCLUSIVE to characters with the snob quirk.
bed_tuckable - Tucking element, for things that can be tucked into bed.
Befriend Petting - Element which makes a mob befriend you if you pet it enough.
blocks_explosives - Apply this element to a movable atom when you want it to block explosions
It will mirror the blocking down to that movable's turf, keeping explosion work cheap
connect_loc - This element hooks a signal onto the loc the current object is on.
When the object moves, it will unhook the signal and rehook it to the new object.
content_barfer - Content Barfer; which expels the contents of a mob when it dies, or is transformed
contextual_screentip_bare_hands - Apply basic contextual screentips when the user hovers over this item with an empty hand.
A "Type B" interaction.
This stacks with other contextual screentip elements, though you may want to register the signal/flag manually at that point for performance.
contextual_screentip_item_typechecks - Apply basic contextual screentips when the user hovers over this item with a provided item.
A "Type B" interaction.
This stacks with other contextual screentip elements, though you may want to register the signal/flag manually at that point for performance.
contextual_screentip_sharpness - Apply basic contextual screentips when the user hovers over this item with an item of the given tool behavior.
A "Type B" interaction.
This stacks with other contextual screentip elements, though you may want to register the signal/flag manually at that point for performance.
contextual_screentip_tools - Apply basic contextual screentips when the user hovers over this item with an item of the given tool behavior.
A "Type B" interaction.
This stacks with other contextual screentip elements, though you may want to register the signal/flag manually at that point for performance.
crackable - Adds crack overlays to an object when integrity gets low
crusher_loot - Crusher Loot; which makes the attached mob drop a crusher trophy of some type if the majority damage was from a crusher!
curse announcement element! - Bespoke element that sends a harrowing message when you first pick up an item, applying a spooky color outline and renaming the item.
For most items, it will announce when picked up. If the item can be equipped, though, it will only announce when the item is worn.
Possible improvements for the future: add an option to allow the cursed affix to be a prefix. right now only coded for suffixes
cursed element! - Attaching this element to something will make it float, and get a special ai controller!
haunted - Attaching this element to something will make it float, get a special ai controller, and gives it a spooky outline.
heretic_focus - Heretic focus element, simple element for making an item a heretic focus,
allowing heretics to cast advanced spells (examine message included).
High Fiver Element - Attach to an item to make it offer a "high five" when offered to people
honkspam - Attachable to items. Plays a bikehorn sound whenever attack_self is called (with a cooldown).
item_fov - An element to unconditonally add a FOV trait to the wearer, removing it when an item is unequipped
item_scaling - Element for scaling item appearances in the overworld or in inventory/storage.
kneecapping - Kneecapping element replaces the item's secondary attack with an aimed attack at the kneecaps under certain circumstances.
kneejerk - An element which enables certain items to tap people on their knees to measure brain health
knockback - Mobs and items with this element will knock movable targets they hit away from them.
Guns and turrets will instead fire projectiles with similar effects.
lifesteal - Heals the user (if attached to an item) or the mob itself (if attached to a hostile simple mob)
by a flat amount whenever a successful attack is performed against another living mob.
light_blocking - Attached to movable atoms with opacity. Listens to them move and updates their old and new turf loc's opacity accordingly.
light_eaten - Makes anything that it attaches to incapable of producing light
light_eater - Makes anything it attaches to capable of permanently removing something's ability to produce light.
microwavable - Atoms that can be microwaved from one type to another.
mob_killed_tally - Mob Killed Tally; which ticks up a blackbox when the mob dies
movement_turf_changer - movement_turf_changer element; which makes the movement of a movable atom change the turf it moved to
movetype_handler - An element that enables and disables movetype bitflags whenever the relative traits are added or removed.
It also handles the +2/-2 pixel y anim loop typical of mobs possessing the FLYING or FLOATING movetypes.
This element is necessary for the TRAIT_MOVE_ traits to work correctly, so make sure to attach this element
before adding them to non-living movables.
nerfed_pulling - This living will be slower when pulling/moving anything in the given typecache
noticable_organ - noticable organ element; which makes organs have a special description added to the person with the organ, if certain body zones aren't covered.
ai_control - Subtype of noticable organs for AI control, that will make a few more ai status checks before forking over the examine.
obj_regen - Object integrity regeneration element added by alien alloy.
openspace_item_click_handler - allow players to easily use items such as iron rods, rcds on open space without
having to pixelhunt for portions not occupied by object or mob visuals.
organ_set_bonus - organ set bonus element; which makes organs in the same set, all in one person, provide a unique bonus!
Pet bonus element! - Bespoke element that plays a fun message, sends a heart out, and gives a stronger mood bonus when you pet this animal.
I may have been able to make this work for carbons, but it would have been interjecting on some help mode interactions anyways.
plant_backfire - -- Plant backfire element --
Certain high-danger plants, like death-nettles, will backfire and harm the holder if they're not properly protected.
If a user is protected with something like leather gloves, they can handle them normally.
If they're not protected properly, we invoke a callback on the user, harming or inconveniencing them.
point_of_interest - Designates the atom as a "point of interest", meaning it can be directly orbited
prevent_attacking_of_types - This hostile will not be able to attack a given typecache, and will receive
a balloon alert when it tries to.
radiation_protected_clothing - Marks the item as being radiation protected.
Adds the TRAIT_RADIATION_PROTECTED_CLOTHING trait, as well as adding an
extra bit to the examine descrpition.
radioactive - This atom will regularly pulse radiation.
As this is only applied on uranium objects for now, this defaults to uranium constants.
ranged_attacks - This proc is used by basic mobs to give them a simple ranged attack! In theory this could be extended to
relay_attackers - This element registers to a shitload of signals which can signify "someone attacked me".
If anyone does it sends a single "someone attacked me" signal containing details about who done it.
This prevents other components and elements from having to register to the same list of a million signals, should be more maintainable in one place.
ridable - This element is used to indicate that a movable atom can be mounted by mobs in order to ride it. The movable is considered mounted when a mob is buckled to it,
at which point a riding component is created on the movable, and that component handles the actual riding behavior.
rust - Adding this element to an atom will have it automatically render an overlay.
The overlay can be specified in new as the first paramter; if not set it defaults to rust_overlay's rust_default
simple flying element! - Non bespoke element (1 in existence) that makes animals fly while living and... not while dead!
Note: works for carbons and above, but please do something better. humans have wings got dangit!
undertile - Add to an object if you want to be able to be hidden under tiles
Unfriend Attacker - Element which makes a mob remove you from its friends list you if you hurt it.
Doesn't make a callout post because we don't have twitter integration.
update_icon_blocker - Prevents calling anything in update_icon() like update_icon_state() or update_overlays()
venomous - Venomous element; which makes the attacks of the simplemob attached poison the enemy.
venue_price - This component can be used to give something value for venues
volatile_gas_storage - An element to make an /obj explode based on gas pressure when broken
wall_engraver - An element that lets you engrave walls when right click is used
Wall Smasher - An element you put on mobs to let their attacks break walls
If put in the hands of a player this can cause a lot of problems, be careful
weapon_description - The purpose of this element is to widely provide the ability to examine an object and determine its stats, with the ability to add
additional notes or information based on type or other factors
weather_listener - This element just handles creating and destroying an area sound manager that's hooked into weather stuff
Web Walker element - A mob with this element will move more slowly when it's not stood on a webbed turf.
Emote - Most of the text that's not someone talking is based off of this.
living
carbon/human/monkey - Snowflake emotes only for le epic chimp
event_admin_setup - Datum that holds a proc for additional options when running an event.
Prototypes are declared here, non-prototypes on the event files.
listed_options - A very common pattern is picking from a tgui list input, so this does that.
Supply a list in get_list and prompt admins will have the admin pick from it or cancel.
departmental_revolt - which department is revolting?
disease_outbreak - Handles actually selecting whicch disease will spawn.
ordnance - A ordnance experiment datum. What gives the science in the first place.
One is instantiated by the techweb, another one is also kept on SSresearch for the briefing.
A disk should contain several of these in a list. Only one should get picked for the final paper.
machinery_tiered_scan - This experiment type will turn up TRUE if at least one of the stock parts in the scanned machine is of the required_tier.
Pretend to upgrade security's techfab but in reality apply only one better matter bin!
Note that a stock part in a machine can either be an object, or a datum.
slime - The suicide victim's brain that will be placed inside the toilet's cistern
The toilet we're about to unleash unto this cursed plane of existence
food - Original Food export file got eaten somewhere along the line and I have no idea when or where it got completely deleted.
Foods given a venue value are exportable to cargo as a backup to selling from venues, however at the expense of elasticity.
large/gas_canister - Gas canister exports.
I'm going to put a quick aside here as this has been a pain to balance for several years now, and I'd like to at least break how to keep gas exports tame.
So: Gasses are sold in canisters below, which have a variable amount of maximum pressure before they start to break. The largest of which is 9.2e13 kPa.
This means we can determine a theoretical maximum value for gas sale prices using the ideal gas laws, as we know we have a minimum gas temperature of 2.7 kelvin.
fish_source - Where the fish actually come from - every fishing spot has one assigned but multiple fishing holes can share single source, ie single shared one for ocean/lavaland river
pluox_formation - If n2o-plasma ratio is less than 1:3 start decomposing n2o.
Rate of decomposition vs BZ production increases as n2o concentration gets lower
Plasma acts as a catalyst on decomposition, so it doesn't get consumed in the process.
N2O decomposes with its normal decomposition energy
color_matrix - A layer to modify the previous layer's colors with a color matrix
icon_state - The most basic greyscale layer; a layer which is created from a single icon_state in the given icon file
reference - A layer created by using another greyscale icon's configuration
greyscale_modify_menu - The controller for the ui in charge of all runtime greyscale configuration/debug.
If Unlock() is not called the menu is safe for players to use.
spray_paint - Used for spray painting items in the gags_recolorable component
Hallucination datum. - Handles effects of a hallucination on a living mob.
Created and triggered via the [cause hallucination proc][/mob/living/proc/cause_hallucination].
battle - Battle hallucination, makes it sound like a melee or gun battle is going on in the background.
bomb - A hallucination of a syndicate bomb ticking down.
e_sword - A hallucination of someone unsheathing an energy sword, going to town, and sheathing it again.
gun - Subtype of battle hallucination for gun based battles, where it sounds like someone is being shot.
disabler - Gun battle hallucination that sounds like disabler fire.
laser - Gun battle hallucination that sounds like laser fire.
harm_baton - A hallucination of someone being stun batonned, and subsequently harmbatonned.
stun_prod - A hallucination of someone being hit with a stun prod, followed by cable cuffing.
body - Makes a random body appear and disappear quickly in view of the hallucinator.
highlander_controller - The highlander controller handles the admin highlander mode, if enabled.
It is first created when "there can only be one" triggers it, and it can be referenced from GLOB.highlander_controller
id_trim - Simple datum that holds the basic information associated with an ID card trim.
admin - Trim for admins and debug cards. Has every single access in the game.
away - Generic away/pffstation trim.
cat_surgeon - Trim for the cat surgeon ruin.
hilbert - Trim for Hilbert in Hilbert's Hotel.
hotel - Trim for the hotel ruin. Not Hilbert's Hotel.
security - Trim for the hotel ruin. Not Hilbert's Hotel.
old
apc - Trim for the oldstation ruin/Charlie station to access APCs and other equipment
eng - Trim for the oldstation ruin/Charlie station
robo - Trim for the oldstation ruin/Charlie station to access robots, and downloading of paper publishing software for experiments
sci - Trim for the oldstation ruin/Charlie station
sec - Trim for the oldstation ruin/Charlie station
battlecruiser - Trim for Syndicate mobs, outfits and corpses.
captain - Trim for Syndicate mobs, outfits and corpses.
bounty_hunter - Trim for Bounty Hunters NOT hired by centcom. (?)
centcom - Trim for basic Centcom cards.
admiral - Trim for Centcom (Soviet) Admirals. All Centcom and Station Access.
bartender - Trim for Centcom Bartenders.
bounty_hunter - Trim for Bounty Hunters hired by centcom.
commander - Trim for Centcom Commanders. All Centcom and Station Access.
corpse
assault - Trim for various Centcom corpses.
bridge_officer - Trim for various Centcom corpses.
commander - Trim for various Centcom corpses.
private_security - Trim for various Centcom corpses.
tradepost_officer - Trim for various Centcom corpses.
custodian - Trim for Centcom Custodians.
deathsquad - Trim for Deathsquad officers. All Centcom and Station Access.
ert - Trim for generic ERT interns. No universal ID card changing access.
chaplain - Trim for generic ERT chaplains. No universal ID card changing access.
clown - Trim for generic ERT clowns. No universal ID card changing access.
commander - Trim for ERT Commanders. All station and centcom access.
engineer - Trim for generic ERT engineers. No universal ID card changing access.
janitor - Trim for generic ERT janitors. No universal ID card changing access.
medical - Trim for generic ERT medics. No universal ID card changing access.
security - Trim for generic ERT seccies. No universal ID card changing access.
intern - Trim for Centcom Interns.
head - Trim for Centcom Head Interns. Different assignment, common station access added on.
medical_officer - Trim for Centcom Medical Officers.
official - Trim for Centcom Officials.
research_officer - Trim for Centcom Research Officers.
specops_officer - Trim for Centcom Specops Officers. All Centcom and Station Access.
thunderdome_overseer - Trim for Centcom Thunderdome Overseers.
vip - Trim for Centcom VIPs
chameleon - Trim for Chameleon ID cards. Many outfits, nuke ops and some corpses hold Chameleon ID cards.
operative - Trim for Chameleon ID cards. Many outfits, nuke ops and some corpses hold Chameleon ID cards.
clown - Trim for Chameleon ID cards. Many outfits, nuke ops and some corpses hold Chameleon ID cards.
clown_leader - Trim for Chameleon ID cards. Many outfits, nuke ops and some corpses hold Chameleon ID cards.
nuke_leader - Trim for Chameleon ID cards. Many outfits, nuke ops and some corpses hold Chameleon ID cards.
engioutpost - Trim for various various ruins.
highlander - Trim for highlander cards, used during the highlander adminbus event.
job - This file contains all the trims associated with station jobs.
It also contains special prisoner trims and the miner's spare ID trim.
ID Trims for station jobs.
Instrument Datums - Instrument datums hold the data for any given instrument, as well as data on how to play it and what bounds there are to playing it.
instrument_key - Instrument key datums contain everything needed to know how to play a specific
note of an instrument.*
interview - Represents a new-player interview form
Interview Manager - Handles all interviews in the duration of a round, includes the primary functionality for
handling the interview queue.
servant_golem - For late joiners, we're forced to put them in an alone department at some point.
unassigned - This type is used to indicate a lack of a job.
The mind variable assigned_role will point here by default.
As any other job datum, this is a singleton.
job_department - Singleton representing a category of jobs forming a department.
assistant - A special assistant only department, primarily for use by the preferences menu
captain - A special captain only department, for use by the preferences menu
undefined - Catch-all department for undefined jobs.
jps_node - The JPS Node datum represents a turf that we find interesting enough to add to the open list and possibly search for new tiles from
json_reader - Takes a json list and extracts a single value.
Subtypes represent different conversions of that value.
json_savefile - A savefile implementation that handles all data using json.
Also saves it using JSON too, fancy.
If you pass in a null path, it simply acts as a memory tree instead, and cannot be saved.
lazy_template - Datum used to designate certain areas that do not need to exist nor be loaded at world start
but do want to be loaded under certain circumstances. Use this for stuff like the nukie base or wizden, aka stuff that only matters when their antag is rolled.
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
map_generator - This type is responsible for any map generation behavior that is done in areas, override this to allow for area-specific map generation. This generation is ran by areas in initialize.
clown_world - Clown enjoyers who are effected by this become ecstatic, they have achieved their life's dream.
This moodlet is equivalent to the one for simply being a traitor.
move_loop - Template class of the movement datums, handles the timing portion of the loops
disposal_holder - Disposal holders need to move through a chain of pipes
Rather then through the world. This supports this
If this ever changes, get rid of this, add drift component like logic to the holder
And move them to move()
move_towards - Used as a alternative to walk_towards
move_towards_budget - The actual implementation of walk_towards()
move - Replacement for walk()
move_rand - This isn't actually the same as walk_rand
Because walk_rand is really more like walk_to_rand
It appears to pick a spot outside of range, and move towards it, then pick a new spot, etc.
I can't actually replicate this on our side, because of how bad our pathfinding is, and cause I'm not totally sure I know what it's doing.
I can just implement a random-walk though
move_to_rand - Wrapper around step_rand
movement_detector - A datum to handle the busywork of registering signals to handle in depth tracking of a movable
movement_packet - A packet of information that describes the current state of a moving object
object_window_info - Datum that holds and tracks info about a client's object window
Really only exists because I want to be able to do logic with signals
And need a safe place to do the registration
black_hole - Black Hole - final (emag can spawn singulo, see death event)
black_hole_death - You died to a black hole, have some fluff text
electronic_part - Malfunction - spend one engine part or wait 3 days (emag effect randomizes some stats)
engine_part - Engine Breakdown - spend one engine part or wait 3 days (harmless emag effect)
hull_part - Collision - spend one engine part or wait 3 days (has a nasty emag effect)
space_port - You found a space port!
tau_ceti - You found the midway mark!
space_port_raid - You raided a space port!
Outfit datums - This is a clean system of applying outfits to mobs, if you need to equip someone in a uniform
this is the way to do it cleanly and properly.
scientist/consistent - A version of the scientist outfit that is guaranteed to be the same every time
wizard_captain - An outfit which replaces parts of a wizard's clothes with captain's clothes but keeps the robes
mafia/abductee - Map-specific custom outfits
stacks_in_hands - List of infuser_entry typepaths which contain species-changing organs.
Species change swaps out all the organs, making test_organ un-usable after insertion.
See #66313 and #60901. outfit_sanity used to runtime whenever you had two mergable sheets in either hand. Previously, this only had a 3% chance of occuring. Now 100%.
overlay_info - Stores the decal & overlays on the floor to preserve texture of the design
in short its just an wrapper for mutable appearance where we retrive the nessassary information
to recreate an mutable appearance
pirate_gang - datum for a pirate team that is spawning to attack the station.
psykers - psychic gangster junkies who want some allowance to continue the gore-binge
rogues - classic FTL-esque space pirates.
silverscales - aristocrat lizards looking to hunt the serfs
skeletons - undead skeleton crew looking for booty
plane_master_debug - Used for testing/debugger plane masters and their associated rendering plates
plane_master_group - Datum that represents one "group" of plane masters
So all the main window planes would be in one, all the spyglass planes in another
Etc
popup - Holds plane masters for popups, like camera windows
Note: We do not scale this plane, even though we could
This is because it's annoying to get turfs to position inside it correctly
If you wanna try someday feel free, but I can't manage it
plant_gene - Plant gene datums - things that build and modify a plant or seed.
reagent - Reagent genes store a reagent ID and reagent ratio.
preset - Preset plant reagent genes that are unremovable from a plant.
chem_cooling - This trait is the opposite of above - it cools down the plant's chemical contents on harvest.
This requires nutriment to fuel. 1u nutriment = -5 K.
chem_heating - This trait automatically heats up the plant's chemical contents when harvested.
This requires nutriment to fuel. 1u nutriment = 25 K.
eyes - A plant trait that causes the plant to gain aesthetic googly eyes.
fire_resistance - Makes the plant and its seeds fireproof. From lavaland plants.
gas_production - Corpseflower's miasma production.
Can be generalized in the future to spawn any gas, but I don't think that's necessarily a good idea.
juicing - Similar to auto-distilling, but instead of brewing the plant's contents it juices it.
maxchem - A plant trait that causes the plant's capacity to double.
mob_transformation - Traits for plants that can be activated to turn into a mob.
shroom - Walking Mushroom's transformation gene
tomato - Killer Tomato's transformation gene.
modified_volume - Traits for plants with a different base max_volume.
cherry_bomb - Cherry Bomb's increased max volume gene
omega_weed - Omegaweed's funny 420 max volume gene
never_mutate - Prevents species mutation, while still allowing wild mutation harvest and Floral Somatoray species mutation. Trait acts as a tag for hydroponics.dm to recognise.
one_bite - Traiit for plants eaten in 1 bite.
plant_laughter - Plays a laughter sound when someone slips on it.
Like the sitcom component but for plants.
Just like slippery skin, if we have a trash type this only functions on that. (Banana peels)
plant_type - Plant type traits. Incompatible with one another.
alien_properties - Currently unused and does nothing. Appears in strange seeds.
fungal_metabolism - Mushrooms need less light and have a minimum yield.
weed_hardy - Weeds don't get annoyed by weeds in their tray.
preserved - Traits for flowers, makes plants not decompose.
repeated_harvest - Allows a plant to be harvested multiple times.
choiced - A preference that is a choice of one option among a fixed set.
Used for preferences such as clothing.
ai_core_display - What to show on the AI screen
backpack - Backpack preference
brief_outfit - What outfit to equip when spawning as a briefing officer for an ERT
gender - Gender preference
ghost_accessories - Determines what accessories your ghost will look like they have.
ghost_form - Determines the appearance of your ghost to others, when you are a BYOND member
ghost_lighting - How bright a ghost's lighting plane is
ghost_orbit - Determines what ghosts orbiting look like to you.
ghost_others - Determines how to show other ghosts
jumpsuit - Jumpsuit preference
mod_select - Switches between mouse buttons for MODsuit active modules
parallax - Determines parallax, "fancy space"
pda_theme - PDA theme
preferred_map - During map rotation, this will help determine the chosen map.
prisoner_crime - Which crime is the prisoner permabrigged for. For fluff!
scaling_method - The scaling method to show the world in, e.g. nearest neighbor
security_department - Which department to put security officers in, when the config is enabled
socks - Socks preference
species - Species preference
ui_style - UI style preference
undershirt - Undershirt preference
underwear - Underwear preference
color - A preference that represents an RGB color of something.
Will give the value as 6 hex digits, without a hash.
ooc_color - The color admins will speak in for OOC.
name - A preference for a name. Used not just for normal names, but also for clown names, etc.
backup_human - The name for a backup human, when nonhumans are made into head of staff
real_name - A character's real name
numeric - A numeric preference with a minimum and maximum value
multiz_performance - Boundary for how many z levels down to render properly before we start going cheapo mode
text - A string-based preference accepting arbitrary string values entered by the user, with a maximum length.
pda_ringtone - This is the preference for the player's SpaceMessenger ringtone.
Currently only applies to humans spawned in with a job, as it's hooked
into /datum/job/proc/after_spawn().
toggle - A preference whose value is always TRUE or FALSE
ambient_occlusion - Whether or not to toggle ambient occlusion, the shadows around people
broadcast_login_logout - Whether or not to announce when the player logs in or out.
darkened_flash - When toggled, being flashed will show a dark screen rather than a light one.
ghost_hud - Toggles the HUD for ghosts
ghost_roles - When enabled, prevents any and all ghost role pop-ups.
ghost_roles_as_admin - When enabled, prevents any and all ghost role pop-ups WHILE ADMINNED.
inquisitive_ghost - Whether or not ghosts can examine things by clicking on them.
multiz_parallax - Whether or not to toggle multiz parallax, the parallax effect for lower z-levels.
playtime_reward_cloak - This can be set to TRUE from the prefs menu only once the user has
gained over 5K playtime hours.
If true, it allows the user to get a cool looking roundstart cloak.
tgui_input_large - Large button preference. Error text is in tooltip.
tgui_input_swapped - Swapped button state - sets buttons to SS13 traditional SUBMIT/CANCEL
tgui_say_light_mode - Light mode for tgui say
typing_indicator - Whether or not to show a typing indicator when speaking. Defaults to on.
window_flashing - Enables flashing the window in your task tray for important events
preference_middleware - Preference middleware is code that helps to decentralize complicated preference features.
keybindings - Middleware to handle keybindings
legacy_toggles - In the before times, toggles were all stored in one bitfield.
In order to preserve this existing data (and code) without massive
migrations, this middleware attempts to handle this in a way
transparent to the preferences UI itself.
In the future, the existing toggles data should just be migrated to
individual /datum/preference/toggles.
names - Middleware that handles telling the UI which name to show, and waht names
they have.
quirks - Middleware to handle quirks
random - Middleware for handling randomization preferences
advanced - Movable and easily code-modified fields! Allows for custom AOE effects that affect movement
and anything inside of them, and can do custom turf effects!
Supports automatic recalculation/reset on movement.
puzzgrid_group - Represents an individual group in a puzzgrid
qdel_item - Qdel Item: Holds statistics on each type that passes thru qdel
Holds the type as a string for this type
Total number of times it's passed thru qdel.
Total amount of milliseconds spent processing this type's Destroy()
Times it was queued for soft deletion but failed to soft delete.
Different from failures because it also includes QDEL_HINT_HARDDEL deletions
Total amount of milliseconds spent hard deleting this type.
Highest time spent hard_deleting this in ms.
Number of times hard deletes took longer than the configured threshold
Number of times it's not respected force=TRUE
Number of times it's not even bother to give a qdel hint
Number of times it's slept in its destroy
junkie - If this is defined, reagent_id will be unused and the defined reagent type will be instead.
actual instanced version of the reagent
Where the drug spawned
If this is defined before pill generation, pill generation will be skipped. This is the type of the pill bottle.
where the accessory spawned
If this is null, an accessory won't be spawned.
how frequently the quirk processes
ticker for processing
penthrite - Can bring a corpse back to life temporarily (if heart is intact)
Makes wounds bleed more, if it brought someone back, they take additional brute and heart damage
They can't die during this, but if they're past crit then take increasing stamina damage
If they're past fullcrit, their movement is slowed by half
If they OD, their heart explodes (if they were brought back from the dead)
deaconize - Makes the person holy, but they now also have to follow the honorbound code (CBT). Actually earns favor, convincing others to uphold the code (tm) is not easy
Religious Sects - Religious Sects are a way to convert the fun of having an active 'god' (admin) to code-mechanics so you aren't having to press adminwho.
immovable_rod - Immovable rod random event.
The rod will spawn at some location outside the station, and travel in a straight line to the opposite side of the station
market_crash - An event which decreases the station target temporarily, causing the inflation var to increase heavily.
sandstorm - Sandstorm Event: Throws dust/sand at one side of the station. High-intensity and relatively short,
however the incoming direction is given along with time to prepare. Damages can be reduced or
mitigated with a few people actively working to fix things as the storm hits, but leaving the event to run on its own can lead to widespread breaches.
sandstorm_classic - The original sandstorm event. An admin-only disasterfest that sands down all sides of the station
Uses space dust, meaning walls/rwalls are quickly chewed up very quickly.
stray_cargo - Spawns a cargo pod containing a random cargo supply pack on a random area of the station
syndicate - Places that shouldn't explode
Subtypes from the above that actually should explode.
A rare variant that drops a crate containing syndicate uplink items
scan_condition - Scan condition, these require some specific setup for the dish to count for the scan power for the given site
scanner_controller - Helper datum to calculate and store scanning power and track in progress scans
scar - scars are cosmetic datums that are assigned to bodyparts once they recover from wounds. Each wound type and severity have their own descriptions for what the scars
look like, and then each body part has a list of "specific locations" like your elbow or wrist or wherever the scar can appear, to make it more interesting than "right arm"
scientific_paper - Scientific paper datum for retrieval and re-reading. A lot of the variables are there for fluff & flavor.
Spatial Grid Cell - used by /datum/controller/subsystem/spatial_grid to cover every z level so that the coordinates of every turf in the world corresponds to one of these in
the subsystems list of grid cells by z level. each one of these contains content lists holding all atoms meeting a certain criteria that is in our borders.
these datums shouldnt have significant behavior, they should just hold data. the lists are filled and emptied by the subsystem.
species datum - Datum that handles different species in the game.
human/tallboy - These won't appear normally in games, they are meant to for debuging the adjustment of limbs based on the height of a humans bodyparts.
station_request - A combined all in one datum that stores everything about the request, the requester's account, as well as the requestee's account
All of this is passed to the Request Console UI in order to present in organized way.
station_state - For counting up how much of the station exists at the start of the shift, and how much is left behind by the end of it.
station_trait - Base class of station traits. These are used to influence rounds in one way or the other by influencing the levers of the station.
revolutionary_trashing - A special trait, used only for when a revolution was won in the previous round. See /obj/effect/mapping_helpers/revolution_trash for more information.
status_effect - Status effects are used to apply temporary or permanent effects to mobs.
This file contains their code, plus code for applying and removing them.
hallucination - Hallucination status effect. How most hallucinations end up happening.
Hallucinations are drawn from the global weighted list, random_hallucination_weighted_list
incapacitated - This status effect represents anything that leaves a character unable to perform basic tasks (interrupting do-afters, for example), but doesn't incapacitate them further than that (no stuns etc..)
inebriated - The drunk status effect.
Slowly decreases in drunk_value over time, causing effects based on that value.
drunk - Stage 2 of being drunk, applied at drunk values between 6 and onward.
Has all the main side effects of being drunk, scaling up as they get more drunk.
tipsy - Stage 1 of drunk, applied at drunk values between 0 and 6.
Basically is the "drunk but no side effects" stage.
inflated - Status effect from the Expand action, makes you big and round and strong.
lobster_rush - Status effect: Makes you run really fast and ignore speed penalties for a short duration.
If you run into a wall indoors you will fall over and lose the buff.
If you run into someone you both fall over.
extended - You get a longer buff if you take the time to implant it in yourself
no_item_received - This status effect is meant only for items that you don't actually receive
when offered, mostly useful for /obj/item/hand_item subtypes.
needs_resting - This status effect is meant only to be used for offerings that require the target to
be resting (like when you're trying to give them a hand to help them up).
Also doesn't require them to have their hands free (since you're not giving them
anything).
carp - bonus of the carp: you can swim through space!
fly - bonus of the fly: you... are a flyperson now. sorry.
goliath - bonus of the goliath: you can swim through space!
gondola - bonus of the observing gondola: you can ignore environmental hazards
rat - bonus of the rat: you can ventcrawl!
protective_blades - Summons multiple foating knives around the owner.
Each knife will block an attack straight up.
recharging - A subtype that doesn't self-delete / disappear when all blades are gone
It instead regenerates over time back to the max after blades are consumed
psychic_projection - Status effect that adds a weird view to its owner and causes them to rapidly shoot a firearm in their general direction.
shadow_cloak - Shadow cloak effect. Conceals the owner in a cloud of purple smoke, making them unidentifiable.
Also comes with some other buffs and debuffs - faster movespeed, slower actionspeed, etc.
brimdust_coating - If you take brute damage with this buff, hurt and push everyone next to you.
If you catch fire and or on the space station, detonate all remaining stacks in a way which hurts you.
Washes off if you get wet.
stock_part - Represents the concept of a stock part.
One is created for every stock part type for every level.
Machines have these inside their component_parts.
For example, scanning modules use /datum/stock_part/scanning_module.
In machines, you can perform a loop through something like
for (var/datum/stock_part/scanning_module/part in component_parts)
ansible - Subspace stock parts
storage - Datumized Storage
Eliminates the need for custom signals specifically for the storage component, and attaches a storage variable (atom_storage) to every atom.
The parent and real_location variables are both weakrefs, so they must be resolved before they can be used.
If you're looking to create custom storage type behaviors, check ../subtypes
custom - Custom supply pack
The contents are given on New rather than being static
This is for adding custom orders to the Cargo console (like order consoles)
engine - Engine Construction
exploration - Exploration drone unlockables
misc/syndicate - Special supply crate that generates random syndicate gear up to a determined TC value
custom_value - Syndicate supply crate that can have its contents value changed by admins, uses a seperate datum to avoid having admins touch the original one.
allow_items - Subtype more forgiving for items.
Careful, this can go wrong and keep a mob hyper-focused on an item it can't lose aggro on
moonicorn - moonicorns will not attack people holding something that could tame them.
ignore_faction - Subtype which doesn't care about faction
Mobs which retaliate but don't otherwise target seek should just attack anything which annoys them
of_size - Subtype which searches for mobs of a size relative to ours
not_friends - Don't target an atom in our friends list (or turfs), anything else is fair game
admin - Admin techweb that has everything unlocked by default
autounlocking - Techweb node that automatically unlocks a given buildtype.
Saved in GLOB.autounlock_techwebs and used to prevent
creating new ones each time it's needed.
bepis - Techweb made through BEPIS machine
Should only contain 1 BEPIS tech at random.
disk - Techweb made through tech disks
Contains nothing, subtype mostly meant to make it easy for admins to see.
science - Global Science techweb for RND consoles
Techweb Node - A datum representing a researchable node in the techweb.
reload_admins - Reload admins tgs chat command. Intentionally not validated.
validated - subtype tgs chat command with validated admin ranks. Only supports discord.
validate discord userid is linked to a game admin with these flags.
tgui_alert - Datum used for instantiating and using a TGUI-controlled modal that prompts the user with
a message and has buttons for responses.
tgui_input_number - Datum used for instantiating and using a TGUI-controlled number input that prompts the user with
a message and has an input for number entry.
tgui_list_input - Client does NOT have tgui_input on: Returns regular input
tgui_panel - tgui_panel datum
Hosts tgchat and other nice features.
tgui_say - The tgui say modal. This initializes an input window which hides until
the user presses one of the speech hotkeys. Once something is entered, it will
delegate the speech to the proper channel.
traitor_category_handler - The traitor category handler. This is where the probability of all objectives are managed.
traitor_objective - A traitor objective. Traitor objectives should not be deleted after they have been created and established, only failed.
If a traitor objective needs to be removed from the failed/completed objective list of their handler, then you are doing something wrong
and you should reconsider. When an objective is failed/completed, that is final and the only way you can change that is by refactoring the code.
assistant - This is only for assistants, because the syndies are a lot less likely to give a shit about what an assistant does, so they're a lot less likely to appear
traitor_objective_category - The objective category.
Used to group up entire objectives into 1 weight objects to prevent having a
higher chance of getting an objective due to an increased number of different objective subtypes.
These are nothing but informational holders and will have no other purpose.
sabotage_machinery - Traitor objective to destroy a machine the crew cares about
triple_ai_controller - The triple ai controller handles the admin triple AI mode, if enabled.
It is first created when "Toggle AI Triumvirate" triggers it, and it can be referenced from GLOB.triple_ai_controller
After it handles roundstart business, it cleans itself up.
trophy_data - trophy data datum, for admin manipulation
blindness - Unit test to check that blindness adds the correct status effects, overlays, and client colors
bloody_footprints - Tests to make sure bloody footprits work as expected
So no stacking, they actually apply, and shoe staining thrown in for free
breath - Tests to ensure humans, plasmamen, and ashwalkers can breath in normal situations.
Ensures algorithmic correctness of the "breathe()" and "toggle_internals()" procs.
Built to prevent regression on an issue surrounding QUANTIZE() and BREATH_VOLUME.
See the comment on BREATH_VOLUME for more details.
breath_sanity_ashwalker - Tests to make sure ashwalkers can breathe from the lavaland air.
breath_sanity_plasmamen - Tests to make sure plasmaman can breath from their internal tanks
cable_powernets - Checking all powernets to see if they are properly connected and powered.
cardboard_cutouts - Validates that cardboard cutouts have the proper icons
chat_filter_sanity - Tests the sanity of the chat filter, ensuring it properly blocks words and gives the reason
circuit_component_category - Tests to make sure each circuit component that could potentially be available to a player has a category
closets - Checks that the length of the initial contents of a closet doesn't exceed its storage capacity.
Also checks that nothing inside that isn't immediate is a steal objective.
connect_loc_basic - Test that the connect_loc element handles basic movement cases
connect_loc_change_turf - Test that the connect_loc element handles turf changes
connect_loc_multiple_on_turf - Tests that multiple objects can have connect_loc on the same turf without runtimes.
contents_barfer - Unit test for the contents barfer element
crayon_naming - Makes sure that crayons have their crayon_color in their initial name (to differentiate them in the crafting menu).
create_and_destroy - Delete one of every type, sleep a while, then check to see if anything has gone fucky
dcs_get_id_from_arguments - Tests that DCS' GetIdFromArguments works as expected with standard and odd cases
defined_inhand_icon_states - Makes sure items with defined inhand_icon_states... actually have icons that exist!
door_access_check - Tests to make sure door access works correctly.
drink_icons - Unit tests glass subtypes have a valid icon setup
dummy_spawn_outfit - Equips and devests our dummy of one of every job outfit
dummy_spawn_species - This set of tests is focused on ensuring the stability of preference dummies
And by extension the hacks built to make them fast
Organ consistency, object pooling via the wardrobe ss, etc
dynamic_roundstart_ruleset_sanity - Verifies that roundstart dynamic rulesets are setup properly without external configuration.
dynamic_unique_antag_flags - Verifies that dynamic rulesets have unique antag_flag.
egg_glands - Verifies that all glands for an egg are valid
eye_damage - Unit test to ensure eyes are properly blinded and nearsighted by eye damage
focus_only - These tests perform no behavior of their own, and have their tests offloaded onto other procs.
This is useful in cases like in build_appearance_list where we want to know if any fail,
but is not useful to right a test for.
This file exists so that you can change any of these to TEST_FOCUS and only check for that test.
For example, change /datum/unit_test/focus_only/invalid_overlays to TEST_FOCUS(/datum/unit_test/focus_only/invalid_overlays),
and you will only test the check for invalid overlays in appearance building.
invalid_emissives - Checks that every created emissive has a valid icon_state
invalid_overlays - Checks that every overlay passed into build_appearance_list exists in the icon
invalid_research_designs - Checks that every icon sent to the research_designs spritesheet is valid
invalid_vending_machine_icon_states - Checks that every icon sent to vending machines is valid
multiple_space_initialization - Checks that space does not initialize multiple times
nightvision_color_cutoffs - Checks that nightvision eyes have a full set of color lists
sorted_smoothing_groups - Checks that smoothing_groups and canSmoothWith are properly sorted in /atom/Initialize
stacked_lights - Checks that no light shares a tile/pixel offsets with another
valid_turf_states - Checks that floor tiles are properly mapped to broken/burnt
food_edibility_check - Makes sure that spawned food has reagents and the edible component (or else it can't be eaten).
full_heal_damage_types - Tests the fully heal combination flag HEAL_DAMAGE.
full_heal_heals_organs - Tests the fully heal flag HEAL_ORGANS.
full_heal_regenerates_organs - Tests the fully heal flag HEAL_REFRESH_ORGANS.
get_message_mods - Test to verify message mods are parsed correctly
get_turf_pixel - ensures that get_turf_pixel() returns turfs within the bounds of the map,
even when called on a movable with its sprite out of bounds
geyser - Geysers listen to reagent signals to know when to start processing, which is very cool, smart, optimized and fragile
Tests:
Check for reagent datum
Check if our geyser starts with the right reagent
Check if our geyser refills (by clearing the reagents, setting refresh rate to max and manually firing the subsystem)
Check if our geyser refilled with the right reagent
glass_style_functionality - Unit tests glass style datums are applied to drinking glasses
glass_style_icons - Unit tests all glass style datums with icons / icon states that those are valid and not missing.
greyscale_color_count - Makes sure objects using greyscale configs have, if any, the correct number of colors
greyscale_item_icon_states - Makes sure items using GAGS have all the icon states needed to work
hallucination_icons - Unit tests various image related hallucinations
that their icon_states and icons still exist,
as often hallucinations are copy and pasted
implementations of existing image setups
that may be changed and not updated.
human_through_recycler - Puts a consistent assistant into an emagged recycler, and verifies that all intended behavior of an emagged recycler occurs (chewing up all the clothing, applying a level of melee damage, etc.)
hunger_curse - Tests that the curse of hunger, from /datum/component/curse_of_hunger,
is properly added when equipped to the correct slot and removed when dropped / deleted
hydroponics_extractor_storage - Unit test to ensure seeds can properly be added to the plant seed extractor through multiple methods.
This only tests transferring seeds to the storage, it does NOT test creating seeds.
hydroponics_self_mutation - Unit test to ensure plants can't self-mutate into themselves.
hydroponics_validate_genes - Unit test to ensure plants don't have multiple of a plant type at once by default.
json_savefiles - The job of this unit test is to ensure that save files are correctly imported from BYOND to JSON.
It's a rather convoluted process and so this test ensures that something didn't fuck up somewhere.
knockoff_component - Test that the knockoff component will properly cause something
with it applied to be knocked off when it should be.
lesserform - Unit test to ensure that changelings can consistently turn from monkeys to humans and back
limb_height_adjustment - removes the abstract items.
Tests the height adjustment system which dynamically changes how much the chest, head, and arms of a carbon are adjusted upwards or downwards based on the length of their legs and chest.
load_map_security - Tests to ensure we can load a map from a whitelisted directory (_maps), but not a non-whitelisted directory (i.e "fartyShitPants")
log_mapping - Conveys all log_mapping messages as unit test failures, as they all indicate mapping problems.
lungs - Tests the standard, plasmaman, and lavaland lungs organ to ensure breathing and suffocation behave as expected.
Performs a check on each main (can be life-sustaining) gas, and ensures gas alerts are only thrown when expected.
lungs_sanity_ashwalker - Tests the lavaland/Ashwalker lungs organ.
Ensures they can breathe from the lavaland air mixture properly, and suffocate on inadequate mixture.
lungs_sanity_plasmaman - Tests the Plasmaman lungs organ to ensure Plasma breathing and suffocation behave as expected.
mapload_space_verification - Verifies that there are no space turfs inside a station area, or on any planetary z-level. Sometimes, these are introduced during the load of the map and are not present in the DMM itself.
Let's just make sure that we have a stop-gap measure in place to catch these if they pop up so we don't put it onto production servers should something errant come up.
mecha_damage - Unit test to ensure that mechs take the correct amount of damage
based on armor, and that their equipment is properly damaged as well.
operating_table - Make a mob hop on an optable, rest, get up, rest again, and then move to another tile.
While the mob is still an active patient, move another mob in too.
This is so the replacement code can kick in when the original mob is no longer valid.
orderable_items - Makes sure that no orderable items have dynamic descriptions, if they
don't explicitly set a description.
Also makes sure 2 orderable items don't sell the same thing.
organ_sanity - Check organ insertion and removal, for all organ subtypes usable in-game.
Ensures algorithmic correctness of the "Insert()" and "Remove()" procs.
This test is especially useful because developers frequently override those.
organ_set_bonus_id - Checks that all "organ_set_bonus" status effects have unique "id" vars.
Required to ensure that the status effects are treated as "unique".
organ_set_bonus_sanity - Checks that all implantable DNA Infuser organs are set up correctly and without error.
Tests the "organ set bonus" Elements and Status Effects, which are for the DNA Infuser.
This test ensures that the "organ_set_bonus" status effects activate and deactivate when expected.
paintings - Checks that all kind of painting frames have a sprite for each canvas type in the game.
plane_double_transform - Ensures plane masters that get shrunk by multiz NEVER render into each other
plane_dupe_detector - Checks if we don't have two planes on the same layer
preference_species - Checks that all enabled roundstart species
selectable within the preferences menu
have their info / page setup correctly.
preferences_implement_everything - Requires all preferences to implement required methods.
preferences_valid_main_feature_name - Requires all main features have a main_feature_name
preferences_valid_savefile_key - Requires all preferences to have a valid, unique savefile_identifier.
quirk_icons - Ensure every quirk has a unique icon
range_return - This tests for an unspecified bit of behavior we rely on in energy_ball.dm code
Essentially, as of the current byond version, range and view will return turfs in what looks "roughly" like a circle
So we can be guarenteed that if we find a turf, it will be the closest turf of that sort, or at least one of them
This code tests for that. If this ever fails, remove the logic fron energy_ball.dm, and test if spiral_turfs would be faster
reagent_container_sanity - Test to ensure that all possible reagent containers have enough space to hold any reagents they spawn in with.
A drink can with only 30 units of space should not be able to hold 50 units of drink, as an example.
reagent_names - Test that all reagent names are different in order to prevent #65231 and tests that searching for that reagent by name gives the correct one
reagent_transfer - Tests transferring reagents between two reagents datums.
say_signal - Test to verify COMSIG_MOB_SAY is sent the exact same list as the message args, as they're operated on
screenshot_antag_icons - A screenshot test to make sure every antag icon in the preferences menu is consistent
screenshot_basic - This is an example for screenshot tests, and a meta-test to make sure they work in the success case.
It creates a picture that is red on the left side, green on the other.
screenshot_dynamic_human_icons - A screenshot test for specific dynamic human icons
screenshot_humanoids - A screenshot test for every humanoid species with a handful of jobs.
screenshot_husk - A screenshot test for husks
screenshot_saturnx - A screenshot test for making sure invisible limbs function, keeping them clothed so we know they're there.
shapeshift_holoparasites - Validates that shapeshifts function properly with holoparasites.
shapeshift_spell - Validates that shapeshift spells put the mob in another mob, as they should.
shapeshift_spell_validity - Validates that all shapeshift type spells have a valid possible_shapes setup.
simple_animal_freeze - Tests that no new simple_animal subtypes are added.
slips - Unit test that forces various slips on a mob and checks return values and mob state to see if the slip has likely been successful.
space_dragon_expiration - Unit tests that the space dragon - when its rift expires and it gets qdel'd - doesn't delete all the mobs it has eaten
spawn_mobs - Unit test that spawns all mobs that can be spawned by golden slimes
species_change_clothing - Gives a Human lizard-incompatible shoes, then changes their species over to see if they drop the now incompatible shoes, testing if Digitigrade feet works.
Gives a Monkey a collar, then changes their species to Human to see if item's restrictions works on species change.
species_change_held_items - Gives a Human items in both hands, then swaps them to be another species. Held items should remain.
species_change_organs - Unit test to ensure that, when a mob changes species,
certain aspects are carried over between their old and new set of organs
(brain traumas, cybernetics, and organ damage)
species_unique_id - Every species should use a species ID unique to it and it alone. This test runs through every subtype of /datum/species, and checks for a species ID.
Every ID is written to a list, gathered_species_ids, and if a previously written ID is written again, this test will fail.
speech - This runs some simple speech tests on a speaker and listener and determines if a person can hear whispering or speaking as they are moved a distance away
spell_invocations - Validates that all spells have a correct
invocation type and invocation setup.
spell_names - Validates that all spells have a different name.
spritesheets - Checks if spritesheet assets contain icon states with invalid names
stack_singular_name - Goes through every subtype of /obj/item/stack to check for a singular name, var/singular_name.
Everything within the blacklist does not need to be tested because it exists to be overriden.
This test will fail if a subtype of /obj/item/stack is missing a singular name.
start_tend_wounds - Ensures that the tend wounds surgery can be started
station_traits - This test spawns various station traits and looks through them to see if there's any errors.
tgui_create_message - Test that TGUI_CREATE_MESSAGE is correctly implemented
trait_addition_and_removal - Simple Unit Test to ensure multiple methods of adding/removing a trait work as intended.
translate_language - This unit test translates a string from one language to another depending on if the person can understand the language
tutorial_sanity - Verifies that every tutorial has properly set variables
verify_config_tags - Unit Test to ensure that all config tags that we associate to all jobs in SSjob.joinable_occupations are valid.
verify_emoji_names - Apparently, spritesheets (or maybe how the CSS backend works) do not respond well to icon_state names that are just pure numbers (which was a behavior in emoji.dmi).
In case we add more emoji, let's just make sure that we don't have any pure numbers in the emoji.dmi file if we ever add more.
wizard_loadout - Test loadouts for crashes, runtimes, stack traces and infinite loops. No ASSERTs necessary.
worn_icons - Makes sure suit slot items aren't using CS:S fallbacks.
mirroring - Tracks and updates another mob with our mob's visual data
tracking - Tracks but does not relay updates to someone's visual data
Accepts a second visual data datum to use as a source of truth for the mob's values
voice_of_god_command - Voice of god command datums that are used in [/proc/voice_of_god()]
attract - This command throws the listeners at the user.
bleed - This command makes carbon listeners bleed from a random body part.
brute - This command applies 15 points of brute damage to the listeners. There's subtle theological irony in this being more powerful than healing.
burn - This command sets the listeners ablaze.
cold - This command cools the listeners down like freezing water.
emote - Supertype of all those commands that make people emote and nothing else. Fuck copypasta.
getup - This command forces the listeners to get the fuck up, resetting all stuns.
hallucinate - This command makes the listeners see others as corgis, carps, skellies etcetera etcetera.
heal - This command heals the listeners for 10 points of total damage.
honk - This command plays a bikehorn sound after 2 seconds and a half have passed, and also slips listeners if the user is a clown.
hot - This command heats the listeners up like boiling water.
immobilize - This command stops the listeners from moving.
jump - This command forces the listener to do the jump emote 3/4 of the times or reply "HOW HIGH?!!".
knock_knock - This command forces the listeners to say "Who's there?".
knockdown - This command knocks the listeners down.
move - This command forces the listeners to take step in a direction chosen by the user, otherwise a random cardinal one.
multispin - This command spins the listeners 1800° degrees clockwise.
repulse - This command throws the listeners away from the user.
run - This command forces the listeners to switch to run intent.
say_my_name - This command forces the listeners to say the user's name
silence - This command silences the listeners. Thrice as effective is the user is a mime or curator.
sit - This command forces each listener to buckle to a chair found on the same tile.
speak - This command forces the listeners to say a brain damage line.
stand - This command forces each listener to unbuckle from whatever they are buckled to.
state_laws - This command forces silicon listeners to state all their laws.
throw_catch - This command turns the listeners' throw mode on.
vomit - This command makes carbon listeners throw up like Mr. Creosote.
wake_up - This command wakes up the listeners.
walk - This command forces the listeners to switch to walk intent.
who_are_you - This command forces the listeners to say their true name (so masks and hoods won't help).
Basic and simple mobs who are forced to state their name and don't have one already will... reveal their actual one!
Vote Singleton - A singleton datum that represents a type of vote for the voting subsystem.
rock_the_vote - If a map vote is called before the emergency shuttle leaves the station, the players can call another vote to re-run the vote on the shuttle leaving.
Voucher Set - A set consisting of a various equipment that can be then used as a reward for redeeming a mining voucher.
basic - Simple animals 2.0, This time, let's really try to keep it simple. This basetype should purely be used as a base-level for implementing simplified behaviours for things such as damage and attacks. Everything else should be in components or AI behaviours.
Magicarp - Carp who can cast spells!
Mostly created via wizard event or transformation.
Come in 'does one thing' and 'does random things' varieties.
Chaos Magicarp - Fires a random spell (and changes colour) every time, also beefier.
Sometimes actually more durable than the much larger megacarp. That's magic for you.
They trade off for this with a tendency to fireball themselves.
xenobiology - Has a more limited spell pool but can appear from gold slime cores
pet - Pet carp, abstract carp which just holds some shared properties.
cayenne - Cayenne - Loyal member of the nuclear operatives.
Spawns in the nuke op shuttle, can be made sapient if they want to do that for some reason.
Is very talented and also capable of holding the nuclear disk.
lia - Lia - Sometimes the pet of the Head of Security.
Has a lot more health than a normal carp because she's meant to be a mildly more threatening pet to have to assassinate than an aging corgi.
swarm - Weaker variant of ghosts. Meant to be summoned in swarms via the ectoplasmic anomaly and associated ghost portal.
Giant Spider - A mob which can be created by dynamic event, botany, or xenobiology.
The basic type is the guard, which is slow but sturdy and outputs good damage.
All spiders can produce webbing.
Wumborian Fugu - A strange alien creature capable of increasing its mass when threatened, when not inflated it is virtually defenceless.
Mostly only appears from xenobiology, or the occasional wizard.
On death, the "fugu gland" is dropped, which can be used on mobs to increase their size, health, strength, and lets them smash walls.
human - Any humanoid (non-Xeno) mob, such as humans, plasmamen, lizards.
consistent - Provides a dummy for unit_tests that functions like a normal human, but with a standardized appearance
Copies the stock dna setup from the dummy/consistent type
Goliath Broodmother - A stronger, faster variation of the goliath. Has the ability to spawn baby goliaths, which it can later detonate at will.
When it's health is below half, tendrils will spawn randomly around it. When it is below a quarter of health, this effect is doubled.
It's attacks are as follows:
Herald - A slow-moving projectile user with a few tricks up it's sleeve. Less unga-bunga than Colossus, with more cleverness in it's fighting style.
As it's health gets lower, the amount of projectiles fired per-attack increases.
It's attacks are as follows:
Legionnaire - A towering skeleton, embodying the power of Legion.
As it's health gets lower, the head does more damage.
It's attacks are as follows:
Pandora - A box with a similar design to the Hierophant which trades large, single attacks for more frequent smaller ones.
As it's health gets lower, the time between it's attacks decrease.
It's attacks are as follows:
lobstrosity - Lobstrosities, the poster boy of charging AI mobs. Drops crab meat and bones.
Outside of charging, it's intended behavior is that it is generally slow moving, but makes up for that with a knockdown attack to score additional hits.
bear/fightpit - If the atom entering the gate is a vehicle, we store it here to add to the approved list to enter/leave the scanner gate.
We store the driver of vehicles separately so that we can add them to the approved list once payment is fully processed.
blob - retreat doesn't obey pass_flags, so won't work on blob mobs.
lightgeist - A small critter meant to heal other living mobs and unable to interact with almost everything else.
The procs related to its unarmed attacks can be found in _onclick/other_mobs.dm (attack_lightgeist)
Space Dragon - A space-faring leviathan-esque monster which breathes fire and summons carp. Spawned during its respective midround antagonist event.
vatbeast - Vatbeasts are creatures from vatgrowing and are literaly a beast in a vat, yup. They are designed to be a powerful mount roughly equal to a gorilla in power.
proccall_handler - Used to handle proccalls called indirectly by an admin (e.g. tgs, circuits).
Has to be a mob because IsAdminAdvancedProcCall() checks usr, which is a mob variable.
So usr is set to this for any proccalls that don't have any usr mob/client to refer to.
durand_shield - Shield processing
*An object to take the hit for us when using the Durand's defense mode.
It is spawned in during the durand's initilization, and always stays on the same tile.
Normally invisible, until defense mode is actvated. When the durand detects an attack that should be blocked, the
attack is passed to the shield. The shield takes the damage, uses it to calculate charge cost, and then sets its
own integrity back to max. Shield is automatically dropped if we run out of power or the user gets out.
effect
abstract - The abstract effect ignores even more effects and is often typechecked for atoms that should truly not be fucked with.
chasm_storage - An abstract object which is basically just a bag that the chasm puts people inside
info - An info button that, when clicked, puts some text in the user's chat
local_food_rain - Makes food land near it until it expires
particle_holder - objects can only have one particle on them at a time, so we use these abstract effects to hold and display the effects. You know, so multiple particle effects can exist at once.
also because some objects do not display particles due to how their visuals are built
z_holder - Exists to be placed on the turf of walls and such to hold the vis_contents of the tile below
Otherwise the lower turf might get shifted around, which is dumb. do this instead.
trading_card_panel - A display panel that renders a set of icons (in this case mana crystals), this is generated by /obj/machinery/trading_card_button and can be manipulated by the button which generates it.
health - A variant of the display panel for life shards, this one is set up to display two columns.
permanent - A form of the cult forcefield that lasts permanently.
Used on the Shuttle 667.
mime - Mime forcefields (invisible walls)
psychic - Psyker forcefield
wizard - The wizard's forcefield, summoned by forcewall
grand_rune - Magic rune used in the grand ritual.
A wizard sits themselves on this thing and waves their hands for a while shouting silly words.
Then something (usually bad) happens.
heretic_rune - The heretic's rune, which they use to complete transmutation rituals.
big - A 3x3 heretic rune. The kind heretics actually draw in game.
hotspot - Hotspot objects interfaces with the temperature of turf gasmixtures while also providing visual effects.
One important thing to note about hotspots are that they can roughly be divided into two categories based on the bypassing variable.
heretic - Lardmarks meant to designate where heretic sacrifices are sent.
lift_id - lift_id landmarks. used to map in specific_lift_id to trams. when the trams lift_master encounters one on a trams tile
it sets its specific_lift_id to that landmark. allows you to have multiple trams and multiple controls linking to their specific tram
corpse - these mob spawn subtypes trigger immediately (New or Initialize) and are not player controlled... since they're dead, you know?
ai - dead ai, blue screen and everything.
facehugger - dead facehuggers, great for xeno ruins so you can have a cool ruin without spiraling the entire round into xenomorph hell. also, this is a terrible terrible artifact of time
aimodule/harmless - AI uploads have the ai_module/reset , ai_module/supplied/freeform , ai_module/reset/purge , and ai_module/core/full/asimov directly mapped in
food_or_drink/cake_ingredients - Used for the employee birthday station trait
round_default_fallback - When the default lawset spawner cannot find a module object to spawn, it will spawn this, and this sets itself to the round default.
This is so /datum/lawsets can be picked even if they have no module for themselves.
malf - Makes the AI Malf, as well as give it syndicate laws.
sign_language - Sign language book adds the sign language component to the reading Human.
Grants reader the ability to toggle sign language using a HUD button.
bounty_cube - Upon completion of a civilian bounty, one of these is created. It is sold to cargo to give the cargo budget bounty money, and the person who completed it cash.
Index Table Component - Gets the row of a table as an associative list using the index inputted. Will return no value if the index is invalid or a proper table is not returned.
Bar Overlay Component - Basically an advanced verion of object overlay component that shows a horizontal/vertical bar.
Requires a BCI shell.
Pathfinding component - Calcualtes a path, returns a list of entities. Each entity is the next step in the path. Can be used with the direction component to move.
Proximity Pinpointer Component - Return the location of its input.
SDQL Component - A component that performs an sdql operation
Select Component - Selects a list from a list of lists by a specific column. Used only by USBs for communications to and from computers with lists of varying sizes.
rtd - An tool used to create, destroy, and copy & clear decals of floor tiles
Great for janitor but can be made only in engineering
Supports silo link upgrade and refill with glass, plasteel & iron
Compact Remote - A handheld device with several buttons.
In game, this translates to having different signals for normal usage, alt-clicking, and ctrl-clicking when in your hand.
monkeycube/syndicate - internal proc called by a monkeycube's suicide_act using a timer and callback. takes as argument the mob/living who activated the suicide
Spider Charge - A unique version of c4 possessed only by the space ninja. Has a stronger blast radius.
Can only be detonated by space ninjas with the bombing objective. Can only be set up where the objective says it can.
When it primes, the space ninja responsible will have their objective set to complete.
smokebomb - This is smoke bomb, mezum koman. It is a grenade subtype. All craftmanship is of the highest quality.
It menaces with spikes of iron. On it is a depiction of an assistant.
The assistant is bleeding. The assistant has a painful expression. The assistant is dead.
ballistic - Subtype for any kind of ballistic gun
This has a shitload of vars on it, and I'm sorry for that, but it does make making new subtypes really easy