Files
timmy-home/docs/BEZALEL_EVENNIA_WORLD.md
Alexander Whitestone b3359e1bae
Some checks failed
Smoke Test / smoke (pull_request) Failing after 19s
feat: add Bezalel Evennia world scaffold (#536)
2026-04-15 00:46:03 -04:00

2.9 KiB

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

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:

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.