Familiar

將 Claude、ChatGPT、Gemini、Grok 或 Muse Code 連接到 Foundry VTT。

透過 MCP 使用你的 AI 帳戶、在內建聊天中使用自己的 API 金鑰，或使用自己電腦上的模型。無論選哪種方式，都能使用相同的 230 項工具。

內建聊天

貼上 API 金鑰，就能開始和你的遊戲對話。

不需要伺服器、終端機或設定檔。即時轉錄、語音聽寫、NPC 回合自動駕駛（D&D 5e）、斜線指令和拖放附件僅在此處可用。/rolled 指令也能在 Foundry 自己的聊天框中使用。思考控制項可讓你設定模型推理的強度：困難戰鬥時調高，快速查詢時調低。

聊天

• OpenRouter
• Anthropic
• OpenAI
• Google (Gemini)
• Groq
• Mistral
• Together AI
• DeepSeek
• xAI
• Cohere
• Perplexity
• Fireworks AI
• Cerebras
• SambaNova
• NanoGPT
• Local / custom server

OpenRouter 只需一把金鑰，就能解鎖 300 多種模型。Local / custom server 可將內建聊天連到你執行的任何 OpenAI 相容伺服器，設定位置在專屬的 Local / Custom 設定分頁。

語音

• ElevenLabs
• Cartesia
• OpenAI TTS
• OpenRouter TTS
• NanoGPT TTS
• Custom TTS

圖像

• OpenAI (GPT Image)
• fal.ai
• Leonardo AI
• OpenRouter
• NanoGPT
• Custom (OpenAI-compatible)

轉錄

• Gladia
• Deepgram
• AssemblyAI

使用你的訂閱方案

已經在付費使用 Claude、SuperGrok 或 Muse Code？有任何 ChatGPT 方案（包括 Free），或 Google 帳戶？讓它派上用場。

透過 Model Context Protocol 連線，使用你現有的方案，就能從自己的用戶端操作同一套工具。你下達指令時，怪物就會採取行動；每次攻擊和法術都會依照 5e 規則檢查。模組內建 MCP Setup Wizard。選擇用戶端的卡片，它就會提供確切內容：可貼上的設定區塊，或包含密鑰的單一指令。每張卡片也附有 Copy help prompt，適用於你已在使用的任何 AI 聊天，包括免費網頁版：它會說明步驟，由你輸入。最適合長串、多步驟的操作。模型和推理強度是在你自己的用戶端設定，而不是在這裡。

MCP 用戶端

• Claude Desktop

• Claude Code

• Codex CLI

• ChatGPT desktop app (Codex tab)

• Antigravity CLI

• Antigravity Editor

• Grok Build CLI

• Muse Code

閱讀 MCP 設定指南

在本機執行

使用自己的電腦，不必按 token 付費。

使用相同的內建聊天，並將它連到你執行的伺服器。選擇預設項目、確認自動填入的 URL，然後開啟 Use for chat。你的託管服務供應商設定會保留，方便切換回去。

執行工具

• Ollama
• LM Studio
• llama.cpp
• LiteLLM
• Any OpenAI-compatible server

預設清單也包含 Venice，如果你想租用 GPU。這種方式會連出你的網路，費用則計入你的 Venice 帳戶。

閱讀本機指南

你的金鑰，你的費用。

Foundry 上多數付費 AI 模組會透過自家伺服器轉送請求，並按訊息數限制用量。Familiar 絕不代轉或加價。你的 API 金鑰會直接從瀏覽器傳送到服務供應商；透過 MCP，AI 服務則由你的訂閱方案涵蓋。無論採用哪種方式，語音、圖像、音樂和影片都會使用各自服務供應商的金鑰計費。

看它如何進行戰鬥、為 NPC 配音、生成戰鬥地圖。

以下每個區段都展示 Familiar 如何替地下城主分擔一項工作，並附上來自實際遊戲世界的影片或截圖。直接跳到你想看的內容。

戰鬥與自動駕駛

在 D&D 5e (2024) 中，AI 操控怪物，規則引擎則判定哪些行動有效。在實際戰鬥中，它不能捏造骰子結果，也不能把傷害直接寫進角色卡。它不能憑空移除狀態，也不能讓生物移動超過其速度。只要在聊天的戰鬥列中開啟 Auto-Pilot，所有沒有玩家操控的生物都會自行採取回合行動，怪物和友善 NPC 都包括在內。你也可以使用安全上限和逐回合確認。

