ExcelTableImporter

A Godot 4.x editor plugin that turns .xlsx / .csv spreadsheet tables into type-safe Resources + generated load code with one click. Stop hand-writing config parsing code.

Features

• .xlsx parsing — zero external dependency (built on Godot's ZIPReader + XMLParser), multi-sheet, shared/inline strings.
• .csv parsing — quote-aware, escaped quotes, comma-in-quote, UTF-8 with/without BOM.
• Type inference — column types inferred from row data automatically.
• Cleaning & validation — identifier checks and duplicate-name detection before export.
• Code & resource generation — exports typed .gd (Resource classes + loader), .tres and .json into res://tables.
• Editor import plugin — .xlsx / .csv become visible/importable in the editor.
• Table preview dock — preview parsed tables right inside the editor.
• Interactive export dialog — pick tables, rename class names, choose formats (.gd / .tres / .json) and output directory.

Quick Start

1. Put tables in res://examples/ (first row = headers).
2. Tools → Excel 导表工具 → 导出选项… to open interactive export.
3. Generated files land in res://tables/; read them as typed resources in your game.

Limitations

• V1: full re-export, no per-table incremental diffing yet.
• V2 (roadmap): Google Sheets / cloud-sourced tables.

License

MIT — Copyright (c) 2026 wolflanlan. See LICENSE.