Tinkers KubeJS Arsenal

Tinkers KubeJS Arsenal

用KubeJS扩展Tinkers' Construct:全部66种配方类型、新材料、属性类型、部件、工具、弓、盔甲以及脚本化修饰符事件。无需Java。

工匠的构成

Tinkers KubeJS Arsenal

一个 Minecraft 1.20.1 Forge 的匠魂(Tinkers' Construct)附属模组,让你可以用 KubeJS 脚本扩展匠魂。

特性

  • 配方: 全部 66 种匠魂配方类型(熔化、浇铸、合金、部件建造、工匠站、词条、斩首等)统一为一致的链式写法,并提供一次性批量金属配方的调用。
  • 材料: 定义带有数值、特性、颜色和自动生成部件贴图的新材料;为已有材料追加数值或特性;材料标签与客户端材料变体。
  • 材料三围: 给材料设置硬度、密度和韧性,并让公式生成其数值和特性(见下文)。
  • 属性类型与部件: 注册新的材料属性类型和新部件形状。铸模、配方、标签、模型和各材料贴图都会自动生成。
  • 工具: 注册新的模块化工具、弓、弩、护甲和护甲套,可设置数值、词条槽、特性、工具动作和范围挖掘。
  • 词条: 定义新词条,并按词条监听近战伤害、命中、弹射物命中、挖掘、受伤、工具属性和属性修饰事件。
  • 工具类: ArsenalTool 用于查询词条、读写工具数据,ArsenalFluids 提供标准流体用量。

大部分修改执行 /reload 即可生效;只改事件逻辑时用 /kubejs reload server_scripts。

材料三围

在原版匠魂中,每个材料都需要为每种属性类型手写数值。新增一种属性类型,就得给所有材料各补一份。使用材料三围后,只需写一份公式:

  • 三围: 给材料设置硬度、密度和韧性,也可以加自定义数值。
  • 属性公式: 给属性类型写一份线性公式,所有设置了三围的材料自动算出该类型的数值和特性。100 个材料只需 1 份公式,新材料也只需填三围。
  • 部件公式: 按部件所用材料的三围,为某个具体部件额外加成工具属性和特性。匠魂原版部件也支持。
  • 覆盖规则: 手写的数值始终优先,可以按材料排除属性类型,替换模式下完全只用公式结果。
  • 提示框: 部件提示框直接显示加成,按住 Shift 查看属性,F3+H 查看原值与加成。
ArsenalMaterialEvents.data(event => {
  event.create('kubejs:mythril').properties(4, 5, 9)

  event.statFormula('head')
    .field('melee_attack', { hardness: 1 })
    .field('durability', { base: 100, toughness: 50 }, 'nearest')
    .tiers({ hardness: 1 }, [[0, 'minecraft:wood'], [6, 'minecraft:iron'], [9, 'minecraft:diamond']])
    .trait('tconstruct:reinforced', { toughness: 0.25 }, 5)

  event.partFormula('tconstruct:pick_head')
    .stat('attack_damage', { hardness: 0.5 })
})

同样的内容也可以用数据包编写。生成的都是普通的匠魂材料数据,手册、JEI 和联机同步照常工作。详见 Material Properties。

ProbeJS 支持

安装 ProbeJS 后,在 /reload 之后执行 /probejs dump,即可获得以下补全:

  • 配方: 全部 event.recipes.tconstruct.* 配方类型及其参数。
  • 按当前游戏生成的 ID 列表: 材料、材料属性类型、挖掘等级、词条、部件加工台图案、词条槽类型、工具部件、材料物品、可改造工具、工具属性和属性修饰。脚本定义的内容也会列出,同时仍可填写自定义 ID。
  • 构建器参数: 流体与流体标签、方块标签、矿石倍率、稀有度、护甲部位、部件属性类型、工具动作、可改造标签、贴图回退、属性运算方式、词条等级与提示显示方式、范围挖掘方向、语言代码。
  • 覆盖的 API: 熔化、浇铸、合金、词条配方;材料定义、外观与标签;材料属性类型;词条定义;toolStats 与 attributes 事件;ArsenalTool;工具、部件、护甲套构建器;工具数据定义。

前置

  • Minecraft Forge 1.20.1
  • 匠魂(含 Mantle)
  • KubeJS 2001.6.x(含 Rhino、Architectury)
  • HPTlib 1.1.0 及以上
  • ProbeJS(可选,用于脚本自动补全)

客户端和服务端都需要安装。

文档

完整中英文教程见 GitHub Wiki。

源码与问题反馈见 GitHub。

中文介绍

匠魂 KubeJS 军械库是匠魂(Tinkers' Construct)的附属模组

  • 配方: 支持全部 66 种匠魂配方(熔化、浇铸、合金、部件、工匠站、词条、斩首等),统一链式写法,并提供一行生成整套金属配方的工具。
  • 材料: 定义新材料的属性、特性、颜色和自动生成的部件贴图;给已有材料追加属性或特性;材料标签与客户端材料变体。
  • 材料三围: 给材料填写硬度、密度、韧性,由公式自动生成属性和特性(见下文)。
  • 属性类型与部件: 注册新的材料属性类型和新部件形状,自动生成铸模、配方、标签、模型和各材料贴图。
  • 工具: 注册新的模块化工具、弓、弩、护甲和护甲套,设置数值、词条槽、特性、工具动作和范围挖掘。
  • 词条: 定义新词条,并按词条监听近战伤害、命中、弹射物命中、挖掘、受伤、工具属性和属性修饰等事件。
  • 工具类: ArsenalTool 查询词条、读写工具数据,ArsenalFluids 提供标准流体用量。

大部分修改执行 /reload 即可生效;只改事件逻辑时用 /kubejs reload server_scripts 更快。

材料三围:原版匠魂里,每个材料都要为每种属性类型手写数值;新增一种属性类型,就得给所有材料各补一份。三围体系改为只写一份公式:

  • 三围: 给材料填写硬度、密度、韧性,也可以加自定义数值。
  • 属性公式: 给属性类型写一份线性公式,所有填了三围的材料自动算出该类型的数值和特性。100 个材料只要 1 份公式,新材料也只需填三围。
  • 部件公式: 按部件所用材料的三围,为某个具体部件额外加成工具属性和特性,匠魂原版部件也能写。
  • 覆盖规则: 手写的数值始终优先,可以按材料排除属性类型,替换模式下完全只用公式结果。
  • 提示框: 部件提示框直接显示加成,按住 Shift 查看属性,F3+H 查看原值与加成。

同样的内容也可以用数据包编写。生成的都是普通的匠魂材料数据,手册、JEI 和联机同步照常工作。写法见 Wiki 的材料三围与属性公式。

ProbeJS 支持:安装 ProbeJS 后,在 /reload 之后执行 /probejs dump,即可获得以下补全:

  • 配方: 全部 event.recipes.tconstruct.* 配方类型及其参数。
  • 按当前游戏生成的 ID 列表: 材料、材料属性类型、挖掘等级、词条、部件加工台图案、词条槽类型、工具部件、材料物品、可改造工具、工具属性和属性修饰。脚本定义的内容也会列出,同时仍可填写自定义 ID。
  • 构建器参数: 流体与流体标签、方块标签、矿石倍率、稀有度、护甲部位、部件属性类型、工具动作、可改造标签、贴图回退、属性运算方式、词条等级与提示显示方式、范围挖掘方向、语言代码。
  • 覆盖的 API: 熔化、浇铸、合金、词条配方;材料定义、外观与标签;材料属性类型;词条定义;toolStats 与 attributes 事件;ArsenalTool;工具、部件、护甲套构建器;工具数据定义。

前置:Minecraft Forge 1.20.1、匠魂(含 Mantle)、KubeJS 2001.6.x(含 Rhino、Architectury)、HPTlib 1.1.0 及以上;ProbeJS 可选。客户端和服务端都需要安装。

完整中英文教程见 GitHub Wiki。