Wifi Hoppers

插件

· 作者 IdleToxicDust

适用于 Paper 和 Folia 的无线、可升级漏斗——跨距离连接箱子,过滤物品,提升传输速度和吸附能力,并支持从 UpgradeableHoppers 迁移。

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

最新 1.3.36 · 26.1.2 · Folia / Paper

一键开服(送7天)

封面图片

概览

WifiHoppers 使用无线容器链接取代原版漏斗物流。放置一个特殊的漏斗方块,打开其菜单,使用游戏内货币升级属性,并将物品路由到箱子、熔炉、合成器等——无需在世界中铺设漏斗链。

该插件专为高玩家数量的生存服务器构建:支持 Folia 上的区域安全刻处理、Paper 上的可选批量处理、玩家区块活动门控,以及可选的堆叠物品支持(WildStacker)。

核心功能

无线漏斗

  • 放置 Wifi Hopper 物品以在该位置注册受管理的漏斗。
  • 破坏方块可回收漏斗物品,其物品描述符中保存了等级、类型和链接数量。
  • 数据存储在本地 SQLite 数据库中(内置驱动——无需外部数据库设置)。

容器链接

  • 将漏斗链接到同世界内的任何容器持有者:箱子、 barrels、潜影盒、熔炉、高炉、烟熏炉、营火、合成器等。
  • 无需物理漏斗链——物品会从漏斗库存瞬移到配置距离内的链接目标。
  • 基于升级等级的每链接限制(GUI 中最多 36 个链接槽,实际最大链接数由升级决定)。
  • 重新排序链接(优先级)、重命名链接,并从菜单中移除链接。
  • 链接验证:同世界、距离上限、防止重复、最大链接数。

物品吸取(拾取)

  • 按可配置的刻间隔将地面上的物品吸入漏斗库存。
  • 普通漏斗:以漏斗为中心的球形半径范围(可升级)。半径为 0 = 仅从上方方块进行原版式拾取。
  • 区块漏斗:从漏斗周围加载区块中的区块半径范围内吸取物品(适用于大型农场)。
  • 当存在链接时,尊重漏斗库存空间和可选过滤规则。
  • WildStacker:安装插件后正确处理堆叠物品实体。

物品传输(输出)

  • 按单独的刻间隔将物品从漏斗库存移动到链接容器中。
  • 每个周期的传输量可升级(例如,普通类型的每次周期可从 8 升级到 320+ 物品)。
  • 支持熔炉(仅限输入和燃料槽,绝不输出)、合成器(尊重禁用槽位)和普通库存。

高级路由

  • 按顺序插入(开/关):
    • 开:第一个匹配的链接优先获取物品。
    • 关:在匹配的链接间均匀分配。
  • 删除非过滤物品(开/关):
    • 开:不匹配任何过滤器的物品会被销毁(吸取可以收集所有物品;路由会删除被拒绝的物品)。
    • 关:未匹配的物品保留在漏斗中或进入未过滤的“溢出”链接。
  • 过滤器优先级:严格过滤器 → 类型/名称 → 未过滤溢出链接。

每链接过滤

每个链接都有自己独立的过滤 GUI:

  • 过滤模式
    • 白名单 或 黑名单
  • 匹配类型
    • 类型(材料)、严格(精确物品 + NBT)、名称(显示名称)
  • 类型过滤器
    • 点击背包中的物品以添加/移除材料
  • 潜影盒过滤器
    • 空/满潜影盒占用令牌(类型模式)
  • 严格过滤器
    • 完整物品序列化——精确堆叠匹配
  • 清除过滤器
    • 一键重置

默认新链接:白名单 + 类型。

升级(GUI + 经济)

每种漏斗类型有四个升级轨道,通过 Vault 支付(如果已安装;若无 Vault 则免费):

  1. 链接 — 同时连接的容器最大数量
  2. 传输 — 每次传输周期移动的物品数量
  3. 吸取半径 — 拾取范围(根据类型是方块或区块)
  4. 链接距离 — 目标可以有多远

所有成本和等级值均在 hoppers.yml 中定义(采用 UpgradeableHoppers 风格的布局)。

主动吸取调整

  • 独立于最大吸取升级:为每个漏斗设置主动拾取半径(在 GUI 中增加/减少)。
  • 让玩家可以在繁忙的农场上限制延迟,而无需降级已购买的升级。

漏斗类型

