Aeonfront Common

Shared deterministic rules, validation and protocol types for 万世战线 Aeonfront.

The package has no browser, database, system-clock or network dependency. Given the same card catalog, front catalog, seed and player actions, it produces the same state and event log. The authoritative server executes these rules; clients consume only player-safe views.

Included systems

• twelve-card deck validation, seeded shuffle and initial draw;
• six turns of increasing military orders and simultaneous plans;
• three unique fronts revealed over the opening turns;
• deterministic initiative and reveal ordering;
• composable multi-ability resolver with 25 lifecycle triggers, 33 conditions, 28 selectors and 44 atomic effects;
• seventy-two compatible weighted fronts with complexity, category, pack and incompatibility metadata;
• stable front artwork keys, focal points and accessible descriptions;
• banner stake changes, withdrawal and final scoring;
• hidden-information player/public views;
• deterministic post-match statistics, highlights, turning points and timeline summaries;
• serialization, action-event replay and replay verification;
• versioned lobby, room, matchmaking and game protocol types with runtime validation.

Commands

npm install
npm run lint
npm run typecheck
npm test
npm run build
npm run validate:fronts
npm run test:replay

Node.js 20 or newer is required. Consumers can import the public API from src/index.ts in a submodule checkout or from the built package entrypoint.

Extending rules

Ability components live in src/abilities/; fronts live in src/fronts.ts. Every effect uses structured arguments, deterministic selection and emitted events. Natural-language card text is presentation data, never executable input. Protocol compatibility is documented in docs/PROTOCOL.md.