✨ WarpHopper – 终极路由引擎 ✨
“下一代无线物流。零延迟。精准过滤。”
✔ 跨维度 • ✔ 多存储 • ✔ 智能区块加载 • ✔ 独立路由 • ✔ 物理管道成本
MC 版本: 1.17 – 1.26.2 • JAR 大小: ~625 KB • 存储: SQL, JSON, YAML, NBT • 高度优化
🌐︎ 什么是 WarpHopper?
WarpHopper 是一款企业级物品分发解决方案,旨在用无形、无线的连接取代杂乱且导致卡顿的漏斗线路。它将标准漏斗转变为智能网关,将物品束射至你的基地——甚至跨越维度——直接送入它们所属的容器中,专为高性能服务器优化。
🚀︎ 为什么选择 WarpHopper?
- 跨维度掌控 — 在主世界、下界和末地之间无缝链接容器,实现流畅的物品路由。
- 智能基础设施 — 通过动态区块加载避免服务器开销,让物流运转而无需承担永久性的性能成本。
- 企业级存储 — 选择你的引擎:
.dat、.yml、.json、MySQL 或 MariaDB,并内置连接池。
- 物理真实感 — 一套虚拟管道系统,根据距离对物理漏斗收费,确保游戏平衡性。
🛠︎ 物流引擎
WarpHopper 充当你服务器自动化的骨干:
- 智能路由器: 使用独立白名单/黑名单逻辑,确保物品精确到达所需位置。
- 跨世界桥梁: 在不同维度之间无缝传输货物,支持可配置的成本和安全防护。
- 数据 powerhouse: 提供可插拔的多提供者存储系统和完整的迁移套件。
- 维护工具: 包含内部存储箱、漏斗库存视图和全局黑名单。
🛡︎ 技术深度解析
- 智能区块加载(无停滞): 仅在需要时临时加载目标区块,并根据物品数量和每位玩家的安全限制进行动态扩展。
- 虚拟管道成本: 链接并非免费;它会根据曼哈顿距离从你的库存中扣除漏斗,并提供共享骨干支持以奖励高效的网络设计。
- 独立路由逻辑: 双轨过滤系统,其中黑名单过滤器作为完全独立的路由运行,绝不会溢出到默认容器中。
- 热交换存储引擎: 在
config.yml 中更改数据库类型后,插件即可自动触发异步即时迁移。
⚙︎ 核心功能
- 零延迟异步管道 — 所有重型数据操作和物流处理均在主线程之外进行,以维持 20 TPS。
- 跨维度传输 — 在不同世界间路由物品,具有专用的区块加载和可配置的固定费率成本。
- 物理成本集成 — 基于距离的漏斗扣除系统,具备防漏洞退款和共享路线效率。
- 多提供者存储(SQL/NoSQL) — 支持 MySQL、MariaDB、JSON、YAML 和 NBT,并配备 HikariCP 连接池。
- 独立白名单/黑名单路由 — 通过可视化过滤器状态指示器,对物品路径进行精确控制。
- 每过滤器销毁模式 — 在源头永久删除特定物品,并显示实时会话计数器。
- 智能区块管理 — 自动加载和卸载目标区块,并设有每位玩家的上限。
- 迁移与备份套件 — 交互式
/wh migrate 命令,支持安全的异步传输和自动文件备份。
- 全局物品黑名单 — 防止特定物品进入物流网络。
- 路由分析 — 实时分解每种过滤器的独立、共享和骨干路径。
- 内部存储(未路由物品) — 为没有目的地的物品提供 54 格的虚拟库存,防止堵塞。
- 漏斗库存视图 — 直接从 GUI 访问物理漏斗的原版库存。
- 配置自动更新器 — 自动合并新的配置属性,同时保留自定义设置。
- 简化删除 — 在所有 GUI 中提供快速、单键管理,带来无缝体验。
🚀︎ 3.5-pre 新功能
- 跨维度路由 🌌 — 在主世界、下界和末地之间实现无缝物流。
- 物理基础设施成本 📱 — 基于曼哈顿距离的漏斗费用,支持共享骨干网。
- 独立路由过滤器 🔀 — 白名单与黑名单逻辑,为过滤后的物品提供单独路径。
- 可插拔存储与迁移 💾 — 使用一条命令在 SQL、JSON 和 YAML 之间移动数据。
- 智能区块加载 ⚡ — 零停滞交付,具有动态负载扩展和安全上限。
- 路由分析 📊 — 直观展示你的漏斗在网络中的使用情况。
🚀︎ 安装指南
- 下载: 获取最新版本的 WarpHopper。
- 安装: 将
.jar 文件放入服务器的 /plugins 文件夹中。
- 配置: 启动服务器以生成
config.yml。选择你的 storage-type。
- 重载: 使用
/wh reload 应用更改。
📜︎ 指令
管理员指令
/wh reload — 强制刷新配置和数据,并自动更新字段。
/wh migrate <type> — 将所有数据迁移到新的存储格式(SQL、YAML 等)。
/wh stats — 监控全局吞吐量、总传送物品数和网络规模。
通用命令
/wh hopper — 将你注视的漏斗转换为 WarpHopper。
/wh unregister — 停用该漏斗并清除其路由数据。
/wh info — 显示所有权、链接饱和度及活跃管理员信息。
/wh addadmin <p> — 授予队友对你漏斗的管理权限。
/wh removeadmin <p> — 撤销某玩家的管理授权。
权限节点
warphopper.use — 允许转换和管理漏斗的标准访问权限。(默认:true)
warphopper.admin — 允许查看全局统计信息和访问管理工具。(默认:OP)
warphopper.reload — 允许重载插件配置文件的权限。(默认:OP)
示例配置文件 (`config.yml`)
# ─────────────────────────────────────────────
# WarpHopper v3.5-pre · 配置文件
# ─────────────────────────────────────────────
# 每次传输周期之间的间隔(以刻为单位)。20 刻 = 1 秒。
# 提高此值可降低繁忙服务器上的 CPU 占用率。
transfer-interval-ticks: 20
# 每个周期内传输到单个链接容器的最大物品数量。
# 增加此值会加快物品移动速度,但如果设置过高可能会影响性能。
transfer-amount: 5
# 每个周期内从源漏斗库存中提取的最大物品数量。
# 这决定了漏斗一次能拉取多少物品。
source-take-amount: 5
# 自动保存间隔(以刻为单位)。6000 刻 = 5 分钟。
# 在服务器关闭时也会立即保存数据。
auto-save-interval: 6000
# 使用区域链接时的最大区域选择大小(每轴)。
# 例如:100 表示最多扫描 100×100×100 的方块立方体 = 1,000,000 个方块。
# 请保持合理数值;扫描操作是同步执行的。
max-region-size: 100
# 单个 WarpHopper 可以链接的最大容器数量。
# 默认值:300(可根据需要设置为 500 或更高)。
max-links-per-hopper: 300
# 跨链接容器进行轮询物品分配。
# true → 物品均匀循环:箱子1 → 箱子2 → 箱子3 → 箱子1 …
# false → 先填满:先填满箱子1,然后再移动到箱子2
round-robin: false
# 当启用轮询模式时,未能装入一个容器的剩余物品
# 是否应在同一周期内继续转移到列表中的下一个容器?
round-robin-overflow: true
# ─────────────────────────────────────────────
# 存储配置
# ─────────────────────────────────────────────
# 可用类型:yml, json, dat, mysql, mariadb
storage-type: yml
# 数据库凭据(仅在 storage-type 为 mysql 或 mariadb 时使用)
database:
host: "localhost"
port: 3306
name: "warphopper"
username: "root"
password: "password"
# ─────────────────────────────────────────────
# 企业级功能
# ─────────────────────────────────────────────
# 允许在不同世界/维度之间链接容器(例如:主世界 -> 下界)
allow-cross-dimensional-transfer: true
# 智能区块加载:如果目标区块未加载,则临时加载它们,
# 即使附近没有玩家也能确保物品送达。
smart-chunk-loading: true
# 保持区块加载的基础刻数。(20 刻 = 1 秒)
# 插件会根据正在传输的物品量动态增加此值。
base-chunk-load-ticks: 20
# 单个玩家一次可以强制加载的最大区块数量(防止滥用)
max-temp-chunks-per-player: 2
# 跨维度传输时,是否应在另一个维度中加载目标区块?
cross-dim-chunk-loading: true
# 保持跨维度区块加载的基础刻数。
cross-dim-chunk-load-ticks: 20
# 单个玩家一次可以强制加载的最大跨维度区块数量
cross-dim-max-chunks-per-player: 2
# 创建跨维度链接时收取的一次性固定漏斗费用。
# 这代表了连接两个维度的“传送门基础设施”费用。
# 设置为 0 以禁用(跨维度链接仅按距离收费,与同世界链接相同)。
# 共享路线:如果你已经有一个指向相同目标世界的链接,则不会再次收取费用——
# 视为共享了传送门基础设施。
cross-dim-flat-cost: 0
# ─────────────────────────────────────────────
# 漏斗存款系统
# ─────────────────────────────────────────────
# 设置为 true 以要求存入物理漏斗物品才能链接容器。
use-hopper-deposit-system: true
# 多个 WarpHopper 可以共享路线的最大距离(半径)。
shared-connection-radius: 25.0
卓越的物流。优化的性能。更智能的存储。
由 BlackForge Studio 精密开发
✨ WarpHopper – The Ultimate Routing Engine ✨
“Next-Generation Wireless Logistics. Zero Lag. Precision Filtering.”
✔ Cross-Dimensional • ✔ Multi-Storage • ✔ Smart Chunk Loading • ✔ Independent Routing • ✔ Physical Pipeline Cost
MC Versions: 1.17 – 1.26.2 • JAR Size: ~625 KB • Storage: SQL, JSON, YAML, NBT • Highly Optimized
🌐︎ What is WarpHopper?
WarpHopper is an enterprise-grade item distribution solution designed to replace messy, lag-inducing hopper lines with invisible, wireless connections. It transforms standard hoppers into intelligent gateways that beam items across your base—and even across dimensions—directly into the containers they belong in, optimized for high-performance servers.
🚀︎ Why Choose WarpHopper?
- Cross-Dimensional Mastery — Link containers across the Overworld, Nether, and The End with seamless item routing.
- Smart Infrastructure — Avoid server overhead with dynamic chunk loading that keeps logistics moving without permanent performance costs.
- Enterprise Storage — Choose your engine:
.dat, .yml, .json, MySQL, or MariaDB with built-in connection pooling.
- Physical Realism — A virtual pipeline system that charges physical hoppers based on distance, ensuring balanced gameplay.
🛠︎ The Logistics Engine
WarpHopper serves as the backbone for your server's automation:
- Intelligent Router: Uses Independent Whitelist/Blacklist logic to ensure items go exactly where they are needed.
- Cross-World Bridge: Seamlessly transfers goods between dimensions with configurable costs and safety guards.
- Data Powerhouse: Offers a Pluggable Multi-Provider Storage system and a complete Migration Suite.
- Maintenance Utility: Includes Internal Storage Chests, Hopper Inventory Views, and Global Blacklists.
🛡︎ Technical Deep Dives
- Smart Chunk Loading (Zero-Stall): Temporarily loads destination chunks only when needed, with dynamic scaling based on item volume and per-player safety limits.
- Virtual Pipeline Cost: Links aren't free; they deduct hoppers from your inventory based on Manhattan distance, with shared backbone support to reward efficient network design.
- Independent Routing Logic: A dual-track filter system where Blacklist filters act as entirely independent routes, never spilling over into default containers.
- Hot-Swap Storage Engine: Change your database type in
config.yml and the plugin can automatically trigger an asynchronous migration on the fly.
⚙︎ Core Capabilities
- Zero-Lag Asynchronous Pipeline — All heavy data operations and logistics processing occur off the main thread to maintain 20 TPS.
- Cross-Dimensional Transfer — Routing items across worlds with dedicated chunk loading and configurable flat-rate costs.
- Physical Cost Integration — A distance-based hopper deduction system with exploit-safe refunds and shared route efficiency.
- Multi-Provider Storage (SQL/NoSQL) — Support for MySQL, MariaDB, JSON, YAML, and NBT with HikariCP connection pooling.
- Independent Whitelist/Blacklist Routing — Precise control over item paths with a visual filter status indicator.
- Per-Filter Destroy Mode — Permanently delete specific items at the source with live session counters.
- Smart Chunk Management — Automatic loading and unloading of destination chunks with per-player caps.
- Migration & Backup Suite — Interactive
/wh migrate command with safe async transfers and automatic file backups.
- Global Item Blacklist — Prevent specific items from entering the logistics network entirely.
- Route Analytics — Real-time breakdown of independent, shared, and backbone paths for every filter.
- Internal Storage (Unrouted Items) — A 54-slot virtual inventory for items with no destination, preventing clogs.
- Hopper Inventory View — Access the physical hopper's vanilla inventory directly from the GUI.
- Config Auto-Updater — Automatically merges new configuration properties without losing custom settings.
- Streamlined Deletion — Fast, single-click management across all GUIs for a frictionless experience.
🚀︎ What's New in 3.5-pre
- Cross-Dimensional Routing 🌌 — Seamless logistics between the Overworld, Nether, and The End.
- Physical Infrastructure Cost 📱 — Manhattan distance-based hopper fees with shared backbone support.
- Independent Routing Filters 🔀 — Whitelist vs Blacklist logic with separate paths for filtered items.
- Pluggable Storage & Migration 💾 — Move your data between SQL, JSON, and YAML with a single command.
- Smart Chunk Loading ⚡ — Zero-stall delivery with dynamic load scaling and safety caps.
- Route Analytics 📊 — Visual breakdown of how your hoppers are being used across your network.
🚀︎ How to Setup
- Download: Get the latest version of WarpHopper.
- Install: Place the
.jar file in your server's /plugins folder.
- Configure: Start the server to generate
config.yml. Choose your storage-type.
- Reload: Use
/wh reload to apply changes.
📜︎ Commands
Admin Commands
/wh reload — Force-refresh configurations and data with auto-field updating.
/wh migrate <type> — Migrate all data to a new storage format (SQL, YAML, etc.).
/wh stats — Monitor global throughput, total items warped, and network scale.
General Commands
/wh hopper — Convert the hopper you are looking at into a WarpHopper.
/wh unregister — Decommission the hopper and purge its routing data.
/wh info — Display ownership, link saturation, and active admins.
/wh addadmin <p> — Grant a teammate management rights to your hopper.
/wh removeadmin <p> — Revoke management authorization from a player.
Permissions
warphopper.use — Standard access to convert and manage hoppers. (Default: true)
warphopper.admin — Access to global stats and administration tools. (Default: OP)
warphopper.reload — Permission to reload the plugin configuration. (Default: OP)
Example Configuration (`config.yml`)
# ─────────────────────────────────────────────
# WarpHopper v3.5-pre · Configuration
# ─────────────────────────────────────────────
# Ticks between each transfer cycle. 20 ticks = 1 second.
# Raise this to reduce CPU usage on busy servers.
transfer-interval-ticks: 20
# Max items transferred to a SINGLE linked container per cycle.
# Increasing this will move items faster but may impact performance if set too high.
transfer-amount: 5
# Max items taken from the source hopper inventory per cycle.
# This governs how many items the hopper can pull out in one go.
source-take-amount: 5
# Auto-save interval in ticks. 6000 ticks = 5 minutes.
# Data is also saved immediately on server shutdown.
auto-save-interval: 6000
# Maximum size of a region selection (per axis) when using Region Link.
# e.g. 100 means up to 100×100×100 block cube = 1,000,000 blocks scanned.
# Keep this reasonable; scanning is performed synchronously.
max-region-size: 100
# Maximum number of containers that can be linked to a single WarpHopper.
# Default: 300 (can be set to 500 or more as needed).
max-links-per-hopper: 300
# Round-robin item distribution across linked containers.
# true → items cycle evenly: chest1 → chest2 → chest3 → chest1 …
# false → fill-first: fill chest1 before moving to chest2
round-robin: false
# When round-robin is true, should leftover items that didn't fit in one container
# continue to the NEXT container in the list within the same cycle?
round-robin-overflow: true
# ─────────────────────────────────────────────
# Storage Configuration
# ─────────────────────────────────────────────
# Available types: yml, json, dat, mysql, mariadb
storage-type: yml
# Database credentials (only used if storage-type is mysql or mariadb)
database:
host: "localhost"
port: 3306
name: "warphopper"
username: "root"
password: "password"
# ─────────────────────────────────────────────
# Enterprise Features
# ─────────────────────────────────────────────
# Allow linking containers across different worlds/dimensions (e.g. Overworld -> Nether)
allow-cross-dimensional-transfer: true
# Smart Chunk Loading: Temporarily load target chunks if they are unloaded,
# guaranteeing item delivery even when no players are nearby.
smart-chunk-loading: true
# Base ticks to keep the chunk loaded. (20 ticks = 1 second)
# The plugin will dynamically increase this based on the amount being transferred.
base-chunk-load-ticks: 20
# Max number of chunks a single player can force-load at once (prevents abuse)
max-temp-chunks-per-player: 2
# Should transferring across dimensions load the target chunk in the other dimension?
cross-dim-chunk-loading: true
# Base ticks to keep cross-dimensional chunks loaded.
cross-dim-chunk-load-ticks: 20
# Max number of cross-dimension chunks a single player can force-load at once
cross-dim-max-chunks-per-player: 2
# Flat hopper cost charged ONCE when a cross-dimensional link is created.
# This represents the "portal infrastructure" fee for bridging two dimensions.
# Set to 0 to disable (cross-dim links cost only distance, same as same-world links).
# Shared routes: if you already have a link to the same destination world, the fee
# is NOT charged again — the portal infrastructure is considered shared.
cross-dim-flat-cost: 0
# ─────────────────────────────────────────────
# Hopper Deposit System
# ─────────────────────────────────────────────
# Set to true to require physical hopper items to be deposited to link containers.
use-hopper-deposit-system: true
# The maximum distance (radius) within which multiple WarpHoppers can share routes.
shared-connection-radius: 25.0
Superior logistics. Optimized performance. Smarter storage.
Developed with Precision by BlackForge Studio
评论 0
登录后参与评分
还没有评论,来抢沙发吧