开发者用 Tailcat 为 Minecraft 制作联机原型模组

这是一个快速、主要由 AI 生成的原型，演示了使用 Tailcat 的一种方式。它不是 Tailscale 官方支持的产品，Tailscale 也没有分发它的计划。本仓库仅供演示和娱乐之用。

这是一个 Fabric 1.21.1 客户端 mod，通过 Tailcat 标准的用户态 WireGuard、magicsock 直接 NAT 穿透以及 DERP 回退来共享一个集成的 Minecraft 世界。它不创建 TUN 接口，也不需要安装 Tailscale。Java 负责 Minecraft 的 UI 和进程生命周期；随附的 Go 辅助程序负责所有网络和加密。

tailcatmcdemo.mp4

构建

需要 JDK 21、curl 和 tar。辅助程序使用公开的 Tailcat Go 模块。原生构建脚本会下载所需的 Tailscale Go 工具链：

scripts/build-natives.sh

./gradlew :mod:build

普通 JAR 会写入 mod/build/libs/。仅做 Java 开发时，将 MCLINK_HELPER 设置为本地构建的辅助程序路径。原生构建会生成 Windows、macOS（Intel 和 Apple Silicon）以及 Linux 辅助程序并计算校验和。

主机暂停单人游戏，点击 Share with Tailcat，然后复制 mcl1_... 邀请码。另一名玩家打开 Multiplayer，点击 Connect with Tailcat，粘贴邀请码并连接。如果集成服务器尚未发布，打开远程共享会按照 Minecraft 正常的 LAN 行为将其发布。

带版本号的邀请码封装了一个临时的 Tailcat 连接 token。持有该不可猜测的 token 即可在共享会话存续期间获得访问授权。辅助程序只允许虚拟 TCP 端口 25565，仅将加入监听器绑定到 127.0.0.1，并限制并发流数量。

要使用单个 Minecraft 账号测试，只启动主机，并使用明确仅供开发用的离线认证开关：

MCLINK_DEV_OFFLINE_AUTH=1 ./gradlew :mod:runClient

从另一个终端启动第二个客户端，使用隔离的游戏目录和不同的离线用户名：

mkdir -p mod/run-client2 ./gradlew :mod:runClient --args='--gameDir ../run-client2 --username Client2'

该开关在 Fabric 开发环境之外会被忽略，并且当 Tailcat 共享停止时，服务器原有的 online-mode 设置会被恢复。切勿将这一绕过方式用于真实的远程共享。

构建默认不签名。公开发布的产物必须对两个 Windows 可执行文件进行 Authenticode 签名，对两个 macOS 可执行文件进行签名/公证，替换打包文件，重新生成 checksums.json，生成完整的第三方声明，然后构建最终的 JAR。按照项目简介中列出的内容，测试不同的机器以及 direct/DERP 路径。

从锁定的 Go 模块图生成依赖声明（例如使用 go-licenses report ./...）。Tailcat 和 Tailscale 采用 BSD-3-Clause 许可证；Fabric Loader/API 是运行时依赖，而非嵌入的 mod 内容，Minecraft 仍受 Mojang 条款约束。