TeamViewRelay

一个用于 Minecraft 团队协同作战的 视觉与信号共享 系统。目前主要针对 Minecraft 1.21.8 Fabric 进行开发与验证。

1. 核心特性

• 团队玩家数据同步：同步玩家位置、实体信息和共享路标点
• 快速标记：通过快捷键 / 双击鼠标中键一键标记；支持中键取消、超时清理和数量限制
• 可选的 Xaero 集成：
• 与 Xaero 小地图的双向共享路标点同步
• 与 Xaero 大地图的远程玩家追踪同步
• 可选的 JourneyMap 集成：
• 在地图上共享路标点并显示远程玩家
• 房间隔离：通过 roomCode 分隔不同的游戏大厅，避免相互干扰

推荐的可选安装：

• Mod Menu（可从模组列表中直接访问配置）
• Xaero 小地图（路标点同步联动）
• Xaero 大地图（远程玩家追踪联动）
• JourneyMap（远程玩家追踪联动）

2. 游戏内初始配置

1. 进入游戏后，按下默认快捷键 O 打开配置面板。
2. 默认服务器地址：ws://127.0.0.1:8765/mc-client（修改为你的后端地址）
3. 选择一个房间 ID（默认：default；只有同一房间内的玩家才能相互看见）
4. 点击 保存服务器设置，然后点击 连接。

3. 基本控制

• O：打开配置面板（默认绑定）
• 连接切换快捷键：默认未绑定 — 请在控制设置中手动设置
• 快速标记快捷键：默认未绑定 — 请在控制设置中手动设置

只有在 **渲染已启用 且 网络连接已建立** 时，标记和同步功能才会生效。

4. 显示功能

• 远程玩家边界框
• 追踪线
• 友方 / 中立 / 敌方颜色编码系统
• 可切换的标记渲染样式：信标 / 圆环 / 图钉

5. 标记机制

• 快速标记：按下专用标记快捷键，或启用双击鼠标中键标记
• 取消标记：单击鼠标中键以移除准星附近你自己的标记
• 自动移除：当目标实体死亡确认时，实体标记会在本地自动取消
• 数量限制：当玩家超过最大标记数量时，旧标记会自动清除

6. 配置项

• 主配置：服务器 URL、房间 ID、连接 / 断开控制
• 显示设置：渲染距离、边界框/追踪线开关、追踪线起点、颜色与标记子设置
• 网络设置：上传频率、实体上传开关、共享路标点上传、系统代理
• 标记设置：标记可见性、鼠标中键交互、持久标记、视觉样式与形状参数

配置文件路径：config/MC-Teamviewer.json（标准 Fabric 配置目录）

版本命名规则

本项目采用双版本号方案，例如 v0.2.1-proto0.3.0：

• 应用版本：0.2.1 — 表示核心功能迭代与程序更新
• 网络协议版本：0.3.0 — 定义了跨程序通信的协议标准

所有连接的客户端和后端服务需要网络协议版本一致或完全匹配，才能正常连接和进行团队协作。

安装

除了在游戏中安装此模组外，你还需要搭建一个中心服务器来提供服务器 URL，用于同步每个玩家的数据。链接如下： https://github.com/MC-TeamViewer/Minecraft-TeamViewer-Backend