> For the complete documentation index, see [llms.txt](https://youyi580.gitbook.io/zentutorial/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://youyi580.gitbook.io/zentutorial/advanced/loottweaker-advanced.md).

# 战利品表修改(LootTweaker-进阶)

在阅读此页面前, 强烈建议先阅读 [战利品表修改(LootTweaker-基础)](/zentutorial/easy/loottable-introduction/loottweaker-easy.md) 页面.

## ZenScript 类型

### LootTweaker

* 全名 : `loottweaker.LootTweaker`.

#### 方法

**getTable(String tableName)**

* tableName - LootTable 的名称.

  如没有对应 LootTable 时, 返回错误.

正常时返回对应的 LootTable 对象.

**newTable(String tableName)**

* tableName - LootTable 的名称.

  如已存在同名 LootTable, 返回错误.

如使用了 `minecraft` 命名空间, 返回警告. (可在 LootTweaker 配置中关闭此警告.)

正常时返回对应名称的空 LootTable 对象.

### LootTable

* 全名 : `loottweaker.vanilla.loot.LootTable`.

#### 方法

**clear()**

清除所有此 LootTable 中的物品, 包括在调用此方法前使用脚本添加的。无返回值。

**addPool(String poolName, float minRolls, float maxRolls, float minBonusRolls, float maxBonusRolls)**

创建一个名称为 指定名称的 pool.

* poolName - pool 的名称.
* minRolls - 最低被抽取次数.
* maxRolls - 最高被抽取次数.
* minRolls - 最低额外被抽取次数.
* maxRolls - 最高额外被抽取次数.

  如已存在同名 pool, 返回错误.

正常时返回对应名称的空 pool 对象.

**removePool(String poolName)**

移除指定名称对应的 pool.

* poolName - pool 的名称.

如指定名称对应的 pool 不存在, 返回错误.

正常时返回 void.

**getPool(String poolName)**

* poolName - pool 的名称.

如指定名称对应的 pool 不存在, 返回错误.

正常时返回指定名称对应的 pool.

#### pool 名称

所有 pool 都有一个名字. 第一个, 默认的 pool 名为 main. 接连的 pool 的命名格式为 `poolN`, N 是一个从 `1` 递进的整数.

### LootPool

* 全名 : `loottweaker.vanilla.loot.LootPool`.

#### Map 自动转换

0.2.1 及以上版本的 LootTweaker 会自动将 JSON 格式 Map 转换为 LootCondition/LootFunction. 即所有 LootFunction/LootCondition 参数都同样可以接受 JSON 格式 Map.

#### 方法

**addConditions(LootCondition\[] conditions)**

为 pool 添加条件.

* conditions - LootCondition 实例数组.

无返回值。

**removeEntry(String entryName)**

移除 pool 中指定名称对应的 entry.

* entryName - entry 的名称.

pool 中不存在指定名称对应的 entry 时, 返回错误.

无返回值。

**addItemEntry(IItemStack iStack, int weight, int quality, LootFunction\[] functions, LootCondition\[] conditions, @Optional String name)**

向指定 pool 中添加一个 `item` 类型的 entry.

* iStack - 此 entry 产生的物品堆. LootTweaker 会在 `functions` 中不包含同名 LootFunction 时基于此堆自动生成 `set_nbt`, `set_damage/set_data` 和 `set_count` 参数.
* weight - 此 entry 的生成权重, 越高生成的机率越大.
* quality - 此 entry 的稀有度, 即幸运效果影响此 entry 的程度, 越高受幸运效果影响就越大.
* functions - 影响此 entry 生成的参数.
* conditions - 此 entry 生成的条件.
* name - (可选) 此 entry 的名称, 必须在 pool 范围中唯一.

如指定 pool 中已存在同名 entry, 返回错误.

正常时返回 void.

**addItemEntry(IItemStack stack, int weightIn, int qualityIn, @Optional String name)**

向指定 pool 中添加一个 `item` 类型的 entry.

* stack - 此 entry 产生的物品堆. LootTweaker 会基于此堆自动生成 `set_nbt`, `set_damage/set_data` 和 `set_count` 参数.
* weightIn - 此 entry 的生成权重, 越高生成的机率越大.
* qualityIn - 此 entry 的稀有度, 即幸运效果影响此 entry 的程度, 越高受幸运效果影响就越大.
* name - (可选) 此 entry 的名称, 必须在 pool 范围中唯一.

如指定 pool 中已存在同名 entry, 返回错误.

正常时返回 void.

**addItemEntry(IItemStack stack, int weightIn, @Optional String name)**

向指定 pool 中添加一个 `item` 类型的 entry.

* stack - 此 entry 产生的物品堆. LootTweaker 会在 `functions` 中不包含同名 LootFunction 时基于此堆自动生成 `set_nbt`, `set_damage/set_data` 和 `set_count` 参数.
* weightIn - 此 entry 的生成权重, 越高生成的机率越大.
* name - (可选) 此 entry 的名称, 必须在 pool 范围中唯一.

如指定 pool 中已存在同名 entry, 返回错误.

正常时返回 void.

**addLootTableEntry(String tableName, int weightIn, int qualityIn, LootCondition\[] conditions, @Optional String name)**

向指定 pool 中添加一个 `loot_table` 类型的 entry.

* tableName - 此 entry 用于读取并生成战利品的 LootTable 的名称.
* weight - 此 entry 的生成权重, 越高生成的机率越大.
* quality - 此 entry 的稀有度, 即幸运效果影响此 entry 的程度, 越高受幸运效果影响就越大.
* conditions - 此 entry 生成的条件.
* name - (可选) 此 entry 的名称, 必须在 pool 范围中唯一.

如指定 pool 中已存在同名 entry, 返回错误.

正常时返回 void.

**addLootTableEntry(String tableName, int weightIn, int qualityIn, @Optional String name)**

向指定 pool 中添加一个 `loot_table` 类型的 entry.

* tableName - 此 entry 用于读取并生成战利品的 LootTable 的名称.
* weight - 此 entry 的生成权重, 越高生成的机率越大.
* quality - 此 entry 的稀有度, 即幸运效果影响此 entry 的程度, 越高受幸运效果影响就越大.
* name - (可选) 此 entry 的名称, 必须在 pool 范围中唯一.

如指定 pool 中已存在同名 entry, 返回错误.

正常时返回 void.

**addLootTableEntry(String tableName, int weightIn, @Optional String name)**

向指定 pool 中添加一个 `loot_table` 类型的 entry.

* tableName - 此 entry 用于读取并生成战利品的 LootTable 的名称.
* weight - 此 entry 的生成权重, 越高生成的机率越大.
* name - (可选) 此 entry 的名称, 必须在 pool 范围中唯一.

如指定 pool 中已存在同名 entry, 返回错误.

正常时返回 void.

**addEmptyEntry(int weight, int quality, LootCondition\[] conditions, @Optional String name)**

向指定 pool 中添加一个 `empty` 类型的 entry.

* weight - 此 entry 的生成权重, 越高生成的机率越大.
* quality - 此 entry 的稀有度, 即幸运效果影响此 entry 的程度, 越高受幸运效果影响就越大.
* conditions - 此 entry 生成的条件.
* name - (可选) 此 entry 的名称, 必须在 pool 范围中唯一.

如指定 pool 中已存在同名 entry, 返回错误.

正常时返回 void.

**addEmptyEntry(int weight, int quality, @Optional String name)**

向指定 pool 中添加一个 `empty` 类型的 entry.

* weight - 此 entry 的生成权重, 越高生成的机率越大.
* quality - 此 entry 的稀有度, 即幸运效果影响此 entry 的程度, 越高受幸运效果影响就越大.
* name - (可选) 此 entry 的名称, 必须在 pool 范围中唯一.

如指定 pool 中已存在同名 entry, 返回错误.

正常时返回 void.

**addEmptyEntry(int weight, @Optional String name)**

向指定 pool 中添加一个 `empty` 类型的 entry.

* weight - 此 entry 的生成权重, 越高生成的机率越大.
* name - (可选) 此 entry 的名称, 必须在 pool 范围中唯一.

如指定 pool 中已存在同名 entry, 返回错误.

正常时返回 void.

**setRolls(float min, float max)**

设置指定 pool 被抽取次数的最大最小值

* min - 被抽取次数的最小值
* max - 被抽取次数的最大值

正常时返回 void.

**setBonusRolls(float min, float max)**

设置指定 pool 额外被抽取次数的最大最小值

* min - 被抽取次数的最小值
* max - 被抽取次数的最大值

正常时返回 void.

**clearConditions()**

清除此 pool 的所有条件.

被绑定在子 entry 上的条件不受影响.

正常时返回 void.

**clearEntries()**

清除此 pool 中的所有 entry.

正常时返回 void.

### Conditions

* 全名 : `loottweaker.vanilla.loot.Conditions`.

JSON 格式偶尔很难写, 此类型提供部分创建简单战利品条件的便利方法, 但如果想创建复杂战利品条件, 写 JSON 格式仍然是最佳选择.

`minecraft:entity_properties` 和 `minecraft:entity_scores` 是没有任何便利方法的, 因为它们太复杂了.

此分类下的所有方法, 除了 `parse()` 会创建一个参数等效于等效战利品条件的参数的原版战利品条件. 所有的原版战利品条件都将被在下方列出.

战利品函数对应的类型是 `Conditions`.

#### 方法

**randomChance(float chance)**

等价于 `minecraft:random_chance`.

* chance - 随机概率.

**randomChanceWithLooting(float chance, float lootingMult)**

等价于 `minecraft:random_chance_with_looting`.

* chance - 随机概率.
* lootingMult - 多战利品概率

**killedByPlayer()**

等价于 `minecraft:killed_by_player`.

**killedByNonPlayer()**

等价于 `inverse` 值设置为 `true` 的 `minecraft:killed_by_player`.

**parse(DataMap json)**

将一个 `DataMap` 转换为 LootCondition.

* json - `DataMap` 格式的 LootCondition.

**zenscript(loottweaker.CustomLootCondition zenFunction)**

将一个 `zenFunction` 转换为 `LootCondition`.

* zenFunction - 一个附带了 `IRandom` 和 `LootContext` 参数, 且返回 `Boolean` 值的 ZenScript 自定义函数.

如提供的 ZenScript 自定义函数返回 true, 返回一个 LootCondition.

### Functions

* 全名 : `loottweaker.vanilla.loot.Functions`.

JSON 格式偶尔很难写, 此类型提供部分创建简单战利品函数的便利方法, 但如果想创建复杂战利品函数, 写 JSON 格式仍然是最佳选择.

`minecraft:set_attributes` 是没有任何便利方法的, 因为它太复杂了.

此分类下的所有方法, 除了 `parse()` 会创建一个参数等效于等效战利品条件的参数的原版战利品参数. 所有的原版战利品参数都将被在下方列出.

战利品条件对应的类型是 `Functions`.

#### 方法

**enchantRandomly(String\[] enchantIDList)**

等价于 : `minecraft:enchant_randomly`.

* enchantIDList - 需要匹配的附魔的 ID.

当 ID 对应的附魔不存在时, 返回错误.

**enchantWithLevels(int min, int max, boolean isTreasure)**

等价于 : `minecraft:enchant_with_levels`.

* min - 最低等级
* max - 最大等级
* isTreasure - 是否为宝藏附魔

**lootingEnchantBonus(int min, int max, int limit)**

等价于 : `minecraft:looting_enchant`.

* min - 最低等级
* max - 最大等级
* limit - 额外限制量

**setCount(int min, int max)**

等价于 : `minecraft:set_count`.

* min - 最低值
* max - 最大值

**setDamage(float min, float max)**

等价于 : `minecraft:set_damage`.

* min - 最低值
* max - 最大值

当 `max` 大于 `1.0` 时, 返回错误.

**setMetadata(int min, int max)**

等价于 : `minecraft:set_data`.

* min - 最低值
* max - 最大值

**setNBT(DataMap nbtData)**

等价于 : `minecraft:set_nbt`.

* nbtData - 需要设置的 NBT.

当 nbtData 不为 `compound` 标签时, 返回错误.

**smelt()**

等价于 : `minecraft:furnace_smelt`.

**parse(DataMap json)**

将一个 `DataMap` 转换为 LootFunction.

* json - `DataMap` 格式的 LootFunction.

**zenscript(loottweaker.CustomLootCondition zenFunction)**

将一个 `zenFunction` 转换为 `LootFunction`.

* zenFunction - 一个附带了 `IItemStack`, `IRandom` 和 `LootContext` 参数, 且返回 `IItemStack` 的 ZenScript 自定义函数.

如提供的 ZenScript 自定义函数返回 true, 返回一个 LootFunction.

### LootFunction

* 全名 : `loottweaker.vanilla.loot.LootFunction`.

#### 方法

**addConditions(LootCondition\[] conditions)**

为此 LootFunction 添加 LootCondition.

* conditions - 一个 LootCondition 实例数组.

返回被调用在在的 LootFunction.

### LootContext

* 全名 : `loottweaker.LootContext`.

战利品生成的场景对象.

#### 方法

**lootedEntity()**

返回生成战利品的实体, `IEntity` 类型, 可能为空.

**killerPlayer()**

返回触发生成战利品的玩家, `IPlayer` 类型, 可能为空.

**killer()**

返回触发生成战利品的实体, `IEntity` 类型, 可能为空.

**luck()**

返回此战利品生成的幸运等级, `float` 类型.

**world()**

返回战利品生成在的世界, `IWorld` 类型, 可能为空.

**lootingModifier()**

返回此战利品生成的掠夺附魔等级. `int` 类型.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://youyi580.gitbook.io/zentutorial/advanced/loottweaker-advanced.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.