Caputchin
マーケットプレイスゲーム開発

エンジンキット engine-kit（任意）

このページは任意です。 ここのすべては、適合する run を 生む 1 つの便利な方法です。キットを丸ごと無視して、手で書いた素の run を出荷できます。普通のゲームロジックを書いて、決定論、リプレイのループ、トレースのエンコードをあなたのために扱ってほしいときに、@caputchin/engine-kit に手を伸ばしてください。

キットは リプレイ契約 の面全体を再エクスポートするので、キットのユーザーは単一のインポート先を持ちます。

npm install @caputchin/engine-kit

アイデア：レデューサーを書き、run を得る

キットの核心の一手は、あなたのゲームを 純粋なレデューサー として表現させることです。現在の状態と 1 ティックの入力を取り、次の状態を返す関数です。そのレデューサーに決定論的なプリミティブを足したものから、キットの toRun アダプターは、構成によって契約に適合する run(seed, config, trace) を生みます。

import { defineEngine, toRun, cap } from "@caputchin/engine-kit";

const engine = defineEngine({
  setup(seed) {
    const rng = cap.rng(seed);          // deterministic, seeded RNG
    return { score: 0, targets: spawn(rng), rng };
  },
  tick(state, input) {
    // pure: same (state, input) always yields the same next state
    return applyInput(state, input);
  },
  result(state) {
    return { passed: state.score >= 3, score: state.score, durationMs: state.elapsed };
  },
});

export const run = toRun(engine);       // a conforming RunFn

決定論的なプリミティブ

キットは、クロスランタイムの決定論を最もよく壊す 2 つのものを、どちらもシードされ再現可能にして与えます：

  • cap.rng(seed)（と cap.rngFromState）- シード可能な PRNG。Math.random() の代わりに、すべてのランダムな選択にそれを使います。
  • cap.math - ランタイム間で一致する決定論的な超越関数（sin、cos など）。一致しないかもしれないプラットフォームの Math のものの代わりです。

任意のシム

  • applyShim() - 非決定論的なグローバル（壁時計、Math.random）を中和するので、うっかりの呼び出しが、リプレイで黙って分岐するのではなく、開発で大声で失敗します。
  • applyDomShim() - フレームワークのパスのための最小限のヘッドレス DOM。小さな DOM の面に触れるレデューサーも、DOM のないアイソレートでなおリプレイできます。

公開の前にローカルで走らせる

キットの replay ハーネスは、サーバーがするのと同じやり方でエンジンを通してトレースを走らせ、selfCheck はケースの一群を走らせ、公開する前に どの非決定論も報告します：

import { selfCheck } from "@caputchin/engine-kit";

const report = selfCheck(engine, { cases: myCases });
if (!report.ok) console.error(report.violations);

クリーンなローカルの selfCheck は、マーケットプレイスの公開のセルフチェックが通るという最良の予測子です（それは同じ決定論の基準です）。キットは、これを package.json のスクリプトや CI から走らせる CLI も出荷します。

トレースのエンコード

encodeTrace / decodeTrace は、コンパクトでバージョン管理されたトレースの形式を与えるので、ライブのゲームが発する入力のストリームが、リプレイで run がデコードするものとちょうど同じです。両側でそれらを使うと、2 つがロックステップで保たれます。

キットを飛ばすとき

すでに決定論的なロジック（固定小数点のシミュレーション、仕様の浮動小数点向けにコンパイルされた WASM モジュール）があるとき、またはゲームが、run を手で書くのが些末なほど単純なときに、それを飛ばしてください。プラットフォームは、キットがあなたの run を生んだかを決して知らず、気にしません。契約を読み込んでリプレイするだけです。

あわせて読む

リプレイ契約

前へ

マーケットプレイスに公開する

次へ

このページの内容

アイデア：レデューサーを書き、run を得る決定論的なプリミティブ任意のシム公開の前にローカルで走らせるトレースのエンコードキットを飛ばすときあわせて読む