feat(ludic.inventory, ludic.wallet): the pack and the purse as mechanic packages
ludic.inventory: counts per item kind, a PackRules port (stack_limit), add what fits / take all or none / set outright, an ItemChanged queue, and a save section keyed by item NAME so a game can reorder its items with no migration. ludic.wallet: earn, spend only what is there, lose down to zero, set, a MoneyChanged queue and its own save section. Six and five test blocks. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
parent
6cfaaf0bf9
commit
8075892e0e
12 changed files with 445 additions and 0 deletions
29
packages/ludic.wallet/README.md
Normal file
29
packages/ludic.wallet/README.md
Normal file
|
|
@ -0,0 +1,29 @@
|
|||
# ludic.wallet
|
||||
|
||||
Money carried, in whole units: earned, spent only when it is there, lost when a cost happens
|
||||
anyway, and every change reported. Uses [`ludic.base`](../ludic.base/README.md) and nothing
|
||||
else. Prices, reputation and what a thing costs are the game's; the wallet only holds the money.
|
||||
|
||||
```ludic
|
||||
import "ludic.wallet"
|
||||
```
|
||||
|
||||
No ports: the wallet asks the world nothing.
|
||||
|
||||
## API
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| `wallet_money()`, `wallet_can(n)` | what is there, and whether `n` is |
|
||||
| `wallet_earn(n)` | add |
|
||||
| `wallet_spend(n) -> bool` | only what is there: false, and nothing spent, when it is not |
|
||||
| `wallet_lose(n)` | a cost that happens whether or not it can be paid (a rescue); never below zero |
|
||||
| `wallet_set(n)` | exactly `n` (a starting purse, a correction, the network's word) |
|
||||
| `wallet_changes() -> Queue<MoneyChanged>` | the facts: `{ before, after }`, one per change |
|
||||
| `wallet_system() -> System` | `"wallet"`, `PH_COMMIT`: reset, and its save section (`wallet_save`, `wallet_load`) |
|
||||
|
||||
## Tests
|
||||
|
||||
```bash
|
||||
ludic build packages/ludic.wallet/tests/wallet_test.ludic --headless -o /tmp/wallet_test && /tmp/wallet_test
|
||||
```
|
||||
Loading…
Add table
Add a link
Reference in a new issue