Back to the Index

Script Help

Return to Tumult employs a lot of scripts that are used to handle the basic fundamentals of the game, everything from rolling dice to the expenditure of Willpower or Essence. This page is, quite simply, a summary and "help" page for using the various scripts.

Go to Chardice/Exaltdice, Stats, and Essence/Willpower


Chardice & Exaltdice

Both Chardice and Exaltdice work similarly; they are both dice-rolling scripts, predicated on rolling a given amount of dice with a lot of different modifiers and tags. Both are used in the same general format; !chardice "Stats" +# <tags>, or !exalt "Amount" +# <tags>

"Stats" refers to up to four character traits. An example would be Compassion, Str+Damage, Dex+Melee+Acc, or Stamina+Endurance+Ess+Conv. I've tried to ensure that the script can support any common abbreviations for traits, as well as frequent typos or mispellings. I can easily add more variations without difficulty.

"Amount", by contrast, is simply a number. It might be 3, 17, or even 40. The number determines the base amount of dice that will be rolled, but can be modified by other traits.

Chardice & Exaltdice Tags

A tag can come directly after "Stat"/"Amount" or after the +# modifier. It doesn't matter what order you enter tags, nor how many tags you use. Some tags might not do anything without the presence of other tags, however, but they should not actually cause problems. Tags are not case sensitive.

Basic Tags

  • dif-# determines the Difficulty of the roll. Both "dif", and "-#" must be a part of the tag for it to be detected. Thus "diff-#" or "difficulty-#" would both work, while "d-#" would not.
  • pen-# is a "hard" dice penality. These are used for wound penalities and individual split action penalities. These penalities can and will reduce your dice pool to 0, and thus are more severe. Both "pen" and "-#" must be a part of tag for it to be detected. Thus, "penality-#" would work. You can also enter these penalities as part of your +# modifier (just use -# instead). The pen-# tag is included for ease of use only.
  • soak-# is a "loose" dice penality. This is mostly used for enviromental penalities, soak totals, and most magical penalities that subtract dice. These penalities cannot reduce a dice pool lower than the characters Essence.
  • tn-# sets the Target Number for the roll. This is mainly used for Sidereals.
  • dmg is the Damage-dice tag. It prevents 10s from being counted twice. You can also use extra.
  • x2 is the pool-doubling tag. It doubles the entire pool, after applying all relevant modifiers.
  • -s is the secret tag. It ensures that nobody except the Storyteller will see the results of the roll.

Advanced Tags

  • split-# allows you to automatically split your pool for # actions. This automatically assesses an appropriate multiple action penality, and displays the resulting successes from each roll.
  • cascade-# is allows you to reroll a given pool # times.
  • ess-# is a tag that sets the Essence minimum. This can be used to set the tag to a trait other than Essence, or in order to set it at an actual number.
  • raw is the tag to display the results of all of the dice roll. The number that came up on every individual dice is given, for all of the pools of 1 die or above. This is optional; unless you include this tag, this information will not be shown.
  • -r is the reducing cascade tag. It is used when your making a cascade-#, and causes the pool rolled to loose one die for every roll after the first. Any penality applied to the first pool must be assessed normally. This tag is not necessary unless you are using the cascade option.
  • hp is the halve-penality tag. It is useful for both splits and cascades. When used with a split, it halves the initial penality for the first dice action. It also slows the rate of atrophy, making it so you only loose one full die per two rolls.

The Stat script

This script displays and modifies a characters statistics. It functions quite simply, !stat Stat <tag>.

If no tags are included, the !stat script will display the resulting stat or stats. In this case, you can choose to use Stats such as "Dawn", "Fire" or "War". You can also use groupings like "Dex+Melee", up to four stats, similar to the workings of Chardice.

All of the tags deal with modifying a very specific attributes. Thus when using tags you must supply a given attribute such as "Strength" or "Melee". Other groupings are not supported, and will result in errors.

Basic Tags

  • inc-# modifiers the stat upward, raising it. This change is reversable with the revert tag.
  • dec-# modifies the stat downward, lowering it. This change is reversable with the revert tag.
  • set-# changes the value of the stat. This is a permanent change, and should be used with care.
  • revert resets the stat to its original value after its been increased or decreased. This does not work after set-# has been used, as that tag permanently changes the value of the stat.

One final function of Stat is "!stat revert". If you type this, you revert ALL of your statistics! This is generally useful, especially if you've forgotten what all you've modified.


Essence & Willpower scripts

This script is currently getting reworked! More information will be provided once the programming is near complete.