FPS游戏开发

---

第 01 步 场景系统

😜 创建一个Web-based第三人称射击游戏新手场景，使用Three.js进行3D渲染，参考无畏契约的风格。

• Three.js：一款基于 WebGL 的 JavaScript 3D 图形库，可以在浏览器中直接渲染 3D 场景，无需安装任何插件。它提供了相机、灯光、几何体、材质等全套 3D 渲染组件，是当前 Web 端做 3D 游戏最主流的选择。
• Web-based：基于浏览器运行的意思，即游戏直接在网页（Chrome、Edge、Firefox 等）中打开就能玩，不需要下载安装客户端。
• 3D 渲染：将 3D 模型数据（几何体、纹理、光照）通过计算转换成 2D 屏幕图像的过程。每一帧（通常每秒 60 次）都会重新渲染一次，形成动态画面。
• 无畏契约（Valorant）：由拳头公司开发的一款战术射击游戏，风格特点是科幻感十足、色彩鲜明、线条干净。本项目参考它的视觉风格。
• 第三人称：相机在角色身后，可以看到角色全身的视角。与此相对的是第一人称（FPS），相机在角色眼睛位置，只能看到手和武器。

第 02 步 去 AI 化

😜 去掉游戏里墙上的 "AI生成" 字样，纹理资源在 app/public/ 目录下

• 纹理资源：贴在 3D 模型表面的图片文件。比如一面墙看起来是金属的，其实是墙这个模型表面贴着一张画了金属花纹的图片（纹理）。
• 模型 + 纹理：3D 场景由两部分组成：模型是几何体（决定物体形状），纹理是图片（决定物体看起来是什么材质）。两者配合才能让"一块三角形网格"看起来像"金属墙"。生成的场景采用的是模型 + 纹理，纹理就是一张张图片，AI生成的字样是在图片左下角的，所以直接找到图片路径，让AI去改，目标更明确，会更加高效。
• app/public/ 目录：这个目录是项目中的素材文件夹，存放所有图片、音频等资源文件，浏览器可以直接通过 URL 访问这些资源。

第 03 步 移动系统

😜 【核心逻辑】实现真实人物行走模拟系统，要求符合人体运动学原理，提供自然流畅的移动体验。

【交互操作规范】

1. 基础移动控制：
   • W键：控制角色向前移动
   • A键：控制角色向左移动
   • S键：控制角色向后移动
   • D键：控制角色向右移动
2. 速度模式切换：
   • 未按住Shift键：启用慢走模式
   • 按住Shift键：启用快走/奔跑模式

【交互结果与技术要求】

1. 角色移动系统：
   • 慢走模式：移动速度设定为中等（建议值：3-4米/秒）
   • 快走/奔跑模式：移动速度设定为较快（建议值：6-7米/秒），需确保与慢走模式有明显速度差异
2. 镜头效果实现：
   • 基础缓动效果：为第一人称镜头添加自然的呼吸式缓动效果，建议使用正弦曲线控制垂直方向±1-2度的轻微摆动，周期设定为3-4秒
   • 慢走模式：镜头晃动幅度较小（建议水平±0.5度，垂直±0.3度）
   • 快走/奔跑模式：镜头晃动幅度显著增加（建议水平±1.5度，垂直±1度），晃动频率提高至慢走模式的1.5-2倍
3. 音频系统实现：
   • 脚步声资源：需提供至少两套脚步声素材（慢走和快走/奔跑）
   • 慢走模式：播放节奏舒缓的脚步声，音量中等，步频建议0.6-0.8步/秒
   • 快走/奔跑模式：播放节奏急促的脚步声，音量提高20-30%，步频建议1.2-1.5步/秒
   • 音频触发机制：根据角色实际移动状态（静止/移动/速度模式）智能触发和切换脚步声，确保脚步声与移动动画同步
4. 整体体验要求：
   • 移动控制响应延迟不超过50ms
   • 镜头过渡效果平滑无卡顿
   • 脚步声与移动状态精准同步，无明显延迟或提前
   • 所有效果在不同帧率（30-120fps）下均能保持一致性和稳定性

• 人体运动学原理：人类真实行走的物理规律，例如：走路时左右脚交替、每一步有节奏、速度快时步子变大变快、头部会随步伐起伏等。
• 正弦曲线（sine wave）：数学函数 y=sin(x) 产生的波浪形曲线。在游戏中常用于模拟"来回摆动、周期性变化"的效果，例如呼吸、晃动。其值在 -1 到 1 之间平滑变化。乘上一个变量，即可修改它的值域。
• 缓动效果（Tween / Lerp）：不是从 A 瞬间跳到 B，而是用一小段时间平滑过渡。比如从"静止"到"移动"，镜头晃动幅度不会从 0 突然变到最大值，而是逐渐增大。
• 帧率（FPS / Frames Per Second）：屏幕每秒刷新次数。60fps 表示每秒画 60 张画面。不同设备帧率不同，所以时间相关的效果（如步伐节奏）必须用真实时间计算，而不是用"刷新次数"，否则在不同帧率下节奏会不一样。
• 音频触发机制：根据玩家是否在移动、移动速度是快还是慢，自动决定"要不要播放脚步声"、"用哪个速度的脚步声"、"多久播放一次"的智能判断逻辑。
• 响应延迟：玩家按键到画面产生变化的时间差。50ms 以内感觉不到延迟，超过 100ms 玩家会觉得"按键卡了"。

第 04 步 跳跃系统

😜 【核心逻辑】实现真实物理效果的玩家跳跃机制，用于使玩家角色能够越过游戏场景中的障碍物。该机制需模拟符合现实物理规律的跳跃轨迹，包括上升阶段和下降阶段。

【交互操作】玩家通过按下键盘空格键(Space)触发跳跃动作。系统需准确检测空格键的按下事件，确保响应及时且无延迟。

