NetUtils

NetUtils

一个用于协议调试和状态同步测试的网络实用工具。

游戏机制

NetUtils

一个强大的网络工具,用于 Minecraft 协议调试、状态同步测试和网络分析。基于 Architectury API 构建,支持 Fabric 和 NeoForge。

本工具仅用于教育和调试目的。 使用它在多人服务器上获取不公平优势或执行漏洞利用,违反大多数服务器规则和平台服务条款。开发者不纵容作弊/刷物品行为。请自行承担使用风险,并仅在你获得明确许可的情况下使用本模组。


本项目具体提供什么?

NetUtils 添加了一套全面的客户端调试工具,让你能够以原版客户端无法做到的方式与 Minecraft 网络层进行交互:

  • 数据包流控制:拦截、延迟或完全切换出站数据包,以测试服务器端的响应时间和处理逻辑。
  • 物品栏状态操控:实验客户端-服务器失同步(例如,在本地关闭界面而不通知服务器),以测试状态处理逻辑。
  • 详细数据提取:查看内部菜单信息(同步 ID、类名),列出带有内部 ID 的村民交易,并检查 GUI 槽位元数据。
  • 资源包管理:绕过或强制拒绝服务器请求的资源包,以进行环境隔离测试。
  • 增强的客户端命令:一个自定义命令系统(使用 ^ 前缀)用于底层交互,包括发送原始数据包和循环执行。

为什么你应该使用 NetUtils?

  • 模组与插件开发:如果你正在开发依赖复杂物品栏或网络逻辑的模组或服务器插件,NetUtils 是一个宝贵的工具,可以针对“非法”或意外的客户端状态对你的代码进行压力测试。
  • 协议学习:非常适合希望通过实时观察和操控数据包来理解 Minecraft 网络协议的开发者和研究人员。
  • 网络韧性测试:使用失同步和数据包延迟功能,验证你的服务器反作弊或状态恢复系统是否健壮。

关键信息与安全

  • 多人游戏使用:在公共服务器上使用此工具很可能导致永久封禁。它旨在用于私人开发环境。
  • 兼容性:需要 Minecraft 1.21.11+ 和 Architectury API。

功能

  • 数据包控制:延迟或切换出站数据包。
  • 同步:模拟客户端-服务器失同步,用于状态处理测试。
  • 物品栏控制:关闭物品栏界面而不向服务器发送数据包。
  • 资源包控制:绕过或强制拒绝服务器资源包。

使用方法

按 V 键恢复上次关闭的界面。

客户端命令

所有命令使用 ^ 前缀,可在普通聊天或自定义聊天输入框中输入。

  • ^help - 显示所有命令
  • ^toggle - 启用/禁用模组功能
  • ^menuinfo - 显示 GUI 信息(类名、槽位、同步 ID)
  • ^trades - 列出带有 ID 的村民交易
  • ^trade <id> - 自动选择并执行一笔交易
  • ^click <slot> [button] [type] - 点击指定的物品栏槽位
  • ^loop <n> <command> - 将命令重复执行 n 次
  • ^desync - 同步/失同步物品栏状态
  • ^clear - 清除聊天记录
  • ^packets - 列出 ^rawsend 可用的数据包类型
  • ^rawsend <times> <packet> [args] - 强制向服务器发送原始数据包
  • ^save/^load - 保存或恢复当前界面状态

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。