RecipesSchema简单教程

本文档基于1.20.1编写, 嗯...1.21就没了, 1.21用的其他方式

在1.20的KubeJS添加了一个recipeSchemaRegistry启动事件Startup, 这个事件可以让你给某些没有适配KubeJS的配方类型添加简单的适配, 例如createmetallurgy(机械动力: 冶金学), 这个Mod没有添加KubeJS

我找作者问过了, 他说真的没时间学科比吉斯(KubeJS)了

在写这篇教程的时候, 这个Mod还没有进行KubeJS适配, 现在的KubeJS适配还是我(柒月)向作者进行提交的KubeJS适配代码

这个Mod内有个类似于匠魂的铸造台配方, 在Json格式下是这样

{
	"type": "createmetallurgy:casting_in_table",
	"ingredients": [
		{
			"item": "createmetallurgy:graphite_plate_mold"
		},
		{
			"fluid": "createmetallurgy:molten_brass",
			"amount": 90
		}
	],
	"processingTime": 80,
	"mold_consumed": false,
	"result": {
		"item": "create:brass_sheet"
	}
}

同样的配方, 在添加了配方概述(下文称Schema)后可以变成这样

ServerEvents.recipes((event) => {
	let { createmetallurgy } = event.recipe

	createmetallurgy.casting_in_table("create:brass_sheet", [
		"createmetallurgy:graphite_plate_mold",
		Fluid.of("createmetallurgy:molten_brass", 90)
	]).processingTime(80).mold_consumed(false)
})

正文开始

介绍和示例就演示到这里, 下面开始正文(完整的代码在下面👇)

首先请先下载这个Schema配方文件RecipesSchema, 这个文件内有着各种类型的组件, 在编写的时候需要很频繁的查阅这些东西

然后去迺逸夫老师的GitHub仓库下载prelude.js, 这个文件是逸夫老师事先写好的轮子, 可以非常大程度的提升编写效率

随后将这个文件放入kubejs/starup_scripts/@recipes内

随后就可以开始编写自己的Schema了, 创建一个需要适配的Mod的modid一样的js文件

例如createmetallurgy.js

这里就拿createmetallurgy演示, 创建了文件后, 我们在文件内先写入

new Schema()

这里第一个括号内填入配方类型, 配方类型可以在配方文件的第一行"type"看到, 例如上文的铸造台配方类型就是"createmetallurgy:casting_in_table"

new Schema("createmetallurgy:casting_in_table")

下面开始添加.simpleKey()方法, 第一个参数内填入键名, 也就是配方文件中对应的各种一级键名, 例如ingredients processingTime result等

第二个就是需要填入的类型, 这个需要在上面提到的Java文件进行查看

第三个就是填入可选的内容, 其中字符串需要列举出来, 使用||进行分隔, 例如"superheated" || "heated"

接下来我们拿第一个类型createmetallurgy:casting_in_basin进行讲解

首先各种方法的排序代表着在ServerEvent.recipes中的排序

例如我是ingredients在前那createmetallurgy.casting_in_basin()排在第一个的就是ingredients而不是result或results(这里我提到了两种, 要留意一下, 下面会着重讲解(问就是我就被这个搞过🤡))

1

2

3

好我们继续, 上面提到想要和别的配方写法一样那首先就得确保results或result再最前面, ingredients或input一类的关键词在第二个

我们先说第一个results和result, 他们之间的区别就是一个s, 在英语中s代表复数, 因此多一个s就代表着可以 多输出

写入的第一个之后我们看第二个, 第二个代表着类型, 打开游戏, 随便看一个配方

4

根据猜测, 这种配方类型似乎只能输出一种物品, 因此我们在Java文件内找到带关键词output item的单词outputItem 输出物品, 然后我们先把这个写进去, 后面如果不行我们继续慢慢改

new Schema("createmetallurgy:casting_in_basin")
	.simpleKey("result", "outputItem")

接下来是第二个ingredients, 和上面的results一样, 后面带个s, 并且根据上图的配方来看, 这是一个多输出的配方(熔融铁和板子模具), 接下来我们去看Json文件

