rpfm_server/

settings.rs

//---------------------------------------------------------------------------//
// Copyright (c) 2017-2026 Ismael Gutiérrez González. All rights reserved.
//
// This file is part of the Rusted PackFile Manager (RPFM) project,
// which can be found here: https://github.com/Frodo45127/rpfm.
//
// This file is licensed under the MIT license, which can be found here:
// https://github.com/Frodo45127/rpfm/blob/master/LICENSE.
//---------------------------------------------------------------------------//

//! Persistent settings store and config-path helpers.
//!
//! Settings are kept in a single JSON file under the OS-specific config
//! directory (resolved through [`directories::ProjectDirs`]) and exposed as a
//! per-type [`Settings`] map: `bool`, `i32`, `f32`, `String`, raw bytes,
//! and `Vec<String>`. Both the UI and the server side use the same
//! [`rpfm_ipc::settings_keys`] constants when reading and writing, so a typo
//! becomes a compile error rather than a silently-missed setting.

use anyhow::{anyhow, Result};
use directories::ProjectDirs;
use ron::ser::{PrettyConfig, to_string_pretty};
use serde_derive::{Serialize, Deserialize};

use tokio::sync::broadcast;

use std::collections::HashMap;
use std::io::{BufReader, BufWriter, Read, Write};
use std::fs::{DirBuilder, File};
use std::path::{Path, PathBuf};
use std::sync::{LazyLock, RwLock};

use rpfm_extensions::optimizer::OptimizerOptions;
use rpfm_extensions::translator::DEFAULT_SRC_LANG;

use rpfm_ipc::settings_keys::*;

use rpfm_lib::error::RLibError;
use rpfm_lib::games::{GameInfo, LUA_AUTOGEN_FOLDER, supported_games::*};
use rpfm_lib::schema::{DefinitionPatch, SCHEMA_FOLDER};

use crate::*;

const SETTINGS_FILE_NAME: &str = "settings.json";

/// File for storing the path to the user-chosen custom config folder.
const CONFIG_REDIRECT_FILE_NAME: &str = "config_folder.txt";

const DEPENDENCIES_FOLDER: &str = "dependencies";

/// Folder under [`config_path`] where the user drops plugin scripts (`.py`/`.lua`).
const SCRIPTS_FOLDER: &str = "scripts";

const TABLE_PATCHES_FOLDER: &str = "table_patches";
const TABLE_PROFILES_FOLDER: &str = "table_profiles";
const TRANSLATIONS_LOCAL_FOLDER: &str = "translations_local";
const TRANSLATIONS_REMOTE_FOLDER: &str = "translations_remote";

//-------------------------------------------------------------------------------//
//                                  Macros
//-------------------------------------------------------------------------------//

/// Macro to set a batch of settings in one go in an efficient way.
///
/// It expects a list of the following:
///
/// - $rtype: The setting's setter (set_bool, set_i32, etc.)
/// - $id: The ID of the setting as a string literal.
/// - $source: The expression to get the value.
///
/// You can add more settings by adding another 3 arguments to the macro.
#[macro_export]
macro_rules! set_batch {
    ($( $rtype:ident, $id:literal, $source:expr), *) => {
        {
            let mut set = SETTINGS.write().unwrap();
            set.set_block_write(true);
            $(
                let _ = set.$rtype($id, $source);
            )*
            set.set_block_write(false);
            let _ = set.write();
        }
    };
}

//-------------------------------------------------------------------------------//
//                              Enums & Structs
//-------------------------------------------------------------------------------//

/// Snapshot of every persisted setting.
///
/// Each typed sub-map keeps its own keys; lookups never cross types, so
/// `settings.bool("X")` and `settings.i32("X")` are independent. Lookups for
/// a missing key return the type's default (`false`, `0`, `""`, …).
///
/// Values mutate through the typed `set_*` / `initialize_*` methods. Each
/// successful set persists to disk immediately, unless [`set_block_write`]
/// is set to `true` (used for batch updates via the [`set_batch!`] macro).
///
/// [`set_block_write`]: Self::set_block_write
#[derive(Clone, Debug, Default, Serialize, Deserialize)]
pub struct Settings {

    /// When `true`, [`Self::write`] becomes a no-op. Used by [`set_batch!`]
    /// to coalesce many updates into a single disk write.
    #[serde(skip_serializing, skip_deserializing)]
    pub block_write: bool,

    /// Boolean settings.
    pub bool: HashMap<String, bool>,
    /// Signed 32-bit integer settings.
    pub i32: HashMap<String, i32>,
    /// 32-bit floating-point settings.
    pub f32: HashMap<String, f32>,
    /// String settings (also used for path-shaped strings; see
    /// [`Self::path_buf`] for `PathBuf` access on top of the same map).
    pub string: HashMap<String, String>,
    /// Opaque byte-blob settings.
    pub raw_data: HashMap<String, Vec<u8>>,
    /// Lists-of-strings settings.
    pub vec_string: HashMap<String, Vec<String>>
}

