Simulador de dados D&D

Uma cadeia de notação malformada falha com invalid_input em vez de inventar uma rolagem.

O que uma rolagem em notação D&D devolve de fato

Este endpoint tokeniza a cadeia de notação, inicializa um gerador mulberry32 com a semente inteira não negativa que você envia e, para cada dado, toma uma palavra sem sinal de trinta e dois bits que se projeta no intervalo inteiro fechado de 1 a S inclusive. A mesma notação e a mesma semente produzem sempre o mesmo JSON porque o caminho nunca consulta o relógio de parede nem a fonte aleatória do anfitrião.

Contrato de entrada, forma da resposta e erros

Zero é uma semente válida e não é tratado como ausente. Exemplo: a notação 2d6+3 com uma semente publicada produz sempre as mesmas duas faces e o mesmo total, porque o gerador e o mapa de resto são fixos. A validação falha não consome saldo. Expressões com mais de duzentos caracteres, mais de cem dados ou um dado com mais de mil faces são recusadas para que uma cadeia hostil não esgote um isolate. Envie por POST um corpo JSON com dois campos. notation é a expressão de dados obrigatória; os aliases expression, dice, formula, expr, input e text são aceitos quando os clientes reutilizam nomes de formulário antigos. Espaços em torno de mais e menos são permitidos. seed é um inteiro não negativo obrigatório; os aliases rng_seed e value são aceitos. A semente pode chegar como número JSON ou como cadeia numérica de dígitos; cadeias vazias, booleanos, objetos, frações, negativos e valores fora do intervalo inteiro seguro falham com invalid_input nomeando o campo. Essas falhas não são cobradas. Em caso de sucesso o corpo repete notation e seed, devolve normalized como a forma canônica sem espaços e com contagens implícitas escritas como um, devolve total como o resultado inteiro, devolve dice como o array de faces individuais na ordem da expressão, devolve dice_sum como a soma com sinal dessas faces, devolve modifier como a constante líquida, e documenta dice_count, min_total e max_total para que um renderer rotule o valor primário sem constantes extras. Combine a resposta com sua própria ficha de personagem se precisar de vantagem, desvantagem ou manter os mais altos; este endpoint só rola NdS padrão mais constantes. Documente as sementes ao lado do registro da sessão, fixe goldens para as sementes que publicar e trate invalid_input como um sinal de qualidade de dados em vez de repetir uma cadeia malformada. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída.

Onde um simulador de dados D&D agrega valor

Geradores de preparação de exames e salas de probabilidade precisam de um oráculo determinístico que marque uma expressão quebrada como invalid_input em vez de devolver em silêncio um total vazio que um corretor defeituoso poderia tratar como sucesso. Mantenha uma cadeia de notação e uma semente por chamada, fixe o total inteiro e a lista de faces nos testes, e você obterá rolagens D&D reproduzíveis para lições, plugins de LMS e workers de borda sem montar um serviço aleatório próprio.