
工匠的AI
Tinkers' AI 是一个轻量级、数据驱动的 Minecraft 1.20.1 / Forge 附加模组。它为新生成的怪物提供匠魂装备,并教会它们使用匠魂的弓、弩和投掷武器。
Tinkers' AI
Monster gear and ranged combat AI for Tinkers' Construct. 为匠魂(Tinkers' Construct)添加怪物装备与远程战斗 AI。
Tinkers' AI 是一个面向 Minecraft 1.20.1 / Forge 的轻量、配置文件驱动的匠魂附属模组。它会让新生成的怪物装备匠魂工具与护甲,并让怪物学会使用匠魂的弓、弩和投掷武器。匠魂与 Mantle 是可选依赖:未安装时模组仍可正常加载,只是不会启用相关功能。
本文档为中英对照,每节先英文、后简体中文。
概述
Tinkers' AI 有两个独立功能:
- 怪物装备:按照配置文件,把
#tinkersai:stripped_monster_gear中列出的原版装备替换为匠魂工具与护甲。 - 远程 AI:让手持匠魂发射器或投掷武器的怪物获得自定义远程攻击 AI,因为原版 AI 只识别
BowItem和CrossbowItem。
本模组不会修改原版或匠魂的战利品表,不会改变玩家掉落,也不会改动匠魂自带的怪物装备表。
功能
1. 怪物装备
- 在怪物进入世界时执行,此时原版与匠魂都已经完成各自装备的随机。
- 只从六个装备槽中移除
#tinkersai:stripped_monster_gear里列出的原版工具、武器和护甲。 - 按配置文件随机匠魂装备,并且只填充空槽,因此匠魂自带的怪物装备会被保留。
- 每件工具的各部件材料独立随机。
- 内置规则不包含远古工具(
#tconstruct:modifiable/ancient);配置文件可以有意加入它们。 - 规则里可以写任意物品 ID,不限于匠魂物品;未知 ID 会跳过并在日志中警告。
2. 远程战斗 AI
- 弓:怪物拉弓,蓄满后释放,由匠魂负责发射箭。
- 弩:怪物先上膛,再通过匠魂发射。
- 投掷武器(
javelin以及其他带throwing词条的工具):怪物举起并投出ThrownTool,类似三叉戟。武器不会被消耗,不扣耐久,投出的实体不可拾取。 - 手持匠魂发射器的怪物射击时会获得无限箭;玩家的箭矢不受影响。
- AI 在怪物进入世界时挂载;之后捡起物品不会新增 AI。
- 怪物之后捡起匠魂发射器时,也会自动挂上该 AI。
3. 规则系统
- 可以定义哪些怪物获得哪些主手武器、副手物品和护甲套装。
- 支持实体 ID 或实体标签。
- 不需要写 Java 就能为模组怪物添加兼容规则。
- 规则通过
/reload重载,只影响之后生成的怪物。
环境
| 组件 | 版本 | 必需 |
|---|---|---|
| Minecraft | 1.20.1 | 是 |
| Forge | 47.x(使用 47.4.28 构建) | 是 |
| Java | 17 | 是 |
| Tinkers' Construct | 3.12.1+ | 可选 |
| Mantle | 1.11+ | 可选 |
中文: 匠魂与 Mantle 是可选依赖。未安装时模组可以加载,但不会注册装备或 AI 功能。客户端和服务端都需要安装本模组。
安装
- 安装 Minecraft 1.20.1 与 Forge 47.x。
- 将
tinkers-ai-1.1.1.jar放入mods文件夹。 - 可选安装 Tinkers' Construct 3.12.1+ 与 Mantle 1.11+。
- 启动游戏。单人游戏与专用服务器均可使用。
工作原理
- 装备替换在
EntityJoinLevelEvent中执行,此时Mob#finalizeSpawn已经完成原版与匠魂装备的随机。 - 处理器只移除
#tinkersai:stripped_monster_gear物品标签中的物品,然后按匹配到的配置随机装备。 - 一个作用于匠魂
ModifiableItem的小型 Mixin 提供远程 AI 所需的主动使用动画;只涉及匠魂自己的类。 - 通过
LivingGetProjectileEvent为手持匠魂发射器的怪物提供箭。
配置文件规则
规则放在哪里
- 原版怪物:
config/tinkersai/mob_gear/minecraft/(首次启动自动生成) - 模组怪物:
config/tinkersai/mob_gear/compat/<模组 ID>/
文件名任意;这些目录下的每个 .json 都会被加载,修改后用 /reload 重读。
示例
{
"priority": 5,
"mobs": ["minecraft:zombie"],
"mainhand": {
"chance": 0.02,
"items": [
{ "item": "tconstruct:sword", "weight": 5 },
{ "item": "tconstruct:pickaxe", "weight": 7 }
]
},
"offhand": {
"chance": 0.05,
"items": [
{ "item": "tconstruct:plate_shield", "weight": 1 }
]
},
"armor": {
"chance": 0.08,
"sets": [
{ "set": "travelers", "weight": 3 },
{ "set": "plate", "weight": 1 }
]
}
}
字段
| 字段 | 类型 | 说明 |
|---|---|---|
priority |
integer | 多条规则命中同一怪物时,优先级高的生效。 |
mobs |
string array | 实体 ID 或 # 实体标签。 |
mainhand / offhand |
object | chance 为触发概率(0–1),items 按 weight 加权。 |
armor |
object | chance 为触发概率,sets 按 weight 加权。 |
sets[].set |
string | plate(板甲)或 travelers(旅行者护甲)。 |
- 规则只填充空槽,已经有匠魂装备的怪物会保留原装备。
- 每件护甲有少量概率被跳过,因此可能只生成部分套装。
mainhand与offhand可以写任意物品 ID,包括非匠魂物品。- 修改后执行
/reload;已经生成的怪物不会被追溯修改。
配置
材料等级权重位于 config/tinkersai-common.toml:
[materialTierWeights]
tier0 = 25.0
tier1 = 25.0
tier2 = 30.0
tier3 = 17.0
tier4 = 3.0
- 每个工具部件先抽取等级,再在该等级内随机材料。
- 权重是相对值,不需要加起来等于 100。
- 默认分布:tier 0 + tier 1 = 50%,tier 2 = 30%,tier 3 = 17%,tier 4 = 3%。
- 所有值都设为
0时会回退到默认分布。 - 修改后下次加载配置/进入世界生效。
生成的
.toml注释只有英文;游戏内配置界面的选项名通过assets/tinkersai/lang/*.json翻译。
兼容性与限制
- 匠魂是可选依赖。 未安装时不会注册匠魂装备或远程 AI。
- 不修改战利品表。 原版与匠魂的战利品表、玩家掉落、交易和箱子战利品都不会被改动。
- 远古工具需手动加入。 内置规则排除了
#tconstruct:modifiable/ancient中的匠魂工具;配置文件可以加入它们。 - 只影响新怪物。 已经生成的怪物不会被追溯修改;只会在加载时尝试重新挂载远程 AI。
- 可能被其他模组覆盖。 如果其他模组在怪物进入世界后替换装备,以那个模组的结果为准。
- 客户端与服务端都要装。 服务端负责装备与 AI。
- 这是非官方附属模组,与匠魂官方团队无关,也未获得其背书。
构建
需要 JDK 17:
./gradlew build
输出文件:
build/libs/tinkers-ai-1.1.1.jar
启动开发服务器:
./gradlew runServer
将 Mantle-1.20.1-1.11.124.jar 与 TConstruct-1.20.1-3.12.1.237.jar 放入 run/mods/;开发依赖已在 build.gradle 中声明。
许可证
中文: 本项目使用 MIT 许可证。
链接
- GitHub: https://github.com/Rhaaaaaast1/Tinkers-AI
- Issues: https://github.com/Rhaaaaaast1/Tinkers-AI/issues
- Tinkers' Construct: https://github.com/SlimeKnights/TinkersConstruct
- Mantle: https://github.com/SlimeKnights/Mantle
中文: 反馈问题时请附上 Minecraft 版本、Forge 版本、匠魂版本和 latest.log。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。