Character Vault
Any Concept / Any System
Compendium
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Difference between revisions of "Game Management"

From Roll20 Wiki

Jump to: navigation, search
(Inviting and Managing Players)
m (Creator)
 
(45 intermediate revisions by 9 users not shown)
Line 1: Line 1:
= My Games Page =
+
{{revdate}}{{HCbox| {{hc|articles/360039715753-Game-Management Here}} }}
The '''My Games''' page, you can join games, create games, manage the games you are a part of. It is accessible either by clicking on the '''[https://app.roll20.net/campaigns/search/ Games]'''  option on the Site's main navigation bar or clicking on the '''My Games''' option from the '''Games''' drop-down menu when you hover your mouse there.
+
[[File:Game Details Page-v2.jpg|border|right|500px|The "Game Details" page for a game.]]This is a page detailing how to manage and changes settings for individual Games/Campaigns. See the '''[[My Games]]'''-page for info on all of your games.
  
[[File:Game List Page v02.jpg||border]]
+
=Game Details Page=
 +
Each [[creator|game you create]] in Roll20 has its own dedicated Details Page. This is where [[player]] invites can be managed as well as changing any of the game’s settings. Before they hop into the VTT, this is also the first page new players see after accepting an invite to a game. From this page, [[players]] can keep track of in-between session content, such as the next game session's date as well as asking questions and starting discussions via the game’s dedicated private forum.<br />
  
== 1. Game Search ==
 
Across the top of the '''My Games''' page is a search bar.  If you have a large list of games, this search bar will filter your '''Game List''' based on either Tags or Keywords used by the games you've created and the games you are a player of.
 
  
== 2. Game List ==
+
The '''[[Game Settings Page]]''' contains a number of settings such as what [[Character Sheet|character sheet]] is used and it's default settings, as well as {{Compendium}} settings, such as [[Compendium Sharing]].
 
+
The bulk of the page is taken up by the Game List, which shows all the games you can access.  Each listed game shows several pieces of information:
+
* Click the '''Game Title''' to be taken to the '''Game Details''' page.
+
* The '''Game Image''' will also take you to the '''Game Details''' page.
+
* '''Launch Game''' will take you straight into the tabletop for the game.
+
* '''Player Icons''' are listed for each game, showing you who else plays that game.
+
* The '''Last Played On''' date tells you when last the game was in session.
+
** Games created by you have a '''Creator''' badge.
+
** Games you are a Co-GM on have a '''GM''' badge.
+
** Games you are a player in are unadorned.
+
 
+
 
+
== 3. Buttons ==
+
At the top right are a collection of buttons for creating, copying, and adding games to your Game List.
+
* '''+ Create New Game''' takes you through the game creation process to set up a new game.
+
* '''Access the Dev Server''' takes you to the Developer's Server, a ''Pro'' subscription perk.
+
* '''Copy from Dev''' takes you to a page that lets you copy a game from the Developer Server to the Production Server, a ''Pro'' subscription perk.
+
* '''Find a Group''' takes you to the Looking for Group Tool, so you can find more games to join.
+
 
+
 
+
== 4. My Tags ==
+
On the right edge is the '''My Tags''' box lists all the tags you have defined in decreasing order by how many games have them.  You can click a tag to instantly filter the list down to the games that include that tag.
+
 
+
=Game Details Page=
+
[[File:Game Details Page.jpg|border|right]]
+
Each game you create in Roll20 has its own dedicated Details Page. This is where player invites can me managed as well as changing any of the game’s settings. Before they hop into the VTT, this is also the first page new players see after accepting an invite to a game. From this page, players can keep track of in-between session content, such as the next game session's date as well as asking questions and starting discussions via the game’s dedicated private forum.<br />
+
  
 +
__TOC__
 
==Inviting and Managing Players==
 
==Inviting and Managing Players==
 
On the right hand side of this page is where you can invite and manage the players who will join your game. Within a single game, there are three different roles that a Roll20 user can assume:
 
On the right hand side of this page is where you can invite and manage the players who will join your game. Within a single game, there are three different roles that a Roll20 user can assume:
====Creator====
+
====[[Creator]]====
The game’s Creator is the Roll20 user who originally created the game. There is only ever one Creator for a Roll20 game. They have complete control over all of the game's settings and any subscription perks (Dynamic Lighting, F/X Tool, API Scripts, etc…) that the game can benefit from is based on what the creator’s account is currently subscribed as. Likewise, content such as Game Addons must be bought on the Creator’s account in order for them to be added to the game.<br />
+
The game’s [[Creator]] is the Roll20 user who originally created the game. There is only ever one Creator for a Roll20 game. They have complete control over all of the game's settings and any [[subscription]] perks ([[Dynamic Lighting]], F/X Tool, [[Mod|Mod Scripts]] , etc…) that the game can benefit from are based on which subscription level the creator’s account currently has. Likewise, content such as Game Add-ons must be bought on the Creator’s account in order for them to be added to the game.<br />
  
The Creator’s profile image and name  is highlighted in purple in the upper right corner of this page. General user stats such as their account creation date and collective hours played are also listed. Clicking on either their name or their profile image will navigate to their Profile Page.
+
The Creator’s profile image and name  are highlighted in purple in the upper right corner of this page. General use stats such as the account creation date and collective hours played are also listed. Clicking on either their name or their profile image will navigate to their Profile Page.
====Player====
+
Anyone else who joins the game will be listed as a Player. This section is listed right underneath the Creator in light grey. Players who join the game will be listed in this section with their profile icon followed by their name underneath. Their order are listed chronological by when they first joined the game.
+
====GM====
+
[[File:GM Promotion.png|framed|left|Player Steve has been Promoted to the GM Role. His profile image now has a "GM" icon displayed over it to note the role.]]
+
The Creator of the game can promote one or more Players in a game to the role of '''GM'''. A GM is granted access to alter, add, and delete most of the game's content within Roll20 as well as access a couple of features from the Game Details Page. For this reason, the Creator should practice discretion when promoting Players to this role so these privileges are not abused. A GM, like the Creator, will load into the game on the VTT in GM Mode rather than Player Mode.<br />
+
  
A GM has access to the following:<br />
+
====[[Player]]====
 +
Anyone else who joins the game will be listed as a '''[[Player]]'''. This section is listed right underneath the Creator in light grey. Players who join the game will be listed in this section with their profile icon followed by their name underneath. They are listed chronologically by when they first joined the game.
 +
 
 +
====[[GM]]====
 +
[[File:GM Promotion.png|framed|right|Player Steve has been Promoted to the GM Role. His profile image now has a "GM" icon displayed over it to note the role.]]
 +
The Creator of the game can promote one or more Players in a game to the role of '''[[GM]]'''(Game Master). A GM is granted access to alter, add, and delete most of the game's content within the game, as well as access a couple of features from the Game Details Page. For this reason, the Creator should practice discretion when promoting Players to this role so these privileges are not abused. A GM, like the Creator, will load into the game on the VTT in GM Mode rather than Player Mode.<br />
  
''Within the VTT''
 
* Full access to all Page Layers
 
* Create, Modify, and Delete Pages
 
* Place images and tokens to the Tabletop from their personal image library (not the Creator's library)
 
* Assign and edit tokens
 
* Create handouts and characters, assign their view and edit permissions
 
* Move the Player Ribbon to different Pages
 
* Add, Remove, and Play music from the Jukebox
 
* See GM Whispers and Rolls in Chat
 
* Create Macros and Token Actions
 
* Modify Dynamic Lighting on a Page if the game's Creator is a paid Roll20 subscriber
 
* Access to all in-game options on the Settings Tab in the VTT ''except'' the Transmogrifier
 
<br />
 
''Outside the VTT''
 
* Invite Players (''anyone'' can share the unique join link to the game)
 
* View and Edit API Scripts (Creator must be a Pro Subscriber)
 
* Manage the game's private forum, including sinking and deleting posts<br />
 
<br />
 
  
 
A promoted player will have a blue “GM” tag added to the upper left of their profile icon in the Player List.<br /><br />
 
A promoted player will have a blue “GM” tag added to the upper left of their profile icon in the Player List.<br /><br />
 
  
 
===Inviting, Promoting, and Removing Players From a Game===
 
===Inviting, Promoting, and Removing Players From a Game===
Line 81: Line 36:
  
 
====Removing a Player From the Game====
 
====Removing a Player From the Game====
* ‘’’Kick from Game’’': This will remove the Player from the game and change the unique join link URL of the entire game. This will prevent the Player from attempting to rejoin with the previous join link.<br />
+
* ‘’’Kick from Game’’': This will remove the [[Player]] from the game, and change the unique "Invite Player" link URL of the game, disabling to old url. This will prevent the Player from rejoin the game with the previous join link.<br />
 
<br />
 
<br />
  
Selecting either of these two options will cause the page to reload to process the new changes.<br />
+
To invite back a previously kicked player to the game, you need to share them the new invite link.
  
 +
Selecting either of these two options will cause the page to reload to process the new changes.<br />
 +
[[File:Game Details Page-v2.jpg|border|right|550px|The "Game Details" page for a  game.]]
 
==Managing Your Game==
 
==Managing Your Game==
 
The rest of this page covers information and settings for the game. Most of these options can only be altered by the game’s Creator.<br />
 
The rest of this page covers information and settings for the game. Most of these options can only be altered by the game’s Creator.<br />
  
 
===Game Icon===
 
===Game Icon===
At the top of the Game Details page is the '''Game Icon''', which is an image  used to represent your game in the '''Game List''' and '''Looking For Group Listing''' (if enabled). This image also helps convey the game’s theme to your players when they join it.  To set the image, either drag the desired image to this section, or click the '''Choose a File...''' button to be prompted to find an image file on your computer.  This uploaded image will be added to your '''[[Art Library]]'''. Once one is added, you can change the image to something else by hovering your mouse over this area and clicking the '''Change Image''' link that appears.<br />
+
At the top of the Game Details page is the '''Game Icon''', which is an image  used to represent your game in the '''Game List''' and '''Looking For Group Listing''' (if enabled). This image also helps convey the game’s theme to your players when they join it.  To set the image, either drag the desired image to this section, or click the '''Choose a File...''' button to be prompted to find an image file on your computer.  This uploaded image will be added to your '''<span style="font-family:Pictos;">P</span> [[Art Library]]'''. Once one is added, you can change the image to something else by hovering your mouse over this area and clicking the '''Change Image''' link that appears.<br />
  
 
===Game Name===
 
===Game Name===
Line 100: Line 57:
 
[[File:GameDetails Menu Content.png|thumb]]The '''Content Button''' has two menu options available when clicked: '''Chat Archive''' and '''External Journal'''. <br />
 
[[File:GameDetails Menu Content.png|thumb]]The '''Content Button''' has two menu options available when clicked: '''Chat Archive''' and '''External Journal'''. <br />
 
<br />
 
<br />
The Chat Archive will open a new window that displays the entire chat history of the game. There is a button in the top right that '''Hide Whispers''' in the chat log. Players can only see Whispers and GM rolls they were originally a participant of.<br /><br />
+
The Chat Archive will open a new window that displays the entire chat history of the game. There is a button in the top right to '''Hide Whispers''' in the chat log. Players can only see Whispers and GM rolls of which they were originally a participant.<br /><br />
External Journal Access is available for games where its Creator is a paid subscriber. This option redirects to a new page where GMs can view all journal entries for unarchived Characters and Handouts within the game. Players also have access and can view any Characters or Handouts they have control permissions of within the game. Only the Bio & Info tab of a character is accessible from the External Journal. An individual's Character Sheet or Attributes and Abilities tabs can only be accessed within the VTT.<br style="clear:both;" />
+
External Journal Access is available for games with Creators who are paid subscribers. This option redirects to a new page where GMs can view all journal entries for unarchived Characters and Handouts within the game. Players also have access and can view any Characters or Handouts they have control permissions of within the game. Only the "Bio & Info" tab of a character is accessible from the External Journal. An individual's "Character Sheet" or "Attributes and Abilities" tabs can only be accessed within the VTT.<br style="clear:both;" />
  
 
===Looking for Players===
 
===Looking for Players===
 
[[File:GameDetails Menu LookingForPlayers.png|thumb]]
 
[[File:GameDetails Menu LookingForPlayers.png|thumb]]
The Looking for Players menu allows a game's Creator to create or manage a [[Looking for Group|Looking for Group listing]].  Adding their game to Roll20's game directory will allow other Roll20 users to find and apply to join to it. You must include some basic information about your game in order to list it, including the type of game that you'll be playing and the date and time of the next game to be played.<br style="clear:both;" />
+
The Looking for Players menu allows a game's [[Creator]] to create or manage a [[Looking for Group|Looking for Group listing]].  Adding their game to Roll20's game directory will allow other Roll20 users to find and apply to join to it. You must include some basic information about your game in order to list it, including the type of game that you'll be playing and the date and time of the next game to be played.<br style="clear:both;" />
  
===Game Settings===
+
===Settings===
 
[[File:Game_Settings_Menu_Options.jpg|thumb]]The Settings menu provides several options for the game. The game's Creator can access all of these options, while Promoted GMs have limited access. Players only have access to the '''Leave Game''' option detailed below.<br />
 
[[File:Game_Settings_Menu_Options.jpg|thumb]]The Settings menu provides several options for the game. The game's Creator can access all of these options, while Promoted GMs have limited access. Players only have access to the '''Leave Game''' option detailed below.<br />
 
====Game Settings====
 
====Game Settings====
This option displays the [[Game Settings Page]].
+
{{main|Game Settings Page}}
 +
 
 +
The [[Game Settings Page]] contains a number of settings such as what [[Character Sheet|character sheet]] is used and it's default settings, as well as {{Compendium}} settings such as [[Compendium Sharing]].
 +
 
 
====API Scripts====
 
====API Scripts====
This option will give the game’s Creator and GMs access to the [[API:Introduction|API Script Editor]]. The game's Creator must be a Pro subscriber for this feature to be available.
+
This option will give the game’s [[GM#Creator|Creator]] and GMs access to the [[API:Use_Guide#The_Script_Editor|API Script Editor]]. The game's Creator must be a {{Pro}} subscriber for this feature to be available.
 +
 
 +
====[[Convert Lighting]]====
 +
This is used to convert the Dynamic Lighting settings of pages and tokens from the [[LDL|Legacy Dynamic Lighting]] to [[UDL|Updated Dynamic Lighting]].
 +
 
 
====Copy Game====
 
====Copy Game====
This option allows the Creator to create a duplicate of the current game on their account. They can rename the duplicate, change its tags, and decide which elements are carried over to the copy: Players and Player Settings (Including Macros), Pages, Decks and Rollable Tables, Chat Log, Journal (Characters & Handouts), Jukebox Playlist, or the Game Forums. Currently, the character sheet will default to None during a copy, so you’ll want to select the sheet you need for the copy. When you have everything designated for the duplicate, click the blue '''I'm ready, Create Game!''' button.
+
This option allows the Creator to create a duplicate of the current game on their account. They can rename the duplicate, change its tags, and decide which elements are carried over to the copy:
 +
 
 +
