#define VALUE_MODE_NUM 0 #define VALUE_MODE_TEXT 1 #define VALUE_MODE_FLAG 2 #define VALUE_MODE_NUM_LIST 3 #define KEY_MODE_TEXT 0 #define KEY_MODE_TYPE 1 /datum/config_entry /// Read-only, this is determined by the last portion of the derived entry type var/name /// The configured value for this entry. This shouldn't be initialized in code, instead set default var/config_entry_value /// Read-only default value for this config entry, used for resetting value to defaults when necessary. This is what config_entry_value is initially set to var/default /// The file which this was loaded from, if any var/resident_file /// Set to TRUE if the default has been overridden by a config entry var/modified = FALSE /// The config name of a configuration type that depricates this, if it exists var/deprecated_by /// The /datum/config_entry type that supercedes this one var/protection = NONE /// Do not instantiate if type matches this var/abstract_type = /datum/config_entry /// Force validate and set on VV. VAS proccall guard will run regardless. var/vv_VAS = TRUE /// Requires running OnPostload() var/postload_required = FALSE /// Controls if error is thrown when duplicate configuration values for this entry type are encountered var/dupes_allowed = FALSE /// Stores the original protection configuration, used for set_default() var/default_protection /datum/config_entry/New() if(type == abstract_type) CRASH("Abstract config entry [type] instatiated!") name = lowertext(type2top(type)) default_protection = protection set_default() /datum/config_entry/Destroy() config.RemoveEntry(src) return ..() /** * Returns the value of the configuration datum to its default, used for resetting a config value. Note this also sets the protection back to default. */ /datum/config_entry/proc/set_default() if ((protection & CONFIG_ENTRY_LOCKED) && IsAdminAdvancedProcCall()) log_admin_private("[key_name(usr)] attempted to reset locked config entry [type] to its default") return if (islist(default)) var/list/L = default config_entry_value = L.Copy() else config_entry_value = default protection = default_protection resident_file = null modified = FALSE /datum/config_entry/can_vv_get(var_name) . = ..() if(var_name == NAMEOF(src, config_entry_value) || var_name == NAMEOF(src, default)) . &= !(protection & CONFIG_ENTRY_HIDDEN) /datum/config_entry/vv_edit_var(var_name, var_value) var/static/list/banned_edits = list(NAMEOF(src, name), NAMEOF(src, vv_VAS), NAMEOF(src, default), NAMEOF(src, resident_file), NAMEOF(src, protection), NAMEOF(src, abstract_type), NAMEOF(src, modified), NAMEOF(src, dupes_allowed)) if(var_name == NAMEOF(src, config_entry_value)) if(protection & CONFIG_ENTRY_LOCKED) return FALSE if(vv_VAS) . = ValidateAndSet("[var_value]") if(.) datum_flags |= DF_VAR_EDITED return else return ..() if(var_name in banned_edits) return FALSE return ..() /datum/config_entry/proc/VASProcCallGuard(str_val) . = !((protection & CONFIG_ENTRY_LOCKED) && IsAdminAdvancedProcCall() && GLOB.LastAdminCalledProc == "ValidateAndSet" && GLOB.LastAdminCalledTargetRef == "[REF(src)]") if(!.) log_admin_private("Config set of [type] to [str_val] attempted by [key_name(usr)]") /datum/config_entry/proc/ValidateAndSet(str_val) VASProcCallGuard(str_val) CRASH("Invalid config entry type!") /datum/config_entry/proc/ValidateListEntry(key_name, key_value) return TRUE /datum/config_entry/proc/DeprecationUpdate(value) return /datum/config_entry/proc/OnPostload() return /datum/config_entry/string default = "" abstract_type = /datum/config_entry/string var/auto_trim = TRUE /datum/config_entry/string/vv_edit_var(var_name, var_value) return var_name != NAMEOF(src, auto_trim) && ..() /datum/config_entry/string/ValidateAndSet(str_val, during_load) if(!VASProcCallGuard(str_val)) return FALSE config_entry_value = auto_trim ? trim(str_val) : str_val return TRUE /datum/config_entry/number default = 0 abstract_type = /datum/config_entry/number var/integer = TRUE var/max_val = INFINITY var/min_val = -INFINITY /datum/config_entry/number/ValidateAndSet(str_val) if(!VASProcCallGuard(str_val)) return FALSE var/temp = text2num(trim(str_val)) if(!isnull(temp)) config_entry_value = clamp(integer ? round(temp) : temp, min_val, max_val) if(config_entry_value != temp && !(datum_flags & DF_VAR_EDITED)) log_config("Changing [name] from [temp] to [config_entry_value]!") return TRUE return FALSE /datum/config_entry/number/vv_edit_var(var_name, var_value) var/static/list/banned_edits = list(NAMEOF(src, max_val), NAMEOF(src, min_val), NAMEOF(src, integer)) return !(var_name in banned_edits) && ..() /datum/config_entry/flag default = FALSE abstract_type = /datum/config_entry/flag /datum/config_entry/flag/ValidateAndSet(str_val) if(!VASProcCallGuard(str_val)) return FALSE config_entry_value = text2num(trim(str_val)) != 0 return TRUE /// List config entry, used for configuring a list of strings /datum/config_entry/str_list abstract_type = /datum/config_entry/str_list default = list() dupes_allowed = TRUE /// whether the string elements will be lowercased on ValidateAndSet or not. var/lowercase = FALSE /datum/config_entry/str_list/ValidateAndSet(str_val) if (!VASProcCallGuard(str_val)) return FALSE str_val = trim(str_val) if (str_val != "") config_entry_value += lowercase ? lowertext(str_val) : str_val return TRUE /datum/config_entry/number_list abstract_type = /datum/config_entry/number_list default = list() /datum/config_entry/number_list/ValidateAndSet(str_val) if(!VASProcCallGuard(str_val)) return FALSE str_val = trim(str_val) var/list/new_list = list() var/list/values = splittext(str_val," ") for(var/I in values) var/temp = text2num(I) if(isnull(temp)) return FALSE new_list += temp if(!new_list.len) return FALSE config_entry_value = new_list return TRUE /datum/config_entry/keyed_list abstract_type = /datum/config_entry/keyed_list default = list() dupes_allowed = TRUE vv_VAS = FALSE //VAS will not allow things like deleting from lists, it'll just bug horribly. var/key_mode var/value_mode var/splitter = " " var/lowercase = TRUE /datum/config_entry/keyed_list/New() . = ..() if(isnull(key_mode) || isnull(value_mode)) CRASH("Keyed list of type [type] created with null key or value mode!") /datum/config_entry/keyed_list/ValidateAndSet(str_val) if(!VASProcCallGuard(str_val)) return FALSE str_val = trim(str_val) var/key_pos = findtext(str_val, splitter) var/key_name = null var/key_value = null if(key_pos || value_mode == VALUE_MODE_FLAG) key_name = copytext(str_val, 1, key_pos) if(lowercase) key_name = lowertext(key_name) if(key_pos) key_value = copytext(str_val, key_pos + length(str_val[key_pos])) var/new_key var/new_value var/continue_check_value var/continue_check_key switch(key_mode) if(KEY_MODE_TEXT) new_key = key_name continue_check_key = new_key if(KEY_MODE_TYPE) new_key = key_name if(!ispath(new_key)) new_key = text2path(new_key) continue_check_key = ispath(new_key) switch(value_mode) if(VALUE_MODE_FLAG) new_value = TRUE continue_check_value = TRUE if(VALUE_MODE_NUM) new_value = text2num(key_value) continue_check_value = !isnull(new_value) if(VALUE_MODE_TEXT) new_value = key_value continue_check_value = new_value if(VALUE_MODE_NUM_LIST) // this is all copy+pasted from number list up there, but it's super basic so I don't see it being changed soon var/list/new_list = list() var/list/values = splittext(key_value," ") for(var/I in values) var/temp = text2num(I) if(isnull(temp)) log_admin("invalid number list entry in [key_name]: [I]") continue_check_value = FALSE new_list += temp new_value = new_list continue_check_value = new_list.len if(continue_check_value && continue_check_key && ValidateListEntry(new_key, new_value)) new_key = preprocess_key(new_key) new_value = preprocess_value(new_value) config_entry_value[new_key] = new_value return TRUE return FALSE /datum/config_entry/keyed_list/vv_edit_var(var_name, var_value) return var_name != NAMEOF(src, splitter) && ..() /datum/config_entry/keyed_list/proc/preprocess_key(key) return key /datum/config_entry/keyed_list/proc/preprocess_value(value) return value //snowflake for donator things being on one line smh /datum/config_entry/multi_keyed_flag vv_VAS = FALSE abstract_type = /datum/config_entry/multi_keyed_flag default = list() var/delimiter = "|" /datum/config_entry/multi_keyed_flag/vv_edit_var(var_name, var_value) if(var_name == NAMEOF(src, delimiter)) return FALSE return ..() /datum/config_entry/multi_keyed_flag/ValidateAndSet(str_val) if(!VASProcCallGuard(str_val)) return FALSE str_val = trim(str_val) var/list/keys = splittext(str_val, delimiter) for(var/i in keys) config_entry_value[process_key(i)] = TRUE return length(keys)? TRUE : FALSE /datum/config_entry/multi_keyed_flag/proc/process_key(key) return trim(key)