【物理参数】设置合理的重力加速度值，建议范围为9.8-12 m/s²，确保跳跃手感自然。同时配置适当的初始跳跃速度，使跳跃高度与游戏场景障碍物相匹配。

【音效控制】实现以下音效播放逻辑：

1. 玩家起跳瞬间播放上跳音效
2. 玩家角色落地瞬间播放落地音效
3. 跳跃过程中（从起跳至落地）完全禁用行走时的脚步声播放

【时间控制】严格控制从玩家起跳开始到落地结束的总时长为1.3秒。需通过调整重力加速度和初始跳跃速度来精确实现这一要求。

【实现要求】

1. 确保跳跃动画与物理运动同步
2. 跳跃过程中角色碰撞体积保持准确
3. 防止连续跳跃（需落地后才能再次起跳）
4. 跳跃轨迹应平滑自然，无明显卡顿或抖动

【测试标准】

1. 跳跃总时长精确控制在1.3±0.05秒范围内
2. 音效播放时机准确，无提前或延迟
3. 跳跃过程中脚步声完全静音
4. 能够稳定越过设计规格内的障碍物

• 重力加速度（g）：地球表面物体自由下落的加速度，现实中约为 9.8 m/s²。意思是每秒速度增加 9.8 米/秒。在游戏中可以适当加大到 10-12，让跳跃手感更"有劲"。
• 物理规律的跳跃轨迹：在现实中，你跳起来后速度不是匀速的——上升时速度越来越慢直到 0，然后开始下落且速度越来越快。这个曲线是抛物线形状。
• 初始跳跃速度：起跳瞬间给玩家向上的速度，例如 5 m/s。配合重力一起决定跳多高、跳多久。
• 碰撞体积：玩家在物理系统中的"占位大小"，即使看起来是一个人形，物理上也通常用一个简化的盒子或胶囊体来代表玩家，用于检测是否撞到墙或站在地上。
• 防止连续跳跃：跳跃后必须先落地才能再次起跳，避免玩家可以在空中连续按空格无限"飞"起来的作弊行为。实现方式是给玩家一个"在地面上"的布尔标记。
• 上升阶段 / 下降阶段：一次完整跳跃的两部分。上升阶段：速度向上但在减小（因为重力在拉），直到最高点速度为 0。下降阶段：速度向下且越来越大，直到落地。

第 05 步 武器系统

😜 【核心逻辑】实现真实玩家持枪的第一人称视角模拟系统。

【交互操作】从互联网资源库搜索并获取符合以下技术规范的AK47武器模型文件：

1. 格式必须为GLB（二进制GLTF）格式
2. 模型多边形数量控制在5000-15000面之间，确保性能与细节平衡
3. 需包含基本材质和纹理信息
4. 模型原点应设置在合理的握持位置

【交互结果】实现以下武器装备功能：

1. 初始状态：玩家角色处于无武器状态
2. 武器装备：成功加载AK47模型后，将其挂载到玩家相机对象层级下作为子物体
3. 位置调整：设置AK47模型的局部坐标为相机前方偏下的标准第一人称持枪位置（建议参考行业标准参数：X: 0.2-0.3, Y: -0.15-0.25, Z: 0.5-0.7单位）
4. 旋转调整：设置AK47模型的局部旋转参数，确保枪口精确指向相机正前方（建议参考行业标准参数：X: 15-25°, Y: 0-5°, Z: 0-5°）
5. 跟随机制：实现AK47模型与玩家相机的完全同步跟随，包括但不限于：
   • 相机的平移运动
   • 相机的俯仰旋转
   • 相机的左右旋转
   • 相机的倾斜角度变化

【技术要求】

1. 模型加载过程需包含错误处理机制，确保在模型加载失败时提供明确反馈
2. 武器跟随必须保持平滑无延迟，帧率不低于60FPS
3. 模型位置和旋转参数应设计为可配置，便于后续调整优化
4. 确保武器模型不会穿透场景几何体或玩家自身模型
5. 实现武器装备状态的切换逻辑，支持从无武器到有武器的平滑过渡效果

• GLB / GLTF 格式：当前最主流的 3D 模型文件格式。GLTF 是文本版（类似 JSON），GLB 是 GLTF 的二进制压缩版本（文件更小、加载更快），适合在网络上传输。
• 多边形数量（面数）：3D 模型由许多小三角形拼成，面数越多模型越精细，但性能开销越大。5000-15000 面对于 Web 游戏中的一把枪是合理范围。
• 材质和纹理：材质决定物体的反光、光泽、颜色等属性；纹理是贴在模型上的图片。两者配合才能让一把枪看起来像"金属枪"而不是"灰色塑料"。
• 模型原点：模型的中心点/基准点。移动、旋转模型都围绕这个点。如果原点在"枪的握把处"，那么把原点放到相机前，枪就自然握在手里。
• 相机对象层级（Parent-Child Hierarchy）：把武器模型设为相机的"子物体"后，相机移动/旋转，武器会自动跟着移动旋转，不需要额外代码。
• 局部坐标（Local Coordinates）：相对于父物体的位置。武器作为相机的子物体，它的局部坐标 (0.25, -0.2, 0.6) 表示"在相机右方 0.25、下方 0.2、前方 0.6 的位置"。
• 局部旋转：武器自己的旋转角度。X 轴旋转控制枪口上下摆动，Y 轴控制左右转动，Z 轴控制滚动。
• 行业标准参数：经过大量游戏验证、被广泛采用的数值范围。例如第一人称枪一般放在相机前方 0.5-0.7 米处，稍微偏右下。

第 06 步 野怪系统

😜 【核心逻辑】实现野怪动态生成与追击系统：

