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

[5e OGL] How to setup Ammunition /Resource tracker

1477316221

Edited 1477316742
Dan
Plus
Sheet Author
This might seem pretty basic but some people might not be aware of the capabilities you have with roll20 OGL character sheet. I've been helping many people to setup this and I believe it worth posting something about it. Most of the people get lost where to go, where to click, where are the options you need to change, so I will try to cover with a full example how to do this. Think of resources like something you can automatically decrement a counter whenever you trigger an attack in the application. I will cover how to setup resources in roll20 OGL sheet to make your game go smoother and faster avoiding repetitive actions. Ammunitions is probably the most common use case for resources setup in your character sheet. The setup is not complicated. In a nutshell you need a pro account, a sandbox with some scripts for the game you are enabling the feature, and some character sheet level configuration. First when you open roll20 click on the game title you want to setup ammunition tracker. On the game page click in Settings menu select API Scripts. In the API Scripts page the first tab is Script Library, you can see a dropdown that allows you to search, search for Companion. Select “5th Edition OGL by roll20 Companion”. Finally click on add Script button in the bottom: This script also have other features I won't talk about, for instance it also keeps track of you spell slot usage if you're using default spell slots rules. All you have to do now is go inside the game and open the character sheet you want to configure. On the sections menu select the Engine icon, locate the right column named General Options and change Ammo Tracking value to "On". Back into the CORE section you must define what you want to keep track of, inside the equipment section mouse over the equipment line click in the “I” icon that will appear, select the option “User as Resource”. This will make it also be controlled by the resource section, so that whenever you change the quantity there it also changes in your inventory. Open the existing attack, such as the one roll20 automatically creates when you drag a crossbow from the compendium. Move mouse over the attack, click in the inline engine icon that will appear and locate the AMMUNITION field and type the exactly same name of the equipment you want to auto decrement a counter automatically. Now whenever you run an attack you will see both the resources and the equipment counter decrement. Another example would be a cleric from tempest domain that can use his reaction to give some damage. He can use this ability let’s say 3 times until recover. As long as you type type same name of an existing resource in the AMMUNITION field inside the attack setup, even if you don’t have that resource in the inventory (remember you can create resources independently of anything in your sheet), it will decrement from it. Look the following example for the Cleric, note that after you run the attack for the first time the system will update the AMMUNITION field value adding a | (pipe) symbol to separate the name from the id it needs to keep reference of which field it should update. You basically ignore this id and leave it there. Finally you can do the same for Second Wind ability for fighters with a heal attack, Channel Divinity, etc.
1477316344
The Aaron
Pro
API Scripter
Very informative!  Would you consider adding that to the wiki?
1477316488
Dan
Plus
Sheet Author
Absolutely, do I need some specific permission in order to do it?
1477316693
The Aaron
Pro
API Scripter
Nope.  You should be able to just create a page for it and add all the text.  You probably can't upload the images, but if I can do that for you and add the links.
1477316857
Dan
Plus
Sheet Author
Sure man, that sounds great. Do you want me to send you the picture or you can get them from here?
1477317062
The Aaron
Pro
API Scripter
I downloaded them all already. =D
1477317441
The Aaron
Pro
API Scripter
I've uploaded them all under the names OGL_AMMO_Instructions_1.jpg through  OGL_AMMO_Instructions_9.jpg (from top to bottom of this page) You can link them with: [[File:OGL_Ammo_Instructions_1.jpg]] Or just use the Insert File button and supply the name Thanks for the great contribution!
1477318028
Dan
Plus
Sheet Author
Ok, I created the page&nbsp; <a href="https://wiki.roll20.net/How_to_setup_Ammunition_/R" rel="nofollow">https://wiki.roll20.net/How_to_setup_Ammunition_/R</a>... but I the images aren't working, I couldn't also login into the wiki, every I click login it redirects me to main page and nothing happens.
1477318098
Dan
Plus
Sheet Author
Ohhh lord I just saw that the slash / in the same made it create a sub page It's all messed up =[
1477318696

Edited 1477318717
The Aaron
Pro
API Scripter
No worries. &nbsp;I moved it to&nbsp; <a href="https://wiki.roll20.net/How_to_setup_Ammunition_an" rel="nofollow">https://wiki.roll20.net/How_to_setup_Ammunition_an</a>... I also fixed the image links (The wiki changed them all to .jpeg files). &nbsp;I'll let you adjust the size or I can go back in and do some formatting later. &nbsp;No worries!
1477318886
Dan
Plus
Sheet Author
Cool, how can I edit the page? I could do it, but I can't see any edit buttons. Maybe it's because I can't login
1477319701
The Aaron
Pro
API Scripter
There is an edit link at the top. &nbsp;The "logged in" is a misnomer. &nbsp;if you're logged into the Roll20 site, you're logged into the wiki. =D
1477327991
Dan
Plus
Sheet Author
Cool, done! I changed formatting for the images, look pretty good now
1477328470
The Aaron
Pro
API Scripter
It does! &nbsp;Thanks for doing that. &nbsp;I'll probably adjust all the images down a bit so it's easier to follow.
1477328701
The Aaron
Pro
API Scripter
I moved it to:&nbsp; <a href="https://wiki.roll20.net/OGL_5e_DnD:_How_to_setup_A" rel="nofollow">https://wiki.roll20.net/OGL_5e_DnD:_How_to_setup_A</a>... to further clarify the intent, and adjusted the images down just a little (half size on the first 4, then 3/4 size on the rest. &nbsp;Great job! &nbsp;I'll link it from some places also. =D
1477328888
The Aaron
Pro
API Scripter
Linked from OGL sheet page and added to Tips & Tricks. =D