How to Use UVTT Files in Roll20

⚠️ Importing a UVTT file into Roll20 requires a few more steps than most other platforms. Roll20 uses a community API script called UniversalVTT Importer to handle the import, and accessing scripts requires a Roll20 Pro subscription. 

Please note that if you do not have a Roll20 Pro subscription, you will not be able to follow this guide. 

What is a UVTT file? 

A UVTT (Universal Virtual Tabletop) file packages a map’s image together with its wall, lighting, and grid data. 

Every Czepeku map comes with a UVTT file, available to download with a Premium subscription and ready to import into Roll20.

Step 1: Obtain Your Image and VTT File

You’ll need two things before you start: an image file of your map, and the UVTT file.

The UVTT file (.dd2vtt, .df2vtt, or .uvtt) contains the wall, lighting, and grid data. However, note that you can’t upload this directly to Roll20 due to file size limitations. You’ll need to run it through a sanitization process first (covered in Step 2), which extracts just the data Roll20 needs into a text file. 

The map image file is a separate .png or .jpg of the map. The UniversalVTT Importer script can’t pull the image out of the UVTT file itself, so you’ll need to upload it separately.

With Czepeku maps, we’ve already done the sanitization for you, so you can skip Step 2. 

  1. On the map’s gallery page, find the variation you want to use. 
  2. Click the round download icon next to the map image. 
  3. Select Roll20 from the list of VTT options, which will download both the UVTT text file and the map image. 

 Then skip straight to Step 3. 

Step 2: Sanitize Your File

As mentioned above, you can’t upload a UVTT file directly to Roll20. You’ll need to run it through a sanitizer tool that strips out the image data and leaves just the wall and lighting information as a text file. 

  1. Go to the Universal VTT Import Sanitizer tool
  2. Click Choose File and select your UVTT file.
  3. Copy all of the resulting text and keep it somewhere handy.

Step 3: Install the UniversalVTTImporter script 

  1. From your Roll20 dashboard, find your game and click on it.
  2. Under Settings, select “Mod (API) Scripts”. Note that this option is only available to Pro subscribers. 
  1. Open the Mod Library and search for UniversalVTTImporter.
  1. Select it and click Add Script.
  2. Launch your game.

Step 4: Upload the Image File 

  1. In your game, drop your map image onto the page.
  2. Scale it to fit as needed.

Step 5: Upload the Sanitized / Text Map Information

  1. Double-click the map image to open its properties.
  2. Go to the GM Notes tab.
  1. Paste the text from Step 2 into the GM Notes field.
    1. If you’re using a Czepeku file, open the .txt file you downloaded in Step 1 in a word processor like Wordpad, and copy the text from there. 
  2. Click on Save Changes.

Step 6: Confirm and Enable Token Vision

  1. Make sure your map image is selected on the page.
  2. Type “!uvtt” into the Roll20 chat, and press Enter. 

You should see a confirmation message in the chat. Your map’s dynamic elements, including walls and lighting, are now active.

Don’t forget to enable token vision in each character’s token settings to make full use of the dynamic lighting. 

And that’s it! Your map is ready to go. Happy adventuring! 

Something Didn’t Work? 

Head to the #VTT-discussion channel on our Discord—our community is always happy to help with any questions. You can also reach us directly at support@czepeku.com!

Last updated June 18, 2026