URD WYRD

Define in Urd. Inspect. Run Anywhere.

A declarative schema system for interactive worlds - author in Schema Markdown, compile to JSON and a queryable model, run anywhere.

v0.1.14 Reference Manual
Project Timeline
Project Log

Updates

What's happened, as it happens. RSS

Artifacts

The work so far

Every document produced.
Architecture

System Architecture

How the pieces fit together — from authoring to execution.

Who Writes What
Writer narrative designers Writer Mode
.urd.md files
Prose with seven symbols
@  ?  >  *  +  ->  //  ==
Frontmatter
Not YAML — strict grammar
import: ./world.urd.md
SEES: completions · conversation graph · scene preview · never JSON
Engineer schema designers Engineer Mode
World Schema
Types, entities, traits, visibility
world.urd.md
Rules & Logic
Conditions, effects, sequences, select
rules.urd.md
SEES: type browser · compiled JSON · test runner · import graph
▼ ▼ ▼
Core Tools — CLI or Embedded
Compiler CLI + WASM
Transforms .urd.md source into compiled .urd.json and a queryable FactSet analysis IR. Five-phase pipeline.
Parse
→
Import
→
Link
→
Validate
→
Emit
Wyrd Reference Runtime
Loads .urd.json, executes the world, produces events. Spec ambiguities resolved by what Wyrd does.
  • Immutable state transitions, event sourcing
  • All 5 effects: set, move, reveal, destroy, spawn
  • 4 visibility levels · containment model
  • Dialogue: sticky/one-shot, exhaustion, jumps
  • Seeded randomness — deterministic replay
urd.world IDE panel CI / Headless
3 layers: Core Engine · Presentation · Extension Host (v2)
Testing CLI + Library
Validates schemas and simulates playthroughs. Embeds the real Wyrd engine — no mocking.
  • Monte Carlo playthrough simulation
  • Reachability analysis, dead-end detection
  • Coverage reporting per schema primitive
  • Visibility auditing — hidden state never leaked
  • JSON-only test definitions, seeded runs
  • AI-assisted narrative QA (optional)
Tests run against .urd.json, not source
▼ ▼ ▼
.urd.json
The single contract between authoring and execution
Self-contained Deterministic Versioned Human-inspectable
world* types entities locations rules actions sequences dialogue
▼ ▼ ▼
Product Surfaces
Product
Urd IDE
Integrated authoring environment. Writer mode and engineer mode in the same tool. Play panel embeds Wyrd. Diagnostics embed the compiler.
Compiler Wyrd Testing LSP Server Syntax highlighting
Live
urd.dev
Development journal, technical specs, and browser playground. WASM compiler runs in the browser — zero install.
Playground Compiler (WASM) CodeMirror
Product
urd.world
Product website with live demos. Click Play → Wyrd loads a .urd.json from a URL → world runs in the browser. Zero install.
Wyrd Monty Hall Key Puzzle Tavern Interrogation
Downstream Consumers
Game Engines
Unity and Godot plugins. Dialogue UI, save/load, schema runtime in native code.
Alternative runtimes — test against Wyrd for parity
Web Games
Browser games, prototyping, interactive fiction, embedded worlds.
Wyrd is the web runtime — zero install
AI Integration
Schema-constrained generation. Intelligent NPCs. Narrative QA.
Optional — every world works without AI
Wyrd API
Minimal public surface shared by all consumers.
load() · getAvailableActions()
performAction() · on('event')
seed() · reset()
Specifications Schema Spec Schema Markdown Architecture Nested Dialogue Wyrd Runtime Future Proposals
Compiler Architecture PARSE IMPORT LINK VALIDATE EMIT Formal Grammar Test Strategy Completion Gate
Reference Writers Engine Developers urd.dev build diary · technical specs urd.world product face · live demos powered by Wyrd
Sycophancy Corner

What the Machines Think

We asked AI systems to review the specification. They were suspiciously enthusiastic.