/datum/preferences

Vars
background	Icon for the preview background
character_preview_view	A preview of the current character
character_savefile	The savefile relating to character preferences, PREFERENCE_CHARACTER
current_window	The current window, PREFERENCE_TAB_* in [`code/__DEFINES/preferences.dm`]
game_savefile	The savefile relating to core preferences, PREFERENCE_PLAYER
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")
middleware	A list of instantiated middleware
recently_updated_keys	A list of keys that have been updated since the last save.
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.
yogtoggles	removed, kept here for migration in 'legacy_mood_migration.dm' DO NOT USE THIS!
Procs
apply_all_client_preferences	Applies all PREFERENCE_PLAYER preferences
apply_character_randomization_prefs	Randomizes the character according to preferences.
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_savefile_for_savefile_identifier	Returns which savefile to use for a given savefile identifier
migrate_character_to_tgui_prefs_menu	Handle the migrations necessary from pre-tgui prefs to post-tgui prefs, for characters
migrate_preferences_to_tgui_prefs_menu	Handle the migrations necessary from pre-tgui prefs to post-tgui prefs
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.
should_randomize	Returns if a preference should be randomized.
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.
write_preference	Set a /datum/preference entry. Returns TRUE for a successful preference application. Returns FALSE if it is invalid.

Var Details

var
background
– /icon

Icon for the preview background

var
character_preview_view
– /atom/movable/screen/character_preview_view

A preview of the current character

var
character_savefile
– /savefile

The savefile relating to character preferences, PREFERENCE_CHARACTER

var
current_window
–

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

var
game_savefile
– /savefile

The savefile relating to core preferences, PREFERENCE_PLAYER

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
middleware
– /list/datum/preference_middleware

A list of instantiated middleware

var
recently_updated_keys
– /list

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

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.

var
yogtoggles
–

removed, kept here for migration in 'legacy_mood_migration.dm' DO NOT USE THIS!

Proc Details

proc
apply_all_client_preferences
()

Applies all PREFERENCE_PLAYER preferences

proc
apply_character_randomization_prefs
(antag_override)

Randomizes the character according to 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_savefile_for_savefile_identifier
(savefile_identifier)

Returns which savefile to use for a given savefile identifier

proc
migrate_character_to_tgui_prefs_menu
()

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

proc
migrate_preferences_to_tgui_prefs_menu
()

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

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
should_randomize
(/datum/preference/preference, is_antag)

Returns if a preference should be randomized.

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
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.

/datum/preferences

Vars

Procs

Var Details

var background – /icon

var character_preview_view – /atom/movable/screen/character_preview_view

var character_savefile – /savefile

var current_window –

var game_savefile – /savefile

var key_bindings – /list

var key_bindings_by_key – /list

var middleware – /list/datum/preference_middleware

var recently_updated_keys – /list

var tainted_character_profiles –

var value_cache –

var yogtoggles –

Proc Details

proc apply_all_client_preferences()

proc apply_character_randomization_prefs(antag_override)

proc check_keybindings()

proc get_default_randomization()

proc get_highest_priority_job()

proc get_key_bindings_by_key(/list/key_bindings)

proc get_savefile_for_savefile_identifier(savefile_identifier)

proc migrate_character_to_tgui_prefs_menu()

proc migrate_preferences_to_tgui_prefs_menu()

proc randomise_appearance_prefs(randomize_flags)

proc read_preference(preference_type)

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

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

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