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
• 本地 / 自定义服务器

OpenRouter 只需一个密钥即可解锁 300 多个模型。本地 / 自定义服务器选项可将内置聊天连接到你运行的任何兼容 OpenAI 的服务器，可在其专属的本地 / 自定义设置标签页中配置。

语音

• ElevenLabs
• Cartesia
• OpenAI TTS
• OpenRouter TTS
• NanoGPT TTS
• 自定义 TTS

图像

• OpenAI (GPT Image)
• fal.ai
• Leonardo AI
• OpenRouter
• NanoGPT
• 自定义（兼容 OpenAI）

转录

• Gladia
• Deepgram
• AssemblyAI

使用你的订阅

已经在为 Claude、SuperGrok 或 Muse Code 付费？使用任何 ChatGPT 套餐（包括免费套餐），或拥有 Google 账户？让它发挥作用。

通过 Model Context Protocol 连接，你现有的套餐就能在自己的客户端中驱动同一张工具表。只要你提出要求，怪物就会行动；每次攻击和法术都会依据 5e 规则进行检查。模块内置 MCP 设置向导。选择客户端对应的卡片，它就会提供准确的文本：可粘贴的配置块或一条命令，其中包含密钥。每张卡片还附带一段可复制的帮助提示，适用于你已有的任何 AI 聊天，包括免费的网页版：它负责解释，你负责输入。最适合长链条、多步骤的操作。模型和推理强度在你自己的客户端中设置，而不是在这里。

MCP 客户端

• Claude Desktop

• Claude Code

• Codex CLI

• ChatGPT 桌面应用（Codex 标签页）

• Antigravity CLI

• Antigravity Editor

• Grok Build CLI

• Muse Code

阅读 MCP 设置指南

在本地运行

使用你自己的机器，无需按 token 付费。

同一套内置聊天，只需指向你运行的服务器。选择预设，检查自动填入的 URL，然后开启“用于聊天”。你的托管服务提供商设置会保留，方便切换回来。

运行器

• Ollama
• LM Studio
• llama.cpp
• LiteLLM
• 任何兼容 OpenAI 的服务器

预设列表中还包含 Venice，如果你更愿意租用 GPU：这种方式会离开你的网络，并向你的 Venice 账户收费。

阅读本地指南

你的密钥，你的费用。

大多数面向 Foundry 的付费 AI 模块都会通过自己的服务器转发请求，并按消息数量限制用量。Familiar 不会代理请求，也不会加价。你的 API 密钥会直接从浏览器发送到服务提供商；通过 MCP，AI 部分则由你的订阅承担。无论采用哪种方式，语音、图像、音乐和视频都会向各自服务提供商的密钥账户收费。

看它如何运行战斗、为 NPC 配音、生成战斗地图。

下面每个部分都展示了 Familiar 如何替地下城主分担一项工作，并配有来自实况世界的片段或截图。直接跳到你想看的部分。

战斗与自动驾驶

在 D&D 5e (2024) 中，AI 操控怪物，规则引擎决定哪些操作允许执行。在实况战斗中，它不能凭空编造掷骰结果，也不能直接把伤害写入角色卡。它不能无故移除状态，也不能让角色移动超过其速度。在聊天的战斗栏中开启自动驾驶后，所有没有玩家控制的生物都会自动行动，包括怪物和友方 NPC。你也可以按需启用安全上限和逐回合确认。

• 每个动作执行前都会经过规则检查
• 被拒绝的移动会明确说明原因，AI 会调整行动
• 由角色卡本身掷骰，包含熟练加值和魔法加值
• 多重攻击、传奇动作、怪物反应；玩家的反应仍由玩家自己掌控
• NPC 连续行动；可通过战斗栏、回合卡或 Ctrl+Shift+X 关闭
• 操作出错时可撤销上一个动作

开始战斗，播放音乐，让所有人都行动起来。分别为队伍和强盗掷骰，然后进行一轮战斗。

规则引擎如何执行规则

语音、音乐与音效

Familiar 会为刚刚写好的场景配音：旁白使用你的旁白音色，每个 NPC 的台词则使用各自的音色，文本一生成就会播放。此功能开箱即用，但只有在语音标签页中设置密钥后才会播放或产生费用。音乐会淡入淡出，切换到你现有播放列表中的氛围音乐；你也可以提出要求，用自己的密钥创作新曲。

