holonovel

holonovel

ルールブックのためのホロデッキ — ルールを適用し、世界を記憶します。

テーブルトップRPG向けのワールドモデルMCPサーバーです。部屋、もの、出口、パーサーコマンドレイヤー、ナラティブツールを備え、Fate、Ironsworn、Blades in the Darkのメカニクス（Fudgeダイス、モメンタム、ストレスのトラック）を初期状態で利用できます。特定のルールセットは不要です。インストールしたら、任意の数のルールセットパッケージを追加できます。各パッケージはベースと並行して読み込まれ、ベースを変更することはありません。

要件

• Node.js 22+

インストール

npx -y holonovel

ソースをチェックアウトしたディレクトリで、npm installとnpm run startを実行します。

MCP クライアントの設定

"holonovel": {
  "type": "local",
  "command": ["npx", "-y", "holonovel"],
  "enabled": true
}

データ

Novelは、アトミック保存、バッジごとの取り消し／やり直し用スナップショット、追記専用の監査ログを備えた構造化セーブファイルです。デフォルトでは、状態ディレクトリはオペレーティングシステムのユーザーデータ保存先です。Linuxでは~/.local/share/holonovel、macOSでは~/Library/Application Support/holonovel、Windowsでは%LOCALAPPDATA%\holonovelです。変更するにはTTRPG_DATA_DIRを設定してください。互換性のため、サーバーと同じ場所に既存の.holonovel-state/があれば使用されます。

キャンペーンデータとインストール済みパッケージは、サーバーのツリー外にある状態ディレクトリに保存されるため、holonovelを更新しても変更されません。

ツールの構成

ホストは、永続化されるエンティティ型、パーサーコマンドレイヤー、ベースメカニクスの解決機能を網羅する36個のアクション識別子ツールを公開します。廃止されたツールのエイリアスは、デフォルトの一覧には表示されません。各ツールには、MCPの4種類すべての変更クラスヒントと、3つの節から成る説明が付いています（全体の構成とツール定義の作成基準についてはAGENTS.mdを参照してください）。

カテゴリ：

• バッジとワークフロー — バッジの切り替え、ワークフローへの応答、取り消し／やり直し
• キャラクターと登場人物 — プレイヤーキャラクター、NPC、アイデンティティ、信念
• 世界とシーン — ワールドモデル、シーンの枠組み、知覚、因果状態
• ナラティブ — ストーリー日誌、設定資料、メモ、誓い、派閥、カウントダウン
• セッション — 振り返り、健全性、発見、イベントログ、監査
• メカニクス — Fate、Ironsworn、Forged in the Darkの解決機能
• コンテンツ — アドベンチャー、コーデックス、ルールセットパッケージ、統合

設定

動作を切り替える設定は環境変数から読み取られます。すべての切り替えは、デフォルトでは無効です。主な値：

変数	用途
TTRPG_DATA_DIR	状態ディレクトリ（デフォルト：ユーザーごとのデータ保存先）
TTRPG_NOVEL	起動時に有効化するNovel
TTRPG_SEED	決定論的PRNGシード
TTRPG_RULESETS	先行して読み込むルールセットのスラッグ
TTRPG_RULESET_DIRS	ルールセットのインストール先ディレクトリ
TTRPG_NPC_AUTONOMY, TTRPG_NPC_MIND	NPCの自律性に関する動作
TTRPG_WORLD_REACTIVITY	World-in-Motionの反応性（デフォルトで有効）
TTRPG_NARRATION_VALIDATION	ナレーションの根拠検証
TTRPG_GUIDANCE_PROFILE	fullまたはleanのガイダンス

開発

npm run typecheck          # TypeScript type checking
npm run test:all           # verification harnesses

テストはscripts/以下のtsxハーネスです（test/ディレクトリはありません）。

ライセンス

MIT。LICENSE.mdを参照してください。

同梱のメカニクスとRuleset Wisdomは、以下を基に構築されています。

• D&D 5e SRD v5.1 (CC BY 4.0 + OGL 1.0a, Wizards of the Coast)
• Graham Nelson's Inform (Artistic License 2.0, Graham Nelson)
• if-craft-corpus (CC BY 4.0, pvliesdonk)
• dmcp (MIT, Shawn Rushefsky)
• lonelog (CC BY-SA 4.0, zeruhur)
• BitD SRD (CC BY 3.0, John Harper)
• Ironsworn: Starforged SRD (CC BY 4.0, Shawn Tomkin)
• Sly Flourish Lazy GM Resource Document (CC BY 4.0, Mike Shea)
• The Alexandrian (CC BY 4.0, Justin Alexander)
• Dungeon World SRD (CC BY 3.0, Sage LaTorra, Adam Koebel)
• Fate SRD (CC BY 3.0, Evil Hat Productions)
• Ironsworn SRD (CC BY 4.0, Shawn Tomkin)