SimpleCom

SimpleCom / 简单的通讯器

Purpose / 初衷

English

Why SimpleCom exists: 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.

SimpleCom sends voice over the same TCP connection you already use for Minecraft via plugin message (payload) channels. No extra ports, no NAT traversal, no firewall rules. If you can join the server, voice works. Data flows: Client → Server → Other clients in the same channel. We trade a bit of latency for reliability: voice works wherever the game works.

中文

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

SimpleCom 通过 你已经在用的 Minecraft TCP 连接 上的插件消息（payload）通道传语音。不需要额外端口、不需要 NAT 穿透、不需要改防火墙。能进服务器，语音就能用。数据路径：客户端 → 服务器 → 同信道其他客户端。我们用一点延迟换 稳定：游戏能连上的地方，语音就能用。

How to Use / 使用方法

English

V1.x (payload channel inside Minecraft)

1. Install the mod (Fabric or Forge) and Architectury API. On the server, install the SimpleCom server plugin (Bukkit/Spigot) so it can relay voice.
2. Join 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. Choose a channel: Press C to open the channel screen. Enter a number 1–100. Channel 0 = mute (no send/receive).
4. Talk: Hold V to record. Release V 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. Controls: V = 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. Server (required): install the V2.0 SimpleCom server plugin/mod and configure SimpleComConfig/config.yml so that the port-multiplex proxy and internal WebSocket server are running (players and the client connect to the proxy listen-port).
2. Client mod/app: install/run the V2.0 client package you downloaded (no manual building needed for players).
3. In game: join the Minecraft server; when the server is active, you will receive a 6-digit verification code in chat.

4. In the client UI (FX GUI):

   • Choose language (Language / 语言).
   • Enter your Minecraft username.
   • Enter the server address 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 verification code from chat.
   • Click Connect 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. 安装 本模组（Fabric 或 Forge）以及 Architectury API。服务器需安装 SimpleCom 服务端插件（Bukkit/Spigot）才能转发语音。
2. 进入 服务器。若服务器装有插件，会看到握手成功提示；否则可能提示超时（无服务端插件时语音不可用）。
3. 选信道： 按 C 打开信道界面，输入 1–100 的信道号。信道 0 为静音（不发送也不接收）。
4. 说话： 按住 V 录音，松开 V 发送。按住时显示“正在录音...”，发送后显示“录音完成，X KB”。别人说话时会显示“XXX正在对讲”。
5. 按键： V = 按键说话，C = 信道设置。可在游戏“控制”选项中“简单的通讯器”分类下改键。

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

1. 服务端（必需）：安装 V2.0 SimpleCom 服务端插件/模组，并在 SimpleComConfig/config.yml 中启用端口复用代理与内部 WebSocket 服务器（玩家和客户端都连接到同一个 代理监听端口）。
2. 客户端模组/程序：直接安装/运行你下载到的 V2.0 客户端发布包（玩家无需自己构建）。
3. 在游戏中：进入安装了 SimpleCom 服务端插件的服务器，聊天栏会收到一条包含 6 位验证码 的提示。

4. 在客户端界面（FX GUI）中：

   • 选择界面语言（Language / 语言）。
   • 输入你的 Minecraft 用户名。
   • 输入语音服务器地址，例如 example.com:25566 或 127.0.0.1:25566（即代理监听端口或直接 WS 端口）。
   • 输入聊天中看到的 6 位 验证码。
   • 点击 连接 / Connect，客户端会通过 WebSocket 连接到服务端。
5. 认证成功后会进入“已连接”窗口，按键说话（全局热键）与信道控制在此 FX 窗口中完成，而不再依赖游戏内按键绑定。

Features / 功能特性

Русский

• Режим рации поверх существующего соединения Minecraft (без UDP, без дополнительных портов).
• 100 каналов (1–100); канал 0 — это мьют.
• Forge и Fabric в одном моде (Architectury); один JAR на версию игры.
• Серверный плагин передаёт голос между игроками в одном канале.
• Протокол VarInt + UTF-8, совместим с форматом payload Minecraft.

Version Compatibility / Совместимость версий

Русский

Каждая версия несовместима с другими версиями. Нужно использовать совпадающие версии клиента и сервера.

• Сервер V2.0 (плагин/мод) работает только с клиентом V2.0. В этой версии появился новый Voice Stream API (WSAPI) и единая схема версионирования V2.0.
• Сервер V1.1 (мод или Bukkit-плагин) работает только с клиентом V1.1.
• Сервер V0.1 работал только с клиентом V1.0.

Не смешивайте версии: например, клиент V2.0 на сервере V1.1 не будет работать корректно.

V2.0 Changes / Изменения в V2.0

Русский

• Новое ядро сервера (SimpleCom-server-core): общая чисто-Java реализация прокси с мультиплексированием портов и WebSocket-сервера, переиспользуемая в Bukkit, Fabric и других серверных платформах.
• Voice Stream API (WSAPI): WebSocket-эндпоинт с проверкой токена, позволяющий внешним сервисам (например, ботам, мостам) подписываться на нешифрованные голосовые пакеты в реальном времени.
• Единое версионирование: все основные модули в ветке V2.0new теперь используют одну строку версии V2.0 — так проще разворачивать и искать проблемы.

Requirements / Зависимости

Русский

• Minecraft (поддерживаемые версии смотрите в описании проекта)
• Architectury API (обязательно)
• Fabric Loader + Fabric API (Fabric) или Forge (Forge)
• Сервер: для работы голоса в мультиплеере нужен плагин SimpleCom Bukkit/Spigot.

Donate / Донат

Русский

Криптовалюта (USDT):

• USDT в сети TRON: TDoJuuSBTztZFVQuVC7xeEESfFbktBUb9W
• USDT в сети Ethereum: 0x9ce2b2de37976da8e795e7a3ff4badb60b3c8487
• USDT в сети BNB Chain: 0x9ce2b2de37976da8e795e7a3ff4badb60b3c8487
• USDT в сети Polygon: 0x9ce2b2de37976da8e795e7a3ff4badb60b3c8487
• USDT в сети X Layer: XKO9ce2b2de37976da8e795e7a3ff4badb60b3c8487

Спасибо за поддержку.

中文

微信 / 支付宝：

感谢支持。