ItemsFilter-Plugin

插件

· 作者 Teruki

一个基于 AI 辅助修复 GriefPrevention 中遇到的物品复制漏洞的 Items Filter 数据包插件适配版本。

0 本站下载 0 关注 更新于 4 个月前

最新 1.4.0 · 26.1.2 · Paper

一键开服(送7天)

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 的协助下开发完成。


? 安装与迁移

  1. 下载 .jar 文件。
  2. ⚠️ 迁移注意: 如果是从旧版本升级,必须在放置新文件之前删除 plugins/ 文件夹中的旧 JAR 文件,以避免配置损坏。
  3. 将新的 JAR 文件放入服务器的 plugins 文件夹中。
  4. 重启服务器。
  5. (可选) 你可以修改插件文件夹中生成的配置文件和本地化文件。

? 媒体与文档

该插件的功能与原数据包完全一致。要了解如何使用它并探索所有过滤可能性,请参阅 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 的帮助下完成开发。


? 安装与迁移

  1. 下载 .jar 文件。
  2. ⚠️ 迁移注意: 如果您是从旧版本升级,必须先删除 plugins/ 文件夹中的旧 JAR 文件,再放入新文件,以避免数据损坏。
  3. 将新的 JAR 文件放入服务器的 plugins 文件夹中。
  4. 重启服务器。
  5. (可选)您可以修改插件目录中生成的配置文件和语言文件。

? 媒体资料与文档

本插件的运行方式与原数据包相同。要了解如何使用它并探索所有过滤可能性,您可以参考 KawaMood 制作的视频和文档:


? 命令与权限

主命令: /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 键)。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源