Chapter Creation System
Relevant source files
The following files were used as context for generating this wiki page:
The Chapter Creation System is a data-driven framework within ChapterMaster that defines the attributes, composition, and visual identity of Space Marine Chapters. It utilizes a structured JSON schema to store comprehensive metadata, ranging from lore-based "flavor" text to technical modifiers that affect gameplay mechanics, unit stats, and fleet composition.
This system allows for both the implementation of canonical chapters and the creation of custom entities by defining a set of core parameters, advantages, and disadvantages. These definitions determine how a chapter interacts with other factions, its starting resources, and its unique combat doctrines.
Data Architecture and Schema
The system is built around a centralized chapter configuration object. Each chapter is identified by a unique ID and contains nested structures for various subsystems such as fleet management, specialist distribution, and visual liveries.
Core Chapter Metadata
Each chapter definition includes fundamental identification and balance parameters:
| Field | Type | Description |
|---|---|---|
id | Integer | Unique identifier for the chapter. |
name | String | The display name of the chapter. |
origin | Integer | Source of the chapter (1: Founding, 2: Successor, 3: Other, 4: Custom). |
points | Integer | Point value used for balance or creation costs. |
founding | Integer | ID of the progenitor chapter. |
fleet_type | Integer | Determines base fleet and location (1: Homeworld, 2: Fleet-based, 3: Penitent). |
Sources: datafiles/main/chapters/37.json:3-13, datafiles/main/chapters/33.json:3-13
The Advantage and Disadvantage Subsystem
The mechanical uniqueness of a chapter is largely derived from its "Advantages" and "Disadvantages". These are external JSON definitions that apply modifiers to the chapter's state.
The diagram shows how chapter-specific JSON files reference central advantage/disadvantage definitions to apply global modifiers.
Sources: datafiles/main/chapter_advantages.json, datafiles/main/chapter_disadvantages.json
Component Systems
Specialist and Marine Composition
The system manages the distribution of personnel through extra_specialists and extra_marines blocks. These fields allow chapters to deviate from the standard Codex Astartes organization. For example, the Deathwatch chapter significantly reduces standard marine counts while increasing specialist roles.
- Specialist Loading: The
load_to_shipsobject controls how veterans and scouts are distributed across companies (e.g.,split_vetsorsplit_scouts). - Role Customization: The
custom_rolesblock allows chapters to rename standard units (e.g., "Apothecary" to "Lifebinder" for Celestial Lions).
Sources: datafiles/main/chapters/33.json:140-180, datafiles/main/chapters/35.json:160-190
Visual Identity and Livery
Chapters define complex color schemes through the colors and complex_livery_data structures.
This diagram illustrates the relationship between the chapter definition and its visual components.
Sources: datafiles/main/chapters/36.json:52-84, datafiles/main/chapters/37.json:53-84
Custom Squad Formations
The custom_squads feature allows chapters to override standard unit configurations with specialized "Kill Teams" or unique formations. This includes defining specific weapon loadouts (wep1, wep2) and mobility items (mobi).
- Loadout Constraints: The system supports "required" items and "optional" pools for squad variety.
- Formation Options: Squads can be tagged with specific doctrines such as
tactical,assault, ordevastator.
Sources: datafiles/main/chapters/33.json:200-500
Faction Interaction and Disposition
Chapters maintain a disposition array that tracks their standing with seven core Imperial and external factions. Modifications to these values are often dictated by advantages like "Tech-Brothers" (Mechanicus boost) or disadvantages like "Suspicious" (Inquisition penalty).
| Index | Faction | Baseline Value Example (Consecrators) |
|---|---|---|
| 2 | Imperium | 50 |
| 3 | Admech | 50 |
| 4 | Inquisition | 50 |
| 5 | Ecclesiarchy | 50 |
| 6 | Astartes | 50 |
Sources: datafiles/main/chapters/37.json:145-154, datafiles/main/chapter_advantages.json:120-130
Summary
The Chapter Creation System provides a modular and extensible method for defining the diverse characteristics of Space Marine Chapters. By separating visual data, mechanical modifiers (advantages/disadvantages), and organizational structure (custom squads/roles), the system enables high fidelity in representing both lore-accurate and player-generated chapters. This architecture ensures that changes to a single JSON definition can propagate throughout the gameplay experience, affecting everything from diplomatic relations to battlefield tactics.