Lancer les dés

DiceRolls est le service que l'application appelle. Une expression est un Pool ou une chaîne, lue dans la notation de la locale donnée, ou dans la notation canonique si elle est nulle. readRolisteam() lit une commande du DiceParser de Rolisteam, et DiceMacros une entrée qui nomme des macros.

$dice->parse('2W6', 'de');                      // a Pool
$dice->readRolisteam('5D10K3');                 // a Pool, from Rolisteam's DiceParser
$dice->write($pool, 'de');                      // "2W6"
$dice->translate($pool, 'foundry')->text();     // "/r 2d6"
$dice->roll('4d6kh3')->totals();                // [13], for instance

Les lancers simples viennent du moteur sûr de PHP. Chaque lancer prend l'arrondi de ses divisions, vers le bas par défaut. Un jeu qui arrondit vers le haut pour un camp et vers le bas pour l'autre passe le mode de celui qui lance :

$dice->roll('1d6/3', null, RoundingMode::PositiveInfinity)->totals();             // [2], for instance
$dice->translate($pool, 'roll20', RoundingMode::PositiveInfinity)->notices;       // the divisions a table rounds down

Lancers rejouables

$recorded = $dice->rollReplayable('4d6kh3', $member);   // kept in the journal
$replay = $dice->replay($recorded->id());
$replay->result;      // the roll, die for die
$replay->matches();   // whether it gave what the journal holds

rollReplayable() tire un identifiant et un germe, lance avec l'arrondi donné et enregistre un RecordedRoll daté par l'horloge, arrondi compris ; le propriétaire, une ResourceReference, est facultatif. replay() le relance à partir de son expression, de son germe et de son arrondi, et lève UnknownRoll pour un identifiant que le journal ne contient pas. rollsOf($member, $limit) liste les derniers lancers d'un membre, le plus récent d'abord.

Lancers vérifiables

$seed = $dice->newSeed();
$commitment = $seed->commitment()->hex;          // publish it, keep the seed secret
$roll = $dice->rollVerifiable('1d20', $seed, $clientSeed, $nonce);
// … once the rolls of this seed are done, publish $roll->toArray(), which reveals the seed
$dice->verify($commitment, $seed, $clientSeed, $nonce, '1d20', $claimed);

Un lancer vérifiable fait avec un autre arrondi se vérifie avec le même, que toArray() publie : passez-le à rollVerifiable() et à verify(). Chaque construction de la notation (instructions, branches, listes de textes, phrases) est rejouée et vérifiée de la même façon.

L'endroit où le germe est gardé entre l'engagement et la révélation est le choix de l'application : une session, une ligne d'une table.

Effacer les lancers d'un membre

eraseOwner($member) efface du journal chaque lancer d'un membre et retourne leur nombre ; appelez-la quand la personne est effacée.