TS3-Widget

TS Widget

直接在 Minecraft HUD 中集成 TeamSpeak 3。

TS Widget 通过 ClientQuery 接口连接到您正在运行的 TeamSpeak 3 客户端，显示您当前所在的频道、谁在说话，并让您可以直接在 Minecraft 中控制 TeamSpeak —— 无需再切换窗口。

🔌 连接

• 游戏启动时自动连接（可选，可在设置中开关）
  - 自动 API 密钥检测 —— 在 Windows、macOS 和 Linux 上搜索常见的 TeamSpeak 3 配置位置（%APPDATA%/TS3Client/、~/Library/Application Support/TeamSpeak 3/、~/.ts3client/），并为您读取 ClientQuery 插件的密钥
  - 如果自动检测未找到，则回退到手动配置的 API 密钥
  - 连接断开时，通过心跳监控自动重新连接

🎧 HUD 小组件

• 显示您的当前频道名称以及其中的用户列表
  - 说话指示器 —— 实时查看谁在说话
  - 状态图标，用于说话、空闲、静音、聋哑和离开
  - 可选的**“美观”频道名称格式化
  - 可选显示服务器查询客户端**
  - 可调整的缩放、位置和透明度
  - 最大显示客户端数设置，可在繁忙服务器上保持小组件紧凑
  - 随时使用按键绑定切换小组件可见性

🔔 吐司通知

当 TeamSpeak 事件发生时，在游戏中弹出提示，每个事件均可单独开关：
- 用户加入服务器
- 用户离开服务器
- 用户切换频道
- 您更换频道
- 有人戳您（点击吐司即可直接跳转到回复）

💬 聊天桥接

• 将 TeamSpeak 文本消息桥接到您的 Minecraft 聊天中（可选，有独立的吐司开关）
  - 通过 Minecraft 聊天命令将消息发送回 TeamSpeak

⌨️ 命令

无需离开游戏即可完全控制 TeamSpeak，支持 Tab 补全：
- /tsjoin <频道> —— 切换频道（部分名称匹配，多个匹配时点击选择）
- /tsmsg <玩家> <消息> —— 按昵称向 TS 用户发送私信
- /tspoke <玩家> <消息> —— 戳一戳 TS 用户
- /tschannel <消息> —— 向您当前所在的频道发送消息
- /tsmute / /tsunmute —— 切换您的麦克风
- /tsdeafen —— 切换输出
- /tsafk [消息] —— 将您标记为离开，可附带自定义消息

😴 AFK 同步

• 当您在 Minecraft 中暂停或切换窗口时，自动将您在 TeamSpeak 中标记为离开
  - 可配置同步前的延迟
  - 可自定义离开消息（默认：AFK in Minecraft）
  - 当您返回时自动清除离开状态

⚙️ 设置界面

所有内容都可通过游戏内的专用 UI 进行配置（滑块、开关、标签页）—— 无需手动编辑配置文件。

⌨️ 按键绑定

• TS3 Widget Toggle —— 显示/隐藏小组件
  - TS3 Connect/Disconnect —— 连接或断开
  - Open TS3 Settings —— 打开配置界面

📋 要求

• Minecraft 1.21.11、Fabric Loader >=0.18.1、Fabric API >=0.141.0、Java >=21
  - 启用了 ClientQuery 插件的 TeamSpeak 3 客户端

🔧 设置

1. 在 TeamSpeak 3 中启用 ClientQuery：工具 → 选项 → 附加组件 → ClientQuery
   2. 将 TS Widget 与 Fabric API 一起安装
   3. 启动 Minecraft —— TS Widget 会自动检测您的 API 密钥并连接

📄 许可证

MIT —— 仅客户端使用，数据不会离开您的机器（仅连接到 127.0.0.1）。

支持
发现错误、有建议或需要帮助？加入我们的 Discord 并提交工单！
https://discord.gg/Z3b8NvWb9n