Check a CSV or JSON item list, then export it as a Roblox ModuleScript. Invalid prices, duplicate IDs and broken prerequisites stop the export.
Run it locally with Python. No extra packages or Roblox login are needed.
Requires Python 3.11 or newer. From the repository folder:
python flash_config.py examples/items.json --check
python flash_config.py examples/items.csv --output build/Items.luau
python -m unittest discover -s tests -vOn Windows, use py instead of python if that is how Python is installed.
Open the generated file and copy it into a ModuleScript named Items in ServerScriptService. If your project uses Rojo, put it in the directory mapped to that service instead. examples/ReadCatalog.server.luau shows how to build a lookup by item ID. A Studio plugin or importer is not required.
JSON is an array of objects. CSV uses these exact headers, in any order:
| Field | Required | Meaning |
|---|---|---|
| id | Yes | Unique, case-sensitive identifier: letter first, then letters, digits, underscore or hyphen; maximum 64 ASCII characters. |
| name | Yes | Nonblank display text, up to 120 Unicode code points. |
| price | Yes | Whole currency units, from 0 to 9007199254740991. JSON booleans and decimal numbers are rejected. |
| requires | No | Another item ID that must already be owned. Empty CSV cells mean no prerequisite; omit the field in JSON. |
The catalog may contain 1–10,000 items and must fit in 1 MiB of UTF-8 text. UTF-8 BOMs are accepted. Unknown fields, duplicate JSON fields or CSV headers, missing references, self-references and prerequisite cycles fail validation. CSV prices use plain decimal digits, without leading zeros except for zero itself.
--checkvalidates without creating a file.--output path.luaugenerates an array in source order. Each row and the outer table are frozen. References remain ID strings.- A successful command prints an item count and exits 0. Invalid input or a file error prints an explanation to stderr and exits 1. Incorrect CLI usage exits 2.
- The same catalog produces the same output. After validation, the new file replaces the old one in a single operation. Failed validation leaves the old file alone. Missing parent directories are created.
The module holds item data. Your server code still needs to handle purchases, ownership, prerequisites and saving. Changes reach the game when you regenerate and import the file.
Tests cover malformed inputs, reference cycles, Unicode escaping, a long prerequisite chain, CSV/JSON agreement, command exit codes and preserving output on failure. CI also loads a generated module in Lune and checks its values and frozen tables. Live Roblox Studio integration has not been tested.
Tarmac compiles and manages Roblox assets. Flash Config handles item catalog data. Rojo can sync the generated source into Studio.
MIT licensed. See LICENSE.