//-------------------------------------------------------------------------------//
//                              Shared state
//-------------------------------------------------------------------------------//

/// The single [`Settings`] instance for this server process.
///
/// One server process serves every locally-running `rpfm_ui` instance, each
/// getting its own [`crate::session::Session`]. All sessions read and write
/// through this one lock, so every session in the process sees the same
/// values.
pub static SETTINGS: LazyLock<RwLock<Settings>> = LazyLock::new(|| {
    RwLock::new(Settings::init(false).unwrap_or_else(|error| {
        rpfm_telemetry::warn!("Failed to initialize settings, falling back to defaults. Error: {error}");
        Settings::default()
    }))
});

/// Broadcasts the [`SettingsSnapshot`] resulting from every successful write to
/// [`SETTINGS`], so every connected session can push it to its own client and
/// keep their settings caches in sync without requiring a reconnect.
pub static SETTINGS_CHANGED: LazyLock<broadcast::Sender<SettingsSnapshot>> = LazyLock::new(|| broadcast::channel(16).0);

/// Applies a mutation to the shared [`SETTINGS`] store and broadcasts the
/// resulting snapshot on [`SETTINGS_CHANGED`] if it succeeds.
pub fn mutate_settings<T>(mutator: impl FnOnce(&mut Settings) -> Result<T>) -> Result<T> {
    let mut settings = SETTINGS.write().unwrap();
    let result = mutator(&mut settings)?;
    let _ = SETTINGS_CHANGED.send(settings.snapshot());
    Ok(result)
}

//-------------------------------------------------------------------------------//
//                         Settings implementation
//-------------------------------------------------------------------------------//

impl Settings {

