zero-engine/zero-engine-state.md

# Zero Engine (SLA Industries) — System State Reference

**Last updated:** 2026-06-01  
**System version:** 1.3.0-dev  
**Foundry compatibility:** v13 minimum, verified v14.361  
**World:** SLA_Industries (last played 2026-06-01, ~110 hours playtime)  
**Single source file:** `zero-engine.mjs` (~6500+ lines)

---

## File Map

| Path | Role |
|------|------|
| `system.json` | Manifest — id: `zero-engine`, entry: `zero-engine.mjs` |
| `zero-engine.mjs` | Everything: classes, hooks, data tables, PC/NPC creators |
| `styles/zero-engine.css` | All CSS (~4600+ lines, SLA Borg font family) |
| `blade-runner.css` / `.js` | Legacy Blade Runner skin (not SLA-active) |
| `template.json` | Actor & Item data schemas |
| `lang/en.json` | English localisation strings |
| `templates/actor/character-sheet.hbs` | Primary PC sheet (Mk1) |
| `templates/actor/character-sheet-mk2.hbs` | Mk2 dark sheet variant |
| `templates/actor/npc-sheet.hbs` | NPC sheet |
| `templates/actor/vehicle/vehicle-sheet.hbs` | Vehicle sheet |
| `templates/actor/loot/loot-sheet.hbs` | Loot container sheet |
| `templates/actor/character/` | Modular tab partials (stats, combat, inventory, mods, bio) |
| `templates/components/roll/roll-chatcard.hbs` | Roll result chat card |
| `templates/item/item-sheet.hbs` | Item sheet |
| `packs/armors.json` | 6 armors |
| `packs/drugs.json` | 7 drugs |
| `packs/ebb-formulae.json` | 30 Ebb formulae |
| `packs/specialties.json` | 16 specialties |
| `packs/tables-data.json` | 5 rollable tables (panic, phys crit, mental crit, ranged fail, melee fail) |
| `fonts/SLABorg-*.woff2` | Custom SLA Borg font family (Book, Tech, Title, UI) |
| `assets/icons/ebb/` | 10 Ebb discipline SVG icons |
| `assets/racial/` | 8 racial ability SVG icons |
| `assets/textures/` | Chat card, character sheet, journal background webps |

---

## Actor Types

### `character` (PC)

**Attributes** (base 2 each, rolled as Nd6):
- Strength, Agility, Wits, Empathy

**Skills** (add to attribute for dice pool):
| Skill | Attribute |
|-------|-----------|
| Force, Melee, Stamina | Strength |
| Marksmanship, Mobility, Stealth | Agility |
| Crafting, Observation, Survival | Wits |
| Healing, Insight, Persuasion, Ebb | Empathy |

**Derived Stats:**
- `health` (value/max) — base 3, modified by race/training/armor/drugs/specialties
- `resolve` (value/max) — base 3, modified by race/training/drugs/specialties
- `stress` — scalar 0–10; adds stress dice to all rolls (1s on stress dice = Banes)
- `carryLimit` — base 4
- `broken` — boolean; triggers Broken condition

**Other Fields:**
- `details` — age, height, weight, scl (default 10), credits (default 500)
- `race` — string key (see Races below)
- `training` — array, first entry used as archetype label
- `archetype` — string
- `flux` (value/max) — Ebb resource; max = Ebb skill + 1
- `criticalInjuries` — physical\[\] and mental\[\] arrays
- `panic` — directive string, active boolean
- `vevaphon` — instability (0–12), instabilityMax (12), activeMorphForm
- `finances` — income (salary, bpnReward, other), expenses (accommodation, drugs, subscriptions, other, bulletTax), debt, ammoSpentSession, creditLog\[\]
- `bpn` — code, type (blue/green/red/silver/gold/black), status, reward, description, objectives, notes
- `specialties` / `equipment` / `weapons` — legacy text fields (items are embedded)

**Health/Resolve calculation** (`calculateHealthResolve`):
```
healthMax = 2 + (STR-2) + raceMod + trainingMod + equipmentMod + specialtyMod + drugMod
resolveMax = 2 + (EMP-2) + raceMod + trainingMod + equipmentMod + specialtyMod + drugMod
```
Recalculates on: attribute changes, race change, item add/remove/update, active effect changes.

