# SimpleCom \/ \u7b80\u5355\u7684\u901a\u8baf\u5668<\/p>\n
## Purpose \/ \u521d\u8877<\/p>\n
### English<\/p>\n
**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.<\/p>\n
**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 \u2192 Server \u2192 Other clients in the same channel**. We trade a bit of latency for **reliability**: voice works wherever the game works.<\/p>\n
### \u4e2d\u6587<\/p>\n
**SimpleCom \u7684\u521d\u8877\uff1a** \u591a\u6570\u8bed\u97f3\u6a21\u7ec4\u7528 **UDP** \u4f20\u8bed\u97f3\u3002\u5728\u5b9e\u9645\u7f51\u7edc\u91cc UDP \u7ecf\u5e38\u5931\u6548\uff1a\u5bf9\u79f0\u578b NAT\u3001\u8fd0\u8425\u5546 NAT\u3001\u9632\u706b\u5899\u3001\u4e25\u683c\u7f51\u7edc\u7b56\u7565\u90fd\u4f1a\u62e6\u622a\u6216\u4e22\u5305\uff0c\u73a9\u5bb6\u65e0\u6cd5\u8fde\u4e0a\u6216\u542c\u4e0d\u5230\u5bf9\u65b9\u3002<\/p>\n
**SimpleCom** \u901a\u8fc7 **\u4f60\u5df2\u7ecf\u5728\u7528\u7684 Minecraft TCP \u8fde\u63a5** \u4e0a\u7684\u63d2\u4ef6\u6d88\u606f\uff08payload\uff09\u901a\u9053\u4f20\u8bed\u97f3\u3002\u4e0d\u9700\u8981\u989d\u5916\u7aef\u53e3\u3001\u4e0d\u9700\u8981 NAT \u7a7f\u900f\u3001\u4e0d\u9700\u8981\u6539\u9632\u706b\u5899\u3002\u80fd\u8fdb\u670d\u52a1\u5668\uff0c\u8bed\u97f3\u5c31\u80fd\u7528\u3002\u6570\u636e\u8def\u5f84\uff1a**\u5ba2\u6237\u7aef \u2192 \u670d\u52a1\u5668 \u2192 \u540c\u4fe1\u9053\u5176\u4ed6\u5ba2\u6237\u7aef**\u3002\u6211\u4eec\u7528\u4e00\u70b9\u5ef6\u8fdf\u6362 **\u7a33\u5b9a**\uff1a\u6e38\u620f\u80fd\u8fde\u4e0a\u7684\u5730\u65b9\uff0c\u8bed\u97f3\u5c31\u80fd\u7528\u3002<\/p>\n
—<\/p>\n
## How to Use \/ \u4f7f\u7528\u65b9\u6cd5<\/p>\n
### English<\/p>\n
#### V1.x (payload channel inside Minecraft)<\/p>\n
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.
\n2. **Join** a server. When the server has the plugin, you\u2019ll see a success message; otherwise you may see a timeout (voice won\u2019t work without the server plugin).
\n3. **Choose a channel:** Press **C** to open the channel screen. Enter a number 1\u2013100. Channel **0** = mute (no send\/receive).
\n4. **Talk:** Hold **V** to record. Release **V** to send. You\u2019ll see \u201cRecording…\u201d while holding and \u201cRecording done, X KB\u201d when sent. When someone else talks, you\u2019ll see \u201cX is speaking\u201d.
\n5. **Controls:** **V** = push-to-talk, **C** = channel settings. You can rebind these in Minecraft\u2019s Controls menu under the \u201cSimpleCom\u201d category.<\/p>\n
#### V2.0 (WebSocket + FX GUI + proxy)<\/p>\n
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**).
\n2. **Client mod\/app**: install\/run the **V2.0 client package you downloaded** (no manual building needed for players).
\n3. **In game**: join the Minecraft server; when the server is active, you will receive a **6-digit verification code** in chat.
\n4. **In the client UI (FX GUI)**:
\n – Choose language (`Language \/ \u8bed\u8a00`).
\n – Enter your **Minecraft username**.
\n – 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).
\n – Enter the 6-digit **verification code** from chat.
\n – Click **Connect** to start a WebSocket session with the server.
\n5. 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\u2019s keybinds.<\/p>\n
### \u4e2d\u6587<\/p>\n
#### V1.x\uff08\u6e38\u620f\u5185 payload \u901a\u9053\uff09<\/p>\n
1. **\u5b89\u88c5** \u672c\u6a21\u7ec4\uff08Fabric \u6216 Forge\uff09\u4ee5\u53ca **Architectury API**\u3002\u670d\u52a1\u5668\u9700\u5b89\u88c5 SimpleCom \u670d\u52a1\u7aef\u63d2\u4ef6\uff08Bukkit\/Spigot\uff09\u624d\u80fd\u8f6c\u53d1\u8bed\u97f3\u3002
\n2. **\u8fdb\u5165** \u670d\u52a1\u5668\u3002\u82e5\u670d\u52a1\u5668\u88c5\u6709\u63d2\u4ef6\uff0c\u4f1a\u770b\u5230\u63e1\u624b\u6210\u529f\u63d0\u793a\uff1b\u5426\u5219\u53ef\u80fd\u63d0\u793a\u8d85\u65f6\uff08\u65e0\u670d\u52a1\u7aef\u63d2\u4ef6\u65f6\u8bed\u97f3\u4e0d\u53ef\u7528\uff09\u3002
\n3. **\u9009\u4fe1\u9053\uff1a** \u6309 **C** \u6253\u5f00\u4fe1\u9053\u754c\u9762\uff0c\u8f93\u5165 1\u2013100 \u7684\u4fe1\u9053\u53f7\u3002\u4fe1\u9053 **0** \u4e3a\u9759\u97f3\uff08\u4e0d\u53d1\u9001\u4e5f\u4e0d\u63a5\u6536\uff09\u3002
\n4. **\u8bf4\u8bdd\uff1a** \u6309\u4f4f **V** \u5f55\u97f3\uff0c\u677e\u5f00 **V** \u53d1\u9001\u3002\u6309\u4f4f\u65f6\u663e\u793a\u201c\u6b63\u5728\u5f55\u97f3…\u201d\uff0c\u53d1\u9001\u540e\u663e\u793a\u201c\u5f55\u97f3\u5b8c\u6210\uff0cX KB\u201d\u3002\u522b\u4eba\u8bf4\u8bdd\u65f6\u4f1a\u663e\u793a\u201cXXX\u6b63\u5728\u5bf9\u8bb2\u201d\u3002
\n5. **\u6309\u952e\uff1a** **V** = \u6309\u952e\u8bf4\u8bdd\uff0c**C** = \u4fe1\u9053\u8bbe\u7f6e\u3002\u53ef\u5728\u6e38\u620f\u201c\u63a7\u5236\u201d\u9009\u9879\u4e2d\u201c\u7b80\u5355\u7684\u901a\u8baf\u5668\u201d\u5206\u7c7b\u4e0b\u6539\u952e\u3002<\/p>\n
#### V2.0\uff08WebSocket + FX \u56fe\u5f62\u754c\u9762 + \u670d\u52a1\u7aef\u7aef\u53e3\u590d\u7528\uff09<\/p>\n
1. **\u670d\u52a1\u7aef\uff08\u5fc5\u9700\uff09**\uff1a\u5b89\u88c5 **V2.0 SimpleCom \u670d\u52a1\u7aef\u63d2\u4ef6\/\u6a21\u7ec4**\uff0c\u5e76\u5728 `SimpleComConfig\/config.yml` \u4e2d\u542f\u7528\u7aef\u53e3\u590d\u7528\u4ee3\u7406\u4e0e\u5185\u90e8 WebSocket \u670d\u52a1\u5668\uff08\u73a9\u5bb6\u548c\u5ba2\u6237\u7aef\u90fd\u8fde\u63a5\u5230\u540c\u4e00\u4e2a **\u4ee3\u7406\u76d1\u542c\u7aef\u53e3**\uff09\u3002
\n2. **\u5ba2\u6237\u7aef\u6a21\u7ec4\/\u7a0b\u5e8f**\uff1a\u76f4\u63a5\u5b89\u88c5\/\u8fd0\u884c\u4f60\u4e0b\u8f7d\u5230\u7684 **V2.0 \u5ba2\u6237\u7aef\u53d1\u5e03\u5305**\uff08\u73a9\u5bb6\u65e0\u9700\u81ea\u5df1\u6784\u5efa\uff09\u3002
\n3. **\u5728\u6e38\u620f\u4e2d**\uff1a\u8fdb\u5165\u5b89\u88c5\u4e86 SimpleCom \u670d\u52a1\u7aef\u63d2\u4ef6\u7684\u670d\u52a1\u5668\uff0c\u804a\u5929\u680f\u4f1a\u6536\u5230\u4e00\u6761\u5305\u542b **6 \u4f4d\u9a8c\u8bc1\u7801** \u7684\u63d0\u793a\u3002
\n4. **\u5728\u5ba2\u6237\u7aef\u754c\u9762\uff08FX GUI\uff09\u4e2d**\uff1a
\n – \u9009\u62e9\u754c\u9762\u8bed\u8a00\uff08`Language \/ \u8bed\u8a00`\uff09\u3002
\n – \u8f93\u5165\u4f60\u7684 **Minecraft \u7528\u6237\u540d**\u3002
\n – \u8f93\u5165\u8bed\u97f3\u670d\u52a1\u5668\u5730\u5740\uff0c\u4f8b\u5982 `example.com:25566` \u6216 `127.0.0.1:25566`\uff08\u5373\u4ee3\u7406\u76d1\u542c\u7aef\u53e3\u6216\u76f4\u63a5 WS \u7aef\u53e3\uff09\u3002
\n – \u8f93\u5165\u804a\u5929\u4e2d\u770b\u5230\u7684 6 \u4f4d **\u9a8c\u8bc1\u7801**\u3002
\n – \u70b9\u51fb **\u8fde\u63a5 \/ Connect**\uff0c\u5ba2\u6237\u7aef\u4f1a\u901a\u8fc7 WebSocket \u8fde\u63a5\u5230\u670d\u52a1\u7aef\u3002
\n5. \u8ba4\u8bc1\u6210\u529f\u540e\u4f1a\u8fdb\u5165\u201c\u5df2\u8fde\u63a5\u201d\u7a97\u53e3\uff0c\u6309\u952e\u8bf4\u8bdd\uff08\u5168\u5c40\u70ed\u952e\uff09\u4e0e\u4fe1\u9053\u63a7\u5236\u5728\u6b64 FX \u7a97\u53e3\u4e2d\u5b8c\u6210\uff0c\u800c\u4e0d\u518d\u4f9d\u8d56\u6e38\u620f\u5185\u6309\u952e\u7ed1\u5b9a\u3002<\/p>\n
—<\/p>\n
## Features \/ \u529f\u80fd\u7279\u6027<\/p>\n
### English<\/p>\n
– Push-to-talk over **Minecraft\u2019s existing connection** (no UDP, no extra ports).
\n– **100 channels** (1\u2013100); channel 0 = mute.
\n– **Forge & Fabric** in one mod (Architectury); one JAR per game version.
\n– Server plugin relays voice between players in the same channel.
\n– VarInt + UTF-8 protocol, compatible with Minecraft payload format.<\/p>\n
### \u4e2d\u6587<\/p>\n
– \u57fa\u4e8e **Minecraft \u5df2\u6709\u8fde\u63a5** \u7684\u6309\u952e\u8bf4\u8bdd\uff08\u4e0d\u7528 UDP\uff0c\u4e0d\u5360\u989d\u5916\u7aef\u53e3\uff09\u3002
\n– **100 \u4e2a\u4fe1\u9053**\uff081\u2013100\uff09\uff1b\u4fe1\u9053 0 \u4e3a\u9759\u97f3\u3002
\n– **Forge \u4e0e Fabric** \u5171\u7528\u540c\u4e00\u6a21\u7ec4\uff08Architectury\uff09\uff0c\u5404\u7248\u672c\u4e00\u4e2a JAR\u3002
\n– \u670d\u52a1\u7aef\u63d2\u4ef6\u5728\u540c\u4fe1\u9053\u73a9\u5bb6\u95f4\u8f6c\u53d1\u8bed\u97f3\u3002
\n– VarInt + UTF-8 \u534f\u8bae\uff0c\u4e0e Minecraft payload \u683c\u5f0f\u517c\u5bb9\u3002<\/p>\n
—<\/p>\n
## Version Compatibility \/ \u7248\u672c\u517c\u5bb9<\/p>\n
### English<\/p>\n
**Each release version is incompatible with other versions.** You must use matching client and server versions.<\/p>\n
– **V2.0** server (plugin\/mod) only works with **V2.0** client. This version introduces the new **Voice Stream API (WSAPI)** and a unified `V2.0` versioning scheme.
\n– **V1.1** server (mod or Bukkit plugin) only works with **V1.1** client.
\n– **V0.1** server only worked with **V1.0** client.<\/p>\n
Do not mix versions: e.g. V2.0 client on a V1.1 server will not work correctly.<\/p>\n
### \u4e2d\u6587<\/p>\n
**\u6bcf\u4e2a\u7248\u672c\u4e0e\u5176\u5b83\u7248\u672c\u4e0d\u517c\u5bb9\u3002** \u5ba2\u6237\u7aef\u4e0e\u670d\u52a1\u7aef\u5fc5\u987b\u4f7f\u7528\u76f8\u540c\u7248\u672c\u3002<\/p>\n
– **V2.0** \u670d\u52a1\u7aef\uff08\u63d2\u4ef6\/\u6a21\u7ec4\uff09\u4ec5\u517c\u5bb9 **V2.0** \u5ba2\u6237\u7aef\u3002\u672c\u7248\u672c\u5f15\u5165\u65b0\u7684 **\u8bed\u97f3\u6d41 API\uff08WSAPI\uff09**\uff0c\u5e76\u7edf\u4e00\u4e3a `V2.0` \u7248\u672c\u53f7\u3002
\n– **V1.1** \u670d\u52a1\u7aef\uff08\u6a21\u7ec4\u6216 Bukkit \u63d2\u4ef6\uff09\u4ec5\u517c\u5bb9 **V1.1** \u5ba2\u6237\u7aef\u3002
\n– **V0.1** \u670d\u52a1\u7aef\u4ec5\u517c\u5bb9 **V1.0** \u5ba2\u6237\u7aef\u3002<\/p>\n
\u8bf7\u52ff\u6df7\u7528\u7248\u672c\uff1a\u4f8b\u5982 V2.0 \u5ba2\u6237\u7aef\u8fde\u63a5 V1.1 \u670d\u52a1\u7aef\u5c06\u65e0\u6cd5\u6b63\u5e38\u5de5\u4f5c\u3002<\/p>\n
—<\/p>\n
## V2.0 Changes \/ V2.0 \u66f4\u65b0\u5185\u5bb9<\/p>\n
### English<\/p>\n
– **New server core (`SimpleCom-server-core`)**: shared pure-Java implementation of the port-multiplex proxy and WebSocket server, reused by Bukkit, Fabric and other server platforms.
\n– **Voice Stream API (WSAPI)**: a token-protected WebSocket endpoint that lets external services (e.g. bots, bridges) subscribe to non-encrypted voice packets in real time.
\n– **Unified versioning**: all main modules in the `V2.0new` branch now use the same version string **`V2.0`** for easier deployment and troubleshooting.<\/p>\n
### \u4e2d\u6587<\/p>\n
– **\u5168\u65b0\u7684\u670d\u52a1\u7aef\u6838\u5fc3\u5e93\uff08`SimpleCom-server-core`\uff09**\uff1a\u5c06\u7aef\u53e3\u590d\u7528\u4ee3\u7406\u4e0e WebSocket \u670d\u52a1\u5668\u62bd\u53d6\u4e3a\u7eaf Java \u516c\u5171\u6a21\u5757\uff0c\u4f9b Bukkit\u3001Fabric \u7b49\u591a\u79cd\u670d\u52a1\u7aef\u5e73\u53f0\u590d\u7528\u3002
\n– **\u8bed\u97f3\u6d41 API\uff08WSAPI\uff09**\uff1a\u65b0\u589e\u5e26 Token \u6821\u9a8c\u7684 WebSocket \u63a5\u53e3\uff0c\u5141\u8bb8\u5916\u90e8\u670d\u52a1\uff08\u5982\u673a\u5668\u4eba\u3001\u8bed\u97f3\u6865\u63a5\u670d\u52a1\uff09\u5b9e\u65f6\u8ba2\u9605\u300c\u975e\u52a0\u5bc6\u4fe1\u9053\u300d\u7684\u8bed\u97f3\u6570\u636e\u5305\u3002
\n– **\u7248\u672c\u53f7\u7edf\u4e00\u4e3a `V2.0`**\uff1a`V2.0new` \u5206\u652f\u4e0b\u4e3b\u8981\u6a21\u5757\uff08\u5ba2\u6237\u7aef\u3001\u670d\u52a1\u7aef\u3001\u6838\u5fc3\u5e93\uff09\u7edf\u4e00\u4f7f\u7528 **V2.0** \u7248\u672c\u53f7\uff0c\u4fbf\u4e8e\u90e8\u7f72\u4e0e\u6392\u9519\u3002<\/p>\n
—<\/p>\n
## Requirements \/ \u4f9d\u8d56\u8bf4\u660e<\/p>\n
### English<\/p>\n
– **Minecraft** (see project for supported versions)
\n– **Architectury API** (required)
\n– **Fabric Loader** + **Fabric API** (Fabric) or **Forge** (Forge)
\n– **Server:** SimpleCom Bukkit\/Spigot plugin for voice to work in multiplayer.<\/p>\n
### \u4e2d\u6587<\/p>\n
– **Minecraft**\uff08\u652f\u6301\u7248\u672c\u89c1\u9879\u76ee\u8bf4\u660e\uff09
\n– **Architectury API**\uff08\u5fc5\u88c5\uff09
\n– **Fabric Loader** + **Fabric API**\uff08Fabric\uff09\u6216 **Forge**\uff08Forge\uff09
\n– **\u670d\u52a1\u5668\uff1a** \u591a\u4eba\u8bed\u97f3\u9700\u5b89\u88c5 SimpleCom Bukkit\/Spigot \u63d2\u4ef6\u3002<\/p>\n
—<\/p>\n
## Donate \/ \u6350\u8d60<\/p>\n
### English<\/p>\n
**Cryptocurrency (USDT):**<\/p>\n
– **USDT on TRON:** `TDoJuuSBTztZFVQuVC7xeEESfFbktBUb9W`
\n– **USDT on Ethereum:** `0x9ce2b2de37976da8e795e7a3ff4badb60b3c8487`
\n– **USDT on BNB Chain:** `0x9ce2b2de37976da8e795e7a3ff4badb60b3c8487`
\n– **USDT on Polygon:** `0x9ce2b2de37976da8e795e7a3ff4badb60b3c8487`
\n– **USDT on X Layer:** `XKO9ce2b2de37976da8e795e7a3ff4badb60b3c8487`<\/p>\n
Thank you for your support.<\/p>\n
### \u4e2d\u6587<\/p>\n
**\u5fae\u4fe1 \/ \u652f\u4ed8\u5b9d\uff1a**
\n
\n<\/p>\n
\u611f\u8c22\u652f\u6301\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"
SimpleCom is a Minecraft voice communication mod that enables in-game push-to-talk voice chat.<\/p>\n","protected":false},"featured_media":140923,"template":"","meta":{"_minecraft_slug":"simplecom","_minecraft_project_id":"eioMe3UT","_minecraft_author":"xiaofanforfabric","_minecraft_license":"LGPL-2.1-only","_minecraft_downloads":202,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simplecom.zip","_minecraft_size_bytes":39165675,"_minecraft_version_count":20,"_minecraft_updated_at":"2026-05-16T12:31:21.856192Z","_minecraft_date_created":"2026-03-24T18:32:48.613048Z","_minecraft_date_modified":"2026-03-11T10:55:01.290830Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simplecom","_minecraft_icon_attachment_id":140923,"_minecraft_imported_at":"2026-06-08T08:53:24+00:00","_minecraft_import_hash":"0ae6d297f972c862892eab2f4aaf0086","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,97,125,104,126,127,128,129,123],"mod_loader":[130,131,106,132,133,134],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-140922","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-fabric","mod_category-folia","mod_category-forge","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_loader-bukkit","mod_loader-folia","mod_loader-forge","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n