WFWorld Forge
v4.9.0 — 2D / 2.5D World Authoring Studio

World Forge: Author. Validate. Export.

Paint zones and tiles on a 2D canvas, define districts and factions, place entities, author towns (markets, buildings, hubs, strongholds), vertical strata, typed hazards, and party-gated zones — export a complete, engine-verified content pack for ai-rpg-engine, Unreal Engine 5, or Godot 4.

Install

npm install npm run build

Editor

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

Export (Godot 4)

npx world-forge-export-godot project.json \ --out ./GodotPack

Features

Paint a world. Validate it. Export it to three engines.

Zone Painting

Drag to create zones with snap-to-grid layout, resize handles, multi-select, and object snapping. The canvas is the product.

Dependencies & Validation

Live validation with 89 structural checks, a dependency scanner, and one-click repair. Invalid worlds cannot export as lossless.

Three Export Lanes

AI RPG Engine ContentPack, Unreal Engine 5 UnrealContentPack (2.5D-aware), and Godot 4 playable .tscn — plus portable ProjectBundle.

2.5D Authoring

Elevation ranges, parallax layers, and skyline refs on the canvas. UE5 export emits Z-up coordinates; an authored presentation block gives a dimetric client its cells and occupancy.

Godot 4 Playable Scene

A navigable .tscn: per-zone collision + navmesh, TileMapLayer, town structures, strata, hazards — verified against real Godot 4 headless.

Tiles & Interiors

Image-backed tilesets with a colored-rect fallback, layers, wall collision, and a prop palette for interiors.

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

# Godot 4 (loadable project root)
npx world-forge-export-godot project.json --out ./GodotPack

# Validate without writing files
npx world-forge-export project.json --dry-run

Authoring Surface

What World Forge authors today and what is planned.

FeatureStatus
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 anchorsShipped
Faction presences & pressure hotspotsShipped
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, skylineRefShipped (v4.2.0)
Zone 2.5D editor UI + canvas elevation badge + parallax previewShipped (v4.3.0)
Unreal Engine 5 export (UnrealContentPack, 2.5D aware)Shipped (v4.2.0)
UE5 sky/lighting metadata, collision channels, parallax spawn manifestShipped (v4.3.0)
LootTable, SpawnCondition grammar, TransitionEntityShipped (v4.3.0)
Zone physics overrides (gravity, zero-g, aquatic)Shipped (v4.3.0)
AI RPG Engine export profiles (debug/release) + --dry-runShipped (v4.3.0)
Godot 4 export (playable .tscn: collision, navmesh, camera, y-sort)Shipped (v4.5.0)
Tile pipeline (image + fallback tilesets, brush, Godot TileMapLayer)Shipped (v4.5.0)
Interiors: prop placement + tile wall collisionShipped (v4.5.0)
Town economy (markets, crafting) + structures (buildings, hubs, strongholds)Shipped (v4.5.0)
World modeling: vertical strata + typed hazards + entry party-gatesShipped (v4.5.0)
Forge→Engine alignment audit (measured export table + leaf-path differ)Shipped (v4.6.0)
Content-pack manifest truth (real semver range, content hash, gated module ids)Shipped (v4.6.0)
Space vocabulary crossing (compiled spawn conditions, hazards, entry gates, scene descriptors)Shipped (v4.6.0)
Drawing contract (presentation block: dimetric cells, zone anchors, occupancy, advisories)Shipped (v4.9.0)
UE5 reference loader pluginShips with Star Freight
Quest system + Canon adapter v1 + faction relationshipsPlanned