更新と移行

メジャーバージョン1の中で更新する

現在のエンジンはバージョン1です。設定、共有した記録、ストレージの読み込みは、説明されている互換性を保ちます。このドキュメントの変更は、ガイドとリファレンスの構成、検証した例の追加です。乱数の手順や公開関数の引数は変わりません。変更履歴に各リリースの内容があります。

1.4の振り直しの変更

r<3は条件を満たさなくなるまで、ro<3は1回だけ振り直します。古い設定のrerollは従来の意味のままです。vがない古いリンクも以前の読み方を保ち、新しいリンクはバージョン2を指定します。古い文字列の移行ではroに変更するか、legacyReroll: trueを使います。

import { parseNotation, formatNotation } from "@johnmorrisdotca/korokoro";
const legacy = parseNotation("2d8r<3", { legacyReroll: true });
if (legacy) console.log(formatNotation(legacy));

2d8ro<3

移行の資料に、トレイでダイスを追加する動作など、以前の変更も残っています。

別のダイスライブラリから移行する

表記をテキストとして受け取り、設定として使う前に確認します。RollSpecはKorokoro独自の形です。別のライブラリの構文木をそのまま渡せません。振り直しや追加の上限、残す出目、文字、独自の面、式の丸め方を確認します。表記の比較に違いがあります。