Home

🧬 Formamorph Wiki

A browser-based, AI-driven text RPG framework — play, create, and share interactive worlds powered by your own LLM.

Formamorph runs entirely in the browser and talks to any OpenAI-compatible chat-completions endpoint (local LM Studio / Ollama, OpenAI, etc.), so your games stay on your own machine and model. Pick a built-in world, import one, or build your own in the visual editor.

🌐 Live demo: play Formamorph in your browser → — instant, no install. (18+ — see below.)

Caution

For adults only (18+). Formamorph is an open-ended AI roleplay engine. Stories are generated by your chosen AI model and worlds can be authored by anyone, so content is effectively unbounded. The in-app world browser surfaces user-created worlds, unmoderated and as-is. See the repository's README for the full responsible-use disclaimer.

---

📖 Where to go

Page	What's inside
📐 World Format	The full structure of a world .json — every field of stats, traits, locations, entities, stat-updates, and the dictionary
🧮 Stat Code Guide	Writing dynamic JS formulas that derive one stat from others
📝 Changelog	What's changed, release by release

🚀 Getting started

Prerequisites: Node.js 20.19+ and npm.

npm install
npm run dev      # serves at http://localhost:5173

Open the app, go to Settings, and point it at your AI endpoint. Full setup, configuration, and the optional VRAM monitor are documented in the repository README.

🧱 Tech stack

React 18 · TypeScript (strict) · Vite 5 · Tailwind CSS + shadcn/ui (Radix) · three.js + @pixiv/three-vrm · Kokoro (TTS) · QuickJS (sandboxed stat code)

---

ℹ️ This wiki is generated from the docs/ folder in the repository. Edit the docs there — changes publish here automatically. This is a community fork of the original Formamorph by FieryLionite.