方块注册

kubejs可以在startup_scripts文件夹内创建去创建方块，注意所有的添加自定义的操作都是无法热加载的，写完之后需要重启游戏后才会加载进游戏内

基础写法

在kubejs当中注册方块是一件很容易的事情,它只需要下面这一行代码就可以注册好方块

StartupEvents.registry("block", (event) => {
    //event.create(方块id, 方块类型)
    event.create("meng:my_block", "basic")
})

上面的代码中我们选择的是方块注册，将方块id设置为"meng:my_block"，这里前面的meng是命名空间,主要关系到我们之后去添加材质贴图和本地化(lang文件)的路径

方块类型

我们的方块类型设置的为basic也就是默认的、基本的方块类型，在kubejs中已经给我们提供了不少的方块类型，如下

类型	描述	示例
`basic`	基础方块	待更新
`carpet`	地毯	待更新
`crop`	农作物	作物篇
`fence`	栅栏	待更新
`fence_gate`	栅栏门	待更新
`pressure_plate`	压力板	待更新
`button`	按钮	待更新
`slab`	台阶	待更新
`stairs`	楼梯	待更新
`wall`	墙	待更新
`cardinal`	朝向方块(类似讲台、熔炉等)	待更新
`detector`	检测方块?	待更新
`falling`	下落方块(类沙子)	待更新

在kubejs中，你并不用为方块单独去注册物品，kubejs已经帮你把方块物品注册好了，所以你可以直接获取到方块的物品，且物品id和方块id是一样的，在准备材质时，只需要准备方块的材质就可以了，无需单独为方块物品准备材质

通用方法参数

通用方法参数指的是不管什么类型的方块都可以调用到下面的方法

常用

方法	参数	描述	返回类型
`randomTick(Consumer\<RandomTickCallbackJS>)`	-	方块随机tick	this
`lootTable(Consumer\<LootBuilder>)`	-	方块战利品构建	~
`tagBlock(ResourceLocation)`	常用参数	设置方块的标签(如可被挖掘的工具类型和挖掘等级)	this
`tagItem(ResourceLocation)`	->	设置方块物品的tag	this
`noItem()`	-	不生成对应的物品	this
`displayName(Component)`	->	设置显示名字	this
`lightLevel(float)`	->	设置光照等级	this
`blockEntity(Consumer\<BlockEntityInfo>)`	-	创建为方块实体	this
`rightClick(Consumer\<BlockRightClickedEventJS>)`	-	方块右键事件	this
`noDrops()`	-	该方块的无掉落物	this
`hardness(float)`	->	设置方块硬度(默认1.5)	this
`speedFactor(float)`	->	设置方块速度(高于1会速度很快)	this
`jumpFactor(float)`	->	设置方块跳跃高度	this
`noValidSpawns(bool)`	->	该方块上是否会生成生物	this
`notSolid()`	-	使块不坚固???	this
`unbreakable()`	-	使方块无法破坏	this
`resistance(float)`	->	设置方块的耐爆炸性(默认为3)	this
`requiresTool()`	-	设置方块需要对应的工具挖掘才会掉落	this

常用的tagBlock()参数

挖掘需要的对应工具

如果方块没有requiresTool()，则使用对应工具可以加快挖掘速度
如果方块有requiresTool()，则需使用对应工具才可掉落

参数	对应工具类型
`"minecraft:mineable/sword"`	剑
`"minecraft:mineable/pickaxe"`	镐
`"minecraft:mineable/axe"`	斧
`"minecraft:mineable/shovel"`	锹
`"minecraft:mineable/hoe"`	锄

挖掘需要的工具品质

参数	需要的工具品质
`"minecraft:needs_wooden_tool"`	木
`"minecraft:needs_stone_tool"`	石
`"minecraft:needs_iron_tool"`	铁
`"minecraft:needs_golden_tool"`	金
`"minecraft:needs_diamond_tool"`	钻石
`"forge:needs_netherite_tool"`	下界合金(由`Forge`提供的标签,fabric版本未知)

关于渲染相关

方法	参数	描述	返回类型
`box(double, double, double, double, double, double)`	~	~	this
`box(double, double, double, double, double, double, bool)`	~	~	this
`defaultCutout()`	-	~	this
`defaultTranslucent()`	-	~	this
`transparent(bool)`	->	方块是否透明	this
`noCollision()`	-	设置方块无碰撞箱	this
`renderType(string)`	"cutout"/"cutout_mipped"/"translucent"/"basic"	选择渲染类型，一共就前面四种	this
`model(string)`	->	模型的位置路径	this
`viewBlocking(bool)`	~	~	this
`fullBlock(bool)`	->	设置方块是否为完整的块	this
`opaque(bool)`	->	设置方块是否透明(光线是否能够穿过)	this
`material(string)`	->	?	this

声音类型

方法	参数	描述	返回类型
`glassSoundType()`	-	玻璃音效	this
`grassSoundType()`	-	草地音效	this
`sandSoundType()`	-	沙子音效	this
`stoneSoundType()`	-	石头音效	this
`gravelSoundType()`	-	沙砾音效	this
`cropSoundType()`	-	作物音效	this
`woodSoundType()`	-	木头音效	this
`noSoundType()`	-	没有音效	this
`soundType(SoundType)`	->	自定义音效	this