• 每個行動都會先經過規則檢查，才會生效
• 行動遭拒時會明確說明，AI 也會調整做法
• 由角色卡本身擲骰，包含熟練加值和魔法加值
• 多重攻擊、傳奇動作、怪物反應；玩家的反應仍由玩家掌控
• NPC 會接連採取回合行動；可從戰鬥列、回合卡或 Ctrl+Shift+X 關閉
• 呼叫出錯時可復原上一步行動

開始戰鬥、播放音樂，並讓所有人都行動。分別替隊伍和強盜擲骰，然後進行一個回合。

規則引擎如何執行規則

語音、音樂與音效

Familiar 會在文字出現時，立即朗讀它剛寫好的場景：旁白使用你的旁白聲線，每個 NPC 的台詞則使用各自的聲線。這項功能開箱即用，但只有在 Voice 分頁中設定金鑰後才會播放或計費。音樂會淡入淡出，切換到你現有播放清單中的合適氛圍；你也可以要求使用自己的金鑰創作新曲。

• 要求用角色的聲音說出任何台詞，或為整個場景的每位說話者指定聲音
• 為尚未指定聲音的 NPC 配音，並告訴你使用了哪個聲音；聊天中的說話者標籤會標示發言者
• ElevenLabs、Cartesia、OpenAI TTS、OpenRouter、NanoGPT 或你自己的端點；每個角色都能指定固定聲音
• 氛圍會自動隨地點切換；設為 On request 後則會等你指示
• 創作的曲目會放在 Familiar Music 播放清單中，等你播放
• 生成的音效會出現在聊天中，並附有可將它保存為曲目的 Save 按鈕

調暗燈光，播放雨聲和雷聲，再讓旅店老闆用他的聲音低聲警告前方的道路。

語音與音效

場景、美術與工作室

透過指令建立場景，並為場景加入美術素材。Familiar 負責放置，你負責指揮。

• 建立場景，並從任何圖鑑生成 token
• 繪製牆壁、門和觸發區域；設定光照、黑暗和天氣
• 根據文字提示生成戰鬥地圖背景，或直接生成肖像和物品美術
• 使用你的 fal.ai 金鑰，將靜態圖像製作成循環片段，並疊加在場景上作為動態地圖
• 將 Make images 設為 Automatic，故事進展到新地點或角色時，就會自動生成圖像
• Familiar Studio：在同一個視窗中查看所有圖像、片段和曲目，並顯示服務供應商提供的費用資訊；Missing art 可在一次操作中補齊所有佔位素材

生成一張迷霧籠罩的墓園戰鬥地圖，給我三個選項，並將第二個設為背景。

深入了解 Familiar Studio

聊天視窗

GM 每場遊戲都會使用的視窗。每個對話串都是 Foundry 日誌，並附有完整的稽核記錄。戰役資訊會存放在記憶庫中，你可以瀏覽、釘選和編輯。

• 它回答時仍可繼續輸入；下一則訊息會排隊等候
• 編輯或刪除訊息、重新生成回覆；/undo 可復原 Familiar 最近一次的編輯
• 簡短、一般或詳細回覆；五種主題，預設為 Dark，也可選 Auto 跟隨 Foundry
• 新聊天會接續故事；對話串太長時，較早的回合會整理成摘要
• 可在日誌、角色、場景、物品和轉錄內容中進行全文搜尋
• 按住 Ctrl+Shift+D 即可用說話取代輸入；三種服務供應商支援即時轉錄，並將錄音存入 Foundry 日誌

開啟「Stormpoint Castle」對話串，接續上週的進度。

戰役記憶的運作方式

角色、物品與物品欄

透過指令建立角色陣容，並在不開啟角色卡的情況下管理他們攜帶的物品。檢視、更新和複製世界中已有的任何角色。

• 描述一名英雄，取得完整的 D&D 5e 角色，並透過升級視窗完成升級
• 貼上屬性區塊，建立可用的 NPC
• 贈送、收納和交易物品；在 D&D 5e 中會自動找零，並可依你的要求先查價格
• 套用並切換啟用效果、增益和減益
• 從任何圖鑑包匯入；設定玩家擁有權
• 擲骰查詢表格，生成隨機遭遇和戰利品

