WF World Forge
v4.4.0 — 2D / 2.5D 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, 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.

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
2.5D fields: elevation, elevationRange, parallaxLayers, skylineRef
Shipped (v4.2.0)
Zone 2.5D editor UI + canvas elevation badge + parallax preview
Shipped (v4.3.0)
Unreal Engine 5 export (UnrealContentPack, 2.5D aware)
Shipped (v4.2.0)
UE5 sky/lighting metadata, collision channels, parallax spawn manifest
Shipped (v4.3.0)
LootTable, SpawnCondition grammar, TransitionEntity
Shipped (v4.3.0)
Zone physics overrides (gravity, zero-g, aquatic)
Shipped (v4.3.0)
AI RPG Engine export profiles (debug/release) + --dry-run
Shipped (v4.3.0)
Godot 4 export lane
Planned
UE5 reference loader plugin
Ships with Star Freight
Quest system + Canon adapter v1 + faction relationships
Planned