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 buildLaunch Editor
# Start the web editor
npm run dev --workspace=packages/editor
# Open http://localhost:5173
# Paint zones, connect, place entities, exportCLI 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-runAuthoring 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 (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 collision | Shipped (v4.5.0) |
| Town economy (markets, crafting) + structures (buildings, hubs, strongholds) | Shipped (v4.5.0) |
| World modeling: vertical strata + typed hazards + entry party-gates | Shipped (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 plugin | Ships with Star Freight |
| Quest system + Canon adapter v1 + faction relationships | Planned |