Register

Myxelium’s Battlemap Importer

An Add-on Module for Foundry Virtual Tabletop

Author: Lunah1 Project Source Foundry Versions 12 to 13 (Verified 13) Last Updated 3 weeks, 5 days ago

Myxelium's Battlemap Importer

Effortlessly turn single images or exported map data into ready‑to‑play Foundry VTT scenes. Drop an image or video for the background, optionally drop a JSON export with walls and lights, and create a complete scene in seconds.


image


What it is

Quick Battlemap Importer is a Foundry VTT module that adds a simple "Quick import" button to the Scenes sidebar. It opens a window where you can drag and drop a background image or video and, if you have it, a JSON configuration file. The module uploads the media, applies grid settings, creates walls, lights and doors etc, and builds a new scene for you automatically.

 

Why it exists

Setting up scenes manually can be slow: uploading backgrounds, measuring grid size, placing walls, and configuring lights. This module removes repetitive steps so you can spend more time playing and less time navigating configuration windows.

 

The problem it solves

  • Converts a plain map image into a playable scene with minimal effort
  • It attempts to apply grid settings automatically from submitted image
  • Imports walls and lights from common JSON exports (ex, Dungeon Alchemist)
  • Saves time for game masters managing many scenes

Key features

  • Drag-and-drop panel for images, videos, and JSON configuration files
  • Automatic grid detection for images when no JSON is provided
  • Imports walls and ambient lights from supported JSON
  • Creates and activates a new scene with the uploaded background
  • Optional "No grid" toggle for gridless maps
  • GM-only quick access button in the Scenes directory

Usage

  1. Enable the module in your world
  2. Open the Scenes sidebar
  3. Click the "Quick import" button (GM only)
  4. In the panel, drag and drop one of the following:
  • Background image (png, jpg, jpeg) or video (webm, mp4)
  • Optional JSON export with walls and lights (for example, from tools like Dungeon Alchemist or compatible Foundry exports)
  1. Optionally enable "No grid" if the map is gridless
  2. Click "Create Scene"

Categories

Available Versions

  1. Version 1.4.1

    3 weeks, 5 days ago
    Foundry Version 12 - 13 (Verified 13) Manifest URL Read Notes