Files
aeternalis/docs/MILESTONE-2.md
T

6.8 KiB

Milestone 2: content and input foundations

Implemented for manual testing. Model rigs, equipment attachments, animations, and sound hooks remain in milestone 4.5. Playwright authoring/runs remain deferred.

Available in Control -> Content

  • Requirement sets: immutable named collections of up to eight integer thresholds. Titles support existing achievement/stat metrics; equipment accepts sets containing only level/stat thresholds. Existing title prerequisites on equipment remain available separately.
  • Effect sets: immutable named collections of signed flat/percentage stat modifiers. These are the first reusable effect building blocks; timed damage, healing, auras, and spell behavior arrive with their later systems.
  • Composition: title/equipment drafts can select up to eight sets of each kind and include inline values. Repeated thresholds resolve to the highest value; modifiers add using the existing stat formula. The final result still obeys title/item limits. Unsupported equipment metrics fail server validation.
  • Preview changes: validates and shows the resolved definition against the draft's catalog version. It does not publish, increment the version, create items/awards, or write an audit event. Form edits clear the previous preview.
  • Publish changes: repeats the same content validation under the existing catalog lock and writes the catalog version and audit atomically. Stale editors, missing sets, mixed payloads, unsupported values, and repeated references are rejected. Identical publication retries return the original result.

Sets are expanded into concrete values at publication, not stored as live links on acquired gear or earned titles. Published definitions/sets are append-only: use a new definition for a variation; its ID is assigned by the server. Sets cannot reference other sets, so recursive composition is not supported. Old catalogs without these collections remain valid. No new table or title-ownership migration is required for this milestone.

Server implementations: content/library.go, store/catalog_preview.go, and the existing catalog publication path. Shared content API models are generated from schemas/protocol.json alongside the unchanged gameplay intent/snapshot shapes. The read-only preview uses authenticated same-origin POST /api/control/catalog/preview with the same draft body as publication.

Follow-up: automatic IDs and dark mode

Content creation asks for names and properties only. The server assigns a random permanent ID when publishing a title, item, requirement set, or effect set. Preview does not reserve or display an ID. The audit stores the assigned identity, and an identical request retry returns that same ID, including after restart. Public API creation rejects client-supplied definition IDs. Existing catalog IDs/references and trusted seed/import paths remain compatible. The hidden request UUID is only an idempotency token, not a user-selected content identity.

The website and Control have a Dark mode toggle in their headers. The default follows the device preference; choosing light/dark saves the preference for both pages and syncs across tabs. Theme applies to forms, tables, dialogs, status badges, stat breakdowns, and content previews. Gameplay rendering is unchanged.

Input and menus

Keyboard and movement buttons feed named input actions rather than duplicating gameplay dispatch. Existing bindings remain: WASD/arrows move, E gathers, Space attacks, and I opens inventory. Controller support and rebinding UI arrive later.

Esc closes one focused menu: game inventory/settings, Control character/command dialogs, or the content draft. With multiple panels open, only the focused/most recent menu closes. Focus returns to its opener where available. Esc works while editing a field and does not trigger an underlying game action.

Opening a game menu stops movement/auto-approach; typing in fields cannot move or attack. Key release, pointer capture loss, tab hiding, and window blur clear held movement. Closing a draft discards unsaved edits; closing while a request is in flight does not cancel that submitted request. Publication results still appear in the catalog/audit. Arrival/death/disconnect screens retain their existing flows.

Manual test checklist

Use recognizable test names; the server creates IDs. Published test content cannot currently be deleted.

  1. In Control -> Content -> Requirement sets, name a set M2 Level with level >= 1. Fill a reason, preview, and confirm the catalog version/audit has not changed. Publish; refresh and confirm the new set and one audit/version increment.
  2. Create effect set M2 Defence with defence +2 flat and movement speed -5%. Preview/publish it. Create a ring with those two sets, drop chance 0, and any inline modifiers you want to inspect. Preview shows the expanded requirements and effects. Publish and confirm the equipment list contains the same values.
  3. Use Control -> Characters -> Manage items and titles to give the ring to a living character. Equip/unequip it in game and inspect the final stat breakdown. Confirm existing inventory, titles, health, and daily usage were not reset.
  4. Confirm there is no permanent-ID input and publication shows an assigned ID in the catalog/audit. For stale editing, open drafts in two Control tabs, publish one, then preview/ publish the other: expect a refresh conflict, not silent overwriting.
  5. Open inventory and settings together. Focus a settings field and press Esc: settings closes, inventory stays open. Press Esc again: inventory closes. Repeat in a Control draft and a character/command dialog; only that menu closes.
  6. Move with WASD/arrows and the on-screen controls, gather with E, attack with Space. Opening a menu or switching tabs stops movement. Typing in fields must not move/attack; returning focus must not leave a movement key stuck.
  7. Toggle dark mode on the public site, open Control, and reload. Confirm the choice persists and that dialogs, fields, stat rows, and badges remain readable. Switch back to light mode and check that both pages follow the new preference.

Verification and limits

Required verification: TypeScript check, production build, generated-contract freshness, and Go tests. Added server tests cover preview non-mutation, composed publication parity, reference validation, retry identity, immutable IDs, restart persistence, and anonymous/player/cross-origin/strict-JSON boundaries. Existing lifecycle tests remain in the full Go suite. PostgreSQL-specific tests require TEST_DATABASE_URL; no new capacity/load claim is made.

Manual browser testing is the user's handoff; automated Playwright was not run. This milestone does not activate resurrection, hub travel, character-title migration, new resource/mob definitions, or model/animation/audio systems. Pause after commit/push for feedback before milestone 3.