ImprovedHoppers

插件

· 作者 OneLonePlayer

智能的、领地感知物品路由

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

最新 1.1.4 · 1.21 · Bukkit / Paper

一键开服(送7天)

✨ 管理员为何喜爱它

  • 每个系统只需一个智能漏斗 → 大幅减少 ticking block(活跃方块),降低服务器负载。
  • 支持在同一世界内跨区块远程路由,具备优先级、过滤器、轮询/填满优先等机制。
  • 延迟感知批量处理,跳过阻塞/未加载的目标,可选有界重试队列。
  • 内置领地与信任系统(也可对接你的区域插件);支持管理员绕过限制。
  • 正常游玩无需使用命令——一切通过清晰的游戏内 GUI 界面完成。
  • 可选能源系统(免费模式、红石模式或燃料箱 → 能量单位)。
  • 演示:YouTube – 快速导览

? 依赖与兼容性

  • 硬性依赖: Vault(用于经济系统;解锁熔炉及升级所需)。

  • 软性依赖:

  • 服务端: Paper/Spigot 1.20+(API 目标版本为 1.21)。

  • 区域插件: 兼容 GriefPrevention/WorldGuard;若无安装,则自带轻量级内部领地系统。


? 功能概览(核心特性)

远程物品路由

将一个高级漏斗链接到同一世界内的多个容器。可配置:

  • 针对每个目标的优先级(高优先级优先)
  • 白名单/黑名单物品过滤器
  • 分配模式:轮询或填满优先

完整游戏内 GUI

右键点击:管理链接、过滤器、能源、信任、统计信息、模拟路径、切换视觉效果。

聊天搜索过滤器

点击指南针图标,输入文字进行搜索;按 Esc 或点击“取消”退出。

能源模式

  • 无:免费运行
  • 红石:requireRedstonePower(需要红石信号)或 pauseWhenPowered(通电时暂停)
  • 燃料:链接燃料箱;燃料物品根据距离和数量转换为能量单位

信任与领地

漏斗必须被认领;所有者可使用 /trust 授予用户权限;管理员可绕过此限制。 crafted 的节点自动认领。

延迟感知批量处理

每 tick 上限控制,智能跳过空输入/阻塞/未加载的目标。

视觉工具

粒子光束指向目标;传输轨迹线;过滤器聚焦可视化效果。

内置熔炉(可选)

虚拟熔炼功能,支持通过 Vault 解锁及升级。

可制作

高级漏斗和燃料箱的合成配方均可自定义配置。


?️ 安装步骤

  1. 将 JAR 文件放入 /plugins 文件夹。
  2. 确保已安装 Vault 并启用了一个经济插件。
  3. (可选)安装 DecentHolograms、LuckPerms 以及你的 Skyblock 插件。
  4. 启动服务器。如需修改,编辑 /plugins/ImprovedHoppers/config.yml。
  5. 执行 /improvedhoppers reload 应用更改。

⚡ 快速上手(玩家篇)

  1. 合成一个高级漏斗(若使用燃料模式,还需合成燃料箱)。
  2. 放置并认领漏斗(crafted 的节点会自动认领)。
  3. 打开 GUI → 添加目标 → 点击容器以建立链接
    提示:使用 /improvedhoppers wand 可快速进行多链接。
  4. 设置过滤器、优先级和分配模式。
  5. 选择能源模式。若选燃料模式,请链接燃料箱并放入燃料。
  6. (可选)根据红石设置接入红石信号。

⌨️ 命令列表

命令 描述 权限
/improvedhoppers 显示子命令 (无)
/improvedhoppers wand 获取链接魔杖以进行多重链接 improvedhoppers.user.wand
/improvedhoppers settings 打开设置界面(节点视图或管理员视图) improvedhoppers.user.settings / improvedhoppers.admin.settings
/improvedhoppers remote 远程控制端(随时随地查看/管理) improvedhoppers.user.remote
/improvedhoppers reload 重载配置文件 improvedhoppers.admin.reload
/improvedhoppers power apply 重新应用能源设置 improvedhoppers.admin

? 权限说明

用户权限

  • improvedhoppers.user.wand (默认: true)
  • improvedhoppers.user.settings (默认: true)
  • improvedhoppers.user.remote (默认: true)
  • improvedhoppers.user.* (默认: true)
  • improvedhoppers.user.restore (默认: true)

管理员权限

  • improvedhoppers.admin (默认: op) — 管理绕过权限
  • improvedhoppers.admin.reload (默认: op)
  • improvedhoppers.admin.settings (默认: op)
  • improvedhoppers.admin.* (默认: op)

限制覆盖(覆盖配置文件中的值)

  • improvedhoppers.limit.player.<n>
  • improvedhoppers.limit.island.<n>
  • improvedhoppers.limit.links.<n>
  • improvedhoppers.limit.trusted.<n>
  • improvedhoppers.limit.filter.<n>
  • improvedhoppers.hopper.power.<n>

? 合成配方

高级漏斗 — 形状合成配方(所有材料均可配置)

I C I
R H R
I C I

燃料箱 — 可配置(例如:煤炭 + 箱子)
请参阅 recipes.yml 获取具体的材料名称及 NBT 设置。


⚙️ 配置亮点(示例)

general:
  storage: YAML          # YAML | SQLITE
  locale: en_US
  holograms:
    enabled: true
    update_ticks: 20
  particles:
    enabled: true
    transfer_trail: true
    filter_focus: true

claims:
  required: true
  auto_claim_on_craft: true
  admin_bypass: true

