双子座AI伴侣机器人

双子座AI伴侣机器人

真正自主的AI伙伴玩家,能够采矿、制作、耕种、繁殖动物、保卫营地,并在多人游戏中聊天。

怪物

🤖 Gemini AI Companion Bots (NeoForge 26.3)

为你的 Minecraft 世界注入生命,迎来真正自主的 AI 伙伴玩家!由 Google Gemini 和智能离线战术引擎驱动,这些伙伴不会只是站在原地——它们会行走、挖掘、合成、耕种、繁殖动物、建造带床的房屋、用盾牌和跳跃暴击守卫你的基地、操作火车头和拖拉机、挖掘坑洞、穿戴你本地文件夹中的自定义皮肤,并在多人聊天中与你自然交谈。

适用于单人游戏和专用多人服务器!


⚡ 无需任何配置(离线战术引擎)

没有 API 密钥?没问题! 本模组内置离线战术决策引擎。安装模组并生成伙伴的那一刻,它们就能立即:

  • 将自定义皮肤放入 aicompanion/skins,自动按角色主题穿戴,支持 Alex/Steve 双层
  • 根据对话需求系统地逐层挖掘坑洞(“在这里挖个洞”)
  • 在锚定半径内挖掘特定方块类型(“挖掉这 10 格区域内的所有石头”)
  • 卡住时动态分析环境,探测墙壁两侧的路径并逃离坑洞
  • 建造完整的村庄小屋、瞭望塔、谷仓和锻造炉,包含门、窗、火把和床
  • 右键或按 B 键打开交互式速度表风格仪表盘
  • 用盾牌和冲刺跳跃暴击守卫你的领地
  • 执行用测量员法杖设置的全局边界
  • 耕种作物、繁殖牲畜、操作火车和拖拉机

(可选) 想要完整的对话 AI 个性、玩笑和上下文规划?30 秒内添加 100% 免费的 Google Gemini API 密钥!


🔑 如何在 30 秒内获取免费 Gemini API 密钥

Google 提供免费的 Gemini API 访问,无需信用卡或计费:

  1. 获取密钥:前往 https://aistudio.google.com/app/apikey 并使用标准 Google 账号登录。

  2. 创建密钥:点击蓝色 “Create API Key” 按钮并复制生成的密钥。

  3. 在 Minecraft 中添加:打开聊天并运行:

    /bot apikey YOUR_API_KEY_HERE
    

    就是这样!你的密钥会本地保存到服务器/客户端配置中。


🌟 核心功能

🎭 1. 自定义皮肤文件夹与角色主题自动分配 (v1.2 新增)

  • 即插即用皮肤文件夹(/aicompanion/skins):
    • 只需将标准 64×64 或 64×32 的 .png Minecraft 皮肤放入 aicompanion/skins 文件夹(位于游戏实例目录或配置文件夹中)!
    • 首次启动时自动初始化目录并生成指南。
  • 角色子文件夹与自动分配:
    • 将皮肤整理到角色子目录中(例如 /guard/、/builder/、/lumberjack/、/rancher/、/miner/、/farmer/、/conductor/),或用角色前缀命名(例如 guard_knight.png)。
    • 当伙伴以某个角色生成时,会自动从该角色类别中选择匹配的皮肤,并在不同变体间轮换,让每个工人/守卫看起来都与众不同!
  • 精确伙伴名称匹配与后备池:
    • 以伙伴名称命名皮肤文件(例如 gemini.png 或 bob.png)即可实现即时 1:1 皮肤分配。
    • 文件夹中任何通用或未分配的皮肤会自动形成伙伴的后备池。
  • 双层与纤细(Alex 3px)/ 宽型(Steve 4px)支持:
    • 完整双层渲染:外层配件层(安全帽、皮革挎包、工具腰带、皮套裤、辫子、抓绒背心)高保真渲染。
    • 通过 alpha 透明度或 _slim/alex 文件名标签自动检测 Alex 3px 纤细手臂模型。
  • 游戏内皮肤命令:
    • /bot skin list —— 列出文件夹中检测到的所有皮肤及其检测到的模型类型。
    • /bot skin reload —— 实时从磁盘热重载所有皮肤纹理,无需重启 Minecraft。
    • /bot skin set <botName> <skinName> —— 为伙伴分配特定皮肤,并在世界重启后保持。

