This page is about a feature exclusive to Pro subscribers, or to players in a Game created by a subscriber. If you'd like to use this feature, consider upgrading your account.
Are you wondering how to get started with installing Mod (API) scripts? This article helps walk you through installing Mod (API) scripts via our easy-to-use 1-Click Install Library.
Where to Go to Install?
Mod (API) scripts have to be installed for each campaign individually. We don't have an option at this time to install Mods (API) across multiple games. You will need to individually access each game and install the scripts you want to execute for that particular game.
To get started, navigate to the Game Details page for the specific game. Click on the Settings dropdown and choose Mods (API) Scripts.
This will open up your Mods (API) Settings page which is going to be your hub to install, modify, and manage your Mods (API) Scripts. For a detailed breakdown of the API Settings page, we highly encourage you to check out our guide here.
Installation
Once you reach the Mods (API) Settings page, go ahead and navigate to the Script Library tab. Within that tab, select the dropdown menu titled Roll20 Mods (API) Script Library to search for scripts available for 1-Click Install.
The scripts are sorted by the various functions that they perform such as extending a Character Sheet's features, performing a utility task, change Dynamic Lighting, or modify Tokens.
This dropdown will bring up information regarding the script, the author, the version, and much more. Reading and understanding the script details is crucial for effectively using it.
When the script is open, simply click the Add Script button at the bottom of the page to install it. Once you click the Add Script button, the Mod (API) will restart and the page will refresh. You will know everything went successfully if you see a new tab next to Script Library with the name of your script.
After Installation
How to Use scripts?
Make sure you review the script's description for important information. That's where you will find instructions on how to use it in-game. To find the script's description, simply click the tab with the script's name from your Mods (API) Settings page.
Are You Having Trouble?
If you are running into issues with using the Mod (API) or installing the script, make sure to check out our guide on troubleshooting Mod (API) issues.