[TACZ] 使命召唤匹配系统

COD Matchmaking - Minecraft 团队死亡竞赛

《使命召唤》风格的 Minecraft 团队死亡竞赛，由 TACZ（Timeless and Classics Guns） 驱动，提供逼真的枪战体验。

创建竞技场、设置出生点、注册武器并设定解锁等级，让玩家在快节奏的红蓝对抗中战斗 —— 包含升级系统、自定义配装、武器图鉴和地图投票。

---

功能特性

匹配与游戏流程

• 地图浏览器 —— 浏览所有可用地图，实时显示在线人数、比赛状态和倒计时
• 快速加入 —— 输入 /play 即可瞬间进入最佳可用比赛
• 队伍自动平衡 —— 玩家自动分配至红队或蓝队
• 比赛生命周期 —— 等待 → 倒计时 → 进行中 → 结束 → 地图投票，全自动化
• 地图投票 —— 每场比赛结束后，玩家投票选择下一张地图
• 中途加入 —— 玩家可加入已进行的比赛，并立即获得配装

武器与配件系统

• 完整 TACZ 集成 —— 支持所有 TACZ 枪械、配件和投掷物
• 自动扫描 —— 使用单条命令 (/tdm weapon scan) 即可发现服务器上所有 TACZ 武器和配件
• 6 种配件类型 —— 瞄具、枪口、枪托、握把、激光、扩容弹匣
• 武器类别 —— 主武器、副武器、手雷、护甲、物品
• 武器图鉴 GUI —— 玩家可浏览所有武器/配件，查看详细属性（伤害、射速、弹药、爆头倍率、穿透力、射击模式、配件修正）
• 兼容性检查 —— 每把武器仅显示兼容配件（基于 TACZ 标签匹配）

升级系统

• 击杀经验 —— 每次击杀获得经验，爆头额外奖励
• 1–60 级 —— 升级解锁武器和配件
• 数据持久化 —— 击杀、死亡、爆头次数和等级跨会话保存
• 经验 HUD 弹出提示 —— 获得经验或升级时屏幕显示通知

自定义配装

• 每位玩家 10 个配装槽位 —— 创建并保存个人配装
• 完整配装编辑 GUI —— 选择主武器、副武器、手雷、配件、护甲和额外物品
• 配件选择 —— 可视化配件选择器，按武器兼容性过滤
• 等级锁定 —— 武器和配件需要达到相应等级才能装备
• 无限弹药箱 —— 自动包含，确保弹药永不耗尽

管理员配装（按地图）

• 地图专属配装 —— 创建绑定到特定地图的预制配装
• GUI 编辑器 —— 面向管理员的可视化配装管理器
• 每张地图最多 20 个配装（可配置）
• 配装选择界面 —— 玩家在出生前从可用配装中选择

游戏内 HUD

• 实时记分板 —— 红蓝分数、击杀上限和比赛计时始终可见
• TAB 菜单 —— 自定义玩家列表，显示队伍、击杀和死亡数
• 队伍标识 —— 清晰的视觉队伍区分
• 游戏内按钮 —— 比赛期间可访问“配装”和“武器”按钮

战斗特性

• 友军伤害防护 —— 无队伍伤害
• 重生无敌 —— 复活后可配置的无敌时间（默认 3 秒）
• 爆头检测 —— 集成 TACZ 爆头系统
• 击杀追踪 —— 准确的击杀/死亡归属，消除重复死亡计数

---

命令

玩家命令

命令	描述
/play	快速加入最佳可用比赛
/play <地图>	加入特定地图
/tdm join [地图]	加入比赛（同 /play）
/tdm leave	离开当前比赛
/tdm list	列出所有地图及其状态、玩家数和设置
/tdm weapons	打开武器图鉴 GUI

管理员命令（权限等级 2）

地图管理

命令	描述
/tdm create <地图>	创建新地图
/tdm delete <地图>	删除地图
/tdm setspawn <地图> <red|blue>	在当前站位添加队伍出生点
/tdm setobj <地图> <击杀上限>	设定击杀上限（1–1000）
/tdm settimer <地图> <秒数>	设定比赛时长（30–3600 秒）
/tdm setminplayers <地图> <数量>	设定比赛开始所需最少玩家数（1–64）
/tdm setlobby	在当前站位设置大厅传送点
/tdm start [地图]	强制开始比赛
/tdm stop [地图]	强制停止比赛

配装管理

