REFramework配置系统完全指南：从基础到高级应用

一、配置系统基础认知

当你首次安装REFramework并启动游戏时，可能会疑惑那些菜单设置是如何保存的，或者想知道如何自定义快捷键来提升操作效率。【配置系统】作为REFramework的核心组件，正是负责管理这些用户偏好设置的底层机制。它不仅记录你的操作习惯，还允许你深度定制框架行为，打造个性化的游戏增强体验。

配置系统核心组件

REFramework的配置功能主要通过以下三个部分实现：

• 配置定义：在src/mods/REFrameworkConfig.hpp中声明所有可配置参数及其默认值
• 配置逻辑：在src/mods/REFrameworkConfig.cpp中实现参数的加载、保存和UI交互
• 持久化存储：通过re2_fw_config.txt文件保存用户设置，采用简单的键值对格式

配置加载流程解析

配置系统的工作流程可以概括为三个关键步骤：

1. 初始化：游戏启动时，REFrameworkConfig::on_initialize()创建配置实例并设置默认值
2. 加载：on_config_load()从配置文件读取参数并应用到内存变量
3. 保存：用户修改设置后，on_config_save()将当前状态写回文件

二、核心配置功能解析

当你需要调整REFramework的基础行为，比如修改菜单快捷键或调整界面字体大小时，了解核心配置参数及其作用至关重要。这些参数控制着框架的各种交互方式和视觉表现，是个性化设置的基础。

菜单控制参数

参数名	类型	默认值	常见应用场景
MenuKey_V2	按键	VK_INSERT	自定义打开/关闭菜单的快捷键，适合不同键盘布局用户
MenuOpen	布尔值	true	控制游戏启动时菜单是否默认展开，减少重复操作
RememberMenuState	布尔值	false	记忆上次游戏退出时的菜单状态，保持操作连贯性

💡 配置项应用场景：对于经常使用REFramework的玩家，建议将RememberMenuState设为true，并将MenuKey_V2改为易于按压的按键（如F5），这样每次启动游戏都能保持一致的操作体验。

界面显示参数

光标控制

• DrawCursorWithMenuOpen：控制菜单打开时是否显示系统光标
  • RE8游戏默认值：true（方便VR操作）
  • 其他游戏默认值：false（减少画面干扰）
• ShowCursorKey：快速切换光标显示状态的快捷键，默认未设置

字体设置

REFramework支持自定义界面字体，让不同视力的玩家都能舒适阅读：

• FontSize：界面字体大小，默认16，建议根据屏幕分辨率调整
• FontFile：字体文件名称，默认"DEFAULT"，可替换为自定义字体

字体加载的核心代码逻辑如下：

// 扫描字体目录并加载可用字体文件
const auto fonts_path = REFramework::get_persistent_dir() / "reframework" / "fonts";
fs::create_directories(fonts_path);
for (const auto& entry : fs::directory_iterator(fonts_path)) {
    if (fs::is_regular_file(entry) && 
       (entry.path().extension() == ".otf" || entry.path().extension() == ".ttf")) {
        fonts.push_back(entry.path().filename().string());
    }
}

三、配置操作实践指南

当你想要修改REFramework的默认设置时，通过配置界面进行操作是最直观的方式。无论是调整快捷键、更改字体大小，还是设置光标行为，都可以通过简单的几步完成，无需直接编辑配置文件。

配置界面访问步骤

1. 启动游戏并确保REFramework已加载
2. 按下默认快捷键Insert打开主菜单
3. 在主菜单中找到并展开"Configuration"折叠项
4. 修改所需参数，设置会自动保存

⚠️ 注意事项：部分设置（如字体更改）可能需要重启游戏才能完全生效。建议修改后记录当前设置，以便出现问题时可以恢复。

配置文件手动编辑方法

如果无法通过UI进行配置（如快捷键冲突导致菜单无法打开），可以手动编辑配置文件：

1. 找到配置文件re2_fw_config.txt（通常位于游戏根目录）
2. 使用文本编辑器打开，找到需要修改的参数
3. 按参数名=值格式修改，例如MenuKey_V2=VK_F5
4. 保存文件并重启游戏

四、高级配置技巧与应用

对于需要深度定制REFramework的高级用户，掌握配置系统的进阶用法可以显著提升使用体验。从批量管理配置到迁移设置，这些技巧能帮助你更高效地管理框架行为。

