The Mod Scripts Settings page is where you can add, change, and manage your Mod Scripts.
1. Script Library Section
This dropdown includes a list of all the curated scripts that Roll20 offers for 1-Click Install. This list is continuously updated with scripts that are approved for 1-Click Install through Roll20. However, you can still install any scripts from our official Roll20 GitHub library by adding them manually, or you can even create your own scripts from scratch!
Selecting a script will display an additional section with information on the script. This information includes how to use the script, who the author is, what the current version is, and other important details. We highly recommend you review all of the information available before you install a script.
Whenever you are ready to install, there will be an Add Script button as well as an Import button. See How to Install Mod Scripts via 1-Click Install for the full walkthrough.
2. New Script Section
It is strongly recommended that you have a basic understanding of coding and JavaScript before you make any changes here. This section allows you to add code directly into the Mod Script Sandbox and save it as a script. This section includes a built-in coding editor to add and manipulate your script code. When you are ready to make changes, there are both a Disable Script and Save Script button. Click here for the Advanced Use Guide and for information on how to create your own scripts.
3. Restart Mod Script Sandbox Button
This button allows you to restart the Mod Script Sandbox instance that is running. This effectively reboots any Mod Scripts and restarts any other affected processes.
Games can run Mod Script Sandbox v1.0 or Mod Script Sandbox v1.5. After a restart, scripts can read Campaign().sandboxVersion ("1.0" or "1.5") to see which sandbox is running.
4. Mod Output Console
The Mod Output Console is your “window” into your scripts. Since Mod Scripts run in a sandbox, you don’t have direct access to them while they are running to view information on the script’s results or errors. The Mod Output Console brings this information out of the sandbox so you can view it while you are editing your scripts. All log() commands will show here, as well as any errors that are encountered during the execution of your scripts.