It's a smiling halfgoblin! The website's logo. The Halfgoblin's Almanac Buy Me a Coffee at ko-fi.com

Cave Generator

How do I import my cave map into Foundry VTT?

There are two ways of doing that. The simpler one is if you have the Universal Battlemap Importer module installed. You are most likely familiar with it if you have ever imported custom maps from external mapmaking software. The module makes things easy because it allows you to import one single file in the Universal VTT (.uvtt) format, which contains both the scene configuration and the background image. If you do not have or do not want to use the module, you can also just import the background image and scene files separately. There are steps below for both of the methods.

Method 1: Universal Battlemap Importer

  1. Pick a cave map you like and export it as a "Universal VTT" file. This will generate a file with the .uvtt extension.
  2. The 'Universal VTT' button in the bottom right corner is being pressed.
  3. Go into Foundry VTT > Scenes Directory > Universal Battlemap Import
  4. The 'Universal Battlemap Import' button in the bottom right corner is being pressed.
  5. Pick a name, upload the .uvtt file and make sure both the padding and the offset are set to zero.
  6. The import dialogue showing that both the offset and padding are set to zero.
  7. Click "Import" and you are done!
  8. The cave scene was imported and all the walls are in place.

Method 2: Separate image and scene files

  1. Pick a cave map you like and export it both as a jpg file and a "Foundry VTT Scene" file. This will generate a .jpg (the background image) and .json (the scene configuration) file.
  2. The 'JPG image' and 'Foundry VTT Scene' buttons in the bottom right corner are being pressed.
  3. Go into Foundry VTT > Scenes Directory > Create Scene and create a new scene. Pick a name but leave the rest of the settings as default since they will be overwritten anyway in the next step.
  4. The 'Create Scene' button at the top is being pressed.
  5. Right click on the newly created scene and select "Import Data". Then upload the .json file that you exported from the cave generator. This is the file containing the scene configuration.
  6. The new scene is right-clicked and the 'Import Data' button is pressed. In the new dialogue, the .json scene file is uploaded and the 'Import' button is pressed.
  7. The scene configuration should now be imported. However, the background image is still missing. To import that, simply right click on the scene and select "Configure". Then set the background image to the .jpg file that you downloaded from the cave generator.
  8. The new scene is right-clicked and the 'Configure' button is pressed. The file browser in the section 'Background Image' is opened.
  9. Save the scene and you are done!
  10. The cave scene is now ready with all the walls in place.