Skip to main content

XRESLOADER TOOLCHAIN

Excel game data
conversion tools

Convert Excel workbooks into structured game configuration.
Map and validate fields against schemas, convert batches with the CLI or GUI, and generate data loaders.

Quick startDownload tools

Ready-to-use Excel, schema and XML · No protoc needed to get started

Inputs and output formatsConfiguration workflow
XExcelDesign data
+
PProtobufStructure and constraints
xresloaderField mapping / validation / conversion
protobufJSONLuaMsgPackJavaScriptUE DataTable
xresconv-cli -p 1 convert.xml

Use the CLI in pipelines and select tables interactively in the desktop app.

Components

Tools and downloads

Toolchain overview

CLI batch converter

xresconv-cli

Convert workbooks from XML manifests, preview tasks, control concurrency and integrate with build pipelines. Native Rust; no Python required.

Repository ↗Guide ↗

Checking the latest stable release…

Download latest release ↓

Choose the package for your system on the latest release page. Projects without a stable release offer their current source.

Game configuration

Capabilities

Explore all capabilities

Batch conversion across platforms

A Java engine, native Rust CLI and Tauri GUI work together on Windows, macOS and Linux. Designers and build pipelines use the same manifests.

Read the guide and examples

Multiple output formats

Export protobuf, MsgPack, Lua, JavaScript, JSON, XML and Unreal Engine DataTable JSON / CSV for clients and servers.

Read the guide and examples

Nested messages and field types

Use proto2 / proto3, nested messages, repeated fields, oneof, map and in-cell Plain structures to describe your data model.

Read the guide and examples

Export enums and descriptors

Export schema enums, constants and descriptors as Lua / JavaScript code or JSON / XML data, with custom options for reflection.

Read the guide and examples

Aliases and validation

Field and enum aliases, macros, ranges, cross-table references and composed validators catch input errors during conversion.

Read the guide and examples

Field mapping and merged tables

Merge Excel sources, map field names with regular expressions, select ranges and transpose data. Schema options control export behavior.

Read the guide and examples

Output controls

Choose cached or explicitly evaluated formulas, trim or retain empty data, set data versions, and filter outputs by format, directory and tags.

Read the guide and examples

Data loaders and indexes

Integrate with C++, C#, Go, upb, pbc or lua-protobuf. Lua supports global / require / module; JavaScript supports global / Node.js / AMD.

Read the guide and examples

Unreal Engine and project extensions

Export UE DataTables and generate loaders. Connect project tools through GUI events, custom buttons and Node.js scripts; inspect binary data with dump-bin.

Read the guide and examples

Quick start

Conversion example

The example includes Excel workbooks, schema descriptors and XML manifests, with bin and JSON outputs.
The quick start covers conversion, data checks and loading.

Download example ZIP
  1. 01

    Prepare the tools

    Install Java and the xresloader JAR, then choose the CLI or GUI.

  2. 02

    Preview conversion tasks

    One XML manifest connects workbooks, schemas and outputs.

  3. 03

    Check and load the data

    Compare with Excel, inspect bin files, and use the sample loaders for JSON or protobuf.

XRESCONV-GUI 3.0

Desktop batch conversion

Select entries in a tree, configure output formats, and inspect conversion progress and logs. Filter logs or cancel a running conversion.

Explore the interfaceConnect project scripts
xresconv-gui 3.0 release with three entries selected, showing a completed conversion and six successful outputsxresconv-gui 3.0 release with three entries selected, showing a completed conversion and six successful outputs
3.0 release · Actual conversion of the full configuration example

XRESCONV-CLI

Command-line batch conversion

CLI reference

Preview the commands for an XML manifest with --test. Run the same manifest to export bin and JSON files; the exit status and logs report the result.

Task preview

xresconv-cli --test -p 1 convert.xml
Actual xresconv-cli 2.0.2 preview output: four commands for two tables, with no data written
Actual output snapshot · Paths shortened; tool diagnostics retain their original language. Scroll horizontally on narrow screens or open the image at full size.

Conversion results

xresconv-cli -p 1 convert.xml
Actual xresconv-cli 2.0.2 conversion output: four successful bin and JSON exports, three records per output, zero failed jobs
Actual output snapshot · Paths shortened; tool diagnostics retain their original language. Scroll horizontally on narrow screens or open the image at full size.

Technical reference

Configuration and integration

Data mapping

Fields, arrays, nested messages and data ranges

Manifests and output matrices

Includes, directories, renaming and tag filters

Validation and extensions

Validators, scripts, events and custom buttons

Development and integration

Dependencies, builds, processes and interfaces