5

不难看出在ingredients这个键后所带的是一个[], 也就是数组, 数组的英文是Array, 你可能会像上面一样继续去找关键词. 这是对的, 但是这个配方不仅仅可以输入item, 同样可以输入fluid, 这是一个很关键的点, 需要注意, 根据上面的几个关键词Array item fluid找到inputFluidOrItemArray将他写在第二个参数上, 这样一个最简单的Schema就添加好了, 我们打开游戏输入/probe dump并且重启VS Code后就可以看到解构的补全了

6

我们写一个简单的配方

ServerEvents.recipes((event) => {
	let { createmetallurgy } = event.recipes

	createmetallurgy.casting_in_basin("minecraft:brick", [
		Fluid.of("minecraft:lava", 90),
		"#forge:ingots/iron"
	])
})

理论上这个配方其实已经可以用了, 但是配方内还有processingTime和mold_consumed两个键, 对应着加工时间和是否消耗模具

因此我们需要将这两项也写上, 这两个都比较简单

首先是加工时间, 加工时间用的是数字(单位Tick), 因此其实随便找一个和数字(Number)有关的就好, 第三个参数表现的时间可写可不写, 但最好随便写个数字

我这里用的是doubleNumber, 这种加工时间的一般在配方后用方法表示

7

接下来是模具消耗(mold_consumed), 这个在原文件中使用的是布尔值(true/false), 因此和上面一样, 随便找一个可以表示布尔的即可, 第三个参数把可选的true和false加上

然后进游戏dump一下, 写一个完整的配方

ServerEvents.recipes((event) => {
	let { createmetallurgy } = event.recipes

	createmetallurgy.casting_in_basin("minecraft:brick", [
		Fluid.of("minecraft:lava", 90),
		"#forge:ingots/iron"
	]).processingTime(114).mold_consumed(true)
})

Game Be Staring...

8

配方一切正常, 来看看🐴

new Schema("createmetallurgy:casting_in_basin")
	.simpleKey("result", "outputItem")
	.simpleKey("ingredients", "inputFluidOrItemArray")
	.simpleKey("processingTime", "doubleNumber", 100)
	.simpleKey("mold_consumed", "bool", false || true)

剩下的配方都差不多, 自己学着写一下

提示

这里简单讲一下机械动力的热量等级, 在配方中他们是一个键和字符串heatRequirement, 在Schema中创建了key后选择使用非空字符串(nonEmptyString), 然后在后面把热源等级都加上即可, 使用||进行分隔

随后在配方后使用.heatRequirement(String)方法进行热量配置

完整代码示例

new Schema("createmetallurgy:casting_in_basin")
	.simpleKey("result", "outputItem")
	.simpleKey("ingredients", "inputFluidOrItemArray")
	.simpleKey("processingTime", "doubleNumber", 100)
	.simpleKey("mold_consumed", "bool", false || true)

new Schema("createmetallurgy:casting_in_table")
	.simpleKey("result", "outputItem")
	.simpleKey("ingredients", "inputFluidOrItemArray")
	.simpleKey("processingTime", "doubleNumber", 100)
	.simpleKey("mold_consumed", "bool", false || true)

new Schema("createmetallurgy:grinding")
	.simpleKey("results", "outputItemArray")
	.simpleKey("ingredients", "inputItemArray")
	.simpleKey("processingTime", "doubleNumber", 100)

new Schema("createmetallurgy:alloying")
	.simpleKey("results", "outputFluidOrItemArray")
	.simpleKey("ingredients", "inputFluidOrItemArray")
	.simpleKey("heatRequirement", "nonEmptyString", "superheated" || "heated")
	.simpleKey("processingTime", "doubleNumber", 100)

new Schema("createmetallurgy:melting")
	.simpleKey("results", "outputFluidArray")
	.simpleKey("ingredients", "inputItemArray")
	.simpleKey("heatRequirement", "nonEmptyString", "superheated" || "heated")
	.simpleKey("processingTime", "doubleNumber", 100)