Superheader
Superheader defines the schema of the header region. It consists of multiple labels, each configuring one aspect of that schema — description, name, data type, and more. Superheader appears in both Regular Tables and Property Sheets.
Supported labels vary by spreadsheet type.
| Label | Regular Table | Property Sheet |
|---|---|---|
| Description / Name / Type | ✓ | ✓ |
| Subtable Description / Name / Type | ✓ | |
| Options | ✓ | ✓ |
| Enabled | ✓ | ✓ |
| Section | ✓ | ✓ |
| Case | ✓ |
Required Labels
Section titled “Required Labels”Every superheader must contain these three labels.
| Label | Description |
|---|---|
| Description | A human-readable description with no functional effect on data export or code generation. Use - when no description is needed. Can be abbreviated as Desc. |
| Name | The identifier used in exported data and generated code; changing it affects all downstream output. |
| Type | The data type and its default export value, e.g., int=/, where / represents the type’s zero value. |
Subtable Labels
Section titled “Subtable Labels”Subtable labels permit subtable definitions within a regular table. They are required only when the sheet uses a Subtable Type.
| Label | Description |
|---|---|
| Subtable Description | A human-readable description with no functional effect on data export or code generation. Use - when no description is needed. Can be abbreviated as Subtable Desc. |
| Subtable Name | The identifier used in exported data and generated code; changing it affects all downstream output. |
| Subtable Type | The subtable’s data type and its default export value, e.g., **[]=/. |
Optional Labels
Section titled “Optional Labels”Options
Section titled “Options”Options hold settings for filtering, validation, export behavior, and code generation.
See Options Overview for more information.
Enabled
Section titled “Enabled”Enabled controls the inclusion of a column in regular tables, or a row in property sheets.
| Cell value | Effect |
|---|---|
| (blank) | Included |
1, T, TRUE |
Included |
0, F, FALSE |
Skipped |
↷ |
Skipped |
env@VAR |
Reads VAR from the environment; skipped when the variableis unset or falsy |
Section
Section titled “Section”Section acts as a prefix to Name. Together they form the full name Section.Name.
Case assigns one or more case labels to a field and works together with the switch type. Within a config entry, a field is active only when the entry’s switch value matches one of the field’s case labels. A field with no case label stays active regardless of the switch value.
Syntax: a single case label, or several separated by |:
meleemelee | magicmelee | magic | rangedDotted Names
Section titled “Dotted Names”Name, Section, and Subtable Name all accept dotted names. See Dotted Names for details.
Label Resolution
Section titled “Label Resolution”Archmage matches superheader labels case-insensitively and ignores spaces. Name, NAME, and name are equivalent.
Multi-line cells match per line; any matching line qualifies.