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