Escape the Valley: Ledger Trail.
Lead a party through procedurally generated wilderness. Manage food, water, wagon condition, and morale. An AI Game Master narrates your journey. An optional XRPL ledger tracks your supplies on-chain.
Install
pip install -e ".[dev]"
Play
trail tui --seed 42
Resume
trail tui --continue
Features
Everything that makes the trail worth walking.
AI Game Master
Three GM profiles (Chronicler, Fireside, Lantern-Bearer) narrate your journey with distinct voices. Powered by Ollama — runs locally, zero API cost.
Deterministic Physics
Seeded RNG, scarcity curves, and doctrine modifiers. Every run is reproducible. The engine is the rules-lawyer; the GM just tells the story.
Oregon Trail Mechanics
Travel, rest, hunt, repair. Events with real choices. Escape valves for emergencies. Maintenance windows for the careful. Pace matters.
XRPL Ledger Backpack
Optional on-chain inventory tracking on XRPL Testnet. Supply tokens, settlement receipts, and parcels. Proof that you survived — or tried.
Full-Screen TUI
Rich terminal interface built with Textual. Camp actions, event choices, route forks, and a trail ledger at journey's end.
316 Tests
Comprehensive test suite covering physics, events, save/load, ledger, backpack, and death cause enrichment. Lint clean.
Quick Start
Install
# Install the game
pip install -e ".[dev]"
# Optional: XRPL backpack
pip install -e ".[xrpl]"Play
# Launch the TUI (recommended)
trail tui --seed 42
# With AI narration (requires Ollama)
trail tui --seed 42 --voice
# Without AI (deterministic mode)
trail tui --seed 42 --gm-offCommands
trail tui # Full-screen TUI
trail tui --continue # Resume saved game
trail status # Party & supplies
trail journal -n 5 # Recent events
trail ledger enable # Enable XRPL backpack
trail self-check # Environment healthGM Profiles
The narrator shapes the tone, not the mechanics. All three play the same game.