How to ...

… troubleshoot efficiently

If you are new to this, make sure to read our “Prerequisites” and “Understanding Automation” sections first. This will help you identify the potential source of your problem and enable you to resolve it as quickly as possible.

Prerequisites

Understanding Automation

We’ve put together a list of the most common errors encountered by our users. It’s highly likely that the solution to your problem can be found here.

Issues related to JB2A

Issues with FoundryVTT

… troubleshoot an issue yourself

These steps are designed to suit a wide range of problems. Some steps may be unnecessary in your case, but these are solid guidelines to follow whenever you’re trying to solve a problem you’ve encountered while using our content.

Select the corresponding tab related to your issue.

JB2A Modules

1. Non-Chromium browsers (such as Firefox, Opera, Safari) are known to cause issues. Use a Chromium based browser like Chrome or Edge.

2. Sometimes, refreshing the page, re-starting the server or re-installing the module with the issue can be enough. It’s worth a try.

   • Windows: F5 to refresh or CTRL + F5 to refresh and clear the cache.
   • MacOS: CMD + R to refresh or SHIFT + CTRL + R to refresh and clear the cache.

3. Check for any updates that might be available for the module you are having issues with and all of its dependencies. It’s usually safe to update your modules.

   Caution

   You have to be careful with game system updates and major updates for FoundryVTT, as the module developers have to play “catch-up” with potentially breaking changes. When in doubt, always make a backup of your data first.

   How to make a backup

4. Have you forgotten to enable the module in the world?

5. Is there an error in the console when you trigger the macro or item? Errors are red, yellow ones are deprecation warnings and are safe for you to ignore.

   To open the console in FoundryVTT:

   • Windows: Press F12
   • MacOS: Press Option + CMD + J

   If you do have an error, please include a screenshot when reporting it.

6. Make sure you try with only the required modules activated. It’s often easier to do so in a fresh new world.

   You would need at least these modules activated:

   • JB2A module, Free or Patreon
   • Sequencer
   • Socketlib (Sequencer dependency)
   • Any other module required for your automation

7. The Github page for each module is, almost always, the best source of information about the module. That’s where the information is most up to date and you can see when the last update to the module occured.

   Community Links

Automated Animations

If you use Automated-Animations:

1. Have you targeted a token?

   

2. Is the Sequencer module up to date?

3. Is your game system supported by Automated-Animations (AA)?

   List of compatible game systems

4. Is the Diagnostic all green?

   1. Open the Autorecognition Menu.

      

   2. Click “Diagnostics” button to open the Diagnotics Window. It should look something lile this.

      

5. Is the item/spell/feature in the global recognition menu?

   1. Open the Autorecognition Menu and select the apprioprate tab for your effect.

   2. Use the search bar to find it quickly.

      

6. Is the item/spell/feature disabled in its AA configuration menu?

   1. Open the details of an item/spell/feature.

      

   2. Check if the animation is enabled and activate “Customize Item” if you want only this item to have its own specific animation.

      

   3. Don’t forget to check if everything is set correctly in the Details tab of the item.

7. Have you rolled for attack or damage? Check in AA’s settings.

   

… report an issue

The best place to report an issue is on our Discord server. Please check the Troubleshooting Forum channel, your issue might have been reported before! If you can’t find it, copy and use the template provided below.

Join our Discord Server

Helpful information

Here are a few things that could help us know straight away if we’ve encountered the issue and potentially know about a solution.

Hosting Method
Self-Hosting, the Forge, Molten Hosting…etc

Foundry VTT Version
V11, V12, V12.331…

Game System and Version
DnD5e Vx.x.x, PF2e Vx.x.x …etc

Describe the issue
A clear and concise description of what the issue is.

To Reproduce
It could be really useful to know the steps on how to reproduce the behavior.

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add a screenshot or a quick video, for us to understand your problem more easily.

Discord Template to Copy

**Hosting Method**
Self-Hosting, the Forge, Molten Hosting...etc

**Foundry VTT Version**
V11, V12, V12.331...

**Game System and Version**
DnD5e Vx.x.x, PF2e Vx.x.x ...etc

**Describe the issue**
A clear and concise description of what the issue is.

**To Reproduce**
It could be really useful to know the steps on how to reproduce the behavior.

**Expected behavior**
A clear and concise description of what you expected to happen.

**Screenshots**
If applicable, add a screenshot or a quick video, for us to understand your problem more easily.