工匠的AI

工匠的AI

Tinkers' AI 是一个轻量级、数据驱动的 Minecraft 1.20.1 / Forge 附加模组。它为新生成的怪物提供匠魂装备,并教会它们使用匠魂的弓、弩和投掷武器。

工匠的构成

Tinkers' AI

Monster gear and ranged combat AI for Tinkers' Construct. 为匠魂(Tinkers' Construct)添加怪物装备与远程战斗 AI。

GitHub License Minecraft Forge

Tinkers' AI 是一个面向 Minecraft 1.20.1 / Forge 的轻量、配置文件驱动的匠魂附属模组。它会让新生成的怪物装备匠魂工具与护甲,并让怪物学会使用匠魂的弓、弩和投掷武器。匠魂与 Mantle 是可选依赖:未安装时模组仍可正常加载,只是不会启用相关功能。

本文档为中英对照,每节先英文、后简体中文。


概述

Tinkers' AI 有两个独立功能:

  1. 怪物装备:按照配置文件,把 #tinkersai:stripped_monster_gear 中列出的原版装备替换为匠魂工具与护甲。
  2. 远程 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 功能。客户端和服务端都需要安装本模组。


安装

  1. 安装 Minecraft 1.20.1 与 Forge 47.x。
  2. 将 tinkers-ai-1.1.1.jar 放入 mods 文件夹。
  3. 可选安装 Tinkers' Construct 3.12.1+ 与 Mantle 1.11+。
  4. 启动游戏。单人游戏与专用服务器均可使用。

工作原理

  • 装备替换在 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 许可证。


链接


中文: 反馈问题时请附上 Minecraft 版本、Forge 版本、匠魂版本和 latest.log。