在圖鑑中找一隻 CR 3 狼人，把它放進場景當頭目，並賦予它對非銀製武器的抗性。

角色的建立方式

單人、雙人或完整隊伍遊玩。

無論有多少人到場，你都能開始遊戲。桌邊的人類玩家越少，Familiar 負責運行的世界就越多。骰子和每個 NPC 都由它處理；在 D&D 5e 中，怪物和規則也一併交給它。你可以坐下來，玩一場平常由你主持的遊戲。

• 單人

  只有你 你扮演自己的角色。Familiar 負責周遭的一切：每個 NPC 都有自己的聲音、每隻怪物的回合，以及場景；並執行 2024 D&D 5e 規則。你也可以使用玩家帳號登入，讓 Familiar 擔任 GM。戰役記憶會將世界延續到下一場遊戲。

• 雙人

  你和另一位玩家 你們都不必擔任 DM。Familiar 會為你們兩人運行 D&D 5e (2024) 世界：角色陣容、遭遇和裁定都由它處理。你們只需扮演玩家，故事仍會繼續。

• 小型團

  你和幾位玩家 配角、燈光和音樂都由 Familiar 負責；在 D&D 5e (2024) 中，怪物回合和規則裁定也交給它。沒有人需要離開遊戲來維持進度。你的玩家也能參與其中。你在 Familiar 視窗中看到的故事會出現在他們的 Foundry 聊天中。設定語音金鑰後，NPC 台詞就會從他們的喇叭播放。他們任何人都能在聊天中詢問 Familiar，或在 Any NPC 開啟時直接點名詢問 NPC。

• 完整隊伍

  你為四人或更多人擔任 DM GM 不再需要承擔繁重的戰術工作。你負責說故事；在 D&D 5e (2024) 中，Familiar 會處理先攻、怪物回合和帳務。你負責主持場景，不必埋首試算表。今晚有玩家無法出席？把他的角色交給 Familiar；在 D&D 5e (2024) 中，它會代為採取回合行動。結束時，請它整理事件摘要並存成日誌，讓該玩家閱讀。

Familiar 會在你身邊處理 DM 的工作，但絕不捏造故事。無論誰坐在桌邊，你帶來的戰役都是故事主軸；在 D&D 5e (2024) 中，骰子和計算永遠正確。絕不會出現「你擲出了 47」這種結果。

你的遊戲系統

Familiar 不只支援 D&D，也能用於 Pathfinder、Call of Cthulhu 和 Shadowdark 遊戲。選擇你的系統，了解在該系統中如何進行戰役。

• Pathfinder 2e
• LANCER
• Pathfinder 1e
• Warhammer Fantasy 4e
• Call of Cthulhu 7e
• Cyberpunk RED
• Daggerheart
• Savage Worlds
• Shadowdark
• Dragonbane

為想說故事、不想埋首試算表的遊戲主持人打造的副駕駛。

我是 Ryan，有兩個年幼的孩子，和最愛的人結了婚，空閒時間也就可想而知。我和妻子一起玩 D&D，只有我們兩個人；但單人 DM 的工作量很大：說書人、每個 NPC、規則引擎和音效師，全都得一手包辦。扮演神祕陌生人講到一半，我還得跳出角色擲先攻，或翻找那首酒館配樂，氣氛就這樣消失了。

我想要一個能接手機械性工作的工具，讓我能留在故事裡。我可以對副駕駛說：「替哥布林擲先攻、調暗火把，然後播放戰鬥音樂」，它就會照做，而我可以繼續說故事。於是我一項工具接一項工具地打造它，在開放給大家使用之前，先在自己的桌上連續跑了好幾場遊戲。我不想再推出另一個 AI，讓它只因為忘了上週發生的事，就把你的戰役搞得一團糟。

我用自己也願意接受的方式定價：只有一種方案，從第一天起就能使用所有工具。我沒有其他東西要賣給你。

Ryan，Familiar 開發者

聽聽他們怎麼說。

以下是使用者在自己的桌上運行 Familiar 時分享的話，引用自 Discord。

