##CategoryProjects
##CategoryCalinsProjects
----

Author: ["Calin"]

Language: [wiki:WikiPedia/MUF_%28programming_language%29 MUF]

Platform: [http://www.protomuck.org ProtoMUCK]

----

== Usage ==
{{{
Roll [options] [dice spec] ...
}}}

= options =

{{{    #hide }}}                   Do not show results to the entire room

{{{    #list[:{macro}] }}}         Show the specified macro, or show all macros

{{{    #user:{name} }}}            Use the specified user's macros instead of your own

{{{    #spec }}}                  Show a full description of the dice spec

{{{    #define:{macro}={spec} }}}  Create a new personal macro

{{{    #delete:{macro} }}}        Delete the specified personal macro dice spec examples

{{{    3d6 }}}           Roll 3 6-sided dice

{{{    1f20+12 }}}       Roll 1 20-sided die with houserules -10/+10, and add 12

The dice spec cannot have spaces in it.  You can roll multiple specs at once by separating them with spaces.

== Spec ==
The spec consists of the following tokens:

{{{   {number} }}}     A literal number

                 Example: {{{ 13 }}}

{{{   {alpha} }}}      A word containing only letters is a macro, which can be a full or partial dice spec.  Use {{{ #define }}} to create macros.

                 Example: {{{ fire }}}

                 Resolves to: {{{ 1d4+1 }}}

{{{   (spec) }}}       A spec inside parenthesis will be evaluated to a single number before other tokens are evaluated.

                 Example: {{{ (1,2) }}}

                 Resolves to: {{{ 3 }}}

{{{   _ }}}            This will evaluate to a list of numbers, from the preceding to the following, inclusive.

                 Example: {{{ 1_5 }}}

                 Resolves to: {{{ 1,2,3,4,5 }}}

{{{   [spec] }}}       A token will be chosen at random from within this spec.

                 Example: {{{ [1,2,3] }}}

                 Resolves to: one of: {{{ 1 }}} , {{{ 2 }}} or {{{ 3 }}}

{{{   @ }}}            Repeats the following token a number of times equal to the previous token.

                 Example: {{{ 3@5 }}}

                 Resolves to: {{{ 5,5,5 }}}

{{{   + - }}}          These only effect the sign of the following number.

                 Example1:   {{{ +3 }}} Resolves to: {{{ 3 }}}

                 Example2: {{{ -5 }}}   Resolves to: {{{ -5 }}}

{{{   * / }}}          These perform multiplication and division.

                 Example1:    {{{ 6*2 }}} Resolves to {{{ 12 }}}

                 Example2:    {{{ 9/3 }}} Resolves to {{{ 3 }}}

{{{   > }}}            This may only be used in macros, and lets the macro pull in the following token.

                 Example: The macro 'd' is defined as {{{ @[1_>] }}}
so {{{ 3d8 }}} resolves to {{{ 3@[1_8] }}}, which resolves to {{{ [1_8][1_8][1_8] }}} which might resolve to {{{ 3,7,4 }}}.

{{{   Other }}}        Any other symbol is discarded,  but serves to separate tokens

                 Example: {{{ 3,2 }}} Resolves as {{{ 3,2 }}}

                 The comma is discarded, but prevents it from resolving as {{{ 32 }}}.