配置工具

Excel 生成器将资源工作簿转换为 XML 元数据、配置数据及 C++、C# 定义。这是离线制作资源的步骤，启动 Sample1 和运行 C++ 网络测试都不需要执行它。

运行条件与命令

使用 Python 3 运行现有生成器，并在所选 Python 环境中安装 openpyxl。只有打包独立可执行文件时才需要 PyInstaller。

python3 build/tools/config_tool/config_tool.py --help
python3 build/tools/config_tool/config_tool.py --path /path/to/resource

参数帮助虽然写着「excel file path」，实际应传入资源根目录，不是 .xlsx 文件或 excel/ 子目录。生成器在该根目录下写文件，并要求输出目录已经存在。

在临时资源副本中导出

先在仓库根目录复制附带的资源目录，再修改工作簿。macOS/Linux：

resource_demo=$(mktemp -d)
cp -R build/resource/. "$resource_demo/"
python3 build/tools/config_tool/config_tool.py --path "$resource_demo"
printf '%s\n' "$resource_demo"

Windows PowerShell，需先准备 Python 和 openpyxl：

$resourceDemo = Join-Path ([System.IO.Path]::GetTempPath()) ("ark-resource-" + [guid]::NewGuid())
New-Item -ItemType Directory -Path $resourceDemo | Out-Null
Copy-Item build/resource/* $resourceDemo -Recurse -Force
python build/tools/config_tool/config_tool.py --path $resourceDemo
Write-Output $resourceDemo

附带的工作簿会在副本中生成以下文件：

部署前先检查生成的 XML 和定义。当前生成器不会另外导出一套客户端资源，也不会迁移数据库结构或重新加载运行中的进程。Kernel 加载这些数据时，需要把所需的 meta/、server/ 输出放到运行目录的 resource/ 下，详见应用启动器。

修改普通配置工作簿

使用 .xlsx 格式。对于 item.xlsx 等普通配置，生成器读取第一张工作表，每列表示一个字段：

entity_class.xlsx 使用另一种布局描述实体类和字段，应以仓库附带工作簿为模板。修改 C++ 标识符时，不要顺带改变类名、字段名和反射字符串，它们属于资源约定。

更新仓库中的生成头文件

资源变更经过检查后，在工作分支运行包装脚本。脚本导出仓库的 build/resource/，按项目 clang-format 规则格式化 code/meta_define.hpp，再复制到 include/ark/meta_define.hpp，会覆盖这些生成文件。

macOS/Linux 上选择 Python 环境和项目支持的 clang-format 版本：

PYTHON=python3 CLANG_FORMAT=clang-format sh build/tools/gen-config.sh

Windows 按需设置 PYTHON、CLANG_FORMAT 后运行 build/tools/gen-config.bat。直接运行 config_tool.py 不会执行最后的头文件复制。

生成头文件使用 snake_case 的 C++ 名称，保留 Player 等资源字符串：

#include "ark/meta_define.hpp"

const auto& class_name = ark::entity_meta_player::self_name();
const auto field_index = ark::meta_name_index::get_index(class_name, "map_id");

类或字段不存在时返回索引 0。C# 输出保留原有命名规范。资源命名和格式变化需要单独确定兼容规则，生成的 C++ 名称变化不代表资源 schema 已迁移。

工具目录中的其他内容

工具源码位于 build/tools。应用的 XML 插件列表、日志配置与生成的 Kernel 资源是不同的配置输入。