跳到主要内容

XRESLOADER TOOLCHAIN

Excel 游戏配置
转换工具链

将 Excel 表格转换为结构化游戏配置。
按协议映射和校验字段,用 CLI 或 GUI 批量转换,并生成项目所需的读表代码。

准备好的 Excel、协议和 XML · 入门无需安装 protoc

输入与输出格式配置工作流
XExcel策划数据
+
PProtobuf结构与约束
xresloader字段映射 / 数据校验 / 转换
protobufJSONLuaMsgPackJavaScriptUE DataTable
xresconv-cli -p 1 convert.xml

命令行接入流水线,桌面工具交互选表。

工具链组件

组件与下载

工具链概览

二进制数据查看工具

xresloader-dump-bin

按 descriptor 展示已经转出的 bin 文件,核对头信息和记录,提取字符串或带标签的数据。

正在查询最新正式版…

下载最新版本 ↓

在最新发布页选择适合目标系统的包;尚无正式版的项目提供当前源码。

游戏配置

主要功能

完整能力概览

跨平台批量转换

Java 引擎、原生 Rust CLI 与 Tauri GUI 支持 Windows、macOS 和 Linux。桌面选表与构建流水线可复用同一份 XML 清单。

查看功能与示例

多格式输出

protobuf、MsgPack、Lua、JavaScript、JSON、XML,以及 Unreal Engine DataTable JSON / CSV,满足客户端和服务端的不同需求。

查看功能与示例

嵌套结构与字段类型

支持 proto2 / proto3、嵌套 message、repeated、oneof、map,以及单元格内的 Plain 结构。

查看功能与示例

枚举与描述信息导出

导出协议枚举、常量和 descriptor,生成 Lua / JavaScript 代码或 JSON / XML 数据,配合自定义插件扩展反射信息。

查看功能与示例

别名与数据校验

字段和枚举可使用别名与宏;范围、跨表引用和逻辑组合验证器在转换时检查输入数据。

查看功能与示例

字段映射与合表

多张 Excel 合并输出,支持字段名正则映射、范围、转置和数组;协议插件控制输出行为。

查看功能与示例

输出控制

公式缓存或显式实时计算、空数据裁剪与定长保留、数据版本号、多格式输出目录和标签筛选。

查看功能与示例

数据加载与索引

配套 C++、C#、Go、upb、pbc、lua-protobuf 等接入方式;Lua 支持 global / require / module,JavaScript 支持 global / Node.js / AMD。

查看功能与示例

Unreal Engine 与项目扩展

输出 UE DataTable,生成加载代码;通过 GUI 事件、自定义按钮和 Node.js 脚本接入项目工具。dump-bin 用于查看二进制数据。

查看功能与示例

快速上手

转换示例

示例包含 Excel、协议描述文件和 XML 清单,输出 bin 与 JSON。
快速上手介绍转换、数据核对和加载方法。

下载示例 ZIP
  1. 01

    准备工具

    安装 Java,下载 xresloader JAR,并选择 CLI 或 GUI。

  2. 02

    预览转换任务

    用同一份 XML 关联表格、协议与输出。

  3. 03

    核对并加载数据

    对照 Excel、查看 bin,用示例代码加载 JSON 或 protobuf。

XRESCONV-GUI 3.0

桌面批量转换

在树形列表中选择条目、设置输出格式,并查看转换进度和日志。支持筛选日志和取消运行中的转换。

查看界面与操作接入项目脚本
xresconv-gui 3.0 正式版选择三项条目,真实转换完成并显示六个输出的成功日志xresconv-gui 3.0 正式版选择三项条目,真实转换完成并显示六个输出的成功日志
3.0 正式版 · 使用完整配置示例实际转换

XRESCONV-CLI

命令行批量转换

CLI 参考

使用 --test 预览 XML 清单对应的转换命令。执行同一清单可导出 bin 和 JSON,退出码和日志用于核对结果。

任务预览

xresconv-cli --test -p 1 convert.xml
xresconv-cli 2.0.2 实际预览输出:两张表的四条转换命令,不生成数据文件
实际输出快照 · 路径已缩写,诊断保留工具原始语言。窄屏可横向滚动或点击查看原图。

转换结果

xresconv-cli -p 1 convert.xml
xresconv-cli 2.0.2 实际转换输出:四个 bin 和 JSON 文件成功导出,每个文件三条记录,失败任务数为零
实际输出快照 · 路径已缩写,诊断保留工具原始语言。窄屏可横向滚动或点击查看原图。

技术参考

配置与集成