Lancer de dés

[Discourse]

	Résumé	Dice Roller ajoute un lanceur de dés complet à vos messages Discourse, idéal pour les besoins de jeu de votre forum !
	Lien du dépôt	https://github.com/discourse/discourse-dice
	Nouveau dans les thèmes Discourse ?	Guide de démarrage pour utiliser les thèmes Discourse

Installer ce composant de thème

Étant donné qu’il s’agit d’un composant de thème official maintenu par l’équipe Discourse, les demandes de Support, Contribute > Bug, Contribute > UX et Contribute > Feature peuvent être faites dans les catégories respectives ici sur Meta, et marquées avec le tag approprié du composant de thème. Cliquez sur un lien ci-dessous pour en créer un.

 Support  Bug  UX  Fonctionnalité

Administrateurs : Envisagez de désactiver le paramètre discourse narrative bot disable public replies après l’installation, car ce composant de thème rend entièrement obsolète le comportement de lancer de dés du bot.

Utilisation de base

Le composant de thème interprète les lancers formatés comme [wrap=dice].

[wrap=dice]d20[/wrap]
[wrap=dice]d100[/wrap]
[wrap=dice]2d6[/wrap]

Vous pouvez lancer plusieurs dés du même type, appliquer des modificateurs additifs, et vérifier automatiquement le résultat par rapport à un seuil de succès :

[wrap=dice]2d6+3t12[/wrap]

Fonctionnalités avancées : Crits, Lancers fractionnés

Vous pouvez spécifier des lancers naturels particuliers pour qu’ils soient traités comme des « coups critiques » avec l’option crit=. Les coups critiques sont vérifiés avant le modificateur additif.

[wrap=dice crit=1,100]1d100[/wrap]
[wrap=dice crit=1,20]d20+3[/wrap]

Si certaines valeurs de crit sont notables sur votre forum, un administrateur peut ajouter du CSS supplémentaire pour les mettre en évidence. Dans cet exemple, les critiques qui tombent sur un 1 sont colorées en rouge.

Si vous autorisez plusieurs lancers à être vérifiés par rapport au même seuil, vous pouvez ajouter le modificateur i Individuel conjointement avec les t Seuils. Le nombre de dés ayant réussi le seuil sera résumé à la fin.

[wrap=dice]5d100t60i[/wrap]
[wrap=dice]3d20-5t0i[/wrap]

Actuellement, les lancers pré-modificateur sont affichés. Cela pourrait changer à l’avenir en fonction des retours.

Restrictions

Pour éviter les abus avec des corps de message volumineux, un nombre maximum de dés par lancer est disponible dans les paramètres du thème pour que l’administrateur puisse l’ajuster. La valeur par défaut est de 80 dés.

Les dés à 0 face et à 1 face ne sont pas autorisés. Lancer 0 dé n’est pas autorisé, et les dés avec plus d’environ 67 millions de faces ne sont pas autorisés pour des raisons de performance.

Détails techniques, et triche

Les lancers sont calculés en JavaScript en utilisant un générateur de nombres aléatoires (RNG) amorcé par l’ID du message et son horodatage de création, en parcourant le corps du message dans l’ordre. Les valeurs des lancers ne sont pas visibles avant la création du message.

Plusieurs styles de formatage spéciaux sont appliqués aux lancers, pour les distinguer du texte normal dans les messages. Cela n’empêche pas les gens de poster des images !

Les valeurs des lancers ne sont pas enregistrées automatiquement dans le corps du message. Cela pose un problème pour les besoins d’archivage. Les solutions à cela nécessiteront l’utilisation d’un plugin.

Si vous devez ajouter d’autres lancers de dés à votre message, ils doivent être ajoutés en bas pour préserver les résultats de tous les lancers précédents. Ajouter de nouveaux lancers de dés en haut d’un message randomisera les résultats de tous les lancers. Pour cette raison, la présence de n’importe quel lancer erroné dans un message empêchera tous les lancers suivants de fonctionner.

L’aperçu du compositeur vous indiquera si votre spécification de dé est correcte ou erronée.

Bien que ces mesures puissent aider à prévenir la triche accidentelle, un tricheur déterminé peut essayer de prédire quand il devrait soumettre son message. Si vous envisagez cela pour quelque chose de précieux, faites autoriser le message par un utilisateur de confiance qui ne peut pas recevoir la récompense, ou utilisez une source indépendante comme https://random.org , qui propose des services payants pour des tirages et des loteries auditable.

N’oubliez pas de vous amuser !

Paramètres

Nom	Description
max dice

Traduction	Défaut
dice.result.success_count.one	(%{count} Succès)
dice.result.success_count.other	(%{count} Succès)
dice.excessive.quantity.one	Quantité excessive de dés (max %{count})
dice.excessive.quantity.other	Quantité excessive de dés (max %{count})
dice.excessive.faces	Le nombre de faces de dé ne peut pas dépasser 67 000 000
dice.missing.faces	Spécification de dé invalide : nombre de faces manquant
dice.invalid.generic	Spécification de dé invalide. Format : 2d20+3
dice.invalid.quantity	Le nombre de dés ne peut pas être 0
dice.invalid.faces	Le nombre de faces de dé ne peut pas être 0 ou 1
dice.invalid.modifier	Le modificateur ne peut pas être 0
dice.invalid.threshold	Le seuil ne peut pas être 0
dice.invalid.crits	Nombres incorrects dans l’attribut crits. (Doit être crits=4,5,6)
dice.invalid.halt_after_error	Lancer arrêté en raison d’une erreur précédente. Corrigez les erreurs pour voir les résultats.

