SimpleCom
V2.0SimpleCom is a Minecraft voice communication mod that enables in-game push-to-talk voice chat.
V2.0latestSimpleCom V2.0Mar 11, 2026 V2.0 更新日志 / V2.0 Changelog
- 协议与架构 / Protocol & Architecture - 从 Minecraft payload 消息通道 完全迁移为 WebSocket + 服务器端代理端口复用。 Switched from in-game payload channels to a WebSocket-based architecture with a port-multiplexing proxy. - 新增独立的 服务端核心库 `SimpleCom-server-core`,统一实现端口复用代理、WebSocket 认证与语音转发逻辑。 Introduced a shared server core (SimpleCom-server-core) that contains the proxy, WS auth and voice routing. - 客户端 / Client - 新增 JavaFX 图形客户端 流程:在游戏中获取 6 位验证码,在 FX GUI 中填写用户名 / 服务器地址 / 验证码,通过 WebSocket 连接语音服务。 Added a JavaFX client workflow: get a 6‑digit code in-game, then connect via the FX GUI over WebSocket using username/server/code. - 为 Fabric/Forge V2.0 客户端模组 内置 SimpleCom-core、Opus 编解码器、JavaFX 依赖,开箱即用。 Fabric/Forge V2.0 client mods now bundle SimpleCom-core, Opus codec and JavaFX, so users can just drop in the jar. - 服务端 / Server - 新增 端口复用代理(PortMultiplexProxy):一个公网端口同时承载 MC 与 WebSocket,自动区分协议并转发。 Added a port-multiplex proxy so a single public port serves both Minecraft and WebSocket traffic. - Bukkit 插件SimpleCom-server与跨平台服务端simpleCom-server-all-1.20.1均改为基于SimpleCom-server-core。 Bukkit pluginSimpleCom-serverand cross-platform serversimpleCom-server-all-1.20.1are now built on top ofSimpleCom-server-core. - 语音流 API / Voice Stream API (WSAPI) - 新增 WSAPI(WebSocket 语音流接口):允许外部服务(如 KOOK/Discord 机器人)通过 WebSocket 订阅「非加密信道」语音数据包。 Introduced WSAPI, a WebSocket stream API for external services (e.g. KOOK/Discord bots) to subscribe to non‑encrypted voice packets. - 使用 Token 鉴权,提供心跳与服务器状态推送,详细协议见V2.0new/WSAPI.md。 WSAPI uses token-based auth and sends heartbeat + server status; seeV2.0new/WSAPI.mdfor protocol details. - 版本与构建 / Versioning & Build - 所有 V2.0 相关模块统一使用版本号 `V2.0`,包括客户端、服务端和核心库。 All V2.0 modules (clients, servers, core) share the same version string `V2.0`. - CI 工作流更新为:在推送V2.*标签时,仅构建V2.0new下的 4 个 V2.0 项目并自动发布 Release。 CI workflow now builds only the four V2.0new projects and auto‑publishes a Release when aV2.*tag is pushed.1.2SimpleCom 1.2Mar 6, 2026 SimpleCom V1.2 Changelog
SimpleCom V1.2 更新日志
New Features
新增功能
Encrypted Channels
加密信道
- Create encrypted channel: Press C → "创建加密信道" → Enter name and password - 创建加密信道:按 C →「创建加密信道」→ 输入信道名称和密码 - Connect to encrypted channel: Press C → "连接加密信道" → Get server channel list - 连接加密信道:按 C →「连接加密信道」→ 获取服务器加密信道列表 - Join encrypted channel: Enter password to join, only players with password can hear/send - 加入加密信道:输入密码加入,仅知道密码的玩家可收发语音 - Exit encrypted channel: Press C when in encrypted channel to view current channel and exit - 退出加密信道:在加密信道状态下按 C 可查看当前信道并退出 - Encrypted channel IDs start from 101 (separate from public channels 1–100) - 加密信道 ID 从 101 起,与普通信道 1–100 区分Minecraft 1.19.2 Support
Minecraft 1.19.2 支持
- Client mod: Fabric & Forge 1.19.2 - 客户端模组:支持 Fabric 与 Forge 1.19.2 - Server mod: Fabric & Forge 1.19.2 server - 服务端模组:支持 Fabric 与 Forge 1.19.2 服务端 ---Version Compatibility
版本兼容
| Platform / 平台 | 1.16.5 | 1.18.2 | 1.19.2 | |-----------------|--------|--------|--------| | Client (Fabric/Forge) / 客户端 ||
|
| | Server Mod (Fabric/Forge) / 服务端模组 |
|
|
| | Bukkit/Spigot Plugin / Bukkit 插件 |
| - | - | Note: V1.2 client requires V1.2 server (mod or Bukkit plugin). Do not mix with V1.1 or earlier. 注意: V1.2 客户端需搭配 V1.2 服务端(模组或 Bukkit 插件)使用,请勿与 V1.1 及更早版本混用。 ---
Technical Changes
技术变更
- 1.19.2 API updates:LiteralText→Text.literal(),ClientPlayerNetworkEvent.LoggingIn/LoggingOut,PlayerEvent.getEntity()- 1.19.2 API 适配:LiteralText→Text.literal(),ClientPlayerNetworkEvent.LoggingIn/LoggingOut,PlayerEvent.getEntity()- Server encrypted channel:EncryptedChannelStore,EncryptedChannelHandler, etc. - 服务端加密信道:EncryptedChannelStore、EncryptedChannelHandler等 - Bukkit plugin: Encrypted channel create/list/join support - Bukkit 插件:支持加密信道的创建、列表、加入 ---Downloads
下载
See [GitHub Releases](https://github.com/xiaofanforfabric/SimpleCom/releases/ta… for: 从 [GitHub Releases](https://github.com/xiaofanforfabric/SimpleCom/releases/ta… 下载: -simplecom-1.16.5-*/simplecom-1.18.2-*/simplecom-1.19.2-*(client / 客户端) -simplecom-server-1.16.5-*/simplecom-server-1.18.2-*/simplecom-server-1.19.2-*(server mod / 服务端模组) -bukkitserver-*(Bukkit/Spigot plugin / Bukkit 插件)1.1SimpleCom 1.1Mar 6, 2026 V1.1 Changelog / V1.1 更新日志
English
Features
- Low-latency mode (边录边发): When the server enables low latency, the client now streams voice while holding the key (sends every ~40 ms) instead of sending only after key release. Reduces perceived delay. - Multi-speaker display: If multiple players talk at once, the action bar shows “PlayerA, PlayerB, PlayerC... 正在对讲” instead of only one name. - Per-player playback: Each player’s voice is decoded and played on a dedicated thread (and dedicatedVoicePlayer). Multiple people talking at once are mixed correctly instead of playing out of order. - Mod server (1.16.5 / 1.18.2): Server mod now supports the same options as the Bukkit plugin:use_compression_encoderandlow_latencyin config, handshake includes these two bytes so the client can match server behavior. - Server startup log: Bukkit and mod servers log on startup: “已启用,使用 payload 通道传输数据,压缩编码器:启用/关闭,低延迟:开启/关闭”. - Client status messages: After handshake, the client shows in chat whether the server uses low latency or “原版通信模式”, and whether compression is enabled.Fixes
- Duplicate last packet: In low-latency mode, the last voice packet was sometimes played twice; deduplication (per-user, 80 ms window) fixes this. - 1.18.2 Forge handshake: Server was casting toServerCustomPayloadEvent; Forge actually usesClientCustomPayloadEventwhen the server receives a client payload. Cast corrected so the handshake works.Version & docs
- Version: All mod clients, mod servers, and the Bukkit plugin are now V1.1. - Version compatibility: Docs (README, MODRINTH_DESCRIPTION) state that each release is incompatible with others: V1.1 server only works with V1.1 client; V0.1 only with V1.0. Do not mix versions. - CI: Workflow builds 1.16.5/1.18.2 client mods, 1.16.5/1.18.2 server mods, and the Bukkit plugin, and uploads all artifacts. ---中文
功能
- 低延迟模式(边录边发): 服务端开启低延迟时,客户端改为按住说话键期间按约 40 ms 间隔边录边发,不再仅松键发送,降低延迟感。 - 多人对讲显示: 多人同时说话时,物品栏上方显示“玩家A,玩家B,玩家C... 正在对讲”,不再只显示一个人名。 - 按玩家独立播放: 每位玩家的语音在独立线程中解码、独立播放器播放,多人同时说话时正确混音,不再乱序。 - 模组服务端(1.16.5 / 1.18.2): 服务端模组与 Bukkit 插件对齐:支持配置项use_compression_encoder、low_latency,握手包末尾两字节下发,客户端可据此启用压缩/低延迟。 - 服务端启动日志: Bukkit 与模组服务端启动时输出:“已启用,使用 payload 通道传输数据,压缩编码器:启用/关闭,低延迟:开启/关闭”。 - 客户端状态提示: 握手成功后聊天栏提示服务端是否启用低延迟、是否启用压缩(“原版通信模式”等)。修复
- 最后一个语音包重复播放: 低延迟下最后一个包有时被播放两次;增加按用户、80 ms 窗口的去重后已修复。 - 1.18.2 Forge 握手: 服务端误用ServerCustomPayloadEvent,实际应使用ClientCustomPayloadEvent,已改为正确类型,握手正常。版本与文档
- 版本号: 所有模组客户端、模组服务端、Bukkit 插件统一为 V1.1。 - 版本兼容说明: README、MODRINTH_DESCRIPTION 中注明“每个版本与其它版本不兼容”:V1.1 服务端仅兼容 V1.1 客户端,V0.1 仅兼容 V1.0,请勿混用。 - CI: 工作流构建 1.16.5/1.18.2 模组客户端、1.16.5/1.18.2 模组服务端、Bukkit 插件,并上传全部产物。v0.1SimpleCom v0.1 for serverMar 4, 2026
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
WorldEdit
A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.
11.6MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
3.9MSueta