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¶
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¶
TL;DR
Crafting runs the jobs.
You own everything around it.