自定义快捷键完全指南

REFramework支持使用虚拟按键码（VK_*）设置快捷键，常见按键代码包括：

• VK_F1-F12：功能键F1到F12
• VK_UP/VK_DOWN/VK_LEFT/VK_RIGHT：方向键
• VK_NUMPAD0-VK_NUMPAD9：小键盘数字键

示例：将菜单快捷键改为F5

MenuKey_V2=VK_F5

配置迁移与备份策略

当你更换电脑或重新安装游戏时，可以通过以下步骤迁移配置：

1. 找到旧系统中的re2_fw_config.txt文件
2. 将其复制到新系统的游戏根目录
3. 启动游戏，REFramework会自动加载迁移的配置

💡 技巧：定期备份配置文件到云端或外部存储，可防止系统故障导致设置丢失。

多游戏配置隔离方案

如果你在同一台电脑上玩多个RE引擎游戏，可以通过创建游戏特定配置文件实现隔离：

1. 为每个游戏创建单独的配置文件，如re2_fw_config_re2.txt、re2_fw_config_re8.txt
2. 创建批处理脚本，启动游戏前将对应配置文件复制为re2_fw_config.txt
3. 通过快捷方式执行批处理脚本启动游戏

五、常见配置问题解决

在使用REFramework配置系统时，你可能会遇到各种问题，从设置不生效到游戏崩溃。以下是一些常见问题的解决方案，帮助你快速恢复正常使用。

配置修改后游戏崩溃

症状：修改配置后游戏无法启动或频繁崩溃
原因：可能是参数值格式错误或超出有效范围
解决方案：

1. 删除re2_fw_config.txt文件
2. 启动游戏，REFramework会自动生成默认配置
3. 重新进行配置，避免使用非标准参数值

自定义字体不生效

症状：设置了FontFile但界面字体未变化
原因：字体文件位置或格式不正确
解决方案：

1. 确认字体文件格式为.otf或.ttf
2. 将文件放置在reframework/fonts目录（无子目录）
3. 确保文件名无特殊字符，如空格、中文或符号
4. 在配置界面重新选择字体并应用

快捷键设置无效

症状：设置新快捷键后无反应
原因：可能与游戏或其他软件快捷键冲突
解决方案：

1. 选择不常用的按键组合
2. 避免使用游戏本身已占用的快捷键
3. 检查是否有其他软件（如录屏工具）占用了该快捷键

六、配置系统技术原理

要深入理解REFramework配置系统的工作机制，需要了解其底层实现方式。配置系统采用模块化设计，通过统一的接口管理所有配置项，确保扩展性和维护性。

配置项管理架构

REFramework使用ValueList统一管理所有配置选项：

ValueList m_options {
    *m_menu_key,
    *m_menu_open,
    *m_remember_menu_state,
    *m_always_show_cursor,
    *m_show_cursor_key,
    *m_font_size,
};

这种设计允许通过循环批量处理所有配置项，简化了加载和保存逻辑：

// 批量加载配置示例
for (IModValue& option : m_options) {
    option.config_load(cfg);
}

配置UI渲染流程

配置界面的渲染通过REFrameworkConfig::on_draw_ui()实现，采用ImGui库构建交互界面：

if (!ImGui::CollapsingHeader("Configuration")) { return; }
ImGui::TreePush("Configuration");
m_menu_key->draw("Menu Key");
m_show_cursor_key->draw("Show Cursor Key");
// 其他配置项绘制...
ImGui::TreePop();

配置系统流程图

配置系统的核心工作流程如下：

游戏启动 → 创建配置实例 → 加载配置文件 → 应用配置值 → 
用户交互修改 → 实时更新内存值 → 触发保存 → 写回配置文件

相关资源

• 配置定义源码：src/mods/REFrameworkConfig.hpp
• 配置逻辑实现：src/mods/REFrameworkConfig.cpp
• 配置文件：re2_fw_config.txt
• 字体目录：reframework/fonts

通过本文介绍的配置方法，你可以充分发挥REFramework的定制能力，根据个人习惯和游戏需求调整框架行为。无论是基础的快捷键修改，还是高级的配置迁移，掌握这些知识将帮助你获得更流畅的游戏增强体验。

图：REFramework配置系统背后的节点编辑器界面，展示了模块化配置项的关联关系