---

### `npc` (NPC)

Simplified schema: biography, threat (1–5), flat attributes (str/agi/wits/emp), health (value/max), armor (flat number), damage.

---

## Item Types

| Type | Key Fields |
|------|-----------|
| `weapon` | weaponType, category (ranged/melee), damage, range, rof, gearBonus, ap, magazine, ammo, fireModes, autoAmmoUse, ammoType, caliber, roundType, initiativeMod, equipped, ammoEmpty |
| `armor` | armorRating, armorDice, armorAuto, statMod, skillMod, statModTarget, skillModTarget, healthMod, resolveMod, initiativeMod, equipped |
| `equipment` | quantity, cost, weight, isDrug, active, activeDuration, healthMod, resolveMod, statPhysicalMod, skillAllMod, panicReduction, injuryPenaltyIgnore, stressRecoveryBonus, postUseStaminaDamage, withdrawal variants of all mods, per-skill mods, initiativeMod, equipped |
| `ammo` | caliber, roundType, quantity, costPerRound, apBonus, damageMod, blastRadius, weight |
| `specialty` | category, effects, prerequisites, package, healthMod, resolveMod, racialBonuses\[\], isActive |
| `ebb` | discipline, fluxCost, successes, effect, catastrophe, duration, range |

---

## Races

8 playable races, defined in `SLA_RACES`:

| Race | Key | Base Attrs | Attr Points | Skill Points | Health Mod | Resolve Mod | Notes |
|------|-----|------------|-------------|--------------|-----------|------------|-------|
| Human | `human` | 2/2/2/2 | 6 | 10 | 0 | 0 | Caps 5/5/5/5 |
| Ebon | `ebon` | 2/2/3/3 | 4 | 10 | 0 | +1 | Ebb user. Caps 4/4/5/5 |
| Brain Waster | `brainwaster` | 2/2/4/3 | 3 | 10 | 0 | 0 | Ebb user, push risk catastrophe. Caps 3/4/5/5 |
| Stormer 313-S | `stormer` | 4/3/2/2 | 3 | 8 | +2 | 0 | Caps 5/5/3/3 |
| Shaktar | `shaktar` | 3/3/2/2 | 4 | 9 | +1 | 0 | Caps 5/5/4/4 |
| Wraith Raider | `wraithraider` | 2/4/2/2 | 4 | 10 | 0 | +1 | Caps 4/5/5/4 |
| Frother | `frother` | 4/2/2/2 | 4 | 8 | +1 | -1 | Drug Dependency: -1 all rolls when no drug active. Caps 5/4/4/3 |
| Stormer Vevaphon | `vevaphon` | 3/3/2/2 | 5 | 8 | +2 | -1 | Morph forms + Instability. Caps 5/5/4/3 |

**Race-derived derived stats** are applied in `RACE_DERIVED_MODS` and `calculateHealthResolve`. Race change auto-adds racial specialty items via `_ensureRacialAbilities`.

---

## Racial Abilities (auto-embedded on race set)

Each race gets specialty items automatically added to the actor:

| Race | Specialties Added |
|------|------------------|
| Human | Social Versatility (+1 Persuasion, +1 Insight) |
| Ebon | Ebb Sensitive, natural Ebb formulae |
| Brain Waster | Ebb Fury (push = catastrophe risk), natural Ebb formulae |
| Stormer | Regeneration (regen HP on rest) |
| Shaktar | Warrior Caste (+1 Force, +1 Melee), Code of Honor |
| Wraith Raider | Shaper Senses (+2 Stealth, +1 Observation), Cold Adapted |
| Frother | Drug Dependency, Combat Drug User (+2 Force/Melee while drugged), Blade Proficiency |
| Vevaphon | Brute Form, Stalker Form, Raptor Form, Morphic Strike |

---

## Vevaphon Morph Forms

Switching form costs 1 Instability and triggers an automatic instability check roll (1d6 + current instability). Forms are stored as specialty items. `activeMorphForm` key: `none` / `brute` / `stalker` / `raptor`.