1. 野怪生成机制：按照预设频率和数量在指定区域内刷新野怪实体
2. 模型配置：所有生成的野怪必须使用类型为"Wingman"的角色模型资源
3. 警戒范围系统：为每个野怪设置圆形警戒区域，半径为${alert_radius}单位
4. 追击行为：当玩家角色进入野怪的警戒范围时，野怪应立即停止当前行为并启动追击逻辑
5. 移动逻辑：野怪追击时需以${movement_speed}的速度持续向玩家当前位置移动，路径规划应避开地形障碍物
6. 脱离机制：当玩家离开野怪警戒范围${leash_distance}单位后，野怪应停止追击并返回初始生成位置

• 动态生成（Spawn / Refresh）：不是一开始就在场景里放好所有敌人，而是根据时间和位置，在游戏运行中"凭空生成"新的敌人。
• 警戒范围（Alert Radius / Aggro Range）：围绕野怪的一个不可见圆圈。玩家进入这个圆（通常是 10-20 米半径），野怪就会注意到玩家并开始攻击。
• 追击逻辑（Chase AI）：野怪持续朝玩家位置移动的 AI 行为。最简单的实现是"每帧朝玩家走一步"，高级版本会加入避障、加速、减速等。
• 路径规划（Pathfinding）：野怪不会直接穿墙去追玩家，而是绕过障碍物。常见算法是 A*（A-Star），在游戏行业非常标准。
• 脱离机制（Leash / Disengage）：玩家跑太远后，野怪不会无限追下去，而是追到一定范围就放弃，回到自己出生点。防止玩家把野怪拉到地图另一端卡住。
• leash_distance： leash 原意为"拴狗绳"，在游戏 AI 里引申为"最远追击距离"，意思是野怪只能离开出生点这么远。
• Wingman：本项目中使用的一个野怪角色模型名称，看起来像一个机器人/机械敌人。

第 07 步 射击系统

😜 【核心逻辑】实现武器开火系统，具体功能包括：

1. 音效播放机制：根据当前装备的武器类型（如AK-47）播放对应的开火音效，设计可扩展的音效接口以支持未来新增武器类型
2. 射线检测系统：在开火时发射检测射线，当射线与野怪模型发生碰撞时判定为击中
3. 伤害与生命系统：实现击中判定后对野怪造成指定数值伤害的功能，当野怪生命值归零时触发死亡状态
4. 死亡动画系统：野怪死亡时执行上漂3米的位移动画，同时模型进行3倍比例放大，并伴随淡出效果直至完全消失

【交互操作】实现鼠标左键点击检测机制，仅在以下条件同时满足时触发开火动作：

• 玩家已装备武器
• 武器当前拥有可用子弹
• 检测到有效的鼠标左键按下事件

【交互结果】当前默认武器为AK-47，需播放AK-47特定的开火音效；系统架构需预留武器音效接口，确保后续添加新武器时可通过配置文件或代码扩展方式绑定对应音效资源，无需修改核心逻辑代码。

【UI提示】在游戏界面中心位置实现动态准心系统：

• 默认状态下显示标准准心（建议为白色或灰色）
• 当准心瞄准野怪模型时，准心颜色实时切换为红色
• 确保准心在不同屏幕分辨率下保持居中且大小适配
• 准心应位于所有游戏场景元素之上，保证视觉可见性

• 可扩展接口（Extensible Interface）：一种程序设计方式。先定义好"播放音效"的统一规则（参数：武器类型），以后新增武器时只要按规则加入配置即可，不需要改动核心逻辑代码。
• 射线检测（Raycasting / Raycast）：从相机位置沿枪口方向发射一条不可见的直线（射线），检测这条线是否碰到任何物体。这是 FPS 游戏判断"子弹打到哪了"最标准、最快速的方法。
• 碰撞判定（Collision Detection）：判断射线是否命中某个物体。如果射线穿过野怪的碰撞体积，就判定为击中。
• 伤害数值（Damage Value）：每次射击造成的生命值减少量，例如 AK-47 每发造成 25 点伤害。
• 生命值（HP / Health Points）：表示敌人还"活不活着"。例如野怪初始 100 HP，被打中 -25，HP 降到 0 就死亡。
• 死亡动画（Death Animation）：敌人死亡时的视觉效果。本项目要求：向上漂 3 米 + 放大到 3 倍 + 逐渐透明消失。
• 淡出效果（Fade Out）：物体透明度从 1（完全不透明）渐变到 0（完全透明），实现"慢慢消失"的效果。
• 动态准心（Dynamic Crosshair）：屏幕中心的瞄准标记。颜色会根据瞄到什么而变化——瞄到空地是白色，瞄到敌人变红色，给玩家即时反馈。
• UI 层级（UI Hierarchy / Z-Order）：界面元素的前后关系。准心应该在所有 3D 场景之上（最靠前），不会被墙或敌人挡住。

第 08 步 扣血动画

😜 【核心逻辑】野怪头顶的血条优化，让玩家对击中产生更强的渴望。【交互操作】射击击中野怪的情况【交互结果】血条进行缓动减少【UI提示】血条做三个优化：

1. 血条外层加上一个圆边的边框；
2. 无论多远距离都要显示血条，目前如果离得比较远血条会消失；
3. 血条击中的时候产生的减少动画是缓动的，目前是瞬间变化的；
4. 血条从绿到红的过程，其中绿色和红色不用采用标准的0,255,0和255,0,0，参考魔兽争霸中血条的颜色为准；
5. 5、扣血后，丢失的那一段立刻变暗色，然后从右往左缩到 0，形成 "伤害残影" 拖尾效果。

