VoxLink
在大厅里与朋友一起游玩,或结识新朋友 :D
如何游玩
打开你的世界,创建一个房间,获取一个 6位数字代码,将其发送给你的朋友,他们在输入框中输入即可。无需端口转发,无需路由器设置,无需服务器,你甚至不需要知道什么是公网 IP。安装模组,创建房间,发送代码,搞定。
通常能在几秒钟内连接成功——连接时间和成功率取决于双方的网络状况:同运营商的家庭宽带几乎总是能连通;校园网、办公网络、手机热点可能会有波动。如果直连困难,模组会自动回退到对等中继(peer relay)或 TURN 中继。首次连接不稳定?让双方重启游戏以刷新 NAT 端口。我们每次更新都会改进打洞策略。
Terracotta 集成
从 1.0.4 版本开始,VoxLink 支持与 Terracotta P2P 配合使用(可选,非必需)。你可以直接在模组设置中下载并启用 Terracotta——它可以与其他支持 Terracotta 的工具互操作;如果你进入原生的 VoxLink 房间,VoxLink 自身的打洞过程会与 Terracotta 并行运行。注意:由于技术限制(沙盒机制),目前 Terracotta 无法在 Android 设备上运行——我们稍后会研究解决方案(并且由于虚拟机限制,它也无法读取启动器自带的 Terracotta)。
回退与中继
适用于 VoxLink 1.0.0+
当直接打洞失败时,VoxLink 不会放弃。它备有三招:
- 反向打洞 -- 如果一方的 NAT 阻碍了正向打洞,另一方会发起反向打洞来绕过障碍。
- 对等中继 -- 如果你们双方都无法直连(例如都处于对称型 NAT),VoxLink 会从当前在线的公共大厅玩家中挑选一名合适的玩家作为中继节点。流量将经过该玩家的客户端传输,绝不会经过服务器。中继玩家几乎不会有感知——影响微乎其微。
- TURN 中继 -- 于 1.1.3 添加。打洞 20 秒后会出现一个“使用中继”按钮,由公共中继服务器承载流量。从 1.2.0 起,切换到中继完全自动化,无需点击按钮。P2P 打洞会在后台继续运行 10 分钟,如果成功则平滑切换回直连。中继服务器是有限资源——如果你有闲置的公共服务器?欢迎捐赠~
可以随时在设置中关闭中继功能。关闭后,你既不会为他人提供中继,也无法使用他人的中继。公平合理吧?
特别感谢 XIOPNM,他亲自参与了超过 700 次总测试中的 300 多次远程多人联机测试。我们也想感谢所有在此过程中提供帮助的其他测试人员。
获取主机的模组
于 1.1.2 添加。加入房间时,VoxLink 会获取主机已安装的模组列表,并提供下载你所缺失的模组——之后你需要手动重启游戏。直到 1.1.9 版本,版本查询均通过 Modrinth API 进行;1.2.0+ 增加了 CurseForge。
仅检查依赖完整性——会检测本地与主机模组版本的差异,但不会检测模组兼容性冲突和崩溃风险。如果你是加入陌生人充满强制客户端模组的房间,建议使用干净客户端(仅 VoxLink + Fabric API)以避免崩溃。可在简易设置页面中关闭此功能。
房间
房间无玩家数量限制,离线玩家也可加入。一旦大厅开启,房间名称和自定义标签在展示前会经过 AI 审核。广东与江西之间的延迟测试约为 15-20 毫秒,尽管你的实际 ping 值取决于双方的网络状况。
创建房间时将房间设为公开,它就会显示在大厅中。大厅不会泄露你的 IP 或其他任何信息——仍然是纯 P2P 连接。标签有助于你找到合适的房间。网页面板和游戏内客户端均可浏览大厅;可以从网页复制房间代码,也可以直接从客户端加入。
兼容性
可与 Simple Voice Chat(完美兼容!)、ViaFabric(以及整个 ViaVersion 系列)配合使用。它也兼容中国模组 古人穿越。
现在支持 Forge、NeoForge 和 Fabric 1.20+ ——涵盖 1.20 及以上的所有版本,未来还将支持更多。模组本身支持多语言——提供 12 种语言 可供选择:英语、简体中文、繁体中文、日语、韩语、法语、德语、西班牙语、俄语、葡萄牙语(巴西)、阿拉伯语和文言文。
独立应用
还有一个独立的 VoxLink 应用,适用于任何版本——无需安装模组。它甚至可以为其他游戏进行隧道传输,并支持 Linux、Windows 和 macOS。请查看上方的下载链接。(开发者:该应用也有 CLI 构建版本,欢迎使用。)
发现 Bug?
请访问 https://github.com/AUGUHDAR/VoxLink/issues,带上你的日志文件,包括主机端和加入端的:
.minecraft/versions/<your_version>/logs/latest.log
从 1.1.0 版本开始,日志会自动上传以帮助我们提高打洞成功率。你可以在设置中禁用此功能。VoxLink 永远不会上传或暴露你的私人信息。你也可以在游戏内报告问题或提出建议——反馈界面于 1.1.7 版本加入。
提交问题时,请描述双方的网络环境(家庭宽带 / 校园 WiFi / 手机热点),以便我们更快地定位问题。
服务器地址迁移
注意:自 2026 年 11 月 11 日起,低于 1.2.1 的版本将无法再连接。 打开配置文件文件夹中的
voxlink.json,将serverUrl字段从https://p2p.wuhui.icu更改为https://link.voxdev.top,或者升级到 1.2.1+ 以继续游玩。1.2.1+ 已脱离 Beta 阶段。
VoxLink
Play with your friends, or find new ones in the lobby :D
How to play
Open your world, create a room, get a 6-digit code, send it to your friend, they type it in, done. No port forwarding, no router stuff, no server, you don't even need to know what a public IP is. Install mod, make room, send code, that's it.
Usually connects within seconds -- connection time and success rate depend on both sides' network: same ISP home broadband almost always works, campus WiFi, office network, phone hotspot may fluctuate. If direct connection struggles, the mod automatically falls back to peer relay or TURN relay. First connection a bit flaky? Both restart the game to refresh NAT ports. We're improving the punch strategies every update.
Terracotta Integration
Starting from 1.0.4, VoxLink works with Terracotta P2P (optional, not required). You can download and enable Terracotta right inside the mod settings -- it can interop with other tools that support Terracotta, and if you enter a native VoxLink room, VoxLink's own punching runs in parallel with Terracotta. Note: due to technical limits (sandboxing), Terracotta can't run on Android devices for now -- we may look into ways around it later (and due to the VM limitation, it can't read the launcher's own Terracotta either).
Fallback & Relay
Available in VoxLink 1.0.0+
When direct punching fails, VoxLink doesn't give up. Three tricks up its sleeve:
- Reverse punch -- if one side's NAT is being annoying for forward punching, the other side fires back a reverse punch to sneak around it.
- Peer relay -- if both of you just can't connect directly (like both on symmetric NAT), VoxLink grabs a suitable player from whoever's online in the public lobby right now and uses them as a relay node. Traffic flows through their client, never through the server. The relay player won't feel a thing -- barely any impact.
- TURN relay -- added in 1.1.3. After 20 seconds of punching, a "use relay" button shows up and a public relay server carries the traffic. From 1.2.0 the switch to relay is fully automatic, no button needed. P2P keeps punching in the background for 10 minutes afterwards, and switches back smoothly if it succeeds. Relay servers are a limited resource -- got a spare public server? Donations welcome~
Relay can be toggled off anytime in settings. Turn it off and you won't relay for others, but you also can't use others as relay. Fair enough right?
Huge thanks to XIOPNM, who personally joined over 300 remote multiplayer tests out of 700+ total. We also want to thank all the other testers who helped along the way.
Grab the host's mods
Added in 1.1.2. When joining a room, VoxLink fetches the host's mod list and offers to download the ones you're missing -- you'll need to restart the game manually afterwards. Version lookups went through the Modrinth API up to 1.1.9; 1.2.0+ adds CurseForge.
Only dependency completeness is checked -- local vs host mod version differences are detected, but mod-compatibility conflicts and crash risks are not. If you're joining a stranger's room full of forced client-side mods, consider joining with a clean client (just VoxLink + Fabric API) to avoid crashes. Can be turned off in the simple settings page.
Rooms
Rooms have no player limit, offline players work too. Once the lobby is open, room names and custom tags get AI checked before being shown. Latency tested around 15-20 ms between Guangdong and Jiangxi, though your actual ping depends on both networks.
Set your room to public when creating it and it'll show up in the lobby. The lobby doesn't leak your IP or anything -- still all P2P. Tags help you find the right room. Both the web panel and in-game client can browse the lobby; copy the room code from the web, or join directly from the client.
Compatibility
Works with Simple Voice Chat (good to go!), ViaFabric (and the whole ViaVersion family). It also works with the Chinese mod 古人穿越.
Now supports Forge, NeoForge, and Fabric 1.20+ -- every version from 1.20 up, with more to come. The mod itself is multilingual -- 12 languages to pick from: English, Simplified Chinese, Traditional Chinese, Japanese, Korean, French, German, Spanish, Russian, Portuguese (Brasil), Arabic, and Classical Chinese (Wenyanwen).
Standalone App
There's also a separate VoxLink app that works across any version -- no mod installation needed. It even tunnels other games, and runs on Linux, Windows and macOS. Check the download links above. (Developers: there's a CLI build of the app too, welcome to use it.)
Found a bug?
Go to https://github.com/AUGUHDAR/VoxLink/issues, bring your logs, both host and joiner:
.minecraft/versions/<your_version>/logs/latest.log
Starting from 1.1.0, logs are automatically uploaded to help us improve punch success rates. You can disable this in settings. VoxLink never uploads or exposes your private info. You can also report or suggest things in-game -- the feedback screen arrived in 1.1.7.
When submitting, please describe both sides' network environment (home broadband / campus WiFi / phone hotspot) so we can pinpoint the issue faster.
Server address migration
Note: starting November 11, 2026, versions below 1.2.1 will no longer be able to connect. Open voxlink.json in your config folder and change the serverUrl field from
https://p2p.wuhui.icutohttps://link.voxdev.top, or upgrade to 1.2.1+ to keep playing. 1.2.1+ is out of Beta.
下载 VoxLink
下载 VoxLink
下载 VoxLink
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VoxLink
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VoxLink
下载 VoxLink
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VoxLink
下载 VoxLink
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VoxLink
下载 VoxLink
1.2.1 → 1.2.2 更新内容:
新增
- 大厅房间卡片升级:房间名放不下时自动缩小字号,再放不下会像走马灯一样平滑滚动展示,不用再对着「我的…」猜房间叫什么
- 房间卡片新增版本行:直接显示房主的 VoxLink 版本(V:)与游戏版本(G:),加入前一眼看清版本是否匹配
- 玩家中继升级到 v3:可借力的中继候选从「本房间」扩展到「全大厅」,极端网络的玩家被其他房间玩家中继救援的成功率大幅提升
修复
- 修复最常见的锥型网络(端口受限锥型)被误判为对称网络、导致中继候选被清空、提示「无可用中继节点」的问题
- 修复房主侧中继建立较慢时被过早判定失败的问题,弱网下接入中继更稳
- 修复上一轮打洞未完全停止时干扰下一轮连接尝试的问题
优化
- 存在多个中继节点时自动测试延迟与负载,优先选最快的节点
- 后台探测与连接过程日志更完整,问题定位更快
- 大厅界面细节打磨:加入按钮、按钮缩放等多处交互优化
1.2.0 → 1.2.1 更新内容:
新增
- 大厅界面全面翻新:模糊背景 + 信息面板 + 新版顶栏(搜索 / 版本筛选 / 排序 / 加载器 / 分类),分类改为弹窗选择,底部新增「通过代码加入 / 相关链接 / 反馈与建议 / 简单配置」直达
- 版本筛选:在大厅按 MC 版本过滤房间,支持逗号分隔多个版本(如 1.21,1.20,26.1)
- 标题屏新增 VoxLink 入口(与「多人游戏」并排),点进即是大厅
- 游戏内 Esc 菜单新增直达入口:有房直接进房间管理,无房单机世界直接进创建房间
- 创建房间 / 简单配置改为分组双列布局,陶瓦下载状态一目了然
- 管理房间顶部新增房码展示,点击即可复制
- 界面全面适配窗口尺寸:小窗口下控件与文字自动缩放,不再错位溢出
修复
- 修复部分整合包(大模组清单)进房主房间时等待不足而失败的问题,加载宽容时间大幅延长
- 修复直连已成功但界面仍显示失败、并误断重连的问题
- 修复 TURN 中继单向不通时误判为连接成功的问题
- 修复部分网络下中继指令被限流丢弃、迟迟不分配中继的问题
- 修复 ModSync 必装清单重复弹出的提示问题
- 修复分类弹窗打开后内容空白的问题
- 修复小尺寸窗口下按钮错位、文字超出按钮的问题
- 修复特殊网络环境下网卡选择不正确的问题
优化
- 远程日志与打洞样本更完整,问题定位更快
- 多处界面文案与提示优化
1.1.9 → 1.2.0 更新内容:
新增
- 与 HappyLink 双向互通:大厅可直接看到 HappyLink 玩家开的房间并一键加入,HappyLink 玩家同样可以进入 VoxLink 房间;支持直接输入 HL 房码加入,来源房间在大厅中有徽章标识
- 智能自动中继:打洞受阻时不再需要手动点按钮,模组会根据网络证据自动切换到 TURN 中继或玩家中继(双对称 NAT 约 15 秒、有受阻证据约 30 秒、兜底约 45 秒),全程无需任何操作
- 中继可用后自动尝试直连升级:进入中继后后台仍持续尝试打洞(最长 10 分钟),打通即平滑切换到直连,游戏不中断、无需重连
- 玩家中继全面重写(v2):被中继玩家的数据走独立子通道,与自己与房主的会话字节级隔离,多人同时被中继时互不干扰
修复
- 修复弱网/受限网络下打洞失败后可能一直卡在「连接中」的问题:中继触发条件、两条中继通道的切换与回退、失败后的重试与终态提示共 12 处链路修复
- 修复中继传输「建立成功但实际不通」时无法自动换道的问题,现在会静默换到另一条通道继续
- 修复中继对端短暂失联后恢复、但数据通道永久卡死的问题(重传队列改为救援机制,对端恢复后无损续流)
- 修复房间被越权关闭的问题:关闭房间现在只能由房主本人触发(服务端已同步上线,旧版本客户端同样受益)
- 修复局域网直连成功后连接状态不更新的问题
- 修复信令连接半开时最长 90 秒才判死的问题,现在 35 秒内判定并自动降级
- 修复 HappyLink 密码房在大厅错误显示的问题
- 修复必装模组检查在部分场景静默跳过、不提示原因的问题
优化
- ModSync 大幅提速:优先使用国内镜像源、多线程并行下载,界面按「可一键下载/版本不匹配/未收录/提示」四区展示
- 打洞参数与重试策略按网络证据动态升级,受限网络下的连接成功率明显提升
- 远程日志在连接终态时立即上传,失败现场不再丢失
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