| Form | Bonuses | Restriction |
|------|---------|-------------|
| Base (`none`) | Normal stats | — |
| Brute | +2 Health max, knockdown immune, +1 Force, +1 Melee | Cannot be disguised |
| Stalker | +2 Stealth, +1 Agility dice | Cannot wear armour |
| Raptor | +2 Melee, +1 Marksmanship (close range), crits +1 dmg | — |
| Morphic Strike | Natural weapon DMG 2 AP 1 | Always available, all forms |

**Instability table** (roll: 1d6 + instability value, triggers at result ≥ 7):

| Range | Name | Severity |
|-------|------|----------|
| 7 | Flicker | minor |
| 8 | Skin Crawl | minor |
| 9 | Drift | minor |
| 10 | Identity Slip | minor |
| 11 | Voice Shift | minor |
| 12 | Pain Spike (+1 Stress) | moderate |
| 13 | Limb Fault (-2 phys) | moderate |
| 14 | Form Bleed | moderate |
| 15 | Sensory Overload | moderate |
| 16 | Tissue Rejection (1 dmg, no armour) | moderate |
| 17 | Threat Lock | serious |
| 18 | Form Panic (+1 Stress) | serious |
| 19 | Memory Fracture | serious |
| 20 | Partial Collapse (1d3 dmg) | serious |
| 21 | Identity Bleed | serious |
| 22 | Uncontrolled Shift (+1 Instability) | serious |
| 23 | Trauma Response (Shaken) | serious |
| 24 | Permanent Scar | critical |
| 25 | Full Reversion (-1 Instability, revert) | critical |
| 26 | Psychic Scream | critical |
| 27 | Body Horror | critical |
| 28 | Cascade Shift (1d3 dmg, +1 Instab) | critical |
| 29 | Dissolution Risk | critical |
| 30 | Identity Death | catastrophic |
| 31 | Organ Shift (2 dmg/round) | catastrophic |
| 32 | Full System Failure | catastrophic |
| 33 | Catastrophic Cascade (1d6 dmg/round) | catastrophic |
| 34 | Biogenetic Detonation (2d6 self, 1d6 AoE) | catastrophic |
| 35 | Terminal Dissolution | lethal |
| 36+ | Total Collapse (instant death) | lethal |

Auto-effects are applied programmatically (`autoStress`, `autoDamage`, `autoDamageRoll`, `autoInstability`, `revertForm`, `applyCondition`).

---

## Training Packages

8 packages in `SLA_TRAINING`, selected at PC creation:

| Package | Key | Starting Skills | Specialty | Armour |
|---------|-----|-----------------|-----------|--------|
| Soldier | `soldier` | Melee 2, Marksmanship 2, Stamina 1 | Hard Hitter | CAF Armor |
| Scout | `scout` | Stealth 2, Mobility 2, Observation 1 | Fast Reflexes | Scout Armor |
| Combat Medic | `medic` | Healing 2, Insight 1, Observation 2 | Field Surgeon | Downtown Jacket |
| Technical Operative | `tech` | Crafting 3, Observation 1, Survival 1 | Inquisitive | Downtown Jacket |
| Negotiator | `negotiator` | Persuasion 2, Insight 2, Observation 1 | Gut Feeling | Downtown Jacket |
| Hunter | `hunter` | Marksmanship 2, Stealth 2, Observation 1 | Sniper | Scout Armor |
| Brawler | `brawler` | Force 2, Melee 2, Stamina 1 | True Grit | CAF Armor |
| Ebb Channeller | `ebb_user` | Ebb 3, Insight 1, Persuasion 1 | Ebb Sensitive | Downtown Jacket |

Ebb Channeller gives race-differentiated starting formulae:
- **Ebon:** Empathic Pulse, Danger Sense, Mind-Link, Calm, Ebb Shield, Ebb Sight, Surge
- **Brain Waster:** Ebb Bolt, Heat Touch, Surge, Push, Empathic Pulse, Ebb Shield, Iron Flesh

---

## NPC Archetypes

10 archetypes in `SLA_NPC_TYPES` (used by `SLANPCCreator`):

