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

Difference between revisions of "Solving Technical Issues"

From Roll20 Wiki

Jump to: navigation, search
m
m
 
(39 intermediate revisions by 11 users not shown)
Line 1: Line 1:
 +
{{revdate}}{{HCbox| {{hc|sections/360008317414-Technical-Support Here}} }}
 
Sometimes technical issues can get in the way of your Roll20 experience. Here's a quick process you can follow that may help solve any technical issues you encounter.
 
Sometimes technical issues can get in the way of your Roll20 experience. Here's a quick process you can follow that may help solve any technical issues you encounter.
  
 
Follow these steps in order, checking to see if the problem is solved after each step. These steps will help fix many common issues, including:
 
Follow these steps in order, checking to see if the problem is solved after each step. These steps will help fix many common issues, including:
  
* Campaign pages/maps show as totally blank
+
* Game pages/maps show as totally blank
* Campaign pages/maps show as a tiny strip across the top of the screen
+
* Game pages/maps show as a tiny strip across the top of the screen
* The video + voice chat does not work
+
 
* Stuck at the black "Loading..." screen for more than 30 seconds.
 
* Stuck at the black "Loading..." screen for more than 30 seconds.
  
 +
If your issue has to do with audio, your microphone, video, video chat, or your camera, please visit the [[Video and Voice Chat Troubleshooting]] Guide before following the steps below.
  
 +
'''[[Community FAQ]]''' may address your concern if you have a common issue
 +
 +
=Steps=
 
== Step 1: Make sure to use the right browser ==
 
== Step 1: Make sure to use the right browser ==
 +
{{Main|Browser}}
  
