Character Vault
Any Concept / Any System
Compendium
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Difference between revisions of "Script:Muler"

From Roll20 Wiki

Jump to: navigation, search
m
(Add TokenMod example)
Line 1: Line 1:
 
<noinclude>{{revdate}} {{main|Meta-Toolbox}}{{Meta-ToolboxNav}}
 
<noinclude>{{revdate}} {{main|Meta-Toolbox}}{{Meta-ToolboxNav}}
 
=Muler=</noinclude>
 
=Muler=</noinclude>
'''{{fpl|10005710/ Muler}}''' provides a way to store values on a [[character sheet]] in an ability (called a Mule). Syntax tokens can be used in any API command line to load a mule, retrieve a variable, and/or set a variable. Since the variable is stored on a character sheet, it persists between rolls, game sessions, or even campaigns.
+
'''{{fpl|10005710/ Muler}}''' provides a way to store values on a [[character sheet]] in an '''[[Character#Abilities|ability]]''' (not ''[[Character#Attributes|attribute]]''), which we call a "Mule". Syntax tokens can be used in any API command line to load a mule, retrieve a variable, and/or set a variable. Since the variables are stored on a character sheet, they persists between rolls, game sessions, or even campaigns.
 +
 
 +
A clever bit about this is that usually people use character attributes to store custom stats, but as Mule store the as Abilities, they can be more easily read, and can't de accidentally deleted by commands that updates character attributes.
 
* {{fpl|10292476/ Muler (thread 2)}}
 
* {{fpl|10292476/ Muler (thread 2)}}
 
<noinclude>__TOC__</noinclude>
 
<noinclude>__TOC__</noinclude>
Line 16: Line 18:
  
 
<noinclude>==</noinclude>'''Example'''<noinclude>==</noinclude>
 
<noinclude>==</noinclude>'''Example'''<noinclude>==</noinclude>
<pre style="overflow:auto;white-space:pre-wrap;">!somescript --stuff|get.thestuff {& mule ModMule} --tacos
+
 
 +
<pre>!somescript --stuff|get.thestuff {& mule ModMule} --tacos
 
!somescript --mod|get.initMod {& mule Viper.ModMule}</pre>
 
!somescript --mod|get.initMod {& mule Viper.ModMule}</pre>
 +
 +
'''[[TokenMod]] + Muler'''
 +
 +
Sets the value of bar3 on the selected token to the value of the "Stunned"-variable, which is stored in an character ability named "ConditionTable", for a character named "Blue". To make this command work, Create character named {{c|Blue}}, with and ability named {{c|ConditionTable}}, and save it's content as <code>Stunned=5</code>.
 +
<pre>!token-mod {{!token-mod {{
 +
--set bar3|get.Stunned {& mule Blue.ConditionTable}
 +
}}</pre>
 +
 
<noinclude>
 
<noinclude>
 
==Meta-Toolbox Examples==
 
==Meta-Toolbox Examples==

Revision as of 16:01, 12 March 2022

Main Page: Meta-Toolbox

Muler

Muler(Forum) provides a way to store values on a character sheet in an ability (not attribute), which we call a "Mule". Syntax tokens can be used in any API command line to load a mule, retrieve a variable, and/or set a variable. Since the variables are stored on a character sheet, they persists between rolls, game sessions, or even campaigns.

A clever bit about this is that usually people use character attributes to store custom stats, but as Mule store the as Abilities, they can be more easily read, and can't de accidentally deleted by commands that updates character attributes.

Contents

Syntax

Drop these syntax tokens into any API command to trigger the associated behavior. They will be filtered out (or replaced with the appropriate data) by the script.

{& mule ModTable}                                => loads the first ModTable mule it finds (from characters you control)
{& mule TableMule.ModTable}                      => loads the ModTable mule from the TableMule character
{& mule Cake Izzard.OrDeath}                     => loads the Cake mule (first found) as well as Izzard's OrDeath mule
get.4                                            => if mules are loaded, attempts to retrieve the variable "4"
get.ModTable.4                                   => gets the variable "4" from the ModTable mule (ModTable must be loaded)
get.TableMule.ModTable.4                         => same, but specifically from the TableMule character
set.Izzard.Cake.Rush = We're all outta cake/set  => sets the "Rush" variable in Izzard's Cake mule to "We're all outta cake"
                                                    note the ending /set to close the variable's value

Example

!somescript --stuff|get.thestuff {& mule ModMule} --tacos
!somescript --mod|get.initMod {& mule Viper.ModMule}

TokenMod + Muler

Sets the value of bar3 on the selected token to the value of the "Stunned"-variable, which is stored in an character ability named "ConditionTable", for a character named "Blue". To make this command work, Create character named Blue, with and ability named ConditionTable, and save it's content as Stunned=5.

!token-mod {{!token-mod {{
--set bar3|get.Stunned {& mule Blue.ConditionTable}
}}


Meta-Toolbox Examples

Examples using one or more Meta-Toolbox APIs

Other APIs