| Archetype | Threat | HP | Armor |
|-----------|--------|----|-------|
| Civilian | 1 | 4 | 0 |
| Gang Grunt | 1 | 5 | 1 |
| Shiver (Patrol) | 2 | 6 | 2 |
| SLA Operative (Green) | 2 | 5 | 2 |
| Carrien | 2 | 7 | 1 |
| SLA Operative (Veteran) | 3 | 8 | 3 |
| Ebb Operative (Ebon) | 3 | 6 | 1 |
| Dept. of Propaganda Agent | 3 | 6 | 2 |
| Dark Finder | 4 | 10 | 4 |
| *(10th not captured in this read)* | — | — | — |

---

## Core Roll Mechanics

### Dice Pool

- Roll **Attribute + Skill** d6s (plus Gear Bonus for weapons)
- **Success** = 6 on any die
- Count total successes (each 6 = 1 success)
- 0 successes = failure

### Stress Dice

- `stress` value adds that many d6s to every roll
- 1s on stress dice = **Banes** (tracked, can trigger panic)
- Stress increases on push; some drugs/drugs-withdrawal affect stress

### Push

- After a failed roll, player may push (re-roll non-6, non-1 dice)
- **Cost:** +1 Stress
- **Brain Wasters:** pushing risks catastrophe result
- Results formatted with `_formatYZEResult` and displayed in chat card

### Armor Check

- Triggered when character takes damage
- Roll **armorDice** d6s, subtract **AP** from dice pool first
- Successes reduce damage 1:1
- `armorAuto` = automatic damage reduction (no roll needed)
- Called via `_promptAndRollArmorCheck` → `_rollArmorCheck`

### Weapon Rolls

- **Ranged:** AGI + Marksmanship + Gear Bonus
- **Melee:** STR + Melee + Gear Bonus
- Fire modes: single, burst, full-auto (different ammo costs)
- `autoAmmoUse`: ammo consumed on full-auto (default 8)
- Bullet Tax auto-applied after session (tracked in `finances.bulletTax`)

### Ebb Rolls

- Roll **EMP + Ebb Skill** d6s
- Need `successes` threshold from formula item
- Flux cost deducted from `flux.value`
- Catastrophe text displayed on roll if applicable
- Disciplines: awareness, blast, communicate, enhance, heal, protect, realityFold, senses, telekinesis, thermal

---

## Conditions (SLA_CONDITIONS)

14 registered status effects, auto-applied via `applyCondition` or Token HUD:

| ID | Label | Penalty |
|----|-------|---------|
| `sla-bleeding` | Bleeding | -1 HP/turn |
| `sla-stunned` | Stunned | -3 all dice, clears end of turn |
| `sla-pinned` | Pinned | -2 melee/marksmanship/mobility |
| `sla-suppressed` | Suppressed | -2 all dice |
| `sla-on-fire` | On Fire | -2+ HP/turn (escalating), -1 all dice |
| `sla-blinded` | Blinded | -3 ranged/observation, -2 melee |
| `sla-deafened` | Deafened | -1 observation |
| `sla-broken` | Broken | -2 all dice, must roll Stamina to act |
| `sla-winded` | Winded | -1 all dice, clears end of round |
| `sla-broken-arm` | Broken Arm | -2 Melee, -1 Marksmanship, -1 Force |
| `sla-broken-leg` | Broken Leg | -2 Mobility, -1 Stealth |
| `sla-concussed` | Concussed | -1 all, extra -1 Observation/Wits |
| `sla-gut-wound` | Gut Wound | -2 all dice |
| `sla-panicking` | Panicking | -2 all dice, cannot act normally |
| `sla-shaken` | Shaken | -1 all dice |

Condition dice penalties are applied via `_getConditionModifiers(actor, {skill, attribute})` and reflected in every roll.

---

## Tables (tables-data.json)

| Table | Formula |
|-------|---------|
| Panic | 1d6 + Stress |
| Physical Critical | 1d66 |
| Mental Critical | 1d66 |
| Ranged Critical Fail | 1d6 |
| Melee Critical Fail | 1d6 |

---

## Equipment Packs

### Armors (6)

