🛠️ Crafting — System Guarantees Matrix
This page defines the behavioural contract of the Crafting system.
No marketing. No implication. Just guarantees — and explicit
non-guarantees.
🔎 Quick Navigation
- Core Service
- Preflight
- Accept / Enqueue
- Jobs / Scheduling
- Delivery
- Refunds / Compensation
- Escrow Path
- Authority
- Time / Offline Progress
- Persistence / Restore
- Events
- Modifiers / Validators
- Routing
- Determinism / RNG
- Public API
- Non‑Guarantees
- Final Summary
1️⃣ Core Service
CraftingServiceCore
| Aspect |
Guarantee |
| Orchestration root |
✔ Single service owns crafting truth |
| Job creation |
✔ Service-only |
| Job mutation |
✔ Service-only |
| Runtime usage |
Main thread |
| Adapter-driven |
✔ Yes |
| Inspector required |
❌ No |
| UI required |
❌ No |
2️⃣ Preflight
| Aspect |
Guarantee |
| Mutates state |
❌ Never |
| Safe for UI / tools / teachables |
✔ Yes |
| Check order |
Inputs → Currency → Space |
| Validators run |
✔ Only after core checks succeed |
| No-space override via validator |
❌ Not guaranteed |
| Routing included in space check |
✔ Yes |
| Chance-output space policy applied |
✔ Yes |
3️⃣ Accept / Enqueue
| Aspect |
Guarantee |
| Authority checked before mutation |
✔ Yes |
| Inputs consumed immediately (default path) |
✔ Yes |
| Currency debited immediately (default path) |
✔ Yes |
| Job created only after accept succeeds |
✔ Yes |
| Partial failure compensation |
✔ Best-effort |
| Batch support |
✔ Yes |
| Timed craft support |
✔ Yes |
| Cross-system atomicity |
❌ Not guaranteed |
4️⃣ Jobs / Scheduling
| Aspect |
Guarantee |
| Queued jobs supported |
✔ Yes |
| Running jobs supported |
✔ Yes |
| Paused jobs supported |
✔ Yes |
| Per-station caps |
✔ Yes |
| Global parallel cap |
✔ Yes |
| Queue reorder support |
✔ MoveQueuedFirst |
| Scheduler fairness |
Basic fairness |
| Deterministic scheduling across external state changes |
❌ Not guaranteed |
5️⃣ Delivery
| Aspect |
Guarantee |
| Modifiers re-evaluated at delivery |
✔ Yes |
| Output routing resolved at delivery |
✔ Yes |
| Outputs added immediately on success |
✔ Yes |
| Delivery failure possible after accept |
✔ Yes |
| Timed jobs deliver later |
✔ Yes |
| Delivery atomicity (default path) |
❌ Not guaranteed |
6️⃣ Refunds / Compensation
| Aspect |
Guarantee |
| Currency refund on delivery failure |
✔ Attempted |
| Input refund on delivery failure |
Optional |
| Input refund success |
Best-effort |
| Currency refund success |
Depends on adapter |
| Refunds outside service |
❌ Not supported |
| Net-zero guarantee |
❌ Not guaranteed |
7️⃣ Escrow Path
| Aspect |
Guarantee |
| Scope |
Immediate (zero-duration) crafts |
| Job created |
❌ No |
| Inventory reservations required |
✔ Yes |
| Currency holds required |
✔ Yes |
| Routing used |
❌ No |
| Timed crafts supported |
❌ No |
| Refuses missing escrow seams |
✔ Yes |
| Atomicity |
Depends on adapter |
8️⃣ Authority
| Aspect |
Guarantee |
| Mutation gating supported |
✔ Yes |
| Enqueue gated |
✔ Yes |
| Cancel / Pause / Resume gated |
✔ Yes |
| Scheduler control gating |
Optional |
| Read queries gated |
❌ No |
| Multiplayer replication |
❌ Not provided |
9️⃣ Time / Offline Progress
| Aspect |
Guarantee |
| Gameplay time abstraction |
✔ ITimeProvider |
| Wall-clock abstraction |
✔ IWallClockProvider |
| Offline progress optional |
✔ Yes |
| Paused jobs tick offline |
❌ Never |
| Offline elapsed cap |
Optional |
| acceptedAtUtc captured |
✔ Yes |
🔟 Persistence / Restore
| Aspect |
Guarantee |
| Snapshot type |
Active jobs |
| Queued jobs restorable |
✔ Yes |
| Running jobs restorable |
✔ Yes |
| Paused jobs restorable |
✔ Yes |
| Inputs/currency re-consumed on restore |
❌ No |
| Offline completion applied during restore |
✔ When enabled |
| Idempotent completion across repeated restore |
❌ Not guaranteed (integration-dependent) |
| Save system provided |
❌ Not provided |
| Persistence storage (files/cloud) |
❌ Not provided |
| Save/restore timing responsibility |
Developer-defined |
Crafting defines what job data means and how it resumes —
your game defines when, where, and how it is persisted.
11️⃣ Events
| Aspect |
Guarantee |
| Lifecycle events exposed |
✔ Yes |
| Progress events throttled |
✔ Yes |
| Preflight rejection event |
✔ Yes |
| Designer UnityEvent mirrors |
✔ Yes |
12️⃣ Modifiers / Validators
| Aspect |
Guarantee |
| Modifiers supported |
✔ Yes |
| Validators supported |
✔ Yes |
| Owner/parent discovery |
✔ Yes |
| Modifiers run at accept |
✔ Yes |
| Modifiers run at delivery |
✔ Yes |
| Validators mutate state |
❌ Never |
| Modifier/validator ordering contract |
❌ Not guaranteed |
13️⃣ Routing
| Aspect |
Guarantee |
| Output router supported |
✔ Yes |
| Routing used in preflight |
✔ Yes |
| Routing used at delivery |
✔ Yes |
| Router auto-discovered |
❌ No |
| Router used by escrow |
❌ No |
14️⃣ Determinism / RNG
| Aspect |
Guarantee |
| Deterministic RNG supported |
✔ Yes |
| Seeded results repeat with same call sequence |
✔ Yes |
| Binomial approximation deterministic |
❌ No |
| Exact chance rolls available |
✔ Yes |
| Identical results if call order changes |
❌ Not guaranteed |
15️⃣ Public API
| Aspect |
Guarantee |
| Stable supported service surface |
✔ Yes |
| Public recipe construction seam |
✔ RecipeCore.Create |
| Public adapter seams |
✔ Yes |
| Internal hooks public |
❌ No |
| Integration adapters public |
❌ No |
🚨 Non‑Guarantees
Crafting does not guarantee:
🎯 Final Summary
| Layer |
Strong Guarantee |
Best Effort |
Not Guaranteed |
| Preflight purity |
✔ |
|
|
| Single-service job ownership |
✔ |
|
|
| Default-path compensation |
|
✔ |
|
| Escrow immediate craft |
✔* |
|
|
| Timed craft delivery atomicity |
|
|
❌ |
| Multiplayer replication |
|
|
❌ |
| Cross-system atomicity |
|
|
❌ |
| Persistence integration |
|
|
❌ |
*Depends on reservation/hold adapter correctness.
System Philosophy
Crafting is:
- Explicit
- Job-driven
- Adapter-based
- Authority-aware
- Honest about guarantees