Difference between revisions of "Mod:Development"
From Roll20 Wiki
(Created page with "{{mbox | text=The Roll20 API is only available to paying subscribers with a Mentor level account}} {{mbox | text= The Roll20 API is still very alpha software. We '''strongly...") |
(Adjusting the "where to find a script" section) |
||
| (15 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
| − | {{ | + | {{apibox}} |
| − | + | {{pro only}} | |
| − | {{ | + | |
| Line 10: | Line 9: | ||
'''What do I need to get started?''' | '''What do I need to get started?''' | ||
| − | Scripts for the Roll20 API are written in Javascript. You only need a basic understanding of the language to get started, but if you want to learn more about Javascript, this [http://www.codecademy.com/tracks/javascript Codecademy] course can help teach you. | + | Scripts for the Roll20 API are written in '''Javascript'''. You only need a basic understanding of the language to get started, but if you want to learn more about Javascript, this [http://www.codecademy.com/tracks/javascript Codecademy] course can help teach you. |
'''How does it work?''' | '''How does it work?''' | ||
| − | You write scripts that listen to events that happen during the game. Scripts can check to make sure that rules are followed, change properties on objects and tokens, and even provide custom chat commands. The scripts you write run across the entire | + | You write scripts that listen to events that happen during the game. Scripts can check to make sure that rules are followed, change properties on objects and tokens, and even provide custom chat commands. The scripts you write run across the entire game, and affect things the GM does as well as all the players. Advanced scripts can also run independently, performing automatic actions such as moving a token on a patrol route or nudging players when their turn is taking too long. |
| + | |||
| + | '''To get started, your first stop should be the [[API:Use Guide|Use Guide]].''' | ||
| + | |||
| + | |||
| + | '''Where can I find pre-made scripts?''' | ||
| − | + | The API Script community is fairly active with members creating and discussing scripts all the time. There are 3 basic places to look for new scripts: | |
| + | * '''The [https://github.com/Roll20/roll20-api-scripts Official Roll20 API Script Repo] on Github.''' This is where you'll find the current version of scripts that authors have submitted for inclusion in the repo. | ||
| + | * '''The [https://app.roll20.net/forum/category/46806 Roll20 API Script Forum].''' This is where scripts tend to show up first and where discussion happens about scripts that are being written or need changes. This is also where you can post and ask for help from the community in creating a script you've thought of, or finding a script to fill a need. | ||
| + | * '''The [[API:Script_Index|Wiki's API Script index]].''' This is a good source of information about some scripts, but it's not kept very up-to-date. However, if you'd like to document some scripts you find useful, their authors would certainly appreciate it! | ||
| − | [[Category:API]] [[Category:Docs]] | + | [[Category:API|Introduction]] [[Category:Docs|API Introduction]] |
Revision as of 13:55, 5 July 2017
Roll20 Mod
Use Mods
- Use & Install
- Mod:Script Index & Suggestions
- Short Community Scripts
- Meta Scripts
- User Documentation
- Mod Scripts(Forum)
- Macro Guide
Mod Development
- Mod:Development
- Guide to Mod framework
- Contributing
-
- Guide to GitHub
- Category:API
Reference
- Objects
- Events
- Chat Events & Functions
- Utility Functions
- Function documentation
- Roll20 object
- Token Markers
- Sandbox Model
- Debugging
Cookbook
 | This is about a Roll20 feature exclusive to Pro-subscribers (and often to players in a Game created by a Pro-subscriber). If you'd like to use this feature, consider upgrading your account. |
The Roll20 API provides a powerful way to customize and enhance your game. You write scripts (little pieces of code) that tell Roll20 what to do during gameplay (for instance, move a piece, add a status marker to a token, or even roll dice). It's simple and straightforward to get started, but the possibilities are endless.
What do I need to get started?
Scripts for the Roll20 API are written in Javascript. You only need a basic understanding of the language to get started, but if you want to learn more about Javascript, this Codecademy course can help teach you.
How does it work?
You write scripts that listen to events that happen during the game. Scripts can check to make sure that rules are followed, change properties on objects and tokens, and even provide custom chat commands. The scripts you write run across the entire game, and affect things the GM does as well as all the players. Advanced scripts can also run independently, performing automatic actions such as moving a token on a patrol route or nudging players when their turn is taking too long.
To get started, your first stop should be the Use Guide.
Where can I find pre-made scripts?
The API Script community is fairly active with members creating and discussing scripts all the time. There are 3 basic places to look for new scripts:
- The Official Roll20 API Script Repo on Github. This is where you'll find the current version of scripts that authors have submitted for inclusion in the repo.
- The Roll20 API Script Forum. This is where scripts tend to show up first and where discussion happens about scripts that are being written or need changes. This is also where you can post and ask for help from the community in creating a script you've thought of, or finding a script to fill a need.
- The Wiki's API Script index. This is a good source of information about some scripts, but it's not kept very up-to-date. However, if you'd like to document some scripts you find useful, their authors would certainly appreciate it!
