Vmat Manual

The basics

Vmat will start with a blank object in the middle of the screen. From here you can create a scene, load one, or start a session.

start with text

Player color


Clicking the box below the dice tab will open a panel with 3 sliders. Changing the values will change what color represents you to the other players. Dice, ping markers, and your view zone will match this color.

The order of the sliders from top to bottom is red, green, and blue.

color sliders



Host only

Ctrl + S = force a resync in case a guest  falls out of sync.

Shift + left mouse click on object = edit object menu (only works on objects above the grid)

Shift + Ctrl + Left mouse click on object = edit object menu (only works on objects below the grid)

X + left mouse click = create walls

Right mouse button + wall = delete wall

Up arrow + object edit menu open = send to top of layer

Down arrow + object edit menu open = send to bottom of layer

All users

Mouse click object = move object

Ctrl + mouse click object = move object below grid

Ctrl + L = enable/disable player view zones

G = toggle grid

P = ping location at mouse

/ = view about tab

M= measure distance



Pressing the P key will create a ping on the board where the users mouse overlaps. the Ping will appear over fog of war and will copy the users color.


View zones


Each player's view will be shown to the others as a colored rectangle. This rectangle will adopt their chosen color and be visible though fog of war. View zones can be toggled on and off with Ctrl + L

view range


Objects are the life of Vmat. with them you can load any image you want. From pre made boards, to enemies, decals, and players.

Any user can move an object above the grid by clicking and dragging it with the mouse. to move an object below the grid hold the "Ctrl" key and click the mouse in the same way. to edit the properties of an object hold left shift and click it with the mouse. Only the host can open the edit panel for an object.


Object edit bar options


Changing images

To change an image. make sure you have all the images you need on a hosting site. Copy the direct link to the image and paste it in the text box to load it. Note that some image hosting sites do not allow the image to be loaded outside the webpage. If you try to load an image that is restricted nothing will happen. So take this into consideration. cubeupload.com is a good site for hosting your images. (depending on your browser this function might not work. Tested browsers are Firefox and Chrome.)

tool bar cropped


When you choose to scale an image it will show a red arrow and a blue circle on the top left corner of the image. clicking and dragging the red arrow will change the center of the scale. And dragging the blue circle will scale the image relative to the red arrow. this can be useful if you are scaling a pre-made map. If you align a grid corner on the map with the in game grid in Vmat you can position the arrow to that corner. and then scale the image until the grids align.



Delete will delete the object. this is not reversible.

Toggle Layer will toogle what layer the object is on. being "Above" and "Below" the grid.

Hide/Show will edit the viability of an object. when enabled the object will not be visible to guests. But will be transparent to the host. The object is unchanged in every other way and can still be manipulated.


Manage line of sight will edit how the object appears when fog of war is enabled. When clicked a list will be produced that shows all connected players. clicking the checkbox will make the object viable to the checked player. Objects can be visible to multiple players. you can also set how far the object can see.


You can enable this for each player's avatar so they can see their surroundings. You can also enable line of sight for hidden objects as well. you can use this to light up a room that the Guest might not be in, but you want them to see anyway.

Vision Range

Clone will create a duplicate of the object. The clone will copy the image source and scale, but not other properties such as layer and line of sight.

Hosting and joining a session

To host or join a session open the "other" tab and click the "make or join session" button. You will be asked to enter a username and then enter a room code. If you are the first to enter a room with a given code you will become the host or "DM" of the session. Anyone else that joins with the same code will become a guest. There is no password option. If you wish to play without random players be sure to enter a unique code that would not be easily guessed.

Creating a scene

Between objects and tile maps creating a scene can be easy.


To use the tilemap editor click the "tilemap" tab to open it. Click a tile in the tab to select it and click on the scene to place a tile. Both the host and guests can place tiles.

You can also use objects and their textures to help set the scene. From custom made boards, to scenic items such as terrain, props, blood splats, ect. Whatever helps sell the narrative.


While walls can be used to help separate areas in a scene. Their main purpose is to create obstacles when fog of war is enabled. Walls will prevent guests from seeing the scene that is on the opposite side of any walls in their view range.

Walls do not prevent objects from passing over them and always snap to the grid.


Saving a scene

The host has the option to save the scene as is to return to it later. Depending on what platform you choose more or less options may be available.

Save = save the scene as a file on the users desktop. (Not usable in the web app)

Load = load a file from the users desktop. (Not usable in the web app)

Save by text = text will be generated that the user can copy and paste into a text file. This is the only way to save a scene when using the web app.

Load by text= allows the user to paste a previously generated text into the prompt. This is the only way to load a scene in the web app.



No table top RPG would be complete without dice. Users can create any dice they wish.

Users can crate D4, D6, D8, D12, and D20 dice. When dice are grabbed they will move to the users mouse. To throw dice after picking them up click on the screen.

Users can also create blessed and cursed dice. These dice have odds tilted in favor of one extreme. Blessed dice have a 3 to 1 chance of rolling a higher number. While Cursed dice have a 3 to 1 chance of rolling a lower number. However each number is still possible. the DM can use this to give users a better chance if they please the DM.  Or a worse chance if they get on their bad side or otherwise need to be punished.


Fog of war

The host has the option to enable fog of war. This will cause all guests screens to go black. Fog of war is transparent to the Host.

The host should enable line of sight on any objects that represent a users avatar.

Guest's view with fog of war enabled.

line of sight guest

Host's view with fog of war enabled.

line of sight host

Measuring tool

Users can hold down the M key to measure the distance from one point to another. Each square on the grid is 5FT in length.

Managing the Z order


Sometimes objects may appear to be on top of other objects in a way that may not make sense. Such as a person appearing under a barrel. This is because of the Z order rendering objects in an unintentional order.

The host can change the Z order by first selecting an object with Ctrl + mouse click. and then using the up and down arrow keys to move the object to the top or bottom of the Z order.

z layer 1
z layer 2

Known issues

Sometimes objects might fall out of sync for guests. The position could be off or an image might not load. The host can force guests to resync by pressing Ctrl + S.

Sometimes objects might not load correctly when opening a save. Sometimes this happens if you are loading a session similar to the current one. This can be worked around by Deleting the current session manually then loading the file. Or by restarting the session.

When loading a map the tile map won't synchronize with the guests. The host can fix this by pressing Ctrl + S.