    /// Build a fresh `Settings` instance, loading from disk and applying
    /// per-key default initialisation.
    ///
    /// If `as_new` is `true` the on-disk file is ignored and a fully default
    /// settings struct is returned (still applying the per-key defaults).
    /// Otherwise the settings are loaded with [`Self::load_or_recover`].
    pub fn init(as_new: bool) -> Result<Self> {
        let mut settings = if !as_new {
            match config_path() {
                Ok(config) => Self::load_or_recover(&config.join(SETTINGS_FILE_NAME)),
                Err(error) => {
                    rpfm_telemetry::warn!("Failed to find the settings folder, using defaults. Error: {error}");
                    Settings::default()
                }
            }
        } else {
            Settings::default()
        };

        settings.set_block_write(true);

        settings.initialize_string(MYMOD_BASE_PATH, "");
        settings.initialize_string(SECONDARY_PATH, "");

        let supported_games = SupportedGames::default();
        for game in &supported_games.games() {
            let game_key = game.key();

            // Fix unsanitized paths.
            let current_path = settings.string(game_key);
            if current_path.is_empty() {
                if current_path.contains("\\") {
                    let _ = settings.set_string(game_key, &current_path.replace("\\", "/"));
                }

                let game_path = if let Ok(Some(game_path)) = game.find_game_install_location() {
                    game_path.to_string_lossy().replace("\\", "/")
                } else {
                    String::new()
                };

                // If we got a path and we don't have it saved yet, save it automatically.
                if !game_path.is_empty() {
                    let _ = settings.set_string(game_key, &game_path);
                } else {
                    settings.initialize_string(game_key, &game_path);
                }
            }

            if game_key != KEY_EMPIRE &&
                game_key != KEY_NAPOLEON &&
                game_key != KEY_ARENA {

                // If we got a path and we don't have it saved yet, save it automatically.
                let ak_key = game_key.to_owned() + ASSEMBLY_KIT_SUFFIX;
                let current_path = settings.string(&ak_key);

                if current_path.is_empty() {
                    let ak_path = if let Ok(Some(ak_path)) = game.find_assembly_kit_install_location() {
                        ak_path.join("assembly_kit").to_string_lossy().replace("\\", "/")
                    } else {
                        String::new()
                    };

                    // Fix unsanitized paths.
                    if current_path.contains("\\") {
                        let _ = settings.set_string(&ak_key, &current_path.replace("\\", "/"));
                    }

                    // Ignore shogun 2, as that one is a zip.
                    if !ak_path.is_empty() && game_key != KEY_SHOGUN_2 {
                        let _ = settings.set_string(&ak_key, &ak_path);
                    } else {
                        settings.initialize_string(&ak_key, &ak_path);
                    }
                }
            }
        }

        // Hidden setting.
        settings.initialize_bool(IMPORT_FROM_QT, false);

        // General Settings.
        settings.initialize_string(DEFAULT_GAME, KEY_WARHAMMER_3);
        settings.initialize_string(LANGUAGE, "English_en");
        settings.initialize_string(THEME, THEME_OS);
        //settings.initialize_string(UPDATE_CHANNEL, STABLE);
        settings.initialize_i32(AUTOSAVE_AMOUNT, 10);
        settings.initialize_i32(AUTOSAVE_INTERVAL, 5);

        /*
        let font = QApplication::font();
        let font_name = font.family().to_std_string();
        let font_size = font.point_size();
        settings.initialize_string("font_name", &font_name);
        settings.initialize_i32("font_size", font_size);
        settings.initialize_string("original_font_name", &font_name);
        settings.initialize_i32("original_font_size", font_size);
    */
        // UI Settings.
        settings.initialize_bool(START_MAXIMIZED, false);
        settings.initialize_bool(ALLOW_EDITING_OF_CA_PACKFILES, false);
        settings.initialize_bool(CHECK_UPDATES_ON_START, true);
        settings.initialize_bool(CHECK_SCHEMA_UPDATES_ON_START, true);
        settings.initialize_bool(CHECK_LUA_AUTOGEN_UPDATES_ON_START, true);
        settings.initialize_bool(CHECK_OLD_AK_UPDATES_ON_START, true);
        settings.initialize_bool(USE_LAZY_LOADING, true);
        settings.initialize_bool(DISABLE_UUID_REGENERATION_ON_DB_TABLES, true);
        settings.initialize_bool(PACKFILE_TREEVIEW_RESIZE_TO_FIT, false);
        settings.initialize_bool(EXPAND_TREEVIEW_WHEN_ADDING_ITEMS, true);
        settings.initialize_bool(USE_RIGHT_SIZE_MARKERS, false);
        settings.initialize_bool(DISABLE_FILE_PREVIEWS, false);
        settings.initialize_bool(INCLUDE_BASE_FOLDER_ON_ADD_FROM_FOLDER, true);
        settings.initialize_bool(DELETE_EMPTY_FOLDERS_ON_DELETE, true);
        settings.initialize_bool(AUTOSAVE_FOLDER_SIZE_WARNING_TRIGGERED, false);
        settings.initialize_bool(IGNORE_GAME_FILES_IN_AK, false);
        settings.initialize_bool(ENABLE_MULTIFOLDER_FILEPICKER, false);
        settings.initialize_bool(ENABLE_PACK_CONTENTS_DRAG_AND_DROP, true);
        settings.initialize_bool(CLEAN_UI, false);
        settings.initialize_bool(SINGLE_PACK_MODE, true);
        settings.initialize_bool(GLOBAL_SEARCH_COLLAPSE_RESULTS, false);
        settings.initialize_bool(GLOBAL_SEARCH_AUTO_SELECT_OPEN_PACKS, true);

        // Table Settings.
        settings.initialize_bool(ADJUST_COLUMNS_TO_CONTENT, true);
        settings.initialize_bool(EXTEND_LAST_COLUMN_ON_TABLES, true);
        settings.initialize_bool(DISABLE_COMBOS_ON_TABLES, false);
        settings.initialize_bool(TIGHT_TABLE_MODE, false);
        settings.initialize_bool(TABLE_RESIZE_ON_EDIT, false);
        settings.initialize_bool(TABLES_USE_OLD_COLUMN_ORDER, true);
        settings.initialize_bool(TABLES_USE_OLD_COLUMN_ORDER_FOR_TSV, true);
        settings.initialize_bool(ENABLE_LOOKUPS, true);
        settings.initialize_bool(ENABLE_ICONS, true);
        settings.initialize_bool(ENABLE_DIFF_MARKERS, true);
        settings.initialize_bool(HIDE_UNUSED_COLUMNS, true);
        settings.initialize_bool(SHOW_TABLE_TOOLBAR, false);
        settings.initialize_bool(TABLE_FILTER_NEW_CHIPS_SHARE_GROUP, false);

        // Debug Settings.
        settings.initialize_bool(CHECK_FOR_MISSING_TABLE_DEFINITIONS, false);
        settings.initialize_bool(ENABLE_DEBUG_MENU, false);
        settings.initialize_bool(ENABLE_UNIT_EDITOR, false);
        settings.initialize_bool(ENABLE_ESF_EDITOR, false);
        settings.initialize_bool(USE_DEBUG_VIEW_UNIT_VARIANT, false);
        settings.initialize_bool(USE_DEBUG_VIEW_GROUP_FORMATIONS, false);
        settings.initialize_bool(ENABLE_RENDERER, true);

        // Diagnostics Settings.
        settings.initialize_bool(DIAGNOSTICS_TRIGGER_ON_OPEN, true);
        settings.initialize_bool(DIAGNOSTICS_TRIGGER_ON_TABLE_EDIT, true);

        // Telemetry settings: opt-out, both default to on. Users can disable either in the preferences.
        settings.initialize_bool(ENABLE_USAGE_TELEMETRY, true);
        settings.initialize_bool(ENABLE_CRASH_REPORTS, true);

        // Anonymous id to track distinct installs across sessions.
        if settings.string(ANONYMOUS_TELEMETRY_ID).is_empty() {
            let _ = settings.set_string(ANONYMOUS_TELEMETRY_ID, &uuid::Uuid::new_v4().to_string());
        }

        settings.initialize_string(AI_API_URL, "https://api.openai.com/v1/chat/completions");
        settings.initialize_string(AI_API_KEY, "");
        settings.initialize_string(AI_MODEL, "gpt-4o-mini");
        settings.initialize_string(DEEPL_API_KEY, "");
        settings.initialize_string(TRANSLATOR_SOURCE_LANGUAGE, DEFAULT_SRC_LANG);
        settings.initialize_bool(TRANSLATOR_USE_DEEPL_GLOSSARY, true);
        settings.initialize_string(GITHUB_LOGIN, "");

        settings.initialize_vec_string(RECENT_FILE_LIST, &[]);
        settings.initialize_vec_string(DIAGNOSTICS_DISABLED, &["label_field_with_path_not_found".to_owned()]);

        // Colours.
    /*    let q_settings = qt_core::QSettings::new();
        set_setting_if_new_string(&q_settings, "colour_light_table_added", "#87ca00");
        set_setting_if_new_string(&q_settings, "colour_light_table_modified", "#e67e22");
        set_setting_if_new_string(&q_settings, "colour_light_diagnostic_error", "#ff0000");
        set_setting_if_new_string(&q_settings, "colour_light_diagnostic_warning", "#bebe00");
        set_setting_if_new_string(&q_settings, "colour_light_diagnostic_info", "#55aaff");
        set_setting_if_new_string(&q_settings, "colour_dark_table_added", "#00ff00");
        set_setting_if_new_string(&q_settings, "colour_dark_table_modified", "#e67e22");
        set_setting_if_new_string(&q_settings, "colour_dark_diagnostic_error", "#ff0000");
        set_setting_if_new_string(&q_settings, "colour_dark_diagnostic_warning", "#cece67");
        set_setting_if_new_string(&q_settings, "colour_dark_diagnostic_info", "#55aaff");
        q_settings.sync();*/

        // Optimizer settings.
        let opt = OptimizerOptions::default();
        settings.initialize_bool(PACK_REMOVE_ITM_FILES, *opt.pack_remove_itm_files());
        settings.initialize_bool(PACK_APPLY_COMPRESSION, *opt.pack_apply_compression());
        settings.initialize_bool(PACK_APPLY_ENCRYPTION, *opt.pack_apply_encryption());
        settings.initialize_bool(PACK_REMOVE_DUPLICATED_FILES, *opt.pack_remove_duplicated_files());
        settings.initialize_bool(DB_IMPORT_DATACORES_INTO_TWAD_KEY_DELETES, *opt.db_import_datacores_into_twad_key_deletes());
        settings.initialize_bool(DB_OPTIMIZE_DATACORED_TABLES, *opt.db_optimize_datacored_tables());
        settings.initialize_bool(TABLE_REMOVE_DUPLICATED_ENTRIES, *opt.table_remove_duplicated_entries());
        settings.initialize_bool(TABLE_REMOVE_ITM_ENTRIES, *opt.table_remove_itm_entries());
        settings.initialize_bool(TABLE_REMOVE_ITNR_ENTRIES, *opt.table_remove_itnr_entries());
        settings.initialize_bool(TABLE_REMOVE_EMPTY_FILE, *opt.table_remove_empty_file());
        settings.initialize_bool(TEXT_REMOVE_UNUSED_XML_MAP_FOLDERS, *opt.text_remove_unused_xml_map_folders());
        settings.initialize_bool(TEXT_REMOVE_UNUSED_XML_PREFAB_FOLDER, *opt.text_remove_unused_xml_prefab_folder());
        settings.initialize_bool(TEXT_REMOVE_AGF_FILES, *opt.text_remove_agf_files());
        settings.initialize_bool(TEXT_REMOVE_MODEL_STATISTICS_FILES, *opt.text_remove_model_statistics_files());
        settings.initialize_bool(PTS_REMOVE_UNUSED_ART_SETS, *opt.pts_remove_unused_art_sets());
        settings.initialize_bool(PTS_REMOVE_UNUSED_VARIANTS, *opt.pts_remove_unused_variants());
        settings.initialize_bool(PTS_REMOVE_EMPTY_MASKS, *opt.pts_remove_empty_masks());
        settings.initialize_bool(PTS_REMOVE_EMPTY_FILE, *opt.pts_remove_empty_file());

        settings.set_block_write(false);

        if let Err(error) = settings.write() {
            rpfm_telemetry::warn!("Failed to persist settings file, continuing with in-memory settings. Error: {error}");
        }

        Ok(settings)
    }

