Netherway v1.0.2

Netherway 让 Minecraft 玩家和服务器之间走 P2P 直连，游戏流量不经过中转节点。打洞成功后，第三方只承担最初的信令交换；打不通则自动留在原有线路上，不影响游玩。

本版本是第一次把 v1.0.0 之后新增的三套平台适配 随 Release 一起发出来：Forge 1.12.2、1.16.5 / 1.18.2 / 1.20.1（Forge + Fabric，一套源码），以及一个独立的 Bukkit/Spigot/Paper 服务端插件。连同原有的 Forge 1.7.10，这次一共 9 个资产、覆盖六个平台。（v1.0.1 只发了 Forge 1.7.10 一个 jar，发布范围没跟上仓库实际进度，已撤回。）

资产一览

平台	资产	装在哪
Forge 1.7.10	netherway-forge-1.7.10-1.0.2.jar	客户端与服务端 mods/（同一个 jar）
Forge 1.12.2	netherway-forge-1.12.2-1.0.2.jar	客户端与服务端 mods/（同一个 jar）
Forge 1.16.5	netherway-forge-1.16.5-1.0.2.jar	客户端与服务端 mods/
Fabric 1.16.5	netherway-fabric-1.16.5-1.0.2.jar	客户端与服务端 mods/
Forge 1.18.2	netherway-forge-1.18.2-1.0.2.jar	客户端与服务端 mods/
Fabric 1.18.2	netherway-fabric-1.18.2-1.0.2.jar	客户端与服务端 mods/
Forge 1.20.1	netherway-forge-1.20.1-1.0.2.jar	客户端与服务端 mods/
Fabric 1.20.1	netherway-fabric-1.20.1-1.0.2.jar	客户端与服务端 mods/
Bukkit/Spigot/Paper	netherway-bukkit-1.0.2.jar	服务端 plugins/（仅服务端；客户端仍用对应版本的 Forge/Fabric jar）

各平台逐版差异见 docs/multi-version.md；产品能力与 v1.0.0 一致（见下方亮点），本版本只是把已经过完整 CI 与真机验证的多平台构建正式纳入发布流程，核心逻辑没有变化。

亮点（同 v1.0.0）

• 玩家零配置：装上 mod/插件即可。服务端在玩家登录后自动下发凭证，打洞成功即无缝切换直连；失败自动保持中转，游戏不中断。
• 进服前预热：客户端启动时为服务器列表里的已知服务预取凭证并提前建好隧道。
• 免登录取凭证：首次安装或服务端密钥轮换后，客户端在 Minecraft 端口上直接换取新凭证，无需先中转进服一次；服务器始终只暴露一个端口。
• 公网侧零要求（默认模式）：会合点内嵌在 MC 服务端进程里，公网侧只需任意一条能把 TCP 转到 MC 端口的通道。
• 自建 frps 的分层鉴权：可选 authplugin + 每玩家令牌。
• en/zh 双语：游戏提示、日志与配置注释跟随游戏语言。

验证下载

资产由 GitHub Actions 从本 tag 构建并附带 build provenance，逐个校验：

for f in netherway-*-1.0.2.jar; do
  gh attestation verify "$f" --repo aUsernameWoW/netherway
done

---

English

Netherway establishes peer-to-peer connections between Minecraft players and servers, so gameplay traffic no longer passes through a relay. After NAT traversal succeeds, the third party only handles the initial signaling; if traversal fails, the existing relayed connection is kept and play is never interrupted.

