自动NPC

说明（简体中文）

概述

AutonomeNPC 添加了一个跟随你的伙伴 NPC，并且在被分配职业后能够自主工作：采矿、探索、冶炼、合成，以及自动补充消耗的材料。其移动由 PathEngine 驱动，这是一个全新编写的异步 A* 寻路引擎（一个单独必需的依赖模组），能让伙伴跨越沟壑、攀爬、游泳和构建采矿路线且不会冻结游戏主线程。

重要提示： 尽管名字里有“AI”，本模组不连接任何外部 AI 服务。所有“AI”行为——寻路、工作逻辑、自然语言指令解析——都完全在本地以基于规则代码的形式运行。无需互联网连接或 API 密钥。

特性

伙伴基础功能

• 空手右键点击即可驯服；驯服者成为主人
• 自动跟随主人；右键点击切换坐下/跟随状态
• 专属物品栏（潜行 + 右键点击打开），并可随世界存档保存
• 可自定义名字；聊天报告中会以伙伴名字作为前缀
• 可按单个伙伴切换“落后时传送回主人”的开关
• 可在主世界、下界和末地使用
• 径向快捷菜单（按键绑定），用于等待 / 跟随 / 撤退 / 战斗 / 被动 / 召回
• 新玩家首次加入时会获得 4 个物品（1 个管理物品 + 3 根法杖）—— 生成蛋不包含在初始套装中

管理物品（GUI）

• 一个手持远程遥控器，包含 5 个标签页
• 基础操作（召回/跟随/等待/撤退、战斗开关、添加/移除伙伴、职业分配、近战/远程作战范围）
• 工作模式（配置各项自主工作）
• 外观（内置皮肤预设 + 从文件夹加载自定义 PNG 皮肤）
• 冶炼（燃料优先级列表）
• 设置（HUD 大小、盾牌格挡 HP 阈值）

职业与自主工作（人数限制：战斗 1 / 探索 2 / 基地 2）

• 基地角色：操作熔炉，通过自由文本聊天指令合成物品（“给我做一个……”）并报告进度
• 所有角色：自动收集和合成短缺的材料
• 工具进阶：木质 → 全套石质 → 按需合成铁质。下界合金永远不会自铸——伙伴会等待主人转交
• 挖掘：指定目标方块 ID（最多 5 个，或任意矿石）及目标数量
• 物品搜索：定位并取回指定的物品
• 自动分类：将箱子中的物品重新分配到指定区域内对应的箱子中，并合并部分堆叠
• 基地工作：从受保护区域的箱子中提取原材料，进行冶炼，并返还产物

状态系统

• HP/饥饿值统一为最高 20 点，支持不死图腾
• 左上角专用 HUD（红心/食物图标），带有受击/回复反馈
• 饥饿被视为非致命伤害
• 扩展物品栏：18 格背包 + 食物栏 + 9 格小袋 + 2 格药水栏（小袋/药水不参与自动分类/自动拾取）
• 在 HP 低于 50% 时自动使用治疗/再生药水，冲刺时自动使用速度药水（仅限战斗/挖掘/探索期间，并有冷却时间）
• 副手物品（如盾牌）在损坏/耗尽时自动从小袋中补充

战斗 AI

• 参与反击攻击主人的敌人、主人攻击的目标，或附近的敌对生物；可切换战斗激活/被动模式
• 当 HP 低于设定阈值时向主人撤退
• 伺机跳跃攻击以造成暴击，并会躲避洞穴/熔岩
• 盾牌格挡，配有每个伙伴独立的 HP 阈值滑块
• 远程（弓）风筝 AI，具有箭矢消耗逻辑（无限附魔弓不消耗箭矢），弹药耗尽时撤退
• 可从管理 GUI 切换近战/远程侧重点

实用工具

• 保护法杖：限制伙伴在标记区域内的方块更改
• 存储/分类目标法杖：用于指定自动分类的目标区域
• 在黑暗区域自动放置火把
• 自然语言聊天指令（完全本地、基于规则，支持日语和英语）——自由文本指令目前仅限于基地角色的合成请求

运行环境要求

Minecraft	1.21.1
模组加载器	NeoForge 21.1.x（不支持 Fabric / Forge）
Java	21
端	客户端 和 服务端
必需依赖	PathEngine —— 寻路库，必须与本模组一起安装

使用方法

1. 同时安装 PathEngine 和 AutonomeNPC（两者均为必需）。
2. 进入世界 —— 你会自动获得一个管理物品和 3 根法杖（一次性，仅首次加入时发放）。
3. 右键点击该物品打开 GUI，或通过“添加伙伴”按钮寻找伙伴（受人数限制）。
4. 空手右键点击伙伴以驯服它。
5. 在“工作模式”标签页中分配职业并配置其工作目标。

许可证

保留所有权利。禁止重新分发和修改本模组。 欢迎将其包含在模组包中 —— 无需许可。