Item Filter 适用于 Spigot/Paper(AI 辅助)
这是 KawaMood 原始 Items Filter 数据包的替代插件版本。
如果你的服务器使用了 GriefPrevention、WorldGuard 或 Towny,你可能会遇到原版数据包导致的物品复制漏洞或领地保护冲突问题。本插件完全重写了系统机制,使其与你常用的区域保护功能完全兼容。
✨ 特性
- 简单过滤: 轻松选择自动化分拣系统中允许或禁止的物品。
- 每个过滤器的溢出 GUI: Shift + 右键点击任意过滤器可在 4 种模式 之间切换:
CONTINUE(绿色混凝土块):如果存储空间已满,则忽略该过滤器。
BLOCK(红色混凝土块):如果存储空间已满,则冻结漏斗。
DROP(蓝色混凝土块):将物品掉落至过滤器下方的地面上。
TRASH(黑色混凝土块)[新增]:立即在源头永久销毁物品。
- 完整的多语言 (i18n) 系统: 支持原生本地化(EN/FR),自定义文件位于
plugins/ItemsFilter/Message/ 内。
- 安装简便: 只需将文件放入你的
plugins 文件夹并重启服务器即可。
? 致谢与来源
本项目基于 KawaMood 创建的 "Items Filter" 数据包的原始概念。
为了将此概念转化为插件并修复区域保护相关的漏洞,本项目在 AI 的协助下开发完成。
? 安装与迁移
- 下载
.jar 文件。
- ⚠️ 迁移注意: 如果是从旧版本升级,必须在放置新文件之前删除
plugins/ 文件夹中的旧 JAR 文件,以避免配置损坏。
- 将新的 JAR 文件放入服务器的
plugins 文件夹中。
- 重启服务器。
- (可选) 你可以修改插件文件夹中生成的配置文件和本地化文件。
? 媒体与文档
该插件的功能与原数据包完全一致。要了解如何使用它并探索所有过滤可能性,请参阅 KawaMood 制作的视频和文档:
- 解说视频: 在 YouTube 上观看
- 文档与原始概念: 原项目页面
? 命令与权限
主命令: /itemsfilter(别名:/if, /itemfilter)
公共命令(默认 true)
| 命令 |
描述 |
权限 |
/if help |
显示完整的重新设计的分节帮助指南([Commands]、[How to Use] 等) |
itemsfilter.help |
/if recipe |
给予一本包含溢出 GUI 使用说明的 5 页配方书 |
itemsfilter.command.recipe |
管理员核心命令(默认 op)
| 命令 |
描述 |
权限 |
/if info |
选中一个过滤器 → 显示其模式(宽松/严格)、所有者、位置以及 已传输物品计数器 |
itemsfilter.command.info |
/if debug |
选中一个过滤器 → 完整诊断:计数器、库存实时预览、剩余冷却时间 |
itemsfilter.command.debug |
/if give [player] |
给予一个 Items Filter。如果未指定玩家,则给予给自己 |
itemsfilter.command.give |
/if cooldown <ticks> |
设置传输冷却时间(以刻为单位,默认为 8) |
itemsfilter.command.cooldown |
/if list |
列出当前世界(或从控制台列出所有世界)中加载的所有过滤器 |
itemsfilter.command.list |
/if reload |
重载配置 + 重启刻度任务 + 重新生成缺失的展示实体 |
itemsfilter.command.reload |
区块管理
| 命令 |
描述 |
权限 |
/if chunkload on |
启用 keep-chunks-loaded(过滤器将保持其所在区块加载状态) |
itemsfilter.command.chunkload |
/if chunkload off |
禁用 keep-chunks-loaded 并 移除所有活动的区块票据 |
itemsfilter.command.chunkload |
/if chunkload list |
列出当前由插件保持加载状态的所有区块 |
itemsfilter.command.chunkload |
/if chunkload status |
显示刻度配置状态和活动票据数量 |
itemsfilter.command.chunkload |
/if chunkload add <world> <chunkX> <chunkZ> |
手动添加一个区块票据 |
itemsfilter.command.chunkload |
/if chunkload remove <world> <chunkX> <chunkZ> |
手动移除一个区块票据 |
itemsfilter.command.chunkload |
卸载
| 命令 |
描述 |
权限 |
/if uninstall |
显示确认消息,包含要删除的过滤器总数 |
itemsfilter.command.uninstall |
/if uninstall confirm |
确认并执行彻底删除(过滤器 + 实体 + 配置) |
itemsfilter.command.uninstall |
关于 /if uninstall confirm 的注意事项: 强制同步加载区块以清理所有展示/交互实体,清除 filters.yml,并移除活动票据。雕纹深板岩方块会保留在地图上,需手动破坏。
杂项与标签补全
itemsfilter.use(默认:true)- 允许放置 Items Filter。
itemsfilter.craft(默认:true)- 允许合成 Items Filter。
itemsfilter.break(默认:true)- 允许破坏 Items Filter(GriefPrevention/WorldGuard/Towny 仍具有优先权)。
itemsfilter.overflow(默认:true)- 允许玩家与每个过滤器的溢出 GUI 进行交互。
- 标签补全: 完全支持子命令、在线玩家名称和世界名称的自动补全。
================================================================================
?? 法语版本
Item Filter 的插件版本。
如果您在服务器上使用了 GriefPrevention、WorldGuard 或 Towny,您可能会遇到原版存在的物品复制漏洞。此插件替换了系统原有的运行机制,使其与您常用的保护机制兼容。
✨ 功能特性
- 简单过滤: 轻松选择哪些物品应在您的分类系统中通过或被拦截。
- 溢出过滤菜单: 按住 Shift + 右键点击任意过滤器,可在 4 种模式 之间切换:
CONTINUE(绿色混凝土):如果存储空间已满,则忽略该过滤器。
BLOCK(红色混凝土):如果存储空间已满,则阻止漏斗运作。
DROP(蓝色混凝土):将物品从过滤器下方掉落至地面。
TRASH(黑色混凝土)[新增]:在源头立即且永久地销毁物品。
- 完整的 i18n 国际化系统: 原生支持多语言(FR/EN),配置文件位于
plugins/ItemsFilter/Message/,可自行修改。
- 安装简便: 只需将文件放入
plugins 文件夹并重启服务器即可。
? 致谢与来源
本项目基于 KawaMood 创建的数据包 "Items Filter" 的原始创意。
为了将此概念转化为插件并修复遇到的 bug,本项目在 AI 的帮助下完成开发。
? 安装与迁移
- 下载
.jar 文件。
- ⚠️ 迁移注意: 如果您是从旧版本升级,必须先删除
plugins/ 文件夹中的旧 JAR 文件,再放入新文件,以避免数据损坏。
- 将新的 JAR 文件放入服务器的
plugins 文件夹中。
- 重启服务器。
- (可选)您可以修改插件目录中生成的配置文件和语言文件。
? 媒体资料与文档
本插件的运行方式与原数据包相同。要了解如何使用它并探索所有过滤可能性,您可以参考 KawaMood 制作的视频和文档:
- 说明视频: 在 YouTube 上观看视频
- 文档: 原始项目页面
? 命令与权限
主命令: /itemsfilter(别名:/if, /itemfilter)
公共命令(默认 true)
| 命令 |
描述 |
权限 |
/if help |
显示完全重构的帮助信息,包含清晰的分类部分(如 [Commands]、[Usage] 等) |
itemsfilter.help |
/if recipe |
给予一本扩展至 5 页的配方书(黑色可读文本,集成 Overflow 模式说明) |
itemsfilter.command.recipe |
管理员命令(默认 op)
| 命令 |
描述 |
权限 |
/if info |
指向一个过滤器 → 显示其模式(Lax/Strict)、所有者、位置、放置日期以及物品计数器 |
itemsfilter.command.info |
/if debug |
指向一个过滤器 → 完整诊断(计数器、库存实时预览、剩余冷却时间) |
itemsfilter.command.debug |
/if give [玩家] |
给予一个 Items Filter。如果未指定玩家,则给自己 |
itemsfilter.command.give |
/if cooldown <ticks> |
设置传输冷却时间为刻(tick)(默认 8) |
itemsfilter.command.cooldown |
/if list |
列出当前世界加载的所有过滤器(从控制台运行则列出所有世界的过滤器) |
itemsfilter.command.list |
/if reload |
重新加载配置 + 重启 tick 任务 + 重新生成缺失的展示实体 |
itemsfilter.command.reload |
区块管理
| 命令 |
描述 |
权限 |
/if chunkload on |
启用 keep-chunks-loaded(过滤器将保持其所在区块加载) |
itemsfilter.command.chunkload |
/if chunkload off |
禁用 keep-chunks-loaded 并移除所有活动区块票 |
itemsfilter.command.chunkload |
/if chunkload list |
列出插件当前维持加载的所有区块 |
itemsfilter.command.chunkload |
/if chunkload status |
显示 tick 配置状态(keep-chunks-loaded、活动区块票数量等) |
itemsfilter.command.chunkload |
/if chunkload add <world> <chunkX> <chunkZ> |
手动添加区块票 |
itemsfilter.command.chunkload |
/if chunkload remove <world> <chunkX> <chunkZ> |
移除区块票 |
itemsfilter.command.chunkload |
卸载
| 命令 |
描述 |
权限 |
/if uninstall |
显示确认消息,包含待删除的过滤器数量 |
itemsfilter.command.uninstall |
/if uninstall confirm |
确认并执行彻底删除(包括过滤器、实体和配置文件) |
itemsfilter.command.uninstall |
/if uninstall confirm 行为: 强制同步加载所有含有过滤器的区块,以清理孤立的实体,清空 filters.yml 文件,并移除区块票。深板岩凿(Chiseled Deepslate)方块仍会留在地图上,需手动破坏。
其他与 Tab 补全
itemsfilter.use(默认:true)- 允许放置 Items Filter。
itemsfilter.craft(默认:true)- 允许合成 Items Filter。
itemsfilter.break(默认:true)- 允许破坏 Items Filter(GriefPrevention/WorldGuard/Towny 优先权更高)。
itemsfilter.overflow(默认:true)- 允许玩家打开并与溢出界面交互。
- Tab 补全: 完整支持子命令、玩家名称和世界名称的自动补全(Tab 键)。
Item Filter for Spigot/Paper (AI-Assisted)
An alternative plugin version of KawaMood's original Items Filter datapack.
If you are using GriefPrevention, WorldGuard, or Towny on your server, you might have encountered duplication bugs or land-claim issues with the original datapack. This plugin completely rewrites the system's mechanics to make it fully compatible with your usual region protections.
✨ Features
- Simple Filtering: Easily choose which items are allowed or blocked in your automated sorting systems.
- Per-Filter Overflow GUI: Shift + Right-click any filter to toggle between 4 modes:
CONTINUE (Green Concrete): Ignores the filter if storage is full.
BLOCK (Red Concrete): Freezes the hopper if storage is full.
DROP (Blue Concrete): Drops the item on the ground below the filter.
TRASH (Black Concrete) [NEW]: Permanently destroys the item immediately at the source.
- Full i18n System: Native localization support (EN/FR) with customizable files inside
plugins/ItemsFilter/Message/.
- Easy Installation: Just drop the file into your
plugins folder and restart your server.
? Credits & Origin
This project is based on the original concept of the "Items Filter" datapack created by KawaMood.
To convert this concept into a plugin and fix the region-protection bugs, this project was developed with the assistance of an AI.
? Installation & Migration
- Download the
.jar file.
- ⚠️ Migration note: If upgrading from an older version, you must delete the old JAR file from your
plugins/ folder before placing the new one to avoid configuration corruption.
- Place the new JAR into your server's
plugins folder.
- Restart your server.
- (Optional) You can modify the configuration and localization files generated in the plugin's folder.
? Media & Documentation
The plugin functions exactly like the original datapack. To learn how to use it and explore all the filtering possibilities, please refer to the video and documentation created by KawaMood:
? Commands & Permissions
Main Command: /itemsfilter (aliases: /if, /itemfilter)
Public Commands (default true)
| Command |
Description |
Permission |
/if help |
Displays the full redesigned section-based help guide ([Commands], [How to Use], etc.) |
itemsfilter.help |
/if recipe |
Gives a 5-page recipe book including instructions for the Overflow GUI |
itemsfilter.command.recipe |
Admin Core Commands (default op)
| Command |
Description |
Permission |
/if info |
Target a filter → displays its mode (Lax/Strict), owner, position, and transferred items counter |
itemsfilter.command.info |
/if debug |
Target a filter → full diagnostic: counters, live preview of inventories, remaining cooldown |
itemsfilter.command.info |
/if give [player] |
Gives an Items Filter. If no player is specified, gives it to yourself |
itemsfilter.command.give |
/if cooldown <ticks> |
Sets the transfer cooldown in ticks (default 8) |
itemsfilter.command.cooldown |
/if list |
Lists all loaded filters in the current world (or all worlds from the console) |
itemsfilter.command.list |
/if reload |
Reloads config + restarts tick task + respawns missing display entities |
itemsfilter.command.reload |
Chunk Management
| Command |
Description |
Permission |
/if chunkload on |
Enables keep-chunks-loaded (filters will keep their chunks loaded) |
itemsfilter.command.chunkload |
/if chunkload off |
Disables keep-chunks-loaded and removes all active chunk tickets |
itemsfilter.command.chunkload |
/if chunkload list |
Lists all chunks currently kept loaded by the plugin |
itemsfilter.command.chunkload |
/if chunkload status |
Displays tick config status and active tickets count |
itemsfilter.command.chunkload |
/if chunkload add <world> <chunkX> <chunkZ> |
Manually adds a chunk ticket |
itemsfilter.command.chunkload |
/if chunkload remove <world> <chunkX> <chunkZ> |
Manually removes a chunk ticket |
itemsfilter.command.chunkload |
Uninstallation
| Command |
Description |
Permission |
/if uninstall |
Displays a confirmation message with the total number of filters to delete |
itemsfilter.command.uninstall |
/if uninstall confirm |
Confirms and executes total deletion (filters + entities + configs) |
itemsfilter.command.uninstall |
Note on /if uninstall confirm: Forces synchronous loading of chunks to clean up all display/interaction entities, clears filters.yml, and removes active tickets. Chiseled Deepslate blocks remain on the map to be broken manually.
Miscellaneous & Tab Completion
itemsfilter.use (default: true) - Allows placing an Items Filter.
itemsfilter.craft (default: true) - Allows crafting an Items Filter.
itemsfilter.break (default: true) - Allows breaking an Items Filter (GriefPrevention/WorldGuard/Towny remain prioritized).
itemsfilter.overflow (default: true) - Allows players to interact with the per-filter overflow GUI.
- Tab Completion: Full auto-completion support for sub-commands, online player names, and world names.
================================================================================
?? Version Française
Une version Plugin de Item Filter.
Si vous utilisez GriefPrevention, WorldGuard, ou Towny sur votre serveur, vous avez peut-être rencontré des bugs de duplication avec la version originale. Ce plugin remplace le fonctionnement du système pour le rendre compatible avec vos protections habituelles.
✨ Ce que vous pouvez faire
- Filtrage Simple : Choisissez facilement quels objets doivent passer ou être bloqués dans vos systèmes de tri.
- Menu d'Overflow par filtre : Faites Maj + clic-droit sur n'importe quel filtre pour basculer entre 4 modes :
CONTINUE (Béton vert) : Ignore le filtre si le stockage est plein.
BLOCK (Béton rouge) : Bloque l'entonnoir si le stockage est plein.
DROP (Béton bleu) : Éjecte l'item au sol sous le filtre.
TRASH (Béton noir) [NOUVEAU] : Détruit définitivement et immédiatement l'item à la source.
- Système i18n complet : Support multilingue natif (FR/EN) avec fichiers modifiables dans
plugins/ItemsFilter/Message/.
- Installation facile : Mettez simplement le fichier dans votre dossier
plugins et redémarrez votre serveur.
? Crédits et Origine
Ce projet est basé sur l'idée originale du datapack "Items Filter" créé par KawaMood.
Pour transformer ce concept en plugin et corriger les bugs rencontrés, ce projet a été réalisé avec l'aide d'une IA.
? Installation & Migration
- Téléchargez le fichier
.jar.
- ⚠️ Note de migration : Si vous mettez à jour depuis une version précédente, vous devez supprimer l'ancien fichier JAR du dossier
plugins/ avant de mettre le nouveau afin d'éviter les corruptions de données.
- Placez le nouveau JAR dans le dossier
plugins de votre serveur.
- Redémarrez votre serveur.
- (Facultatif) Vous pouvez modifier la configuration et les fichiers de langue générés dans le dossier du plugin.
? Médias & Documentation
Le fonctionnement du plugin est identique au datapack original. Pour apprendre à l'utiliser et découvrir toutes les possibilités de filtrage, vous pouvez vous référer à la vidéo et à la documentation créées par KawaMood :
? Commandes & Permissions
Commande principale : /itemsfilter (alias : /if, /itemfilter)
Commandes publiques (default true)
| Commande |
Description |
Permission |
/if help |
Affiche l'aide complète entièrement refondue par sections claires ([Commandes], [Utilisation], etc.) |
itemsfilter.help |
/if recipe |
Donne un livre de recette étendu à 5 pages (texte noir lisible, intègre les modes d'Overflow) |
itemsfilter.command.recipe |
Commandes admin (default op)
| Commande |
Description |
Permission |
/if info |
Vise un filtre → affiche son mode (Lax/Strict), owner, position, date de pose, et compteur d'items |
itemsfilter.command.info |
/if debug |
Vise un filtre → diagnostic complet (compteurs, aperçu live des inventaires, cooldown restant) |
itemsfilter.command.info |
/if give [joueur] |
Donne un Items Filter. Si aucun joueur n'est spécifié, se donne à soi-même |
itemsfilter.command.give |
/if cooldown <ticks> |
Définit le cooldown de transfert en ticks (défaut 8) |
itemsfilter.command.cooldown |
/if list |
Liste tous les filtres chargés du monde courant (ou tous les mondes depuis la console) |
itemsfilter.command.list |
/if reload |
Recharge la config + redémarre le tick task + respawn les display entities manquantes |
itemsfilter.command.reload |
Gestion des Chunks
| Commande |
Description |
Permission |
/if chunkload on |
Active keep-chunks-loaded (les filtres maintiendront leurs chunks chargés) |
itemsfilter.command.chunkload |
/if chunkload off |
Désactive keep-chunks-loaded et retire tous les tickets actifs |
itemsfilter.command.chunkload |
/if chunkload list |
Liste tous les chunks actuellement maintenus chargés par le plugin |
itemsfilter.command.chunkload |
/if chunkload status |
Affiche la config tick (keep-chunks-loaded, nombre de tickets actifs, etc.) |
itemsfilter.command.chunkload |
/if chunkload add <world> <chunkX> <chunkZ> |
Ajoute manuellement un chunk ticket |
itemsfilter.command.chunkload |
/if chunkload remove <world> <chunkX> <chunkZ> |
Retire un chunk ticket |
itemsfilter.command.chunkload |
Désinstallation
| Commande |
Description |
Permission |
/if uninstall |
Affiche un message de confirmation avec le nombre de filtres à supprimer |
itemsfilter.command.uninstall |
/if uninstall confirm |
Confirms and executes total deletion (filters + entities + configs) |
itemsfilter.command.uninstall |
Comportement de /if uninstall confirm : Force le chargement synchrone de tous les chunks avec des filtres pour nettoyer proprement les entités orphelines, vide le fichier filters.yml et retire les tickets de chunks. Les blocs Chiseled Deepslate restent sur la map et doivent être cassés manuellement.
Divers & Tab completion
itemsfilter.use (default: true) - Permet de placer un Items Filter.
itemsfilter.craft (default: true) - Permet de crafter un Items Filter.
itemsfilter.break (default: true) - Permet de casser un Items Filter (GriefPrevention/WorldGuard/Towny restent prioritaires).
itemsfilter.overflow (default: true) - Permet aux joueurs d'ouvrir et d'interagir avec l'interface d'overflow.
- Tab Completion : Support complet de la complétion automatique (touche Tab) pour les sous-commandes, noms de joueurs et noms de mondes.
评论 0
登录后参与评分
还没有评论,来抢沙发吧