Runehammer VTT Feature Guide

[KaneDriscol]

This thread is to document and showcase all the features of the Runehammer Virtual Tabletop (RHVTT). If you have questions or would like to showcase how you are using the RHVTT, please feel free to check out the FAQ thread or start a new topic in the forums.

CHECK OUT THE FAQ THREAD

---

RHVTT Homepage

After logging in with your Patreon account, as GM you’ll be able to create a new game. Just type in the name of your game (no special characters or spaces), and drag in a background image. You can also generate a random name game or start with a transparent background.

---

GM Drawer (Homepage)

At the top of the homepage is your GM Drawer, where all of your games are stored in a dropdown menu. Each game will display a picture of your game and three icons: CLEAN UP, EXPORT GAME, and DELETE GAME.

• CLEAN UP will attempt to clear out any broken tokens and will remove any music files.
• EXPORT GAME will download your entire game as a .zip file that can then be reuploaded when selecting a background image in a new game.
• DELETE GAME will remove your game from the server.

---

GM Drawer (Game)

Once you are inside your game, the GM Drawer will display all the various scenes you’ve created and several icons: CREATE SCENE, CLONE SCENE, DELETE SCENE, MOVE RIGHT, and MOVE LEFT.

• CREATE SCENE will create a new, blank scene.
• CLONE SCENE will duplicate everything (except the background) into a new blank scene.
• DELETE SCENE will remove the scene from the game.
• MOVE RIGHT will change the order of the scene to the right.
• MOVE LEFT will change the order of the scene to the left.

---

Token Controls

After you drop in a token from your file browser, you’ll have some basic controls that show up when the token is selected. You can DRAG TO ROTATE, MOVE TO TOP, DELETE TOKEN, MOVE TO BOTTOM, ENTER LABEL, DRAG TO RESIZE, VERTICAL FLIP, CLONE TOKEN, LOCK/UNLOCK.

