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

[Script] rewards - an Adventurers League rewards tracking and calculation tool

1541106913

Edited 1541140865
Ammo
Pro
github: <a href="https://github.com/derammo/der20/releases" rel="nofollow">https://github.com/derammo/der20/releases</a> rewards is the largest in a family of completely over-engineered Roll20 API Scripts I am creating using a framework of reusable TypeScript components I am calling der20 . Plugins are distributed together in releases via github. &nbsp; I am looking for contributors, so I am publishing this now even though a lot of work could still be done. &nbsp; The command reference is at <a href="https://derammo.github.io/der20" rel="nofollow">https://derammo.github.io/der20</a> . This API Script is a rewards tracker for D&amp;D Adventurers League (DDAL) rewards tracking. &nbsp;Before the session, you can enter all of the check point and treasure unlock information about the modules or hardcover you are running for DDAL. &nbsp;Rules differences between Season 8 and previous season's modules are considered and customizable if things change. Configuration is via a command language, which you can store in handouts so you can move them from room to room, or you can just type in commands at the prompt and have the built-in state system store it. During the session, you select which DM you are (in case of shared rooms) and what module or hard cover you are running. The !rewards show command then starts interactive use. &nbsp;It will show the rewards for the current module initialized to their defaults. &nbsp;Depending on whether you are running a module or hardcover and depending on the tier and season, rewards are calculated. &nbsp;You can override any of the defaults calculated for you. Then you interactively check off checkpoints as they are achieved and hit a start and stop timer for the session. &nbsp;Time entry is either as an absolute time string, or empty string for "now" or a number meaning "this many hours ago." &nbsp;So if you have been playing for about 3 hours, you can just hit start and type in "3." When you set the start of the module, the script finds all player-owned characters in the game and adds them to the session data. &nbsp;It selects the highest level character for each player as the probable player character. &nbsp;You can then interactively correct which characters are included in the session. &nbsp; APL and player count are calculated from this selection. &nbsp;In this example, there are two players: 'Ammo' and 'Test U.' &nbsp; &nbsp;'Test U' brought at three characters to the session, only one of which counts. For a Season 8+ module, you might have several explicit checkpoints and no rewards per hour: Finally, you can compile the rewards page in private and check everything before you share it with all the players. Development on this tool continues. &nbsp;There is a feature to directly import this reward information into the website <a href="https://adventurersleaguelog.com" rel="nofollow">https://adventurersleaguelog.com</a> . &nbsp;However, this functionality won't be enabled until the server side code can be implemented under this issue&nbsp; <a href="https://github.com/Ariel-Thomas/adventurers-league-log/issues/157" rel="nofollow">https://github.com/Ariel-Thomas/adventurers-league-log/issues/157</a>
I should have mentioned this is very pre-release also. &nbsp;However, I can't edit titles of posts, so I cannot fix it.&nbsp; Just be warned: &nbsp;This is work in progress!
1541140930

Edited 1541140945
Ammo
Pro
v0.16 posted on github This version contains fixes and a new feature that enumerates player-owned characters and helps record which players were present and to calculate APL. &nbsp; Screenshots updated above.
1541176545
Stephanie B.
Forum Champion
Sheet Author
Very Cool! I'm definitely interested in this!
1541180355

Edited 1541180370
Ammo
Pro
If you are willing to try out early release software, I could really use a "customer" to keep this moving along. &nbsp; If you do end up using it, I would really appreciate any bugs filed. &nbsp; Pull requests are also welcome but certainly not required :)
version 0.17 pushed&nbsp;<a href="https://github.com/derammo/der20/releases/tag/v0.17" rel="nofollow">https://github.com/derammo/der20/releases/tag/v0.17</a> &nbsp; &nbsp; implemented debug output option for all plugins&nbsp;<a href="https://derammo.github.io/der20/#PLUGIN/option_debug" rel="nofollow">https://derammo.github.io/der20/#PLUGIN/option_debug</a> &nbsp; &nbsp; added stack traces to console output on errors &nbsp; &nbsp; fixed option delete command to take effect immediately &nbsp; &nbsp; implemented optional validation on configuration input &nbsp; &nbsp; &nbsp; &nbsp;
1541967039

Edited 1541967064
Ammo
Pro
========================================================== !rewards Release v0.19 ========================================================== [ github commit 29effc9 by Ammo Goettsch on 2018-11-06 ] fixed calculation of mixed tier rewards hard covers that do not include tier 2 or lower were showing rewards for tier 2 vs tier 3
How do you add&nbsp; Consumables?
Kilter said: How do you add&nbsp; Consumables? I have not implemented that yet. &nbsp; There seemed to be no interest in this script, so I was working on other things. &nbsp;If you want, I can easily add consumables support.
That would be nice. I've been playing around with it and think I am getting the hand of it. Just couldn't figure out story award or consumables.
Kilter said: That would be nice. I've been playing around with it and think I am getting the hand of it. Just couldn't figure out story award or consumables. Awesome. &nbsp;New version is about to come out that has GUI for adding modules/dms/objectives/unlocks, so you don't have to just type those long commands any more, unless you want to. I can add Consumables next. &nbsp;I had waited on this because they tie into the "players in the session" concept because I will let you choose a player when the consumable is found, so that it says it was found and given to 'Bob' or whatever, which will also end up in the final report. I have not given much though to Story Awards. &nbsp;Do you think these should be done like objectives that just don't award any ACP and TCP, or should they be their own thing? &nbsp; What is most intuitive here? &nbsp; Don't these vary by character though? &nbsp; Not everyone gets the same story awards I think?
Less typing the better.&nbsp; It seems story awards can be giving to one or multiple characters, and from what I can see they don't have ACP or TCP tied to them. If there is a way to add one or more player selection to an items/awards giving that would be easier than having to add the item more than once.
1544481976
Surok
Roll20 Production Team
I'll try this out. I run an AL group here on Roll20 so plenty of opportunity to test it out.
Surok said: I'll try this out. I run an AL group here on Roll20 so plenty of opportunity to test it out. Awesome. &nbsp;Do me a favor and wait 3 days though? &nbsp;I am about the release the new, much much easier to use version.
1544537244
Surok
Roll20 Production Team
Will do.
Any update?
Sorry, trying to find time to write up new instructions :(
No worries. Just looking forward to it. :)