    /// Read the on-disk settings file (`settings.json` under [`config_path`]).
    ///
    /// Errors if the file is missing or cannot be parsed as JSON. Most callers
    /// want [`Self::init`] instead, which falls back to defaults on failure.
    pub fn read() -> Result<Self> {
        Self::read_from(&config_path()?.join(SETTINGS_FILE_NAME))
    }

    /// Reads the settings from the provided file.
    pub(crate) fn read_from(path: &Path) -> Result<Self> {
        let mut data = vec![];
        let mut file = BufReader::new(File::open(path)?);
        file.read_to_end(&mut data)?;

        serde_json::from_slice(&data).map_err(From::from)
    }

    /// Loads the settings from the provided file, recovering from a missing, empty or broken one.
    ///
    /// A successful read refreshes `settings.json.bak` next to the file as the last good copy. If the read fails,
    /// that backup is loaded instead. If the backup can't be loaded either, the unreadable file's contents are kept
    /// in the backup for inspection (unless it's empty), and defaults are used.
    ///
    /// # Arguments
    ///
    /// * `path` - Path of the settings file.
    ///
    /// # Returns
    ///
    /// The loaded settings, the backup's, or the defaults.
    pub(crate) fn load_or_recover(path: &Path) -> Self {
        let backup_path = backup_path(path);
        match Self::read_from(path) {
            Ok(settings) => {
                let _ = std::fs::copy(path, &backup_path);
                settings
            },
            Err(error) => {
                rpfm_telemetry::warn!("Failed to read settings file. Error: {error}");
                match Self::read_from(&backup_path) {
                    Ok(settings) => {
                        rpfm_telemetry::warn!("Restored the settings from their backup.");
                        settings
                    },
                    Err(_) => {
                        if std::fs::metadata(path).is_ok_and(|metadata| metadata.len() > 0) {
                            let _ = std::fs::copy(path, &backup_path);
                        }

                        rpfm_telemetry::warn!("Failed to read the settings backup, using defaults.");
                        Settings::default()
                    },
                }
            },
        }
    }