• 用角色的声音说出任意台词，或为整段场景中的每位说话者分别配音
• 为尚未分配音色的 NPC 分配音色，并告知你分配结果；聊天中的说话者标签会显示当前发言者
• ElevenLabs、Cartesia、OpenAI TTS、OpenRouter、NanoGPT 或你自己的端点；每个角色都可固定使用一种音色
• 氛围会随地点自动切换；设为“按需”后则会等待你的指示
• 创作的曲目会放入 Familiar Music 播放列表，等你点播
• 生成的音效会出现在聊天中，并附带“保存”按钮，可将其保留为曲目

调暗灯光，播放雨声和雷声，让店主用他的声音低声警告前方的道路。

语音与音效

场景、美术与工作室

通过提问构建场景，并用美术素材填充。Familiar 负责放置，你来指挥。

• 创建场景，并从任意图鉴中生成 Token
• 绘制墙壁、门和触发区域；设置灯光、黑暗和天气
• 根据文本提示生成战斗地图背景，或直接生成肖像和物品美术
• 使用自己的 fal.ai 密钥，将静态图像制作成循环片段，并叠加到场景中作为动态地图
• 将“自动生成图像”设为“自动”，故事发展到新地点或新角色时，它就会为其生成图像
• Familiar Studio：在一个窗口中查看所有图像、片段和曲目，并显示服务提供商报告的费用；一次运行即可为缺失美术素材填充占位符

生成一张雾气弥漫的墓地战斗地图，给我三个选项，并将第二个用作背景。

探索 Familiar Studio

聊天窗口

GM 每场游戏都会使用的窗口。每个对话线程都是一篇 Foundry 日志，带有完整的审计记录。战役资料保存在记忆库中，你可以浏览、置顶和编辑。

• 它回复时你可以继续输入；下一条消息会排队等待
• 编辑或删除你的消息、重新生成回复；/undo 可撤销 Familiar 最近一次编辑
• 回复详略可选简洁、普通或详细；提供五种主题，默认深色，也可选择“自动”以跟随 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 提问，或者在启用“任意 NPC”后按名字询问 NPC。

• 完整队伍

  你为四名或更多玩家担任 DM GM 不再需要承担繁重的战术工作。你讲述故事；在 D&D 5e (2024) 中，Familiar 会处理先攻、怪物回合和记录工作。你负责运行场景，而不是电子表格。今晚有玩家无法参加？把他们的角色交给 Familiar，在 D&D 5e (2024) 中由它代为行动。结束时，让它总结发生的事情，并将总结保存为日志供该玩家阅读。

它会在你身边处理 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

听听他们怎么说。

来自 Discord 上在自己桌边使用 Familiar 的玩家分享。

• “生活越来越忙，我原以为自己再也没机会玩 D&D 了。Familiar 让我重新当上了玩家。它忠实而沉浸地管理游戏（还有语音！）。” Armchair EvokerFamiliar 在 DM 端，已开启语音

• “Familiar 让我可以担任‘助理 DM’，而不是全职 DM。我可以引导并支持游戏进程，同时保留自己的角色。我们正在跑《Phandelver and Below》，让 Familiar 负责旁白、NPC 和场景设定后，再也不用有人独自承担整个游戏了。” D3AD MANS PAR7Y和一群人一起玩《Phandelver and Below》，使用 ElevenLabs 语音，在 Discord 上测试 beta 版本

• “一开始就做得非常出色，而且对反馈和 bug 修复响应迅速。我从没见过开发者会为如此出色的软件亲自帮我排查问题，更别说像你们这样迅速了。” 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 冒险中的 DM 部分：规则、骰子、怪物和 NPC 语音。你仍然是玩家，掌握故事；Familiar 负责管理游戏桌。

• Foundry VTT 有 AI DM 模块吗？

  有。Familiar 是 Foundry VTT 的 AI DM 模块：连接你已经在使用的 AI，然后坐下来当玩家；它会负责运行你导入的已出版 D&D 5e 冒险中的整个 DM 部分，包括战斗、骰子和 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 完全不附带游戏内容：没有冒险、地图、图鉴包、属性数据或棋子图像。它是一款将你自己的 AI 连接到 Foundry 世界的软件。在你的游戏桌上，AI 会根据你的提示即兴生成聊天回复、NPC 语音、音效、音乐、图像和视频片段；生成的内容会进入你的世界，由你保留、编辑或删除。Familiar 强制执行的 5e 规则以名称和数字的形式存在于代码中，不会包含复制的规则文本。 Familiar 与 Foundry 的 AI 政策

