${part.text||ch(' ')}
` : '')+
`${o.join(' ')}
`, items: (o) => `${o.join(' ')}`,
attr: {
bare: (o)=>`${ch('@')}${ch('{')}${o}${ch('}')}`,
selected: (o)=>`${ch('@')}${ch('{')}selected${ch('|')}${o}${ch('}')}`,
target: (o)=>`${ch('@')}${ch('{')}target${ch('|')}${o}${ch('}')}`,
char: (o,c)=>`${ch('@')}${ch('{')}${c||'CHARACTER NAME'}${ch('|')}${o}${ch('}')}`
},
bold: (...o) => `${o.join(' ')}`,
italic: (...o) => `${o.join(' ')}`,
font: {
command: (...o)=>`${o.join(' ')}`
}
},
showHelp = function(playerid) {
let who=(getObj('player',playerid)||{get:()=>'API'}).get('_displayname');
sendChat('','/w "'+who+'" '+
_h.outer(
_h.title('RecursiveTable',version),
_h.header(
_h.paragraph('RecursiveTable provides a way to expand the results of Rollable Tables which have inline rolls within them. Now with options and support for whispering Roll Templates.'),
_h.paragraph(`When using Rolltemplates, your message must have at least one ${_h.code(ch('{')+ch('{'))} that in not coming from a Rollable Table. When using the ${_h.code('PrefaceUniqueSpace')} option, be sure your ${_h.code(`${ch('{')}${ch('{')}name=something${ch('}')}${ch('}')}`)} is first.`)
),
_h.subhead('Commands'),
_h.inset(
_h.font.command( `!rt${_h.optional('options')} ${_h.optional('--help', '...')}`),
_h.paragraph('Performs all inline rolls, then continues to expand inline rolls (to a maximum depth of around 10).'),
_h.ul(
`${_h.bold('--help')} -- Shows the Help screen`,
`${_h.bold('...')} -- Anything following ${_h.code('!rt')} will be expanded, then sent to to the chat.`
),
_h.section('Options'),
_h.paragraph(`These are inline settings to adjust how the rolls are put together. Options are specified in ${_h.code(ch('['))} ${_h.code(ch(']'))} right after the ${_h.code('!rt')}:`),
_h.inset(
_h.pre(`!rt[delimiter:-|maxdepth:20] something`)
),
_h.paragraph( `Options are separated with the verticle pipe symbol (${_h.code(ch('|'))}) and have an optional argument separated by a ${_h.code(':')} or by ${_h.code('%%')} (Useful for API Command buttons where : causes problems). Omitting the argument causes ${_h.bold('true')} to be used for switch options, or the default value. All Options are case insenstive. Options are one of 3 types: Number (any integer), Boolean (true values: ${_h.code('on')}, ${_h.code('yes')}, ${_h.code('y')}, ${_h.code('true')}. false values: ${_h.code('off')}, ${_h.code('no')}, ${_h.code('n')}, ${_h.code('false')}), or text (any value except ${_h.code(']')}, use ${_h.code(ch('\\')+ch('|'))} for ${_h.code(ch('|'))})`),
_h.ul(
`${_h.bold('MaxDepth')} -- Specifies the number of recursions to perform. ${_h.bold('Default: 10 (Number)')}`,
`${_h.bold('Delimiter')} -- A string of text to put between table items. The special value ${_h.code('BR')} will cause html line breaks to be used. ${_h.bold(`Default: ${_h.code(', ')} (String)`)}`,
`${_h.bold('DropEmpty')} -- Causes empty table items to be dropped before joining with the delimiter. ${_h.bold('Default: on (Boolean)')}`,
`${_h.bold('Sort')} -- Causes table items to be sorted before being joined by the delimiter. Note that this happens at a single layer of recursion, so if you have table items made of of lists of table items, the sorting will only be at each level. ${_h.bold('Default: off (Boolean)')}`,
`${_h.bold('PrefaceUniqueSpace')} -- Causes the final message to have a unique number of spaces inserted after each ${_h.code(ch('{')+ch('{'))}. This is useful if you${ch("'")}re building Roll Templates and might have multiple lines with the same label. ${_h.bold('Default: off (Boolean)')}`,
`${_h.bold('ShowIcons')} -- Adds table avatars as inline icons, if they exist. ${_h.bold('Default: off (Boolean)')}`,
`${_h.bold('IconLabel')} -- When table icons are shown, the text for the row is shown as a label below it. ${_h.bold('Default: on (Boolean)')}`,
`${_h.bold('IconScale')} -- When table icons are shown, they are restricted to the provided scale. Any valid CSS size setting will work. ${_h.bold('Default: 5em')}`
),
_h.section('Examples'),
_h.paragraph('Basic usage, whispering treasure to the gm:'),
_h.inset(
_h.pre( `!rt /w gm ${ch('[')+ch('[')}1t${ch('[')}treasure-table${ch(']')+ch(']')+ch(']')}`)
),
_h.paragraph('Whispering a roll template:'),
_h.inset(
_h.pre( `!rt /w gm ${ch('&')+ch('{')}template:default${ch('}')+ch('{')+ch('{')}treasure=${ch('[')+ch('[')}1t${ch('[')}treasure-table${ch(']')+ch(']')+ch(']')+ch('}')+ch('}')}`)
),
_h.paragraph('Whispering a roll template, with each item on a separate line:'),
_h.inset(
_h.pre( `!rt${ch('[')}Delimiter:BR${ch(']')} /w gm ${ch('&')+ch('{')}template:default${ch('}')+ch('{')+ch('{')}treasure=${ch('[')+ch('[')}1t${ch('[')}treasure-table${ch(']')+ch(']')+ch(']')+ch('}')+ch('}')}`)
),
_h.paragraph( `Whispering a roll template, with each item on a separate line, with empty results replaced by ${_h.code('Nothing')}:`),
_h.inset(
_h.pre(`!rt${ch('[')}Delimiter:BR|EmptyDefault:Nothing${ch(']')} /w gm ${ch('&')+ch('{')}template:default${ch('}')+ch('{')+ch('{')}treasure=${ch('[')+ch('[')}1t${ch('[')}treasure-table${ch(']')+ch(']')+ch(']')+ch('}')+ch('}')}`)
),
_h.paragraph(`Whispering a roll template, with each item on a separate line, with a table that is returning ${_h.code(`${ch('{')+ch('{')}label=values${ch('}')+ch('}')}`)}:`),
_h.inset(
_h.pre(`!rt${ch('[')}Delimiter:BR|PrefaceUniqueSpace${ch(']')} ${ch('&')+ch('{')}template:default${ch('}')+ch('{')+ch('{')}name=Treasure Bundles${ch('}')+ch('}')+ch('[')+ch('[')}5t${ch('[')}treasure-bundle${ch(']')+ch(']')+ch(']')}`)
)
)
)
);
},
getAsBoolean = function(val,defVal){
let isTrue = _.isBoolean(val) ? val : _.contains(['on','yes','y','true'],(`${val}`||'true').toLowerCase()),
isFalse = _.isBoolean(val) ? !val : _.contains(['off','no','n','false'],(`${val}`||'true').toLowerCase());
if(isTrue || isFalse){
return !isFalse;
}
return !_.isUndefined(defVal) ? defVal : val;
},
parseOptions = function(cmdOpts){
return _.chain((cmdOpts||'').replace(/((?:\\.|[^|])*)\|/g,'$1\n').replace(/\\/,'').split(/\n/))
.filter((a)=>a.length)
.reduce((m,o)=>{
let tok=o.split(/(?:%%|:)/),
c=tok.shift().toLowerCase(),
a=tok.join(':')||true;
switch(c){
case 'maxdepth':
a=parseInt(a,10)||defaults[c];
break;
case 'iconscale':{
if(! regex.cssSize.test(a)){
a=defaults[c];
}
}
break;
case 'showicons':
case 'iconlabel':
case 'dropempty':
case 'sort':
case 'prefaceuniquespace':
case 'echo':
a=getAsBoolean(a,defaults[c]);
break;
case 'emptydefault':
break;
case 'prefix':
case 'suffix':
case 'delimiter':
switch(a.toLowerCase()){
case 'br':
a = '${eRoll}${e.message}${eRoll}${e.message}${eRoll}${e.message}${eRoll}${e.message}${eRoll}${e.message}${msg_orig.content}