    /// Writes the settings to disk. Does nothing if the block write flag is set.
    pub fn write(&self) -> Result<()> {
        if self.block_write {
            return Ok(());
        }

        self.write_to(&config_path()?.join(SETTINGS_FILE_NAME))
    }

    /// Writes the settings to the provided file, atomically.
    ///
    /// The settings are written to a temporary file, synced to disk, and then renamed over the target. A crash
    /// or power loss leaves either the previous file or the new one, never a truncated one.
    pub(crate) fn write_to(&self, path: &Path) -> Result<()> {
        let temp_path = path.with_extension("json.tmp");
        let mut file = BufWriter::new(File::create(&temp_path)?);
        file.write_all(serde_json::to_string_pretty(self)?.as_bytes())?;

        // `into_inner` flushes the buffer, reporting errors a drop would silently ignore.
        let file = file.into_inner().map_err(|error| error.into_error())?;
        file.sync_all()?;
        std::fs::rename(&temp_path, path)?;
        Ok(())
    }

    /// Disables save to disk when storing a setting. For batch operations.
    pub fn set_block_write(&mut self, status: bool) {
        self.block_write = status;
    }

    /// Read a `bool` setting; returns `false` if `setting` isn't set.
    pub fn bool(&self, setting: &str) -> bool {
        self.bool.get(setting).copied().unwrap_or_default()
    }

    /// Read an `i32` setting; returns `0` if `setting` isn't set.
    pub fn i32(&self, setting: &str) -> i32 {
        self.i32.get(setting).copied().unwrap_or_default()
    }

    /// Read an `f32` setting; returns `0.0` if `setting` isn't set.
    pub fn f32(&self, setting: &str) -> f32 {
        self.f32.get(setting).copied().unwrap_or_default()
    }

    /// Read a `String` setting; returns an empty string if `setting` isn't set.
    pub fn string(&self, setting: &str) -> String {
        self.string.get(setting).map(|x| x.to_owned()).unwrap_or_default()
    }

    /// Read a path-shaped string setting as a `PathBuf`; returns an empty
    /// `PathBuf` if `setting` isn't set. Backed by the same map as
    /// [`Self::string`].
    pub fn path_buf(&self, setting: &str) -> PathBuf {
        self.string.get(setting).map(PathBuf::from).unwrap_or_default()
    }

    /// Read a raw byte-blob setting; returns an empty `Vec` if `setting` isn't set.
    pub fn raw_data(&self, setting: &str) -> Vec<u8> {
        self.raw_data.get(setting).map(|x| x.to_vec()).unwrap_or_default()
    }

    /// Read a `Vec<String>` setting; returns an empty `Vec` if `setting` isn't set.
    pub fn vec_string(&self, setting: &str) -> Vec<String> {
        self.vec_string.get(setting).map(|x| x.to_vec()).unwrap_or_default()
    }

    /// Build a [`SettingsSnapshot`] of every currently persisted setting.
    pub fn snapshot(&self) -> SettingsSnapshot {
        SettingsSnapshot {
            bool: self.bool.clone(),
            i32: self.i32.clone(),
            f32: self.f32.clone(),
            string: self.string.clone(),
            raw_data: self.raw_data.clone(),
            vec_string: self.vec_string.clone(),
        }
    }

    /// Set a `bool` setting and persist to disk (subject to `block_write`).
    pub fn set_bool(&mut self, setting: &str, value: bool) -> Result<()> {
        self.bool.insert(setting.to_owned(), value);
        self.write()
    }

