PCGEx + Watabou

This early prototype has been superseded.
It now lives on as Watabou Bridge -- a free, standalone Unreal Engine plugin on FAB.

---

⚠️ This repository is deprecated

PCGEx + Watabou was an early, open-source prototype for importing Watabou's procedural maps into Unreal Engine's PCG framework. It has been replaced by Watabou Bridge, a dedicated, free plugin distributed on FAB.

This repository is no longer maintained. No further updates, features, or fixes will land here. Please switch to Watabou Bridge.

>> Get Watabou Bridge on FAB (free) <<

Documentation • Discord

---

What changed?

Watabou Bridge is a ground-up rework of this prototype:

• Standalone - it no longer depends on PCGEx (or anything else).
• Generators run in-editor - instead of exporting JSON from the website and re-importing it, the generators are embedded directly in an editor window. What you see in the preview is exactly what gets imported (bundles included with Watabou's permission).
• More generators - Perilous Shores, City, Village, Dwellings, One Page Dungeon, Urban Places and Neighbourhood.
• A cleaner PCG workflow - two nodes, Generate (geometry) and Load Properties (metadata as attributes).
• Free, on FAB - distributed as a free, closed-source plugin.

---

What this means for you

• Existing clones still build against their respective versions, but won't receive updates or fixes.
• Issues and pull requests opened here won't be actioned - please use the Discord or the new documentation.
• There's no automatic migration - just re-generate your maps in Watabou Bridge's import window. It's quicker than the old JSON round-trip.

---

📦 Original prototype README (archived for reference)

PCGEx + Watabou

Import procedural maps from Watabou's generators into Unreal Engine's PCG framework
Cities, villages, neighborhoods, and dungeons - from JSON to PCG data in seconds.

Documentation • Discord • FAB

What is PCGEx + Watabou?

This is a companion plugin for PCGEx that converts JSON exports from Watabou's procedural generators into PCG & PCGEx data you can use directly in Unreal Engine.

Supported Generators

• Medieval Fantasy City Generator
• Neighborhood Generator
• Village Generator
• One Page Dungeon

Experimental Status

This plugin is experimental. Watabou's JSON data structures may change over time. The code is designed to support multiple data versions, but if something breaks, open an issue and I'll look into it.

Requirements

• Unreal Engine 5.6+
• PCGExtendedToolkit - Core PCGEx plugin (free, MIT licensed)

Installation

From FAB

Get the latest release from the FAB Marketplace.

From Source

1. Clone this repository into your project's Plugins/ folder
2. Ensure PCGExtendedToolkit is also installed
3. Regenerate project files and build

Getting Started

1. Go to any of the supported Watabou generators listed above
2. Right-click and export to JSON
3. Rename the file extension from .json to .wataboujson - this is key for the auto-import to kick in
4. Drag and drop the file into Unreal - this generates a new Data Asset. Save it.
5. In a PCG Graph, use the Load Watabou Data node and pick your data asset

The content of the JSON export depends on what is displayed in the generator. Some generators expose different data types such as districts — play around with them!

License

MIT License -- Free for personal and commercial use. See LICENSE for full terms.

---

Support

• Watabou Bridge on FAB - the current, maintained plugin
• Documentation - guides and node reference
• Discord - community support and discussion
• Patreon - support PCGEx development