Revision as of 18:41, 21 September 2021

Page Updated:   2021-09-21

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.

• Oosh's explanation of CRP^(Forum)
• Custom Roll Parsing for Character Sheets

Parts

• An action button
• sheetworker to parse the roll sent with the action button
• Changes to Roll Templates to display the roll

Currently you can only display computed values in the first 10 fields that are sent in the macro.

Example:

<button type="action" name="act_test">Click me</button>

<rolltemplate class="sheet-rolltemplate-test">
    <div class="sheet-template-container">
        <h1>{{name}}</h1>
        <div class="sheet-results">
            <h4>Result = {{roll1}}</h4>
            <h4>Custom Result = {{computed::roll1}}</h4>
        </div>
    </div>
</rolltemplate>

<script type="text/worker">
    on('clicked:test', (info) => {
        startRoll("&{template:test} {{name=Test}} {{roll1=[[1d20]]}}", (results) => {
            const total = results.results.roll1.result
            const computed = total % 4;

            finishRoll(
                results.rollId,
                {
                    roll1: computed
                }
            );
        });
    });
</script>

Forum threads

• Adventures with startRoll()^(Forum) Aug, 2021 by Oosh
  • long discussion with many details
• Custom Roll Parsing - Separating groups of dice by type^(Forum)
• Now on Dev Server: Custom Roll Parsing for Character Sheets^(Forum) - old thread back when this was on Dev Server for testing

See Also

• Custom Roll Parsing for Character Sheets