Familiar

Foundry VTT 的熟悉 AI 副驾驶

Familiar 是适用于 Foundry VTT 的 AI 驱动副驾驶模块。它提供 26 个领域的 230 种工具，让你的 AI 助手可以直接访问游戏世界、角色、战斗、场景、日志、音频等内容。它会运行你已导入的已发布冒险，不会编造故事。

快速安装

在 Foundry VTT 中，前往 附加模块 > 安装模块 > 粘贴清单 URL：

https://github.com/Ryanjansen92/familiar-releases/releases/latest/download/module.json

点击 安装，然后在游戏世界的 管理模块 中启用该模块。

Beta 渠道（可选）：提前体验下一个版本，以验证已报告的问题修复。在同一个对话框中粘贴此清单 URL，然后使用 Foundry 的更新按钮，即可一直使用最新 Beta 版，直到稳定版更新。请先备份你的世界；MCP 客户端运行 npx -y familiar-vtt@beta。

https://github.com/Ryanjansen92/familiar-releases/releases/download/beta/module.json

功能

战斗自动化（D&D 5e）

• 按照完整规则处理攻击、伤害、豁免检定和法术效果
• 按规则执行职业特性：狂暴、动作如潮、额外攻击次数额度、全部 10 种超魔选项、邪术祈唤和 SRD 子职业特性
• 追踪先攻、状态、传奇动作、死亡豁免和专注
• 验证移动并强制遵守速度限制，同时检测借机攻击
• 规则执行由世界设置控制，可关闭，方便各桌按自己的规则进行游戏

NPC 的 AI 语音和音效

• 通过下方列出的任意语音服务商为任何 NPC 进行文本转语音，包括你自己的 OpenAI 兼容 TTS 服务端
• 为角色分配固定语音，或让 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 内置聊天窗口，支持流式响应
• MCP 服务，可供外部 AI 客户端使用（Claude Desktop、Claude Code、Codex CLI、ChatGPT 桌面应用的 Codex 选项卡、Antigravity CLI 和 Editor、Grok Build CLI、Muse Code）
• Table Chat：默认开启。玩家可在普通 Foundry 聊天中与 Familiar 或任意 NPC 交谈，并遵循你的审批模式；世界加载时，Familiar 会发布简短的使用说明。指定一名玩家为 Solo Player，Familiar 就会担任其 GM
• 支持 31 家 AI 服务商，涵盖云端 API 和在你自己的设备上运行的本地模型

支持的服务提供商

聊天：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 密钥
• 现代浏览器（Chrome、Firefox、Edge）
• 仅 MCP 路径需要 Node.js 22 或更高版本。内置聊天只需 Foundry
• Familiar 许可证：每月 $6、每年 $48，或一次性支付 $99。订阅前两周免费，所有功能均已解锁。访问 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 根据 Creative Commons Attribution 4.0 International License 授权，详见 https://creativecommons.org/licenses/by/4.0/legalcode。

支持

• 网站和许可：https://familiarvtt.com
• 错误报告和功能请求：Discord 是最快的联系途径；聊天中的每条错误信息都带有一个 复制诊断信息 按钮，可将已隐去敏感信息的报告复制到剪贴板。GitHub Issues 也可以使用
• Foundry VTT 兼容性问题：请提供你的 Foundry 版本、浏览器，以及任何控制台错误信息

---

这是 Familiar 的发布仓库。Familiar 是一款面向 Foundry VTT 的商业 AI 副驾驶，并以 familiar-vtt 的名称发布在 npm 上。此处不包含源代码；每个版本都包含可直接安装的编译模块。与无关的 rayners/fvtt-foundry-familiar 模块或桌面游戏中的“familiar”生物无关。