• 血条（Health Bar / HP Bar）：显示敌人当前生命值百分比的条形 UI，通常绿色→黄色→红色表示生命值减少。
• 缓动减少（Tween Decrement / Animated Decrement）：血条不是"被扣了 25 血就瞬间变短 25%"，而是用一小段时间（如 0.3 秒）平滑缩短，给玩家一个"血在慢慢掉"的视觉反馈。
• 圆边边框（Rounded Border / Border Radius）：血条外框的四个角是圆角而不是尖角，视觉上更圆润美观。
• 始终可见血条（Always-Visible / Distance-Culled）：有些引擎在物体太远时会自动隐藏小物体以提升性能，包括血条。需要强制血条无论多远都显示。
• 魔兽争霸（Warcraft）血条颜色：不是标准的纯绿(0,255,0) 到纯红(255,0,0)，而是更柔和的配色方案——绿是偏暗的森林绿，红是偏橙的砖红。整体看更协调。
• 颜色插值（Color Interpolation）：从 HP=100% 到 HP=0%，颜色不是"要么绿要么红"，而是在绿色和红色之间平滑过渡。中间血量会显示黄色/橙色。
• 伤害残影（Damage Ghost / Damage Afterimage）：扣血后，被扣掉的那一段不立即消失，而是变成深色，然后慢慢缩回 0。这样玩家能直观看到"这一枪扣了多少血"。常见于《魔兽世界》等 MMORPG。
• 从右往左缩：血条通常从左到右表示生命值。扣血时当前血量从右边界开始向左收缩。"伤害残影"是指被扣掉的那一段（在右边）先变暗，然后自己再缩回去。

第 09 步 碰撞系统

😜 【核心逻辑】实现兼顾碰撞检测效率与野怪集群视觉效果优化的系统。在保证碰撞检测性能的同时，解决因野怪过度集中而产生的视觉重叠与混乱问题，确保游戏场景的视觉清晰度与运行流畅性。

【交互操作】当野怪处于自主移动状态（包括但不限于巡逻、追击、撤退等行为模式）时，实时监测并处理其与其他野怪及环境物体的碰撞关系。

【交互结果】为每个野怪实体构建精确的AABB（轴对齐 bounding box）碰撞体积，确保在野怪移动过程中发生碰撞时，能够实时、准确地检测碰撞事件并执行分离处理，严格保证野怪实体之间及与环境之间无几何穿插现象。实现高效的碰撞响应机制，使野怪在碰撞后能够平滑调整移动路径或位置，维持自然的运动状态与合理的空间分布。

• 碰撞检测（Collision Detection）：判断两个物体是否重叠的计算。游戏里每帧都要检测"野怪是否撞墙了"、"野怪之间是否叠在一起了"。
• AABB（Axis-Aligned Bounding Box / 轴对齐包围盒）：最简单高效的碰撞体积类型。用一个不旋转的矩形盒子包住物体，检测两个盒子是否相交。计算极快，适合性能敏感的游戏。
• Bounding Box（包围盒）：包住一个物体的最小盒子。"包围"的意思就是把物体整个装进去。
• 轴对齐（Axis-Aligned）：盒子的边始终与世界坐标系的 X/Y/Z 轴平行，不会旋转。优点是计算快，缺点是斜着放的物体包围盒会偏大。
• 实时检测：每帧（每秒 60 次）都检查一次碰撞状态。
• 分离处理（Separation / Push Out）：检测到两个野怪重叠后，把它们各自向反方向推开一点点，直到不再重叠。这个"推"的力要平滑，不能把野怪弹飞。
• 野怪集群（Enemy Clustering）：多个野怪挤在一起的情况。如果没有碰撞系统，它们会全部叠在一起变成一个"大肉球"，看起来非常混乱。
• 碰撞响应（Collision Response）：碰撞发生后的处理方式。可以是：停止移动、被推开、改变方向、弹跳等。本项目要求平滑调整位置。
• 几何穿插（Geometry Interpenetration / Z-Fighting）：两个物体重叠时视觉上看起来"穿模了"，这是不允许的。碰撞系统要保证任何两个实体之间至少有最小间距。
• 性能（Performance）：系统运行速度。好的碰撞系统每帧只用很少的计算时间，不影响游戏帧率。

第 10 步 后座系统

😜 【核心逻辑】为增强游戏真实感，需为武器系统实现符合物理特性的后座力机制。后座力表现应包含视角偏移与武器动画两部分，遵循真实枪械力学原理。

【交互触发条件】当玩家同时满足以下条件时触发开枪后座力效果：

1. 玩家已装备武器且武器处于可射击状态
2. 鼠标左键处于完全按下状态
3. 武器当前弹匣内剩余子弹数量大于0
4. 玩家未处于其他动作的硬直状态（如换弹、近战攻击等）

【交互执行流程】

1. 开枪瞬间（0-0.1秒）：
   • 立即执行视角向上偏移，偏移角度范围为[minrecoilangle,{max_recoil_angle}]（根据武器类型配置）
   • 播放武器开火动画（包含枪口火光、弹壳抛出等细节）
   • 播放武器开火音效
2. 后座力恢复阶段（0.1-1.0秒）：
   • 采用渐进式平滑恢复算法（建议使用缓动函数easeOutQuart）使视角从偏移位置回归至初始位置
   • 恢复过程中玩家视角输入部分失效，仅保留部分垂直/水平控制权限（根据游戏设计需求调整）
   • 同步播放武器后座恢复动画，与视角恢复过程保持时间同步

【技术参数要求】

1. 总时长控制：从开枪触发到完全恢复控制的总时间严格控制在1.0秒以内
2. 视角偏移：初始偏移速度快（0.1秒内完成最大偏移），恢复过程平滑减速
3. 动画同步：武器动画帧率不低于30fps，与视角运动曲线保持时间轴同步
4. 性能优化：后座力计算每帧耗时不超过1ms，避免影响游戏帧率

【质量验收标准】

