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
belt_contents	list of items that should go in the belt of the user
box	Internals box. Will be inserted at the start of backpack_contents
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
id_trim	Type path of ID card trim associated with this outfit.
implants	Any implants the mob should start implanted with
internals_slot	ID of the slot containing a gas tank
l_hand	Type path of item to go in the right hand
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
preload	Should we preload some of this job's items?
r_pocket	Type path of item for right pocket slot
shoes	Type path of item to go in shoes slot
skillchips	Any skillchips the mob should have in their brain.
suit	Type path of item to go in suit slot
suit_store	Type path of item to go in suit storage slot
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
copy_from	Copy most vars from another outfit to this one
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
get_types_to_preload	Return a list of types to pregenerate for later equipping This should not be things that do unique stuff in Initialize() based off their location, since we'll be storing them for a while
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
belt_contents
– /list

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

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

var
box
–

Internals box. Will be inserted at the start of backpack_contents

var
chameleon_extras
– /list

extra types for chameleon outfit changes, mostly guns

Valid values are a single typepath or list of typepaths

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
id_trim
–

Type path of ID card trim associated with this outfit.

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_hand
–

Type path of item to go in the right hand

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
preload
–

Should we preload some of this job's items?

var
r_pocket
–

Type path of item for right pocket slot

var
shoes
–

Type path of item to go in shoes slot

var
skillchips
– /list

Any skillchips the mob should have in their brain.

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

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
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/user)

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
copy_from
(/datum/outfit/target)

Copy most vars from another outfit to this one

proc
equip
(/mob/living/carbon/human/user, visuals_only)

Equips all defined types and paths to the mob passed in

Extra Arguments

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

If visuals_only 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
get_types_to_preload
()

Return a list of types to pregenerate for later equipping This should not be things that do unique stuff in Initialize() based off their location, since we'll be storing them for a while

proc
load_from
(/list/outfit_data)

Create an outfit datum from a list of json data

proc
post_equip
(/mob/living/carbon/human/user, visuals_only)

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

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

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

proc
pre_equip
(/mob/living/carbon/human/user, visuals_only)

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

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

If visuals_only 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 belt_contents – /list

var box –

var chameleon_extras – /list

var ears –

var glasses –

var gloves –

var head –

var id –

var id_trim –

var implants – /list

var internals_slot –

var l_hand –

var l_pocket –

var mask –

var name –

var neck –

var preload –

var r_pocket –

var shoes –

var skillchips – /list

var suit –

var suit_store –

var undershirt – /datum/sprite_accessory

var uniform –

Proc Details

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

proc copy_from(/datum/outfit/target)

proc equip(/mob/living/carbon/human/user, visuals_only)

proc get_chameleon_disguise_info()

proc get_json_data()

proc get_types_to_preload()

proc load_from(/list/outfit_data)

proc post_equip(/mob/living/carbon/human/user, visuals_only)

proc pre_equip(/mob/living/carbon/human/user, visuals_only)

proc save_to_file(/mob/admin)

Outfit datums
/datum/outfit

var
accessory
–

var
back
–

var
backpack_contents
– /list

var
belt
–

var
belt_contents
– /list

var
box
–

var
chameleon_extras
– /list

var
ears
–

var
glasses
–

var
gloves
–

var
head
–

var
id
–

var
id_trim
–

var
implants
– /list

var
internals_slot
–

var
l_hand
–

var
l_pocket
–

var
mask
–

var
name
–

var
neck
–

var
preload
–

var
r_pocket
–

var
shoes
–

var
skillchips
– /list

var
suit
–

var
suit_store
–

var
undershirt
– /datum/sprite_accessory

var
uniform
–

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

proc
copy_from
(/datum/outfit/target)

proc
equip
(/mob/living/carbon/human/user, visuals_only)

proc
get_chameleon_disguise_info
()

proc
get_json_data
()

proc
get_types_to_preload
()

proc
load_from
(/list/outfit_data)

proc
post_equip
(/mob/living/carbon/human/user, visuals_only)

proc
pre_equip
(/mob/living/carbon/human/user, visuals_only)

proc
save_to_file
(/mob/admin)