⛏️ 2. 交互式语音挖坑与系统化挖掘(EXCAVATE)(v1.2 新增)

  • 自然的对话式后续追问:
    • 告诉你的伙伴 “挖个洞”、“在这里挖个洞”、“在这里挖掘” 或 “在这里挖”。
    • 伙伴会用绿宝石村民和火焰粒子标记你正看着(或站在其上)的精确地面方块,走到该位置,并在聊天中询问:

      “已标记起点 (X, Y, Z)!要从那里挖多大、多深?(例如‘5x5 深 4’或‘宽 4 深 6’)”

    • 自然回复即可,无需重复机器人名称(例如 "5x5 深 4"、"4 乘 4,深 6"、"宽 4 深 8"、"5x5" 或 "深 4")。
    • 说 "cancel" 可中止,或说 "从这里开始" 在你重新定位后更新锚点。
  • 单次尺寸命令:
    • 在提示中包含尺寸(例如 “在这里挖一个 5x5 深 4 的洞”),伙伴会立即锁定位置并开始挖掘。
  • 系统化蛇形逐层挖掘:
    • 伙伴从地表层开始逐层向下系统挖掘该体积(dy = 0 到 -(depth - 1))。
    • 自动装备最优工具(泥土/沙砾/沙子用铲子,石头/矿石用镐),以真实掉落破坏方块,并将所有挖掘物品直接吸入伙伴背包。

🎯 3. 半径约束的方块类型挖掘 (v1.2 新增)

  • 锚定区域挖掘命令:
    • 自然聊天命令:“挖掉这 10 格区域内的所有石头”、“挖掉 15 格内的所有煤”、“清除这 8 格区域内的所有泥土” 或 “挖掉这里的所有石头”。
    • 将挖掘区域锁定到玩家的锚点,并带有指定的方块半径。
  • 自上而下与暴露方块优先:
    • 挖掘系统优先处理暴露的地表方块,并从最高 Y 层向下工作,平滑地逐层剥离方块。
    • 区分自然地形(石头、深板岩、安山岩、闪长岩、花岗岩、凝灰岩、泥土、矿石)与玩家放置的建筑方块。

🧠 4. 智能卡住检测、区域分析与动态障碍绕行 (v1.2 新增)

  • 距目标停滞追踪:
    • 伙伴衡量向目的地的前进进度(moveNoProgressTicks)。如果在 16 tick(约 0.8 秒)内无法缩短与目标的距离,它们会识别出自己卡住了并分析周围环境。
  • 即时环境分析(analyzeAndExecuteUnstuckPlan):
    • 坑洞与沟渠陷阱分析:检查胸部/头部高度 3 面以上的周围方块。探测 2 格内的自然出口坡道或台阶(findNearbyExitStep)。如果被困在垂直坑洞中(深度 ≥2 格)且无坡道,会用合适的工具清除头顶障碍并执行支柱跳跃(executeHoleEscape())。
    • 墙壁/建筑/悬崖绕行探测:向左右两侧探测最远 8 格的侧向射线,寻找障碍附近最近的角落或开口,设置中间 activeBypassWaypoint。
    • 深谷/深坑边缘搜索:当前方有宽阔落差且无搭桥材料时,伙伴会沿边缘向左右探测,寻找连续地面或安全的天然通道。
  • 无缝中间路径点路由:
    • 直接导航到 activeBypassWaypoint,直到到达或超时,然后无缝恢复直接路径前往原目标。
  • 已消除靠墙搭柱 Bug:
    • 伙伴不再在接触建筑墙壁或房间角落时在脚下放置泥土柱。

