GM Guide to Animated Maps in Roll20


Ever seen those really cool animated backgrounds in YouTube and think to yourself “man I wish I could use that in Roll20”? Well, it turns out you can, with a few easy steps. I tested it out earlier tonight and it works great. You could have maps like the one below for your players in 8 easy steps.

Download the Needed Software

  1. Download Roll20 Enhancement Suite – it is a simple browser addon, like an adblocker. Every player in your game needs to download this for them to see the animated map. They should anyway, as the extra functionality it gives Roll20 is gives is pretty cool.
  2. Download VLC. Only the GM needs to do this, for reasons described below.

Setting Up Your Animated Map

1. After your fresh download of the Roll20 Enhancement Suit, you should now have a new icon in the player area with a roll of film.

Button for Animated Background Setup

2. Click on this new icon will bring you to this screen:

Animated Background Setup Screen

The only part that concerns us in this dialog box is the “Media URL” input, where I have written “STREAM GOES HERE”. You need to fill this in. This has to be a direct stream URL, not the YouTube URL that we are familiar with, so we have to convert it. Which brings us to our next step and why you needed to download VLC.

3. First, choose the YouTube animated background map you wish to use and open it in its own tab. Copy the web address in the address bar to your clipboard (CTRL-C). You will need this address in a moment.

4. Open VLC. Click on Media on the menu bar, then Stream….

Click “Media”, then “Stream…”

5. Click the Network tab. Paste the URL of the YouTube video you copied earlier where it says “Please enter a network URL” and click Stream below. Then push Next (the next few dialogue screens don’t matter, so keep pushing it) until the video is loaded.

Click “Stream” then “Next” a few times without worrying about the next few screens.

6. The video should start playing, but ignore that for now. What you want to do is click Tools in the menu, and then click Codec Info (or just press CTRL-J).

Click “Tools” then “Codec Information”

7. On the bottom of the new box, there will be a Location with a URL. Right click it, “Select All“, right click it again, “Copy“. This is the MEDIA URL to the video that the extension on Roll20 was asking for.

That long line of gibberish is the “Media URL” that the Roll20 Enhancement Suit needs to run the animated map.

8. That long line of gibberish is the “Media URL” that the Roll20 Enhancement Suit needs to run the animated map. Make sure you copy the whole thing! Paste it into the Media URL in the Roll20 Animated Maps Setting and that’s it! It should load automatically.

Final steps!

Final Thoughts

It might appear daunting at first with all 8 of these steps, but I assure, it’s super easy once you get the hang of it.

As a side note, I’ve only figured out how to do this today and I’m sure there will be bugs found in the future. I’ve already discovered one: the “Media URL” seems to expire after a few hours, so you have to do the whole process with VLC just before your game. I’m sure others will be found as well. But it sure it cool technology I think we should use.

Finally, I feel like I have to note that you can use any video for a map, not just a YouTube one. It is outside the scope of this guide, but if we run out of YouTube maps I can write a guide for that as well (it is a different process).

Our New Home in Saltmarsh

Holdfast Farm

In our latest adventure, Milo and Rook bought an outlying homestead which has since been named “Holdfast Farm”.

“Holdfast Farm,” our temporary home while we stay in Saltmarsh

It is currently located in the Southern Outskirts of town, near a noisy wizard named Keledek the Unspoken.

The Town of Saltmarsh

Salthmarsh. We’re staying away from the center of town, because we do weird stuff.

Milo is planning to build a tiny temple to Cyrrollalee, the halfing deity of friendship, trust and hospitality in the open quart-yard near the main entrance.

Milo’s Temple to Cyrrollallee. It is 20’x25′.

Click Here for the 3D-Model Version

The Future Awaits

What do we want to do in Saltmarsh? How will we further deck out our homestead? Write below in the comments!

A Quick and Dirty Guide to Roll20 Macros

Some of you have mentioned an interest in creating macros for Roll20 recently. I’ve put together a mini-guide on what I’ve learned about them below.

What Is A Macro?

For our intents and purposes, a macro is basically a pre-generated chat message. Everything you can do in a macro you can do manually by typing it into Roll20 chat. But, to save yourself some time, you create a macro so you don’t have to laboriously type it out every time you want do a certain action. For example, here is what my attack macro looks like for Bashir:

(An example of what you can output with macros. I used this macro for my Fighter.)

Within this “pre-generated chat message” in the form of a macro you can also embed dice rolls, include pictures, third-person character actions, etc. Plus, when properly created, it looks much nicer than having just a long list of confusing dice rolls cluttering up the Roll20 chat.

How Do I Create A Macro?

You can only create a macro within a Roll20 game, so log into Roll20 and click on “Launch Game” . From within there, click on the “Collection” tab:

(First, click “Collections”)

Then click on “Add“:

(Then, click “+Add”)

This will bring up the following screen:

(The interface in which you create your macro)

Under “Name”, just create a name for your macro like “Bashir-Attack” or something. It automatically puts in hyphens for spaces.

Under Actions is where you write the chat commands for the macro. There are a number of things you can make your macro do.

Making Your Character Speak

Just typing into the “Actions” box straight up without anything extra will make your character say those things. For example, typing in:

(Making your character say “Die!”)

Will have the following output in the chat box:

(You, too, can make your character automatically speak.)

Pretty easy. Now lets make our macro a little more complicated.

Making Your Character Do Actions

