✨ 管理员为何喜爱它
- 每个系统只需一个智能漏斗 → 大幅减少 ticking block(活跃方块),降低服务器负载。
- 支持在同一世界内跨区块远程路由,具备优先级、过滤器、轮询/填满优先等机制。
- 延迟感知批量处理,跳过阻塞/未加载的目标,可选有界重试队列。
- 内置领地与信任系统(也可对接你的区域插件);支持管理员绕过限制。
- 正常游玩无需使用命令——一切通过清晰的游戏内 GUI 界面完成。
- 可选能源系统(免费模式、红石模式或燃料箱 → 能量单位)。
- 演示:YouTube – 快速导览
? 依赖与兼容性
-
硬性依赖: Vault(用于经济系统;解锁熔炉及升级所需)。
-
软性依赖:
-
服务端: Paper/Spigot 1.20+(API 目标版本为 1.21)。
-
区域插件: 兼容 GriefPrevention/WorldGuard;若无安装,则自带轻量级内部领地系统。
? 功能概览(核心特性)
远程物品路由
将一个高级漏斗链接到同一世界内的多个容器。可配置:
- 针对每个目标的优先级(高优先级优先)
- 白名单/黑名单物品过滤器
- 分配模式:轮询或填满优先
完整游戏内 GUI
右键点击:管理链接、过滤器、能源、信任、统计信息、模拟路径、切换视觉效果。
聊天搜索过滤器
点击指南针图标,输入文字进行搜索;按 Esc 或点击“取消”退出。
能源模式
- 无:免费运行
- 红石:
requireRedstonePower(需要红石信号)或 pauseWhenPowered(通电时暂停)
- 燃料:链接燃料箱;燃料物品根据距离和数量转换为能量单位
信任与领地
漏斗必须被认领;所有者可使用 /trust 授予用户权限;管理员可绕过此限制。 crafted 的节点自动认领。
延迟感知批量处理
每 tick 上限控制,智能跳过空输入/阻塞/未加载的目标。
视觉工具
粒子光束指向目标;传输轨迹线;过滤器聚焦可视化效果。
内置熔炉(可选)
虚拟熔炼功能,支持通过 Vault 解锁及升级。
可制作
高级漏斗和燃料箱的合成配方均可自定义配置。
?️ 安装步骤
- 将 JAR 文件放入
/plugins 文件夹。
- 确保已安装 Vault 并启用了一个经济插件。
- (可选)安装 DecentHolograms、LuckPerms 以及你的 Skyblock 插件。
- 启动服务器。如需修改,编辑
/plugins/ImprovedHoppers/config.yml。
- 执行
/improvedhoppers reload 应用更改。
⚡ 快速上手(玩家篇)
- 合成一个高级漏斗(若使用燃料模式,还需合成燃料箱)。
- 放置并认领漏斗(crafted 的节点会自动认领)。
- 打开 GUI → 添加目标 → 点击容器以建立链接
提示:使用 /improvedhoppers wand 可快速进行多链接。
- 设置过滤器、优先级和分配模式。
- 选择能源模式。若选燃料模式,请链接燃料箱并放入燃料。
- (可选)根据红石设置接入红石信号。
⌨️ 命令列表
| 命令 |
描述 |
权限 |
/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 事件会被取消。
? 路由逻辑(概览)
- 从源库存中提取最多
per_tick_item_cap 数量的物品。
- 过滤物品(白名单/黑名单)。
- 按优先级对目标排序,移除未加载或被阻挡的目标。
- 分发:
- 轮询: 按物品类型循环目标。
- 优先填充: 填满第一个有效目标,直到其无法接受更多物品为止。
- 能源核算(如果启用):距离和数量 → PU 消耗。
- 如果移动失败且启用了重试队列,则应用重试队列。
? 性能说明
- 批量处理并限制每刻操作次数,以保持 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 或增加容量。
✨ Why admins love it
- One smart hopper per system → far fewer ticking blocks, lower server load.
- Remote routing across the same world with priorities, filters, round-robin/fill-first.
- Lag-aware batching, skips blocked/unloaded targets, optional bounded retry queue.
- Claim & trust built-in (or hook your region plugin); admin bypass supported.
- No commands needed for normal play — everything via a clear in-game GUI.
- Optional power system (free, redstone, or fuel chest → power units).
- Demo: YouTube – Quick Tour
? Requirements & Compatibility
-
Hard dependency: Vault (for economy; needed for smelter unlocks & upgrades).
-
Soft dependencies:
-
Servers: Paper/Spigot 1.20+ (API 1.21 targeted).
-
Regions: Works with GriefPrevention/WorldGuard; ships a lightweight internal claim system if absent.
? What it does (Core Features)
Remote Item Routing
Link one Improved Hopper to many containers in the same world. Configure:
- Per-target priority (higher first)
- Whitelist/blacklist item filters
- Distribution: Round-robin or Fill-first
Full In-Game GUI
Right-click: manage links, filters, power, trust, stats, simulate routes, toggle visuals.
Chat Search for Filters
Click the compass, type to search; Esc or “cancel” to exit.
Power Modes
- None: free operation
- Redstone:
requireRedstonePower or pauseWhenPowered
- Fuel: link a Fuel Chest; fuel items convert to Power Units based on distance & amount
Trust & Claims
Hoppers must be claimed; owner can /trust users; admins bypass. Crafted nodes auto-claim.
Lag-Aware Batching
Per-tick caps & smart skipping of empty inputs/blocked/unloaded targets.
Visual Tools
Particle beams to targets; transfer trails; filter-focus visualization.
Built-in Smelter (optional)
Virtual smelting with Vault unlock & upgrades.
Craftable
Recipes configurable for both Improved Hopper and Fuel Chest.
?️ Installation
- Place the JAR in
/plugins.
- Ensure Vault is installed and an economy plugin is active.
- (Optional) Install DecentHolograms, LuckPerms, and your Skyblock plugin.
- Start server. Edit
/plugins/ImprovedHoppers/config.yml if desired.
/improvedhoppers reload to apply changes.
⚡ Quick Start (Player)
- Craft an Improved Hopper (and a Fuel Chest if using Fuel mode).
- Place & Claim the hopper (crafted nodes auto-claim).
- Open GUI → Add Targets → click containers to link
Tip: /improvedhoppers wand for fast multi-link.
- Set filters, priorities, and distribution mode.
- Choose Power Mode. If Fuel, link Fuel Chest and insert fuel.
- (Optional) Add redstone depending on redstone settings.
⌨️ Commands
| Command |
Description |
Permission |
/improvedhoppers |
Show subcommands |
(none) |
/improvedhoppers wand |
Get link wand for multi-linking |
improvedhoppers.user.wand |
/improvedhoppers settings |
Open settings (node or admin view) |
improvedhoppers.user.settings / improvedhoppers.admin.settings |
/improvedhoppers remote |
Remote controller (view/manage anywhere) |
improvedhoppers.user.remote |
/improvedhoppers reload |
Reload config |
improvedhoppers.admin.reload |
/improvedhoppers power apply |
Re-apply power settings |
improvedhoppers.admin |
? Permissions
User
improvedhoppers.user.wand (default: true)
improvedhoppers.user.settings (default: true)
improvedhoppers.user.remote (default: true)
improvedhoppers.user.* (default: true)
improvedhoppers.user.restore (default: true)
Admin
improvedhoppers.admin (default: op) — moderation bypass
improvedhoppers.admin.reload (default: op)
improvedhoppers.admin.settings (default: op)
improvedhoppers.admin.* (default: op)
Limits (override config)
improvedhoppers.limit.player.<n>
improvedhoppers.limit.island.<n>
improvedhoppers.limit.links.<n>
improvedhoppers.limit.trusted.<n>
improvedhoppers.limit.filter.<n>
improvedhoppers.hopper.power.<n>
? Crafting
Improved Hopper — shaped recipe (all items configurable)
I C I
R H R
I C I
Fuel Chest — configurable (e.g., coal + chest)
See recipes.yml for exact materials, names, and NBT settings.
⚙️ Config Highlights (sample)
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
routing:
link:
max_distance: 256
owner_must_be_online: false
cleanup_interval_ticks: 200
distribution: ROUND_ROBIN # ROUND_ROBIN | FILL_FIRST
filters:
default_mode: WHITELIST # WHITELIST | BLACKLIST
per_hopper_max: 32
transfer:
interval_ticks: 10
per_tick_item_cap: 256
suction:
radius: 2.5
enabled: true
cost_per_item: 0
retry_queue:
enabled: true
max_entries: 2048
power:
mode: NONE # NONE | REDSTONE | FUEL
redstone:
require_power: false
pause_when_powered: true
fuel:
enabled: false # flip to true to use fuel
capacity: 10000
regen_per_tick: 0
distance_cost_per_block: 0.25
amount_cost_per_item: 0.05
auto_refuel: true
link_limit: 1
max_link_distance: 16
fuels:
COAL: 160
CHARCOAL: 160
BLAZE_ROD: 240
smelter:
enabled: true
base_cook_ticks: 200
queue_size: 128
unlock_cost: 1000 # Vault currency
upgrade_costs:
level_2: 2500
level_3: 5000
limits:
per_player: 20
per_island: 50
links_per_material: 4
trusted_slots: 8
storage:
type: yaml # Storage backend: yaml, sqlite, h2, or mysql (yaml default)
save:
debounceTicks: 30 # Delay in ticks before saving after changes (0 = immediate)
intervalSeconds: 0 # Periodic autosave interval in seconds (0 = disabled)
h2:
file: hoppers # H2 database file (stored in plugin folder)
options: "" # Optional H2 connection options (e.g. AUTO_SERVER=TRUE)
username: "sa"
password: ""
mysql:
host: localhost
port: 3306
database: improvedhoppers
username: root
password: ""
parameters: "useUnicode=true&characterEncoding=utf8&serverTimezone=UTC&useSSL=false&allowPublicKeyRetrieval=true"
Note: Vanilla InventoryMoveItemEvent/InventoryPickupItemEvent are cancelled for claimed nodes to avoid conflicts.
? Routing Logic (at a glance)
- Pull up to
per_tick_item_cap from source inventory.
- Filter items (whitelist/blacklist).
- Order targets by priority, remove unloaded or blocked.
- Distribution:
- Round-robin: cycle targets per item type.
- Fill-first: fill the first valid target until it can’t accept more.
- Power accounting (if enabled): distance & amount → PU cost.
- Apply retry queue if a move fails and queue is enabled.
? Performance Notes
- Batches and caps per tick to keep TPS smooth.
- Skips empty sources & blocked/unloaded targets to save time.
- Optional distance-scaled power discourages extreme cross-map links.
- Visualizer is per-player; filter-focused trails reduce particle spam.
? Compatibility & Hooks
- Hooks: Vault, LuckPerms, DecentHolograms, SuperiorSkyblock2, BentoBox, GriefPrevention, WorldGuard.
- Ships internal claims if none detected.
? Admin Tools
Look at a node and run /improvedhoppers settings (admin view) to live-tune: link distance, suction/transfer caps, fuel values, smelter rates, limits, particles/holograms, world allowlists, recipes, and more.
?? API & Events (for developers)
Events (examples)
HopperSorterTransferEvent — per successful transfer
HopperSorterFuelConsumeEvent — on fuel → power conversion
HopperSorterClaimEvent — when ownership/claims change
- Overflow & alert hooks
Example Listener
@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() if fuel mode; e.isSimulated() for dry runs
if (owner != null && owner.isOnline()) {
owner.sendActionBar(Component.text("§aMoved " + moved + "x " + stack.getType() + " → " + pretty(to)));
}
}
Minimal API sketches available for fuel providers & virtual targets.
? Storage & Persistence
- YAML (default) or SQLite.
- Persists node power, names, particle colors, links, smelter state safely.
❓ FAQ
Q: Can I disable the power system?
A: Yes. It’s off by default; set power.fuel.enabled: true to use Fuel.
Q: Can players manage hoppers remotely?
A: Yes. /improvedhoppers remote opens a network overview or the node GUI.
Q: Do vanilla hopper pulls still happen on claimed nodes?
A: No. We cancel vanilla move/pickup events for claimed nodes to prevent conflicts.
? Troubleshooting
- No transfers happening → Check claims/ownership and power mode.
- Hologram missing → Install/enable DecentHolograms and ensure
holograms.enabled: true.
- Skyblock limits ignored → Ensure SSB2/BentoBox present; confirm LuckPerms dyn-limits if using permission overrides.
- High distance cost → Lower
power.fuel.distance_cost_per_block or increase capacity.
评论 0
登录后参与评分
还没有评论,来抢沙发吧