    /// Set an `i32` setting and persist to disk (subject to `block_write`).
    pub fn set_i32(&mut self, setting: &str, value: i32) -> Result<()> {
        self.i32.insert(setting.to_owned(), value);
        self.write()
    }

    /// Set an `f32` setting and persist to disk (subject to `block_write`).
    pub fn set_f32(&mut self, setting: &str, value: f32) -> Result<()> {
        self.f32.insert(setting.to_owned(), value);
        self.write()
    }

    /// Set a `String` setting and persist to disk (subject to `block_write`).
    pub fn set_string(&mut self, setting: &str, value: &str) -> Result<()> {
        self.string.insert(setting.to_owned(), value.to_owned());
        self.write()
    }

    /// Set a path setting (stored as a string) and persist to disk
    /// (subject to `block_write`).
    pub fn set_path_buf(&mut self, setting: &str, value: &Path) -> Result<()> {
        self.string.insert(setting.to_owned(), value.to_string_lossy().to_string());
        self.write()
    }

    /// Set a raw byte-blob setting and persist to disk (subject to `block_write`).
    pub fn set_raw_data(&mut self, setting: &str, value: &[u8]) -> Result<()> {
        self.raw_data.insert(setting.to_owned(), value.to_vec());
        self.write()
    }

    /// Set a `Vec<String>` setting and persist to disk (subject to `block_write`).
    pub fn set_vec_string(&mut self, setting: &str, value: &[String]) -> Result<()> {
        self.vec_string.insert(setting.to_owned(), value.to_vec());
        self.write()
    }

    /// Set a `bool` setting only if it isn't already set. Used by
    /// [`Self::init`] to seed defaults without clobbering user choices.
    pub fn initialize_bool(&mut self, setting: &str, value: bool) {
        if !self.bool.contains_key(setting) {
            self.bool.insert(setting.to_owned(), value);
        }
    }

    /// Set an `i32` setting only if it isn't already set. See [`Self::initialize_bool`].
    pub fn initialize_i32(&mut self, setting: &str, value: i32) {
        if !self.i32.contains_key(setting) {
            self.i32.insert(setting.to_owned(), value);
        }
    }

    /// Set an `f32` setting only if it isn't already set. See [`Self::initialize_bool`].
    pub fn initialize_f32(&mut self, setting: &str, value: f32) {
        if !self.f32.contains_key(setting) {
            self.f32.insert(setting.to_owned(), value);
        }
    }

    /// Set a `String` setting only if it isn't already set. See [`Self::initialize_bool`].
    pub fn initialize_string(&mut self, setting: &str, value: &str) {
        if !self.string.contains_key(setting) {
            self.string.insert(setting.to_owned(), value.to_owned());
        }
    }

    /// Set a path setting only if it isn't already set. See [`Self::initialize_bool`].
    pub fn initialize_path_buf(&mut self, setting: &str, value: &Path) {
        if !self.string.contains_key(setting) {
            self.string.insert(setting.to_owned(), value.to_string_lossy().to_string());
        }
    }

    /// Set a raw byte-blob setting only if it isn't already set. See [`Self::initialize_bool`].
    pub fn initialize_raw_data(&mut self, setting: &str, value: &[u8]) {
        if !self.raw_data.contains_key(setting) {
            self.raw_data.insert(setting.to_owned(), value.to_vec());
        }
    }

    /// Set a `Vec<String>` setting only if it isn't already set. See [`Self::initialize_bool`].
    pub fn initialize_vec_string(&mut self, setting: &str, value: &[String]) {
        if !self.vec_string.contains_key(setting) {
            self.vec_string.insert(setting.to_owned(), value.to_vec());
        }
    }

    /// Project the optimiser-related boolean settings into an
    /// [`OptimizerOptions`] suitable for handing to
    /// [`rpfm_extensions::optimizer`].
    pub fn optimizer_options(&self) -> OptimizerOptions {
        let mut options = OptimizerOptions::default();

        options.set_pack_remove_itm_files(self.bool(PACK_REMOVE_ITM_FILES));
        options.set_pack_apply_compression(self.bool(PACK_APPLY_COMPRESSION));
        options.set_pack_apply_encryption(self.bool(PACK_APPLY_ENCRYPTION));
        options.set_pack_remove_duplicated_files(self.bool(PACK_REMOVE_DUPLICATED_FILES));
        options.set_db_import_datacores_into_twad_key_deletes(self.bool(DB_IMPORT_DATACORES_INTO_TWAD_KEY_DELETES));
        options.set_db_optimize_datacored_tables(self.bool(DB_OPTIMIZE_DATACORED_TABLES));
        options.set_table_remove_duplicated_entries(self.bool(TABLE_REMOVE_DUPLICATED_ENTRIES));
        options.set_table_remove_itm_entries(self.bool(TABLE_REMOVE_ITM_ENTRIES));
        options.set_table_remove_itnr_entries(self.bool(TABLE_REMOVE_ITNR_ENTRIES));
        options.set_table_remove_empty_file(self.bool(TABLE_REMOVE_EMPTY_FILE));
        options.set_text_remove_unused_xml_map_folders(self.bool(TEXT_REMOVE_UNUSED_XML_MAP_FOLDERS));
        options.set_text_remove_unused_xml_prefab_folder(self.bool(TEXT_REMOVE_UNUSED_XML_PREFAB_FOLDER));
        options.set_text_remove_agf_files(self.bool(TEXT_REMOVE_AGF_FILES));
        options.set_text_remove_model_statistics_files(self.bool(TEXT_REMOVE_MODEL_STATISTICS_FILES));
        options.set_pts_remove_unused_art_sets(self.bool(PTS_REMOVE_UNUSED_ART_SETS));
        options.set_pts_remove_unused_variants(self.bool(PTS_REMOVE_UNUSED_VARIANTS));
        options.set_pts_remove_empty_masks(self.bool(PTS_REMOVE_EMPTY_MASKS));
        options.set_pts_remove_empty_file(self.bool(PTS_REMOVE_EMPTY_FILE));

        options
    }

