Script.json
From Roll20 Wiki
Page Updated: 2022-02-17 |
Main Page: API:Development
Roll20 Mod
Use Mods
- Use & Install
- Mod:Script Index & Suggestions
- Short Community Scripts
- Meta Scripts
- User Documentation
- Mod Scripts(Forum)
- Mod Update 2024🆕
- Macro Guide
Mod Development
Reference
- Objects
- Events
- Chat Events & Functions
- Utility Functions
- Function
- Roll20 object
- Token Markers
- Sandbox Model
- Debugging
Cookbook
Details: Creating a script.json File
Some extra details:
- "roll20userid" - add your id here to get the "API Scripter"-forum flair - find your roll20userid
Description
"description"
is the text displayed on the API Install page. It's written in markdown, with a few quirks. You can have markdown hyperlinks
- See sheet.json#Instructions for formatting tips
- With some changes, you can use Sheet Sandbox to test how the "description" will look like in the One-click menu. Good for checking it's readable
Patreon and Tipeee Link
For API script authors that are contributing to the Roll20 Roll20 API repo, they are approved to advertise via subscription/donation service sites: Patreon and Tippee. Roll20 is not responsible for any payment transactions and cannot enforce any private arrangements.
In order to qualify, an API script author must first have their script contribution approved by the Roll20 staff and included into the Roll20 API Script Repo.
You will want to include your Patreon or Tipeee account information in the script.json
file that should be included with your script submission on GitHub.
The json file should have one of these fields added to it if you wish to advertise with Patreon or Tipeee:
patreon:
Place the URL for a Patreon campaign here, and it will appear under your script's description when selected. (e.g."https://www.patreon.com/<name>"
)
tipeee:
Place the URL for a Tipeee here, and it will appear under your script's description when selected. (e.g."https://www.tipeee.com/<name>"
)
For more information, see github.com/Roll20/roll20-api-scripts#contributing
Related Pages
- Guide to GitHub
- sheet.json
- Sheet Sandbox - good for testing how sheet.json or script.json