快速入门
MCT联机工具是一款基于 OpenP2P、MCILMLink、EasyTier 的轻量便携 Minecraft 联机工具。只需三步即可开始联机：
创建/加入房间
房主点击"创建房间"生成提示码，加入方输入提示码即可连接。支持 P2P 直连和 ET 房间两种模式。
开始游戏
连接成功后，在 Minecraft 中通过虚拟 IP 或端口加入游戏，即可与好友一起冒险！
P2P 联机教程
P2P（点对点）模式是 MCT 的经典联机方案，基于 OpenP2P 实现 NAT 穿透打洞，适合大多数网络环境。
房主操作
- 打开 MCT 联机工具，选择 P2P 联机 模式
- 点击 "创建房间" 按钮
- 程序会自动下载并启动 OpenP2P 核心
- 生成提示码后，将提示码分享给好友
- 在 Minecraft 中开放局域网世界，记录端口号
加入方操作
- 打开 MCT 联机工具，选择 P2P 联机 模式
- 点击 "加入房间" 按钮
- 输入房主分享的提示码
- 输入 Minecraft 局域网世界的端口号
- 等待连接成功，通过虚拟 IP 加入游戏
ET 房间模式
ET 房间模式是基于 EasyTier 的全新联机方案，采用 Scaffolding 协议实现虚拟局域网，适合复杂网络环境。
创建房间
- 打开 MCT 联机工具，选择 ET 房间 模式
- 点击 "创建房间" 按钮
- 程序会自动获取公共节点列表
- 生成 Scaffolding 协议房间码
- 将房间码分享给好友
加入房间
- 打开 MCT 联机工具，选择 ET 房间 模式
- 点击 "加入房间" 按钮
- 输入房主分享的房间码
- 等待连接成功，查看虚拟 IP 列表
- 通过虚拟 IP 直接加入 Minecraft 游戏
玩家列表
ET 房间模式支持实时玩家列表显示，你可以看到：
- 当前房间所有玩家的虚拟 IP
- 每个玩家的实时 Ping 值
- 连接状态与网络质量
设置说明
MCT 联机工具提供丰富的设置选项，满足不同用户的需求。
网络设置
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 自定义端口 | 设置 Minecraft 局域网世界的端口号 | 自动检测 |
| TCP/UDP 切换 | 选择连接使用的网络协议 | TCP |
| 管理员模式 | 提升程序权限以优化连接 | 提示 |
高级设置
| 设置项 | 说明 | 默认值 |
|---|---|---|
| Probe 探针 | 匿名上报版本号帮助开发者统计 | 开启 |
| 自定义提示码 | 设置个性化的房间提示码 | 随机生成 |
| 敏感词过滤 | 自动检测并过滤不当提示码 | 开启 |
常见问题
⚠ 此部分内容由官方知识库整理，文档信息如有错误/缺失，请到 GitHub 上提交 issue。
基于 由U233 整理的 MCT排障手册v2.0 | 手册更新时间: 2026-06-13 | Web更新时间: 2026-07-14
🧩 通用搜索关键词：复制报错末尾 连续 3-4 个英文单词 到本页 Ctrl+F 可瞬间定位。
0. P2PNetWork Login Error
em，遇到这个报错大概率就无解了。可以尝试设置 网络优化，换一个 DNS 看看能不能冲破封锁，或者加入 QQ 群获取相关帮助。这种一般是运营商阻断，直接无法连上服务器。
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
对策：
- 进系统（Windows）设置 → 时间和语言 → 语言和区域 → 管理语言设置 → 更改系统区域设置
- 把"Beta 版: 使用 Unicode UTF-8 提供全球语言支持"前的勾选取消
2️⃣5️⃣ MCT 提示节点服务器连接失败的
说明：字面意思，你所在的地区的 P2P 服务器寄了，切换 Link 模式或者等
🆘 未收录的新问题
如还有其他问题没有在此文档出现过：
请优先使用 MCT AI（软件上栏从左往右第一个按钮）分析日志，还不行再改用群主 Ad1va 或其他在线管理员，会优先回复。
注意：出现在这个文档的问题，优先按照本文档的步骤解决。如果问题未解决，再联系群主 ad1va 或其他在线管理员！
故障排查
遇到问题？按照以下步骤进行排查：
检查 .NET 运行时
确保已安装 .NET 8.0 运行时。可以在命令行运行 dotnet --version 检查版本。
检查防火墙设置
确保 MCT 程序被允许通过 Windows 防火墙。尝试暂时关闭防火墙测试。
以管理员身份运行
右键程序选择「以管理员身份运行」，这可以解决大部分权限相关的问题。
切换网络环境
尝试切换为手机热点或其他网络，排除网络运营商对 P2P 的限制。
联系社区支持
如果以上方法都无效，请加入 QQ 交流群 或提交 GitHub Issue。