| Name | AR | Dice | Auto |
|------|----|------|------|
| Downtown Jacket | 1 | 1 | 0 |
| CAF Armor | 2 | 2 | 1 |
| Scout Armor | 3 | 3 | 1 |
| HARD Armor | 4 | 4 | 2 |
| Exo-Rig Armor | 5 | 5 | 2 |
| Squad Shielded Power Armor | 6 | 6 | 3 |

### Drugs (7)

| Name | HP | Resolve | Str | Panic Red |
|------|----|---------|----|-----------|
| Painkillers | 0 | +1 | 0 | 0 |
| Stimulant | 0 | +1 | +1 | 0 |
| Sedative | 0 | +2 | 0 | 0 |
| Redline | +1 | -2 | +2 | 0 |
| Calm-Line | 0 | +2 | 0 | +2 |
| Rush | +1 | -1 | +1 | 0 |
| UV (Ultra-Violence) | +2 | -3 | +2 | 0 |

All drugs track active/withdrawal states with separate modifier sets.

### Specialties (16 in system pack)

Categories: combat, investigation, social, medical, ebb, racial, survival

| Name | Category | Package |
|------|----------|---------|
| Sniper | combat | Scout |
| Fast Reflexes | combat | Scout |
| Inquisitive | investigation | Investigator |
| Gut Feeling | investigation | Investigator |
| Hard Hitter | combat | Frother |
| True Grit | survival | Frother |
| Menacing | social | Corporate |
| Compassion | social | Corporate |
| Field Surgeon | medical | Medic |
| Healer | medical | Medic |
| Ebb Sensitive | ebb | Ebon - Any |
| Ebb Fury | ebb | Brain Waster - Operative |
| Code of Honor | racial | Shaktar |
| Cold Adapted | racial | Wraith Raider |
| Regeneration | racial | Stormer |
| Combat Drug User | racial | Frother |

### Ebb Formulae (30)

| Discipline | Formulae |
|-----------|---------|
| Awareness | Empathic Pulse (1), Precognition (2), Danger Sense (2) |
| Blast | Ebb Bolt (1), Hellfire (2), Ebb Storm (3) |
| Communicate | Mind-Link (1), Broadcast (2), Compel (2) |
| Enhance | Surge (1), Iron Flesh (2), Heightened State (3) |
| Heal | Mend (1), Restore (2), Calm (1) |
| Protect | Ebb Shield (1), Ward (2), Phase Shell (3) |
| RealityFold | Blink (2), Fold Space (3), Phase Through (3) |
| Senses | Ebb Sight (1), Mind's Eye (1), Remote View (2) |
| Telekinesis | Push (1), Grip (2), Levitate (2) |
| Thermal | Heat Touch (1), Flame Burst (2), Freeze (2) |

*(Numbers in parentheses = Flux cost)*

---

## Sheets

### Registered Sheets

| Class | Type | Label | Default |
|-------|------|-------|---------|
| `ZeroEngineActorSheet` | character + npc | Zero Engine Character Sheet | Yes |
| `ZeroEngineActorSheetMk2` | character only | Zero Engine — Mk2 (Dark) | No |
| `ZeroEngineItemSheet` | all items | Zero Engine Item Sheet | Yes |

### Mk1 Sheet Tabs (character-sheet.hbs)

Stats, Combat, Inventory, Mods, Bio — via `templates/actor/character/sheet-tabs/`

### Mk2 Sheet (ZeroEngineActorSheetMk2)

Dark-themed variant extending `ZeroEngineActorSheet`. Uses `character-sheet-mk2.hbs`. Full SLA Borg font/dark palette.

---

## PC Creator Wizard (`SLAPCCreator`)

Multi-step Application launched from Actor Directory. Steps:
1. Choose race (8 options with flavor text)
2. Allocate attribute points (race-specific pool and caps)
3. Choose training package (some race-restricted, e.g. Ebb Channeller = Ebon/Brain Waster only)
4. Allocate skill points (race-specific pool, cap 3)
5. Random name generation (race-keyed name tables)
6. Confirm & create actor with all embedded items

Racial abilities auto-embedded via `_ensureRacialAbilities` on actor creation when race is set.

---

## NPC Creator (`SLANPCCreator`)

