Skip to content

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

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 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., **[]=/.

Options hold settings for filtering, validation, export behavior, and code generation.

See Options Overview for more information.

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 variable
is unset or falsy

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 |:

melee
melee | magic
melee | magic | ranged

Name, Section, and Subtable Name all accept dotted names. See Dotted Names for details.

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.