@dicelette/core

@Core

The core module for Dicelette, contains :

• The dice function (that parse the string into a Dice Parser and send the result in a good message) ;
• The verification of the template

The two are used in the bot and documentation.

Type alias

• Sign: "+" | "-" | "*" | "/" | "%" | "^" | "**";
• Statistic : { [name: string]: { combinaison?: string; max?: number; min?: number; } } :
  • name: string : The name of the statistic
  • combinaison: string : A combinaison between multiple/other statistic, formula... (ex: constitution+2). Can't coexist with min & max.
  • max: number : The maximum value of the statistic
  • min: number : The minimum value of the statistic

Interface (index.d.ts)

Compare

• sign: "<" | ">" | ">=" | "<=" | "=" | "!=" | "=="
• value: number

Critical

• Optional failure: number
• Optional success: number

Modifier

• sign: Sign
• value: number

Resultat

• Optional comment: string
• Optional compare: Compare
• dice: string
• Optional modifier: Modifier
• result: string

Statistical Template

Example

diceType: "1d20+{{$}}>=20"

The dice throw will be 1d20 + statistique that must be less than 20

diceType: "1d20<=$"

The dice throw will be 1d20 that must be less than the statistic

Properties

• Optional charName: boolean Allow to force the user to choose a name for them characters

• Optional critical: Critical How the success/echec will be done

• Optional damage: { [name: string]: string } Special dice for damage

• Optional diceType: string A die type in the notation supported by the bot. See documentation for syntaxe.

• Optional statistics: Statistic

• Optional total: number A total can be set, it allows to calculate the total value of a future register member If the sum of the value > total, the bot will send a message to the user to inform him that the total is exceeded and an error will be thrown Note: Statistic that have a formula will be ignored from the total

Modules

Dice

Variables

• const COMMENT_REGEX: RegExp

Functions

calculator(sign, value, total): number

Evaluate a formula and replace "^" by "**" if any

Name	Type
sign	Sign
value	number
total	number

roll(dice): Resultat | undefined

Parse the string provided and turn it as a readable dice for dice parser

Name	Type	Description
dice	string	{string}

Utils

cleanedDice(dice): string

Replace the ++ +- -- by their proper value:

• ++ = +
• +- = -
• -- = +

Name	Type	Description
dice	string	{string}

escapeRegex(string): string

Escape regex string

Name	Type	Description
string	string	{string}

generateStatsDice(originalDice, stats?): string

Replace the stat name by their value using stat and after evaluate any formula using replaceFormulaInDice

Name	Type	Description
originalDice	string	{dice}
stats?	Object	{[name: string]: number}

replaceFormulaInDice(dice, stats): string

Replace the {{}} in the dice string and evaluate the interior if any

Name	Type	Description
dice	string	{string}

Verify Template

diceRandomParse(value, template): string

Generate a random dice and remove the formula (+ evaluate it) Used for diceDamage only

Name	Type	Description
value	string	{string}
template	StatisticalTemplate	{StatisticalTemplate}

diceTypeRandomParse(dice, template): string

Name	Type	Description
dice	string	{string}
template	StatisticalTemplate	{StatisticalTemplate}

evalCombinaison(combinaison, stats): Object

Random the combinaison and evaluate it to check if everything is valid

Name	Type	Description
combinaison	Object	{[name: string]: string}
stats	Object	{[name: string]: string|number}

evalOneCombinaison(combinaison, stats): any

Evaluate one selected combinaison

Name	Type	Description
combinaison	string	{string}
stats	Object	{[name: string]: string|number}

evalStatsDice(testDice, stats?): string

Verify if the provided dice work with random value

Name	Type	Description
testDice	string	{string}
stats?	Object	{[name: string]: number}

generateRandomStat(total?, max?, min?): number

Name	Type	Default value
total	undefined | number	100
max?	number	undefined
min?	number	undefined

testCombinaison(template): void

Test all combinaison with generated random value

Name	Type
template	StatisticalTemplate

testDamageRoll(template): void

Test each damage roll from the template.damage

Name	Type
template	StatisticalTemplate

verifyTemplateValue(template): StatisticalTemplate

Parse the provided JSON and verify each field to check if everything could work when rolling

Name	Type
template	any

Changelog

1.8.7 (2024-12-12)

Bug Fixes

• dice: handle non-dice throw evaluation in parseDice function (2eb2846)