HCLW

Hardcore action-RPG on Roblox with server-authoritative combat, real permadeath, and instance-first progression.

Product Stance

• Combat readability matters more than content count.
• Server authority matters more than client spectacle.
• Permadeath only matters if persistence is trustworthy.
• Content scale comes after combat, authority, and save integrity clear their gates.

Current Active Architecture

• src/client: input, prediction, camera, and UI feedback only.
• src/server: authoritative simulation, services, state machines, and future data flow.
• src/shared: immutable config, protocol types, enums, and pure helpers.
• tests: repo OS checks plus subsystem specs used during kernel work.

See docs/repo-structure.md for the current tree and ownership boundaries.

Pre-Alpha Locked Scope

• 1 hub
• 1 arena
• 1 dungeon instance
• 1 two-phase boss
• 2 weapon archetypes
• 3 classes
• 3 lineages
• 8-12 traits
• 1 corruption meter
• 1 complete death and persistence pipeline

W0 Commands

mise install
mise run install
mise run sourcemap
mise run format
mise run lint
mise run test
mise run serve

mise run test runs repo smoke checks plus the deterministic regression suite for blueprint-aligned shared and adapter-backed server modules.

Workflow Docs

• docs/dev-workflow.md
• docs/combat-v2-spec.md
• docs/movement-v2-spec.md
• docs/refactor-map.md
• docs/v2-invariants.md
• docs/test-strategy-v2.md
• docs/task-contract.md
• docs/pr-template.md
• docs/review-checklist.md

License

MIT