Roll20 uses cookies to improve your experience on our site. Cookies enable you to enjoy certain features, social sharing functionality, and tailor message and display ads to your interests on our site and others. They also help us understand how our site is being used. By continuing to use our site, you consent to our use of cookies. Update your cookie preferences .
×
Create a free account

Brand new to Pro and API. Where to start?

October 14 (4 years ago)

I've been using Roll20 for almost 3 years, and finally upgraded from Plus to Pro. The Transmogifier is amazing, and I now have a "Library" Game for my Bestiary worth of character sheets. I've always loved what I could do with Macros, and always been interested in APIs, but I know nothing about them, nor do I have any idea where to start. 

What APIs would you suggest or tips/tricks/advice would you give to someone just starting on APIs?

Thanks!

This thread from a few days ago should help you. As far as tips or tricks go, my advice is to start slow. Identify the areas of need most important for you personally. My go-to scripts may not be yours. Is quality of life the most important thing to you and your players? If so, what aspect of the game do you struggle with the most on Roll20, and is the most in need of API support? For example, do you need a quick, efficient way to add monsters to initiative? Then you should install the GroupInitiative script. Do you want to be able to toggle line of sight on doors (open or closed) on a maps with dynamic lighting? Then check out DoorKnocker. Is note management really important to you? Then check out Supernotes. And so on.


October 14 (4 years ago)

Edited October 14 (4 years ago)

Thanks for the link, I found a bunch of threads from 2-3 years ago and somehow missed the ones from a few days ago hah! I should mention I'm running a Pathfinder game primarily and using the Pathfinder sheet.


As far as area of interest, anything that would help organize and run large complicated combats with a lot of unique monsters, effects, and tracking all the time-related effects. Currently I use an entire row worth of Macros on the Pathfinder sheet to do stuff such as quickly add initiative, and add shortcuts to character sheets, attacks, spells, abilities, etc. I absolutely love Dynamic Lights, so I will 100% check DoorKnocker.


Jeff P. said:

As far as area of interest, anything that would help organize and run large complicated combats with a lot of unique monsters, effects, and tracking all the time-related effects. Currently I use an entire row worth of Macros on the Pathfinder sheet to do stuff such as quickly add initiate, and add shortcuts to character sheets, attacks, spells, abilities, etc.

OK, then you'll probably want to check out Combat Master, but not the one-click version, which currently has issues. Grab the latest version from github. It's a fantastic script and I would be lost without it. You may also want to install Token Action Maker (from the one-click). Having a suite of buttons for monster (or player) token actions on hand is a huge QoL improvement for me. I hate having to keep bringing up monster character sheets in the middle of combat.

October 14 (4 years ago)

Edited October 14 (4 years ago)

I've listed all the scripts that I'm currently using below with links to where to find them and a short snippet of what I use them for.  As a caveat, I'm playing D&D 5e using the Beyond20 extension to roll from DnDBeyond, so I haven't had any use for Combat Master, but it looks like a great script if you are doing all of your tracking and rolling directly on Roll20. I also have a list of other scripts that I haven't started using yet (like I may switch to Door Knocker instead of SimpleDoorControls for example).

Edited to add: A lot of these scripts are not listed as "one-click" but are in fact available in the Script Library.  I just didn't have the link handy for them.  I modified several of the scripts in minor ways -- for example if there is a sendChat() function that has a blank 'speaking as' reference, I usually like to modify that so that the API is named.  