1. 视觉表现：后座力效果自然流畅，无明显卡顿或跳变
2. 操作感受：恢复过程中的视角过渡平滑，不会引起玩家眩晕
3. 一致性：多次连续射击时，后座力表现保持一致的物理特性
4. 兼容性：在不同分辨率和帧率设置下均能保持相同的后座力表现效果

• 后座力（Recoil / Kick）：开枪时枪向后坐的力，在 FPS 游戏中通常表现为视角轻微上移 + 武器上跳。给玩家"枪在开"的感觉。
• 视角偏移（View Offset）：相机暂时偏离原来的朝向。开枪的瞬间视角向上偏 1-3 度。
• 硬直状态（Stun / Locked State）：角色正在执行某个动作时，其他动作被暂时禁止。例如换弹期间不能开枪。
• 缓动函数（Easing Function）：一组数学函数，定义"从 A 到 B 的过程是快还是慢"。常见的有线性（匀速）、easeOut（先快后慢）、easeInOut（两头慢中间快）。
• easeOutQuart：一种具体的缓动函数。变化值 = 1 - (1-t)^4。特点是开始很快，越接近目标越慢，非常适合"回复到原位"这类效果。
• 渐进式平滑恢复：不是瞬间跳回原位，而是一点点地回到初始方向。越接近初始位置恢复速度越慢。
• 枪口火光（Muzzle Flash）：开枪瞬间枪口喷出的火花，通常是一张半透明的贴图快速闪现。
• 弹壳抛出（Shell Ejection）：开火时从枪身侧面抛出的弹壳，通常用一个简单的物理模拟实现。
• 输入部分失效（Input Suppression）：后座过程中玩家输入被部分忽略，模拟"枪在跳动时你没法精准瞄准"。例如垂直方向输入只有 30% 生效。
• 运动曲线（Motion Curve）：随时间变化的函数曲线，描述视角在整个后座过程中的角度变化。用于保证武器动画和视角变化同步。
• 每帧耗时不超过1ms：1 毫秒 = 0.001 秒。对于 60fps（每帧 16ms）的游戏，留给后座力计算的时间只有总预算的 1/16，要求计算非常轻量。

第 11 步 野怪受击

😜 【核心逻辑】增强野怪受击后的反馈机制，实现多维度同步的受击表现效果

【交互触发条件】当野怪受到玩家攻击或子弹命中时，立即触发受击反馈

【交互执行细节】

1. 运动状态处理：在野怪当前跳跃阶段（上升期/最高点/下降期）立即产生0.3秒的滞空顿帧效果，暂停原有运动轨迹
2. 姿态变化：
   • 身体向子弹来向倾斜30-45度（角度可根据攻击强度微调）
   • 头部执行猛烈向后甩动的动画，甩动幅度需明显可见
3. 特效表现：
   • 受击部位生成中型蓝色血雾特效，粒子数量控制在8-12个
   • 同步产生少量飞溅的蓝色血迹效果，血迹飞行轨迹应符合物理规律
4. 角色视觉反馈：
   • 野怪模型闪红0.2秒，红色透明度从100%渐变至0%
   • 模型产生轻微形变：X轴方向压扁10%，Y轴方向拉伸10%，形变效果在顿帧期间保持，顿帧结束后平滑恢复
5. 摄像机效果：触发轻微震动，震动幅度为0.2单位，持续时间0.15秒，震动曲线前强后弱

【执行时间要求】整个受击反馈效果总持续时间严格控制为0.3秒，各子效果需在此时间范围内完成并同步结束

【技术要求】所有效果需保证同步触发，无明显延迟或不同步现象，在不同帧率下均能保持一致的视觉表现和时间节奏

• 滞空顿帧（Hit Stop / Hit Pause）：被击中的瞬间，整个野怪短暂暂停 0.2-0.3 秒，让玩家清晰地看到"打中了"。常见于动作游戏，增强打击感。
• 子弹来向（Bullet Incoming Direction）：子弹打中的方向。野怪会向这个方向倾斜一下，模拟被击中后的冲击力。
• 粒子特效（Particle Effect）：用大量小粒子（小圆点/小方块）模拟的效果。血雾、火花、烟雾、爆炸等都是粒子效果。
• 粒子数量（Particle Count）：一次效果中生成多少个粒子。数量越多效果越华丽，但性能开销越大。
• 血迹效果（Blood Splatter / Decal）：被击中时飞溅出来的液体/碎片效果，通常也用粒子或贴花实现。
• 闪红（Flash Red / Damage Flash）：被打中瞬间，模型在短时间内变成红色然后恢复。最经典的受击提示效果之一。
• 透明度渐变（Alpha Fade）：红色的"可见程度"从 100%（完全红色）逐渐降到 0%（恢复原状），而不是瞬间切换。
• 模型形变（Mesh Deformation）：不改变模型形状，只改变整体的缩放比例。X 轴压扁 = 左右变瘦，Y 轴拉伸 = 上下变长。
• 摄像机震动（Camera Shake / Screen Shake）：相机在随机小范围内抖动，给玩家"有力量击中"的冲击感。
• 震动幅度（Shake Magnitude）：相机偏离原位置的最大距离，例如 0.2 单位。
• 震动曲线（Shake Curve）：强度随时间的变化，要求"前强后弱"——刚开始震得厉害，快结束时越来越弱。
• 同步触发（Synchronized Triggering）：闪红、震动、血雾、倾斜、顿帧必须在"被判定击中"的同一帧内全部启动，不能一个先一个后。

第 12 步 击杀逻辑

😜 【交互操作规范】实现鼠标左键点击触发开枪功能，当成功击杀野怪后执行以下UI反馈机制：

【视觉反馈要求】在屏幕中下方区域显示击杀图标，具体实现需满足：