    /// This function returns the path where the db files from the assembly kit are stored.
    pub fn assembly_kit_path(&self, game: &GameInfo) -> Result<PathBuf> {
        let version = *game.raw_db_version();
        match version {

            // Post-Shogun 2 games.
            2 | 1 => {
                let mut base_path = self.path_buf(&format!("{}_assembly_kit", game.key()));
                base_path.push("raw_data/db");
                Ok(base_path)
            }

            0 => {
                let base_path = old_ak_files_path()?.join(game.key());
                Ok(base_path)
            },

            // Shogun 2/Older games
            _ => Err(RLibError::AssemblyKitUnsupportedVersion(version).into())
        }
    }
}

//-------------------------------------------------------------------------------//
//                             Extra Helpers
//-------------------------------------------------------------------------------//

/// This function returns RPFM's default config path, ignoring any custom-folder redirect.
///
/// Note: On `Debug´ mode this project is the project from where you execute one of RPFM's programs, which should be the root of the repo.
pub fn default_config_path() -> Result<PathBuf> {

    // On debug builds we use the local folder as the config folder.
    if cfg!(debug_assertions) {
        std::env::current_dir().map_err(From::from)
    } else {
        match ProjectDirs::from(ORG_DOMAIN, ORG_NAME, APP_NAME) {
            Some(proj_dirs) => Ok(proj_dirs.config_dir().to_path_buf()),
            None => Err(anyhow!("Failed to get the config path."))
        }
    }
}

/// Path of the backup of a settings file: the same file, with `.bak` appended.
pub(crate) fn backup_path(path: &Path) -> PathBuf {
    path.with_extension("json.bak")
}

/// This function returns the active config path: the user's custom folder if one is set, or the default otherwise.
///
/// All other config sub-paths derive from this, so setting a custom folder relocates RPFM's whole config tree.
pub fn config_path() -> Result<PathBuf> {
    match custom_config_path()? {
        Some(path) => Ok(path),
        None => default_config_path(),
    }
}

/// This function returns the user-configured custom config folder, or `None` if RPFM uses the default one.
///
/// The custom path is read from the [`CONFIG_REDIRECT_FILE_NAME`] file inside the default config path.
pub fn custom_config_path() -> Result<Option<PathBuf>> {
    let redirect_file = default_config_path()?.join(CONFIG_REDIRECT_FILE_NAME);
    if !redirect_file.is_file() {
        return Ok(None);
    }

    let raw = std::fs::read_to_string(&redirect_file)?;
    let trimmed = raw.trim();
    if trimmed.is_empty() {
        Ok(None)
    } else {
        Ok(Some(PathBuf::from(trimmed)))
    }
}

/// This function sets (or clears, when passed `None`) the custom config folder and initializes it.
///
/// The choice is persisted to the redirect file in the default config path. The new folder is created and
/// populated right away, but the running program keeps using the old one until it's restarted.
pub fn set_custom_config_path(path: Option<&Path>) -> Result<()> {

    // The redirect file always lives in the default path, so make sure that one exists first.
    let default_path = default_config_path()?;
    DirBuilder::new().recursive(true).create(&default_path)?;
    let redirect_file = default_path.join(CONFIG_REDIRECT_FILE_NAME);

    match path {
        Some(path) if !path.as_os_str().is_empty() => {
            DirBuilder::new().recursive(true).create(path)?;
            std::fs::write(&redirect_file, path.to_string_lossy().as_bytes())?;
        }
        _ => if redirect_file.is_file() {
            std::fs::remove_file(&redirect_file)?;
        }
    }

    init_config_path()
}

/// This function returns the path where crash logs are stored.
pub fn error_path() -> Result<PathBuf> {
    Ok(config_path()?.join("error"))
}

