outfit

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.

You can also specify an outfit datum on a job to have it auto equipped to the mob on join

/mob/living/carbon/human/proc/equipOutfit(outfit) is the mob level proc to equip an outfit and you pass it the relevant datum outfit

outfits can also be saved as json blobs downloadable by a client and then can be uploaded by that user to recreate the outfit, this is used by admins to allow for custom event outfits that can be restored at a later date

Vars
accessory	Any clothing accessory item
back	Type path of item to go in back slot
backpack_contents	list of items that should go in the backpack of the user
belt	Type path of item to go in belt slot
box	Internals box. Will be inserted at the start of backpack_contents
can_be_admin_equipped	Set to FALSE if your outfit requires runtime parameters
chameleon_extras	extra types for chameleon outfit changes, mostly guns
ears	Type path of item to go in ears slot
glasses	Type path of item to go in the glasses slot
gloves	Type path of item to go in gloves slot
head	Type path of item to go in head slot
id	Type path of item to go in the idcard slot
implants	Any implants the mob should start implanted with
internals_slot	ID of the slot containing a gas tank
l_pocket	Type path of item for left pocket slot
mask	Type path of item to go in mask slot
name	Name of the outfit (shows up in the equip admin verb)
neck	Type path of item to go in neck slot
r_hand	Type path of item to go in the right hand
r_pocket	Type path of item for right pocket slot
shoes	Type path of item to go in shoes slot
suit	Type path of item to go in suit slot
suit_store	Type path of item to go in suit storage slot
toggle_helmet	Should the toggle helmet proc be called on the helmet during equip
undershirt	Any undershirt. While on humans it is a string, here we use paths to stay consistent with the rest of the equips.
uniform	Type path of item to go in uniform slot
Procs
apply_fingerprints	Apply a fingerprint from the passed in human to all items in the outfit
equip	Equips all defined types and paths to the mob passed in
get_chameleon_disguise_info	Return a list of all the types that are required to disguise as this outfit type
get_json_data	Return a json list of this outfit
load_from	Create an outfit datum from a list of json data
post_equip	Called after the equip proc has finished
pre_equip	Called at the start of the equip proc
save_to_file	Prompt the passed in mob client to download this outfit as a json blob

Var Details

var
accessory
–

Any clothing accessory item

var
back
–

Type path of item to go in back slot

var
backpack_contents
– /list

list of items that should go in the backpack of the user

Format of this list should be: list(path=count,otherpath=count)

var
belt
–

Type path of item to go in belt slot

var
box
–

Internals box. Will be inserted at the start of backpack_contents

var
can_be_admin_equipped
–

Set to FALSE if your outfit requires runtime parameters

var
chameleon_extras
– /list

extra types for chameleon outfit changes, mostly guns

Format of this list is (typepath, typepath, typepath)

These are all added and returns in the list for get_chamelon_diguise_info proc

var
ears
–

Type path of item to go in ears slot

var
glasses
–

Type path of item to go in the glasses slot

var
gloves
–

Type path of item to go in gloves slot

var
head
–

Type path of item to go in head slot

var
id
–

Type path of item to go in the idcard slot

var
implants
– /list

Any implants the mob should start implanted with

Format of this list is (typepath, typepath, typepath)

var
internals_slot
–

ID of the slot containing a gas tank

var
l_pocket
–

Type path of item for left pocket slot

var
mask
–

Type path of item to go in mask slot

var
name
–

Name of the outfit (shows up in the equip admin verb)

var
neck
–

Type path of item to go in neck slot

var
r_hand
–

Type path of item to go in the right hand

var
r_pocket
–

Type path of item for right pocket slot

var
shoes
–

Type path of item to go in shoes slot

var
suit
–

Type path of item to go in suit slot

var
suit_store
–

Type path of item to go in suit storage slot

