Content · Reference Engine Constants & Tokens

Numbers, Configs & Design Tokens

Every balance parameter in Diamond Decks is exposed as a configurable knob in the GDScript engine, allowing the automated Monte Carlo test harness to sweep balance distributions. These are the shipped values.

src/engine/rules_config.gd · src/engine/rogue_config.gd · src/ui/dd_theme.gd

RulesConfig — Core Match Engine

Configuration Key	Shipped Default	Behavior & Purpose

RogueConfig — Roguelike Run Configuration

Configuration Key	Default (v6 → v7)	Behavior & Purpose

v7 Coherent Preset Package

ruleset              = "v7"
rally_mode           = "rally"            # D44: outs halve the streak instead of resetting to 1
coverage_conditional = true               # D31: weight reward pool only while basic is missing
burn_mode            = "protect_coverage" # D30: protect the last card of a live quadrant
stage_mill_mode      = "scratch"          # D48: 8-card Scratch replaces blind mill
fans_per_stage       = 12                 # D63: increased fan payout for stage clear
arm_sign_cost        = 16                 # D63: adjusted reliever signing fee

Design System Tokens (src/ui/dd_theme.gd)

Sampled directly from reference mockups in gauntlet/ref/ at 1920×1080 resolution:

Sampled Palette Hexes

Token	Hex Value	Usage

Geometry Measurements

Constant	Measured Value	Visual Meaning

Automated Verification & Simulation Harness

Harness Script	Execution Mode	Validation Goal
`./test.sh`	Headless GDScript	Runs unit tests, card integrity assertions, and parity fixture checks.
`./sim.sh`	Headless Simulation	Simulates 1000 AI vs AI games across multiple seeds to verify balance distributions.
`tests/ui_shot_match.gd`	Rendered (Off-Screen)	Walks game state to every human prompt and captures 1920×1080 UI screenshots.
`tests/sim_rogue.gd`	Headless Simulation	Validates roguelike target scaling, character rally scaling, and bullpen survival.

Known Documentation vs Engine Divergences

Topic	GDD Documentation	Engine Implementation	Authoritative Resolution
Spent-Arm Threshold	Below 8 cards	`arm_spent_threshold = 11`	Engine is correct. 8 cards eliminated the attrition clock (average runs exceeded 12 stages).
Long Man Deck Size	12-card deck	13 cards	Engine is correct. 13 cards provides Act 1 survivability against opening setbacks.
Roguelike Hand Size	5 cards in early draft	`ROGUE_HAND_SIZE = 6`	Engine is correct. 6 cards compensates for the lack of a pre-half allocation phase.