## 🧹 PickupFilter
PickupFilter 是一个强大的物品过滤拾取解决方案，具有可定制的配置文件和 GUI。
[](https://github.com/xP9nda/PickupFilter/wiki) 
### 配置文件？
- 用户可以创建配置文件，这些是单独的过滤器，允许针对不同的情境过滤不同的物品。
- 每个配置文件都是唯一的，具有其自己的过滤物品和过滤状态（白名单/黑名单）。
- 非常适合在具有各种活动的服务器中使用，例如工作。
### 关键特性
- **物品过滤：** 玩家可以精确地过滤他们想要或不想要拾取的物品。不再有杂乱的物品栏！
- **基于配置文件的：** 玩家可以使用命令或 GUI 随时创建、管理和切换配置文件。非常适合各种活动，如工作。
- **集成：** 与 EcoEnchants 和 WorldGuard 等插件的集成使其能够让像 telekinesis（自动拾取物品）之类的附魔与物品过滤器一起工作，并允许管理员设置无过滤器区域用于物品箱或派对，以确保不丢失任何物品。该插件还设计用于与 RoseStacker 等实体堆叠插件配合使用。
- **现代 GUI：** 玩家可以通过直观的 GUI 轻松编辑配置文件和过滤器，具有拖放功能、移位单击功能、易于编辑的过滤器、快速切换白名单/黑名单以及快速开启/关闭过滤器的选项。玩家无需记住冗长的命令。
- **可定制：** 所有 GUI 都可以进行定制以重新排列物品、隐藏或显示按钮、更改物品名称、lore、材质，甚至支持服务器资源包和自定义模型数据！查看 [此处](https://github.com/xP9nda/PickupFilter/wiki/Default-Config) 的配置文件以查看您有哪些控制权限！
- **智能默认值：** 当玩家没有活动配置文件时，插件将退回到原始的拾取行为。
- **快速命令：** 一系列快速命令可供玩家编辑其活动配置文件。玩家还可以使用命令从过滤器中添加或删除任何原始物品，无需将物品放在他们的物品栏中！
- **自定义物品：** 支持具有自定义 NBT 的物品，可以将它们添加到配置文件中，并且只会过滤完全匹配的物品。
- **高性能 & 轻量级**
- **持久数据存储** 使用每个用户的 JSON 文件。这些可以通过管理命令删除！
## ⚙️ 集成
### 必需的依赖项
#### WorldGuard
WorldGuard 是必需的依赖项。WorldGuard 区域的标志是 `pickup-filter`，默认情况下允许使用。
要完全禁用区域中的物品过滤器，请将标志设置为 `deny`。
在诸如箱子、派对、掉落派对等区域中完全禁用物品过滤器可能很有用，以防止任何不必要的行为。
### 其他支持
#### EcoEnchants
已添加支持，允许像 telekinesis（自动拾取物品）之类的附魔考虑物品过滤器。
#### RoseStacker
RoseStacker 支持确保在物品掉落在地上时被过滤的物品得到适当堆叠。
## ⌨️ 命令 & 权限
命令别名：
`/itemfilter`
`/if`
`/pickupfilter`
`/pf`
### 主要命令
| 命令 | 描述 | 权限 |
|:--------|:------------|:-----------|
| `/itemfilter info` | 显示关于插件的一般信息。 | 无权限 |
| `/itemfilter toggle` | 为用户开启和关闭整个物品过滤器。 | `pickupfilter.toggle` |
| `/itemfilter` | 打开一个 GUI 以查看所有配置文件，可以单击它们进行编辑。 | `pickupfilter.profiles` |
### 配置文件管理
| 命令 | 描述 | 权限 |
|:--------|:------------|:-----------|
| `/itemfilter profile create ` | 创建一个新的拾取配置文件。 (配置文件数量上限取决于 config settings.maxAllowedProfiles) | `pickupfilter.profile.create`, `pickupfilter.profile.create.max.` |
| `/itemfilter profile delete [confirmation]` | 删除一个拾取配置文件。 (如果它是活动配置文件，则需要“confirm”。) | `pickupfilter.profile.delete` |
| `/itemfilter profile use ` | 激活给定的配置。 | `pickupfilter.profile.use` |
| `/itemfilter profile rename ` | 重命名一个配置文件。 | `pickupfilter.profile.rename` |
| `/itemfilter profile mode ` | 设置配置文件的模式为白名单或黑名单。 | `pickupfilter.profile.mode` |
### 快速活动配置文件管理
| 命令 | 描述 | 权限 |
|:--------|:------------|:-----------|
| `/itemfilter add [item]` | 将当前物品（或指定的物品）添加到活动配置文件。 | `pickupfilter.add` |
| `/itemfilter remove [item]` | 将当前物品（或指定的物品）从活动配置文件中删除。 | `pickupfilter.remove` |
| `/itemfilter edit` | 打开一个 GUI 以修改活动配置文件。 | `pickupfilter.edit` |
| `/itemfilter mode ` | 将当前配置文件设置为白名单或黑名单模式。 | `pickupfilter.mode` |
### 管理员命令
| 命令 | 描述 | 权限 |
|:--------|:------------|:-----------|
| `/itemfilter admin reload` | 重新加载插件配置文件。 | `pickupfilter.admin.reload` |
| `/itemfilter admin delete ` | 删除离线玩家的所有保存的拾取和配置文件数据。 (玩家和控制台都可以运行) | `pickupfilter.admin.delete` |
#### 智能自动补全
所有命令都提供智能自动补全功能，用于配置文件名称、白名单/黑名单模式以及添加/从配置文件中删除原始物品等信息。
## 📜 配置文件
查看默认配置文件 [此处](https://github.com/xP9nda/PickupFilter/wiki/Default-Config)。
---
---
## ❓ 支持
有任何问题？加入下面的支持 Discord 并创建支持工单：
[](https://discord.gg/88j6jF5WYK)
或者，您可以使用以下邀请链接加入支持 Discord：[https://discord.gg/88j6jF5WYK](https://discord.gg/88j6jF5WYK)