You can also make your character do actions, or “Emotes“. Remember, these are all things you can already do in chat! To make Bashir swing his sword, use “/em” before you type the action. For example:

(Adding an Emote/Action to your macro. In this case, a sword swing)

Will have the following output:

Pretty neat. Now to add the most important part, the roll.

Adding Dice Rolls to Macros

Perhaps the most useful function of macros, it allows you to embed rolls anywhere in your chat output in a very clean fashion that doesn’t clutter up everyone chat interface. To do so, you simply type the dice roll between double “[[ ]]” brackets. It can include some basic math as well. For example, if you wanted Bashir to swing the sword with a d20 and he has a +7 to hit, you would write:

(Now we’re adding rolls into the mix; probably the most useful part of writing macros.)

Will result in the following:

(If you hover your mouse over the yellow roll, you can get the details of what you rolled)

You can add any dice you want, for example if you want to do damage with a d8, you would simply add the following:

(Now we’re adding damage to the macro)

Will result in the following:

(Now we have most of the elements needed for an action. Good job.)

You can also account for things such as an increased critical range (i.e. if 19s are also crits for you), but that is currently beyond the scope of this particular guide. Now for the fun part – adding some flair to your macro.

Embedding Images in Macros (and Chat)

Like everything in this guide, linking an image works the same in macros as it does in the actual chat tab during a Roll20 game. I know there has been some confusion regarding this that will hopefully be cleared up below.

To embed an image in chat or a macro requires the same syntax: you always start out with the characters “[x]” followed by the image link between parenthesis “( image location )“. So basically:

Type the bold characters exactly as seen. No spaces, no quotes. Replace “image_url” with the web address of the image you are linking.

So for example, if I wanted to add an image of Dawnbringer to my swing, I would type [x](

(The last line is adding an image to the macro)

To get the following chat result:

(Now it has an image. You’re pretty much a programmer now.)

Why Isn’t My Image Working?

Often when you try to link an image all you will get is a broken link that goes nowhere and looks like x.

Unfortunately, images not linking correctly in Roll20 is a common problem. Roll20 is fairly strict in linking images. They must:

  • End exactly with the three letter image file extension: “.gif”, “.png”, “.jpg”. A lot of image urls end in a bunch of gibberish after the image name that is quite frankly unnecessary.
  • Roll20 hates .webp images. There is no support for them despite them being one of the most common images on the Internet (you see them all the time in Google Image Search). You have to convert them if you want to use them; more info below. It doesn’t help that .webp files sometimes masquerade as a .jpg or .gif file.

How To Get The Image Working

  1. If you look in the address bar, after the three letter image file extension, there’s sometimes a whole bunch of unnecessary gibberish you can select/highlight and delete. Pressing enter after doing so and reloading the image will work about 80% of the time.
  2. If that doesn’t work, the simplest way to ensure an image works is to Save the file and Upload the file again to a hosting service, such as Imgur. Then, you simply link the file directly. A pain in the ass, but it almost always works, unless it is a .webp file.

This doesn’t work if you have a .webp file. In this case you must covert .wepb files at this website, from which you can then link it directly.

Some .gif files are also actually movie files pretending to be gifs. You can give it a shot and convert them at this website but I make no guarantees.

My Macro Is Ready. How Do I Activate It?

After you click “Save Changes” when you are done writing your macro, you will probably find yourself back on the Collections tab in Roll20. To make your macro visible, simply click the “In Bar” option next to the macro.

(Click this checkbox to make it appear in you Macro Bar)

This will make it appear at the bottom of your play screen, where you can click it:

(The macros can be found on a bar at the bottom of your screen)

Simply click the macro’s name and you’re good to go! You can make a long list of macros and activate or deactivate them as you need them, keeping the ones you use frequently on you Macro Bar at the bottom of your screen. To deactivate a macro, simply uncheck the “In Bar” option again on the Collections tab next to the macro you want to deactivate.

Deleting a Macro

Sometimes you just want to get rid of a macro. Easy enough, but somewhat hidden, is the red “Delete Macro” button hidden in the “Edit Macro” screen. It’s a bit hard to see; you have to scroll down a bit to find it.

(You have to scroll down to find the “Delete Macro” button in red)

Parting Words

Hope you all enjoyed the guide. If you have a suggestion for other areas you think need a guide, feel free to comment below. Or hell, write it yourself! If you want to submit a guide, send it to my email at and I’ll format it nice and neat on the website.

There’s been some changes!

There’s been some changes to!

Been bored during this Coronavirus outbreak, so I’ve delved a little into the website. Made a few minor changes:

  • Properly categorized the notes for our games in the top menu.
  • Added a Members Only area where those with the password can add media to our server so our GMs can use them in our Roll20 games.
  • Added a direct link to our Google Hangouts video server that we use during our games.
  • Overhauled the comments system to make it more robust. The default one kind of sucks.
  • Created a Discord Server, so we can chat with each other out of game! Visitors to the website can see who is currently logged into our server on the right-hand side of the website, and can also directly connect to Discord via the menu at the top.
  • Added a fully functional Events Calendar, where we can plan our game dates and send notice if we are attending the games or not.

I know we are fulfilling the last of these two items via Facebook, and it seems to be working fine. However, I figure I’d throw out the option to use our own website for it if we so desire.

Let me know if you have any other suggestions. ?

P.S. If you are interested in a custom email address with ““, let me know. I can forward it to your gmail address or whatever you use.