preferences

Vars
allow_advanced_colors	Allows the user to freely color his body markings and mutant parts.
alt_job_titles	Alternative job titles stored in preferences. Assoc list, ie. alt_job_titles["Scientist"] = "Cytologist"
augment_limb_styles	List of chosen preferred styles for limb replacements
augments	List of chosen augmentations. It's an associative list with key name of the slot, pointing to a typepath of an augment define
be_special	List of ROLE_X that the client wants to be eligible for
body_markings	A list of all bodymarkings
character_data	The savefile relating to character preferences, PREFERENCE_CHARACTER
character_preview_view	A preview of the current character
chosen_augment_slot	Which augment slot we currently have chosen, this is for UI display
current_window	The current window, PREFERENCE_TAB_* in [`code/__DEFINES/preferences.dm`]
default_slot	Ensures that we always load the last used save, QOL
donator_status	Does this member have donator status on the server
favorite_outfits	What outfit typepaths we've favorited in the SelectEquipment menu
food_preferences	An assoc list of food types to liked or dislike values. If null or empty, default species tastes are used instead on application. If a food doesn't exist in this list, it uses the default value.
hearted	Someone thought we were nice! We get a little heart in OOC until we join the server past the below time (we can keep it until the end of the round otherwise)
hearted_until	If we have a hearted commendations, we honor it every time the player loads preferences until this time has been passed
key_bindings	Custom keybindings. Map of keybind names to keyboard inputs. For example, by default would have "swap_hands" -> list("X")
key_bindings_by_key	Cached list of keybindings, mapping keys to actions. For example, by default would have "X" -> list("swap_hands")
languages	Associative list, keyed by language typepath, pointing to LANGUAGE_UNDERSTOOD, or LANGUAGE_SPOKEN, for whether we understand or speak the language
last_id	Last CID that this client has connected from
last_ip	Last IP that this client has connected from
lastchangelog	Cached changelog size, to detect new changelogs since last join
load_and_save	Whether or not we allow saving/loading. Used for guests, if they're enabled
max_save_slots	The maximum number of slots we're allowed to contain
middleware	A list of instantiated middleware
mismatched_customization	Will the person see accessories not meant for their species to choose from
muted	Bitflags for communications that are muted
path	The path to the general savefile for this datum
preview_pref	Preference of how the preview should show the character.
recently_updated_keys	A list of keys that have been updated since the last save.
savefile	The json savefile for this datum
show_body_size	Whether the user wants to see body size being shown in the preview
tainted_character_profiles	If set to TRUE, will update character_profiles on the next ui_data tick.
value_cache	A cache of preference entries to values. Used to avoid expensive READ_FILE every time a preference is retrieved.
Procs
add_loadout_item	Helper for slotting in a new loadout item
apply_all_client_preferences	Applies all PREFERENCE_PLAYER preferences
apply_character_randomization_prefs	Randomizes the character according to preferences.
apply_prefs_to	Applies the given preferences to a human mob.
check_keybindings	checks through keybindings for outdated unbound keys and updates them
get_default_randomization	Returns the default `randomise` variable ouptut
get_highest_priority_job	Returns what job is marked as highest
get_key_bindings_by_key	Inverts the key_bindings list such that it can be used for key_bindings_by_key
get_save_data_for_savefile_identifier	Returns which savefile to use for a given savefile identifier
hardcore_random_setup	Setup the random hardcore quirks and give the character the new score prize.
load_character_nova	Loads the modular customizations of a character from the savefile
migrate_body_types	Previously, body types could only be used on non-binary characters. PR #62733 changed this to allow all characters to use body type. This migration moves binary-gendered characters over to the "use gender" body type so that old characters are preserved.
migrate_boolean_sound_prefs_to_default_volume
migrate_character_to_tgui_prefs_menu	Handle the migrations necessary from pre-tgui prefs to post-tgui prefs, for characters
migrate_felinid_feature_keys	Rename feature_human_tail and feature_human_ears to something not stupid
migrate_gendered_nonbinary_physique	Previously, physiques only supported binary characters, so "Use gender" on a non-binary character played havoc due to all checks being binary (some checked for females others for males) This caused inconsistencies when it was in play (male laughs and female screams) Force non-binary characters to have a female physique
migrate_legacy_sound_toggles	Previously, sound preferences were legacy toggles. PR #71040 changed these to modern toggles. This migration transfers the player's existing preferences into the new toggles
migrate_preferences_to_tgui_prefs_menu	Handle the migrations necessary from pre-tgui prefs to post-tgui prefs
migrate_quirk_to_loadout	Move quirk items into loadout items
migrate_quirk_to_personality	Replace a quirk with a personality
migrate_toolset_implants	Migration for loadout augments, replaces augments with /toolkit versions if the original doesn't exist
randomise_appearance_prefs	Fully randomizes everything in the character.
read_preference	Read a /datum/preference type and return its value. This will write to the savefile if a value was not found with the new value.
remove_loadout_item	Helper for removing a loadout item
safe_transfer_prefs_to_with_damage	This proc saves the damage currently on `character` (human) and reapplies it after `safe_transfer_prefs()` is applied to the `character`.
sanitize_languages	Cleans up any invalid languages. Typically happens on language renames and codedels.
sanitize_quirks	Cleans any quirks that should be hidden, or just simply don't exist from quirk code.
save_character_nova	Saves the modular customizations of a character on the savefile
savefile_needs_update_nova	Checks if the modular side of the savefile is up to date. If the return value is higher than 0, update_character_nova() will be called later.
select_hardcore_quirks	Goes through all quirks that can be used in hardcore mode and select some based on a random budget. Returns the new value to be gained with this setup, plus the previously earned score.
should_be_random_hardcore	Returns whether the parent mob should have the random hardcore settings enabled. Assumes it has a mind.
should_randomize	Returns if a preference should be randomized.
try_get_common_language	Tries to get the topmost language of the language holder. Should be the species' native language, and if it isn't, you should pester a coder.
update_character_nova	Brings a savefile up to date with modular preferences. Called if savefile_needs_update_nova() returned a value higher than 0
update_preference	Will perform an update on the preference, but not write to the savefile. This will, for instance, update the character preference view. Performs sanity checks.
update_tts_blip_prefs	Previously, tts enabled/blip were individual buttons PR #76558 changed them to one dropdown choice. This migration transfers the player's existing preferences into the new dropdown
write_preference	Set a /datum/preference entry. Returns TRUE for a successful preference application. Returns FALSE if it is invalid.