/// Function to initialize the config folder, so RPFM can use it to store his stuff.
///
/// This can fail, so if this fails, better stop the program and check why it failed.
#[must_use = "Many things depend on this folder existing. So better check this worked."]
pub fn init_config_path() -> Result<()> {

    let config_path = config_path()?;
    DirBuilder::new().recursive(true).create(&config_path)?;
    DirBuilder::new().recursive(true).create(backup_autosave_path()?)?;
    DirBuilder::new().recursive(true).create(error_path()?)?;
    DirBuilder::new().recursive(true).create(schemas_path()?)?;
    DirBuilder::new().recursive(true).create(table_patches_path()?)?;
    DirBuilder::new().recursive(true).create(table_profiles_path()?)?;
    DirBuilder::new().recursive(true).create(scripts_path()?)?;
    DirBuilder::new().recursive(true).create(old_ak_files_path()?)?;

    // Schema patches need their file existing to even save.
    let games = SupportedGames::default();
    for game in games.games_sorted() {
        let path = table_patches_path().unwrap().join(game.schema_file_name());
        if !path.is_file() {
            let base: HashMap<String, DefinitionPatch> = HashMap::new();
            let mut file = BufWriter::new(File::create(path)?);
            let config = PrettyConfig::default();
            file.write_all(to_string_pretty(&base, config)?.as_bytes())?;
        }
    }

    /*
    #[cfg(feature = "support_model_renderer")] {
        let assets_path = format!("{}/assets/", rpfm_ui_common::ASSETS_PATH.to_string_lossy());
        if !PathBuf::from(&assets_path).is_dir() {
            DirBuilder::new().recursive(true).create(&assets_path)?;
        }

        unsafe {crate::ffi::set_asset_folder(&assets_path); }

        let log_path = config_path.to_string_lossy();
        unsafe {crate::ffi::set_log_folder(&log_path); }
    }*/

    Ok(())
}

/// This function returns the schema path.
pub fn schemas_path() -> Result<PathBuf> {
    Ok(config_path()?.join(SCHEMA_FOLDER))
}

/// Folder under [`config_path`] where user-side schema patches live.
pub fn table_patches_path() -> Result<PathBuf> {
    Ok(config_path()?.join(TABLE_PATCHES_FOLDER))
}

/// Folder under [`config_path`] where saved table view profiles (column
/// orders, filters, hidden columns) are persisted.
pub fn table_profiles_path() -> Result<PathBuf> {
    Ok(config_path()?.join(TABLE_PROFILES_FOLDER))
}

/// This function returns the lua autogen path.
pub fn lua_autogen_base_path() -> Result<PathBuf> {
    Ok(config_path()?.join(LUA_AUTOGEN_FOLDER))
}

/// This function returns the lua autogen path for a specific game.
pub fn lua_autogen_game_path(game: &GameInfo) -> Result<PathBuf> {
    match game.lua_autogen_folder() {
        Some(folder) => Ok(config_path()?.join(LUA_AUTOGEN_FOLDER).join(folder)),
        None => Err(anyhow!("Lua Autogen not available for this game."))
    }
}

/// This function returns the autosave path.
pub fn backup_autosave_path() -> Result<PathBuf> {
    Ok(config_path()?.join("autosaves"))
}

/// This function returns the dependencies path.
pub fn dependencies_cache_path() -> Result<PathBuf> {
    Ok(config_path()?.join(DEPENDENCIES_FOLDER))
}

/// Folder under [`config_path`] where the user drops plugin scripts shown in the
/// PackFile contents context menu.
pub fn scripts_path() -> Result<PathBuf> {
    Ok(config_path()?.join(SCRIPTS_FOLDER))
}

/// Folder under [`config_path`] holding archived Empire/Napoleon Assembly Kit
/// definitions (no AK was ever shipped for these games, so RPFM bundles a
/// frozen copy via the `old_ak_files` submodule).
pub fn old_ak_files_path() -> Result<PathBuf> {
    Ok(config_path()?.join("old_ak_files"))
}

/// Folder under [`config_path`] where the user's local mod translations are
/// stored (one JSON per pack/language).
pub fn translations_local_path() -> Result<PathBuf> {
    Ok(config_path()?.join(TRANSLATIONS_LOCAL_FOLDER))
}

/// Folder under [`config_path`] where the local clone of the Translation Hub
/// repository is mirrored.
pub fn translations_remote_path() -> Result<PathBuf> {
    Ok(config_path()?.join(TRANSLATIONS_REMOTE_FOLDER))
}

/// Recursively deletes the config folder, then re-runs [`init_config_path`] to recreate
/// the standard sub-folders. Refuses to delete anything outside
/// [`config_path`].
///
/// Used by the "reset settings" / "clear caches" actions in the UI.
pub fn clear_config_path(path: &Path) -> Result<()> {
    if path.exists() && path.is_dir() && path.starts_with(config_path()?) {
        std::fs::remove_dir_all(path)?;
        init_config_path()
    } else {
        Err(anyhow!("Path is not a valid directory to clear or does not exist"))
    }
}