1. 图标显示时机：野怪死亡判定完成后500ms内弹出
2. 显示时长控制：图标弹出后持续显示1500ms，随后自动消失
3. 动画效果规范：参考《穿越火线》(CF)游戏中的击杀提示效果，实现包含但不限于淡入、缩放等弹出动效
4. 视觉资源要求：使用指定的击杀图标图片资源，确保在不同分辨率下清晰显示

【技术实现要点】

• 建立鼠标左键点击事件与开枪动作的绑定机制
• 实现野怪死亡状态检测与击杀判定逻辑
• 开发图标显示/隐藏的时间控制模块，精确控制500ms弹出延迟和1500ms显示时长
• 集成动画系统实现流畅的弹出动效，确保动画过渡自然不卡顿
• 确保UI元素层级正确，击杀图标应显示在游戏场景之上但不遮挡关键游戏信息

【质量验收标准】

• 交互响应延迟：从鼠标左键点击到开枪动作触发的延迟不超过100ms
• 图标显示准确性：100%的野怪击杀事件能正确触发图标显示
• 时间精度：弹出延迟误差不超过±50ms，显示时长误差不超过±100ms
• 动画流畅度：在目标硬件配置下，动效播放帧率保持在60FPS以上，无掉帧现象

• 击杀图标（Kill Icon / Kill Feed）：成功击杀敌人后在屏幕上显示的图标/提示。常见位置是屏幕下方或右上角。
• 弹出延迟（Popup Delay）：从"敌人死亡"到"图标出现"的时间间隔。500ms 是给玩家一个反应时间。
• 穿越火线（CrossFire / CF）：一款广受欢迎的 FPS 游戏，其击杀提示以"小图标快速弹出"著称。
• 淡入效果（Fade In）：图标从透明度 0（完全不可见）逐渐变为 1（完全可见），而不是瞬间出现。
• 缩放动效（Scale Animation）：图标从小变大（或从大变小再稳定），典型值是从 0 倍缩放到 1.0 倍。
• UI 层级（UI Layer / Z-Order）：击杀图标应该显示在：1. 3D 场景之上（不能被敌人挡住）；2. 血条、准心之下（不要遮挡关键战斗信息）。
• 时间控制模块（Timer Module）：精确控制"什么时间做什么"的代码组件。需要精确到毫秒级。
• 击杀判定（Kill Confirmation）：判断敌人"确实死了"的逻辑。通常是 HP 降到 0 且死亡动画开始播放。
• 掉帧（Frame Drop）：动画过程中帧率突然下降，导致画面卡顿。动画系统要足够高效，避免掉帧。
• 分辨率适配（Resolution Adaptation）：游戏在 1080p、2K、4K 等不同分辨率下运行，图标应该始终清晰且大小适中。

第 13 步 换弹逻辑

😜 【核心逻辑】实现枪械子弹有限机制及换弹系统，确保子弹数量真实消耗并通过换弹操作补充，杜绝无限子弹情况。

【交互操作】玩家通过按下键盘上的"R"键触发换弹功能，需确保按键检测准确且响应及时，避免误触或无响应情况。

【交互结果】换弹操作触发后立即播放换弹动画，动画序列需完整执行，动画结束后根据枪械类型和弹夹容量正确增加可使用的子弹数量，确保数值更新准确无误。

【UI提示1】在游戏界面下方设计并实现子弹状态显示UI，清晰展示当前可使用子弹数量（当前弹夹子弹）和总子弹数量（剩余备用子弹），数值需实时更新且显示清晰。

【UI提示2】当可使用子弹数量低于枪械总弹夹容量的30%时，在子弹数量显示区域下方触发红色闪烁提示文字"按 R 换弹"，闪烁频率设置为1次/秒，提示文字需醒目但不影响游戏体验。

【总时间】换弹动画总时长严格控制在500ms，确保动画流畅且不影响游戏节奏，时间分配需合理，包括抬枪、停留和恢复原位等各阶段。

【动画】参考《穿越火线》(CF)游戏的换弹操作设计动画效果，具体包括：枪械向上抬起15-20度，保持该姿态150ms，然后平滑恢复到原始位置。整个动画过程需应用缓动函数（建议使用ease-in-out），确保动作自然流畅，无卡顿或生硬过渡。

第 14 步 角色受击

😜 【核心逻辑】实现野怪与玩家的战斗交互系统，具体功能如下：

1. 野怪接近判定：当野怪与玩家的距离小于预设攻击范围时，触发野怪攻击行为
2. 攻击动作系统：野怪执行攻击动画，同时对玩家造成伤害
3. 玩家受伤反馈：
   • 生命值扣除：根据野怪攻击力计算并扣除玩家生命值
   • 血屏特效：实现围绕屏幕四周的红色渐变特效，其透明度和覆盖范围随剩余生命值减少而增加（生命值越低，血屏效果越厚重），并添加0.5秒间隔的闪烁动画
   • 屏幕抖动：玩家被攻击时触发持续0.3秒的屏幕震动效果，震动幅度为X轴±3像素，Y轴±3像素
   • 音效系统：为攻击动作和受伤效果添加对应的音效资源
4. 死亡与重生机制：
   • 当玩家生命值降至0时，触发死亡状态，禁止玩家所有操作输入
   • 显示"重新开始"按钮（尺寸150×50像素，居中显示，白色文字，红色背景）
   • 点击按钮后执行重生流程：将玩家传送至预设出生点，重置生命值为最大值，恢复玩家操作权限，清除血屏特效 【UI提示】实现玩家血条的视觉反馈系统：
5. 血条显示：在屏幕指定位置（建议左上角）显示玩家当前生命值与最大生命值的比例条
6. 扣血动画：当玩家受到伤害时，血条采用缓动效果（建议使用easeOutQuad缓动函数，持续时间0.5秒）从当前值平滑过渡到新的生命值，而非瞬间变化
7. 视觉一致性：确保玩家血条的缓动效果与野怪血条的缓动效果保持视觉风格统一

