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, author 2.5D elevation + parallax backdrops — export a complete content pack for ai-rpg-engine or Unreal Engine 5.
Install
npm install
npm run build
Editor
npm run dev --workspace=packages/editor
# → http://localhost:5173
Export (UE5)
npx world-forge-export-unreal project.json \
--out ./UnrealPack
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 65 structural checks including 2.5D parallax/skyline asset refs, finite-number guards, and spawn-condition grammar. Dependency scanner with one-click repair and click-to-focus navigation.
Review & Export
Health dashboard, content overview, summary export. Peer export lanes: AI RPG Engine ContentPack, Unreal Engine 5 UnrealContentPack (2.5D-aware), plus portable ProjectBundle (.wfproject.json). Multi-format import with fidelity reporting.
2.5D Authoring
Zones carry elevation, multi-level elevation ranges, parallax layers, and skyline refs. Canvas shows elevation badges and drop shadows; UE5 export emits Z-up coordinates, sky/lighting metadata, collision channels, and parallax spawn manifests.
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
# AI RPG Engine
npx world-forge-export project.json --out ./pack
# Unreal Engine 5 (2.5D-aware)
npx world-forge-export-unreal project.json --out ./UnrealPack
# Validate without writing files
npx world-forge-export project.json --dry-run Authoring Surface
What World Forge authors today and what is planned.