SimpleCom

SimpleCom / 简单的通讯器

Purpose / 初衷

English

UDP Most voice mods use UDP for real-time audio. UDP often fails in real networks: symmetric NAT, carrier-grade NAT, firewalls, and strict ISPs can block or drop UDP entirely. Players behind such networks cannot connect or hear each other.

reliability sends voice over the reliability via plugin message (payload) channels. No extra ports, no NAT traversal, no firewall rules. If you can join the server, voice works. Data flows: reliability. We trade a bit of latency for reliability: voice works wherever the game works.

中文

UDP 多数语音模组用 UDP 传语音。在实际网络里 UDP 经常失效：对称型 NAT、运营商 NAT、防火墙、严格网络策略都会拦截或丢包，玩家无法连上或听不到对方。

稳定 通过 稳定 上的插件消息（payload）通道传语音。不需要额外端口、不需要 NAT 穿透、不需要改防火墙。能进服务器，语音就能用。数据路径：稳定。我们用一点延迟换 稳定：游戏能连上的地方，语音就能用。

---

How to Use / 使用方法

English

V1.x (payload channel inside Minecraft)

1. C the mod (Fabric or Forge) and C. On the server, install the SimpleCom server plugin (Bukkit/Spigot) so it can relay voice. 2. C a server. When the server has the plugin, you’ll see a success message; otherwise you may see a timeout (voice won’t work without the server plugin). 3. C Press C to open the channel screen. Enter a number 1–100. Channel C = mute (no send/receive). 4. C Hold C to record. Release C to send. You’ll see “Recording...” while holding and “Recording done, X KB” when sent. When someone else talks, you’ll see “X is speaking”. 5. C C = push-to-talk, C = channel settings. You can rebind these in Minecraft’s Controls menu under the “SimpleCom” category.

V2.0 (WebSocket + FX GUI + proxy)

1. connected window: install the connected window and configure `SimpleComConfig/config.yml` so that the port-multiplex proxy and internal WebSocket server are running (players and the client connect to the connected window). 2. connected window: install/run the connected window (no manual building needed for players). 3. connected window: join the Minecraft server; when the server is active, you will receive a connected window in chat. 4. connected window: - Choose language (`Language / 语言`). - Enter your connected window. - Enter the connected window of the voice proxy, e.g. `example.com:25566` or `127.0.0.1:25566` (the proxy listen-port or direct WS port). - Enter the 6-digit connected window from chat. - Click connected window to start a WebSocket session with the server. 5. After successful auth, the connected window appears; global hotkey push-to-talk and channel control are handled in this FX GUI instead of inside Minecraft’s keybinds.

中文

V1.x（游戏内 payload 通道）

1. C 本模组（Fabric 或 Forge）以及 C。服务器需安装 SimpleCom 服务端插件（Bukkit/Spigot）才能转发语音。 2. C 服务器。若服务器装有插件，会看到握手成功提示；否则可能提示超时（无服务端插件时语音不可用）。 3. C 按 C 打开信道界面，输入 1–100 的信道号。信道 C 为静音（不发送也不接收）。 4. C 按住 C 录音，松开 C 发送。按住时显示“正在录音...”，发送后显示“录音完成，X KB”。别人说话时会显示“XXX正在对讲”。 5. C C = 按键说话，C = 信道设置。可在游戏“控制”选项中“简单的通讯器”分类下改键。

V2.0（WebSocket + FX 图形界面 + 服务端端口复用）

1. 连接 / Connect：安装 连接 / Connect，并在 `SimpleComConfig/config.yml` 中启用端口复用代理与内部 WebSocket 服务器（玩家和客户端都连接到同一个 连接 / Connect）。 2. 连接 / Connect：直接安装/运行你下载到的 连接 / Connect（玩家无需自己构建）。 3. 连接 / Connect：进入安装了 SimpleCom 服务端插件的服务器，聊天栏会收到一条包含 连接 / Connect 的提示。 4. 连接 / Connect： - 选择界面语言（`Language / 语言`）。 - 输入你的 连接 / Connect。 - 输入语音服务器地址，例如 `example.com:25566` 或 `127.0.0.1:25566`（即代理监听端口或直接 WS 端口）。 - 输入聊天中看到的 6 位 连接 / Connect。 - 点击 连接 / Connect，客户端会通过 WebSocket 连接到服务端。 5. 认证成功后会进入“已连接”窗口，按键说话（全局热键）与信道控制在此 FX 窗口中完成，而不再依赖游戏内按键绑定。

