核心同伴

核心伙伴

核心伙伴为《我的世界》添加了一个绑定主人的AI伙伴。伙伴可以与你聊天、记住对话上下文、对世界做出反应、使用物品栏、执行生存任务、展现表情，还支持可选的语音/TTS/视觉功能，以及基于Baritone的世界动作。

目标是让伙伴感觉像是你世界中一个永久的角色，而不是简单的宠物或命令机器人。它可以跟随你、待在附近、协助完成任务、响应事件、管理物品、执行规划目标、随时间建立关系，并通过游戏内设置进行自定义。首次进入游戏时会自动设置——根据你的硬件挑选并下载合适的本地AI模型——让你无需编辑任何配置文件即可从安装直接进入有一个能说话的伙伴的世界。

开发状态

核心伙伴处于早期发布阶段。部分功能为实验性，可能会随着模组的改进而变化。

主要特性

• 登录时生成、移除、召回、定位和自动生成你的伙伴
• 持久的绑定主人伙伴身份
• 女性与男性伙伴设置选项
• 每个世界可选择开始模式：立即与伙伴建立羁绊，或在村庄伙伴模式中以未绑定状态相遇，通过聊天和食物赢得其信任
• 伙伴可通过其配置的名称或别名被原版命令指定为目标
• 背包与装备物品栏，包含伙伴物品栏界面和可旋转的3D伙伴预览
• 手持物品、使用装备、物品转移、丢弃、存放和整理行为
• 死亡后帮你捡回掉落物——她会寻路到你的死亡地点，捡起你的物品（完整NBT不变），并带回来
• 支持绑定之球和已绑定/未绑定生成蛋
• 肩扛、下马、牵手、玩家牵引附加/释放/拉动，以及双人表情状态清理

设置与首次运行

首次进入游戏时，核心伙伴会自动设置——无需编辑配置文件。

• 硬件感知模型选择： 它会检查你的机器实际能分配给AI模型的内存——专用GPU显存、Apple Silicon统一内存或系统RAM——为《我的世界》预留几GB以确保不会卸载导致卡顿，然后下载最合适的本地模型：轻量版（dolphin-phi）、均衡版（dolphin3）或最大版（dolphin-mixtral）。它会告知你为你的配置选择了哪个模型，因为更大的模型响应会更精准。
• 实时下载，然后登场： 热力栏上方会有一个进度条跟踪一次性下载，只有当模型下载完成并且预热完毕后，你的伙伴才会出现——她永远不会在无法说话的状态下生成。
• 全新机器友好： 如果本地AI服务（Ollama）尚未安装，会显示清晰的游戏内设置指南而非原始错误信息——并且跟随、挖矿和建造功能在无AI服务时仍可正常工作。
• 始终可调： 选择的模型、提供商、个性等所有内容都可以在游戏内配置界面中稍后编辑，且手动设置的模型始终被优先尊重。

AI与聊天

核心伙伴通过 /corecompanion 命令支持普通聊天响应和AI辅助动作。

• /corecompanion ask — 与你的伙伴聊天
• 本地优先且提供商灵活： 默认运行于本地Ollama模型，或连接任何兼容OpenAI的端点（OpenAI、xAI/Grok、Gemini的兼容OpenAI端点、LM Studio、llama.cpp服务器等）
• 零配置本地启动： 首次进入时自动选择并下载与你的硬件匹配的本地模型，然后在伙伴出现前预热（参见设置与首次运行）
• 提供商、端点、API密钥和模型均在游戏内配置界面中设置
• 可配置的个性、历史记录、温度、令牌长度和响应设置
• 用于Baritone动作、规划目标和社交动作的内部AI动作指令
• 用于位置、注视方块问题/动作、饥饿/进食、最近村庄、睡眠、“带我去基地/农场”和社交请求的确定性处理器
• 可排队和处理多条AI动作指令

直接动作动词

伙伴支持许多直接动作命令和AI触发的动作。

• 控制与状态： stop（停止）、stay（停留）、recall（召回）、where（位置）、status（状态）
• 模式： role（角色）、care_mode（关怀模式）、combat_mode（战斗模式）
• 导航： follow（跟随）、surface（地面）、sleep_routine（睡眠）、explore（探索）、goto（前往）、goto_memory（前往记忆）、go_home（回家）、go_farm（去农场）、locations（位置列表）、locate_village（定位村庄）
• 记忆： remember_location（记住位置）
• 物品与后勤： collect_items（收集物品）、eat（进食）、give_item（给予物品）、drop_item（丢弃物品）、inventory_intent（物品意向）、deposit_items（存放物品）、sort_inventory（整理物品栏）
• 挖矿、战斗与农耕： mine（挖矿）、defend（防御）、attack_hostiles（攻击敌对生物）、hunt（狩猎）、harvest（收获）、replant（重新种植）
• 建造： place（放置）、preview_template（预览模板）、build_line（建造线段）、structures（结构）、build_template（建造模板）

规划器自动化

用于常见生存任务的确定性规划器自动化。自然语言请求可以映射到计划队列中，让伙伴执行多步骤工作。

当前规划目标：get_wood（获取木头）、get_food（获取食物）、get_torches（获取火把）、farm_cycle（农耕循环）、tend_remembered_farm（照料已记忆的农场）、farm_cycle_deposit（农耕循环并存放）、prepare_mining_trip（准备采矿之旅）、prepare_toolkit（准备工具包）、build_shelter（建造庇护所）、patrol_base（巡逻基地）、light_area（照亮区域）、maintain_base（维护基地）、restock_base（补货基地）、wood_run（木材搬运）、mining_expedition（采矿远征）、return_and_deposit（返回并存放）、torch_path（火把路径）、recover_death_drops（回收死亡掉落物）、smelt_ores（熔炼矿石）、tend_livestock（照料牲畜）、fish（钓鱼）、make_camp（扎营）。

