refactor: JSON → INI config via Godot ConfigFile

This commit is contained in:
Eric Smith 2026-05-20 22:32:17 -04:00
parent c6bc1edda4
commit a6d4c290d3
4 changed files with 64 additions and 43 deletions

2
.gitignore vendored
View file

@ -16,7 +16,7 @@ godot_temp_*
*~ *~
# Config — user overrides, not committed # Config — user overrides, not committed
config/config.json config/config.cfg
# OS # OS
.DS_Store .DS_Store

View file

@ -10,10 +10,12 @@ func _ready() -> void:
_load_config() _load_config()
## Read a flat setting by key (e.g. "background_color", "show_cpu").
func get_setting(key: String, default_value: Variant = null) -> Variant: func get_setting(key: String, default_value: Variant = null) -> Variant:
return _settings.get(key, default_value) return _settings.get(key, default_value)
## Persist a setting and emit the change signal.
func set_setting(key: String, value: Variant) -> void: func set_setting(key: String, value: Variant) -> void:
if _settings.has(key) and _settings[key] != value: if _settings.has(key) and _settings[key] != value:
_settings[key] = value _settings[key] = value
@ -21,7 +23,7 @@ func set_setting(key: String, value: Variant) -> void:
config_changed.emit(key, value) config_changed.emit(key, value)
## Parse a "r, g, b" string from config into a Color with alpha 1.0. ## Parse a "r, g, b" string setting into a Color (alpha = 1.0).
func get_color(key: String, default_color: Color = Color.WHITE) -> Color: func get_color(key: String, default_color: Color = Color.WHITE) -> Color:
var raw: Variant = _settings.get(key) var raw: Variant = _settings.get(key)
if raw == null or typeof(raw) != TYPE_STRING: if raw == null or typeof(raw) != TYPE_STRING:
@ -35,45 +37,59 @@ func get_color(key: String, default_color: Color = Color.WHITE) -> Color:
return Color(r, g, b, 1.0) return Color(r, g, b, 1.0)
# --------------------------------------------------------------------------
# INI loading via Godot's ConfigFile
# Keys are flattened as "{section}_{key}" for simple lookup.
# User config.cfg overrides default.cfg on a per-key basis.
# --------------------------------------------------------------------------
func _load_config() -> void: func _load_config() -> void:
# Load defaults, then overlay user config.
var defaults := _read_json_file("res://config/default.json")
var user := _read_json_file("res://config/config.json")
_settings.clear() _settings.clear()
if defaults != null and defaults is Dictionary: _load_cfg("res://config/default.cfg")
_merge_dict(_settings, defaults as Dictionary) _load_cfg("res://config/config.cfg") # silently ignored if absent
if user != null and user is Dictionary:
_merge_dict(_settings, user as Dictionary)
static func _read_json_file(path: String) -> Variant: func _load_cfg(path: String) -> void:
var file := FileAccess.open(path, FileAccess.READ) var cfg := ConfigFile.new()
if file == null: if cfg.load(path) != OK:
return null return
var content: String = file.get_as_text() for section in cfg.get_sections():
var parsed: Variant = JSON.parse_string(content) for key in cfg.get_section_keys(section):
return parsed _settings[section + "_" + key] = cfg.get_value(section, key)
static func _merge_dict(dst: Dictionary, src: Dictionary) -> void:
for key in src:
dst[key] = src[key]
func _save_user_config() -> void: func _save_user_config() -> void:
# Only persists settings that differ from defaults. # Load defaults to compare against.
var defaults := _read_json_file("res://config/default.json") var defaults := ConfigFile.new()
if not (defaults is Dictionary): if defaults.load("res://config/default.cfg") != OK:
return return
var diff: Dictionary = {} # Collect default keys for reference.
for key in _settings: var default_keys: Dictionary = {}
if not defaults.has(key) or defaults[key] != _settings[key]: for section in defaults.get_sections():
diff[key] = _settings[key] for key in defaults.get_section_keys(section):
default_keys[section + "_" + key] = { "section": section, "key": key }
var path: String = "res://config/config.json" var user_cfg := ConfigFile.new()
var json_str: String = JSON.stringify(diff, "\t") var has_diff: bool = false
var file := FileAccess.open(path, FileAccess.WRITE)
if file != null: for flat_key in _settings:
file.store_string(json_str) var entry: Variant = default_keys.get(flat_key)
var section: String
var cfg_key: String
if entry != null:
section = entry.section
cfg_key = entry.key
else:
# Not in defaults — derive section from flat key (before first "_").
var parts: PackedStringArray = flat_key.split("_", true, 1)
section = parts[0] if parts.size() > 1 else "general"
cfg_key = parts[-1]
var default_val: Variant = defaults.get_value(section, cfg_key, null)
if _settings[flat_key] != default_val:
user_cfg.set_value(section, cfg_key, _settings[flat_key])
has_diff = true
if has_diff:
user_cfg.save("res://config/config.cfg")

14
config/default.cfg Normal file
View file

@ -0,0 +1,14 @@
[background]
color=0.08, 0.08, 0.12
[modules]
show_cpu=true
show_memory=true
show_network=true
show_disk=true
[performance]
refresh_interval=1.0
[general]
theme=default

View file

@ -1,9 +0,0 @@
{
"background_color": "0.08, 0.08, 0.12",
"refresh_interval": 1.0,
"show_cpu": true,
"show_memory": true,
"show_network": true,
"show_disk": true,
"theme": "default"
}