• 「生活變得如此忙碌，我原以為自己再也無法玩 D&D 了。Familiar 讓我重新成為玩家。它忠實且身歷其境地主持遊戲（還有語音！）。」 Armchair EvokerFamiliar 擔任 DM，開啟語音

• 「Familiar 讓我能擔任『助理 DM』，而不是完整的 DM。我可以引導並支援遊戲進行，同時保留自己的角色。我們正在跑《Phandelver and Below》，讓 Familiar 負責旁白、NPC 和場景設定，代表再也不必由某一個人獨自扛起整場遊戲。」 D3AD MANS PAR7Y與一群人遊玩《Phandelver and Below》，使用 ElevenLabs 語音，在 Discord 上測試 beta 版本

• 「一開始就做得非常出色，而且對意見回饋和錯誤修正的回應也非常迅速。我從沒遇過如此令人印象深刻的軟體開發者，願意直接陪我排除問題，更別說你們做得這麼快了。」 aakav在無頭 Linux 伺服器的 Docker 中執行 Foundry，使用 Claude Code

常見問題。

簡短解答，並附上詳細說明所在的指南連結。其他問題，歡迎到 Discord 詢問。

• Familiar 是什麼？

  Familiar 是 Foundry VTT 的 AI 副駕駛；Foundry VTT 是你用來進行 D&D 遊戲的虛擬桌上遊戲。你可以透過 Model Context Protocol 或 API 金鑰連接自己已在使用的 AI，例如 Claude 或 ChatGPT，接著它會負責主持你匯入的已出版 D&D 5e 冒險：規則、骰子、怪物和 NPC 語音。你仍是玩家，掌握故事；Familiar 則負責桌上的一切。

• Foundry VTT 有 AI DM 模組嗎？

  有。Familiar 是 Foundry VTT 的 AI DM 模組：連接你已在使用的 AI，坐下來當玩家，它會負責主持你匯入的已出版 D&D 5e 冒險，包括戰鬥、骰子和 NPC 語音。透過 MCP 使用 Claude、ChatGPT、Gemini、Grok 或 Muse Code，或透過 API 金鑰使用 31 家供應商中的任一家。你可以從 Foundry 套件瀏覽器安裝，或使用資訊清單 URL 安裝；訂閱方案提供 14 天免費試用。 閱讀設定指南

• AI 在戰鬥中真的會遵守 D&D 規則嗎？

  它無法作弊的規則包括：造成傷害、施加狀態、移動超過生物的速度，以及偽造骰子結果；這些都由模型無法控制的程式碼處理，而 Foundry 自己會擲出每個結果。側擊等裁定或敘事上的例外等判斷，仍由你決定；AI 做出的任何覆寫都會記錄在聊天紀錄中。若某項規則尚未建模，Familiar 會標示出來，並交由你裁定。 閱讀戰鬥指南

• 如何將 Claude 或 ChatGPT 連接到 Foundry VTT？

  有兩種方式，兩者都由你自備 AI。透過 Model Context Protocol 使用你已有的 Claude、ChatGPT、Gemini、SuperGrok 或 Muse Code 方案，Familiar 會作為 MCP 伺服器供這些用戶端連線。或者將 API 金鑰貼到內建聊天中，它也能與你在自己電腦上執行的模型通訊。兩種方式使用相同的工具；差別在於模型在哪裡執行，以及由誰收費。 閱讀連線指南 在 Foundry 中使用 Claude：Desktop 或 Code 透過 Codex 在 Foundry 中使用 ChatGPT 透過 Antigravity 在 Foundry 中使用 Gemini 透過 Grok Build 在 Foundry 中使用 Grok 在 Foundry 中使用 Muse Code：一個設定檔

• Familiar 能在 The Forge 或其他代管的 Foundry 上運作嗎？

  可以，兩種方式都行。內建聊天可在任何能執行 Foundry 的地方使用，因為模組會直接從瀏覽器呼叫你的 AI 供應商。MCP 也能正常運作，而且連線不會離開你的桌面：伺服器和瀏覽器位於同一台機器上，因此代管服務商看不到連線。從代管遊戲執行設定精靈，它會將遊戲的 URL 寫入 FAMILIAR_WS_ALLOWED_ORIGINS。無須手動編輯。代管遊戲在 MCP 方面確實有幾項限制，首先是瀏覽器的選擇。 排解 MCP 連線問題

