
HopperFilterX
一款轻量级、多语言的 Minecraft 插件,允许你通过简单的游戏内 GUI 来过滤漏斗(Hopper)可以拾取的物品。专为性能优化、生存模式和技术服设计。
? 功能特性
/hopper give <player> [amount]: 向玩家发放带有过滤功能的特殊漏斗。/hopper remove <player> <uuid>: 从玩家或世界中移除已过滤的漏斗。/hopper list <player>: 列出某玩家拥有的所有过滤漏斗。/hopper addperm <player> <uuid>: 授予玩家访问你的过滤漏斗的权限。/hopper removeperm <player> <uuid>: 移除玩家对你过滤漏斗的访问权限。/hopper reload: 重新加载插件的配置和语言文件。- ? 过滤系统:Shift + 右键点击 HopperFilterX 漏斗以打开 GUI。
- ? 拖放物品:将任意物品拖入 GUI 中以定义漏斗的过滤规则。
- ✅ 选择性物品移动:漏斗仅会移动符合过滤条件的物品。
- ? 回退行为:如果未定义过滤规则,其表现如同原版普通漏斗。
- ? 无缝集成原版机制:兼容所有原版机制及漏斗功能。
- ?️ 持久化过滤器:即使服务器重启,过滤设置也会被保存并恢复。
- ?️ 所有者保护:只有漏斗的所有者才能拾取或配置自己的过滤漏斗。
- ?️ 创造/生存模式支持:安全处理创造模式与生存模式之间的切换。
- ?️ 多语言支持:详情请见下文。
?️ 支持的 Minecraft 版本(使用 PaperLib 以确保兼容性)
- Paper/Spigot 1.14.x
- Paper/Spigot 1.15.x
- Paper/Spigot 1.16.x
- Paper/Spigot 1.17.x
- Paper/Spigot 1.18.x
- Paper/Spigot 1.19.x
- Paper/Spigot 1.20.x
- Paper/Spigot 1.21.x
? 多语言支持
HopperFilterX 已完全翻译,准备好服务于国际服务器。目前支持以下语言:
- 英语
- 西班牙语
- 德语
- 法语
- 葡萄牙语
- 俄语
- 简体中文
插件会根据玩家的 Minecraft 客户端设置自动检测语言。所有消息均可在 lang.yml 中进行自定义编辑。
⚙️ 配置说明
config.yml允许启用调试模式以获取详细的日志记录。lang.yml包含所有可翻译的消息,并可编辑以支持自定义语言。
?️ 命令列表
| 命令 | 描述 |
|---|---|
/hopper give <player> [amount] |
向玩家发放过滤漏斗 |
/hopper remove <player> <uuid> |
从玩家/世界中移除过滤漏斗 |
/hopper list <player> |
列出玩家拥有的所有过滤漏斗 |
/hopper addperm <player> <uuid> |
授予玩家访问你的过滤漏斗的权限 |
/hopper removeperm <player> <uuid> |
移除玩家对你过滤漏斗的访问权限 |
/hopper reload |
重新加载插件配置和语言文件 |
? 权限节点
| 权限节点 | 描述 |
|---|---|
hopperfilterx.use |
允许玩家使用过滤 GUI |
hopperfilterx.give |
允许使用 /hopper give 命令 |
hopperfilterx.remove |
允许使用 /hopper remove 命令 |
hopperfilterx.list |
允许使用 /hopper list 命令 |
hopperfilterx.addperm |
允许使用 /hopper addperm 命令 |
hopperfilterx.removeperm |
允许使用 /hopper removeperm 命令 |
hopperfilterx.reload |
允许通过命令重新加载插件 |
hopperfilterx.* |
授予所有 HopperFilterX 权限 |
? 工作原理
- 使用
/hopper give <player> [amount]给予玩家一个特殊的漏斗。 - 像放置普通漏斗一样放置它。
- Shift + 右键点击该漏斗以打开过滤 GUI。
- 添加你希望漏斗接受的物品。
- 现在漏斗只会移动所选物品。如果过滤为空,则按原版逻辑工作。
? 权限系统
HopperFilterX 内置了一个权限系统,允许你将过滤漏斗的访问权限共享给其他玩家:
- 授予访问权限:使用
/hopper addperm <player> <uuid>允许另一名玩家使用你的过滤漏斗- 不带 UUID:授予对你当前和未来所有过滤漏斗的访问权限
- 带 UUID:仅授予对特定漏斗的访问权限
- 撤销访问权限:使用
/hopper removeperm <player> <uuid>移除玩家的访问权限 - 所有者保护:只有漏斗所有者才能修改过滤规则和管理工作权限
- 持久化存储:权限保存在数据库中,并在服务器重启后保持不变
? 应用场景
- 创建自动化物品分类器。
- 防止在复杂的红石系统中拾取特定物品。
- 轻松搭建精炼农场和存储系统。
? 演示
? 技术与法律信息
- 许可证: GPL-3.0-only(详见 LICENSE 文件)
- 作者: MrH00k
- 数据库: 使用 SQLite 进行持久化的过滤存储。
- 不抑制静态分析警告: 所有警告均保持可见,以便维护。
- 无需外部依赖(除用于版本兼容性的 PaperLib 外)。
像专业人士一样整理你的漏斗——使用 HopperFilterX!