• DRAG TO ROTATE will rotate the token around a central point.
• MOVE TO TOP will push the token above other tokens.
• DELETE TOKEN will remove the token from the scene (you can also use the delete key).
• MOVE TO BOTTOM will push the token below other tokens.
• ENTER LABEL will let you add a text label to the token in your player color (if you add a ‘#’ at the beginning of the label, it will increase the size and center the label text).
• DRAG TO RESIZE will increase or decrease the size of the token depending on what direction you drag.
• VERTICAL FLIP will flip the direction the token is facing.
• CLONE TOKEN will duplicate the token (you can also use ctrl/cmd+c and ctrl/cmd+v to Copy/Paste)
• LOCK/UNLOCK will prevent or allow the tokens from moving or being controlled. All tokens start UNLOCKED.

Note: You can also multi-select tokens by clicking and highlighting multiple tokens or by selecting each token with ctrl/cmd+click to add a token to the group. All tokens can then be controlled at the same time.

---

Dice Controls

Clicking on any of the dice will produce a random result. Each roll is colored coded/labeled by player and will disappear after a short time. Criticals will be highlighted to draw attention to the maximum roll.

Each of the dice can be drag and repositioned around the edge of the map area. Right-clicking on any of the dice will return them to their orginal position.

Shift+click-drag on any of the dice will pull out a TIMER die with the most recent roll as the main label. It will also be colored coded. Two additional icons will appear ( + and - ) that will increase or decrease the label by one.

---

Music Controls

Once you drop in a .mp3 file into a scene, the music controls will appear and can be dragged around the scene. You’ll be able to MAKE LOUDER, TOGGLE MUSIC, MAKE QUIETER, and CLEAR MUSIC. Each player will have full control over the music on their side.

• MAKE LOUDER will increase the volume.
• TOGGLE MUSIC will mute or unmute the music.
• MAKE QUIETER will decrease the volume.
• CLEAR MUSIC will remove the music for everyone.

Note: Music will continue from scene to scene until you clear the music, drop in a new file, or use the clean up tool from the home page.

---

Player Controls

All players who have logged in will appear at the bottom along with their name, country, and chosen color. The list of players can be dragged around the scene along with controls to MOVE LEFT/RIGHT and KICK PLAYER.

• MOVE LEFT/RIGHT will reorder the players in the list
• KICK PLAYER will disconnect a player from the game (this option is only available to the GM).

Note: If players want to change their name or color, they just need to refresh the game and log back in with their new name and color.

---

Any additional features or updates will be added as they are documented.

[KaneDriscol]

=== RHVTT UPDATE v1.2.1 ===

We skipped v1.2.0 due to some updating issue (just internal things).
Fixed token icon tooltip (Vertical Flip is now Horizontal Flip
“Music muted” is only shown if music is available
Better image pre-loading for a game (see footer indicator “Loading assets…”). All your assets should be automatically pre-loaded by your players, so you can quickly switch pre-setup scenes.
Webcam can be snapshot as a background (e.g. for terrain setup on your real table)

---

Webcam Snapshot

Within the GM Drawer during a game, you can now use your Webcam to snapshot background images.

Once you’re ready with your webcam you can take a snapshot and apply it to the background of your scene.

[KaneDriscol]

=== RHVTT Update ===
v1.2.3
Screen Share Snapshot feature (as teased earlier)
Auto-Movement Lock/Unlock for pings
Player-Colored Timer Tokens are drawn more efficiently (less FPS drops)

Remember: Clear your cache

Upcoming updates will primarily be bug fixes and UI improvements.

---

Screenshare Snapshot

With this latest update, you can also take a snapshot of your screen and set it as a background, right within the RHVTT. In the GM Drawer, you select the Preview Screenshare button.

It will then ask you to select which Screen, Application Window, or Tab you’d like to use as the snapshot.

After you’ve chosen your source, you can preview, take a snapshot, and apply the screen snapshot as the background.

---

Auto-Movement Lock/Unlock

When zoomed, players can now enable/disable the ability to auto center their screen whenever someone pings a location. The lock icon will only appear if the player is zoomed in. When locked, the screen will not move. When unlocked, the screen will move.

[KaneDriscol]

=== RHVTT UPDATE ===
We’re hitting v1.2.4 with:
webcam/screenshare snapshots are using less bandwidth (now using correct encoding)
fixed issue with extremly dark or bright playercolors when using timer tokens
flipped token’s label is not longer rotated with the token
more subtle notification for assets being up-/downloaded
player color can be randomly picked over and over again on login screen without reloading ( icon)

Remember to clear your cache

---

Randomly Select/Reselect Player Color

Before entering a game, you can now randomly select a color using the Random Color Generator. The option to specifically select a color remains.

[KaneDriscol]

=== RHVTT UPDATE ===
We’re hitting v1.3.0 with
Reworked music system (now offering a couple of slots for quicker music switching)
Timer label now resized on token resize
Typo in screenshare error messege
Country flags fixed (made more robust)

As always: clear your cache.

---

Updated Music System

The Music system has been reworked and updated to provide a more robust option of playing music in the RHVTT. The main feature is the inclusion of up to 5 Music Slots that you can switch to whenever you need

The Music Player without any tracks added

You can drag and drop in up to 5 .mp3 to fill each slot. Once loaded in, anyone can toggle each track on and off by selecting the specific slot. This will change the music for everyone. Change back and forth between tracks will restart the track at the beginning, but if you lower the volume to 0%, it will continue looping as normal (just without any sound).

Right-clicking on a specific slot will open a dialog box with an option to delete the track.

[KaneDriscol]

=== RHVTT Update ===
We’re hitting v1.3.1
Solved problem with uploading a token after game cleanup
Workaround for occasional login delays
Music is cleared on game cleanup (but not longer cleared when exporting to a ZIP)
Music slots are correctly updated after login
Fixed several rare crashes (you’ve event might not notices them)
Workaround for “hanging players” (aka name-already-in-use)
D100 rolls when doubleclicking d10
Token labels are now shrinked when zooming
Fixed adding timer dice in chrome (hopefully )
Thx for your contribution!

Note: Don’t overdo timer dice, they are resource intense on some browsers!

And, as always, Clear your Cache!

---

Roll a d100

You now have the option to roll d100 simply by double clicking the d10 die. A single click will provide a result from 1-10. A double click will give you a result from 1-100.

[KaneDriscol]

=== RHVTT UPDATE ===

We are hitting v1.3.2 with a huge overhaul improving especially the mobile experience.

General things:
Fixed some rare crashes
D100 rolls have leading 0 digit so they can be distinguished
Ping beacon animation has multiple cycles (instead of a single one)

Zooming:
Moving zoomed viewport with Spacebar+Leftclick is not resetting token selection anymore
Ping beacon is drawn smaller if zoomed in
minimum token size is relative to zoom level (zoom in and shrink them again if you want them to be tiny)
Zoomed Viewport can be moved using Arrow Keys

Mobile:
Zooming using pinch gesture
Zoomed Viewport can be moved using wipe gesture
Selecting multiple tokens on mobile using pressure-sensitive input
No ctrl/shift/whatever-key required for getting timer dice (just drag it into the center; dragging to the border works as before)
File upload dialog (since there is no drag-and-drop for files on mobile)

Notes:
Sharing camera/screen is not working for mobile. But you should be able to access your builtin-camera via file upload dialog.
File upload works for all image and audio files. it works in tandem with the dropbox app, but loading from the device’s memory is highly recommended.
The wipe gesture is based on touch pressure. Most players should be fine with selecting single tokens at a time; GMs are advised to use a pressure-sensitive pen or something similar if the multi-token selection is required while mobile GMing.

As always: clear your cache and report every bit that’s off or broken

---

File Upload Option

Within the GM Drawer, you now have a File Upload Option. By clicking on the File Upload button, a dialog box will open for your files. You can then select one or multiple files which will then be dropped in as if you dragged them into the scene directly.

File Upload Option in the GM Drawer

Select one or multiple files

Images are dropped directly into the scene

[KaneDriscol]

=== RHVTT UPDATE ===
We are hitting v1.3.3 with some more minor improvements, especially on mobile, since I GMed a couple of sessions using only my tablet.

No more double-activation when tapping token icons
Dice are spread vertically on mobile (better screen usage without rearranging everything; on desktop it stays tightly packed)
Tokens with a pure number as label now have plus/minus icons (e.g. tracking enemy hitpoints)
You can draw onto your background and reupload it (neither redo nor eraser, just doodling around), allowing for some quick’n’dirty floor plans if necessary. Note, that pens are supported and disable drawing by finger (can be reenabled with the PEN-checkbox if you want to). That way, most palm touches are ignored while drawing (hopefully, pretty experimental).
Improved token label readability when zooming

As always: clear your cache and report every bit that’s off or broken

---

Tokens with Number Counters

When using a pure number as a label, all tokens now have the ability to add or subtract numbers from them. It’s a great way to track HP or other individual stats. Just create a label and input the specific number (no ‘#’ needed).

Token with number label

Plus and Minus option to add or subtract numbers from token

---

Drawing on Background

GM’s now have access to draw on the background with a simple drawing tool within the GM Drawer. These drawings are then uploaded as the new background. This allows GMs to draw in little details or draw maps on the fly as players move throughout the space. If you use a monochromatic background, like white, you can treat it very much like a whiteboard.

Drawing tool within the GM Drawer

The Drawing Preview Panel

_NOTE:_The new image will replace the old background with a new 1600x900px image. This may affect porportions and resolution slightly if the original image is not 1600x900px.

[Fuzzymagoo]

Pretty dang cool!

[KaneDriscol]

=== RHVTT UPDATE ===
We are hitting v1.3.4 with some more minor things (this time without restarting the server)

Slightly removed timer fontsize to find a middleground between different devices (the numbers should not longer be larger than the timer token itself)
Token rotation is back to work
Improved token movement responsiveness (is that even a word?) on chrome (notice that the FPS are limited to a lower number now)
Tried to make images less blurry. Please report your window.devicePixelRatio to me if things are still blurry for you.

As always: clear your cache and report every bit that’s off or broken
PS: There are still issues on my list

[KaneDriscol]

=== RHVTT Update ===

We are hitting v1.3.5 with the following:

dice icons are not longer blurred or pixelated on chrome
music is no longer deleted by accident (do it manually if it’s intended)
token labels are no longer cut off at the bottom
ctrl-click to add/remove tokens to/from selection got fixed
ctrl-a selects all tokens correctly

As always: clear your cache and keep reporting

[KaneDriscol]

=== RHVTT Update ===

Quick and small update to v1.3.6

Adding TIMER DICE should work now consistently (just drag a dice icon into the scene, without any keys pressed like CTRL)
Note: The option of moving dice around had to be disabled. Both features were constantly blocking each other.

As always: make sure to clear your cache

[KaneDriscol]

=== RHVTT Update ===
We’re hitting v1.3.7 today with a few changes, one of them drastic!

• Improved WAR|MAKER-dice (thanks to @Hankerin [B] for the help in updating the art)
• Dragged-in Tokens now appear at the correct position (were slightly off here and there)
• Hank and I decided to drop the patreon-requirement for RHVTT. Everybody (regardless of whether RH-Patreon or not) can now be a GM. The Patreon-Login still remains, but anybody can now join with any patreon account (even if there is no subscription to anybody). Especially, since patreon allows to quick-login via Google/Apple/Facebook, we’ve got a pretty quick and open access now

Clear your cache.

[KaneDriscol]

=== RHVTT Update ===

Folks, we’re hitting v1.4.0 with some great things:

When adding tokens while zoomed, the token size now fits the zoom level
The music player automatically appears/disappears if music is used or not.
The login page’s layout was fixed on mobile devices
Mobile users can now unselect tokens; this was broken for some reason…

All players can now doodle index cards
GMs can create game links with a game starting time, which works across different timezones
The skull dice is now using proper artwork, also on its roll results
A dice tray is added which holds your latest rolls (cleared after 1min or on right click). It only shows your own rolls (all rolls are shown as before) and dice inside the tray can be moved (e.g. for grouping while adding, just like at the table) and used as timer dice. So, RHVTT should allow for proper VDS gameplay due to the dice pool approach.

PS: As always keep on reporting broken bits and pieces.

---

Doodle Index Cards

Players and GMs now have the option to quickly doodle their own index cards and drop them directly into the game. In the bottom left corner of the screen, there is now a Pen () icon that when clicked, will open a new drawing panel.

Draw Index Card button

The Draw Index Card panel is very similar to the Draw Background panel and you have options for color, brush size, etc… If you need to erase something, you can either use a white brush set or just trash the card and start again. Once you’ve completed your card, then you can click Upload and it will drop the new index card directly into the scene, as a token. This feature is available to all players. Not just the GM.

Draw Index Card Panel

NOTE: The Pen toggle disables or enables Pen Only Drawing. When toggled on, the panel will only respond to pressure-sensitive input, like a pen, and ignore something like your palm.

Behold! A new pile of gold!

Game Starting Time Countdown

GMs now have the option to include a countdown timer when they share game links with their players or prospective players. The GM can set the starting date and time in their own timezone and the countdown will translate the correct time in each of their player’s time zone.

On the Home Screen, after a game has been created and shows up in the GM’s Drawer, you should now see a new Schedule Icon (). Clicking that will open the Schedule Game panel.

Schedule Game Option

The Schedule Game Panel allows you to set a date and a time for your upcoming game. The Time option does use a 24-Hour Clock, so make sure you know if you’re meaning AM or PM. Once you have the time and date set, you can now click Start Countdown.

A Countdown Timer will then appear on the login page of that specific game. It shows the date, the time, and countdown until the game begins. This will adjust times according to the individual’s time zone.

NOTE: The Countdown Timer does not prevent you from logging and joining the game early.

Skull Dice Update

The Skull Dice have now been updated to either display skulls or nothing at all.

The Dice Tray

GMs and Players now have the ability to see a temporary history of all the dice they’ve rolled recently within a dice tray, on the right side of the screen. When a die is rolled, it is automatically added to the dice tray and after 1 minute (or by right clicking on a specific die) it will disappear. While it is in the dice tray, you can move dice around by clicking and dragging to group dice together. You can also click and drag a specific dice out of the dice tray to create a timer. Note that only your own dice rolls will appear in the dice tray, but you’ll still be able to see everyone’s rolls as usual.

To access the dice tray, just click on the tray once to open it. Click it again to close it.

As you make your rolls, color-coded dice will appear whether or not the dice tray is open or closed. While it is open, you can then click and drag the dice to move them around or drag them outside of the tray to create a timer.

Two VDS rolls grouped together for easier adding

[KaneDriscol]

Quick Note:

Back in version 1.2.3 (I believe), a ping feature was released that I completed forgot to include in this guide and it was brought up on the Discord channel. Oops! My bad.

Anyway, the RHVTT does have a ping option! You just have to double click anywhere on the screen and a color-coded radiating ping will appear where you clicked. Additionally, if you are zoomed in, the screen will automatically center on the ping location.

Ping radiates from where you double clicked

[KaneDriscol]

=== RHVTT Update ===
The VTT is currently (10/16) rebooting to install a small fix (no new version number):
The GM name is now updated using the Patreon login if you re-join (clear your cache + relogin via Patreon)

Due to some changes in some Google APIs, we’ll have a couple of more minutes of downtime but hopefully will return in function soon

---

Modify GM Name in RHVTT

You can now modify your GM name within the RHVTT, by changing your Display Name within your Patreon profile, clearing all of your cookies for RHVTT in your browser, and then logging in. This will update the name displayed for logged in GMs here:

[KaneDriscol]

=== RHVTT Update ===
As announced, we’re hitting v1.4.1 with a few changes:
Workaround against those nasty broken tokens (showing labels but no tokens). Hopefully this isn’t happening anymore. Let me know if it continues to fail
Scenes are not break the scenes’ custom order if the active scene is deleted.
Workaround against players that were disconnected and cannot be kicked. That shouldn’t happen anymore hopefully . Let me know if it helps!
Increased file size for ZIP files (archived games) to 30 MiB.
The game schedule countdown now includes days if appropriate.

[KaneDriscol]

=== RHVTT-Update ===
We’re hitting v1.4.2 with some minor tweaks:
Stepping music volume fixed (shouldn’t go like 1%, 1%, 3% but 1% 2% 3%)
Music player remembers volume from the last session
Resetting the players’ box position now uses the correct vertical position
GMs can now see their players’ “User Agents” (= browser version, OS version - could be useful to report bugs) by hovering their name. The feature is only visible for GMs to avoid UI cluttering for regular players.
Roll multiple dice at once by hovering a dice and pressing a number (1-9) without clicking that often. That may become useful for VDS… idk, let me know!|

[KaneDriscol]

I put together a video version of this Feature Guide here in a YouTube Playlist. I thought it would be easier to focus on individual pieces of the VTT rather than just doing a long overview. Hopefully it helps!

One important note to mention is that I mispronounced glocke’s name in the first video. The name is “glocke” with an “eh” at the end. My apologies! I’ll get it fixed soon!

[Fuzzymagoo]

Fantastic! Watched a couple already, super helpful.