AntiNbtKick

AntiNbtKick

一个模组,可防止你的玩家拾取超过NBT数据限制的物品,并总体上防止被踢出。

优化

AntiNbtKick

一个 Fabric 模组,可防止玩家因物品栏中 NBT 数据过大而被踢出服务器。该模组会智能地监控并限制物品栏大小,保护你免遭服务器踢出,同时仍允许你有效地管理物品。

功能特性

🛡️ 物品栏大小保护

  • 智能大小检测:使用 Minecraft 基于 CODEC 的编码方式精确计算物品的字节大小
  • 最大限制:对物品栏总数据(包括所有槽位和元数据开销)强制执行 1,777,777 字节的限制
  • 元数据计算:每个槽位计入 128 字节的开销,以便正确追踪大小

📦 全面的物品栏监控

该模组会追踪并检查:

  • 主物品栏槽位(36 个槽位)
  • 快捷栏(9 个槽位)
  • 副手槽位
  • 盔甲槽位(4 个槽位)
  • 所有 NBT 数据和物品属性

🚫 多重模式保护

地面物品拾取:

  • 阻止拾取会超出物品栏限制的物品
  • 静默阻止收集过大的物品

容器交互(生存模式与创造模式):

  • Shift 点击:如果从容器移入你的物品栏会超出限制,则阻止该操作
  • 单次点击:阻止将过大的物品放入你的物品栏
  • 拖拽操作:如果拖拽物品进入你的物品栏会超出限制,则阻止该操作
  • 存入容器:允许你自由地将物品从物品栏移入容器,即使已超出限制

创造模式保护:

  • 如果创造模式放置物品会超出限制,则阻止该操作
  • 阻止会溢出物品栏的创造模式拖拽/绘制操作
  • 阻止对过大物品进行创造模式克隆(中键点击)

🎮 便捷的开关命令

使用简单的聊天命令控制该模组:

命令 描述
/apk 显示当前模组状态
/apk toggle 切换模组开启/关闭
/apk on 启用模组
/apk off 禁用模组
/apk status 显示详细状态

状态消息使用颜色编码:

  • 🟢 绿色:模组已启用
  • 🔴 红色:模组已禁用

工作原理

大小计算

该模组使用 Minecraft 原生的 ItemStack.CODEC 将物品精确编码为 NBT 格式,并测量其序列化后的字节大小。这与服务器计算物品栏数据大小的方式一致,确保结果一致。

智能拦截

该模组会智能地:

  1. ✅ 允许从地面拾取物品(除非已达到限制)
  2. ✅ 允许将物品存入容器(清理物品栏)
  3. ✅ 允许在自己的物品栏内移动物品
  4. ❌ 阻止添加会超出限制的新物品
  5. ❌ 阻止从容器拖拽物品进入物品栏
  6. ❌ 阻止创造模式放置过大的物品

配置

  • 默认状态:启动时启用
  • 可切换:使用 /apk toggle 随时启用/禁用
  • 无配置文件:开箱即用,采用合理的默认设置

安装

  1. 下载模组 JAR 文件
  2. 将其放入你的 .minecraft/mods 文件夹
  3. 使用 Fabric Loader 启动 Minecraft
  4. 模组将默认处于启用状态

环境要求

  • Minecraft:1.21.4 或更高版本
  • Fabric Loader:0.16.4 或更高版本
  • Java:21 或更高版本
  • Fabric API:任何与你的 Minecraft 版本兼容的版本

故障排除

问:我无法将物品放入物品栏 答:你的物品栏可能已达到或接近 1,777,777 字节的限制。使用 /apk off 禁用模组,或将物品存入容器。

问:我可以将物品拖入容器吗? 答:可以!即使超出限制,你始终可以将物品从物品栏移入容器。这是清理物品栏的预期方式。

问:这会影响多人游戏吗? 答:会,该模组可在任何服务器上保护你。它会防止你达到会导致踢出的服务端 NBT 大小限制。

问:我可以禁用该模组吗? 答:可以!使用 /apk off 禁用所有保护。使用 /apk on 重新启用。

致谢

  • 原作者:UnicornMaster-Dev
  • Minecraft 版本:1.21.4

远离 NBT 踢出困扰! ✨