(make sure it's valid for that suit)

var
toggle_helmet
–

Should the toggle helmet proc be called on the helmet during equip

var
undershirt
– /datum/sprite_accessory

Any undershirt. While on humans it is a string, here we use paths to stay consistent with the rest of the equips.

var
uniform
–

Type path of item to go in uniform slot

Proc Details

proc
apply_fingerprints
(/mob/living/carbon/human/H)

Apply a fingerprint from the passed in human to all items in the outfit

Used for forensics setup when the mob is first equipped at roundstart essentially calls add_fingerprint to every defined item on the human

proc
equip
(/mob/living/carbon/human/H, visualsOnly, /client/preference_source)

Equips all defined types and paths to the mob passed in

Extra Arguments

visualsOnly true if this is only for display (in the character setup screen)

If visualsOnly is true, you can omit any work that doesn't visually appear on the character sprite

proc
get_chameleon_disguise_info
()

Return a list of all the types that are required to disguise as this outfit type

proc
get_json_data
()

Return a json list of this outfit

proc
load_from
(/list/outfit_data)

Create an outfit datum from a list of json data

proc
post_equip
(/mob/living/carbon/human/H, visualsOnly)

Called after the equip proc has finished

All items are on the mob at this point, use this proc to toggle internals fiddle with id bindings and accesses etc

Extra Arguments

visualsOnly true if this is only for display (in the character setup screen)

If visualsOnly is true, you can omit any work that doesn't visually appear on the character sprite

proc
pre_equip
(/mob/living/carbon/human/H, visualsOnly)

Called at the start of the equip proc

Override to change the value of the slots depending on client prefs, species and other such sources of change

Extra Arguments

visualsOnly true if this is only for display (in the character setup screen)

If visualsOnly is true, you can omit any work that doesn't visually appear on the character sprite

proc
save_to_file
(/mob/admin)

Prompt the passed in mob client to download this outfit as a json blob

Outfit datums /datum/outfit

Vars

Procs

Var Details

var accessory –

var back –

var backpack_contents – /list

var belt –

var box –

var can_be_admin_equipped –

var chameleon_extras – /list

var ears –

var glasses –

var gloves –

var head –

var id –

var implants – /list

var internals_slot –

var l_pocket –

var mask –

var name –

var neck –

var r_hand –

var r_pocket –

var shoes –

var suit –

var suit_store –

var toggle_helmet –

var undershirt – /datum/sprite_accessory

var uniform –

Proc Details

proc apply_fingerprints(/mob/living/carbon/human/H)

proc equip(/mob/living/carbon/human/H, visualsOnly, /client/preference_source)

proc get_chameleon_disguise_info()

proc get_json_data()

proc load_from(/list/outfit_data)

proc post_equip(/mob/living/carbon/human/H, visualsOnly)

proc pre_equip(/mob/living/carbon/human/H, visualsOnly)

proc save_to_file(/mob/admin)

Outfit datums
/datum/outfit

var
accessory
–

var
back
–

var
backpack_contents
– /list

var
belt
–

var
box
–

var
can_be_admin_equipped
–

var
chameleon_extras
– /list

var
ears
–

var
glasses
–

var
gloves
–

var
head
–

var
id
–

var
implants
– /list

var
internals_slot
–

var
l_pocket
–

var
mask
–

var
name
–

var
neck
–

var
r_hand
–

var
r_pocket
–

var
shoes
–

var
suit
–

var
suit_store
–

var
toggle_helmet
–

var
undershirt
– /datum/sprite_accessory

var
uniform
–

proc
apply_fingerprints
(/mob/living/carbon/human/H)

proc
equip
(/mob/living/carbon/human/H, visualsOnly, /client/preference_source)

proc
get_chameleon_disguise_info
()

proc
get_json_data
()

proc
load_from
(/list/outfit_data)

proc
post_equip
(/mob/living/carbon/human/H, visualsOnly)

proc
pre_equip
(/mob/living/carbon/human/H, visualsOnly)

proc
save_to_file
(/mob/admin)