配置项:
  路由:
    链接:
      最大距离: 256
      所有者必须在线: false
      清理间隔刻数: 200
  分发方式: ROUND_ROBIN   # ROUND_ROBIN | FILL_FIRST
  过滤器:
    默认模式: WHITELIST   # WHITELIST | BLACKLIST
    每个漏斗最大数量: 32

传输:
  间隔刻数: 10
  每刻物品上限: 256
  吸取:
    半径: 2.5
    启用: true
    每物品消耗: 0
  重试队列:
    启用: true
    最大条目数: 2048

能源:
  模式: NONE                  # NONE | REDSTONE | FUEL
  红石:
    需要电力: false
    通电时暂停: true
  燃料:
    启用: false            # 翻转为 true 以使用燃料
    容量: 10000
    每刻再生: 0
    每区块距离消耗: 0.25
    每件物品消耗: 0.05
    自动补充燃料: true
    链接限制: 1
    最大链接距离: 16
    燃料列表:
      COAL: 160
      CHARCOAL: 160
      BLAZE_ROD: 240

熔炉:
  启用: true
  基础烹饪刻数: 200
  队列大小: 128
  解锁成本: 1000           # Vault 货币
  升级成本:
    等级 2: 2500
    等级 3: 5000

限制:
  每名玩家: 20
  每岛屿: 50
  每种材料的链接数: 4
  受信任槽位: 8

存储:
  类型: yaml                      # 存储后端:yaml, sqlite, h2 或 mysql(默认为 yaml)
  保存:
    debounceTicks: 30             # 更改后保存前的延迟刻数(0 = 立即保存)
    intervalSeconds: 0            # 定期自动保存间隔秒数(0 = 禁用)
  h2:
    文件: hoppers                 # H2 数据库文件(存储在插件文件夹中)
    选项: ""                   # 可选的 H2 连接选项(例如 AUTO_SERVER=TRUE)
    用户名: "sa"
    密码: ""
  mysql:
    主机: localhost
    端口: 3306
    数据库: improvedhoppers
    用户名: root
    密码: ""
    参数: "useUnicode=true&characterEncoding=utf8&serverTimezone=UTC&useSSL=false&allowPublicKeyRetrieval=true"

注意:为防止冲突,已认领节点的原版 InventoryMoveItemEvent/InventoryPickupItemEvent 事件会被取消。


? 路由逻辑(概览)

  1. 从源库存中提取最多 per_tick_item_cap 数量的物品。
  2. 过滤物品(白名单/黑名单)。
  3. 按优先级对目标排序,移除未加载或被阻挡的目标。
  4. 分发:
    • 轮询: 按物品类型循环目标。
    • 优先填充: 填满第一个有效目标,直到其无法接受更多物品为止。
  5. 能源核算(如果启用):距离和数量 → PU 消耗。
  6. 如果移动失败且启用了重试队列,则应用重试队列。

? 性能说明

  • 批量处理并限制每刻操作次数,以保持 TPS 稳定。
  • 跳过空源和被阻挡/未加载的目标以节省时间。
  • 可选的距离缩放能耗机制可 discourages 极端跨地图链接。
  • 可视化器是每玩家独立的;基于过滤器的轨迹可减少粒子刷屏。

? 兼容性与挂钩

  • 挂钩:Vault、LuckPerms、DecentHolograms、SuperiorSkyblock2、BentoBox、GriefPrevention、WorldGuard。
  • 如果未检测到其他插件,则自带内部领地功能。

? 管理员工具

查看某个节点并运行 /improvedhoppers settings(管理员视图)即可实时调整:链接距离、吸取/传输上限、燃料值、熔炉速率、限制、粒子/全息图、世界白名单、配方等。


?‍? API 与事件(面向开发者)

事件(示例)

  • HopperSorterTransferEvent — 每次成功传输时触发
  • HopperSorterFuelConsumeEvent — 燃料转换为能源时触发
  • HopperSorterClaimEvent — 所有权/领地变更时触发
  • 溢出与警报挂钩

监听器示例

@EventHandler(ignoreCancelled = true, priority = EventPriority.MONITOR)
public void onTransfer(HopperSorterTransferEvent e) {
    Player owner = e.getOwner();
    ItemStack stack = e.getItem();
    Location from = e.getSource();
    Location to = e.getTarget();
    int moved = e.getAmount();
    // e.getCostPU() 如果是燃料模式; e.isSimulated() 用于干跑测试
    if (owner != null && owner.isOnline()) {
        owner.sendActionBar(Component.text("§aMoved " + moved + "x " + stack.getType() + " → " + pretty(to)));
    }
}

提供燃料提供商和虚拟目标的简易 API 草图。


? 存储与持久化

  • YAML(默认)或 SQLite。
  • 安全地持久化节点能源、名称、粒子颜色、链接和熔炉状态。

❓ 常见问题

问:我可以禁用能源系统吗?
答:可以。默认情况下它是关闭的;设置 power.fuel.enabled: true 以使用燃料。

问:玩家可以远程管理漏斗吗?
答:可以。/improvedhoppers remote 会打开网络概览或节点 GUI。

问:在已认领的节点上原版漏斗抽取仍然会发生吗?
答:不会。我们取消了已认领节点的原版移动/拾取事件,以防止冲突。


? 故障排除

  • 没有发生传输 → 检查领地/所有权和能源模式。
  • 全息图缺失 → 安装/启用 DecentHolograms 并确保 holograms.enabled: true。
  • 天空岛限制被忽略 → 确保 SSB2/BentoBox 存在;如果使用权限覆盖,请确认 LuckPerms 的动态限制。
  • 距离成本过高 → 降低 power.fuel.distance_cost_per_block 或增加容量。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源