82 lines
2.9 KiB
Markdown
82 lines
2.9 KiB
Markdown
# Bezalel Evennia World
|
|
|
|
Issue: `timmy-home#536`
|
|
|
|
This is the themed-room world plan and build scaffold for Bezalel, the forge-and-testbed wizard.
|
|
|
|
## Rooms
|
|
|
|
| Room | Description focus | Core connections |
|
|
|------|-------------------|------------------|
|
|
| Limbo | the threshold between houses | Gatehouse |
|
|
| Gatehouse | guarded entry, travel runes, proof before trust | Limbo, Great Hall, The Portal Room |
|
|
| Great Hall | three-house maps, reports, shared table | Gatehouse, The Library of Bezalel, The Observatory, The Workshop |
|
|
| The Library of Bezalel | manuals, bridge schematics, technical memory | Great Hall |
|
|
| The Observatory | long-range signals toward Mac, VPS, and the wider net | Great Hall |
|
|
| The Workshop | forge + workbench, plans turned into working form | Great Hall, The Server Room, The Garden of Code |
|
|
| The Server Room | humming racks, heartbeat of the house | The Workshop |
|
|
| The Garden of Code | contemplative grove where ideas root before implementation | The Workshop |
|
|
| The Portal Room | three shimmering doorways aimed at Mac, VPS, and the net | Gatehouse |
|
|
|
|
## Characters
|
|
|
|
| Character | Role | Starting room |
|
|
|-----------|------|---------------|
|
|
| Timmy | quiet builder and observer | Gatehouse |
|
|
| Bezalel | forge-and-testbed wizard | The Workshop |
|
|
| Marcus | old man with kind eyes, human warmth in the system | The Garden of Code |
|
|
| Kimi | scholar of context and meaning | The Library of Bezalel |
|
|
|
|
## Themed items
|
|
|
|
At least one durable item is placed in every major room, including:
|
|
- Threshold Ledger
|
|
- Three-House Map
|
|
- Bridge Schematics
|
|
- Compiler Manuals
|
|
- Tri-Axis Telescope
|
|
- Forge Anvil
|
|
- Bridge Workbench
|
|
- Heartbeat Console
|
|
- Server Racks
|
|
- Code Orchard
|
|
- Stone Bench
|
|
- Mac/VPS/Net portal markers
|
|
|
|
## Portal travel commands
|
|
|
|
The Portal Room reserves three live command names:
|
|
- `mac`
|
|
- `vps`
|
|
- `net`
|
|
|
|
Current behavior in the build scaffold:
|
|
- each command is created as a real Evennia exit command
|
|
- each command preserves explicit target metadata (`Mac house`, `VPS house`, `Wider net`)
|
|
- until cross-world transport is wired, each portal routes through `Limbo`, the inter-world threshold room
|
|
|
|
This keeps the command surface real now while leaving honest room for later world-to-world linking.
|
|
|
|
## Build script
|
|
|
|
```bash
|
|
python3 scripts/evennia/build_bezalel_world.py --plan
|
|
```
|
|
|
|
Inside an Evennia shell / runtime with the repo on `PYTHONPATH`, the same script can build the world idempotently:
|
|
|
|
```bash
|
|
python3 scripts/evennia/build_bezalel_world.py --password bezalel-world-dev
|
|
```
|
|
|
|
What it does:
|
|
- creates or updates all 9 rooms
|
|
- creates the exit graph
|
|
- creates themed objects
|
|
- creates or rehomes account-backed characters
|
|
- creates the portal command exits with target metadata
|
|
|
|
## Persistence note
|
|
|
|
The scaffold is written to be idempotent: rerunning the builder updates descriptions, destinations, and locations rather than creating duplicate world entities. That is the repo-side prerequisite for persistence across Evennia restarts.
|