HynfinityIndexer

HynfinityIndexer

Hytale 服务端 0.5.6 或更高版本

基于管道的物品物流系统，适用于你的 Hytale 服务器。放置一个中心索引器终端，用透明的玻璃管道将你的箱子连接起来，即可在一个界面中浏览整个存储网络中的物品并进行移动——同时实时观看每件物品在管道内物理移动。

快速开始

1. 从发布页面下载最新的 HynfinityIndexer-*.jar
2. 将其放入服务端的 mods/ 目录
3. 启动服务器
4. 在工作台（精细工艺）上制作索引器和一些玻璃管道

功能特性

中心索引器

• 一个终端，汇总其管道网络内可触及的每个箱子
• 在单一界面中浏览整个网络的内容——物品会跨所有箱子进行分组和计数
• 点击即可存入和取出物品；右键可拉取一整组
• 配备接收和发送缓冲区，确保传输在高负载下有序排队

玻璃管道——观察物品移动

• 透明管道：内部运输的物品会以实际物品实体形式渲染，在管道内移动——无需猜测，你就能看到流动过程
• 根据连接状态自动变换形状（直线/转角/T字/枢纽），并带有动画效果
• 连接索引器 ↔ 管道 ↔ 箱子；网络会自动被发现

智能路由

• 自动发现网络（广度优先搜索）跨越管道、箱子和索引器
• 基于拥塞感知的每段定向路由：数据包会绕过繁忙的管道，因此并行运行可使吞吐量大致翻倍
• 防乒乓效应与环路死锁退避机制，确保物品在高负载下持续流动
• 可配置管道速度、单个网络限制以及并发度

合成配方

物品	配方	产出	工作台
玻璃管道	2× 铜锭 + 1× 青色水晶	×8	工作台（精细工艺）
索引器	6× 铁锭 + 4× 青色水晶	×1	工作台（精细工艺）

命令

命令	描述	权限
/indexer status	版本、配置摘要、网络及已发现索引器计数	—
/indexer network	列出每个活动网络（索引器位置、管道、箱子、有效性）	—
/indexer reload	从磁盘重新加载 config.json	—

别名：/hynfinityindexer。

配置

配置文件在首次运行时会创建于插件数据文件夹中。

设置项	默认值	描述
pipeSpeedTicksPerBlock	5	物品穿过一个管道方块所需的游戏刻数（数值越低越快）
maxChestsPerNetwork	32	单个索引器网络最多跟踪的箱子数量
maxPipesPerNetwork	128	单个网络中最多的管道数量
maxConcurrentTransfers	16	每个网络同时进行的传输数量上限
indexerBufferReceptionSize	3	接收缓冲区槽位
indexerBufferEnvoiSize	3	发送缓冲区槽位
allowMultipleIndexersPerNetwork	false	允许一个已连接网络中存在多个索引器
dropItemsOnNetworkFailure	true	网络故障时，将运输中的物品掉落到世界中（而非丢失）
debugMode	false	详细日志记录（路由/广度优先搜索）——生产环境请关闭

高级路由权重（routingCostAlpha/Beta/Occupied、deadlockBackoffTicks、pipeCapacityPacketsPerSecond 等）可用于调优吞吐量与公平性之间的平衡。

分析统计

本模组会向 HStats 报告匿名服务器统计数据（服务端及模组数量和版本——不含用户名、IP 地址或世界数据）。这是一个极小且尽力而为的 ping 请求，可通过 HStats 在服务器目录中创建的 hstats-server-uuid.txt 文件（enabled=false）在服务器范围内禁用。