Var Details

var
allow_advanced_colors

Allows the user to freely color his body markings and mutant parts.

var
alt_job_titles
– /list

Alternative job titles stored in preferences. Assoc list, ie. alt_job_titles["Scientist"] = "Cytologist"

var
augment_limb_styles

List of chosen preferred styles for limb replacements

var
augments

List of chosen augmentations. It's an associative list with key name of the slot, pointing to a typepath of an augment define

var
be_special
– /list

List of ROLE_X that the client wants to be eligible for

var
body_markings
– /list/list

A list of all bodymarkings

var
character_data
– /list

The savefile relating to character preferences, PREFERENCE_CHARACTER

var
character_preview_view
– /atom/movable/screen/map_view/char_preview

A preview of the current character

var
chosen_augment_slot

Which augment slot we currently have chosen, this is for UI display

var
current_window

The current window, PREFERENCE_TAB_* in [code/__DEFINES/preferences.dm]

var
default_slot

Ensures that we always load the last used save, QOL

var
donator_status

Does this member have donator status on the server

var
favorite_outfits
– /list

What outfit typepaths we've favorited in the SelectEquipment menu

var
food_preferences
– /list

An assoc list of food types to liked or dislike values. If null or empty, default species tastes are used instead on application. If a food doesn't exist in this list, it uses the default value.

var
hearted

Someone thought we were nice! We get a little heart in OOC until we join the server past the below time (we can keep it until the end of the round otherwise)

var
hearted_until

If we have a hearted commendations, we honor it every time the player loads preferences until this time has been passed

var
key_bindings
– /list

Custom keybindings. Map of keybind names to keyboard inputs. For example, by default would have "swap_hands" -> list("X")

var
key_bindings_by_key
– /list

Cached list of keybindings, mapping keys to actions. For example, by default would have "X" -> list("swap_hands")

var
languages
– /list

Associative list, keyed by language typepath, pointing to LANGUAGE_UNDERSTOOD, or LANGUAGE_SPOKEN, for whether we understand or speak the language

var
last_id

Last CID that this client has connected from

var
last_ip

Last IP that this client has connected from

var
lastchangelog

Cached changelog size, to detect new changelogs since last join

var
load_and_save

Whether or not we allow saving/loading. Used for guests, if they're enabled

var
max_save_slots

The maximum number of slots we're allowed to contain

var
middleware
– /list/datum/preference_middleware

A list of instantiated middleware

var
mismatched_customization

Will the person see accessories not meant for their species to choose from

var
muted

Bitflags for communications that are muted

var
path

The path to the general savefile for this datum

var
preview_pref

Preference of how the preview should show the character.

