使用文档

快速入门

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

P2P 联机教程

P2P（点对点）模式是 MCT 的经典联机方案，基于 OpenP2P 实现 NAT 穿透打洞，适合大多数网络环境。

房主操作

1. 打开 MCT 联机工具，选择 P2P 联机 模式
2. 点击 "创建房间" 按钮
3. 程序会自动下载并启动 OpenP2P 核心
4. 生成提示码后，将提示码分享给好友
5. 在 Minecraft 中开放局域网世界，记录端口号

加入方操作

1. 打开 MCT 联机工具，选择 P2P 联机 模式
2. 点击 "加入房间" 按钮
3. 输入房主分享的提示码
4. 输入 Minecraft 局域网世界的端口号
5. 等待连接成功，通过虚拟 IP 加入游戏

ET 房间模式

ET 房间模式是基于 EasyTier 的全新联机方案，采用 Scaffolding 协议实现虚拟局域网，适合复杂网络环境。

创建房间

1. 打开 MCT 联机工具，选择 ET 房间 模式
2. 点击 "创建房间" 按钮
3. 程序会自动获取公共节点列表
4. 生成 Scaffolding 协议房间码
5. 将房间码分享给好友

加入房间

1. 打开 MCT 联机工具，选择 ET 房间 模式
2. 点击 "加入房间" 按钮
3. 输入房主分享的房间码
4. 等待连接成功，查看虚拟 IP 列表
5. 通过虚拟 IP 直接加入 Minecraft 游戏

玩家列表

ET 房间模式支持实时玩家列表显示，你可以看到：

• 当前房间所有玩家的虚拟 IP
• 每个玩家的实时 Ping 值
• 连接状态与网络质量

设置说明

MCT 联机工具提供丰富的设置选项，满足不同用户的需求。

网络设置

设置项	说明	默认值
自定义端口	设置 Minecraft 局域网世界的端口号	自动检测
TCP/UDP 切换	选择连接使用的网络协议	TCP
OLAN 兼容模式	兼容部分特殊网络环境	关闭
管理员模式	提升程序权限以优化连接	提示

高级设置

设置项	说明	默认值
Probe 探针	匿名上报版本号帮助开发者统计	开启
自定义提示码	设置个性化的房间提示码	随机生成
敏感词过滤	自动检测并过滤不当提示码	开启

常见问题

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

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

0. P2PNetWork Login Error

1️⃣ No further information

症状：连接时弹出含 further 字样提示。

根因：房主端口 / 提示码填错，或自己手滑。

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

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

根因：正版验证挡路。

对策：

• 方案 A：全部换 外置登录（LittleSkin）
• 方案 B：装 自定义局域网联机 Mod 关闭验证

2.1 文件含病毒提示

根因：Windows Defender 误杀。

对策：进入程序的 设置 → WDF 加白，点一下即可。

3️⃣ 未知主机

根因：中文冒号 ： 混入。

对策：一律使用英文 :，或直接点复制按钮。

4️⃣ 是否支持其他启动器？

答：完全 OK！工具与启动器零耦合，喜欢哪个用哪个。

5️⃣ Invalid characters in username

根因：昵称违规。

规范：3-16 位，仅英文大小写、数字、下划线，禁中文。

6️⃣ Connection refused: getsockopt

根因：P2P 打洞中。

对策：等 30-60s；若仍拒绝，换预览版本再试。

7️⃣ 进服后秒退 / 掉虚空 / 区块不刷

快速修复：房主把 渲染距离 & 模拟距离 调到 2 区块，全员站稳后再拉高。

7.1 高延迟偶发卡掉

• 检查路由稳定性，重启光猫 / 路由
• 关闭游戏特效，降低视距
• 精简 Mod 列表，避免带宽爆炸

8️⃣ 联机皮肤不显示

捷径：直接外置登录 → LittleSkin 一键换肤；或装万能皮肤补丁 Mod。

9️⃣ 聊天消息验证失败

解药：装 No Chat Reports Mod（1.19.1+ 专属）。

🔟 Index *** out of bounds

两大元凶：

• 用户名 >16 位或含中文
• 某 Mod 代码越界 → 查日志 → 移除或反馈作者

1️⃣1️⃣ 数据包过大

常见三胞胎提示：

• Tried to read NBT tag that was too big
• Badly compressed packet
• Packet too big

万能钥匙：装 Packet Fixer（群文件有最新版）。

1️⃣2️⃣ NAT 类型导致的联机噩梦

12.1 提升 NAT 等级

• 光猫改桥接：拿到超管密码 → 切桥接 → 路由拨号
• 路由开 uPnP / Full Cone / DMZ：把主机 IP 扔进 DMZ

图文教程 B 站直通车：bilibili.com/opus/885294846817861638

1️⃣3️⃣ java.lang.NullPointerException NBT 空指针

AI 速译：

• 插件 / Mod 冲突 → 逐个禁用排查
• 世界数据损坏 → 用备份恢复或 NBT 修复工具
• 版本不兼容 → 统一服务端 / 客户端版本
• 配置错误 → 检查自定义 NBT 文件格式

1️⃣4️⃣ 软件已连接但游戏进不去

玄学解法：

• 刷新 DNS：ipconfig /flushdns
• 重启工具 & 游戏
• 再不行 → 复制日志找群主 ad1va

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

症状：日志出现 wait tcp handshake timeout 或 p2pTunnel listen error

对策：

• 确认使用的是最新版本
• 下载预览版尝试
• 运行软件自带的网络优化功能
• 运行功能测试软件诊断问题

1️⃣6️⃣ 游戏帧率周期性卡顿

症状：玩游戏时帧率隔一段时间忽然卡几下然后恢复正常

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

1️⃣7️⃣ 第二次上线物品全部丢失

症状：朋友在第二次上线时发现物品全部丢失

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

对策：使用上次联机用的相同名称

1️⃣8️⃣ 支持其他游戏吗？

答：可以！在设置-兼容选项可以找到泰拉瑞亚。

原理：理论上支持局域网联机的游戏都可以用此软件来辅助联机。

1️⃣9️⃣ IndexOutOfBoundsException 网络数据包错误

症状：报错 Internal Exception: io.netty.handler.codec.DecoderException: java.lang.IndexOutOfBoundsException

根因：网络传输数据时出现问题，尝试读取超出了数据流的有效范围

对策：

• 确保游戏版本匹配
• 检查网络连接稳定性
• 更新或重装游戏
• 检查插件或模组，尝试禁用排查
• 增加服务器端内存

2️⃣0️⃣ IPv4 显示为 0

症状：联机时 IPv4 死活为 0

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

2️⃣1️⃣ 地区联机被阻断

症状：某些地区无法联机

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

说明：此问题暂时无法解决，属于运营商阻断

2️⃣2️⃣ hasIPv4 和 UPNP 为 9

症状：日志中 hasIPv4 和 UPNP 显示为 9

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

2️⃣3️⃣ 缺少 DLL / 无法定位链接库

症状：出现"无法定位链接库""缺少 xxxxxxxx.dll"

根因：缺少 .NET 运行库

对策：

• 0.0.7 用户：请先安装 .NET 8 Runtime
• 旧版本用户：自行去微软官网安装 .NET Framework

2️⃣4️⃣ HRESULT: 0x8007007A

症状：软件出现异常报错 HRESULT: 0x8007007A

对策：

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

🆘 未收录的新问题

故障排查

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