除了采集和基地维护，她还可以去钓鱼、熔炼矿石、照料牲畜、扎营，以及在糟糕的经历后——回收你的死亡掉落物并带回给你。关系加成可以缩放某些规划器的供应数量。

社交与关系特性

互动菜单包括伙伴动作、任务快捷方式、关系选项和实用控制：物品栏访问、关系界面、任务板、结构菜单、动作队列、跟随/停留/状态/停止/清除队列、整理和存放、警戒/农耕/巡逻/火把/木材/挖矿预设、基地和农场记忆控制、角色按钮以及社交动作。

内置表情：挥手、击掌、坐下、斜靠、拥抱、亲吻。

一起休息： 夜晚时，充满感情的伙伴可以挨着你睡觉——在她自己的相邻床上、拉近一点的位置，或与你同床——并带有一些爱心动画。亲吻、牵手以及整体的亲密强度均可配置，让你决定她主动的程度。

关系通过对话和喂食积累，并通过等级递进——陌生人、熟人、朋友、亲密、约会、绑定——解锁更多社交动作和更温暖的行为：

• 陌生人/熟人 — 克制；基础动作和击掌
• 朋友 — 斜靠、肩扛、牵手；当你受伤时自动防御和提供食物帮助
• 亲密 — 拥抱、亲吻
• 约会/绑定 — 公开表达爱意；当你即将倒下时给你一个金苹果，偶尔还会送你小礼物

部分双人互动仅在伙伴状态和玩家位置允许时执行，以防止尴尬或无效的动画。

自主性与安全模式

角色、关怀和战斗设置可以让伙伴根据不同情况表现不同行为。

• 角色： 空闲、警戒者、农夫、矿工、搬运工
• 关怀模式： 被动、平衡、警戒、撤退、全面
• 战斗策略： 被动、防御、协助
• 世界编辑安全： 切换她是否被允许在你的世界中破坏或放置方块

她会照顾自己和你的：低血量时饮用治疗药水、自动装备最佳护甲并在战斗前拔出最佳武器、受到重伤时撤退到你身边——如果你离得远则撤回到记忆的基地，并在没有食物时向你索要。友好的伙伴还能主动采取行动，在天黑时提议制作火把，或在你饥饿时去取食物。如果她死亡，会留下一个可回收的生成蛋纪念品，以便你带她回来且羁绊保持不变。

记忆与感知

持久记忆可以追踪玩家偏好、最近的聊天、事件、死亡、挖矿、探索、生物群系、记忆的基地/农场/坐标、记忆的计划、心情/当前目标及摘要。

世界情境可以包括维度、位置、生物群系、时间、天气、光照等级、附近实体、记住的地点、声音/听觉环境以及物理状态。她当前的心情影响行为——脆弱心情会使她更早退缩，而保护心情则让她坚守防线守护你。她也能将近期事件联系起来进行推理，而非孤立地响应每一个事件。

被动反应可以涵盖接收物品、牵手、肩扛、社交动作、玩家牵引事件、伤害、饥饿、挖矿、建造、战斗、旅行、空闲时刻、危险，以及在启用视觉时——她在屏幕上看到的显著事物。

语音、视觉与客户端UI

可选的客户端特性包括语音、TTS、视觉、HUD、覆盖层和渲染：

• 使用本地语音转文字/whisper.cpp支持的语音输入捕获
• 使用OpenAI或ElevenLabs语音（游戏内配置）的文本转语音播放
• 通过本地Ollama视觉模型实现可选的帧缓冲视觉捕获，支持按需捕获并将视觉摘要输入伙伴上下文
• 状态HUD、调试HUD和Baritone路径覆盖层
• 游戏内配置界面风格与原版菜单匹配，包括用于端点、模型和API密钥的AI提供商部分
• 伙伴渲染层包括体型、猫耳、尾巴、玩家牵引视觉、护甲和手持物品

数据与可扩展性

• 内置和配置加载的互动包
• 内置和配置加载的结构模板，以及捆绑的庇护所/模板数据
• 用于包和模板的重载命令
• 调试门控工具，用于提示转储、Baritone状态/失败、奇偶校验检查、表情测试、视频脚本和牵手记录

隐私/AI服务说明

核心伙伴设计为使用用户配置的AI服务。聊天可以通过本地Ollama模型或你配置的任何兼容OpenAI的端点运行。可选的语音、文本转语音和视觉功能取决于玩家配置的服务。使用云端LLM或TTS提供商会将你的文本（以及视觉功能中的截图上下文）发送给该提供商；在本地运行所有内容则将其保留在你的机器上。在启用这些功能前请检查你的配置。

命令

主命令：/corecompanion

子命令：ask（询问）、spawn（生成）、remove（移除）、recall（召回）、where（位置）、help（帮助）、setup female（设置女性）、setup male（设置男性）、start bonded（开始绑定）、start village（开始村庄）、carry（肩扛）、dismount（下马）、playerlead（玩家牵引）、reload（重载）。当调试选项启用时，还有额外的调试和开发者命令可用。

需求

• Fabric API
• GeckoLib
• Mod Menu（可选——打开游戏内配置界面）
• 兼容的《我的世界》/Fabric版本
• 用于本地AI的Ollama（或其他本地模型服务），或用于云端AI的兼容OpenAI的API密钥——对于本地AI，首次运行时会自动下载合适大小的模型