
双子座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 访问,无需信用卡或计费:
获取密钥:前往 https://aistudio.google.com/app/apikey 并使用标准 Google 账号登录。
创建密钥:点击蓝色 “Create API Key” 按钮并复制生成的密钥。
在 Minecraft 中添加:打开聊天并运行:
/bot apikey YOUR_API_KEY_HERE就是这样!你的密钥会本地保存到服务器/客户端配置中。
🌟 核心功能
🎭 1. 自定义皮肤文件夹与角色主题自动分配 (v1.2 新增)
- 即插即用皮肤文件夹(
/aicompanion/skins):- 只需将标准 64×64 或 64×32 的
.pngMinecraft 皮肤放入aicompanion/skins文件夹(位于游戏实例目录或配置文件夹中)! - 首次启动时自动初始化目录并生成指南。
- 只需将标准 64×64 或 64×32 的
- 角色子文件夹与自动分配:
- 将皮肤整理到角色子目录中(例如
/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。 - 深谷/深坑边缘搜索:当前方有宽阔落差且无搭桥材料时,伙伴会沿边缘向左右探测,寻找连续地面或安全的天然通道。
- 坑洞与沟渠陷阱分析:检查胸部/头部高度 3 面以上的周围方块。探测 2 格内的自然出口坡道或台阶(
- 无缝中间路径点路由:
- 直接导航到
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")。
- 防御守卫瞭望塔(5×5,10 格高):多层前哨,石砖基座、梯子攀爬井、中层守卫平台和带箭矢射孔的开阔城垛,供守卫使用(
- 自主工坊合成与供应物流:
- 建造者自动扫描建筑工地 16 格内的工坊箱子。
- 如果供应不足,箱子中的原木会自动合成为木板和木棍,无需玩家手动喂料。
- 自适应模组调色板引擎:
- 动态扫描附近存储和模组注册表,寻找 Macaw's 系列(
mcwdoors、mcwroofs、mcwwindows、mcwlights、mcwfurnitures),并在所有结构中协调匹配的木质主题。
- 动态扫描附近存储和模组注册表,寻找 Macaw's 系列(
- 村庄住房登记:自动追踪已完成的房屋和可用床铺,以支持未来的殖民地扩张。
⚔️ 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
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。