var
recently_updated_keys
– /list

A list of keys that have been updated since the last save.

var
savefile
– /datum/json_savefile

The json savefile for this datum

var
show_body_size

Whether the user wants to see body size being shown in the preview

var
tainted_character_profiles

If set to TRUE, will update character_profiles on the next ui_data tick.

var
value_cache

A cache of preference entries to values. Used to avoid expensive READ_FILE every time a preference is retrieved.

Proc Details

proc
add_loadout_item
(typepath, /list/data)

Helper for slotting in a new loadout item

proc
apply_all_client_preferences
()

Applies all PREFERENCE_PLAYER preferences

proc
apply_character_randomization_prefs
(antag_override)

Randomizes the character according to preferences.

proc
apply_prefs_to
(/mob/living/carbon/human/character, icon_updates, /list/do_not_apply, visuals_only)

Applies the given preferences to a human mob.

Arguments:

character - The human mob to apply the preferences to
icon_updates - Whether to update the mob's icons after applying preferences. Is often skipped to save processing when an update will happen later anyway.
do_not_apply - A list of preference types to skip when applying preferences.

proc
check_keybindings
()

checks through keybindings for outdated unbound keys and updates them

proc
get_default_randomization
()

Returns the default randomise variable ouptut

proc
get_highest_priority_job
()

Returns what job is marked as highest

proc
get_key_bindings_by_key
(/list/key_bindings)

Inverts the key_bindings list such that it can be used for key_bindings_by_key

proc
get_save_data_for_savefile_identifier
(savefile_identifier) as /list

Returns which savefile to use for a given savefile identifier

proc
hardcore_random_setup
(/mob/living/carbon/human/character)

Setup the random hardcore quirks and give the character the new score prize.

proc
load_character_nova
(/list/save_data)

Loads the modular customizations of a character from the savefile

proc
migrate_body_types
(/list/save_data)

Previously, body types could only be used on non-binary characters. PR #62733 changed this to allow all characters to use body type. This migration moves binary-gendered characters over to the "use gender" body type so that old characters are preserved.

proc
migrate_boolean_sound_prefs_to_default_volume
()

Pull request: #86932 Sound mixer part 1
Multiplies boolean sound prefs by 100
Changed ambience tick pref to numeric slider
Changed ship ambience tick pref to numeric slider
Changed lobby music tick pref to numeric slider
Changed Radio noise tick pref to numeric slider

proc
migrate_character_to_tgui_prefs_menu
()

Handle the migrations necessary from pre-tgui prefs to post-tgui prefs, for characters

proc
migrate_felinid_feature_keys
(/list/save_data)

Rename feature_human_tail and feature_human_ears to something not stupid

proc
migrate_gendered_nonbinary_physique
(/list/save_data)

Previously, physiques only supported binary characters, so "Use gender" on a non-binary character played havoc due to all checks being binary (some checked for females others for males) This caused inconsistencies when it was in play (male laughs and female screams) Force non-binary characters to have a female physique

proc
migrate_legacy_sound_toggles
(/savefile/savefile)

Previously, sound preferences were legacy toggles. PR #71040 changed these to modern toggles. This migration transfers the player's existing preferences into the new toggles

proc
migrate_preferences_to_tgui_prefs_menu
()

Handle the migrations necessary from pre-tgui prefs to post-tgui prefs

proc
migrate_quirk_to_loadout
(quirk_to_migrate, new_typepath, /list/data_to_migrate)

Move quirk items into loadout items

If this is accompanied with removal of a quirk, you don't need to worry about handling that here - quirk sanitization happens AFTER migration

proc
migrate_quirk_to_personality
(quirk_to_migrate, /datum/personality/new_typepath)

Replace a quirk with a personality

If this is accompanied with removal of a quirk, you don't need to worry about handling that here - quirk sanitization happens AFTER migration

proc
migrate_toolset_implants
(/list/save_data)

Migration for loadout augments, replaces augments with /toolkit versions if the original doesn't exist

proc
randomise_appearance_prefs
(randomize_flags)

Fully randomizes everything in the character.

proc
read_preference
(preference_type)

Read a /datum/preference type and return its value. This will write to the savefile if a value was not found with the new value.

proc
remove_loadout_item
(typepath)

Helper for removing a loadout item

proc
safe_transfer_prefs_to_with_damage
(/mob/living/carbon/human/character, icon_updates, is_antag)

This proc saves the damage currently on character (human) and reapplies it after safe_transfer_prefs() is applied to the character.

proc
sanitize_languages
()

Cleans up any invalid languages. Typically happens on language renames and codedels.

