Loot Table Event

info

该篇教程源自于 LootJs 官方网站，

适用于 Minecraft 1.21 及更高版本

此事件允许您直接修改战利品表

该事件在其他 Mod 将其战利品更改后使用数据包添加到原版战利品列表后触发，允许你删除或更改它们

战利品表

此篇教程是基于LootJs新版本添加的LootJS.lootTables事件进行的基础教程

建议搭配ProbeJs模组以及插件一起使用，辅助编写

获取战利品表 ID

getLootTableIds

返回所有可用战利品表 ID 的数组，可以进行筛选

使用正则表达式可以对战利品列表进行筛选

使用方法：

• getLootTableIds()
• getLootTableIds(filter: string | regex)

使用console.log()打印出来后，你将会在logs/kubejs/server.log日志文件里面看见所有通过数据包注册的战利品列表 ID

无筛选

LootJS.lootTables((event) => {
	let ids = event.getLootTableIds();
	console.log(ids);
});

使用正则表达式筛选

LootJS.lootTables((event) => {
	let ids = event.getLootTableIds(/.*chests\/.*/);
	console.log(ids);
});

使用正则表达式筛选后，只会打印出所有匹配chests这个战利品列表里面的战利品 ID

例如使用getLootTableIds()后日志输出为:

[minecraft:chests/bastion_treasure, minecraft:chests/village/village_weaponsmith, minecraft:chests/ruined_portal, minecraft:chests/trial_chambers/reward_ominous_rare, minecraft:chests/shipwreck_supply, minecraft:chests/stronghold_corridor, minecraft:chests/bastion_other, minecraft:chests/trial_chambers/reward_unique, minecraft:chests/village/village_fletcher, minecraft:chests/ancient_city_ice_box, minecraft:chests/village/village_cartographer, minecraft:chests/simple_dungeon, minecraft:chests/village/village_savanna_house, minecraft:chests/village/village_plains_house, minecraft:chests/village/village_taiga_house, minecraft:chests/nether_bridge, minecraft:chests/trial_chambers/intersection_barrel, minecraft:chests/trial_chambers/reward_ominous_unique, minecraft:chests/underwater_ruin_small, minecraft:chests/trial_chambers/reward_ominous_common, minecraft:chests/igloo_chest, minecraft:chests/village/village_armorer, minecraft:chests/village/village_mason, minecraft:chests/trial_chambers/intersection, minecraft:chests/trial_chambers/reward, minecraft:chests/buried_treasure, minecraft:chests/bastion_hoglin_stable, minecraft:chests/ancient_city, minecraft:chests/abandoned_mineshaft, minecraft:chests/trial_chambers/entrance, minecraft:chests/stronghold_crossing, minecraft:chests/village/village_fisher, minecraft:chests/village/village_butcher, minecraft:chests/shipwreck_treasure, minecraft:chests/village/village_toolsmith, minecraft:chests/village/village_temple, minecraft:chests/jungle_temple, minecraft:chests/desert_pyramid, minecraft:chests/trial_chambers/corridor, minecraft:chests/trial_chambers/reward_rare, minecraft:chests/village/village_desert_house, minecraft:chests/pillager_outpost, minecraft:chests/stronghold_library, minecraft:chests/shipwreck_map, minecraft:chests/underwater_ruin_big, minecraft:chests/trial_chambers/supply, minecraft:chests/village/village_shepherd, minecraft:chests/jungle_temple_dispenser, minecraft:chests/woodland_mansion, minecraft:chests/village/village_snowy_house, minecraft:chests/end_city_treasure, minecraft:chests/trial_chambers/reward_ominous, minecraft:chests/village/village_tannery, minecraft:chests/spawn_bonus_chest, minecraft:chests/bastion_bridge, minecraft:chests/trial_chambers/reward_common] [java.util.ArrayList]

给定 ID 获取战利品表

getLootTable

按照所指定的 ID 返回一个战利品表，如果没有这个战利品表的 ID，则返回为null

LootJS.lootTables((event) => {
	let table = event.getLootTable("minecraft:chests/simple_dungeon");
	console.log(table);
});

战利品列表检测

hasLootTable

返回具有给定 ID 的战利品表是否存在

如果该战利品列表存在，则返回true，否则返回false

下面的示例代码中，检测minecraft:chests/simple_dungeon这个战利品列表是否存在，最后可以看到console.log输出为true

LootJS.lootTables((event) => {
	let exists = event.hasLootTable("minecraft:chests/simple_dungeon");
	console.log(exists);
});

清除战利品列表

clearLootTables

清除所有与给定过滤器匹配的战利品表

可以使用选择器来过滤战利品表

语法：

• clearLootTables(filter: string | regex)

下面的示例中使用的是正则表达式来进行过滤，清除有关箱子里面所有的战利品

你也可以直接使用战利品表的 ID 来进行指定清除

LootJS.lootTables((event) => {
	event.clearLootTables(/.*chests.*/);
});

