From 4afc059de4ba07c38f9a48b1f45cec0922f35bd9 Mon Sep 17 00:00:00 2001
From: QiHuang02 <2830447227@qq.com>
Date: Mon, 28 Oct 2024 21:20:26 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0121=5FAddon=5FLootJS=5FAPI=5F?=
 =?UTF-8?q?ItemFilter=E3=80=81Range=E5=92=8C121=5FAddon=5FLootJS=5FModifie?=
 =?UTF-8?q?rs=5FEvent=E9=83=A8=E5=88=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Addon/LootJs/API/ItemFilter.md            | 284 ++++++++++++++++++
 .../Introduction/Addon/LootJs/API/Range.md    |  22 ++
 .../Addon/LootJs/LootModifiers/Event.md       | 151 ++++++++++
 docs/zh/modpack/kubejs/1.21/index.md          |  45 +++
 4 files changed, 502 insertions(+)
 create mode 100644 docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/LootModifiers/Event.md

diff --git a/docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/API/ItemFilter.md b/docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/API/ItemFilter.md
index e69de29bb..f0763880c 100644
--- a/docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/API/ItemFilter.md
+++ b/docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/API/ItemFilter.md
@@ -0,0 +1,284 @@
+# 物品过滤器 ItemFilter
+
+物品过滤器是 LootJS 中的一个重要使用工具。主要用于根据给定的条件过滤物品。
+
+在任何可以使用物品过滤器作为参数的地方，我们都可以简单的使用物品的id作为字符串或者标签传递参数，LootJS将会自动为其创建物品过滤器。
+
+## armor
+
+如果该物品是armor类物品则会被匹配。
+
+::: v-info
+
+当一些模组的物品不是使用原版armor系统，而是使用自己创建的armor类物品时，这些物品不会被匹配到。
+
+:::
+
+语法：
+
+- `ItemFilter.ARMOR`
+
+## blockItem
+
+如果该物品是 block item 时可以被匹配。
+
+语法：
+
+- `ItemFilter.BLOCK_ITEM`
+
+## custom
+
+你可以创建自定义的物品过滤器。
+
+语法：
+
+- `ItemFilter.custom(filter: (item: ItemStack) => boolean)`
+
+```js
+// 当物品id为 minecraft:apple 时会被匹配。
+ItemFilter.custom(item => item.id === "minecraft:apple")
+
+// 当物品拥有 #c:ores 标签并且数量大于 16 时会被匹配。
+ItemFilter.custom(item => {
+    if (item.hasTag("#c:ores")) {
+        return true
+    }
+
+    return item.count > 16
+})
+```
+
+## damageable
+
+如果物品可以被损坏则会被匹配。
+
+语法：
+
+- `ItemFilter.DAMAGEABLE`
+
+## damaged
+
+如果物品已经损坏则会被匹配。
+
+语法：
+
+- `ItemFilter.DAMAGED`
+
+## edible
+
+如果物品可以被使用则会被匹配。
+
+语法：
+
+- `ItemFilter.EDIBLE`
+
+## enchanted
+
+如果该物品已经被附魔则会被匹配。
+
+语法：
+
+- `temFilter.ENCHANTED`
+
+## empty
+
+检查该物品是否为空。
+
+语法：
+
+- `ItemFilter.EMPTY`
+
+## equipmentSlot
+
+如果物品在特定的装备槽位则匹配。目前支持检测的槽位有： `mainhand` 、 `offhand` 、 `head` 、 `chest` 、 `legs` 、 `fee"`。
+
+语法：
+
+- `ItemFilter.equipmentSlot(slot: string | EquipmentSlot)`
+
+```js
+ItemFilter.equipmentSlot("mainhand")
+```
+
+## equipmentSlotGroup
+
+如果物品位于特定装备组中则匹配。现有组： `any` 、 `mainhand` 、 `offhand` 、 `hand` 、 `feet` 、 `legs` 、 `chest` 、 `head` 、 `armor`。
+
+语法：
+
+- `ItemFilter.equipmentSlotGroup(slot: string | EquipmentSlotGroup)`
+
+```js
+ItemFilter.equipmentSlotGroup("armor")
+```
+
+## hasEnchantment
+
+用于检查给定的物品是否与附魔相匹配。
+
+语法：
+
+- `ItemFilter.hasEnchantment(filter)`
+- `ItemFilter.hasEnchantment(filter, levelRange: Range)` ,关于 Range
+
+::: code-group
+
+```js [仅匹配附魔]
+ItemFilter.hasEnchantment("minecraft:fortune")
+
+```
+
+```js [通过模组匹配]
+// 匹配所有来自 `minecraft` 的附魔
+ItemFilter.hasEnchantment("@minecraft")
+```
+
+```js [通过一个数组中有的附魔匹配]
+// 匹配数组中有的所有附魔
+ItemFilter.hasEnchantment(["minecraft:fortune", "minecraft:mending"])
+```
+
+```js [通过附魔等级匹配]
+// 匹配2-3级的耐久附魔
+ItemFilter.hasEnchantment("minecraft:unbreaking", [2, 3])
+```
+
+:::
+
+## hasStoredEnchantment
+
+用于检查给定的附魔书具有的附魔相匹配。
+
+语法：
+
+- `ItemFilter.hasStoredEnchantment(filter)`
+- `ItemFilter.hasStoredEnchantment(filter, levelBound: Range)` 关于 Range
+
+::: code-group
+
+```js [仅匹配附魔]
+ItemFilter.hasStoredEnchantment("minecraft:fortune")
+
+```
+
+```js [通过模组匹配]
+// 匹配所有来自 `minecraft` 的附魔
+ItemFilter.hasStoredEnchantment("@minecraft")
+```
+
+```js [通过一个数组中有的附魔匹配]
+// 匹配数组中有的所有附魔
+ItemFilter.hasStoredEnchantment(["minecraft:fortune", "minecraft:mending"])
+```
+
+```js [通过附魔等级匹配]
+// 匹配2-3级的耐久附魔
+ItemFilter.hasStoredEnchantment("minecraft:unbreaking", [2, 3])
+```
+
+:::
+
+## item
+
+如果物品匹配则匹配。这不能检测物品的数量，但可以同时检测组件。
+
+- `ItemFilter.item(item: ItemStack | string)`
+- `ItemFilter.item(item: ItemStack | string, matchComponents: boolean)`
+
+## not/negate
+
+反转过滤器。如果过滤器不匹配则匹配。
+
+语法：
+
+- `ItemFilter.not(filter: ItemFilter)`
+- `anyFilter.negate()` 这里的 `anyFilter` 不是指有该过滤器，而是本教程提到的过滤器。
+
+```js
+ItemFilter.not(ItemFilter.hasEnchantment("minecraft:fortune"))
+
+ItemFilter.hasEnchantment("minecraft:fortune").negate()
+```
+
+## tag
+
+如果物品具有特定标签，则匹配。
+
+语法：
+
+- `ItemFilter.tag(tag: string)`
+
+## toolAction
+
+NeoForge 添加了一个名为 ToolAction 东西，它可以用来确定一个物品是否可以执行特定的动作。一些模组将其用于多功能工具。
+
+如果所有动作都存在，则匹配。
+
+语法：
+
+- `ItemFilter.toolAction(...action)`
+- `ItemFilter.anyToolAction(...action)`
+
+::: code-group
+
+```js [仅匹配一个动作]
+ItemFilter.toolAction("pickaxe_dig")
+
+ItemFilter.anyToolAction("pickaxe_dig")
+```
+
+```js [匹配多个动作]
+ItemFilter.toolAction("pickaxe_dig", "shovel_dig")
+
+ItemFilter.anyToolAction("pickaxe_dig", "shovel_dig")
+```
+
+:::
+
+## 组合匹配
+
+### allOf
+
+将多个物品过滤器合并为一个。如果所有过滤器都匹配则匹配。
+
+语法：
+
+- `ItemFilter.allOf(...filters: ItemFilter[])`
+
+```js
+ItemFilter.allOf(
+    ItemFilter.hasEnchantment("minecraft:fortune"), 
+    ItemFilter.equipmentSlotGroup("hand")
+)
+```
+
+### anyOf
+
+将多个物品过滤器合并为一个。如果至少有一个过滤器匹配则匹配。
+
+语法：
+
+- `ItemFilter.anyOf(...filters: ItemFilter[])`
+
+```js
+ItemFilter.anyOf(
+    ItemFilter.hasEnchantment("minecraft:silk_touch"),
+    ItemFilter.equipmentSlotGroup("armor")
+)
+```
+
+### all
+
+一个返回匹配所有物品的过滤器。
+
+语法：
+
+- `ItemFilter.ALL`
+
+### none
+
+一个返回不匹配所有物品的过滤器。
+
+语法：
+
+- `ItemFilter.NONE`
diff --git a/docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/API/Range.md b/docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/API/Range.md
index e69de29bb..43a03614e 100644
--- a/docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/API/Range.md
+++ b/docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/API/Range.md
@@ -0,0 +1,22 @@
+# Range
+
+在使用 LootJS 时，我们经常需要指定两个值之间的范围。对于这些情况，我们有 `Range` 。当函数需要 `Range` 时，我们可以通过直接向函数传递 `number` 或 `number[]` 来轻松使用类型包装器。
+
+语法：
+
+- `Range.exactly(value: number)`
+- `Range.atLeast(value: number)`
+- `Range.atMost(value: number)`
+- `Range.between(min: number, max: number)`
+
+```js
+const condition = LootCondition.distance(10)
+```
+
+```js
+const condition = LootCondition.distance([0, 10])
+```
+
+```js
+const condition = LootCondition.distance(Range.atLeast(20))
+```
diff --git a/docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/LootModifiers/Event.md b/docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/LootModifiers/Event.md
new file mode 100644
index 000000000..f94eb67ff
--- /dev/null
+++ b/docs/zh/modpack/kubejs/1.21/Introduction/Addon/LootJs/LootModifiers/Event.md
@@ -0,0 +1,151 @@
+# Loot Modification Event
+
+该事件用于创建战利品修改器，这些修改器用于修改滚动战利品表后直接生成的物品。也就是说他不直接修改战利品表，而是修改战利品表最后生成的物品。
+
+## getGlobalModifiers
+
+返回所有由模组注册的全局战利品修改器列表。
+
+语法：
+
+- `.getGlobalModifiers()`
+
+## removeGlobalModifiers
+
+删除所有由指定过滤器指定的模组注册的全局战利品修改器。
+
+语法：
+
+- `.removeGlobalModifiers(filter: string | regex)`
+
+## addTableModifier
+
+为所有与给指定过滤器匹配的战利品表创建战利品修改器。
+
+语法：
+
+- `.addTableModifier(filter: string | string[] | regex)` ，返回一个LootModifier
+
+::: code-group
+
+```js [使用过滤器]
+LootJS.modifiers(event => {
+    event
+        .addTableModifier("minecraft:chests/simple_dungeon")
+        .randomChance(0.5)
+        .addLoot("minecraft:gunpowder")
+})
+```
+
+```js [支持正则表达式]
+LootJS.modifiers(event => {
+    event
+        .addTableModifier(/minecraft:chests:.*/)
+        .randomChance(0.5)
+        .addLoot("minecraft:gunpowder")
+})
+```
+
+:::
+
+## addTypeModifier
+
+为给定的战利品类型添加新的类型修改器。有效的战利品表类型有 `chest` 、 `block` 、 `entity` 、 `fishing` 、 `archaeology` 、 `gift` 、 `vault` 、 `shearing` 、 `piglin_barter`
+
+语法:
+
+- `.addTypeModifier(type: LootType)` ，返回一个LootModifier
+
+::: code-group
+
+```js [支持添加一个]
+LootJS.modifiers(event => {
+    event.addTypeModifier("chest")
+         .randomChance(0.5)
+         .addLoot("minecraft:gunpowder")
+})
+```
+
+```js [也支持添加多个]
+LootJS.modifiers(event => {
+    event.addTypeModifier("block", "entity")
+         .randomChance(0.5)
+         .addLoot("minecraft:gunpowder")
+})
+```
+
+:::
+
+## addEntityModifier
+
+为与指定过滤器匹配的所有实体添加新的战利品修改器。
+
+语法：
+
+- `.addEntityModifier(filter: string | string[] | tag)` ，返回一个LootModifier
+
+::: code-group
+
+```js [支持直接使用过滤器]
+LootJS.modifiers(event => {
+    event.addEntityModifier("minecraft:creeper")
+         .randomChance(0.5)
+         .addLoot("minecraft:gunpowder")
+})
+```
+
+```js [也支持使用过滤器数组]
+LootJS.modifiers(event => {
+    event
+        .addEntityModifier(["minecraft:cow", "minecraft:pig"])
+        .randomChance(0.5)
+        .addLoot("minecraft:gold_nugget")
+})
+```
+
+```js [也支持使用标签过滤器]
+LootJS.modifiers(event => {
+    event.addEntityModifier("#minecraft:skeletons")
+         .randomChance(0.5)
+         .addLoot("minecraft:stick")
+})
+```
+
+:::
+
+## addBlockModifier
+
+为与指定过滤器匹配的所有方块添加新的战利品修改器。
+
+语法：
+
+- `.addBlockModifier(filter: string | string[] | regex | tag)` ，返回一个LootModifier
+
+::: code-group
+
+```js [支持直接使用过滤器]
+LootJS.modifiers(event => {
+    event.addBlockModifier("minecraft:iron_ore")
+         .randomChance(0.5)
+         .addLoot("minecraft:iron_nugget")
+})
+```
+
+```js [也支持使用过滤器数组]
+LootJS.modifiers(event => {
+    event
+        .addBlockModifier(["minecraft:gravel", "minecraft:dirt"])
+        .randomChance(0.5)
+        .addLoot("minecraft:gold_nugget")
+})
+```
+
+```js [也支持使用标签]
+LootJS.modifiers(event => {
+    event.addBlockModifier("#c:ores")
+         .randomChance(0.5)
+         .addLoot("minecraft:flint")
+})
+```
+
+:::
diff --git a/docs/zh/modpack/kubejs/1.21/index.md b/docs/zh/modpack/kubejs/1.21/index.md
index b7e02dd59..06d9fda7b 100644
--- a/docs/zh/modpack/kubejs/1.21/index.md
+++ b/docs/zh/modpack/kubejs/1.21/index.md
@@ -48,6 +48,51 @@ root:
                     - title: Create
                       path: /
                       file: Create
+                - title: LootModifiers
+                  path: LootModifiers
+                  collapsed: true
+                  children:
+                    - title: Event
+                      path: /
+                      file: Event
+                - title: API
+                  path: API
+                  collapsed: true
+                  children:
+                    - title: ItemFilter
+                      path: /
+                      file: ItemFilter
+                    - title: LootTable
+                      path: /
+                      file: LootTable
+                    - title: LootPool
+                      path: /
+                      file: LootPool
+                    - title: LootEntry
+                      path: /
+                      file: LootEntry
+                    - title: LootEntryTransformer
+                      path: /
+                      file: LootEntryTransformer
+                    - title: LootConditions
+                      path: /
+                      file: LootConditions
+                    - title: LootFunctions
+                      path: /
+                      file: LootFunctions
+                    - title: LootModifier
+                      path: /
+                      file: LootModifier
+                    - title: LootContext
+                      path: /
+                      file: LootContext
+                    - title: NumberProvider
+                      path: /
+                      file: NumberProvider
+                    - title: Range
+                      path: /
+                      file: Range
+                      
 prev: false
 next: false
 ---