Familiar について
Familiarは、インポート済みのアドベンチャーを扱い、物語を創作しないFoundry VTT向けAIコパイロットモジュールです。ゲーム管理、D&D 5eの戦闘、メディア生成、セッション文字起こしに対応し、外部AIクライアント用のMCPサーバーを備えています。
主な機能
- 01キャラクター・アイテム・ジャーナル・シーンの管理
- 02D&D 5eの戦闘ルールと進行の自動処理
- 03マップ・画像・音楽・NPC音声の生成
- 04セッションの文字起こしと要約作成
- 05MCP経由で外部AIクライアントに接続
活用シーン
- 01D&D 5eの戦闘処理と状態の追跡
- 02Foundryのワールドでシーンを作成・編集
- 03セッションにNPC音声や効果音を追加
- 04外部AIクライアントからゲームデータに接続
MCP 対応
FamiliarにはMCPサーバーが含まれ、外部AIクライアントからFoundry VTTのゲームワールドとツールにアクセスできます。MCP接続にはNode.js 22以降が必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Foundry VTT 向け Familiar AI コパイロット
Familiar は、Foundry VTT 向けの AI 搭載コパイロットモジュールです。26 のドメインにわたる 230 個のツールを提供し、AI アシスタントからゲームワールド、キャラクター、戦闘、シーン、ジャーナル、音声などに直接アクセスできます。インポート済みの公開アドベンチャーを実行するもので、ストーリーを創作するものではありません。
クイックインストール
Foundry VTT で、アドオンモジュール > モジュールをインストール に移動し、マニフェスト URL を貼り付けます。
https://github.com/Ryanjansen92/familiar-releases/releases/latest/download/module.json
インストール をクリックし、ゲームワールドの モジュールを管理 からモジュールを有効にします。
ベータチャンネル(任意):報告された修正を確認するために、次のリリースを先行して利用できます。同じダイアログにこのマニフェスト URL を入力すると、Foundry の更新ボタンによって、安定版が追いつくまで最新のベータ版を利用できます。まずワールドをバックアップしてください。MCP クライアントでは npx -y familiar-vtt@beta を実行します。
https://github.com/Ryanjansen92/familiar-releases/releases/download/beta/module.json
機能
戦闘の自動処理(D&D 5e)
- 攻撃、ダメージ、セーヴィング・スロー、呪文の効果を、ルールに完全準拠して処理します
- クラス特徴は記載どおりに発動します:激怒、アクション・サージ、追加攻撃の回数、10種類すべてのメタマジック・オプション、妖術、SRDのサブクラス特徴
- イニシアチブ、状態、伝説的アクション、死亡セーヴ、精神集中を管理します
- 移動速度の適用や機会攻撃の検出を含め、移動を検証します
- ルールの適用はワールド設定で、独自のルールを採用する卓ではオフにできます
NPCのAIボイスとサウンド
- 以下に記載されたあらゆる音声プロバイダー(独自のOpenAI互換TTSサーバーを含む)を通じて、どのNPCにもテキスト読み上げを設定できます
- キャラクターに固定のボイスを割り当てるか、Familiarにプロバイダーのカタログから選ばせて、プレイ中にAIがキャラクターになりきって話せるようにします
- 効果音はまず独自のプレイリストから選び、一致するものがなければ生成します。シーンの変化に応じて、アンビエンスのムードもプレイリスト間で切り替わります
- デフォルトでは、ボイスとサウンドは卓全体で再生され、発話はすべて話者名とともにチャットにも表示されます。Familiarの設定にある「Voice」タブで、どちらもブロードキャストをオフにできます。音楽と保存済みのトラックは、Foundryのプレイリストを通じて引き続き全員に再生されます
- 音楽をリクエストすると、FamiliarがElevenLabs、fal.ai、NanoGPT、OpenRouterのキーを使ってインストゥルメンタル曲を作成し、プレイリストに保存します。再生は開始しません
バトルマップの生成
- AI画像プロバイダーを使って、バトルマップやシーンの背景を生成します
- マップはシーンのグリッドに合わせたアスペクト比で生成されるため、マス目にぴったり収まります
- 生成したマップはワンクリックでシーンに変換でき、その後AIに壁と照明を設定させられます
- シーン、トークン、照明、壁、タイルについて普通の言葉で指示すると、Familiarがワールド内に作成し、変更します
ライブセッションの文字起こし
- ゲームセッションの音声をリアルタイムでテキストに文字起こしします
- セッションの要約を自動作成し、ジャーナルノートを作成します
画像生成
- キャラクターの肖像、トークンアート、アイコン、配布資料を必要に応じて生成し、アクターやアイテムに直接適用します
- Familiarはfal.aiのキーを使って静止画を短いループ動画に変換できます。動くマップとしてシーンに重ねたり、プレイヤーに見せたりできます
- Familiarが作成した画像、動画、音楽トラックはすべて、ゲーム内から検索できるウィンドウ「Familiar Studio」に自動で保存されます。閲覧、絞り込み、並べ替えができ、アートをキャンバスにドラッグしたり、グリッドの下にプロンプトを入力して新しいものを作成したりできます
- 作成済みの画像を画像そのものから編集するか、変更したい部分を指定できます(OpenAI、fal.ai、OpenRouter)
- プロバイダー:OpenAI(GPT Image)、fal.ai、Leonardo AI、OpenRouter、NanoGPT、カスタム(OpenAI互換)
ワールド管理
- アクター、アイテム、ジャーナル、プレイリスト、マクロなどを作成、読み取り、更新、検索します
- サイドバーまたはコンペンディウムパック内で、複数のドキュメントを一度にフォルダーへ保存します
- キャラクターシート間でアイテムを移動できます。D&D 5eではコインも移動でき、Familiarが両替し、先に価格を確認することもできます
- キャンバスの操作:描画、天候、照明、フォグ・オブ・ウォー
柔軟なAIアクセス
- Foundry VTT内にストリーミング応答対応のチャットウィンドウを搭載
- 外部AIクライアント(Claude Desktop、Claude Code、Codex CLI、ChatGPTデスクトップアプリのCodexタブ、Antigravity CLIおよびEditor、Grok Build CLI、Muse Code)から利用できるMCP サーバー
- テーブルチャット:デフォルトで有効です。プレイヤーは通常のFoundryチャットから、設定された承認モードに従ってFamiliarや任意のNPCと会話できます。ワールドの読み込み時には、Familiarが簡単な使い方を投稿します。プレイヤーを1人「Solo Player」に指定すると、FamiliarがそのプレイヤーのGMとして卓を進行します
- クラウドAPIから、自分のマシンで実行するローカルモデルまで、31のAIプロバイダーに対応しています
対応プロバイダー
チャット:OpenRouter、Anthropic、OpenAI、Google、Groq、Mistral、Together AI、DeepSeek、xAI、Cohere、Perplexity、Fireworks AI、Cerebras、SambaNova、NanoGPT、ローカル/カスタムサーバー。ローカル/カスタムオプションでは、OpenAI 互換サーバーを任意に指定できます。
音声:ElevenLabs、Cartesia、OpenAI TTS、OpenRouter TTS、NanoGPT TTS、カスタム TTS
画像:OpenAI(GPT Image)、fal.ai、Leonardo AI、OpenRouter、NanoGPT、カスタム(OpenAI 互換)
文字起こし:Gladia、Deepgram、AssemblyAI
必要条件
- Foundry VTT v13 以降(v14 で動作確認済み)
- 対応する AI プロバイダーの API キー(少なくとも 1 つ)
- 最新のブラウザー(Chrome、Firefox、Edge)
- MCP パスのみ、Node.js 22 以降が必要です。組み込みチャットは Foundry 以外に何も必要ありません
- Familiar ライセンス:月額 6 ドル、年額 48 ドル、または一括 99 ドル。サブスクリプションは最初の 2 週間無料で、すべての機能を利用できます。https://familiarvtt.com で登録してください
- ゲームシステム:戦闘ルールエンジンには D&D 5e(2024)が必要です。それ以外の Foundry システムでも、ストーリー、NPC、シーン、オーディオ、音楽、音声、画像、動画クリップ、文字起こし、キャンペーンメモリー、独自システムのキャラクターシートを使ったキャラクターの読み取り機能を利用できます。Pathfinder 2e、Dragonbane、Troika で実機動作確認済みです。
ライセンス
このモジュールは、PolyForm Shield License 1.0.0 の下でライセンスされています。
Familiar は独立した製品です。Wizards of the Coast LLC との提携、同社による承認、後援、認可はありません。Dungeons & Dragons および D&D は、Wizards of the Coast LLC の商標です。
この作品には、Wizards of the Coast LLC による System Reference Document 5.2.1(「SRD 5.2.1」)の素材が含まれています。https://www.dndbeyond.com/srd で入手できます。SRD 5.2.1 は、https://creativecommons.org/licenses/by/4.0/legalcode で入手できる Creative Commons Attribution 4.0 International License の下でライセンスされています。
サポート
- ウェブサイトとライセンス:https://familiarvtt.com
- バグ報告と機能リクエスト:最も迅速な連絡先はDiscordです。チャットの各エラーには診断情報をコピーボタンがあり、編集済みのレポートをクリップボードにコピーできます。GitHub Issuesもご利用いただけます
- Foundry VTT の互換性に関する問題:Foundry のバージョン、ブラウザー、コンソールエラーがあれば記載してください
これは、npm で familiar-vtt として公開されている、Foundry VTT 用の商用 AI コパイロット Familiar のリリースリポジトリです。ここにはソースコードは含まれていません。各リリースには、インストール可能なコンパイル済みモジュールが含まれています。無関係な rayners/fvtt-foundry-familiar モジュールや、テーブルトークゲームのクリーチャー「familiar」とは関係ありません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。