下面的示例代码中，指定了史莱姆的战利品表 ID，清除了史莱姆的所有战利品

LootJS.lootTables((event) => {
	event.clearLootTables("minecraft:entities/slime");
});

提示：对于战利品表 ID 的获取，游戏内可以使用/loot指令来进行获取

创建战利品列表

create

使用这个语法可以创建一个新的战利品表并应用

语法：

• create(id: string, type?: LootType)

如果LootType未提供，那么默认为LootType.CHEST

示例代码：

LootJS.lootTables((event) => {
	event.create("lootjs:table1", LootType.ENTITY).createPool((pool) => {
		// 修改你的战利品池
	});

	// 使用默认的LootType(CHEST)
	event.create("lootjs:table2").createPool((pool) => {
		// 修改你的战利品池
	});
});

修改战利品列表

modifyLootTables

该方法允许你一次修改所有的战利品表，或者进行筛选，返回后进行对应的战利品表修改

或者，您可以按战利品表类型进行筛选。战利品表类型在表 JSON 中的键下定义。例如，下面 JSON 中的 loot 表在第 2 行中使用 type 作为其类型:

type minecraft:blocks/bricks block

{
	"type": "minecraft:block",
	"pools": [
		{
			// ...
		}
	],
	"random_sequence": "minecraft:blocks/bricks"
}

语法：

• modifyLootTables(filter: LootTableFilter | LootTableFilter[])

示例代码:

单项选择器

LootJS.lootTables((event) => {
	event.modifyLootTables(/.*chests\/.*/).createPool((pool) => {
		// 修改你的战利品池
	});

	event.modifyLootTables(LootType.CHEST).createPool((pool) => {
		// 修改你的战利品池
	});
});

多选择器

LootJS.lootTables((event) => {
	event
		.modifyLootTables(LootType.CHEST, "minecraft:gameplay/fishing")
		.createPool((pool) => {
			// 修改你的战利品池
		});

	event
		.modifyLootTables(LootType.CHEST, LootType.ENTITY)
		.createPool((pool) => {
			// 修改你的战利品池
		});
});

在modifyLootTables中，可以使用多个过滤器来进行战利品表的修改。同样的你也可使用正则表达式来进行过滤选择

同时，选择器支持的类型有：

• 字符串
• 正则表达式
• LootTableFilter
• LootType

enum LootType {
    CHEST,
    BLOCK,
    ENTITY,
    EQUIPMENT,
    FISHING,
    ARCHAEOLOGY,
    GIFT,
    VAULT,
    SHEARING,
    PIGLIN_BARTER,
}

方块战利品列表

获取战利品表

getBlockTable

返回给定方块的战利品表，如果没有找到则返回null。

使用方法：

• getBlockTable(block: string | Block)

LootJS.lootTables(event => {
    let table = event.getBlockTable("minecraft:diamond_ore")
})

修改方块战利品表

modifyBlockTables

该方法允许你一次性修改所有匹配给定方块的战利品表。

info

在 Minecraft 1.21.1 后，战利品表的加载顺序在标签之前，因此modifyBlockTables方法不支持与标签一起使用。如果想使用标签，请考虑使用loot modifier event。

使用方法：

单过滤器

LootJS.lootTables(event => {
    event.modifyBlockTables("minecraft:diamond_ore").createPool(pool => {
        // edit the pool
    })
})

多过滤器

LootJS.lootTables(event => {
    event.modifyBlockTables("minecraft:diamond_ore", "minecraft:emerald_ore").createPool(pool => {
        // edit the pool
    })
})

实体战利品表

获取实体战利品表

getEntityTable

返回给定实体的战利品表，如果没有则返回null

使用方法：

• getEntityTable(entity: string | EntityType)

LootJS.lootTables(event => {
    let table = event.getEntityTable("minecraft:sheep")
})

修改实体战利品表

modifyEntityTables

该方法允许你一次性修改所有匹配给定实体的战利品表。

info

在 Minecraft 1.21.1 后，战利品表的加载顺序在标签之前，因此modifyBlockTables方法不支持与标签一起使用。如果想使用标签，请考虑使用loot modifier event。

使用方法：

• modifyEntityTables(filter: string | string[] | EntityType | EntityType[])

单过滤器

LootJS.lootTables(event => {
    event.modifyEntityTables("minecraft:sheep").createPool(pool => {
        // edit the pool
    })
})

多过滤器

LootJS.lootTables(event => {
    event.modifyEntityTables("minecraft:sheep", "minecraft:pig").createPool(pool => {
        // edit the pool
    })
})

Contributors

xiaoliziawa M1hono QiHuang02

Changelog

Last edited about 2 months ago

View full history

6a1dc79 - Update Twoslash config and 1.21 LootJS en translation.

f99fb30 - 完成LootJS_1.21.1的LootTables部分

afc5af6 - LootJs 1.21 Update

43b7cb2 - 再次提交

d275e09 - LootTables.md提交

7af4854 - 1.21 LootJs 提交

f5b01e7 - 更新LootJs 1.21教程