📐 5. 地下坑洞支持与高度范围 (v1.2 新增)

  • 负高度坑洞挖掘:
    • /bot area height <name> <height>(以及 /bot area cube)接受负值(低至 -384),以定义地下坑洞和地下采石场。
  • 双数字显式 Y 范围:
    • 新增语法 /bot area height <name> <minY> <maxY>,用于定义两个显式世界 Y 层之间的长方体体积。

🌟 6. 伙伴名称标签光影泛光修复 (v1.2 新增)

  • Iris 与 Complementary 光影泛光修复:
    • 通过标准非自发光缓冲区渲染名称标签,防止光影包上出现刺眼的白色发光矩形,并与人类玩家名称标签完全一致。

📊 7. 交互式伙伴仪表盘与速度表 HUD (v1.1)

  • 右键或按 B 键:右键点击伙伴或按 B(可在控制中配置)打开其完整仪表盘。
  • 速度表风格生命仪表:简洁的颜色编码生命和饥饿仪表,实时显示 HP 和食物水平。
  • 完整物品栏与装备管理:41 个专用槽位,涵盖头盔、胸甲、护腿、靴子、副手(盾牌/火把)和 36 格背包,支持 Shift 点击转移。
  • 一键命令按钮:立即命令机器人执行 [跟随/停留]、[巡逻]、[建造小屋]、[存入箱子] 或 [吃口粮]。

🗺️ 8. 全局路径点与区域系统(测量员法杖)(v1.1)

  • 测量员法杖工具(/bot wand):
    • 右键方块,用发光激光粒子围栏连接周边角点(支持 2 角对角框或多角多边形)。
    • 潜行 + 右键打开区域配置 GUI,可命名区域(Compound、NorthFarm)并选择区域类型(COMPOUND、FARM、RANCH、SAFE_ZONE、RESTRICTED)。
    • 可在生存模式中用小号合成:1 个指南针 + 2 根木棍在工作台上斜向摆放。
  • 3D 长方体体积挤出(/bot area height / /bot area cube):
    • 为任何测量区域指定垂直高度或最小/最大 Y 范围。
    • 即时投射 3D 全息线框体积,带垂直角点信标和上/下粒子边界。
  • 周边限制:已分配的伙伴(/bot area assign <bot> <area> 或聊天 “守卫 Compound”)被锁定在边界内;移动向量会自动反射回区域中心。
  • AI 遥测:实时区域存在状态会自动传递给 Gemini AI 提示。

📐 9. 世界内蓝图扫描器与自定义建造目录 (v1.1)

  • 扫描并捕获任何建筑:
    • 运行 /bot blueprint capture <areaName> <blueprintName>,将 3D 立体区域内的所有内容扫描为持久蓝图。
    • 记录精确方块 ID、旋转属性和相对坐标。
    • 随时用 /bot blueprint info <blueprintName> 查看材料清单和尺寸。
  • 建造机器人复刻:
    • 蓝图会立即注册到机器人的建造目录中!
    • 在聊天中告诉任何建造伙伴:"builder, build <blueprintName>" 或输入 /bot build <bot> <blueprintName>。
    • 机器人会自动旋转结构以匹配其朝向,清除占地,从工坊箱子征用材料(必要时将原木合成为木板),并逐块建造整个建筑!