This is the first release that actually ships the three platform adapters added since v1.0.0: Forge 1.12.2, 1.16.5 / 1.18.2 / 1.20.1 (Forge + Fabric, one shared source tree), and a standalone Bukkit/Spigot/Paper server plugin — alongside the original Forge 1.7.10. Nine assets, six platforms. (v1.0.1 shipped only the Forge 1.7.10 jar and was withdrawn — its release scope hadn't caught up with what the repo actually supported.)

Assets

Platform	Asset	Install
Forge 1.7.10	netherway-forge-1.7.10-1.0.2.jar	Client + server mods/ (same jar)
Forge 1.12.2	netherway-forge-1.12.2-1.0.2.jar	Client + server mods/ (same jar)
Forge 1.16.5	netherway-forge-1.16.5-1.0.2.jar	Client + server mods/
Fabric 1.16.5	netherway-fabric-1.16.5-1.0.2.jar	Client + server mods/
Forge 1.18.2	netherway-forge-1.18.2-1.0.2.jar	Client + server mods/
Fabric 1.18.2	netherway-fabric-1.18.2-1.0.2.jar	Client + server mods/
Forge 1.20.1	netherway-forge-1.20.1-1.0.2.jar	Client + server mods/
Fabric 1.20.1	netherway-fabric-1.20.1-1.0.2.jar	Client + server mods/
Bukkit/Spigot/Paper	netherway-bukkit-1.0.2.jar	Server plugins/ only (clients still use the matching Forge/Fabric jar)

Per-version differences are in docs/multi-version.md. Product behavior is unchanged from v1.0.0 (highlights below) — this release just brings the already-CI-validated multi-platform builds into the official release pipeline.

Highlights (same as v1.0.0)

• Zero player configuration — the server hands out credentials after login and the client switches over seamlessly once the tunnel is ready; failures silently stay on the relay.
• Pre-join warm-up — tunnels are prepared while the game starts.
• Credential exchange on the Minecraft port itself — a single exposed port, even for first-time installs and after secret rotation.
• No requirements on the public side (default mode) — the rendezvous is embedded in the Minecraft server process.
• Layered auth for self-hosted frps — optional authplugin with per-player tokens.
• Bilingual en/zh messages, logs, and config comments.

Verify the download

for f in netherway-*-1.0.2.jar; do
  gh attestation verify "$f" --repo aUsernameWoW/netherway
done

---

What's Changed

Other changes

• 版本号提升至 1.0.1 by @aUsernameWoW in #14
• 发布流水线：把六个平台的 jar 一起发出去，版本号提升至 1.0.2 by @aUsernameWoW in #15

Full Changelog: v1.0.0...v1.0.2

Netherway v1.0.0

首个正式版本。

Netherway 让 Minecraft 玩家和服务器之间走 P2P 直连，游戏流量不经过中转节点。打洞成功后，第三方只承担最初的信令交换；打不通则自动留在原有线路上，不影响游玩。

本版本提供 Forge 1.7.10 适配（客户端与服务端同一个 jar），其他平台尚未发布。

亮点

• 玩家零配置：装上 mod 即可。服务端在玩家登录后自动下发凭证，打洞成功即无缝切换直连；失败自动保持中转，游戏不中断。
• 进服前预热：客户端启动时为服务器列表里的已知服务预取凭证并提前建好隧道，点击原条目直接走直连；列表延迟显示的就是直连延迟。
• 免登录取凭证：首次安装或服务端密钥轮换后，客户端在 Minecraft 端口上直接换取新凭证，无需先中转进服一次；服务器始终只暴露一个端口。
• 公网侧零要求（默认模式）：会合点内嵌在 MC 服务端进程里，公网侧只需任意一条能把 TCP 转到 MC 端口的通道——租用的转发服务、nginx stream、一条 NAT 规则都可以，无需自建 frps。
• 自建 frps 的分层鉴权：可选 authplugin + 每玩家令牌（绑定 UUID、带有效期、登录续签），收敛全局 token 的滥用面。
• en/zh 双语：游戏提示、日志与配置注释跟随游戏语言。

安装

客户端与服务端把 jar 放进各自的 mods/ 文件夹即可；服务端首次启动生成 config/netherway.cfg，默认配置开箱即用。详见中文文档。

• jar 内置 Windows x64、Linux x64、macOS Apple Silicon 三平台 agent，其他环境自动保持原有中转线路。
• 兼容 Java 8–25 运行时（含以 lwjgl3ify 等方式运行 1.7.10 的现代整合）。
• 打洞成功率取决于两端 NAT 类型，对称 NAT 大概率失败；失败不影响原有连接。
• 内置匿名质量遥测（仅连接结果、失败码与延迟分桶，不含用户名、服务器地址、房间、凭证或任何持久标识），可在 config/netherway.cfg 的 telemetry 段关闭。

验证下载

资产由 GitHub Actions 从本 tag 构建并附带 build provenance：

gh attestation verify netherway-forge-1.7.10-1.0.0.jar --repo aUsernameWoW/netherway

---

English

First stable release.

Netherway establishes peer-to-peer connections between Minecraft players and servers, so gameplay traffic no longer passes through a relay. After NAT traversal succeeds, the third party only handles the initial signaling; if traversal fails, the existing relayed connection is kept and play is never interrupted.

This release ships the Forge 1.7.10 adapter (one jar for both client and server); other platforms are not yet available.

Highlights:

• Zero player configuration — the server hands out credentials after login and the client switches over seamlessly once the tunnel is ready; failures silently stay on the relay.
• Pre-join warm-up — tunnels are prepared while the game starts, and the server list latency reflects the direct path.
• Credential exchange on the Minecraft port itself — a single exposed port, even for first-time installs and after secret rotation.
• No requirements on the public side (default mode) — the rendezvous is embedded in the Minecraft server process; any TCP forward to the Minecraft port works, no self-hosted frps needed.
• Layered auth for self-hosted frps — optional authplugin with per-player tokens (UUID-bound, expiring, renewed on login).
• Bilingual en/zh messages, logs, and config comments.

Install by dropping the jar into mods/ on both sides; the server generates a ready-to-use config/netherway.cfg on first launch. See the English documentation.

Bundled agents cover Windows x64, Linux x64, and macOS Apple Silicon; other environments keep the relay path. Runs on Java 8–25. NAT traversal success depends on both sides' NAT type (symmetric NAT usually fails). Anonymous quality telemetry (connection outcomes, failure codes, and latency buckets only — no username, server address, room, credential, or stable identifier) can be disabled in the telemetry section of the config.

Verify the download:

gh attestation verify netherway-forge-1.7.10-1.0.0.jar --repo aUsernameWoW/netherway

---

What's Changed

Dependencies

• Bump the frp group across 1 directory with 2 updates by @dependabot[bot] in #1
• Bump github.com/samber/lo from 1.47.0 to 1.53.0 by @dependabot[bot] in #5
• Bump github.com/fatedier/golib from 0.8.1 to 0.8.2 in the frp group by @dependabot[bot] in #12

Other changes

• 精简预认证中冗余的鉴权模块，回归纯链路职责 by @YogIce in #10
• 重写 README：面向服主与玩家的部署指引 by @aUsernameWoW in #11
• 版本号提升至 1.0.0 by @aUsernameWoW in #13

New Contributors

• @dependabot[bot] made their first contribution in #1
• @YogIce made their first contribution in #10
• @aUsernameWoW made their first contribution in #11

Full Changelog: https://github.com/aUsernameWoW/netherway/commits/v1.0.0