Lanzador de dados D&D

Una cadena de notación malformada falla con invalid_input en lugar de inventar una tirada.

Qué devuelve de verdad una tirada en notación D&D

Este endpoint tokeniza la cadena de notación, inicializa un generador mulberry32 con la semilla entera no negativa que usted envía y, por cada dado, toma una palabra sin signo de treinta y dos bits que se proyecta sobre el intervalo entero cerrado de 1 a S inclusive. La misma notación y la misma semilla producen siempre el mismo JSON porque la ruta nunca consulta el reloj de pared ni la fuente aleatoria del anfitrión.

Contrato de entrada, forma de la respuesta y errores

El cero es una semilla válida y no se trata como ausente. Esos fallos no se facturan. Ejemplo: la notación 2d6+3 con una semilla publicada produce siempre las mismas dos caras y el mismo total, porque el generador y el mapa de resto son fijos. La validación fallida no consume saldo. Se rechazan expresiones de más de doscientos caracteres, más de cien dados o un dado con más de mil caras, para que una cadena hostil no agote un isolate. Envíe por POST un cuerpo JSON con dos campos. notation es la expresión de dados obligatoria; se aceptan los alias expression, dice, formula, expr, input y text cuando los clientes reutilizan nombres de formulario antiguos. Se permiten espacios alrededor de más y menos. seed es un entero no negativo obligatorio; se aceptan los alias rng_seed y value. La semilla puede llegar como número JSON o como cadena numérica de dígitos; las cadenas vacías, los booleanos, los objetos, las fracciones, los negativos y los valores fuera del intervalo entero seguro fallan con invalid_input nombrando el campo. En caso de éxito el cuerpo repite notation y seed, devuelve normalized como la forma canónica sin espacios y con recuentos implícitos escritos como uno, devuelve total como el resultado entero, devuelve dice como el array de caras individuales en el orden de la expresión, devuelve dice_sum como la suma con signo de esas caras, devuelve modifier como la constante neta, y documenta dice_count, min_total y max_total para que un renderer etiquete el valor primario sin constantes extra. Combine la respuesta con su propia hoja de personaje si necesita ventaja, desventaja o conservar los más altos; este endpoint solo tira NdS estándar más constantes. Documente las semillas junto al registro de sesión, fije goldens para las semillas que publique y trate invalid_input como una señal de calidad de datos en lugar de reintentar una cadena malformada. Como la implementación es parse pura de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo y sin red saliente.

Dónde un lanzador de dados D&D aporta valor

Los generadores de preparación de exámenes y las aulas de probabilidad necesitan un oráculo determinista que marque una expresión rota como invalid_input en lugar de devolver en silencio un total vacío que un calificador defectuoso podría tratar como éxito. Mantenga una cadena de notación y una semilla por llamada, fije el total entero y la lista de caras en las pruebas, y obtendrá tiradas D&D reproducibles para deberes, plugins de LMS y trabajadores de borde sin montar un servicio aleatorio propio.