• 弹夹容量（Magazine Capacity / Clip Size）：一个弹夹能装的子弹数，例如 AK-47 是 30 发。打完后需要换弹。
• 当前弹夹子弹（Current Ammo）：已经上好膛、可以直接发射的子弹数。
• 备用子弹（Reserve Ammo）：身上带的还没装进去的子弹总数。换弹时从这里扣除。
• 实时更新（Real-time Update）：每开一枪，UI 上的数字立刻减 1，不能有延迟。
• 红色闪烁提示（Blinking Red Prompt）：子弹快打完时的警告文字。闪烁 1 次/秒 = 亮 0.5 秒，灭 0.5 秒。
• 换弹动画总时长 500ms：从按下 R 键到可以再次射击的总时间是 0.5 秒。
• 动画序列（Animation Sequence）：换弹由几个动作组成：抬枪 → 保持（装弹期间）→ 恢复原位。
• 抬枪角度：武器向上翘起，模拟"抽出旧弹夹"的动作。
• ease-in-out 缓动函数：开始和结束都慢，中间快。模拟真实动作的"启动-加速-停止"节奏。
• 无限子弹（Infinite Ammo）：子弹不会减少。开发阶段可能使用此模式调试，但正式游戏必须禁用。

第 15 步 医疗系统

😜 【核心逻辑】在游戏地图内随机生成医疗包资源，需满足以下条件：

1. 生成位置需避开地图边界、障碍物及不可到达区域

2. 刷新频率设置为低频模式，建议间隔时间不低于60秒

3. 同时在地图上存在的医疗包数量限制为1个，新医疗包生成前需确保旧医疗包已被拾取或超过存在时间（建议存在时间设为300秒） 【交互操作】实现医疗包交互系统：

4. 当玩家角色与医疗包的距离小于等于2米时，触发交互提示（建议显示"按E键使用医疗包"文字提示）

5. 玩家按住键盘E键开始交互进度条，松开E键则中断交互

6. 交互过程中实时显示进度条UI，进度条样式采用线性填充方式 【交互结果】医疗包使用效果：

7. 交互进度条完成后，为玩家恢复当前最大生命值的30%

8. 生命值恢复时播放视觉特效和音效反馈

9. 医疗包使用后立即从地图中移除 【交互中断机制】实现以下交互中断条件：

10. 交互进度条总时长严格控制为2秒

11. 玩家角色移动超过交互有效范围（>2米）时立即中断进度条

12. 玩家受到任何伤害时立即中断进度条

13. 中断后进度条重置为0，需重新开始交互 【技术要求】

14. 医疗包生成位置需通过随机算法实现，并进行碰撞检测验证

15. 交互距离判定使用角色碰撞体中心点与医疗包碰撞体中心点的直线距离计算

16. 进度条需使用平滑的线性动画，精确到0.1秒级显示

17. 生命值恢复需进行边界检查，确保不会超过最大生命值上限

• 攻击范围（Attack Range）：野怪能打到玩家的最大距离。玩家进入这个范围，野怪就会开始攻击。
• 血屏特效（Blood Screen / Vignette）：屏幕四周出现红色半透明渐变效果，模拟"视野里有血"的感觉，给玩家危险警告。
• 透明度与生命值关联：HP 越高血屏越不明显；HP 很低时整个屏幕几乎被红色覆盖。用这种方式给玩家直观的血量感知。
• 闪烁动画（Blinking Animation）：血屏效果不是始终稳定显示，而是"亮一下暗一下"周期性变化，增加紧张感。
• 屏幕震动幅度：相机偏移的距离。±3 像素 = 最多在任意方向偏移 3 像素。
• 死亡状态（Dead State）：HP=0 后玩家不能再移动、不能开枪，只能看结算界面。
• 重生流程（Respawn / Revive）：死亡后重新开始的流程，包括重置位置、重置 HP、清除负面效果。
• 出生点（Spawn Point）：玩家每次开始或重生时出现的位置。
• easeOutQuad 缓动函数：缓动公式是 t²（加速开始，减速结束）。特点是开始变化快，越接近目标越慢，适合"血量掉下来"的感觉。
• 视觉一致性（Visual Consistency）：玩家血条和野怪血条使用相同的动画风格（都是缓动减少），让玩家感觉这是同一个游戏世界。

第 16 步 游戏目标

😜 【核心逻辑】移除游戏右侧现有未实现的目标系统相关的所有逻辑代码与界面元素，包括但不限于相关的变量定义、函数调用、事件监听及UI组件。同时，设计并实现一个全新的游戏目标系统，该系统应具备完整的目标管理、进度跟踪及通关判定功能。

【UI实现】开发一个全新的游戏目标面板UI，具体要求如下：

1. 面板布局：设计清晰直观的界面布局，包含目标标题区域、描述区域、进度展示区域及状态指示区域
2. 目标描述：在面板中清晰显示当前目标文本："消灭指定数量的敌人"
3. 进度跟踪：
   • 数字显示：以"当前击杀数 / 目标击杀数"的格式实时展示进度
   • 进度条：实现类似玩家血条样式的可视化进度条，精确反映完成百分比
   • 实时更新：确保在玩家击杀敌人后，进度数字和进度条能立即同步刷新
4. 通关反馈：当目标完成（当前击杀数达到目标击杀数）时，立即触发通关判定，并播放一个高质量、视觉冲击力强的粒子特效作为奖励，特效应覆盖主要游戏区域，持续时间不少于2秒

【功能要求】

1. 目标系统核心功能：
   • 目标配置：支持设置不同关卡的目标击杀数量
   • 进度计算：实时统计玩家击杀敌人数量并与目标数量对比
   • 通关判定：当击杀数量达到目标数量时，触发通关逻辑
