Aller au contenu principal
astuce

To open a context menu, right-click (or long press on mobile) on a message, then select Application.

Create a Link to a Result

This command allows you to generate a direct link to a dice roll result from the bot. Useful for sharing a specific result in another channel or with another user.

This command can be customized in two ways:

  • Per user, for each server, using /user_config create_link
  • Per server, by administrators, using /config create_link
important

The server format takes priority over the user format.

Format​

Usage

/config create_link format [final] (results) (dice) (info) (name) (original_dice) (character) (join_results)

  • dice: The raw dice result, usually [RES](SIGN)(COMPARISON), for example [29]>=10.
  • info: The information text, such as critical (including custom), failure, or success messages.
  • name: The name of the statistic or macro, if one is found.
  • join_results: The text used to join multiple results together.
  • results: A list that contains the combination of dice and info, joined using the join_results variable.
  • final: The final format that combines variables to build the link.
  • original_dice: The original dice rolled, for example 1d100.
  • character: The name of the character who rolled the dice.
Attention

Discord does not allow trailing (or leading) spaces in options. If you want to add a space at the beginning or end of a variable, use \s to represent a space.

When variables are left empty, default values are used.

Variables​

To simplify format creation, you can use the following variables in your format fields:

  • {{dice}} : Dice result (example: [29]>=10)
  • {{info}} : Information text (example: Critical Failure)
  • {{name}} : Statistic or macro name (example: Strength)
  • {{results}} : List combining multiple {{dice}} and {{info}}
  • {{link}} : Link to the message containing the dice result
  • {{original_dice}} : The original dice rolled (example: 1d100)
  • {{character}} : The name of the character who rolled the dice

It is also possible to associate specific functions with these variables by adding:

  • :upper: capitalizes all characters.
  • :lower: lowercases all characters.
  • :title: capitalizes the first letter of each word.
  • :capitalize: capitalizes only the first letter.
  • :standardize: removes accents by replacing them with standard characters (é -> e, ü -> u, etc.).
  • :trunc=N: truncates to N characters. For example, {{name:trunc=5}} will give the first 5 characters of the name.
  • :short: Keeps only the initials if the word contains several (example: Jean-Luc Picard becomes JLP).
  • :long: Keeps the entire word unchanged (exactly as if no option were applied).

These options are applied in the order in which they are written. For example, {{name:short:upper}} will give the initials in uppercase.

These variables can only be used in the corresponding format fields, not in the final field.

Results ({{results}})​

The {{results}} variable is actually a list joined using the variable join_results. This variable can only contain:

  • {{dice}}
  • {{info}}
  • {{original_dice}}

Final​

The final variable may only contain {{results}}, {{link}}, and {{name}}.

Variable Diagram

Default​

By default, the format is defined as follows:

  • Final: [[{{name}}{{results}}]](<{{link}}>),
  • Results: {{info}} `{{dice}}` ,
  • Join results: ; ,
  • Dice: {{dice}},
  • Info: {{info}} - ,
  • Name: __{{name}}__: ,
  • Original Dice: {{original_dice}},
  • Character: {{character}}

Which gives: [[__Name__ : Critical Failure - `[29] ⩾ 10`]](<https://discord.com/channels/guildId/channelId/messageId>)

Display​

Usage

/config create_link display

Displays the list of the current link formats for the server, along with an example based on the following format:

__**Character**__ (<@000000000000000000>)  (\`>= 11\`):
[__Nom__]
  **Critical Failure** — \`1d100\` ⟶ \`[29]\` = \`[29] ⩾ 10\`

Reset​

Usage

/config create_link reset

Remove the configuration and reset the link format to default values.