使用文档

快速入门

MCT联机工具是一款基于 OpenP2P、MCILMLink、EasyTier 的轻量便携 Minecraft 联机工具。只需三步即可开始联机：

🎮 联机教程已独立成页 查看 P2P、ET 房间模式与完整联机流程 前往教程 →

常见问题

⚠ 此部分内容由官方知识库整理，文档信息如有错误/缺失，请到 GitHub 上提交 issue。

基于 由U233 整理的 MCT排障手册v2.0 | 手册更新时间: 2026-06-13 | Web更新时间: 2026-07-14

🧩 通用搜索关键词：复制报错末尾 连续 3-4 个英文单词 到本页 Ctrl+F 可瞬间定位。

0. P2PNetWork Login Error

1️⃣ No further information

根因：房主提供的端口或提示码错误，或是自己输错了

对策：双人核对后再敲，别盲猜！若确认无误，请查看联机工具箱是否报错。

2️⃣ 登入失败，无效的会话

根因：正版验证导致的

对策：

• 外置登录 或 加 自定义局域网联机 Mod 以关闭验证

2.1 开启核心后提示：无法成功完成操作，因为文件包含病毒或潜在的垃圾软件

根因：可能是被杀软误杀了呢喵~

对策：可能是 Windows 安全中心捣的鬼，在"设置"中选中 WDF 加白；如果有其他杀毒软件，请将软件加入扫描排除项

3️⃣ 未知主机

根因：IP 格式错误，请勿使用中文冒号，或填写错误

对策：仔细检查，一律使用英文 :

4️⃣ 可以使用其他启动器吗？

答：可以

5️⃣ Invalid characters in username

完整报错：Internal Exception: java.lang.IllegalStateException: Invalid characters in username

根因：用户名不合规

对策：更改用户名，要求仅可出现英文大小写、数字、英文下划线，3-16 位，不可使用中文用户名。详见 Minecraft 玩家 ID 命名规范。

6️⃣ Connection refused: getsockopt

根因：P2P 正在打洞，请稍等片刻

对策：长时间无响应请使用预览版本

7️⃣ 进入后一直掉线（或加载不出地形 / 掉虚空等类似描述）

快速修复：尝试房主把 渲染距离和模拟距离 调到最低，加入方进入后稳定后再调回来

7.1 进入虽然不掉线，但延迟很高，偶尔就会卡掉线

• 检查你的网络稳定性，尝试重启路由器或更换更稳定的网络连接
• 在游戏设置中降低图形和网络相关的选项，比如关闭一些不必要的特效，减少延迟
• 房主端请调低视距，双方启用网络优化，如果有过多的 Mod，请按需减少，可能是 Mod 数量过多的原因

8️⃣ 联机皮肤不显示

推荐：直接外置登录，在皮肤站设置皮肤就行了；或者打个皮肤 Mod

9️⃣ 聊天消息验证失败

解药：安装禁用聊天举报 Mod（相关链接见群聊精华）

🔟 Index *** out of bounds for length ***

根因：程序访问超出数组长度的索引

• 用户名长度过长，正常用户名长度应该不超过 16 位，并且不应该出现中文
• 某个 Mod 存在漏洞，这个报错属于编程错误，请查看游戏日志，检查玩家进入时的报错，移除相关 Mod，有能力的话请反馈给 Mod 开发者

1️⃣1️⃣ 数据包过大可能的报错

11.1 读取过大的 NBT 标签时被踢出

提示：Tried to read NBT tag that was too big; tried to allocate: Xbytes where max allowed: 2097152；或是压缩后的数据包过大被踢出，提示 Badly compressed packet - size of X is larger than protocol maximum of 2097152

11.2 发包过大被踢出

提示：Attempted to send packet over maximum protocol size: 8388608 / Packet too big (is X, should be less than 8388608)；或是 Payload 过长被踢出，提示 Payload may not be larger than X bytes

对策：可以安装 Mod 以修复此问题，详见群聊精华消息

11.3 客户端 Connection Lost 错误

症状：服务器上的数据包发送失败或被拒绝，客户端可能会被断开连接

对策：确保所有插件或 Mod 都是最新版本，有时这些问题可能由不兼容或过时的插件引起

1️⃣2️⃣ NAT 类型导致的联机过慢或连接失败

12.1 提升 NAT 类型的途径和方法

• 修改光猫工作模式：把光猫工作模式设置为桥接模式，这就是获取光猫超级密码的目的。无线路由器直接连到猫上就可以上网的，说明光猫是路由模式；无线路由器需要 PPPoE 拨号上网的就是桥接模式。
• 更改路由器设置：如果无线路由器有启用 Full Cone、uPnP 等功能，果断启用。特别是启用 uPnP，绝大部分路由器都支持。另外大部分路由器都支持 DMZ，把你要提升 NAT 类型的主机 IP 地址设置好，设置之前把主机的 IP 设置为静态的。
• 检查 Windows 系统服务：以下三个服务是否自动开启，如果未开启，则设置为自动启动。另外在系统防火墙将需要的程序添加例外：
  • Function Discovery Provider Host
  • Function Discovery Resource Publication
  • SSDP Discovery

