💰 Currency — Sample Scenes¶
These scenes demonstrate the Currency System in isolation using small, focused setups.
Each scene is driven by a corresponding Teachable Panel, which shows how to use the system through the public API.
🎯 What These Scenes Are¶
- Working examples of specific behaviours (caps, exchange, escrow, etc.)
- Teachable-driven demos — panels show how to interact with the system
- Single-player setups using permissive authority for clarity
⚠️ What These Scenes Are Not¶
- Not production-ready game logic
- Not multiplayer implementations
- Not a complete economy system
They are reference setups, not drop-in solutions.
🧩 Scenes¶
| Scene | Description |
|---|---|
| 00 • Currency Basics | Core wallet operations and results |
| 01 • Policy Caps | Min/max rules and clamp/fail behaviour |
| 02 • Exchange | Currency conversion via exchange tables |
| 03 • Persistence | Save/load and audit inspection |
| 04 • UI Bars | UI binding via wallet events |
| 05 • Escrow | Holds, release, and expiry |
| 06 • Idempotency | Retry-safe operations using RIDs |
| 07 • Batch & Transactions | Atomic multi-operation commits |
| 08 • Awaiters | Event-driven waiting (no polling) |
🧠 How to Use These¶
- Start with 00_Currency_Basics
- Move forward based on what you need
- Use the panels as copy-paste references
- Ignore anything you don’t need — each scene is isolated
💡 Key Principle¶
You don’t need to understand everything here.
Each system works independently —
use only what your project needs.