2. 事件系统：
   • 实现敌人击杀事件监听机制
   • 建立UI更新事件，确保数据变更能及时反映到界面
3. 性能优化：确保粒子特效播放时不影响游戏帧率，优化UI渲染性能

【技术实现要点】

1. 代码结构：模块化设计目标系统，分离数据逻辑与UI展示
2. 数据管理：使用合适的数据结构存储目标信息和当前进度
3. 视觉效果：确保粒子特效具有足够的视觉表现力，可考虑使用粒子系统实现多种效果组合

【测试要求】

1. 验证目标系统在不同目标数量下的进度计算准确性
2. 测试UI更新的实时性和流畅度
3. 确保粒子特效在各种设备配置下都能正常播放
4. 验证通关逻辑在目标达成时能正确触发

• 医疗包（Medkit / Health Pack）：可以恢复玩家生命值的道具，通常在地图上随机出现。
• 随机生成（Random Spawn）：在地图合法区域内随机选一个点生成医疗包，不能每次都在同一个位置。
• 刷新频率（Spawn Frequency / Respawn Timer）：多久生成一个新的。低频 = 60 秒以上，不频繁。
• 存在时间（Lifespan / Time-to-Live）：医疗包在地图上存在多久后会自动消失。300 秒 = 5 分钟。
• 交互提示（Interaction Prompt）：玩家走近物体时屏幕上出现的文字提示，告诉玩家"可以按某个键使用它"。
• 按住 E 键交互（Hold-to-Use）：不是按一下就生效，而是必须按住一段时间（按住 2 秒）。这样可以防止误触，也让"使用医疗包"在战斗中有风险。
• 进度条 UI（Progress Bar）：显示交互进度的条状图形，从 0% 填到 100%。
• 线性填充（Linear Fill）：进度条匀速增长，不是先快后慢或先慢后快。
• 交互中断（Interaction Interruption）：交互过程中发生某些事件（走开、受伤）时进度条被取消，必须重新开始。
• 碰撞检测验证（Collision Validation）：随机选了一个位置后，检查那里是否被墙/障碍物挡住了，如果是就重新选。
• 边界检查（Boundary Check / Clamping）：恢复 HP 时确认结果不能超过最大 HP。例如 HP 90，恢复 30，结果应该是 100 而不是 120。
• 最大生命值的 30%：按比例恢复而不是固定值。例如最大 HP 100，恢复 30；最大 HP 200，恢复 60。

第 17 步 关卡系统

😜 【核心逻辑】设计并实现一个包含四个关卡的渐进式关卡系统，具体要求如下：

1. 关卡配置系统：为每个关卡创建独立的配置文件，精确记录以下参数：
   • 地图场景标识
   • 地图尺寸参数（宽度×高度）
   • 障碍物类型、位置及碰撞属性
   • 野怪移动速度（随关卡递增）
   • 野怪攻击力数值（随关卡递增）
   • 野怪生命值设定（随关卡递增）
   • 明确的通关目标条件（如：消灭所有敌人、到达指定位置、存活指定时间等）
2. 难度曲线设计：确保从第一关到第四关难度呈线性递增，通过合理调整野怪属性、障碍物密度和通关条件实现难度梯度。
3. 关卡视觉系统：
   • 为四个关卡分别设计独特的视觉风格，基于现有纹理资源(floor-metal.jpg、wall-metal.jpg、skybox-space.jpg)进行色调调整
   • 第一关：蓝色调（保持现有配置）
   • 第二关：紫色调
   • 第三关：金色调
   • 第四关：红色调
   • 确保色调调整保持纹理细节和清晰度，同时营造明显的关卡区分度

【UI实现】在游戏界面右上角位置设计并实现关卡信息展示组件，具体要求：

• 清晰显示当前关卡编号（如："关卡 1/4"）
• 采用与当前关卡色调相协调的视觉风格
• 确保UI元素不遮挡游戏关键区域，具有良好的视觉层级
• 实现关卡切换时的平滑过渡动画效果

• 目标系统（Objective System）：定义和跟踪游戏目标（例如"消灭 10 个敌人"、"存活 2 分钟"）的完整系统。
• 目标面板 UI（Objective Panel）：显示当前目标的界面，通常在屏幕上方或右侧。
• 进度跟踪（Progress Tracking）：实时记录"完成了多少"与"目标是多少"。
• 击杀数（Kill Count）：玩家成功击杀的敌人数量。
• 完成百分比（Completion Percentage）：(当前击杀数 / 目标击杀数) × 100%。
• 通关判定（Level Completion / Win Condition）：判断游戏目标是否达成的逻辑。
• 事件监听机制（Event Listener / Observer Pattern）：一种程序设计模式。当"敌人被击杀"这件事发生时，所有关心这件事的系统（目标系统、UI、音效）都会收到通知并自动更新。
• 模块化设计（Modular Design）：把代码拆分成独立的模块，每个模块只负责一件事。目标系统应该是一个独立模块，不直接和战斗系统耦合。
• 数据结构（Data Structure）：如何组织和存储数据。例如可以用一个对象 { current: 5, target: 10 } 来存储进度。
• 粒子系统（Particle System）：用于创建大量小粒子（火花、烟雾、彩纸等）的特效系统。通关特效通常会用大量粒子来制造庆祝感。
• 性能优化（Performance Optimization）：确保特效和 UI 更新不会占用太多 CPU/GPU，保持游戏流畅运行。
• 移除未实现代码（Remove Stub Code）：删除之前写了占位符但没实际功能的代码，避免混乱。
• UI 渲染性能（UI Render Performance）：UI 元素重新绘制所需时间。好的设计只在数据变化时重绘，而不是每帧都重绘。