• AI 会破坏我的世界吗？

  文档更新会经过清理，因此常规编辑无法触及所有权、权限或内部 ID。默认情况下，任何破坏性操作都会暂停并等待你确认；WebSocket 连接也使用共享密钥进行身份验证。如果编辑结果不符合你的预期，/undo 可以撤销 Familiar 对角色卡、日志、棋子、场景或播放列表所做的更改，也包括金币和文件夹的移动；MCP 客户端也通过同一记录进行撤销。但并非所有操作都能撤销。XP、状态、战斗操作之外的伤害或治疗、升级、角色卡上的新图像、被移动的物品或棋子，以及创建或删除的任何内容，都无法撤回。请保留备份：无论是否使用 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 的角色卡上将其固定，让它继续回复；也可以将玩家拥有的角色交给 Familiar。所有操作都在你的浏览器中运行，使用你的密钥，而且你能看到每个问题和每条回复。玩家自己的角色遵循你设置的审批模式；其他范围更广的操作都需要等待你的批准，包括任何会产生 AI 服务商费用的操作；玩家回合中绝不会生成视频片段。唯一的例外是回复本身：如果设置了语音服务商，回复会使用你的密钥直接朗读，无需询问；Familiar 使用你的旁白音色，每个 NPC 使用各自的音色。Voice 选项卡中的 Table chat 开关可以关闭此功能。如果 Chat 选项卡中没有设置服务商（大多数 MCP 设置都是如此），问题会先进入桌面收件箱，等待你的 Claude、Codex、Antigravity、Grok 或 Muse Code 会话查看。将一名玩家设为 Solo Player 后，该玩家席位则按你自己的规则运行。 阅读单人游戏指南

• AI 会在不同场次之间记住我的战役吗？

  会，分为三个层次。你的聊天线程会保存为 Foundry 日志，并在你上次离开的地方重新打开。在内置聊天中，每次对话都会注入一组战役事实，因此上周发生的事今晚仍然有效。持续更新的剧情摘要则会记录故事本身。在 Foundry 中打开名为“[Familiar] Campaign Memory”的日志，即可查看它存储的所有内容；如果有错误，你可以编辑或删除。 阅读记忆指南

• Familiar 的费用是多少？

  每月 $6、每年 $48，或一次性支付 $99，这就是 Familiar 的全部费用。没有不同等级：无论选择哪种付款方式，都包含所有更新。两种订阅都提供两周免费试用。我们这边不按用量计费，没有余额、单条消息费用，也没有游戏次数上限。AI 本身由你自己的服务商按标价收费：一次典型游戏场次的 API 令牌费用为 $0.50 到 $3；每条语音、每张图像、每首曲目或每段视频片段则单独计费（战斗地图页面列有带日期的图像价格清单）。也可以完全不产生令牌费用：将内置聊天指向你自己机器上的模型，或通过 Claude、ChatGPT、Gemini 或 SuperGrok 套餐，或 Muse Code 订阅，使用 MCP 驱动 Familiar。 比较两种方式及其费用

• 如何取消订阅？

  前往 familiarvtt.com/account 中的客户门户。Polar 作为登记商家负责处理账单，因此取消订阅也要在该门户中进行：使用付款时填写的电子邮件地址登录。同一门户还可以切换月付和年付、改为终身许可证、更新银行卡，以及获取发票。取消会在当前已付款周期结束时生效。如果门户无法识别你的电子邮件，请到 Discord 提问，或发送邮件至 support@familiarvtt.com。 打开订阅页面

• AI 能以地下城主的身份运行我的游戏吗？

  可以。AI 不擅长编造故事，所以 Familiar 不会让它们这么做。你提供包含地图和 NPC 的已出版冒险，AI 阅读并运行它；人类随时可以接手。连接你自己的 AI 后，它会负责运行整个 DM 部分，并在不同场次之间记住你的战役。