• Familiar 會收集我的資料嗎？

  不會遙測、不會分析，也不會建立你的遊戲桌檔案。Familiar 在你的 Foundry 世界中執行，只有在你傳訊息給所選的 AI 供應商時，你的戰役資料才會離開你的機器。桌上聊天預設為開啟，因此玩家傳送的 @familiar 訊息也會透過你的金鑰送到該供應商，直到你在 Chat 分頁將它關閉為止。只有兩種請求會自行送出：世界載入時更新模型清單，以及每週一次連線至 Polar 的授權檢查。兩者都不會連同你的戰役資料一起送出。將 Local / Custom 分頁指向你自己機器上的模型，連供應商流量也會停止。 閱讀本機模型指南

• Familiar 會附帶 AI 生成的遊戲內容嗎？

  不會。Familiar 完全不附帶遊戲內容：沒有冒險、地圖、圖鑑套件、數值資料或 Token 美術。它是一套將你自己的 AI 連接到 Foundry 世界的軟體。在你的遊戲桌上，該 AI 會根據你的提示即興產生聊天回覆、NPC 語音、音效、音樂、圖片和影片片段；生成的內容會放進你的世界，由你保留、編輯或刪除。Familiar 強制執行的 5e 規則以名稱和數值形式存在程式碼中，絕不包含複製的規則原文。 Familiar 與 Foundry 的 AI 政策

• AI 會破壞我的世界嗎？

  文件更新都會經過清理，因此一般編輯無法觸及所有權、權限或內部 ID。任何具破壞性的操作預設都會先要求你確認，而且 WebSocket 連線會使用共用密鑰進行驗證。如果編輯結果不如預期，/undo 可以復原 Familiar 對角色卡、日誌、Token、場景或播放清單所做的變更，也包括金幣和資料夾的移動；MCP 用戶端也會透過相同紀錄復原。但並非所有變更都能復原。XP、狀態、戰鬥動作以外的傷害或治療、升級、角色卡上的新美術、被移動的物品或 Token，以及任何建立或刪除的內容，都無法復原。無論是否使用 AI，定期備份都是好習慣。

• 它支援 D&D 5e 以外的遊戲系統嗎？

  支援，但有一項限制：負責裁定戰鬥的規則引擎僅支援 D&D 5e (2024)。除此之外，Familiar 會在第一則回覆中說明你的遊戲系統，並讀取你世界中的圖鑑，而不是對你引用 D&D 規則。故事、NPC、場景、音訊和戰役記憶也都會依照你的系統運作。 查看你的系統支援哪些功能

• 哪些 AI 模型效果最好？

  Anthropic、OpenAI 或 Google 目前的任何旗艦模型都擅長使用工具；具體型號等級請參閱「選擇 AI 模型」指南。使用你已付費的任何金鑰或訂閱方案即可。推理能力的餘裕能應付艱難的戰鬥或錯綜複雜的場景。在內建聊天中，Thinking 預設設為 High；除了艱難的戰鬥之外，Medium 已經足夠。透過 MCP 使用時，則在你自己的用戶端中調整這項設定。

• AI 能幫我獨自進行 D&D 嗎？

  可以，這正是它存在的主要原因，也是它的起點：我和妻子進行的一對一 D&D。大多數擁有 Foundry 的人都是 GM，也就是那個永遠沒機會當玩家的人。Familiar 負責規則、怪物和 NPC，並在不同場次之間記住你的戰役，因此你可以在自己的遊戲桌旁坐下來，獨自或一對一遊玩。在 Familiar 的設定中，前往 Chat 分頁，將你的玩家登入名稱設為 Solo Player，並開啟 Listen to the Solo Player。之後，你以該玩家身分輸入的每一行一般文字都會傳給 Familiar，同時保持 GM 視窗開啟。 閱讀單人遊玩指南

• 開始遊玩前，我需要有自己的戰役嗎？

  不需要。購買一個可在 Foundry 使用的冒險（官方 D&D 模組約 $20 到 $30，地圖和光照都已建置完成），放入一兩張戰鬥地圖，啟用 Familiar，就能開始遊玩。Familiar 會讀取冒險的日誌，了解你即將探索的故事，並在遊戲進行時從你的圖鑑中取得怪物和物品。