For all of these scripts I have various macros to call them but that would take a lot of time to list all those out.  Also, definitely check out the Stupid Roll20 Tricks thread if you haven't before. 

    October 14 (4 years ago)
    The Aaron
    Roll20 Production Team
    API Scripter

    Wow, that's quite a list, Jarren!  Nothing should require isGMModule anymore, but if you do find something that uses it, let me know so I can update it. 

    October 14 (4 years ago)

    The Aaron said:

    Wow, that's quite a list, Jarren!  Nothing should require isGMModule anymore, but if you do find something that uses it, let me know so I can update it. 

    I only added the isGMModule and DnD 5e by Roll20 Companion scripts because there were listed at some point as being dependencies for other scripts... though I don't think I actually need them haha. 


    Some of the rest I've installed but haven't gotten around to really using (like SuperNotes) and others I want to hack a bit to work the way I want -- like combining TokenAction & UniversalChatMenu... which I might be able to do with the InsertArg script.  My coding skills (HTML & CSS years ago) are just enough to make me think I'll be able to figure it out!

    October 14 (4 years ago)
    David M.
    Pro
    API Scripter

    InsertArgs is such an intimidating script in both scope and syntax. Pretty sure all mysteries of the universe must be hidden within it. Hope you can share what you come up with, Jarren!

    October 14 (4 years ago)
    keithcurtis
    Forum Champion
    Marketplace Creator
    API Scripter

    Fantastic list and well-cited, Jarren.

    Token Action Maker has been significantly updated from the version you linked, and can now be found in the one click. Thread is here:

    https://app.roll20.net/forum/post/8458497/script-token-action-maker-v-dot-0-2-dot-7

    October 14 (4 years ago)
    Kraynic
    Pro
    Sheet Author

    If you find yourself overwhelmed, I would recommend the following that will give you a lot of tools to work with.  I think all of these were mentioned by Jarren, who also kindly provided links to things.

    Universal Chat Menu
    I have the global macros I am currently using for the Pathfinder by Roll20 sheet near the top of (what is currently) the last page of the thread where you find this script.  If you learn how to set up this script from the examples given, you can adapt this script to any sheet and use it to generate lists of abilities to trigger from chat.  With the Roll20 pathfinder sheet, I find that I can use the same menu for skills between players and npcs, but I have a specific npc menu for everything else.  It will show me pretty much anything I might need and allows me to trigger spells, attack rolls, saves, displays the various ACs, and shows notes on various defenses all with one token action.  Basically one token action will do that for any npc I have out on the map.  It is so much easier running a combat or skill heavy scenario with that script since I very rarely need to open the actual character sheets anymore (basically, I only need to do that in the event of the players getting loot/gifts).  Also, players with animal companions or familiars can use the npc menu as well to quickly access info/rolls they may need.

    TokenMod
    In pathfinder, you will be messing with lighting/vision a lot.  There are also a lot of conditions that you might want to indicate with token markers.  TokenMod makes all of that easy.  Set up the options you need in a Chat Menu, possibly on a Macro Character, which are ideas out of the Stupid Roll20 Tricks thread mentioned by Jarren (the first post is an index).

    ChatSetAttr
    I really haven't used this script enough, but I can tell you one thing I use it for in Pathfinder.  Got a player with augmented summons and another without?  Don't want to clutter your journal with augmented/normal versions of the summons?  Just use the normal and use ChatSetAttr to alter some of the npc attributes for the higher fortitude saves, str, and con with a ChatSetAttr command.  You can have another command to set things back.

    You can also do this with notes in the attacks, but there are already notes for reminding me of the possible affects of alignment oriented templates, so I generally change the sheet attributes back and forth with ChatSetAttr.  I actually use this in combination with TokenMod so that the HP of augmented summon tokens gets raised also.  So that I know how much to raise it, I have a macro that whispers me the hit dice formula.

    Door Knocker
    I haven't used all of the features of this.  The ability to set a color for doors and just be able to toggle doors open/closed by moving a token around on the GM layer and click a token action has been incredibly useful.  I haven't really paid attention to all the other stuff it can do, since that is all I need.

    Group Initiative
    Got groups of npcs that need initiative rolled? Want to display tie breaker stats as part of your roll?  Want initiative to automatically sort when you roll?  Use this script to make all that simple.  You just have to configure it for the sheet/stats you use.

    Welcome Package
    If you are starting a new game or run one shots where you aren't using pregenerated characters, this script will assign anyone that logs in for the first time a character sheet.  It also creates a macro that you can make visible to players that will generate another sheet for those that need to also set up a mount, companion, familiar, or just a sheet to track bag of holding or handy haversack inventory.  No need for the GM to be logged in to create/assign the sheet.  Obviously you might not want to enable the macro for everyone for a bunch of strangers, but if you have a batch of known trusted players, I have found it really useful.



    Compared to others, I am fairly conservative in the number of scripts I use.  It really doesn't take very many to have a serious impact on how you run games.  You might consider starting small.  Try just a few of them and get a little time in using them before adding more.  Or not.  The convenience can be addicting.