This package contains art, text, or software code produced using generative AI.
Generative AI (Google Gemini) was utilized as a pair-programming assistant during the development of this module. Specifically, it assisted in writing and optimizing the core JavaScript logic (such as edge detection and wall merging algorithms), integrating with the Foundry VTT API, and drafting the README documentation. All code was actively directed, reviewed, and tested by the human author. No AI-generated media (images or audio) are included in this package.
A lightweight and efficient Foundry VTT module that seamlessly imports dungeon maps generated by Donjon directly into your scenes. It automatically calculates and draws optimized walls and doors from your Donjon JSON files.
✨ Features
- One-Click Import: Upload your Donjon
.jsonfile and watch the walls build themselves in seconds. - Wall Optimization: Intelligently merges overlapping or adjacent wall segments into single, long walls to maximize Foundry VTT performance.
- Smart Door Parsing: Automatically detects regular doors, locked doors, secret doors, and portcullises, converting them into native Foundry door objects.
- Dynamic Grid & Offset Support: Complete manual control over grid sizes and scene padding (X/Y offsets) to ensure walls perfectly align with your background images, no matter your scene settings.
🛠️ How to Use
- Generate a dungeon on Donjon
- Download both the Map Image (PNG/JPG) and the JSON Data (Export -> JSON).
- In Foundry VTT, create a new Scene and set the downloaded image as the Background Image.
- Go to the Wall Controls layer on the left toolbar.
- Click the new Dungeon Icon (Import Donjon Map).
- Select your JSON file, adjust offsets if necessary, and click Build Map.
💡 Alignment Tip: Donjon exports are usually 50px per square. If your walls don't align perfectly due to Foundry's default scene padding, use the Manual Offset X & Y fields (e.g., trying 300 for both often perfectly aligns with default padding).