• AI 能在我這一方扮演角色嗎？

  可以。在 D&D 5e (2024) 中，Familiar 負責 DM 的一方（規則、怪物和所有 NPC），也會在你身旁替盟友行動：友善 NPC 會像怪物一樣自動行動，你也可以交給它一名完整的隊伍角色來扮演。在我自己的每週戰役中，Familiar 已經連續幾個月扮演三名英雄中的兩名。

• 我的玩家可以和 Familiar 對話嗎？

  可以，安裝後即可使用。桌上聊天預設為開啟，世界載入時以及你開啟此功能時，Familiar 都會在 Foundry 聊天中張貼簡短的使用說明。以 @familiar 開頭的訊息會在同一個聊天中得到回覆。沒有玩家擁有的任何 NPC 也會以角色身分回應對它自己的 @name 發出的訊息；若某場遊戲中只要說出名字就會洩漏劇情，請關閉 Any NPC 開關，因為 Familiar 無法對它讀得到的內容保密。關閉開關後，你可以在 NPC 的角色卡上將它釘選，讓它繼續回覆；也可以將玩家擁有的角色交給它。所有內容都在你的瀏覽器中執行，使用你的金鑰，而且你看得到每個問題和每個回答。玩家自己的角色會依照你設定的核准模式運作；其他範圍的操作都會等你核准，包括任何會向 AI 供應商收費的操作，而且玩家回合中絕不會產生影片片段。唯一例外是回答本身：設定語音供應商後，回答會使用你的金鑰直接朗讀，不會先詢問；Familiar 使用你的旁白聲線，每個 NPC 則使用各自的聲線。Voice 分頁中的 Table 聊天開關可以關閉這項功能。若 Chat 分頁沒有設定供應商（大多數 MCP 設定都是如此），問題會先留在桌上收件匣，直到你的 Claude、Codex、Antigravity、Grok 或 Muse Code 工作階段查看桌面。將一名玩家設為 Solo Player，該座位就會改用你自己的規則。 閱讀單人遊玩指南

• AI 會在不同場次之間記住我的戰役嗎？

  會，分成三個層次。你的聊天對話串會儲存為 Foundry 日誌，重新開啟時會回到上次離開的位置。在內建聊天中，每次對話都會加入一組戰役事實，因此上週發生的事今晚依然記得。持續更新的劇情摘要則會記錄故事本身。在 Foundry 中開啟名為「[Familiar] Campaign Memory」的日誌，即可查看它儲存的所有內容，並編輯或刪除錯誤資訊。 閱讀記憶指南

• Familiar 的費用是多少？

  每月 $6、每年 $48，或一次付清 $99，這就是 Familiar 的全部費用。沒有分級方案：無論選擇哪種付款方式，都包含所有更新。兩種訂閱方案都提供兩週免費試用。我們不會按用量計費，沒有點數餘額、逐則訊息費用，也不限制遊玩次數。AI 費用則由你自己的供應商按牌價收取：一般場次的 API Token 費用約為 $0.50 到 $3，每段語音、圖片、音軌或影片片段則各自計費（戰鬥地圖頁面列有附日期的圖片價格清單）。也可以完全不付 Token 費用：將內建聊天指向你自己機器上的模型，或透過 Claude、ChatGPT、Gemini 或 SuperGrok 方案，或 Muse Code 訂閱，使用 MCP 操作 Familiar。 比較兩種方式及各自的費用

• 如何取消訂閱？

  前往 familiarvtt.com/account 的客戶入口網站。Polar 是登記商家，負責處理帳單，因此請在該處取消：使用你付款時的電子郵件地址登入。同一個入口網站也能讓你切換月繳和年繳、改用終身授權、更新信用卡，以及取得發票。取消會在你已付款期間結束時生效。如果入口網站無法辨識你的電子郵件，請到 Discord 詢問，或寄信至 support@familiarvtt.com。 開啟訂閱頁面

• AI 能以地下城主身分主持我的遊戲嗎？

  可以。AI 不擅長自行編造故事，因此 Familiar 不會要求它這麼做。你提供包含地圖和 NPC 的已出版冒險，AI 會讀取並主持冒險，而人類隨時可以接手。連接你自己的 AI 後，它就會負責 DM 的所有工作，並在不同場次之間記住你的戰役。