π§ Crafting β What This System Does (and Doesnβt Do)¶
This page explains what the Crafting system is responsible for and what is intentionally left to you.
No code. No implementation details. Just boundaries.
β What Crafting does¶
Crafting is responsible for:
- Turning recipes into jobs
- Running those jobs over time
- Handling preflight checks (inputs, currency, space, validators)
- Managing job lifecycle (queued β running β completed / failed / cancelled)
- Applying modifiers and routing
- Handling refunds and compensation (best-effort, adapter-dependent)
- Supporting offline job progression and restore-time reconciliation
- Providing snapshots of active jobs for persistence systems
- Emitting events for UI and gameplay systems
π In short:
Crafting owns the execution lifecycle of crafting jobs
β What Crafting does not do¶
Crafting intentionally does not provide:
Persistence¶
- No save files
- No cloud sync
- No automatic save/load
You must decide:
- when to save
- where data is stored
- when to restore
Networking¶
- No replication
- No prediction
- No rollback or reconciliation
You must implement:
- server authority
- state sync
- multiplayer behaviour
Authority Rules¶
- No built-in multiplayer or gameplay authority rules
Crafting supports authority via interfaces, but:
π You define the rules
Game Systems¶
- No inventory system
- No currency system
- No progression system
- No UI
Crafting connects to these systems via adapters.
π§ Responsibility Split¶
| Responsibility | Owner |
|---|---|
| Craft execution | Crafting |
| Job lifecycle | Crafting |
| Offline progression | Crafting |
| Save/load system | You |
| Networking | You |
| Authority rules | You |
| UI / UX | You |
π§© The Mental Shortcut¶
If youβre ever unsure:
- βWhat happens during a craft?β β Crafting
- βWhen and where is data stored?β β You
- βWho is allowed to craft?β β You
- βHow is it shown to the player?β β You
π― The Point¶
Crafting is designed to be:
- Predictable
- Modular
- Explicit
It gives you:
π a reliable execution engine
It does not try to be:
π your entire game
TL;DR¶
Crafting runs the jobs.
You own everything around it.