命令	描述
/tdm loadout	打开配装管理 GUI
/tdm loadout create <地图> <名称>	为地图创建配装
/tdm loadout delete <地图> <名称>	删除配装
/tdm loadout setitem <地图> <名称> <槽位>	将手持物品设到快捷栏（槽位 0–8）
/tdm loadout setarmor <地图> <名称> <head|chest|legs|feet>	将手持物品设为护甲部件
/tdm loadout setoffhand <地图> <名称>	将手持物品设为副手物品
/tdm loadout list <地图>	列出地图的所有配装

武器与配件注册

命令	描述
/tdm weapon editor	打开武器编辑器 GUI
/tdm weapon scan	自动发现所有 TACZ 武器和配件
/tdm weapon add hand <类别> <等级>	将手持物品注册为武器
/tdm weapon add <ID> <类别> <等级> [名称]	按 ID 注册武器
/tdm weapon remove <ID>	注销武器
/tdm weapon setlevel <ID> <等级>	设定武器解锁等级（0–60）
/tdm weapon list [类别]	列出已注册武器
/tdm weapon attachment add hand <等级>	注册手持配件
/tdm weapon attachment add <ID> <类型> <等级> [名称]	按 ID 注册配件
/tdm weapon attachment remove <ID>	注销配件
/tdm weapon attachment setlevel <ID> <等级>	设定配件解锁等级
/tdm weapon attachment list	列出已注册配件

武器类别： primary（主武器）、secondary（副武器）、grenade（手雷）、armor（护甲）、items（物品） 配件类型： SCOPE（瞄具）、MUZZLE（枪口）、STOCK（枪托）、GRIP（握把）、LASER（激光）、EXTENDED_MAG（扩容弹匣）

---

快速入门指南

1. 安装

• 安装 Minecraft Forge 1.20.1（47.2.20+）
• 安装 TACZ（Timeless and Classics Guns）
• 将 codmatchmaking.jar 放入 mods/ 文件夹

2. 创建地图

/tdm create MyArena
/tdm setspawn MyArena red       (站在红队出生点，重复添加更多出生点)
/tdm setspawn MyArena blue      (站在蓝队出生点，重复添加更多出生点)
/tdm setobj MyArena 75          (75 杀获胜)
/tdm settimer MyArena 600       (10 分钟计时)
/tdm setlobby                   (设置大厅返回点)

3. 注册武器

/tdm weapon scan                (自动导入所有 TACZ 武器和配件)

或手动添加：

/tdm weapon add hand primary 1  (手持枪械注册为主武器，解锁等级 1)

4. 设定解锁等级

/tdm weapon setlevel tacz:ak47 5
/tdm weapon attachment setlevel tacz:red_dot_sight 3

或使用 GUI：/tdm weapon editor

5. 开始游戏！

/play MyArena

玩家将看到地图浏览器，选择地图，挑选配装，然后开战！

---

配置

所有设置均位于 config/codmatchmaking-common.toml：

设置项	默认值	范围	描述
defaultKillLimit	75	1–1000	新地图默认击杀上限
defaultTimerSeconds	600	30–3600	默认比赛时长（秒）
defaultMinPlayers	2	1–64	比赛开始最少玩家数
defaultMaxPlayers	64	2–128	每场比赛最多玩家数
countdownSeconds	10	3–60	赛前倒计时
respawnInvincibilityTicks	60	0–200	复活后无敌时间（游戏刻）
endDelayTicks	200	40–600	比赛重置前延迟（游戏刻）
voteDurationSeconds	15	5–60	地图投票阶段时长
maxLoadoutsPerMap	20	1–50	每张地图最大管理员配装数
xpPerKill	100	1–10000	每次击杀获得的经验
xpHeadshotBonus	25	0–5000	爆头额外经验
maxLevel	60	1–200	玩家最高等级
maxCustomLoadouts	10	1–20	每位玩家自定义配装槽位数

---

要求

• Minecraft 1.20.1
• Forge 47.2.20+
• TACZ（Timeless and Classics Guns）—— 必须安装

---

附加组件兼容性

支持 TACZ 附加组件包（例如 LesRaisins 武器包）。附加组件中的投掷物和近战武器可通过 /tdm weapon scan 自动检测。

---

数据存储

所有数据均存储在世界文件夹的 worlddata/ 目录下：

• 地图 —— 每张地图的 JSON 配置
• 武器和配件 —— 武器注册 JSON
• 玩家进度 —— 每位玩家的 JSON（等级、经验、数据）
• 玩家配装 —— 每位玩家的 JSON（自定义配装槽位）

无需外部数据库，所有数据在服务器重启后持久保存。