Az的伙伴

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

Az 的伙伴

一个为 Minecraft 1.21.1 设计的温馨成人伙伴模组 —— 与你一同穿越世界、并肩战斗、夜晚入睡，并可（可选）通过本地或远程 LLM 与你聊天。

角色明确为成人、温馨且非性相关内容。

最新及进行中构建请访问 GITHUB

你将获得

使用伙伴护身符召唤一个伙伴，然后通过游戏内菜单（默认按键 K）或护身符 + Shift + 右键来指挥他们：

跟随 / 停留 / 坐下 / 游荡 — 坐下时人形形态会使用可见的坐姿；动物形态则保留其原有的坐姿
自定义 — 形态（玩家 + 生物）、毛色/品种变体、体型比例、皮肤以及玩家形态的活动服装（睡眠 / 沐浴 / 冒险）
物品栏 — 存放并管理他们的装备
战斗 — 固定的下界合金剑近战攻击；可为主播/管理员启用团队战斗
世界互动 — 赠送花朵、夜间睡眠（Kon 床）、当你骑乘时他们跟随、游泳跟随、随你跨维度传送（原版 + 模组）、退出时停放 / 登录时恢复
生物特性 — 猫形态吓跑苦力怕；狼形态吓跑骷髅；游荡模式下可与附近的生物进行趣味互动
子嗣 — 伙伴可以生育孩子，孩子会留在家庭中
可选 AI — 配置 LLM 后（默认关闭），可进行 /ask 对话、空闲闲聊和事件反应

已拥有的伙伴不会自然消失。沙漠神殿有几率掉落伙伴护身符（约 5%；可通过 world.enableLoot 禁用）。

版本（选择一个 jar 文件）

Jar	使用场景
独立版（NeoForge 或 Fabric）	默认 — 无主播桥接
CCI 版（NeoForge 或 Fabric）	通过 CCI + iChunUtil 与 Twitch / Streamlabs / StreamElements 集成

每个加载器仅安装一个 Az 的伙伴 jar — 切勿将独立版与 CCI 版同时安装。

要求： Minecraft 1.21.1、Java 21、NeoForge 21.1.x 或 Fabric Loader ≥0.16 + Fabric API。
仅限 CCI 版本： 相同加载器的 CCI 1.13.0 + iChunUtil 1.0.3。

软兼容

没有这些也能正常工作；有了它们体验更佳：

FTB Teams / Chunks / Ranks（信任与领地感知行为）
地图图标（Xaero's、JourneyMap）
动态光源软检测
Simple Voice Chat 检测（无完整 TTS 桥接）

多人游戏与主机

伙伴是按所有者区分的。指令和 /ask 仅针对你的伙伴。
断开连接时，你所拥有的伙伴会停放，并在你登录时在你附近恢复。
区块加载票据（默认开启）可保持已召唤的伙伴 / 子嗣在你离开后仍保持加载，以便跟随和睡眠功能继续工作 — 并非 FTB 领地功能。
专用 / 局域网主机需在服务器上配置一次 AI（密钥保留在主机上）。请参阅下面的 AI 设置。

AI 设置（可选）

默认：禁用。 未配置提供商时，伙伴仅使用简短的离线 / 脚本化台词。启用 AI 绝不会强制使用云 API — 你可以选择本地或远程。

聊天工作方式

使用 /ask <消息> 或 /az ask <消息> 聊天（可选择指定某个伙伴）。
回复会以角色扮演聊天形式显示给所有者（等待期间显示思考 HUD）。
每个伙伴保留自己的人设和记忆 — 共享主机端点 ≠ 共享同一个大脑。
首次创建时进行人设引导（谁 / 做什么 / 怎么做 + 可选的说话风格、关系、怪癖）；可随时使用 /az persona edit 编辑。
空闲闲聊（管理员可切换）：附近时偶尔播放环境台词（默认约 75–180 秒）。
反应性闲聊： 对附近事件（爆炸、黑暗 → 要求照明、制作装备、重大发现）作出简短反应 — 每位拥有者每 14 天（现实时间）约一次。配置了 LLM 时使用 LLM；否则使用稀疏的脚本化回退。
LLM 仅用于文本对话 — 没有操控世界的“AI 模式”。采集 / 任务使用常规伙伴行为指令。

