Schema

A project root and each included schema module may use SCON, TOML, YAML, JSON, or Lua. SCON is recommended for new files.

project { id = "game_config" }
includes = ["schema/items.scon", "schema/skills.scon"]

Every file is first parsed into a format-specific keyed representation and then lowered to a format-independent schema module. The root must declare project; included modules must not declare root-only project, groups, views, codegen, or localization. Includes may cross formats and are loaded recursively in declaration order, with cycle, duplicate-module, and duplicate-declaration checks.

Declaration names are keys and are not repeated inside bodies. Unknown properties are rejected.

Namespaces and Imports

Each module may declare a logical namespace and aliases for other namespaces:

namespace = "game.items"
imports {
  common = "game.common"
}

structs {
  Drop {
    fields {
      reward = "struct<common.Reward>"
    }
  }
}

Declarations stay local in the source file: Drop above has the canonical name game.items.Drop. An unqualified reference such as struct<Cost> resolves in the current namespace, an alias-qualified reference such as common.Reward expands through imports, and any other dotted reference is an absolute project-qualified name. ref<items.Item.id> treats the final segment as the field and everything before it as the table name.

Namespace, import-alias, and declaration segments must be ASCII identifiers. The empty namespace is the project root namespace. Canonical qualified names are used by validation, schema locks, fingerprints, bundles, and runtime table lookup.

Enums

enums {
  ItemType = ["Weapon", "Armor", "Material"]
}

Enums keep their value order and are stored symbolically in editable data.

Structs

structs {
  Cost {
    fields {
      gold = "i32"
    }
  }
}

Struct fields preserve author order and model reusable nested values.

Unions

unions {
  RewardAction {
    tag = "type"
    variants {
      AddItem {
        fields {
          item_id = "ref<Item.id>"
        }
      }
    }
  }
}

Union variants preserve author order. tag is the discriminator used in source and runtime values.

Tables

tables {
  Item {
    mode = "map"
    key = "id"
    source {
      format = "xlsx"
      file = "Item.xlsx"
      sheet = "Item"
    }
    fields {
      id = "i32"
    }
  }
}

See Schema Formats for equivalent natural forms in all five frontends, Tables for sources and indexes, Types for field types, and Cell Parsers for compact cell encodings.