CLI
Commands
Section titled “Commands”dsl init
Section titled “dsl init”Initialize a workspace with configuration files:
dsl init [path] [--preset <preset>] [--force]| Preset | Files Created |
|---|---|
full | appsettings.json, datasheetlang.yml, config/, packages/core/, scripts/ |
minimal | appsettings.json, datasheetlang.yml |
equipment | appsettings.json, config/stat-formulas.yaml, config/gear-tiers.yaml |
sync | appsettings.json, config/sync-config.template.yaml |
Use --force to overwrite existing files.
dsl apply
Section titled “dsl apply”Apply a spec file to a DataSheet folder:
dsl apply <spec.yaml> --path <path> [--verbose]Use --verbose (or -v) to see diagnostic output during import and definition resolution.
dsl validate
Section titled “dsl validate”Validate a spec without writing changes:
dsl validate <spec.yaml> [--path <path>]dsl explain
Section titled “dsl explain”Debug equipment computation for a specific item:
dsl explain <spec.yaml> <item_id> --formulas <stat-formulas.yaml>dsl regenerate equipment
Section titled “dsl regenerate equipment”Bulk-regenerate equipment stats from existing XML:
dsl regenerate equipment --path <data> --tiers <tiers.yaml> --formulas <formulas.yaml>dsl sync
Section titled “dsl sync”Synchronize server XML to client DataCenter format:
dsl sync --config <sync-config.yaml> --alldsl sync -c <sync-config.yaml> -e ItemData -e NpcDataSee Client Sync.
dsl expand
Section titled “dsl expand”Preview YAML after preprocessing (expand all directives):
dsl expand <spec.yaml> [--output <file>]Outputs the preprocessed YAML with $extends and $remove directives fully resolved. Useful for debugging definition inheritance.