加入同意与隐私

加入时你可能会看到一个可选的是 / 否提示。它只是询问；不会自动启用或将你锁定到服务器 LLM。
你的选择在每个服务器上只被记住一次（客户端文件）— 不会每次加入都提醒。
API 密钥绝不会离开主机。 客户端仅能看到密钥状态（config / env / 未设置），永远看不到机密本身。
优先使用环境变量 AZS_LLM_API_KEY，而不是将密钥粘贴到配置文件中。

提供商

在 /az admin → AI 配置（或 /az ai config）中配置 — 管理员 / 主机 / 白名单：

配置示例	典型用途
禁用	默认，离线安全
LM Studio / Ollama	本地 OpenAI 兼容 HTTP
LiteLLM / OpenAI / OpenRouter / Groq	远程或代理的 `/v1/chat/completions`
MCP	通过 MCP `companion_chat` 工具路由聊天

文件：Fabric config/azscompanions-ai.json · NeoForge config/azscompanions-ai.toml。
保存并应用 会写入文件并热应用管理员字段（这些字段无需重启）。

使用服务器 LLM

关闭（默认）： 个人 / 主机本地设置。非常适合单人游戏或你自己的局域网主机，指向 LM Studio、Ollama、LiteLLM 或远程 API。
开启（可选）： 为该世界中的所有人提供共享的主机端点。加入者无需自己的密钥或本地 LLM。
在专用服务器上，/ask 始终在服务器进程中运行（不涉及每个加入者的客户端 LLM）。当你想要该共享端点生效时，请开启 使用服务器 LLM。

玩家和管理员关心的设置项

设置	作用
`provider`	`disabled` / `local` / `openai_compatible` / `mcp`
`baseUrl` + `model`	端点和模型 ID
`apiKey` / `apiKeyEnv`	仅存于主机的机密
使用服务器 LLM (`serverLlmOnly`)	可选加入的共享主机 LLM
空闲闲聊 (`idleChat`)	附近的环境 + 反应性台词
`idleChatSecondsMin` / `Max`	环境台词间隔（默认约 75–180 秒）
`maxParallelRequests`	并发 LLM 调用数（默认 2；`/ask` 可插队）
`timeoutSeconds` / `connectTimeoutSeconds`	生成超时 vs 快速失败连接
`maxTokens`	回复长度上限（环境台词被限制得更短）
`perCompanionMemory` / `memoryMaxMessages`	独立思维 + 历史深度
`inputLanguage`	首选回复语言
`enableChatMessages`	将回复显示为所有者的聊天行

状态：/az ai status。完整参考：伙伴 AI 文档。

安全设置（推荐）

在你需要 AI 之前，将提供商保持为禁用。
启动本地服务器（LM Studio / Ollama / LiteLLM）或选择一个远程 OpenAI 兼容 API。
打开 /az admin → AI 配置 → 选择一个配置 → 设置模型 → 保存。
将密钥放入 AZS_LLM_API_KEY（或仅在主机上使用掩码 apiKey）。
在伙伴附近尝试 /ask hello。
对于多人游戏共享，仅在你打算使用主机级端点时开启 使用服务器 LLM。
如果你只想要按需 /ask，请关闭 空闲闲聊。

指令（快速参考）

/az — 主根指令（别名 /azscompanions）
/ask · /az ask — 与你的伙伴交谈
/az admin · /az ai config — 管理员 / AI 面板
/az persona … — 查看 / 编辑人设
/az teamfight on|off|status — 管理员团队战斗开关

已知限制

NeoForge 26.2 / 更新的 Minecraft 版本线：1.0.0 中未提供
VoiceMod TTS / 完整的 SVC 实体语音：仅检测的软兼容
旧存档中包含已移除的物品 / 形态：这些特性将不再生成