* Players and Player Settings (Including [[Macros]])
 +
* [[Page Toolbar|Pages]]
 +
* [[Decks]] and [[Rollable Tables]]
 +
* Chat Log
 +
* {{Journal}} (Characters & Handouts)
 +
* {{Jukebox}} Playlist
 +
* Game Forums
 +
 
 +
 
 +
Currently, the [[Game_Settings_Page#Character_Sheet_Template|Character Sheet Template]] will default to '''None''' during a copy, so you’ll want to select the same sheet to be used in the new game. When you have everything designated for the duplicate, click the blue '''I'm ready, Create Game!''' button.
 +
 
 
====Clear Chat Archive====
 
====Clear Chat Archive====
This option PERMANENTLY deletes the entire archived chat history from the game.
+
{{warning| "Clear Chat Archive" PERMANENTLY deletes the entire archived chat history from everyone.}}
 +
This option PERMANENTLY deletes the entire archived [[Chat Archive]] from the game.
 +
 
 +
Sometimes if the chat archive becomes corrupted, the {{Text Chat}} stops working, and it can be solved with Clearing the Chat Archive.
 +
 
 
====Delete Game====
 
====Delete Game====
 +
{{warning| Deleting game is irreversible for users, and shouldn't be done lightly. If you are lucky, Roll20 developers can recover the game for you.}}
 
This option opens up a dialog box to confirm the Creators’ decision to delete the game.
 
This option opens up a dialog box to confirm the Creators’ decision to delete the game.
====Roll Back Game====
+
====[[Rollback|Roll Back]] Game====
The Creator must have a Pro subscription to have access to this feature. Between the hours of 4 and 6 AM PST, a save state is made for every game on Roll20. Seven days’ worth of save states are kept on file before they’re rewritten with new save states. Pro users have the ability to roll back their game to any save state available from the past seven days to correct any drastic mistakes made to their game.<br />
+
{{pro only|section}}
 +
 
 +
Between the hours of 4 and 6 AM PST, a save state is made for every game on Roll20. Seven days’ worth of save states are kept on file before they’re rewritten with new save states. Pro users have the ability to roll back their game to any save state available from the past seven days to correct any drastic mistakes made to their game.<br />
  
 
To commit a rollback, click '''Roll Back Game'''. This brings up a dialog box that allows you to choose the date of the save state you would like to roll your game back to. Select the date and click on the pink '''Rollback''' button to initiate the rollback process. This may take a minute or two, but once finished, the Game Details Page will prompt you when the rollback has successfully completed. This process cannot be undone; however, you can choose to roll back again to a later save state you have available if you discover you’ve rolled back too far.
 
To commit a rollback, click '''Roll Back Game'''. This brings up a dialog box that allows you to choose the date of the save state you would like to roll your game back to. Select the date and click on the pink '''Rollback''' button to initiate the rollback process. This may take a minute or two, but once finished, the Game Details Page will prompt you when the rollback has successfully completed. This process cannot be undone; however, you can choose to roll back again to a later save state you have available if you discover you’ve rolled back too far.
 +
 
====Leave Game====
 
====Leave Game====
 
This option is only visible to Players and GMs invited to the game. Once a player leaves a game, they no longer have access to the game and it will no longer show up on their Games Page.<br />
 
This option is only visible to Players and GMs invited to the game. Once a player leaves a game, they no longer have access to the game and it will no longer show up on their Games Page.<br />
Line 138: Line 122:
 
This field is where the game Creator can set the date and time for the game’s next session. The time is automatically converted to the viewer's local timezone.<br />
 
This field is where the game Creator can set the date and time for the game’s next session. The time is automatically converted to the viewer's local timezone.<br />
  
Note: The time selector uses a 12-hour clock rather than a 24-hour clock. 12:00 AM is used to indicate Midnight (00:00) while 12:00 PM is used to indicate Noon.
+
Note: The time selector uses a 12-hour clock rather than a 24-hour clock. 12:00 AM is used to indicate Midnight (00:00) while 12:00 PM is used to indicate Noon. If you want a 24h clock option, it's recommended to vote & post in {{forum|post/1419527/24-hour-clock this suggestion}}.
 +
 
 
====Game Description====
 
====Game Description====
 
This is where a Game's Creator can add a blurb advertising what to expect out of the game, adventure flavor text, or provide pre-requisites for potential players. This free-form text field is for anything the Creator feels would be convenient for the Players to know.<br />
 
This is where a Game's Creator can add a blurb advertising what to expect out of the game, adventure flavor text, or provide pre-requisites for potential players. This free-form text field is for anything the Creator feels would be convenient for the Players to know.<br />
Line 145: Line 130:
  
 
===Game Addons===
 
===Game Addons===
[[File:Addons.png|framed|right|The Addon Section of the Game Details Page.]][https://marketplace.roll20.net/browse/search/?keywords=&sortby=newest&type=gameaddon&genre=all Game Addons], unlike Marketplace modules, are smaller content packages that are meant to enhance your existing games such as: custom card decks, maps, single encounter adventures and more. Once bought, these content packages are available via a dropdown menu in the Game Addons section of the Game Settings Page. Select the one you wish to add and click on the blue '''Add to Game''' button beside the drop-down menu. When a Game Addon is appended to the game, it will be added to a bulleted list underneath the "Addon in [Title of Current Game]" list. This list is shown underneath the addon drop down menu and the blue Add to Game button.<br /><br />
+
[[File:Addons.png|framed|right|The Addon Section of the Game Details Page.]] [[Addons]], unlike [[Marketplace]] [[Marketplace#Modules|modules]], are smaller content packages that are meant to enhance your existing games such as: custom [[card|card decks]], maps, single encounter adventures and more. Once bought, these content packages are available via a dropdown menu in the Game Addons section of the Game Details Page. Select the one you wish to add and click on the {{button|Add to Game|bluelight}} button beside the drop-down menu. When a Game Addon is appended to the game, it will be added to a bulleted list underneath the "Addon in [Title of Current Game]" list. This list is shown underneath the addon drop down menu and the blue Add to Game button.<br /><br />
  
 
{{mbox | text = Adding an Addon more than once will overwrite the previous version of that addon you currently have added to your game. You will lose any changes you may have made, but this will also assists a GM who made any edits by mistake and wish to revert back to the original copy of the Addon.}}
 
{{mbox | text = Adding an Addon more than once will overwrite the previous version of that addon you currently have added to your game. You will lose any changes you may have made, but this will also assists a GM who made any edits by mistake and wish to revert back to the original copy of the Addon.}}
Line 151: Line 136:
 
To remove any Game Addon content you've added to a game, you will need to delete it manually from inside the launched game. If you ever delete a Game Addon unintentionally, remove the Addon from the Addon List on the Game Details Page, then add it back in again.<br style="clear:both;" />
 
To remove any Game Addon content you've added to a game, you will need to delete it manually from inside the launched game. If you ever delete a Game Addon unintentionally, remove the Addon from the Addon List on the Game Details Page, then add it back in again.<br style="clear:both;" />
  
===Game Discussion Forum===
+
===[[Token Markers|Token Marker Sets]]===
Each game has an exclusive mini forum. It behaves exactly like the public Roll20 forums. Everyone in the game can create their own threads on this forum and also make replies. The game's Creator and GMs all have access to the Sink, Sticky, and Delete commands on individual posts within this forum.<br />
+
{{main|Token Markers}}
  
The Sink command will keep a thread at the bottom of the forum regardless of activity.<br />
+
You can add custom '''Token Marker Sets''' that fits to your games. These sets must have been create in the [https://app.roll20.net/marker-library Token Marker Library] beforehand to be accessible to add to individual games.
  
The Sticky Command will pin the thread to the top of the forum.<br />
+
===Game Patching===
 +
[[File:PatchUpdate.png|framed|center]]
 +
Occasionally, corrections need to be made to an existing module or game addon. A patch is made to correct the issues discovered. A notification will appear on the Game Details page when a patch is available for a module or addon installed on your game. Typically, a link will be included in the notification to the patch notes that lists all the changes that will be made by the patch.
  
The Delete command will remove the post's text from view by those who are not the Creator or GMs. Deleting the first post in a thread will remove the entire thread from the Game Discussion Forum.<br />
+
To preserve as much of your edited content as possible, patches only overwrite the tabletop elements that were directly changed by the patch. It's worthwhile to check the patch notes before updating your game in the off chance you need to duplicate some journal entries to preserve player or GM edited module/addon content. Additionally, if a patch is making changes to a Page you and your players are currently active on, you may want to wait to update your game until after the group is between dungeons/maps. That way elements such as tokens, DL, etc aren't reset mid-combat between gaming sessions.
  
This section of the Game Details Page only shows the ten most recent posts from the Game Discussion Forum. To see the entire discussion forum, click on the ‘’’View All Posts >’’’ link at the bottom of the Page.<br />
+
When you click on the '''Update''' button, your game will be sent into a queue to begin the update process. You can cancel the update while it's still sitting in queue and hasn't started processing. You will receive new notifications on the Details Page as a patch moves through the queue line to eventually begin processing the patch. This process can take a couple minutes to complete. Once done, you will receive a final notification that the patch has installed successfully.<br />
  
Clicking on the '''+ Post New Topic''' button redirect you to full Game Discussion Forum so that you can begin drafting a new forum thread.
+
==Game Discussion Forum==
 +
{{:Game Discussion Forum}}
  
 +
=See Also=
 +
* '''[[Game Settings]]''' The Settings that manages things related to [[Character Sheets]] & {{Compendium}} in individual games
 +
* '''[[User Interface|Roll20 Interface]]''' (inside the game)
 +
* '''[[My Games Page]]'''
 +
* [[Adding Character Sheet|Add Character Sheet to your Game]]
 +
* [[Gamemaster]]
 +
* [[Player]]
 +
* [[Library Campaign]] - A good idea for storing unused maps & characters
 +
* [[Optimizing Roll20 Performance]]
 +
<br>
 +
<br>
 
[[Category: Docs]]
 
[[Category: Docs]]
 +
[[Category:Game Management]]

Latest revision as of 09:54, 23 April 2023

Attention: This page is community-maintained. For the official Roll20 version of this article, see the Help Center for assistance: Here .

The "Game Details" page for a  game.
This is a page detailing how to manage and changes settings for individual Games/Campaigns. See the My Games-page for info on all of your games.

[edit] Game Details Page

Each game you create in Roll20 has its own dedicated Details Page. This is where player invites can be managed as well as changing any of the game’s settings. Before they hop into the VTT, this is also the first page new players see after accepting an invite to a game. From this page, players can keep track of in-between session content, such as the next game session's date as well as asking questions and starting discussions via the game’s dedicated private forum.


The Game Settings Page contains a number of settings such as what character sheet is used and it's default settings, as well as i Compendium settings, such as Compendium Sharing.

Contents

[edit] Inviting and Managing Players

On the right hand side of this page is where you can invite and manage the players who will join your game. Within a single game, there are three different roles that a Roll20 user can assume:

[edit] Creator

The game’s Creator is the Roll20 user who originally created the game. There is only ever one Creator for a Roll20 game. They have complete control over all of the game's settings and any subscription perks (Dynamic Lighting, F/X Tool, Mod Scripts , etc…) that the game can benefit from are based on which subscription level the creator’s account currently has. Likewise, content such as Game Add-ons must be bought on the Creator’s account in order for them to be added to the game.

The Creator’s profile image and name are highlighted in purple in the upper right corner of this page. General use stats such as the account creation date and collective hours played are also listed. Clicking on either their name or their profile image will navigate to their Profile Page.

[edit] Player

Anyone else who joins the game will be listed as a Player. This section is listed right underneath the Creator in light grey. Players who join the game will be listed in this section with their profile icon followed by their name underneath. They are listed chronologically by when they first joined the game.

[edit] GM

Player Steve has been Promoted to the GM Role. His profile image now has a "GM" icon displayed over it to note the role.

The Creator of the game can promote one or more Players in a game to the role of GM(Game Master). A GM is granted access to alter, add, and delete most of the game's content within the game, as well as access a couple of features from the Game Details Page. For this reason, the Creator should practice discretion when promoting Players to this role so these privileges are not abused. A GM, like the Creator, will load into the game on the VTT in GM Mode rather than Player Mode.


A promoted player will have a blue “GM” tag added to the upper left of their profile icon in the Player List.

[edit] Inviting, Promoting, and Removing Players From a Game

[edit] Inviting Players

At the top of the light grey Players section is an Invite Players button. Clicking on this opens a dialog box that allow you to send invites out via email adresses, view pending invitations, and also list the game’s unique join link URL that you can copy and send to friends so they can join the game directly.

[edit] Promoting and Demoting Players

As the game’s creator, you have two options available to you when you hover your mouse over a player’s icon or name:

  • ‘’’Promote to GM/Demote to Player’’’: This will elevate a player to GM Status or demote a GM back to player status. This option changes depending on the current status of the player.


[edit] Removing a Player From the Game

  • ‘’’Kick from Game’’': This will remove the Player from the game, and change the unique "Invite Player" link URL of the game, disabling to old url. This will prevent the Player from rejoin the game with the previous join link.


To invite back a previously kicked player to the game, you need to share them the new invite link.

Selecting either of these two options will cause the page to reload to process the new changes.

The "Game Details" page for a  game.

[edit] Managing Your Game

The rest of this page covers information and settings for the game. Most of these options can only be altered by the game’s Creator.

[edit] Game Icon

At the top of the Game Details page is the Game Icon, which is an image used to represent your game in the Game List and Looking For Group Listing (if enabled). This image also helps convey the game’s theme to your players when they join it. To set the image, either drag the desired image to this section, or click the Choose a File... button to be prompted to find an image file on your computer. This uploaded image will be added to your P Art Library. Once one is added, you can change the image to something else by hovering your mouse over this area and clicking the Change Image link that appears.

[edit] Game Name

The Game Name is used to identify your game in the Game List and Looking For Group Listing (if enabled).You can change the Game Name at any time by clicking the name to edit it. Once you are satisfied with the change, you can click the Save button.

[edit] Launch Game

Launch Game Button.png
Clicking on the pink Launch Game button will launch the Game on the Roll20 Virtual Tabletop.

[edit] Content

GameDetails Menu Content.png
The Content Button has two menu options available when clicked: Chat Archive and External Journal.


The Chat Archive will open a new window that displays the entire chat history of the game. There is a button in the top right to Hide Whispers in the chat log. Players can only see Whispers and GM rolls of which they were originally a participant.

External Journal Access is available for games with Creators who are paid subscribers. This option redirects to a new page where GMs can view all journal entries for unarchived Characters and Handouts within the game. Players also have access and can view any Characters or Handouts they have control permissions of within the game. Only the "Bio & Info" tab of a character is accessible from the External Journal. An individual's "Character Sheet" or "Attributes and Abilities" tabs can only be accessed within the VTT.

[edit] Looking for Players

GameDetails Menu LookingForPlayers.png

The Looking for Players menu allows a game's Creator to create or manage a Looking for Group listing. Adding their game to Roll20's game directory will allow other Roll20 users to find and apply to join to it. You must include some basic information about your game in order to list it, including the type of game that you'll be playing and the date and time of the next game to be played.

[edit] Settings

Game Settings Menu Options.jpg
The Settings menu provides several options for the game. The game's Creator can access all of these options, while Promoted GMs have limited access. Players only have access to the Leave Game option detailed below.

[edit] Game Settings

Main Page: Game Settings Page

The Game Settings Page contains a number of settings such as what character sheet is used and it's default settings, as well as i Compendium settings such as Compendium Sharing.

[edit] API Scripts

This option will give the game’s Creator and GMs access to the API Script Editor. The game's Creator must be a
Pro
info subscriber for this feature to be available.

[edit] Convert Lighting

This is used to convert the Dynamic Lighting settings of pages and tokens from the Legacy Dynamic Lighting to Updated Dynamic Lighting.

[edit] Copy Game

This option allows the Creator to create a duplicate of the current game on their account. They can rename the duplicate, change its tags, and decide which elements are carried over to the copy:


Currently, the Character Sheet Template will default to None during a copy, so you’ll want to select the same sheet to be used in the new game. When you have everything designated for the duplicate, click the blue I'm ready, Create Game! button.

[edit] Clear Chat Archive

This option PERMANENTLY deletes the entire archived Chat Archive from the game.

Sometimes if the chat archive becomes corrupted, the q Text Chat stops working, and it can be solved with Clearing the Chat Archive.

[edit] Delete Game

This option opens up a dialog box to confirm the Creators’ decision to delete the game.

[edit] Roll Back Game

Between the hours of 4 and 6 AM PST, a save state is made for every game on Roll20. Seven days’ worth of save states are kept on file before they’re rewritten with new save states. Pro users have the ability to roll back their game to any save state available from the past seven days to correct any drastic mistakes made to their game.

To commit a rollback, click Roll Back Game. This brings up a dialog box that allows you to choose the date of the save state you would like to roll your game back to. Select the date and click on the pink Rollback button to initiate the rollback process. This may take a minute or two, but once finished, the Game Details Page will prompt you when the rollback has successfully completed. This process cannot be undone; however, you can choose to roll back again to a later save state you have available if you discover you’ve rolled back too far.

[edit] Leave Game

This option is only visible to Players and GMs invited to the game. Once a player leaves a game, they no longer have access to the game and it will no longer show up on their Games Page.

[edit] Game Information

The next section below the Launch Game and Settings buttons shows specific information about the current game, from what system will be played to when it will be played.

[edit] Playing

This field shows what system(s) the Creator has specified are being played in this game. The Creator can edit the Playing list by clicking into the text field and choosing popular systems from the drop-down that appears.

If you don't see your preferred system listed, choose Other Games. This list of available popular games are updated on a quarterly basis and if a game system surges in popularity, it gets added.

Only the first two systems alphabetically will be shown in a Looking For Group listing, so be sure to only choose two if you'll be using that system to find players.

[edit] Next Game Will Be

This field is where the game Creator can set the date and time for the game’s next session. The time is automatically converted to the viewer's local timezone.

Note: The time selector uses a 12-hour clock rather than a 24-hour clock. 12:00 AM is used to indicate Midnight (00:00) while 12:00 PM is used to indicate Noon. If you want a 24h clock option, it's recommended to vote & post in this suggestion(Forum).

[edit] Game Description

This is where a Game's Creator can add a blurb advertising what to expect out of the game, adventure flavor text, or provide pre-requisites for potential players. This free-form text field is for anything the Creator feels would be convenient for the Players to know.

To edit the description, simply click inside the text field to activate it and change the text to suit your needs. You can use Markdown formatting to customize the look of your description text. When you are satisfied with your changes, click the Save Changes button.

[edit] Game Addons

The Addon Section of the Game Details Page.
Addons, unlike Marketplace modules, are smaller content packages that are meant to enhance your existing games such as: custom card decks, maps, single encounter adventures and more. Once bought, these content packages are available via a dropdown menu in the Game Addons section of the Game Details Page. Select the one you wish to add and click on the Add to Game button beside the drop-down menu. When a Game Addon is appended to the game, it will be added to a bulleted list underneath the "Addon in [Title of Current Game]" list. This list is shown underneath the addon drop down menu and the blue Add to Game button.

[edit] Removing Addons

To remove any Game Addon content you've added to a game, you will need to delete it manually from inside the launched game. If you ever delete a Game Addon unintentionally, remove the Addon from the Addon List on the Game Details Page, then add it back in again.

[edit] Token Marker Sets

Main Page: Token Markers

You can add custom Token Marker Sets that fits to your games. These sets must have been create in the Token Marker Library beforehand to be accessible to add to individual games.

[edit] Game Patching

PatchUpdate.png

Occasionally, corrections need to be made to an existing module or game addon. A patch is made to correct the issues discovered. A notification will appear on the Game Details page when a patch is available for a module or addon installed on your game. Typically, a link will be included in the notification to the patch notes that lists all the changes that will be made by the patch.

To preserve as much of your edited content as possible, patches only overwrite the tabletop elements that were directly changed by the patch. It's worthwhile to check the patch notes before updating your game in the off chance you need to duplicate some journal entries to preserve player or GM edited module/addon content. Additionally, if a patch is making changes to a Page you and your players are currently active on, you may want to wait to update your game until after the group is between dungeons/maps. That way elements such as tokens, DL, etc aren't reset mid-combat between gaming sessions.

When you click on the Update button, your game will be sent into a queue to begin the update process. You can cancel the update while it's still sitting in queue and hasn't started processing. You will receive new notifications on the Details Page as a patch moves through the queue line to eventually begin processing the patch. This process can take a couple minutes to complete. Once done, you will receive a final notification that the patch has installed successfully.

[edit] Game Discussion Forum

Each game has an exclusive forum. It behaves exactly like the public Roll20 forums. Everyone in the game can create their own threads on this forum and also make replies. The game's Creator and GMs all have access to the Sink, Sticky/unsticky, Delete, and Restore commands on individual posts & comments within this forum.

  • Sink command will keep a thread at the bottom of the forum regardless of activity.
  • Sticky/unsticky Command will pin the thread to the top of the forum.
  • Delete command will remove the post's text from view by those who are not the Creator or GMs. Deleting the first post in a thread will remove the entire thread from the Game Discussion Forum.
    • posts & comments deleted by the Creator/GM becomes invisible to everyone(also Creator/GM), and can only be seen by the original writer.
  • Restore posts & comments deleted by the Creator/GM can only be restored by the writer of the post/comment, if the writer is Creator/GM.

This section of the Game Details Page only shows the ten most recent posts from the Game Discussion Forum. To see the entire discussion forum, click on the ‘’’View All Posts >’’’ link at the bottom of the Page.

Clicking on the + Post New Topic button redirect you to full Game Discussion Forum so that you can begin drafting a new forum thread.

[edit] See Also