🏠 10. 自主建筑建造者与扩展目录(builder)(v1.1)

  • 多原型建筑目录:
    • 防御守卫瞭望塔(5×5,10 格高):多层前哨,石砖基座、梯子攀爬井、中层守卫平台和带箭矢射孔的开阔城垛,供守卫使用("build watchtower" / "build tower")。
    • 农舍谷仓与粮仓(9×9,高拱顶):高拱形木板屋顶、双谷仓门(兼容 Macaw's Barn Doors)、装饰干草捆和农民存放箱("build barn" / "build granary")。
    • 铁匠锻造炉与工坊(7×7):露天工业石制亭子,带烟囱、高炉、普通熔炉、工作台和铁砧("build forge" / "build blacksmith")。
    • 边疆住宅小屋(7×7):带地基、原木柱、玻璃窗、木门、火把照明和床的初始住所("build house" / "build cottage")。
  • 自主工坊合成与供应物流:
    • 建造者自动扫描建筑工地 16 格内的工坊箱子。
    • 如果供应不足,箱子中的原木会自动合成为木板和木棍,无需玩家手动喂料。
  • 自适应模组调色板引擎:
    • 动态扫描附近存储和模组注册表,寻找 Macaw's 系列(mcwdoors、mcwroofs、mcwwindows、mcwlights、mcwfurnitures),并在所有结构中协调匹配的木质主题。
  • 村庄住房登记:自动追踪已完成的房屋和可用床铺,以支持未来的殖民地扩张。

⚔️ 11. 战术战斗精通与小队防御

  • 冲刺跳跃暴击:伙伴跳入近战范围并在向下速度峰值时攻击,以火花粒子保证暴击。
  • 动态盾牌格挡:当苦力怕膨胀或骷髅拉弓时,立即举起副手盾牌,在反击前吸收伤害。
  • 小队遇险调度:当非战斗工人(农民、矿工、伐木工)被攻击时,它们会在聊天中呼救;48 格内的守卫伙伴会冲过去消除威胁。
  • 反向生物 A 寻路与防旋转锁定*:伙伴利用反向寻路绕过掩体接近生物,垂直锁定限制在 ±6 格内并验证视线,不可达目标会干净地超时。

🌾 12. 自主农民角色(farmer)

  • 测量员法杖映射区域耕种:告诉你的农民 "farm it"、"farm this area"、"farm the area" 或 "farm <name>" —— 它们会自动链接到映射区域,并系统地照料 100% 的区域(例如 149 m² 地块),不跳过外围角落。
  • 可分配尺寸:在聊天中指定任意尺寸(例如 "shawn, from this spot your farm is a 10x10 area")。
  • 严格成熟收获:只收获 100% 完全成熟的作物,不碰生长中的植物。
  • 即时补种与空地播种:自动补种已收获的位置,并从物品栏在空耕地上播种。
  • 锄地:装备锄头,将区域内未耕的泥土/草方块锄成耕地,并立即播种。
  • 多箱存储物流:自动定位附近的单箱、双箱和木桶。如果存入过程中箱子满了,农民会无缝切换到下一个有空间的容器。
  • 周边访问:可自由到达农场 24 格内的周边和边界围栏箱子,不会触及周边边界。

🐄 13. 畜牧与牧场(husbandry / rancher)

  • 自主繁殖:在牧场区域找到准备交配的牲畜并喂食繁殖食物。
  • 受控畜群淘汰:当动物数量超过你设定的上限时自动管理种群,绝不伤害幼崽或低于你设定的最低阈值。
  • 掉落物收集:收集肉、皮革、羊毛和羽毛,并存入存储箱。

🚂 14. 火车司机与干净下车(conductor / train)(miningtools 集成)

  • 机车操作:自动登上机车、管理燃料、控制油门并鸣笛。
  • 精确距离控制:说 "move ahead 4 tiles"、"forward 10 blocks" 或 "reverse 5 blocks"。
  • 铁轨寻路:说 "come here" 或 "drive to me",司机会沿铁轨把火车直接开到你面前。
  • 可靠下车与防重新上车保护:告诉任何乘坐火车的伙伴 "get out"、"dismount"、"get off" 或 "exit" —— 它们会干净地下车,取消所有火车命令,恢复之前的角色,并远离铁轨,不会立即重新上车循环。
  • 自动货运物流:在车站之间运输货物,自主装卸箱子。

🚜 15. 拖拉机自动化(tractor)(janemoose 集成)

  • 伙伴可骑乘并驾驶配备犁、播种机和收割机的可骑乘拖拉机穿越农田。

💾 16. 坚不可摧的世界持久化与区块加载

  • 持久区块票据:伙伴保持其区块加载,因此即使人类玩家在远处也能保持活跃。
  • 即时客户端渲染:玩家登录时立即同步数据包,消除隐形伙伴延迟。

💬 自然聊天命令示例

你可以直接在公共聊天中与伙伴对话:

  • 挖掘与挖坑:

    “dig a hole here” → 伙伴回复:“Marked starting point at (X, Y, Z)! How big and how deep should I dig from there?” → 回复:“5x5 and 4 deep” “dig a 4x4 hole 6 deep here” “excavate here”

  • 半径约束挖掘:

    “mine all the stone in this 10 block area” “mine all coal within 15 blocks” “clear all the dirt in this 8 block area”

  • 建造:

    “builder, build a house right here” “build a watchtower” “build a barn” “build a forge”

  • 区域与守卫:

    “guard Compound” “stay inside Base and watch the perimeter”

  • 昵称与重命名:

    “assign nickname Charlie” “set your nickname to Bob” “your nickname is now Steve”

  • 耕种(整个映射区域与自定义尺寸):

    “farm the area” / “farm this area” / “farm it”(自动耕种完整的测量员法杖映射区域)“farm FarmZone” “shawn, from this spot ur farm land is 10x10 area, plant wheat and carrots, put ur harvest in the chest, only harvest 100% mature crop”

  • 畜牧业:

    “james, breed cows with wheat, kill adult cows when amount is over 10, only kill adults never have less then 5 cows at anytime.”

  • 火车:

    “conductor, move ahead 10 blocks” “drive to me” “stop train” “get out” / “dismount” / “get off the train”


🎮 斜杠命令

命令 描述
/bot spawn <name> [role] 生成新伙伴(farmer、husbandry、guard、builder、miner、lumberjack、conductor、courier)
/bot nickname [botName] <nickname> 为伙伴(或最近的伙伴)分配活动昵称/别名
/bot rename [botName] <nickname> /bot nickname 的别名
/bot skin list 列出 aicompanion/skins 文件夹中检测到的所有皮肤及其模型类型
/bot skin reload 实时从磁盘热重载所有皮肤纹理
/bot skin set <botName> <skinName> 手动为伙伴分配特定皮肤(重启后保持)
/bot gui [name] 打开机器人的交互式速度表仪表盘与物品栏
/bot wand 获取测量员法杖,用于定义全局边界区域
/bot area list 列出所有已保存的全局区域和领地
/bot area height <name> <height|minY> [maxY] 设置 3D 挤出高度(支持负值坑洞)或显式最小/最大 Y 范围
/bot area cube <name> <height|minY> [maxY] /bot area height 的别名
/bot area show <name> 显示区域周围的发光激光边界粒子
/bot area assign <bot> <area> 将伙伴的巡逻区域严格限制在已保存区域
/bot area remove <name> 删除已保存的全局区域
/bot blueprint capture <area> <name> 将立体区域内的世界结构扫描为已保存蓝图
/bot blueprint list 列出所有自定义已保存蓝图
/bot blueprint info <name> 查看蓝图的尺寸、方块数量和材料清单
/bot blueprint build <bot> <name> 命令建造伙伴建造蓝图
/bot remove <name> 移除伙伴
/bot list 列出所有活跃伙伴及其当前任务
/bot status <name> 查看 HP、饥饿、农场/牧场区域和物品栏
/bot stop <name|all> 立即停止所有活跃机器人任务
/bot tp <name> 将伙伴传送到你的位置
/bot ask <name> <request> 向伙伴发送直接任务/问题
/bot apikey [key] 查看 API 密钥状态或设置你的个人/服务器 Gemini 密钥
/bot waypoint <name> 将你当前坐标保存为命名的机器人路径点

📋 技术要求

  • 平台:NeoForge 26.3
  • Minecraft 版本:26.3
  • Java 版本:Java 25
  • 端:双端(客户端与服务器)
  • 许可证:MIT