
bItemFilter 是一款面向 Spigot 和 Paper 服务器的玩家个人物品拾取过滤器。每位玩家管理自己独立的过滤列表,一名玩家设置的屏蔽项不会影响其他任何人。
在 Modrinth 上下载!
Discord / 支持
加入社区以获取支持和更新信息。
工作原理
两种模式,任你选择:
黑名单:列表中的物品会留在地面上,其他物品正常拾取。适合屏蔽腐肉或沙砾等垃圾掉落物。
白名单:仅拾取列表中的物品,其他物品会被忽略。适合硬核刷怪者,只想要特定的掉落物。
玩家可以切换模式、开启/关闭过滤器而不会丢失列表,并通过图形界面(GUI)或命令进行管理。过滤器数据保存在 SQLite 中,重启后依然保留。
图形界面
使用 /ifilter 打开。所有内容均可点击:
| 槽位 |
功能 |
| 第 1-4 行 |
当前在你的过滤器中的物品。点击任意一个即可将其移除。 |
| 你的背包 |
点击你手持的任意物品即可添加或从过滤器中移除,无需命令。 |
| 槽位 47 |
模式按钮,在黑名单和白名单之间切换。 |
| 槽位 49 |
开关按钮,启用或禁用过滤器而不清空列表。 |
| 槽位 51 |
清除按钮,Shift+左键点击即可清空列表。 |
| 槽位 45, 53 |
箭头按钮,当条目超过 36 个时用于翻页导航。 |
在 1.20.5+ 版本中,图形界面的标题和按钮名称将以 Unicode 小型大写字母渲染。
命令
所有别名效果相同:/bitemfilter、/itemfilter、/ifilter、/filter。
| 命令 |
功能 |
/ifilter |
打开图形界面 |
/ifilter toggle |
启用或禁用你的过滤器 |
/ifilter mode |
切换黑名单/白名单模式 |
/ifilter add [material] |
添加你手中的物品,或直接输入物品名称 |
/ifilter remove <material> |
从过滤器中移除指定物品 |
/ifilter list |
在聊天栏列出你过滤的物品 |
/ifilter clear |
清空整个过滤器 |
/ifilter help |
显示命令参考帮助 |
管理员命令
需要 bitemfilter.admin 权限。
| 命令 |
功能 |
/ifilter admin clear <player> |
清空另一名玩家的过滤器 |
/ifilter admin list <player> |
查看另一名玩家的过滤器 |
/ifilter admin toggle <player> |
切换另一名玩家的过滤器状态 |
/ifilter reload |
从磁盘重新加载配置文件 |
权限
| 权限 |
默认分配 |
描述 |
bitemfilter.use |
所有人 |
使用过滤器和个人命令 |
bitemfilter.admin |
op (管理员) |
使用管理员命令及接收更新通知 |
配置
config.yml 中的所有设置均可自定义:所有消息均支持 & 颜色代码和 %prefix% 占位符;每个 GUI 按钮的材质和描述文本均可修改,帮助部分的文本也是可编辑的列表。默认模式、默认启用状态以及每位玩家的物品上限均为全局设置。
兼容性
- Minecraft 1.8+:在 1.12 之前版本使用
PlayerPickupItemEvent,在 1.12 及之后版本使用 EntityPickupItemEvent,启动时自动检测
- 兼容 Spigot 和 Paper
- 不与其他拾取或经济类插件冲突:以
NORMAL 优先级取消事件,并尊重已被取消的事件

bItemFilter is a per-player item pickup filter for Spigot and Paper servers. Each player manages their own independent filter what one player blocks doesn't affect anyone else.
Download on Modrinth!
Discord / Support
Join the community for support and updates.
How it works
Two modes, pick your poison:
Blacklist items on the list stay on the ground. Everything else is picked up normally. Good for blocking junk like rotten flesh or gravel.
Whitelist only items on the list get picked up. Everything else is ignored. Good for hardcore grinders who only want specific drops.
Players can switch modes, toggle the filter on/off without losing their list, and manage everything from a GUI or commands. Filters are saved to SQLite and survive restarts.
GUI
Open with /ifilter. Everything is clickable:
| Slot |
What it does |
| Rows 1-4 |
Items currently in your filter. Click any to remove it. |
| Your inventory |
Click any item you're holding to add or remove it from the filter no commands needed. |
| Slot 47 |
Mode button switch between Blacklist and Whitelist. |
| Slot 49 |
Toggle button enable or disable the filter without clearing it. |
| Slot 51 |
Clear button shift-click to wipe the list. |
| Slots 45, 53 |
Arrows page navigation for more than 36 entries. |
On 1.20.5+ the GUI title and button names render in Unicode small caps.
Commands
All aliases work the same: /bitemfilter, /itemfilter, /ifilter, /filter.
| Command |
What it does |
/ifilter |
Open the GUI |
/ifilter toggle |
Enable or disable your filter |
/ifilter mode |
Switch blacklist / whitelist |
/ifilter add [material] |
Add the item in your hand, or name one |
/ifilter remove <material> |
Remove an item from the filter |
/ifilter list |
List your filtered items in chat |
/ifilter clear |
Clear the entire filter |
/ifilter help |
Show command reference |
Admin commands
Require bitemfilter.admin.
| Command |
What it does |
/ifilter admin clear <player> |
Clear another player's filter |
/ifilter admin list <player> |
View another player's filter |
/ifilter admin toggle <player> |
Toggle another player's filter |
/ifilter reload |
Reload config from disk |
Permissions
| Permission |
Default |
Description |
bitemfilter.use |
everyone |
Use the filter and personal commands |
bitemfilter.admin |
op |
Admin commands and update notifications |
Configuration
Everything in config.yml is configurable: all messages support & color codes and a %prefix% placeholder, every GUI button's material and lore can be changed, and the help sections are editable lists. The default mode, default enabled state, and per-player item cap are set globally.
Compatibility
- Minecraft 1.8+ uses
PlayerPickupItemEvent on pre-1.12, EntityPickupItemEvent on 1.12+, detected automatically at startup
- Spigot and Paper
- Does not conflict with other pickup or economy plugins cancels at
NORMAL priority and respects already-cancelled events
License
bItemFilter is free and open source under the GNU General Public License v3.0.
评论 0
登录后参与评分
还没有评论,来抢沙发吧