Your browser is the software application that lets you access websites, like Roll20. While Roll20 will work in a variety of browsers, in order to maximize your playing experience and take advantage of everything that Roll20 can do, you should use the latest version of either [https://google.com/chrome Google Chrome] or [https://firefox.com Mozilla Firefox]
+
Your [[browser]] is the software application that lets you access websites, like Roll20. While Roll20 will work in a variety of browsers, in order to maximize your playing experience and take advantage of everything that Roll20 can do, you should use the latest version of either [[Browser#Chrome|Google Chrome]] or [[Browser#Firefox|Mozilla Firefox]]. Due to bleeding-edge features, we are unable to support beta versions of web browsers.
  
If you are a Supporter or Mentor subscriber (or your GM is), you may access Roll20 on a tablet device. For specific information about that, see the [[Mobile Tablet Support]] page.
+
When troubleshooting, please check to see if issues persist when using both [[Browser#Chrome|Google Chrome]] ''and'' [[Browser#Firefox|Mozilla Firefox]]
  
== Step 2: Ensure that there are no extensions/addons interfering with Roll20 ==
+
If you're using a phone or a tablet, see the [[Table on Tablet Support]] for details.
  
This is by far '''the most common cause of problems with Roll20'''. Often, third-party addons/extensions (also known as "toolbars" or "adware") inject scripts into all the web pages that you visit. Roll20 is very sensitive to this type of interference because it has many more moving parts than a typical website.
+
== Step 2: Ensure that there are no browser extensions interfering with Roll20 ==
  
'''In Google Chrome'''
+
This is among the most common cause of problems with Roll20. Temporally turn off any browser extensions you have active, such as [[Stylus#Stylus|Stylus]], to make sure the problem isn't caused by the extension.
  
You can view a list of your extensions and disable or remove them by following these instructions: [https://support.google.com/chrome/answer/113907 https://support.google.com/chrome/answer/113907]
+
'''Browser extensions/add-ons''' change how your browser behave or looks, and even if an extension isn't specifically targeting Roll20.net, it might interfere with how Roll20 works or looks. Roll20 can be very sensitive to this type of interference because it has many more moving parts than a typical website.
  
'''In Mozilla Firefox'''
+
'''In Google Chrome''' – [https://support.google.com/chrome_webstore/answer/2664769?hl=en Install and manage extensions]
  
You can view a list of your addons and disable or remove them by following these instructions: [http://support.mozilla.org/en-US/kb/disable-or-remove-add-ons http://support.mozilla.org/en-US/kb/disable-or-remove-add-ons]
+
'''In Mozilla Firefox''' – [https://support.mozilla.org/en-US/kb/disable-or-remove-add-ons Disable or remove Add-ons]
  
 
If you see any extensions or addons that you do not recognize, disable them while using Roll20, or even remove them entirely. You don't need any addons or extensions for your browser to function properly, so only keep them if they add additional functionality to your browser that you use on a regular basis.
 
If you see any extensions or addons that you do not recognize, disable them while using Roll20, or even remove them entirely. You don't need any addons or extensions for your browser to function properly, so only keep them if they add additional functionality to your browser that you use on a regular basis.
 +
 +
'''Check Antivirus/Firewall Software'''
 +
 +
If you are having trouble with images loading or loading issues in general, please also make sure that any antivirus or firewall software that you have installed (such as Comodo, Norton, etc.) is not blocking any part of the Roll20 site from loading.
  
 
==Step 3: Clear your cache==
 
==Step 3: Clear your cache==
  
Your browser automatically stores frequently-used pieces of information so that you don't have re-download them everytime you visit a website. However, sometimes errors can occur with Roll20 if a piece of information your browser has stored is too out of date.  
+
Your browser automatically stores frequently-used pieces of information so that you don't have re-download them every time you visit a website. However, sometimes errors can occur with Roll20 if a piece of information your browser has stored is too out of date.  
  
'''In Google Chrome'''
+
'''In Google Chrome''' – [https://support.google.com/chrome/answer/95582?hl=en Clear Browsing data]
  
Follow these instructions: [https://support.google.com/chrome/answer/95582?hl=en https://support.google.com/chrome/answer/95582?hl=en]
+
'''In Mozilla Firefox'''  – [https://support.mozilla.org/en-US/kb/how-clear-firefox-cache How to clear the Firefox cache]
  
'''In Mozilla Firefox'''
+
==Step 4: Provide a bug report==
  
Follow these instructions: [https://support.mozilla.org/en-US/kb/how-clear-firefox-cache https://support.mozilla.org/en-US/kb/how-clear-firefox-cache]
+
If none of the above steps resolved the issue, we may be able to help further if you provide us with information about what exactly is going on with your specific game session. You should post a [[Bug Report|bug report]] to Roll20 through the [[Help Center]]'s '''{{hc|requests/new web form}}'''
  
==Step 4: Provide a console log==
+
The things we need with every bug report are:
 
+
* A detailed description of the issue. The more information you can give us, the better able we'll be to fix the issue promptly!
If none of the above steps solved the issue, we may be able to help further if you provide us with additional information about what exactly is going on with your specific game session. A console log is a listing of the activity that Roll20 is doing while you play, so we can spot anything that deviates from the norm. Follow the instructions below to open your log, then just copy + paste everything into a new forum post in the [https://app.roll20.net/forum/category/18 Bug Reports section of the forums] and we will aid you further.
+
* Step by step instructions on how to reproduce the issue.
 +
* Your computer's settings (A good place to find this info if you don't know it is [https://supportdetails.com/ Support Details]):
 +
** Web Browser Name & Version (ex. Firefox 93.0)
 +
** Operating System (Windows 11)
 +
** If Javascript is enabled
 +
** Your anti-virus software
 +
** List of any browser add-ons or extensions enabled
 +
* You can optionally include screenshots by using the "Attach a File" link when submitting a post.
 +
* A Console Log from the moment you logged into the page through when you encountered the issue.
 +
 +
===Console Log===
 +
A console log is a listing of the activity that Roll20 is doing while you play, so we can spot anything that deviates from the norm. Follow the instructions below to open your log, then just copy and paste everything into your bug report to Roll20 through the [[Help Center]]'s '''{{hc|requests/new web form}}'''
  
 
'''In Google Chrome'''
 
'''In Google Chrome'''
  
Use the keyboard shortcut: Command - Option - J (Mac) or Control -Shift -J (Windows/Linux).
+
{{hc|articles/360040673774-Submitting-a-Console-Log-in-Chrome Submitting a Console Log in Chrome}}
 
+
If that doesn't work, follow these instructions: [https://developers.google.com/chrome-developer-tools/docs/console#opening_the_console https://developers.google.com/chrome-developer-tools/docs/console#opening_the_console]
+
  
 
'''In Mozilla Firefox'''
 
'''In Mozilla Firefox'''
  
Use the keyboard shortcut: Control-Shift-K (Command-Option-K on the Mac)
+
{{hc|articles/360040673814-Submitting-a-Console-Log-in-Firefox Submitting a Console Log in Firefox}}
  
If that doesn't work, follow these instructions: [https://developer.mozilla.org/en-US/docs/Tools/Web_Console https://developer.mozilla.org/en-US/docs/Tools/Web_Console]
+
=Related Pages=
 +
* [[Community FAQ]] - Commonly Encountered Issues
 +
* [[Solving Technical Issues]]
 +
* [[Browser]]
 +
* [[Video and Voice Chat Troubleshooting]]
 +
* {{hc|articles/360037771353-Roll20-Support-FAQ Roll20 Support FAQ}}
 +
* [[Optimizing Roll20 Performance|Optimizing Roll20's Performance]]
 +
* [[Best Practices for Files on Roll20|Best Practices for Files]]
 +
* [[UDL#Known_Issues|Updated Dynamic Lightning - Known Issues]]
 +
* [[Status|Roll20 Status]] see if the service is affected
  
 
[[Category:Docs]]
 
[[Category:Docs]]
 +
[[Category:Troubleshooting]]
 +
[[Category:Web Browser]]

Latest revision as of 10:11, 20 August 2023

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

Sometimes technical issues can get in the way of your Roll20 experience. Here's a quick process you can follow that may help solve any technical issues you encounter.

Follow these steps in order, checking to see if the problem is solved after each step. These steps will help fix many common issues, including:

  • Game pages/maps show as totally blank
  • Game pages/maps show as a tiny strip across the top of the screen
  • Stuck at the black "Loading..." screen for more than 30 seconds.

If your issue has to do with audio, your microphone, video, video chat, or your camera, please visit the Video and Voice Chat Troubleshooting Guide before following the steps below.

Community FAQ may address your concern if you have a common issue

Contents

[edit] Steps

[edit] Step 1: Make sure to use the right browser

Main Page: Browser

Your browser is the software application that lets you access websites, like Roll20. While Roll20 will work in a variety of browsers, in order to maximize your playing experience and take advantage of everything that Roll20 can do, you should use the latest version of either Google Chrome or Mozilla Firefox. Due to bleeding-edge features, we are unable to support beta versions of web browsers.

When troubleshooting, please check to see if issues persist when using both Google Chrome and Mozilla Firefox

If you're using a phone or a tablet, see the Table on Tablet Support for details.

[edit] Step 2: Ensure that there are no browser extensions interfering with Roll20

This is among the most common cause of problems with Roll20. Temporally turn off any browser extensions you have active, such as Stylus, to make sure the problem isn't caused by the extension.

Browser extensions/add-ons change how your browser behave or looks, and even if an extension isn't specifically targeting Roll20.net, it might interfere with how Roll20 works or looks. Roll20 can be very sensitive to this type of interference because it has many more moving parts than a typical website.

In Google ChromeInstall and manage extensions

In Mozilla FirefoxDisable or remove Add-ons

If you see any extensions or addons that you do not recognize, disable them while using Roll20, or even remove them entirely. You don't need any addons or extensions for your browser to function properly, so only keep them if they add additional functionality to your browser that you use on a regular basis.

Check Antivirus/Firewall Software

If you are having trouble with images loading or loading issues in general, please also make sure that any antivirus or firewall software that you have installed (such as Comodo, Norton, etc.) is not blocking any part of the Roll20 site from loading.

[edit] Step 3: Clear your cache

Your browser automatically stores frequently-used pieces of information so that you don't have re-download them every time you visit a website. However, sometimes errors can occur with Roll20 if a piece of information your browser has stored is too out of date.

In Google ChromeClear Browsing data

In Mozilla FirefoxHow to clear the Firefox cache

[edit] Step 4: Provide a bug report

If none of the above steps resolved the issue, we may be able to help further if you provide us with information about what exactly is going on with your specific game session. You should post a bug report to Roll20 through the Help Center's web form

The things we need with every bug report are:

  • A detailed description of the issue. The more information you can give us, the better able we'll be to fix the issue promptly!
  • Step by step instructions on how to reproduce the issue.
  • Your computer's settings (A good place to find this info if you don't know it is Support Details):
    • Web Browser Name & Version (ex. Firefox 93.0)
    • Operating System (Windows 11)
    • If Javascript is enabled
    • Your anti-virus software
    • List of any browser add-ons or extensions enabled
  • You can optionally include screenshots by using the "Attach a File" link when submitting a post.
  • A Console Log from the moment you logged into the page through when you encountered the issue.

[edit] Console Log

A console log is a listing of the activity that Roll20 is doing while you play, so we can spot anything that deviates from the norm. Follow the instructions below to open your log, then just copy and paste everything into your bug report to Roll20 through the Help Center's web form

In Google Chrome

Submitting a Console Log in Chrome

In Mozilla Firefox

Submitting a Console Log in Firefox

[edit] Related Pages