跳到主要内容

xresloader 转表工具套件

xresloader 是一个面向游戏团队的数据转表工具链:把 Excel 中的策划数据转换为 protobuf、JSON、MsgPack、Lua、JavaScript、XML 等多种结构化格式,并配套批量化、校验和代码生成工具。

xresloader logo

跨平台 Excel 转表工具

让 Excel 数据一键落地任意运行时

跨平台覆盖

基于 Java 17+ 的 CLI/GUI,支持 include 复用,Windows、macOS、Linux 一致体验。

多格式导出

Excel 可导出 protobuf、MsgPack、Lua、JavaScript、JSON、XML 以及 UE DataTable(JSON/CSV)。

协议结构支持

兼容 proto v2/v3、嵌套 message、数组嵌套、oneof、map 与 plain 字符串转复杂结构。

枚举与描述导出

可输出 proto 枚举值与 descriptor 到 Lua/JavaScript/JSON/XML,并可扩展自定义反射插件。

流程编排

xresconv CLI/GUI 支持 include、多模板/class 分流,轻松应对多项目流水线。

别名与校验

别名表提升策划可读性,validator 直接识别 proto 字段与枚举,导出前自动校验数据。

版本对比

配合 xresloader-dump-bin 可快速比较不同版本数据包,追踪差异来源。

插件与合表

通过 protobuf 插件控制部分输出,并可自动将多张 Excel 合并成单一目标文件。

内容生态

支持 UE JSON/CSV,自动生成 DataTable 加载代码,适配 Lua/JavaScript 多模块形态。

几分钟构建第一条导出流水线

按照下载、配置、导出的顺序即可完成最小可用流程。文档提供脚本、模板与常见问题解答,贴合 mkdocs-material 风格的阅读体验。

CLI + GUI 命令行集成工具和图形化客户端

首页即可预览 xresconv-cli 与 xresconv-gui 的真实操作动图
查阅文档 前就能体会脚本自动化与 GUI 工作台的差异化体验

批量脚本式导出 演示
CLI

批量脚本式导出

xresconv-cli 在构建机上批量驱动 xresloader,适合自动化流水线与版本对比。

查看 CLI 演示
所见即所得配置 演示
GUI

所见即所得配置

xresconv-gui 以树形结构管理模板,便于运营与策划自行开关导出项。

查看 GUI 指南

支持 Excel 数组和复杂结构映射和多种配置模式

下列示意来自 数据映射,涵盖数据源、Key 映射、Message 复用与数组嵌套等配置场景。
帮助评估 scheme 在复杂策划表中的扩展能力。

数据源绑定 演示
Mapping

数据源绑定

“数据源”章节演示如何声明 Excel 文件、工作表以及行列范围,让转表器精准定位输入。

查看数据源示例
Key 与 proto 对应 演示
Mapping

Key 与 proto 对应

“数据索引”把 Excel Key 与 proto 字段成对绑定,涵盖枚举、常量与多列拼接等配置模式。

查看字段映射
嵌套 Message 演示
Mapping

嵌套 Message

“数据嵌套和 Message 嵌套”章节展示 record/message 复用写法,子结构可以跨表共享。

了解嵌套配置
数组嵌套 演示
Mapping

数组嵌套

“数组嵌套”示例通过 scheme 组合把二维 Excel 区域映射为 repeated message,适配复杂表格导出。

查看数组嵌套