OritechDefender

模组

· 作者 vicuna

OritechDefender 是一个服务端 NeoForge 性能模组,用于减少由 Oritech 机器同步产生的冗余编码和传输。

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

需要前置:Oritech

最新 1.0.1 · 1.21.1 · NeoForge

一键开服(送7天)

OritechDefender

OritechDefender 是一款服务端 NeoForge 性能模组,旨在减少由 Oritech 机器同步产生的冗余编码与传输。

当同一个 Oritech 方块实体在短时间内产生多个绝对状态更新时,OritechDefender 会保留最新的状态,并根据真实的区块追踪、连接可写性以及受限的发送预算安全地发送该状态。

默认模式为 OBSERVE(观察)。它会在不改变数据包传输的情况下记录真实统计数据。管理员可以在切换到 ENFORCE(强制执行)之前查看结果。

功能特性

  • 合并 Oritech 的 TICK 和 SPARSE_TICK 绝对状态更新;
  • 仅保留每个方块实体的最新待处理状态;
  • 仅向实际追踪相关区块的玩家发送更新;
  • 为每位玩家使用独立的队列,防止慢速连接阻塞正常运行的玩家;
  • 应用有效载荷计数预算、估算字节预算以及 Netty 背压机制;
  • 在发送前立即重新验证维度、区块、方块实体身份以及玩家追踪状态;
  • 报告真实的请求、编码、合并、传输、延迟和积压统计数据;
  • 可随时切换至 OFF 以恢复 Oritech 的原始传输路径。

实际运行结果

以下累计统计数据是在真实服务器的一次长时间运行会话中记录的:

类型 请求数 已编码数 编码缩减率
TICK 4,768,552 1,076,220 约 77.43%
SPARSE_TICK 123,237 120,114 约 2.53%
总计 4,891,789 1,196,334 约 75.54%

编码缩减率的计算公式为 1 - encoded / requested。结果取决于机器数量、玩家数量、区块追踪情况以及配置。编码缩减率并不等同于网络接口流量的缩减率。

安全边界

OritechDefender 仅管理 Oritech 的 TICK 和 SPARSE_TICK 广播:

  • INITIAL、GUI_OPEN、GUI_TICK 和 CUSTOM 始终直接通过;
  • 定向的 sendUpdate(type, player) 同步始终直接通过;
  • 机器的 ticking、能量、物品、流体、配方、NBT 和世界数据均未被修改;
  • 不会强制加载区块;
  • 不会写入世界 SavedData;
  • 当版本或精确注入点不匹配时,优化将保持禁用状态;
  • 队列已满、线程或实体验证失败或编码异常时,会保留原始传输路径。

OritechDefender 不需要进行世界数据迁移。停止服务器并移除其 JAR 文件即可恢复到未安装状态。

要求

  • Minecraft: 1.21.1
  • 加载器: NeoForge 21.1.240 或更高版本(21.1.x 系列)
  • Oritech: 1.2.8
  • 安装端: 仅限服务端
  • Java: 21

OritechDefender 会验证完整的 Oritech 1.2.8 JAR 指纹以及所需的 Mixin 注入点。如果使用不同、经过修改或不支持的 Oritech 构建版,将被报告为 PASS_THROUGH(直通);不会强制启用优化。

安装步骤

  1. 停止服务器。
  2. 备份 world、mods 和 config 目录。
  3. 将 OritechDefender 的 JAR 文件放入服务器的 mods 目录中。
  4. 确保已安装受支持的 Oritech 1.2.8 JAR 文件,文件名为 oritech-neoforge-1.21.1-1.2.8.jar。
  5. 启动服务器。
  6. 运行 /oritechdefender status。
  7. 确认 Oritech 被报告为 SUPPORTED,然后在具有代表性的峰值负载期间保持 OBSERVE 启用状态。
  8. 确认统计数据和服务端状态健康后,运行 /oritechdefender mode enforce。

客户端无需安装 OritechDefender。

命令

/oritechdefender status

显示当前模式、兼容性门控、钩子活动、请求/编码/合并/传输计数器、调度器计时、积压、背压、失效和安全打开(fail-open)统计数据。

/oritechdefender top [1..60]

显示选定时间窗口内最繁忙的维度、区块和 Oritech 同步类型。

/oritechdefender player <name>

显示指定玩家的待处理数量、最旧条目年龄、上一刻传输量、连接可写性以及压力状态。

/oritechdefender mode <off|observe|enforce>

  • OFF: 使用 Oritech 的原始传输行为。
  • OBSERVE: 记录统计数据但不改变传输方式。
  • ENFORCE: 启用安全的合并、独立队列和背压机制。

此命令需要权限等级 2。所选模式会持久化保存到配置文件中。

/oritechdefender reload

重新加载配置文件。需要权限等级 2。

/oritechdefender resetstats

清除累积的统计数据。需要权限等级 2。

阅读统计数据

  • requested: 由 Oritech 发起的同步请求;
  • encoded: 实际进行编码的 Oritech 有效载荷;
  • coalesced: 被更新状态替换因而未单独发送的请求;
  • sent: 实际发送给玩家的目标-有效载荷;
  • deferred: 因预算或背压而推迟的调度尝试;
  • pending: 当前等待在玩家队列中的状态;
  • oldest: 最旧待处理条目的年龄;
  • failOpen: 安全检查失败时保留原始路径的次数;
  • queueFull: 有界队列达到配置限制的次数。

sent 可能高于 encoded,因为一个已编码的有效载荷可以发送给追踪同一区块的多名玩家。

推荐部署流程

OBSERVE → ENFORCE → 如有需要则切换为 OFF

在具有代表性的峰值负载期间保持 OBSERVE 启用状态,并在启用 ENFORCE 之前保存 status 和 top 60 的输出。如果出现任何问题,请立即运行:

/oritechdefender mode off

配置

首次启动服务器时会创建:

config/oritechdefender-server.toml

默认最小同步间隔:

  • TICK: 10 ticks
  • SPARSE_TICK: 100 ticks

默认设置优先考虑状态新鲜度和安全回滚。增加这些间隔可能会减少更多编码开销,但也会增加客户端可见的状态延迟。建议不要在没有受控对比测试的情况下进行激进更改。

问题反馈

在报告问题时,请包含以下内容:

  • Minecraft、NeoForge、OritechDefender 和 Oritech 的版本;
  • /oritechdefender status 命令的脱敏输出;
  • 当前配置文件;
  • 最小化复现步骤;
  • 相关日志和异常堆栈跟踪;
  • 切换至 OFF 是否能停止该问题。

发布前请移除服务器地址、玩家信息、认证令牌、RCON 密码及其他敏感数据。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源