图文教程：bilibili.com/opus/885294846817861638

1️⃣3️⃣ Internal Exception: java.lang.NullPointerException: Cannot invoke 'net.minecraft.nbt.CompoundTag.m_128459_(String)' because 'nbt' is null 或相似报错

AI 解答（仅供参考）：这个错误通常与 Minecraft 服务器的 NBT 数据格式有关，可能是因为某个操作尝试读取或修改一个空的 NBT 数据，导致空指针异常。具体原因可能有以下几种：

• 插件或 Mod 冲突：如果你安装了多个插件或 Mod，它们可能会互相冲突，导致 NBT 数据错误。你可以尝试禁用或删除最近添加的插件或 Mod，然后重新测试。
• 世界数据损坏：如果你的世界文件损坏，可能导致 NBT 标签读取错误。你可以尝试通过备份恢复世界，或者用工具修复损坏的文件。
• 版本不兼容：Minecraft 的不同版本可能在 NBT 标签的结构上有所变化。如果你的服务器版本和客户端版本不匹配，或者是你在使用某个不兼容的插件/Mod，可能会导致这个问题。确保你使用的所有插件和 Mod 与服务器版本兼容。
• 配置文件问题：如果你使用的是自定义配置文件（比如某些插件或 Mod 需要的），确保配置文件的格式正确，没有缺失或错误的标签。

1️⃣4️⃣ 软件显示已连接但无法游玩？！

解决方法：刷新一下 DNS 试一下呢喵~~

ipconfig /flushdns

1️⃣5️⃣ ERROR wait tcp handshake timeout / p2pTunnel listen error: wait tcp handshake timeout

对策：

• 确认自己用的是最新版，还是不行下载预览版或联系管理
• 运行软件自带的网络优化
• 运行功能测试软件诊断问题

1️⃣6️⃣ 玩游戏帧率隔一段时间忽然卡几下然后恢复正常

对策：按 F3 观察右上角（分配给 Java 的）内存使用情况，如果经常超过 90%，请在启动器中增加分配的内存。

1️⃣7️⃣ 朋友在第二次上线时发现物品全部丢失

原因：使用了不同的名称加入联机导致 UUID 发生变化

解决：使用上次联机用的名称

1️⃣8️⃣ 这东西还能干其他的吗？

答：可以。在设置-兼容选项可以找到泰拉瑞亚。理论上支持局域网联机的游戏都可以用此软件来辅助联机。

1️⃣9️⃣ Internal Exception: io.netty.handler.codec.DecoderException: java.lang.IndexOutOfBoundsException

完整报错：Internal Exception: io.netty.handler.codec.DecoderException: java.lang.IndexOutOfBoundsException: readerIndex(43150) + length(1) exceeds writerIndex(43150): UnpooledHeapByteBuf

AI 解答（仅供参考）：这个错误通常出现在《我的世界》联机时，可能是由于网络传输数据时出现问题导致的。IndexOutOfBoundsException 说明尝试读取超出了数据流的有效范围。这可能是因为数据包被损坏、客户端和服务器之间的版本不匹配，或者是某些插件导致的。

对策：

• 确保你和你的朋友都在使用相同的游戏版本
• 检查网络连接是否稳定，网络波动可能导致数据包丢失或损坏
• 重新安装《我的世界》，确保游戏文件完整
• 检查安装的插件或模组，试着禁用它们排查问题
• 增加服务器端分配的内存

2️⃣0️⃣ 联机时 IPv4 死活为 0 的

对策：找群主或管理下载特质版软件

2️⃣1️⃣ 有关地区联机被阻断问题

判断：观察日志是否出现了 P2P Login ERROR

说明：此问题暂时无法解决

2️⃣2️⃣ 有不能链接或类似情况，日志中 hasIPv4 和 UPNP 为 9

对策：请更新到软件最新版本

2️⃣3️⃣ 出现"无法定位链接库""缺少 xxxxxxxx.dll"

根因：缺少 .NET Framework 运行库，自行去微软官网安装

2️⃣4️⃣ 软件出现异常报错：HRESULT:0x8007007A

对策：

1. 进系统（Windows）设置 → 时间和语言 → 语言和区域 → 管理语言设置 → 更改系统区域设置
2. 把"Beta 版: 使用 Unicode UTF-8 提供全球语言支持"前的勾选取消

2️⃣5️⃣ MCT 提示节点服务器连接失败的

说明：字面意思，你所在的地区的 P2P 服务器寄了，切换 Link 模式或者等

🆘 未收录的新问题

故障排查

遇到问题？按照以下步骤进行排查：