其他

方法	参数	描述	返回类型
`mirrorState(Consumer\<BlockStateMirrorCallbackJS>)`	~	~	this
`rotateState(Consumer\<BlockStateRotateCallbackJS>)`	~	~	this
`bounciness(float)`	~	弹力？粘性？	this
`canBeReplaced(Predicate\<CanBeReplacedCallbackJS>)`	~	设置块是可以被替换	this
`placementState(Consumer\<BlockStateModifyPlacementCallbackJS>)`	~	放置方块事件	this
`steppedOn(Consumer\<EntitySteppedOnBlockCallbackJS>)`	~	方块踩踏事件	this
`afterFallenOn(Consumer\<AfterEntityFallenOnBlockCallbackJS>)`	-	~	this
`fallenOn(Consumer\<EntityFallenOnBlockCallbackJS>)`	-	方块下落时事件	this
`tagBoth(ResourceLocation)`	~	~	this
`defaultState(Consumer\<BlockStateModifyCallbackJS>)`	-	方块的默认状态	this
`exploded(Consumer\<BlockExplodedCallbackJS>)`	~	方块爆炸后的事件(此时方块已经被摧毁)	this
`canBeWaterlogged()`	-	方块是否被水淹没	bool
`textureSide(Direction,string)`	~	设置特定面的材质	this
`mapColor(MapColor)`	->	设置方块在地图上的颜色	this
`redstoneConductor(bool)`	->	设置方块是否是红石导体	this
`textureAll(string)`	->	用相同的纹理纹理块的所有方面?	this
`suffocating(bool)`	->	设置方块是否会让生物窒息	this
`slipperiness(float)`	~	设置块有多滑?	this
`transformObject(Block)`	~	~	Block
`texture(string,string)`	~	~	this
`property(BlockProperties)`	->	设置方块属性	this
`item(Consumer\<BlockItemBuilder>)`	-	方块的物品构建	this
`tag(ResourceLocation)`	->	设置方块的tag	this
`color(int,BlockTintFunction)`	~	设置块的特定层的颜色	this
`color(BlockTintFunction)`	~	~	this
`createProperties()`	-	?	BlockBehaviour$Properties
`generateDataJsons(DataJsonGenerator)`	~	~	-
`generateAssetJsons(AssetJsonGenerator)`	~	~	-
`getRegistryType()`	-	~	RegistryInfo<>
`waterlogged()`	-	设置块是可以被水淹没	this
`instrument(NoteBlockInstrument)`	~	音符块乐器？	this
`createAdditionalObjects()`	-	~	-

简单的注册方块轮子

注:以下内容根据个人习惯选择性使用和更改

StartupEvents.registry("block", (event) => {
	// ModID声明如果选择不更改ModID(默认即"kubejs")直接把ModID这个变量取消
	const MODID = "meng:"

	// 工具类型
	const toolType = {
		sword: "minecraft:mineable/sword",
		pickaxe: "minecraft:mineable/pickaxe",
		axe: "minecraft:mineable/axe",
		shovel: "minecraft:mineable/shovel",
		hoe: "minecraft:mineable/hoe"
	}

	// 挖掘等级
	const miningLevel = {
		wooden: "minecraft:needs_wooden_tool",
		stone: "minecraft:needs_stone_tool",
		iron: "minecraft:needs_iron_tool",
		gold: "minecraft:needs_gold_tool",
		diamond: "minecraft:needs_diamond_tool",
		nether: "forge:needs_netherite_tool"
	}

	/* 
	* 定义方块
	* 在添加下一个方块时要记得在[]后加上逗号
	* 并且一定要严格按照格式进行
	* [方块id, 声音类型, 硬度和爆炸抗性(这里我选择让他们共用一个数值), 工具类型, 挖掘等级]
	*/
	let blockRegisters = [
		// 示例
		["example_block", "stone", 3, "pickaxe", "wooden"],
	]
	blockRegisters.forEach(([name, soundType, hardness, tool, level]) => {
		event.create(MODID + name) // 声明方块id
			.soundType(soundType) // 声音类型
			.hardness(hardness) // 硬度
			.resistance(hardness) // 方块的耐爆炸性
			.tagBlock(toolType[tool]) // 工具类型
			.tagBlock(miningLevel[level])  // 挖掘等级
			// .tagItem(MODID + "items") // 添加物品tag(可选)
			// .tagItem(MODID + "blocks") // 添加物品tag(可选)
			.requiresTool(true) // 必须要工具挖掘
	})
})

贡献者

页面历史

最后编辑于 7 个月前

查看完整历史

kjs基础

战利品

自定义游戏内容

添加物品示例

添加方块示例

kjs资源路径文件夹

kjs进阶

事件示例

kjs模组

KubeJSAdditions

MoreJS

EntityJS

PonderJs(俺寻思)

进阶内容

函数调用

题外话

项目分享

孤梦的小项目

栗子的小项目

方块注册

基础写法

方块类型

通用方法参数