Hébergé par nous ? Les composants de thème sont disponibles à l’utilisation sur nos plans Standard, Business et Enterprise.

[hugh (Hugh Lashbrooke)]

Si cela intéresse quelqu’un d’implémenter un lanceur de dés plus polyvalent dans Discourse en utilisant une persona IA, je l’ai fait sur une communauté que je gère et cela fonctionne excellemment. J’ai configuré une persona IA et je lui ai permis d’utiliser l’outil Random Picker, j’ai défini le paramètre ‘max context posts’ à 1, et je lui ai donné ces instructions :

Vous êtes Random Picker Bot, spécialisé dans le lancer de dés.

• Vous avez accès à la fonction Random Picker pour obtenir des résultats véritablement aléatoires.
• Les utilisateurs vous invoqueront lorsqu’ils auront besoin de lancer un dé avec un nombre de faces spécifié.
• Les utilisateurs spécifieront un dé à lancer, parfois en indiquant combien, et s’il faut ajouter d’autres modificateurs au résultat.

Dés :
Les dés sont identifiés par la lettre d suivie d’un nombre, le résultat du dé peut être n’importe quoi de 1 jusqu’à ce nombre. Par exemple, si l’utilisateur dit “d8”, vous lancerez un dé à 8 faces et retournerez un seul nombre de 1 à 8.

Dé de pourcentage :
L’utilisateur peut utiliser le symbole % pour le type de dé, comme ceci : d%. Dans ce cas, lancez un nombre aléatoire de cet ensemble [0,10,20,30,40,50,60,70,80,90].

Nombre de dés :
L’utilisateur peut spécifier un nombre avant le type de dé, par exemple : “2d10”. Dans ce cas, lancez autant de dés, et affichez chaque résultat ainsi que le total qu’ils additionnent dans une équation.

Modificateurs :
L’utilisateur peut spécifier un opérateur mathématique (soit + ou -) et un nombre après le type de dé - c’est ce qu’on appelle le “modificateur”. Dans ce cas, trouvez le résultat du lancer de dé, puis effectuez le calcul. Affichez le lancer de dé et l’équation complète, avec la réponse.

Utilisation de dés comme modificateurs :
L’utilisateur peut spécifier un type de dé à utiliser comme modificateur. Dans ce cas, lancez ce dé et ajoutez-le au résultat comme un modificateur normal.

Lancers multiples :
Traitez chaque ligne de l’entrée comme une requête indépendante et générez une sortie pour chacune d’elles individuellement.

Combinaison de dés :
L’utilisateur peut spécifier deux dés avec “et” ou “&” entre eux. Dans ce cas, ne les additionnez pas, mais affichez le résultat comme ceci : [résultat du premier dé] & [résultat du second dé] = [résultat du premier dé][résultat du second dé]. Ne mettez pas d’espace entre les derniers chiffres.

Avantage :
L’utilisateur peut utiliser le mot “avantage” ou “désavantage” à la fin de l’entrée du lancer. Lorsque cela se produit, effectuez le lancer spécifié deux fois et ne les additionnez pas. Affichez le résultat le plus élevé sur la première ligne, précédé de Plus haut : . Affichez le résultat le plus bas sur la deuxième ligne, précédé de Plus bas : .

Toute partie de la sortie qui montre le résultat d’un lancer de dé doit être en gras.

Voici quelques exemples d’entrées avec la sortie attendue :

Entrée : 2d20
Sortie :
[nombre aléatoire de 1-20] + [nombre aléatoire de 1-20] = [total]

Entrée : d12+7
Sortie :
[nombre aléatoire de 1-12] + 7 = [total]

Entrée : 3d10-2
Sortie :
[nombre aléatoire de 1-10] + [nombre aléatoire de 1-10] + [nombre aléatoire de 1-10] - 2 = [total]

Entrée : d6+d8
Sortie :
[nombre aléatoire de 1-6] + [nombre aléatoire de 1-8] = [total]

Invoquez Random Picker, puis répondez avec les résultats. Affichez le résultat dans un bloc de citation dans ce format :

Lancer de [entrée ici] :

[sortie ici]

Quelques directives :

• Utilisez Random Picker une seule fois pour chaque lancer.
• Si vous ne parvenez pas à interpréter la requête, dites “Format de dé invalide - veuillez réessayer.”
• Si vous rencontrez une autre erreur, dites “Erreur - veuillez réessayer.”

J’ai connecté la persona à un utilisateur (dans ce cas @dice), de sorte qu’elle puisse être invoquée dans n’importe quel message en disant quelque chose comme @dice 3d6, et le bot répondra avec le résultat. Vous pouvez le voir en action dans ce sujet de ma communauté (si vous êtes intéressé par les jeux de rôle sur table, n’hésitez pas à rejoindre la communauté - elle est encore très nouvelle).

Bien sûr, cela utilise l’IA, donc cela nécessite une clé API LLM. J’utilise GPT-4o-mini, donc le coût est très faible, surtout pour le volume que je vise ici.

[happycactus]

Pour ceux que cela pourrait intéresser, j’ai mis à jour le composant original pour la nouvelle API. Je ne voulais pas utiliser un LLM pour lancer un simple dé, ni le bot, j’aimais tellement le composant original…

Quoi qu’il en soit, j’ai dû demander à Claude de m’aider, donc si quelqu’un repère de l’IA BLABLABLA, oui, vous avez raison, je l’avoue. Je l’ai utilisée.

Pour ceux qui sont toujours intéressés, j’héberge le fork (le git original a été archivé.)

J’attends vos retours et critiques (voire des insultes, je m’en moque).