DOCUMENTATION

# Hayba 0.5.0

A worldbuilding toolset — tectonics, conlangs, architecture, wired together by an MCP your LLM can drive. The documentation below tracks the current 0.5 series.

## Install

Local toolset: clone `github.com/zajalist/hayba` and run `npm install`. The linguistics workbench builds with `npm run dev --workspace @hayba/linguistics`.

WIP Full install guide is being written. In the meantime, see the repo README for the canonical setup.

## First run

Hayba opens to the conlang workbench by default. Pick a starter phonology, watch the legality heatmap update as you toggle phonemes, then move on to sound changes and lexicon. Everything persists locally; signed-in users get cloud sync and share-links.

## Linguistics workbench

The conlang workbench covers phonology (IPA chart + phonotactic legality heatmap), sound changes (rule stacks with regex selectors), paradigms, and family trees. Built on PHOIBLE co-occurrence data so suggestions reflect what actually appears in human languages.

WIP Per-feature pages in progress.

## Tectonics pillars

The 0.5 series ships M0-M3 of the tectonics pillar: plate seeding, rift opening, collision/subduction, and the dynamic-plate lifecycle. Visualised at each step with real per-tile invariants (plate area, drift, divergence regime) rather than abstracted summaries.

WIP Algorithm references in progress.

## UE5 MCP plugin

Hayba speaks Model Context Protocol. Any LLM with MCP support — Claude Desktop, Cursor, Continue, local Llama via Ollama-MCP — can author terrain, place actors, apply conventions, and orchestrate the full toolset directly in Unreal.

35 tools across 8 domains: Code mode (meta-tools), Actor, Scene, Editor, PCGEx, Conventions, Landscape & Zone Painter, and others. Per-domain toggles let you scope what the agent sees.

WIP Full tools reference rolls out per-domain.

## Self-hosting

The hosted tier is one self-hosted Supabase plus a static Vercel front-end. See `infra/README.md` in the repo for the full bring-up sequence — docker-compose, Caddy, Cloudflare Tunnel, nightly pg_dump rotation.