Lanceur de dés D&D

Cette capacité accepte une chaîne de notation de dés et une graine entière non négative, analyse chaque terme NdS et chaque constante signée, tire une face déterministe par dé à partir de cette graine et renvoie le total obtenu avec chaque face dans l'ordre de l'expression. Une chaîne de notation mal formée échoue avec invalid_input au lieu d'inventer un jet.

Ce qu'un jet en notation D&D renvoie réellement

Lorsque la chaîne de notation est mal formée, la tâche échoue au lieu d'inventer des faces, car une expression brisée n'est pas un jet D&D que quiconque puisse noter. La même notation et la même graine produisent toujours le même JSON, car le chemin ne consulte jamais l'horloge murale ni la source aléatoire de l'hôte.

Contrat d'entrée, forme de la réponse et erreurs

Zéro est une graine valide et n'est pas traité comme manquant. Exemple : la notation 2d6+3 avec une graine publiée produit toujours les deux mêmes faces et le même total, car le générateur et la carte du reste sont fixes. Associez la réponse à votre propre feuille de personnage si vous avez besoin d'avantage, de désavantage ou de conserver les plus hauts ; ce point d'accès ne lance que du NdS standard plus des constantes. Une validation échouée ne consomme pas de solde. Les expressions de plus de deux cents caractères, de plus de cent dés, ou un dé de plus de mille faces sont refusées afin qu'une chaîne hostile n'épuise pas un isolate. Envoyez par POST un corps JSON à deux champs. notation est l'expression de dés obligatoire ; les alias expression, dice, formula, expr, input et text sont acceptés lorsque les clients réutilisent d'anciens noms de formulaire. Les espaces autour des plus et des moins sont autorisés. seed est un entier non négatif obligatoire ; les alias rng_seed et value sont acceptés. La graine peut arriver comme nombre JSON ou comme chaîne numérique de chiffres ; les chaînes vides, les booléens, les objets, les fractions, les négatifs et les valeurs hors de l'intervalle entier sûr échouent avec invalid_input en nommant le champ. Ces échecs ne sont pas facturés. En cas de succès, le corps répète notation et seed, renvoie normalized sous la forme canonique sans espaces et avec les comptes implicites écrits comme un, renvoie total comme le résultat entier, renvoie dice comme le tableau des faces individuelles dans l'ordre de l'expression, renvoie dice_sum comme la somme signée de ces faces, renvoie modifier comme la constante nette, et documente dice_count, min_total et max_total afin qu'un moteur de rendu étiquette la valeur principale sans constantes supplémentaires. Documentez les graines à côté du journal de séance, figez des goldens pour les graines que vous livrez, et traitez invalid_input comme un signal de qualité des données plutôt que de réessayer une chaîne mal formée. Comme l'implémentation est du parse pur de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle et sans réseau sortant.

Où un lanceur de dés D&D justifie son existence

Les auteurs d'aventures publient de la notation dans les blocs de statistiques ; cette page évalue ces chaînes au lieu de forcer le lecteur à séparer à la main le compte, les faces et le modificateur. Les générateurs de préparation d'examens et les salles de probabilité ont besoin d'un oracle déterministe qui marque une expression brisée comme invalid_input au lieu de renvoyer en silence un total vide qu'un correcteur défectueux pourrait traiter comme un succès. Conservez une chaîne de notation et une graine par appel, figez le total entier et la liste des faces dans les tests, et vous obtiendrez des jets D&D reproductibles pour les devoirs, les greffons LMS et les travailleurs de bord, sans dresser un service aléatoire à vous.