HopperFilterX
A lightweight, multilingual Minecraft plugin that lets you filter what hoppers can pick up using a simple in-game GUI. Designed for performance, survival, and technical servers.
? Features
/hopper give <player> [amount]: Give special filter-enabled hoppers to players./hopper remove <player> <uuid>: Remove a filtered hopper from a player or the world./hopper list <player>: List all filtered hoppers owned by a player./hopper addperm <player> <uuid>: Grant players access to your filtered hoppers./hopper removeperm <player> <uuid>: Remove player access from your filtered hoppers./hopper reload: Reload the plugin's configuration and language files.- ? Filter System: Shift + right-click a HopperFilterX hopper to open a GUI.
- ? Drag and Drop Items: Insert any items into the GUI to define the hopper’s filter.
- ✅ Selective Item Movement: Hopper will only move items matching the filter.
- ? Fallback Behavior: If no filter is defined, it behaves like a regular vanilla hopper.
- ? Seamless vanilla integration: Works with all vanilla mechanics and hoppers.
- ?️ Persistent Filters: Filter settings are saved and restored even after server restarts.
- ?️ Owner Protection: Only the owner can pick up or configure their filtered hoppers.
- ?️ Creative/Survival Support: Handles creative/survival mode transitions safely.
- ?️ Multilanguage: See below for details.
?️ Supported Minecraft Versions (uses PaperLib for compatibility)
- Paper/Spigot 1.14.x
- Paper/Spigot 1.15.x
- Paper/Spigot 1.16.x
- Paper/Spigot 1.17.x
- Paper/Spigot 1.18.x
- Paper/Spigot 1.19.x
- Paper/Spigot 1.20.x
- Paper/Spigot 1.21.x
? Multilanguage Support
HopperFilterX is fully translated and ready for international servers. It currently supports:
- English
- Spanish
- German
- French
- Portuguese
- Russian
- Simplified Chinese
The plugin automatically detects the player’s language based on their Minecraft client settings. All messages are customizable in lang.yml.
⚙️ Configuration
config.ymlallows enabling debug mode for detailed logging.lang.ymlcontains all translatable messages and can be edited for custom language support.
?️ Commands
| Command | Description |
|---|---|
/hopper give <player> [amount] |
Give filter hoppers to a player |
/hopper remove <player> <uuid> |
Remove a filtered hopper from a player/world |
/hopper list <player> |
List all filtered hoppers owned by a player |
/hopper addperm <player> <uuid> |
Grant a player access to your filtered hoppers |
/hopper removeperm <player> <uuid> |
Remove a player's access from your filtered hoppers |
/hopper reload |
Reload plugin configuration and language |
? Permissions
| Node | Description |
|---|---|
hopperfilterx.use |
Allows players to use the filter GUI |
hopperfilterx.give |
Allows use of the /hopper give command |
hopperfilterx.remove |
Allows use of the /hopper remove command |
hopperfilterx.list |
Allows use of the /hopper list command |
hopperfilterx.addperm |
Allows use of the /hopper addperm command |
hopperfilterx.removeperm |
Allows use of the /hopper removeperm command |
hopperfilterx.reload |
Allows reloading the plugin via command |
hopperfilterx.* |
Grants all HopperFilterX permissions |
? How it Works
- Use
/hopper give <player> [amount]to give a player a special hopper. - Place the hopper like any normal one.
- Shift + Right-Click on it to open the filter GUI.
- Add items you want the hopper to accept.
- The hopper will now only move the selected items. If the filter is empty, it works like vanilla.
? Permission System
HopperFilterX includes a built-in permission system that allows you to share access to your filtered hoppers with other players:
- Grant Access: Use
/hopper addperm <player> <uuid>to allow another player to use your filtered hoppers- Without UUID: Grants access to all your current and future filtered hoppers
- With UUID: Grants access only to a specific hopper
- Revoke Access: Use
/hopper removeperm <player> <uuid>to remove a player's access - Owner Protection: Only the hopper owner can modify filters and manage permissions
- Persistent: Permissions are saved in the database and persist across server restarts
? Use Cases
- Create automated item sorters.
- Prevent specific items from being picked up in complex redstone systems.
- Set up refined farms and storage systems with ease.
? Demonstration
? Technical & Legal
- License: GPL-3.0-only (see LICENSE)
- Author: MrH00k
- Database: Uses SQLite for persistent filter storage.
- No suppression of static analysis warnings: All warnings remain visible for maintainability.
- No external dependencies required (except PaperLib for version compatibility).
Start organizing your hoppers like a pro — with HopperFilterX!
下载 HopperFilterX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HopperFilterX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HopperFilterX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HopperFilterX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HopperFilterX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HopperFilterX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HopperFilterX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HopperFilterX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
更新日志
[HopperFilterX-0.1.1-BETA-1.21.7-UPDATE] - 2025年7月2日
新增
- 添加了无需打开 GUI 即可将物品栏方块放入漏斗的解决方案。
- 添加了权限验证,确保用户仅能看到其可用的命令,而管理员(operators)则可以看到所有命令。
- 更新了命令补全功能以反映这些权限变更。
改进
- 改进了版本验证机制。
- 优化了插件内的所有文本内容,使其更易于理解且行文流畅。
- 改进了
addperm和removeperm命令的权限设置,允许非管理员用户在各自的漏斗上使用这些命令而不会出现问题。 - 更新了
list命令的权限,使普通用户也能使用该命令查看自己的漏斗。 - 对插件进行了全面的改进。
修复
- 修复了与效果和音效相关的已知问题。
- 修复了 Java 版本兼容性问题。
- 解决了因放置漏斗物品栏方块而导致无法打开 GUI 的问题。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