Skip to content
ArchmageDocs

Brace Flags

Brace flags are the name suffix in curly braces (e.g., {en}, {cn,fr}) used to define field variants. They are designed for mutually exclusive config sets with only minor differences.

Applicable to: field names, section names, and subtable names in spreadsheets; field names in tree-structured data.

Field Variant Activation

Section titled “Field Variant Activation”

A field variant is active only when its brace flags explicitly satisfy the --brace-flags CLI flag.

--brace-flags
not set		 --brace-flags
match
(e.g. en)		 --brace-flags
mismatch
(e.g. cn)
No brace flags (e.g. foo) active active active
foo{en} inactive active inactive
foo{++en} inactive active inactive

An active variant overrides the corresponding unflagged field when present. For example, an active name{en} replaces the base name.

During data export and code generation, Archmage strips {...} from field names. For example, name{en} becomes name.

Examples

Section titled “Examples”
DescPetDefault Gacha RateEN Gacha RateCN Gacha Rate
Namepetraterate{en}rate{cn}
Typestringfloatfloatfloat
1001Dragon0.0150.020.01
1002Phoenix0.060.080.05

See Also

Section titled “See Also”