Not Enough Bandwidth Fabric

模组

· 作者 Trirrin

通过数据包头部索引、聚合 + Zstd 压缩、延迟区块缓存以及持久化的客户端区块去重来优化网络带宽。

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

需要前置:Fabric API

最新 1.0.4+1.21.1 · 1.21.1 · Fabric

一键开服(送7天)

带宽不足 (NEB) — Fabric 移植版

适用于 Minecraft 1.21.4 的 Fabric 模组 —— 通过数据包头部索引、聚合与 Zstd 压缩、延迟区块缓存以及持久化客户端区块去重,实现网络带宽优化。

需要支持或为其他版本移植? 请在 GitHub Issues 提交问题,加入 QQ 群 362669270 (邀请链接),或发送邮件至 support@rms.net.cn。

这是由 USS_Shenzhou 开发的原始 NeoForge 模组 的非官方 Fabric 移植版。 如果您希望参与上游项目的开发,请先在 Discord 上与 USS_Shenzhou 讨论。

简介

NEB 使用多种方法在《Minecraft》游戏过程中尽可能节省网络流量,同时对模组和玩家保持透明。

在 TeaCon Jiachen 数据集中,与未压缩的原始数据相比,NEB 理论上可将服务器的出站流量降低至原始大小的 7.6%。作为对比,《Minecraft》原版默认压缩机制的出站流量为原始数据大小的 39%。

在 Vanilla 环境下的测试中,服务器出站流量被降低至原始大小的 18%。随着已安装模组数量的增加,压缩性能会进一步提升。

在游戏中按下 Alt+N 可查看网络流量状态。

主要功能

紧凑的数据包头部

通过用紧凑的 VarInt 索引替换数据包头部 Identifier(数据包类型),优化了 CustomPacketPayload 的编码和解码过程。这将模组网络数据包头部的开销固定为 3-4 字节,而不是对应网络数据包类型的字符串长度。

[!NOTE]

固定的 8 位头部

+------------- 1 byte (8 bits) ---------------+
|               function flags                 |
+---+---+--------------------------------------+
| i | t |      reserved (6 bits)               |
+---+---+--------------------------------------+
  • i = indexed(已索引,1 位)
  • t = tight_indexed(紧密索引,1 位,仅在 i=1 时有效)
  • reserved = 保留位(6 位,供将来使用)

索引式数据包类型

  • 如果 i=0(未索引):随后跟随完整的 UTF-8 Identifier。
  • 如果 i=1 且 t=0(已索引,非紧密):3 字节 — 12 位命名空间 ID + 12 位路径 ID(每个容量为 4096)。
  • 如果 i=1 且 t=1(已索引,紧密):2 字节 — 8 位命名空间 ID + 8 位路径 ID(每个容量为 256)。

聚合与压缩

优化了原版经常产生大量小型网络数据包的情况。在 Connection 级别拦截传输,每 20ms 将它们组装成一个大型网络数据包,并在经过 Zstd 压缩后发送。

[!NOTE]

+---+-----+----+----+----+----+----+----...
| B | (S) | p0 | s0 | d0 | p1 | s1 | d1 ...
+---+-----+----+----+----+----+----+----...
          +--packet 1---++--packet 2---+
          +---------compressed---------+
  • B = bool,是否已压缩
  • S = varint,未压缩数据的大小(仅在压缩时存在)
  • p = prefix(前缀,medium/int/utf-8),此子数据包的类型
  • s = varint,此子数据包的大小
  • d = bytes,此子数据包的数据

延迟区块缓存 (DCC)

在 Vanilla 中,当玩家移动时,服务器会指示客户端立即遗忘其身后的区块;如果玩家回到原来的位置,则必须再次发送完整的区块数据。通过延迟这种“遗忘”行为,可以节省来回移动时产生的区块传输流量。

持久化区块缓存 (PCC)

使用本地 LevelDB 数据库,以 64 位内容哈希为键,在客户端持久化缓存区块数据。每次连接时,客户端将所有缓存区块哈希的布隆过滤器发送给服务器。当服务器准备发送一个哈希存在于过滤器中的区块时,它只发送 20 字节的哈希值,而不是完整的数据包(约 10–20 KB)。客户端从其本地数据库中加载该区块。在布隆过滤器出现误报时,客户端请求完整数据作为回退。布隆过滤器每新增 64 个缓存区块刷新一次,以便在同一会话内生效。

配置

修改位于 config/NotEnoughBandwidthConfig.json 的配置文件。

compatibleMode

在客户端和服务端独立工作。

是否启用兼容模式。如果设置为 true,将使用下面的 blackList。

blackList

在客户端和服务端独立工作。

兼容模式的黑名单。此处列出的数据包将被 NEB 跳过。您可以根据需要添加数据包。

[!WARNING] 为确保数据包顺序,黑名单中的数据包的到达将中断正在进行的聚合。如果黑名单中有许多数据包,或者对应的数据包发送过于频繁,聚合压缩的效率会降低。

compressionLevel

在客户端和服务端独立工作。

Zstd 压缩级别(整数 1-19)。默认为 6。较高的值会产生更好的压缩效果,但会使用更多的 CPU。

contextLevel

在客户端和服务端独立工作。

Zstd 上下文窗口大小(整数 21-25,代表 2-32MB)。默认为 23(8MB)。较大的值会导致更好的压缩效果,但会消耗更多内存。

[!TIP] 对于拥有 100 名玩家的服务器,设置为 25 将导致大约 3200MB 的额外内存占用。

dccSizeLimit, dccDistance, dccTimeout

仅限服务端。

延迟区块缓存 (DCC) 参数:最大缓存区块数、缓存距离、缓存超时时间(秒)。较大的值可能会消耗更多内存,而较小的值可能会更频繁地触发更新。

chunkCacheEnabled

仅限客户端。

是否启用持久化区块缓存。默认为 true。

chunkCacheMaxSizeMB

仅限客户端。

本地区块缓存数据库的最大大小(以 MB 为单位)。默认值为 2048(2 GB)。

安装

依赖:

  • Minecraft 1.21.4
  • Fabric Loader >= 0.18.0
  • Fabric API

客户端和服务器都必须安装 NEB。 当没有安装 NEB 的客户端连接时,服务器对该连接将回退到原版行为。

许可证

版权所有 (C) 2025 USS_Shenzhou

本模组是 GNU GPL 3.0 下的自由软件。详情请参阅 LICENSE。

额外许可

作为游戏玩家,当您在 Minecraft 中加载并运行此程序时,本许可证自动授予您所有必要的权利,这些权利未被 GPL-3.0 许可证涵盖,或被 GPL-3.0 许可证所禁止,但属于在 Minecraft 中正常加载和运行此程序所需的权利。若 GPL-3.0 许可证与 Minecraft EULA 或其他 Mojang/Microsoft 条款发生冲突,以后者为准。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源