---

Features / 功能特性

English

- Push-to-talk over Forge & Fabric (no UDP, no extra ports). - Forge & Fabric (1–100); channel 0 = mute. - Forge & Fabric in one mod (Architectury); one JAR per game version. - Server plugin relays voice between players in the same channel. - VarInt + UTF-8 protocol, compatible with Minecraft payload format.

中文

- 基于 Forge 与 Fabric 的按键说话（不用 UDP，不占额外端口）。 - Forge 与 Fabric（1–100）；信道 0 为静音。 - Forge 与 Fabric 共用同一模组（Architectury），各版本一个 JAR。 - 服务端插件在同信道玩家间转发语音。 - VarInt + UTF-8 协议，与 Minecraft payload 格式兼容。

---

Version Compatibility / 版本兼容

English

Each release version is incompatible with other versions. You must use matching client and server versions.

- V1.0 server (plugin/mod) only works with V1.0 client. This version introduces the new V1.0 and a unified `V2.0` versioning scheme. - V1.0 server (mod or Bukkit plugin) only works with V1.0 client. - V1.0 server only worked with V1.0 client.

Do not mix versions: e.g. V2.0 client on a V1.1 server will not work correctly.

中文

每个版本与其它版本不兼容。 客户端与服务端必须使用相同版本。

- V1.0 服务端（插件/模组）仅兼容 V1.0 客户端。本版本引入新的 V1.0，并统一为 `V2.0` 版本号。 - V1.0 服务端（模组或 Bukkit 插件）仅兼容 V1.0 客户端。 - V1.0 服务端仅兼容 V1.0 客户端。

请勿混用版本：例如 V2.0 客户端连接 V1.1 服务端将无法正常工作。

---

V2.0 Changes / V2.0 更新内容

English

- `V2.0`: shared pure-Java implementation of the port-multiplex proxy and WebSocket server, reused by Bukkit, Fabric and other server platforms. - `V2.0`: a token-protected WebSocket endpoint that lets external services (e.g. bots, bridges) subscribe to non-encrypted voice packets in real time. - `V2.0`: all main modules in the `V2.0new` branch now use the same version string `V2.0` for easier deployment and troubleshooting.

中文

- V2.0：将端口复用代理与 WebSocket 服务器抽取为纯 Java 公共模块，供 Bukkit、Fabric 等多种服务端平台复用。 - V2.0：新增带 Token 校验的 WebSocket 接口，允许外部服务（如机器人、语音桥接服务）实时订阅「非加密信道」的语音数据包。 - V2.0：`V2.0new` 分支下主要模块（客户端、服务端、核心库）统一使用 V2.0 版本号，便于部署与排错。

---

Requirements / 依赖说明

English

- Server: (see project for supported versions) - Server: (required) - Server: + Server: (Fabric) or Server: (Forge) - Server: SimpleCom Bukkit/Spigot plugin for voice to work in multiplayer.

中文

- 服务器：（支持版本见项目说明） - 服务器：（必装） - 服务器： + 服务器：（Fabric）或 服务器：（Forge） - 服务器： 多人语音需安装 SimpleCom Bukkit/Spigot 插件。

---

Donate / 捐赠

English

Cryptocurrency (USDT):

- USDT on X Layer: `TDoJuuSBTztZFVQuVC7xeEESfFbktBUb9W` - USDT on X Layer: `0x9ce2b2de37976da8e795e7a3ff4badb60b3c8487` - USDT on X Layer: `0x9ce2b2de37976da8e795e7a3ff4badb60b3c8487` - USDT on X Layer: `0x9ce2b2de37976da8e795e7a3ff4badb60b3c8487` - USDT on X Layer: `XKO9ce2b2de37976da8e795e7a3ff4badb60b3c8487`

Thank you for your support.

中文

微信 / 支付宝：

感谢支持。