Two modes: **Quick** (pick archetype, auto-fill stats) and **Full** (manual stat entry). Generates NPC actor with appropriate weapons, armor, and attributes.

---

## Hooks Registered

| Hook | Purpose |
|------|---------|
| `init` | Register sheets, Handlebars helpers, SLA conditions setup trigger |
| `setup` | Register `SLA_CONDITIONS` as Foundry status effects |
| `ready` (×3) | DiceSoNice skin, PC creator button in Actor Directory, world clock |
| `createCombatant` | Auto-initiative handling |
| `renderCombatTracker` | Custom combat UI additions |
| `diceSoNiceReady` | Register custom SLA Borg d6 dice skin |
| `renderChatMessageHTML` | Post-roll push buttons, apply damage buttons |
| `preUpdateActor` | Guard recalc triggers |
| `createActor` | Auto-derive stats + racial abilities |
| `updateActor` (×2) | Recalc derived stats; handle race change → racial abilities |
| `createItem` / `updateItem` / `deleteItem` | Recalc derived stats (armor/drug/specialty mods) |
| `createActiveEffect` / `updateActiveEffect` / `deleteActiveEffect` | Recalc derived stats |
| `renderActorDirectory` | Inject "New SLA Operative" PC creator button |
| `updateWorldTime` | Shift Ledger world clock integration |
| `combatTurnChange` | Per-turn condition ticks (bleeding, on fire, etc.) |
| `renderTokenHUD` | Condition toggle buttons in token HUD |
| `pauseGame` | Custom SLA pause animation |

---

## Modules

All modules are standalone FormApplication/Application classes targeting the `zero-engine` system.

### sla-bpn-dispatch (v0.3.0)

Generates random BPN briefings using SLA mission colour logic (blue/green/red/silver/gold/black). Builds contact name, objectives, scenario frame, reward package. Creates GM debrief journal entry. Integrated into Actor Directory.

### sla-briefing-desk (v0.1.0)

Mission briefing composer. Draft saved to world settings. Renders HTML briefing and creates journal entry. Adds button to Journal Directory.

### sla-gear-cache (v0.1.0)

Generates ammo caches, med packs, breach kits, requisition bundles. Adds generated items directly to selected actor. Adds button to Actor Directory.

### sla-npc-director (v0.1.0)

Tracks NPC morale, suppression, stance, and intent. Reads from current combatants or selected tokens. Saves state to world settings. Accessible from Combat Tracker, Actor Directory, and Settings.

### sla-ops-clock (v0.1.0)

Tracks mission tempo: operation clock, heat, collateral, pressure. Posts player-facing updates to chat. State saved to world settings. Adds button to Scene Directory.

### sla-shift-ledger (v0.2.0)

Full campaign time tracker. Manages: day/week/shift progression, actor duty schedules, housing tiers (with weekly cost calculation), living cost ledger. `SlaCampaignClockApp` application. Integrates with `updateWorldTime` hook.

---

## World Compendium Packs (SLA_Industries world)

| Pack Name | Type | Contents |
|-----------|------|----------|
| `specialities` | Item | World-level specialty items (LevelDB) |
| `sla-specialties` | Item | SLA specialty items (LevelDB) |
| `sla-weapons` | Item | SLA weapon items (LevelDB) |

---

## Known Issues / Notes for Development

- `template.json` still lists `vehicle` as an actor type in world notes but is not in the schema `types` array — vehicle sheet exists as a template but is not formally registered as an actor type.
- Ebb `flux.max` is computed dynamically (Ebb skill + 1) rather than stored; `flux.value` is stored.
- `race` field is typed as `Array` in `template.json` but consumed as a string throughout the code (`race[0]` with fallback). This is a legacy inconsistency.
- Bullet Tax tracks `ammoSpentSession` on the actor and applies costs at rest.
- `blade-runner.css` / `blade-runner.js` are present but not loaded — legacy files from the base YZE system.
- `lang/` contains de, en, es, fr, ko, pl — only en is actively maintained for SLA content.
- DiceSoNice skin registered as `sla-borg-d6` using custom SFX config at `assets/plugins/dice-so-nice/`.