proc
sanitize_quirks
()

Cleans any quirks that should be hidden, or just simply don't exist from quirk code.

proc
save_character_nova
(/list/save_data)

Saves the modular customizations of a character on the savefile

proc
savefile_needs_update_nova
(/list/save_data)

Checks if the modular side of the savefile is up to date. If the return value is higher than 0, update_character_nova() will be called later.

proc
select_hardcore_quirks
(species)

Goes through all quirks that can be used in hardcore mode and select some based on a random budget. Returns the new value to be gained with this setup, plus the previously earned score.

proc
should_be_random_hardcore
(/datum/job/job, /datum/mind/mind)

Returns whether the parent mob should have the random hardcore settings enabled. Assumes it has a mind.

proc
should_randomize
(/datum/preference/preference, is_antag)

Returns if a preference should be randomized.

proc
try_get_common_language
()

Tries to get the topmost language of the language holder. Should be the species' native language, and if it isn't, you should pester a coder.

proc
update_character_nova
(current_version, /list/save_data)

Brings a savefile up to date with modular preferences. Called if savefile_needs_update_nova() returned a value higher than 0

proc
update_preference
(/datum/preference/preference, preference_value)

Will perform an update on the preference, but not write to the savefile. This will, for instance, update the character preference view. Performs sanity checks.

proc
update_tts_blip_prefs
()

Previously, tts enabled/blip were individual buttons PR #76558 changed them to one dropdown choice. This migration transfers the player's existing preferences into the new dropdown

proc
write_preference
(/datum/preference/preference, preference_value)

Set a /datum/preference entry. Returns TRUE for a successful preference application. Returns FALSE if it is invalid.

preferences /datum/preferences

Vars

Procs

Var Details

var allow_advanced_colors

var alt_job_titles – /list

var augment_limb_styles

var augments

var be_special – /list

var body_markings – /list/list

var character_data – /list

var character_preview_view – /atom/movable/screen/map_view/char_preview

var chosen_augment_slot

var current_window

var default_slot

var donator_status

var favorite_outfits – /list

var food_preferences – /list

var hearted

var hearted_until

var key_bindings – /list

var key_bindings_by_key – /list

var languages – /list

var last_id

var last_ip

var lastchangelog

var load_and_save

var max_save_slots

var middleware – /list/datum/preference_middleware

var mismatched_customization

var muted

var path

var preview_pref

var recently_updated_keys – /list

var savefile – /datum/json_savefile

var show_body_size

var tainted_character_profiles

var value_cache

Proc Details

proc add_loadout_item(typepath, /list/data)

proc apply_all_client_preferences()

proc apply_character_randomization_prefs(antag_override)

proc apply_prefs_to(/mob/living/carbon/human/character, icon_updates, /list/do_not_apply, visuals_only)

proc check_keybindings()

proc get_default_randomization()

proc get_highest_priority_job()

proc get_key_bindings_by_key(/list/key_bindings)

proc get_save_data_for_savefile_identifier(savefile_identifier) as /list

proc hardcore_random_setup(/mob/living/carbon/human/character)

proc load_character_nova(/list/save_data)

proc migrate_body_types(/list/save_data)

proc migrate_boolean_sound_prefs_to_default_volume()

proc migrate_character_to_tgui_prefs_menu()

proc migrate_felinid_feature_keys(/list/save_data)

proc migrate_gendered_nonbinary_physique(/list/save_data)

proc migrate_legacy_sound_toggles(/savefile/savefile)

proc migrate_preferences_to_tgui_prefs_menu()

proc migrate_quirk_to_loadout(quirk_to_migrate, new_typepath, /list/data_to_migrate)

proc migrate_quirk_to_personality(quirk_to_migrate, /datum/personality/new_typepath)

proc migrate_toolset_implants(/list/save_data)

proc randomise_appearance_prefs(randomize_flags)

proc read_preference(preference_type)

proc remove_loadout_item(typepath)

proc safe_transfer_prefs_to_with_damage(/mob/living/carbon/human/character, icon_updates, is_antag)

proc sanitize_languages()

proc sanitize_quirks()

proc save_character_nova(/list/save_data)

proc savefile_needs_update_nova(/list/save_data)

proc select_hardcore_quirks(species)

proc should_be_random_hardcore(/datum/job/job, /datum/mind/mind)

proc should_randomize(/datum/preference/preference, is_antag)

proc try_get_common_language()

proc update_character_nova(current_version, /list/save_data)

proc update_preference(/datum/preference/preference, preference_value)

proc update_tts_blip_prefs()

proc write_preference(/datum/preference/preference, preference_value)