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.
directional_attack - This element allows the mob its attached to the ability to click an adjacent mob by clicking a distant atom
that is in the general direction relative to the parent.
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_holder - Language holders will either exist in an atom/movable. 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.
background - A generic background object.
It is also implicitly used to allocate a rectangle on the map, which will
be used for auto-scaling the map.
map_view - A screen object, which acts as a container for turfs and other things
you want to show on the map, which you usually attach to "vis_contents".
plane_master
emissive - Things placed on this mask the lighting plane. Doesn't render directly.
emissive_blocker - Things placed on this layer mask the emissive layer. Doesn't render directly
emissive_unblockable - Things placed on this always mask the lighting plane. Doesn't render directly.
floor - Contains just the floor
game_world - Contains most things in the game world
lighting - Contains all lighting objects
openspace - Things rendered on "openspace"; holes in multi-z
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.
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.
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.
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
tipped_reaction - type of tipped reaction that is akin to puppy dog eyes
use_in_hand - Use in hand the currently held item
use_on_object - Use the currently held item, or unarmed, on an object in the world
dumb - The most braindead type of movement, bee-line to the target with no concern of whats infront 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
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.
find_food - similar to finding a target but looks for food types in the // the what?
asset/simple - If you don't need anything complicated.
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)
asset_cache_item - An internal datum containing info on items in the asset cache. Mainly used to cache md5 info for speed.
rezadone - things im not going to organize right now (This means they should be in another file)
sbiten - DRINKS THAT REQUIRED IMPROVED SPRITES BELOW:: -Agouri
spaceacillin - status chems
surfactant - foam and foam precursor
synthflesh - Multi-damage chems
tofu - FOOD MIXTURES
tramal - pain chems
virus_food - VIROLOGY
yuck - EXPANDED MUTATION TOXINS
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".
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.
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.
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.
footstep - Footstep component. Plays footsteps at parents location when it is appropriate.
fov_handler - Component which handles Field of View masking for clients. FoV attributes are at /mob/living
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.
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
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
tank - input and output, like a holding tank
ranged_attacks - Configurable ranged attack for basic mobs.
default_no_vote - If disabled, no-voters will automatically have their votes added to certain vote options
(For eample: restart votes will default to "no restart", map votes will default to their preferred map / default map)
enable_mob_layershifting - Allows clients to shift the visual layer of the mob they are controlling
panic_bunker_interview - Flag for requiring players who would otherwise be denied access by the panic bunker to complete a written interview
popup_admin_pm - Gives the ability to send players a maptext popup.
number/outdated_movedelay - Outdated move delay
str_list - List config entry, used for configuring a list of strings
string/admin_2fa_url - URL for admins to be redirected to for 2FA
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
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_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.
atmos_requirements - Atmos effect - Yes, you can make creatures that require plasma or co2 to survive. N2O is a trace gas and handled separately, hence why it isn't here. It'd be hard to add it. Hard and me don't mix (Yes, yes make all the dick jokes you want with that.) - Errorage
Leaving something at 0 means it's off - has no maximum.
This damage is taken when atmos doesn't fit all the requirements above.
basic_body_temp_sensetive - When attached to a basic mob, it gives it the ability to be hurt by cold 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.
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.
give_turf_traits - A bespoke element that adds a set of traits to the turf while occupied by at least one attached movabled.
immerse - A visual element that makes movables entering the attached turfs look immersed into that turf.
May the gods forgive me for the bullshit you're about to witness
item_fov - An element to unconditonally add a FOV trait to the wearer, removing it when an item is unequipped
kneecapping - Kneecapping element replaces the item's disarm attack with an aimed attack at the kneecaps under certain circumstances.
light_blocking - Attached to movable atoms with opacity. Listens to them move and updates their old and new turf loc's opacity accordingly.
movetype_handler - An element that enables and disables movetype bitflags as movetype traits are added and 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 include it when
manipulating those traits on non-living movables.
perma_fire_overlay - When applied to a mob, they will always have a fire overlay regardless of if they are actually on fire.
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
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.
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.
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
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.
protocol - A nanite program containing a behaviour protocol. Only one protocol of each class can be active at once.
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
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.
Overmap objects - Everything visible on the overmap: stations, ships, ruins, events, and more.
Dynamic Overmap Encounters - These overmap objects can be docked with and will create a dynamically generated area of many different types depending on the planet variable.
When undocked with, it checks if there's anyone left on the planet, and if not, will move to another random location and wait to create a new encounter.
Overmap Events - These are events that have some sort of effect on overmap ships that are on the same tile.
electric - ELECTRICAL STORM - explodes your computer and IPCs
emp - Electromagnetic - explodes your IPCs
flare - SOLAR FLARE - Explodes your organics and IPCs
meteor - METEOR STORMS - explodes your ship if you go too fast
debris - DEBRIS FIELDS - explodes your ship if you go too fast
Fluff Object - These overmap objects for decoration, unlike /datum/overmap/customizable_object these are premade, and as such are prefered over those for use in static sectors.
Jump points - These overmap objects can be interacted with and will send you to another sector.
These will then dump you onto another jump point post jump. Useful for events or punchcards!
Fluff Object - These overmap objects for decoration, unlike /datum/overmap/customizable_object these are premade, and as such are prefered over those for use in static sectors.
Overmap ships - Basically, any overmap object that is capable of moving by itself. //wouldnt it make more sense for this to be named /datum/overmap/movable
Static Overmap Encounters - These overmap objects can be docked with and will load a premapped "planet". Think of these like gateways.
When undocked with, it checks if there's anyone left on the planet, and if not, will delete themseles.
overmap_datum_token_manager - Datum for the overmap datum token manager.
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.
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
The highest amount of refs its had after failing to qdel
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
Flags related to this type's trip thru qdel.
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.
Request - A representation of an in-game request, such as a prayer.
Request Manager - Handles all player requests (prayers, centcom requests, syndicate requests)
that occur in the duration of a round.
stack_canary - Stack canary. Will go away if the stack it was primed by is ended by byond for return or stack overflow reasons.
stack_end_detector - Stack End Detector.
Can detect if a given code stack has exited, used by the mc for stack overflow detection.
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.
dazzled - Dazzled.
Used when we need to blind someone for entering an area, but only temporarily.
grouped - Status effect from multiple sources, when all sources are removed, so is the effect
Adds itself to sources and destroys itself if one exists already, there are never multiple
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.
swimming - Added by the swimming_tile element. Drains stamina over time until the owner stops being immersed. Starts drowning them if they are prone or small.
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
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
team
borer - ACTUAL ANTAG DATUM THINGS (Translation: Big Scary Magic Things)
tgs_chat_command - User definable chat command. This abstract version MUST be overridden to be used.
tgs_chat_embed
field - See https://discord.com/developers/docs/resources/message#embed-object-embed-field-structure for details.
footer - See https://discord.com/developers/docs/resources/message#embed-object-embed-footer-structure for details.
media - Common datum for similar Discord embed medias.
provider - See https://discord.com/developers/docs/resources/message#embed-object-embed-provider-structure for details.
author - See https://discord.com/developers/docs/resources/message#embed-object-embed-author-structure for details. Must have name set in New().
structure - User definable chat embed. Currently mirrors Discord chat embeds. See https://discord.com/developers/docs/resources/message#embed-object for details.
tgui - Copyright (c) 2020 Aleksej Komarov
SPDX-License-Identifier: MIT
tgui_input_number - Datum used for instantiating and using a TGUI-controlled numbox that prompts the user with
a message and has an input for text entry.
async tgui_input_number - An asynchronous version of tgui_input_number to be used with callbacks instead of waiting on user responses.
tgui_list_input - Datum used for instantiating and using a TGUI-controlled list input that prompts the user with
a message and shows a list of selectable options
async tgui_list_input - An asynchronous version of tgui_list_input to be used with callbacks instead of waiting on user responses.
tgui_modal - Datum used for instantiating and using a TGUI-controlled modal that prompts the user with
a message and has buttons for responses.
async tgui_modal - An asynchronous version of tgui_modal to be used with callbacks instead of waiting on user responses.
tgui_panel - Copyright (c) 2020 Aleksej Komarov
SPDX-License-Identifier: MIT
tgui_window - Copyright (c) 2020 Aleksej Komarov
SPDX-License-Identifier: MIT
wound_pregen_data - A singleton datum that holds pre-gen and static data about a wound. Each wound datum should have a corresponding wound_pregen_data.
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.
Alien - The base subtype of all aliens. Used to establish the basic mechanics (such as organs) they use.
humanoid
Alien Hunter - A fast-moving caste of alien capable of pouncing on prey, stunning them for a decent amount of time. They are, however, the squishiest caste as well.
Alien Royal - A subtype of alien which is used for the larger alien castes (queen and praetorian)
Alien Praetorian - A larget, tankier alien who wields an impressive amount of health at the cost of speed and ventcrawling.
Alien Queen - The most important alien caste, the queen is the only reproductive member of the set.
Alien Sentinel - A slightly more durable but less mobile xeno caste. Utilizes neurotoxin to bring down prey, and has a unique cloaking ability.
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.
Facehugger - A simplemob used by aliens to reproduce. Will attempt to impregnate humans on its own, but can also be picked up and thrown for more efficiency.
Toy Facehugger - A toy breed of facehugger which is sterile and can be purchased from the mining vendor.
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.
chasm_storage - An abstract object which is basically just a bag that the chasm puts people inside
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
ammo_stack - The ammo stack object itself, making this a magazine was the easiest way to handle it
Practically every casing type needs an associated ammo stack type, because that was the easiest
way for me to handle it.
hard_drive/small/nukeops - For tablets given to nuke ops
recharger/cyborg - This recharger exists only in borg built-in tablets. I would have tied it to the borg's cell but
the program that displays laws should always be usable, and the exceptions were starting to pile.
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
self_grasp - an abstract item representing you holding your own limb to staunch the bleeding, see [/mob/living/carbon/proc/grabbedby] will probably need to find somewhere else to put this.
training_toolbox - Device that simply counts the number of times you've hit a mob or target with. Looks like a toolbox but isn't.
udder item - Abstract item that is held in nullspace and manages reagents. Created by udder component.
While perhaps reagents created by udder component COULD be managed in the mob, it would be somewhat finnicky and I actually like the abstract udders.
gutlunch udder subtype - Used by gutlunches, and generates healing reagents instead of milk on eating gibs instead of a process. Starts empty!
Female gutlunches (ahem, guthens if you will) make babies when their udder is full under processing, instead of milk generation
plumbing - Basic plumbing object.
It doesn't really hold anything special, YET.
Objects that are plumbing but not a subtype are as of writing liquid pumps and the reagent_dispenser tank
Also please note that the plumbing component is toggled on and off by the component using a signal from default_unfasten_wrench, so dont worry about it
acclimator - this the plumbing version of a heater/freezer.
filter - chemical plumbing filter. If it's not filtered by left and right, it goes straight.
input - We can empty beakers in here and everything
liquid_pump - We pump liquids from activated(plungerated) geysers to a plumbing outlet. We need to be wired.
output - We can fill beakers in here and everything. we dont inheret from input because it has nothing that we need
pill_press - We take a constant input of reagents, and produce a pill once a set volume is reached
reaction_chamber - a reaction chamber for plumbing. pretty much everything can react, but this one keeps the reagents seperated and only reacts under your given terms
splitter - it splits the reagents however you want. So you can "every 60 units, 45 goes left and 15 goes straight". The side direction is EAST, you can change this in the component
synthesizer - A single machine that produces a single chem. Can be placed in unison with others through plumbing to create chemical factories
merge_conflict_marker - How many mats have we found? You can only be affected by two material datums by default
How much of each material is in it? Used to determine if the glass should break
The glass shard that is spawned into the source item
victim's chest (for cavity implanting the item)
boh_tear - BoH tear
The BoH tear is a stationary singularity with a really high gravitational pull, which collapses briefly after being created
The BoH isn't deleted for 10 minutes (only moved to nullspace) so that admins may retrieve the things back in case of a grief