Comece com Dice Core

Requisitos e instalação

O pacote publica ESM, CommonJS e tipos TypeScript. Requer Node.js 22+ ou navegador ES2022 com globalThis.crypto.getRandomValues. O pacote não tem dependências de runtime. O artefato npm 3.7.1 contém licença MIT; consulte a comparação de licenças para entender a divergência com o checkout atual do repositório.

npm install @erpg/dicecore

Faça sua primeira rolagem

Use o entrypoint /core para carregar somente o motor genérico. Sem seed, o Core usa entropia criptográfica; com seed, a mesma fórmula e a mesma versão reproduzem o resultado.

import { rollRpgDice } from '@erpg/dicecore/core'

const result = rollRpgDice('2d6+3', { seed: 'sessao-42' })
console.log(result.total)
console.log(result.dice)
console.log(result.output)

O resultado contém dice, groups, events, rolls, pool, replay e stats. Em 4d6kh3, o dado descartado continua em dice; consulte included e contribution em vez de somar value manualmente.

Reproduza uma execução

replay guarda o algoritmo, a versão e um material de seed que não revela o texto original. Ele é vinculado ao plano da fórmula.

const first = rollRpgDice('4d6kh3')
const again = rollRpgDice(first.input, { replay: first.replay })

Próximos passos

• Use a referência de notação para descobrir cada tipo de rolagem.
• Teste exemplos no playground.
• Consulte a API para inspeção, limites e resultados.
• Use a prévia física do Dice View V3 ou a integração estável V2 para apresentar a rolagem em 3D.

Teste os exemplos

Testar 2d6+3 · Testar 4d6kh3

Veja em produtos de RPG

O Mini Kraken BOT leva comandos de dados e fichas ao Discord, com uma mesa como Activity no canal de voz. O ERPG.APP mostra fichas e ferramentas com dados 3D sobre a interface. São dois contextos em que uma rolagem estruturada chega aos jogadores.