可在 hoppers.yml 中配置:

  • 普通
    • 方块半径物品拾取,高链接/传输上限
  • 区块
    • 基于区块的拾取,适用于大型物品农场;不同的升级曲线

使用 /hopper get [玩家] [数量] [类型] 获得类型。

控制

  • 左键点击漏斗 -> 打开升级与链接菜单
  • 右键点击漏斗 -> 打开原版漏斗库存
  • 破坏漏斗 -> 掉落带有保存属性的漏斗物品
  • 链接模式 -> 菜单 → “链接到容器” -> 左键点击容器
  • 重命名链接 -> Shift + 右键点击菜单中的链接 -> 在聊天中输入名称(清空以重置)
  • 重新排序链接 -> Shift + 左键点击(上移)/ 右键点击(下移)
  • 移除链接 -> 在菜单中按下 Q(丢弃)链接图标

命令权限

wifihoppers.get

  • /hopper get [玩家] [数量] [类型]
    • 给予无线漏斗物品
  • /hopper types
    • 列出配置的漏斗类型

wifihoppers.admin

  • /hopper reload
    • 重载配置 + hoppers.yml + 运行时
  • /hopper import
    • 从 UpgradeableHoppers 数据库重新导入

别名:hoppers, h, uhopper, uhoppers, uh, uhr, wifihopper, wifihoppers, wh 旧版权限:uhr.get, uhr.admin(同上)

配置

config.yml

engine:
  tick-interval: 2          # 引擎每 N 个服务器刻运行一次
  paper:
    scan-stride: 2          # Paper:每批处理的漏斗数量(轮询)
    adaptive-stride: false  # 当存在大量漏斗时自动调整步长
    target-batch-size: 300  # 启用自适应时的目标每刻漏斗数
import:
  uh-db-path: plugins/UpgradeableHoppers/Data/database.db
  completed: false        # 首次成功导入 UH 后设为 true

hoppers.yml

  • 定义漏斗类型、显示名称、刻间隔和所有升级等级(数值 + Vault 成本)。
  • 结构镜像 UpgradeableHoppers,便于迁移和平衡。

依赖项

  • Paper (或 Folia) -> 必需
  • Vault -> 可选
  • WildStacker -> 可选

不依赖 Citizens、WorldEdit 或其他插件。

UpgradeableHoppers 迁移

  • WifiHoppers 可在首次启动时(或通过 /hopper import 命令)导入现有的 UpgradeableHoppers 数据:
  • 从 UH 数据库路径读取每个世界的 SQLite 表。
  • 导入漏斗位置、等级、链接、过滤器(包括严格物品、潜影盒代币、命名过滤器)。
  • 可在首次安装时从旧的 UH 配置同步 default hoppers.yml 的值。
  • 在成功导入后,将 config.yml 中的 import.completed 设置为 true,以跳过未来重启时的自动导入。

提示:导入前请备份 plugins/UpgradeableHoppers/ 目录及你的世界文件。

性能与 Folia

  • Folia:为每个漏斗使用区域调度器——支持跨区域链接,当目标区块位于其他区域线程上时会优雅地跳过。
  • Paper:可选的轮询批处理机制,防止数百个漏斗在同一服务器刻内全部 ticking(通过 scan-stride 和 adaptive-stride)。
  • 活动门控:漏斗仅在玩家处于服务器模拟距离内时才进行处理(减少空闲世界的 CPU 占用)。
  • 每种漏斗类型拥有独立的吸取/传输计时器(ticks.transfer、ticks.suction,位于 hoppers.yml 中)。

要求

Paper 或 Folia Minecraft 1.21.11 / 26.1.2(已在 Paper 26.1.2 上测试) Java 25+(与 Paper 26.1.x 匹配)

安装

  1. 下载 WifiHoppers-x.x.x.jar。
  2. 将其放入 plugins/ 文件夹。
  3. 重启服务器。
  4. 配置 hoppers.yml(升级成本/数值)和 config.yml(引擎 + 导入路径)。
  5. 可选:安装 Vault 以启用经济升级功能。
  6. 获取漏斗权限:/hopper get 1 normal

如果从 UpgradeableHoppers 迁移,请确保在首次启动前将 import.uh-db-path 指向旧的 database.db 文件。

Jar 包包含内容

  • 插件类 + 默认配置文件(config.yml、hoppers.yml)
  • SQLite JDBC(已捆绑——无需单独下载)

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源