2D World Authoring Studio

World Forge: Author. Validate. Export.

Paint zones on a 2D canvas, define districts and factions, place entities with stats and AI profiles, author branching dialogue trees — export a complete ContentPack for ai-rpg-engine.

Get Started Read the Handbook

Install

npm install npm run build

Editor

npm run dev --workspace=packages/editor # → http://localhost:5173

Export

npx world-forge-export project.json \ --out ./my-pack

Features

Everything you need to author worlds for narrative RPGs.

Zone Painting

Drag to create zones with snap-to-grid layout, resize handles, multi-select with box-select, alignment and distribution tools, and object snapping with visual guides.

Districts & Factions

Group zones into districts with faction control, economy profiles, pressure hotspots, and base metrics. Track faction influence, alert levels, and district-level presences.

Entity Placement

Drop NPCs, enemies, merchants, companions, and bosses onto zones. Author stats, resources, AI profiles, and custom metadata.

Dialogue Trees

Author branching NPC conversations with conditions, effects, and multiple choice paths. Validated for broken links and unreachable nodes.

Character Creation

Define player templates, build catalogs with archetypes, backgrounds, traits, disciplines, entanglements, cross-titles, and progression trees with skill nodes.

Starter Kits & Templates

7 mode-specific starter kits, genre wizard, sample worlds, and user templates. Kit import/export (.wfkit.json) with collision handling and provenance tracking.

Dependencies & Validation

Live validation with 54 structural checks. Dependency scanner surfaces broken, mismatched, and orphaned references with one-click repair and click-to-focus navigation.

Review & Export

Health dashboard, content overview, and summary export (Markdown/JSON). Export to ContentPack, ProjectBundle (.wfproject.json), or review summary. Multi-format import with fidelity reporting.

Speed Panel & Shortcuts

Double-right-click command palette with context-aware actions, pinnable favorites, macros with step editor, 13 keyboard shortcuts, and Ctrl+K search across all objects.

Quick Start

Install

# Clone and install
git clone https://github.com/mcp-tool-shop-org/world-forge
cd world-forge
npm install
npm run build

Launch Editor

# Start the web editor
npm run dev --workspace=packages/editor

# Open http://localhost:5173
# Paint zones, connect, place entities, export

CLI Export

# Export a project file
npx world-forge-export project.json --out ./pack

# Validate without exporting
npx world-forge-export project.json --validate-only

Authoring Surface

What World Forge authors today and what is planned.

Feature

Status

Zones (spatial layout, neighbors, exits)

Shipped

Connections (bidirectional, conditional)

Shipped

Districts (faction control, economy)

Shipped

Landmarks (points of interest)

Shipped

Entities (stats, resources, AI profiles)

Shipped

Items (slot, rarity, modifiers, verbs)

Shipped

Dialogues (branching, conditions, effects)

Shipped

Spawn points & encounter anchors

Shipped

Faction presences & pressure hotspots

Shipped

Player template (stats, inventory, equipment)

Shipped

Build catalog (archetypes, backgrounds, traits)

Shipped

Progression trees (skill nodes, requirements)

Shipped

Starter kits & project bundles (.wfkit.json, .wfproject.json)

Shipped

Dependency scanner (broken refs, orphan detection, repair)

Shipped

Review dashboard (health, content overview, summary export)

Shipped

Speed Panel (command palette, macros, custom groups)

Shipped