Gothic Virtual Tabletop

Released: Feb 6, 2024
Platforms
Last updated: 15 Sep 2026, 00:00 GMT

Updates & announcements

20 posts

18 Oct 2025Developer post
Some Stuff
# add macro self.set_rotation(x), where x is the angle in degrees # add '.dice' to variables that hold the value of a dice roll. Showing this value shows a sorted list of the rolls, with low and high rolls highlighted. # fix issue with execute_macro where passed string variables
19 Aug 2025Developer post
I'm sick so here's an update! Whee!
Add evaluate_roll() macro function Used on an existing local variable holding the result of rolled dice in order to evaluate additional roll options such as counting instances of rolled numbers, getting the highest/lowest values, and most other roll options allowed by the roll()
Add evaluate_roll() macro function
Used on an existing local variable holding the result of rolled dice in order to evaluate additional roll options such as counting instances of rolled numbers, getting the highest/lowest values, and most other roll options allowed by the roll() macro function.
Add get_digit() macro function
Used to get a specific digit of a number, such as the tens place of a d100 roll.
get_digit(69, 100) => 0
get_digit(69, 10) => 6
get_digit(69, 1) => 9
Tokens you pick up will now be moved to the highest visible layer, (with the exception of tokens with 'Token is clickable' set to false on their token's settings page). This means the latest moved token will be displayed above tokens that have not moved recently.
update documentation with new macro functions.
Original post
11 Apr 2025Developer post
Drawing Tool Update 2, Electric Boogaloo
Add new drawing modes (Circle, Square, Cones 45,60,90 degrees) click the drawing tool button to cycle between drawing modes. The eraser tool will use the current drawing mode for its erasing. You can also cycle through drawing modes by clicking the eraser button. When in circle,
Add new drawing modes (Circle, Square, Cones 45,60,90 degrees)

click the drawing tool button to cycle between drawing modes.
The eraser tool will use the current drawing mode for its erasing.
You can also cycle through drawing modes by clicking the eraser button.
When in circle, square, or cone drawing/erasing mode, the pen size slider instead toggles between drawing the outline of the shape, and filling in the shape.
Gothic's whiteboard was designed for quick and dirty drawings, not sprawling exquisite artworks. I do not have the knowledge nor drive to optimize the whiteboard at this time.

Drawing large shapes WILL cause lag briefly while drawing the shape. Once a large shape is drawn, there is little to no performance impact on regular gameplay.
Swapping between maps with tons of (or several large) drawings will be slower than swapping to the same maps with little to no-drawings.
Original post
05 Apr 2025Developer post
Ruler Improvements
Add circle and cone (45, 60, 90 degree variants) ruler options. To change your ruler: Click the ruler tool button to enter ruler mode Click the ruler tool button to cycle through the modes And just like every other tool, right click to leave the ruler mode.
Add circle and cone (45, 60, 90 degree variants) ruler options.
To change your ruler:

Click the ruler tool button to enter ruler mode
Click the ruler tool button to cycle through the modes
And just like every other tool, right click to leave the ruler mode.
Original post
26 Mar 2025Developer post
Improve draw/erase tool
When you select the pencil/eraser tool from the top menu bar, a slider will appear under those buttons allowing you to change the pen size. The technology is here, people. We made it.
22 Feb 2025Developer post
link_macro update
Allow you to provide runtime arguments to macros executed from link_macro(). This change will not break any macros. New usage of link_macro(): link_macro( token , "macro_name" , arg0 , arg1 , ... , argn ); link_macro(self, "Take Damage", 7, "Goblin Spear"); See documentation for
11 Feb 2025Developer post
Misc Tweaks
Fix ruler distance on maps with grid type set to 'none', the cell size and distance_per_cell now properly interact. Increase default token import size to 256x256, previously the default was 100x100. For larger tokens this led to badly pixelated images. * * You can always import t
Fix ruler distance on maps with grid type set to 'none', the cell size and distance_per_cell now properly interact.
Increase default token import size to 256x256, previously the default was 100x100. For larger tokens this led to badly pixelated images. *
* You can always import tokens that are larger sizes than 256x256, just check the 'keep aspect ratio' box. This not only allows you to create non-square dimension tokens that don't get deformed, but also keeps the dimensions of the original image.
Original post
22 Jan 2025Developer post
Battlecry and On Turn Macro Scripts
This update adds two tabs to the Macro character sheet tab. One is 'Battlecry', and the other is 'On Turn'. Both tabs have a text box for you to enter a macro script. You can leave them blank. The script in the 'Battlecry' tab is executed when a token is first dragged out from th
This update adds two tabs to the Macro character sheet tab. One is 'Battlecry', and the other is 'On Turn'.
Both tabs have a text box for you to enter a macro script. You can leave them blank.
The script in the 'Battlecry' tab is executed when a token is first dragged out from the token drawer onto a map.
The script in the 'On Turn' tab is executed every time the token receives initiative in combat, or at the start of each of its turns in combat.
Suggested Uses:

Randomize initial health of non-unique tokens (automatically roll health for each goblin in an encounter)
Reset energy / mana / action counter/ at the start of a turn.
start of turn heal effects (monsters with regeneration)
and many more!
Original post
13 Jan 2025Developer post
is_clickable, keep_middle, show_name_on_hover
add "keep_middle" argument to roll() macro function (docs updated) "keep_middle" lets you keep x median values from a set of rolls. (If keeping_middle on an even number of rolls, the lower of the two 'median' values will always be picked.) add "is_clickable" token setting, found
add "keep_middle" argument to roll() macro function (docs updated) "keep_middle" lets you keep x median values from a set of rolls. (If keeping_middle on an even number of rolls, the lower of the two 'median' values will always be picked.)
add "is_clickable" token setting, found on the token's character sheet 'settings' tab. When checked, you will be able to pick up, select, or open the token's character sheet with a left click (or double click) as usual. When unchecked, you will only be able to select the token by clicking and dragging a select box around it. Once selected, you'll be able to move the token or open it's character sheet as usual.
add "show_name_on_hover" token setting, found on the token's character sheet 'settings' tab. When checked, hovering the mouse over the token will show its name, as usual. When unchecked, hovering the mouse over the token will not show its name. If you have selected the token, its name will always be shown.
Original post
11 Jan 2025Developer post
is_valid_variable()
Added macro function 'is_valid_variable( var_name )' Added script comments * (Comments begin with the pound sign '#', and MUST END WITH A SEMICOLON, just like any other line.) Any line beginning with a '#' will not be executed as a part of the macro. documentation updated Fixed b
Added macro function 'is_valid_variable(var_name)'
Added script comments * (Comments begin with the pound sign '#', and MUST END WITH A SEMICOLON, just like any other line.) Any line beginning with a '#' will not be executed as a part of the macro.
documentation updated
Fixed bug where multiple tokens in a stack would scale up as if they were all picked up. Only the top token (fully visible token) in a stack will be picked up.
is_valid_variable(var_name)
This function will return true if var_name is a variable with an assigned value in the current macro script, otherwise it will return false.
I'm using this in a macro to test and see if the macro was provided any runtime arguments (arg0), which changes what the macro should do.
Here's a snippet of a macro that checks if a variable (in this case a macro's runtime argument arg0) is valid in order to change the macro's behavior:
if is_valid_variable(arg0) { target = pick_token(); target_value = self.get_value("skills/Small Guns/value") - target.get_value("armour/locations/head") - self.RAD_PENALTY; show(self.get_value("bio/name") + " fires their " + arg1); } else { target_value = self.get_value("skills/Small Guns/value") - self.RAD_PENALTY; } ... ... ...
if is_valid_variable(arg0) {

All of my weapon macros pass the weapon's damage and name to the macro of the appropriate skill for the weapon used. So If I am shooting a Beretta M9, I run the "Small Guns" macro with "2d6" and "Beretta M9" as runtime arguments. So, if arg0 is a valid variable (if arg0 has a value assigned to it) then I know I am attacking attacking someone. In that case, we want to adjust our target number by the enemy's armour value.
}
else {

If we are just running the 'Small Guns' macro on its own (like in a circus' shooting gallery), then arg0 will NOT be a valid variable (it will have no value assigned to it), and the target number will just be the value of our "Small Guns" skill, and there is no need to choose a target.
}
Original post
09 Jan 2025Developer post
hotfixes
more like sexy fixes you know what I'm saying
07 Jan 2025Developer post
Macro Rework
This update brings the long awaited New Macro System! For anyone currently running a campaign, YOU AND YOUR PLAYERS should switch to the 'classic-macros' beta branch BEFORE you open the campaign on this new update. You can switch to the classic-macros' beta branch like this: Go t
This update brings the long awaited New Macro System!
For anyone currently running a campaign, YOU AND YOUR PLAYERS should switch to the 'classic-macros' beta branch BEFORE you open the campaign on this new update. You can switch to the classic-macros' beta branch like this:

Go to your steam library
Right click Gothic VTT, and click 'Properties'
Go to the 'Betas' tab
In the top right, click the drop-down menu and select 'classic-macros'
If you open an old campaign on the new update, all is not lost. All of your macros should just work. They will most likely not have full functionality, but at the very least any die rolls in your macros should still roll dice to chat. Anything in the 'text' and 'meta' field of classic macros will not do anything.
I should also mention that the 'classic-macros' branch is considered deprecated, and the following changelog does not apply to that branch. The 'classic-macros' branch will not receive any more updates, except in very rare circumstances. If you have any questions, reach out.
Changelog

+ fix map grid offset changing moves all tokens, not just those on the specific map
- double click on maps in map drawer no longer moves players. (left click to move GM, right click to move players)
+ add slime connecting/receiving files animation (ty MF)
+ add small border to (token and chat) drawer handles
- lessened token 'popping' effect when picking up a token
+ Improved clarity of the targeting cursor to help it contrast more with maps/ tokens
+ fixed a crash that occurred when someone fat-fingered a '\' in a chat roll command.
+ adding a weapon/spell from the compendium to a token who already has that item will update the macro to match the compendium value
+ add party_notes syntax highlighting between these symbols: @#$%^&*. (This isn't final, just temporary while I work on a nicer solution utilizing bbcode tags.)
+ fix token copy-paste issue where the token clipboard would not be updated by new copy attempts
+ add bulk character sheet editor (This edits tokens in the token drawer only, and by extension edits ONLY 'Unique' tokens that have been placed on maps. Non-unique tokens currently on maps will not be edited)
+ hide 'Campaign' button on server start/ connect to free up space on the top menu bar.
Bulk Character Sheet Editor
The bulk sheet editor can be opened by clicking the new button between the 'Edit Map' and 'Fog Of War' buttons on the top menu bar.
When opening the bulk character sheet editor you first select which token's character sheets you'd like to change. Once the character sheet opens, you'll see character sheet entries that ALL of the selected sheets share. if the values of a particular field match, you will see the shared value. If the character sheets have different values for a field (such as the token's name) you will see an ellipsis (...) in place of the value. When the bulk character sheet is saved, any fields with an ellipsis will be replaced with the value originally on that token's character sheet. All other values will overwrite the token's originals.
WARNING: When using the bulk character sheet editor, ALL selected character sheets will become (nearly) exact copies of the visible sheet. If you do not see the macro/ inventory entry/ weapon/ spell/ attribute/ etc on the bulk sheet editor, it WILL NOT be present when you save.
Sheets will only be saved when you click the red floppy disc icon. I'd recommend making some copies of the tokens/ folder in your campaign directory and playing with the bulk character sheet editor to make sure you understand its quirks.
Macro Changes
My holidays were busier than expected (oops) so there is NOT a macro conversion guide. For questions I direct you to the new macro documentation (linked below), and also to the Gothic VTT Discord Server. If you would like help converting a macro, please make a thread in the #macro-conversion-help channel and I'll help you as quickly as I can.
See new documentation here (you can also access the documentation in your steam library after clicking on Gothic VTT, or in-game by clicking on the blue 'i' information button and going to the credits + documentation tab.)
New functions:

+ add link_macro() function Allows you to link a macro in chat, so anyone can run that macro by clicking the link.
+ add set_aura() function Allows you to edit a token's auras in macros
+ pick_token() function lets you choose a token to be a target of macro functions
- remove print_spell() in favor of generic link_compendium()
- remove target() function in favor of pick_token()
and many more!
Original post
09 Dec 2024Developer post
New Macros Are Coming (soon)
If you are currently running a game using Gothic VTT, you and your players need to switch to the 'classic-macros' beta branch. To switch to a beta branch: Go to your steam library Right click Gothic VTT, and click 'Properties' Go to the 'Betas' tab In the top right, click the dro
If you are currently running a game using Gothic VTT, you and your players need to switch to the 'classic-macros' beta branch.
To switch to a beta branch:

Go to your steam library
Right click Gothic VTT, and click 'Properties'
Go to the 'Betas' tab
In the top right, click the drop-down menu and select 'classic-macros'
That's it!
Classic macros will not be able to be converted to the new system 100% automatically, things have changed a bit too much for that. The macro/compendium documentation will be updated along with the update, and there will most likely be a macro migration guide as well.
This upcoming update also has a sizable list of tweaks and fixes, which will be listed in the notes of this imminent update.
F.A.Q.
"New macros when?"
- Soon :)
Original post
04 Oct 2024Developer post
Florida Man Adds Feature to Gothic VTT
This update comes with one 'breaking' change: default_character_sheet.json is no longer located in the base campaign folder, it is now in the tokens/ folder. This change will happen automatically for you when you open an existing campaign. There is nothing you need to do. changes
This update comes with one 'breaking' change: default_character_sheet.json is no longer located in the base campaign folder, it is now in the tokens/ folder. This change will happen automatically for you when you open an existing campaign. There is nothing you need to do.
changes:

fixed something small, I don't even remember what it was
Added the ability to save a character sheet as a 'template.' Learn more below!
Character Sheet Templates
Think of character sheet templates as multiple 'default' character sheets. When you create a new token, you will get to choose from a list of available templates you have created.
To create a new character sheet template:

Open the character sheet you want to base the template off of.
Go to the character sheet's 'Settings' tab.
At the bottom right of the window, type in a name for the new sheet template (or choose an existing sheet template to overwrite)
Click the appropriate button for what you want to do (either 'Overwrite Existing' to update a template, or 'Make New Template' to create a new one.)
That's it!
To use a character sheet template:

Drag in an image file.
In the asset importer, choose 'Token'
The window will change and you will see a drop-down menu.
Choose the template you want to use for the token from the drop-down menu.
Click 'Add Token'.
Original post
28 Sep 2024Developer post
Min and Max fixes
Changes add link_table(visible_text, table_name) macro meta function add link_compendium(category, entry) macro meta function fix min(a,b) and max(a,b) not simplifying equations or dice expressions in some cases. fix link_roll(display_text, roll_string) macro meta function not ha
Changes

add link_table(visible_text, table_name) macro meta function [1]
add link_compendium(category, entry) macro meta function [1]
fix min(a,b) and max(a,b) not simplifying equations or dice expressions in some cases.
fix link_roll(display_text, roll_string) macro meta function not handling roll functions as a part of the roll_string
1. See documentation .pdf for examples
Original post
26 Sep 2024Developer post
The Custom Compendium Categories and Random Stuff Update
Changes: Fixed a crash that occurred when connecting clients received certain network packets out of order. Fixed token status icons not appearing correctly when toggled by players instead of the GM. Add string equality comparison support for if() meta functions. Scrolling (with
Changes:

Fixed a crash that occurred when connecting clients received certain network packets out of order.
Fixed token status icons not appearing correctly when toggled by players instead of the GM.
Add string equality comparison support for if() meta functions.
Scrolling (with the mouse wheel) on compendium tabs and character sheet tabs will change the open tab. [1]
Compendium categories can now be customized. Choose what default compendium .json files are loaded, and add arbitrary custom categories.
1. The actual clickable tab labels do not scroll to follow the tab changes as you would expect, yet. This is a problem with the current Tab system, and will need a custom solution that will take a bit of work. It will be fixed eventually!
To customize your compendiums:

Navigate to your campaign's folder, found at: Windows: %APPDATA%\Godot\app_userdata\Gothic_VTT\campaigns\local Linux: ~/.local/share/godot/app_userdata/Gothic_VTT/campaigns/local
Open the "campaign_properties.json" file, which will look something like this: { "default_map": "default_map", "init_sort": false, "compendium": [ "weapons.json", "armour.json", "items.json", "spells.json", "abilities.json", "tables.json" ] } If your file is missing the "compendium": [] portion, open your campaign in Gothic VTT and then hit Control+S or close Gothic VTT to save the campaign. This will update the campaign_properties.json.
The order of the various "x.json" files in campaign_properties.json is the order that the tabs will appear in the in-game compendium, if you use one tab more than the others move it toward the top of the list.
Remove any .json files from below the line with "compendium" (line 4) you don't use, or add entries for custom compendium categories for things like vehicles, monster manuals, merchant inventories, etc.
Custom compendium .json files should contain an Array of Dictionaries, use the example file below if you don't understand the assignment.
Each dictionary should have a "name" and "description" key, whose roles are self explanatory.
Here are the contents of an example "vehicles.json":
[ {"name":"Car", "description": "Four wheels, very very fast."}, {"name":"Bicycle", "description": "Two wheels, faster than walking."}, {"name":"Plane", "description": "Many wheels, but flies instead. Much faster than a car!"}, ]
After updating the campaign_properties.json or any of the compendium .json files, you can refresh the compendium in-game using the 'Refresh' button on the compendium tab.
Original post
23 Sep 2024Developer post
ALERT ALERT ALERT
add ping feature (right click on the map to ping) fixed an issue where macro meta functions were resolved in the wrong order, resulting in confusing output. Campaigns autosave every 3 minutes (new), in addition to when you close the application (old), and when pressing ctrl+s (ol
add ping feature (right click on the map to ping)
fixed an issue where macro meta functions were resolved in the wrong order, resulting in confusing output.
Campaigns autosave every 3 minutes (new), in addition to when you close the application (old), and when pressing ctrl+s (old).
added /tgm and /tablegm chat commands to roll on a table only to the GM.
reduced overall amount of network traffic
Original post
12 Sep 2024Developer post
several things fixed. Also added ability to copy-paste tokens on and across maps
fixed a (rare-ish) crash when adding tokens to initiative add copy + paste for tokens on maps (GM only.) Ctrl+C to copy selected tokens. Ctrl+V to paste the copied tokens. You can copy paste across maps. fix green token select disc scaling issues fix initiative arrow pointing to
fixed a (rare-ish) crash when adding tokens to initiative
add copy + paste for tokens on maps (GM only.) Ctrl+C to copy selected tokens. Ctrl+V to paste the copied tokens. You can copy paste across maps.
fix green token select disc scaling issues
fix initiative arrow pointing to nothing sometimes
fix initiative arrow only appearing for GM.
Original post
04 Sep 2024Developer post
Custom Chat Tooltips
It is live. It has colors, it will never hide off screen, it is new and improved. What more could you want? Perfection? Bah, perfection comes long after good enough.
03 Sep 2024Developer post
The Big Mini-Update Update
This update contains various additions, tweaks to existing features, and fixes. Most changes are thanks to wdaoygtp on discord, thanks again! Changelog: add min(a, b) and max(a, b) functions for macros add drop-down menus to the input() macro function To use, add a comma separate
This update contains various additions, tweaks to existing features, and fixes. Most changes are thanks to wdaoygtp on discord, thanks again!
Changelog:

add min(a, b) and max(a, b) functions for macros
add drop-down menus to the input() macro function To use, add a comma separated list of values inside the parenthesis. Examples: 1d20 + input(1, 2, 3, 4, 69, 420) In this example, when you run the macro you will get to choose whether to add 1, 2, 3, 4, 69, or 420 to your roll. 1d20 + [input(STR, DEX, CON, INT, WIS, CHA)] In this example, STR, DEX, CON, INT, WIS, and CHA are macro variable names, choosing one will add the value of that macro variable to 1d20.
Initiative tracker no longer automatically sorts when updating a token's initiative value. (If initiative values change in the middle of a round, you'll no longer lose where you are in the turn order.)
application will no longer crash when trying to add a weapon/armour/ability to a character sheet when there are no compendium entries of that type.
if() meta functions now accurately account for modified character sheet values via previous calls to set_value() in the same macro. NOTE: 'Take Damage' and 'Heal' macros from the default "d20 + modifiers" campaign preset in campaigns made before today will incorrectly calculate whether a token is dead or not. Below are the updated macro meta fields to paste into existing character sheets: Heal macro meta field: set_value([hud/HP/value], [hud/HP/value] + input()); if([hud/HP/value] > 0, true=set_status(dead, false)) Take Damage macro meta field: set_value([hud/HP/value], [hud/HP/value] - input()); if([hud/HP/value] <= 0, true=set_status(dead, true))
tokens with even dimensions (2x2, 4x4, 6x6, etc.) now align onto the grid. This doesn't quite feel perfect yet, more tweaks to follow.
full roll strings for macro roll fields are now hidden in the tooltip. With particularly complex macros, the chat roll result tooltip could get too wide for your monitor very quickly. For now, I've hidden the full roll string from the tooltip, which will ensure the actual die rolls are visible at all times. Just to make things clear: You can still see all of the dice rolls in a macro, just not the formula/ equation at the top. It's not ideal, but the actual die rolls are more important most of the time anyway. I'm working on implementing custom tooltips that won't suck.
Original post

Updates & announcements

is_valid_variable(var_name)

Changelog

Bulk Character Sheet Editor

Macro Changes

If you are currently running a game using Gothic VTT, you and your players need to switch to the 'classic-macros' beta branch.

To switch to a beta branch:

changes:

Character Sheet Templates

Changes

Changes:

To customize your compendiums: