简介这份资源是面向Unity3D初学者与进阶开发者的完整FPS游戏源码工程聚焦第一人称射击游戏的核心实现帮助读者通过可运行项目理解场景构建、角色控制器、射击机制、网络同步、AI寻路、UI与音频管理等关键技术点适合希望从零搭建或拆解联机FPS项目的开发者对照学习。压缩包为rar格式共1609个文件约38.91MB以bin、info等工程与缓存文件为主辅以meta、asset、prefab、mat等Unity资源文件以及dll、cs脚本和sln、csproj工程配置完整保留了项目结构与依赖关系。目前已有2410人学习下载。源码覆盖CharacterController移动、射线检测命中、NavMesh敌人路径规划与UNet/Mirror网络同步等模块读者可据此梳理FPS项目的目录组织与组件协作方式并借鉴性能优化与资源管理思路作为实践参考。1. 从一份能跑起来的 FPS 工程说起它到底解决了什么拿到一个 FPS 方向的 Unity3D 完整工程最怕的不是代码多而是打开之后场景跑不起来、输入没反应、打包出来黑屏。这份 Untiy3D_FPS 下载完整版的价值就在这儿它不是零散的脚本片段而是一套把玩家控制器、武器射击、敌人 AI、UI 与场景管理串起来的可运行工程适合想快速摸清 FPS 项目骨架的从业者也适合刚学完 Unity 基础、想找一个能拆能改的实战底子的人。你拿到手之后真正要做的不是从头抄一遍而是先把它跑通再按模块拆开看每个系统怎么协作最后替换成自己的美术与数值。下面按「先立住原理、再动手复现、最后避坑」的顺序往下走每一步都落到具体操作。2. 工程结构与运行链路先搞清楚谁在驱动谁2.1 目录分层与脚本职责划分一个能长期改的 FPS 工程目录结构基本决定了后期维护成本。常见做法是按功能域分而不是按文件类型分。打开工程后先看 Assets 下的分层合格的工程一般长这样目录职责改动频率Scripts/Player移动、视角、跳跃、生命值中Scripts/Weapon射击、换弹、后坐力、弹道高Scripts/AI敌人状态机、寻路、感知中Scripts/UIHUD、准星、血条、计分低Prefabs玩家、武器、敌人、特效预制体高Scenes主菜单、关卡、测试场景低如果工程是按 Models、Materials、Scripts 这种纯类型平铺的说明作者更偏素材展示而非工程化改起来会累。判断标准很简单随便挑一个功能比如「开火」你能不能在三层目录内找到从输入到伤害结算的完整链路。找不到就说明耦合重后面加新武器会翻车。脚本职责上玩家控制器一般拆成移动和视角两块移动负责 CharacterController 或 Rigidbody 的位移视角负责相机旋转与俯仰角钳制。武器系统拆成武器基类、具体武器实现、弹药管理三部分。敌人 AI 用状态机最稳Idle、Patrol、Chase、Attack 四个状态足够覆盖大多数关卡需求。这套拆分不是玄学是为了让你改一个模块时不牵动其他模块。2.2 从输入到伤害结算的完整调用链把「按下鼠标左键 → 敌人掉血」这条链走一遍你就摸清了工程的骨架。典型调用顺序是输入系统读取开火信号武器脚本判断弹药与冷却执行射线检测或发射弹丸命中后调用目标身上的伤害接口目标扣血并触发死亡逻辑UI 订阅事件刷新数值。// 武器开火核心逻辑挂在武器预制体上 public class WeaponFire : MonoBehaviour { public float fireRate 0.1f; // 射击间隔秒 public int damage 25; // 单发伤害 public float range 100f; // 射线最大距离 public LayerMask hitMask; // 可命中层排除玩家自身 private float nextFireTime 0f; void Update() { // 按住左键连续射击用时间戳控制射速 if (Input.GetButton(Fire1) Time.time nextFireTime) { nextFireTime Time.time fireRate; Fire(); } } void Fire() { Ray ray new Ray(Camera.main.transform.position, Camera.main.transform.forward); if (Physics.Raycast(ray, out RaycastHit hit, range, hitMask)) { // 通过接口解耦命中对象自己决定怎么扣血 IDamageable target hit.collider.GetComponentIDamageable(); target?.TakeDamage(damage); } } }这段代码的关键在三个参数fireRate 决定武器手感0.1 秒对应每分钟 600 发改到 0.15 就是 400 发手感差异很明显range 要和关卡尺寸匹配室内图 50 米够用室外图给到 200 米hitMask 必须排除玩家自身层否则射线第一帧就打到自己表现为「开枪没反应但弹药在掉」。接口 IDamageable 是解耦的核心敌人、可破坏箱子、Boss 都实现同一个接口武器不需要知道打的是谁。调用链跑通之后再加新武器就是复制预制体、换模型、调参数不用动核心逻辑。这也是判断工程质量的第二个标准加一把枪需不需要改已有脚本。2.3 场景加载与游戏状态管理FPS 工程一般至少有三个场景主菜单、关卡、结算。场景切换如果直接 SceneManager.LoadScene 硬切会出现加载卡顿和状态残留。常见做法是加一个 GameManager 单例做常驻用协程异步加载并在加载期间显示进度条。// 异步加载关卡避免切换时卡帧 public IEnumerator LoadLevelAsync(string sceneName) { AsyncOperation op SceneManager.LoadSceneAsync(sceneName); op.allowSceneActivation false; // 先不激活等进度条走完 while (op.progress 0.9f) { slider.value op.progress; // 0 到 0.9 是真实加载进度 yield return null; } slider.value 1f; op.allowSceneActivation true; // 手动放行 }注意 op.progress 到 0.9 就停了这是 Unity 的既定行为最后 0.1 是激活阶段所以进度条要手动补到 1。allowSceneActivation 设为 false 期间场景不会切换适合做「点击继续」的交互。GameManager 用 DontDestroyOnLoad 常驻保存玩家分数、当前关卡、设置项切场景时不会丢。这套结构不复杂但少了它后期加暂停、加存档会非常别扭。3. 玩家控制器与武器系统手感是怎么调出来的3.1 移动与视角的参数标定FPS 手感的第一层是移动。CharacterController 比 Rigidbody 更适合做角色移动因为它不受物理力干扰斜坡和台阶处理更稳。核心参数有四个移动速度、跳跃高度、重力、鼠标灵敏度。public class PlayerMove : MonoBehaviour { public float moveSpeed 5f; // 常规移动速度米/秒 public float sprintSpeed 8f; // 冲刺速度 public float jumpHeight 1.2f; // 跳跃高度米 public float gravity -20f; // 重力加速度比真实值大更跟手 public float mouseSensitivity 2f; // 鼠标灵敏度 private CharacterController cc; private Vector3 velocity; private float pitch 0f; void Start() { cc GetComponentCharacterController(); } void Update() { // 视角水平旋转角色垂直旋转相机并钳制俯仰角 float mx Input.GetAxis(Mouse X) * mouseSensitivity; float my Input.GetAxis(Mouse Y) * mouseSensitivity; transform.Rotate(Vector3.up * mx); pitch Mathf.Clamp(pitch - my, -80f, 80f); Camera.main.transform.localEulerAngles new Vector3(pitch, 0, 0); // 移动基于角色朝向计算方向 float h Input.GetAxis(Horizontal); float v Input.GetAxis(Vertical); Vector3 dir transform.right * h transform.forward * v; float speed Input.GetKey(KeyCode.LeftShift) ? sprintSpeed : moveSpeed; cc.Move(dir.normalized * speed * Time.deltaTime); // 重力与落地检测 if (cc.isGrounded velocity.y 0) velocity.y -2f; velocity.y gravity * Time.deltaTime; cc.Move(velocity * Time.deltaTime); } }参数标定的血泪经验重力给 -20 而不是 -9.8是因为真实重力下跳跃像在月球落地拖沓俯仰角钳制在 ±80 度而不是 ±90是为了避免相机翻转导致视角倒置鼠标灵敏度 2 是中等值配合 Input.GetAxis 的原始输入如果工程用的是新输入系统数值要重新标。移动速度 5 米/秒接近真实快走冲刺 8 米/秒有明显加速感但不至于失控。这些数值没有绝对标准但偏离太多手感一定怪。3.2 射击、换弹与后坐力的实现要点射击系统在上面调用链里已经给了核心这里补换弹和后坐力。换弹的本质是状态锁换弹期间禁止开火播放动画动画结束回满弹药。后坐力分两种视觉后坐力相机上抬和弹道后坐力射线方向偏移前者影响手感后者影响命中。// 换弹状态机用协程控制时序 public IEnumerator Reload() { isReloading true; animator.SetTrigger(Reload); // 触发换弹动画 yield return new WaitForSeconds(1.5f); // 与动画时长对齐 currentAmmo magazineSize; // 回满弹匣 isReloading false; } // 开火时叠加视觉后坐力 void ApplyRecoil() { pitch - recoilKick; // 相机上抬 pitch Mathf.Clamp(pitch, -80f, 80f); // 弹道偏移在射线上加一个随机角度 Vector3 spread Random.insideUnitCircle * spreadRadius; Vector3 dir Camera.main.transform.forward Camera.main.transform.right * spread.x Camera.main.transform.up * spread.y; Physics.Raycast(Camera.main.transform.position, dir, out RaycastHit hit, range, hitMask); }换弹等待时间必须和动画时长对齐差 0.2 秒玩家就能感觉到「动画没完子弹就满了」或者「动画完了还在等」。recoilKick 一般给 1 到 2 度每发叠加停火后缓慢回正这个回正逻辑要单独写否则视角会一直往上飘。spreadRadius 控制散布步枪给 0.01 到 0.02霰弹枪给 0.1 以上。这些参数在工程里通常暴露在 Inspector 上方便边跑边调这也是完整工程比脚本片段好用的地方——参数是可视的改完立刻能试。3.3 武器数据配置与扩展方式武器多了之后把参数写死在脚本里就是灾难。常见做法是用 ScriptableObject 做武器数据资产每把枪一个 .asset 文件存伤害、射速、弹匣、模型引用、音效。武器脚本只读数据不存数值。[CreateAssetMenu(fileName WeaponData, menuName FPS/WeaponData)] public class WeaponData : ScriptableObject { public string weaponName; public int damage; public float fireRate; public int magazineSize; public float reloadTime; public GameObject modelPrefab; public AudioClip fireSound; }这样加一把新枪的流程是右键创建 WeaponData 资产、填参数、拖进武器预制体、换模型。全程不碰代码。ScriptableObject 的另一个好处是运行时共享多个敌人用同一把枪不会各自复制一份数据。注意资产修改在编辑器里是持久的运行时改值不会写回调试时别指望改完重启还在。4. 敌人 AI 与关卡节奏让战斗不变成打木桩4.1 状态机驱动的敌人行为敌人 AI 用有限状态机是最稳的比行为树轻比一堆 if-else 可维护。四个状态足够Idle 待机、Patrol 巡逻、Chase 追击、Attack 攻击。状态切换靠条件判断比如玩家进入视野半径切 Chase进入攻击距离切 Attack丢失目标回 Patrol。public enum EnemyState { Idle, Patrol, Chase, Attack } public EnemyState state EnemyState.Patrol; void Update() { float dist Vector3.Distance(transform.position, player.position); switch (state) { case EnemyState.Patrol: Patrol(); if (dist sightRange) state EnemyState.Chase; // 发现玩家 break; case EnemyState.Chase: Chase(); if (dist attackRange) state EnemyState.Attack; else if (dist sightRange * 1.5f) state EnemyState.Patrol; // 脱战留缓冲 break; case EnemyState.Attack: Attack(); if (dist attackRange * 1.2f) state EnemyState.Chase; break; } }两个细节决定 AI 是否「像人」脱战距离给 sightRange 的 1.5 倍避免玩家在视野边缘反复横跳导致敌人抽搐攻击距离退出给 1.2 倍缓冲同理。sightRange 一般 15 到 20 米attackRange 2 到 3 米具体看关卡尺度。巡逻用 Waypoint 数组加 NavMeshAgent 的 SetDestination追击直接追玩家坐标。这套逻辑不复杂但少了缓冲值敌人会在状态边界疯狂切换表现像卡顿。4.2 寻路、感知与性能开销寻路用 NavMesh场景烘焙好 NavMesh 之后敌人才能绕障碍。烘焙参数里 Agent Radius 要略大于敌人碰撞体半径否则贴墙走会卡住Agent Height 按模型高度给。感知除了距离进阶一点加视野角度检测用 Vector3.Angle 判断玩家是否在敌人正前方 60 度锥形内背后偷袭就不会被立刻发现。性能上敌人数量超过 20 个时每帧对每个敌人做距离计算和射线检测会掉帧。常见优化是降低 AI 更新频率用协程每 0.2 秒更新一次状态判断而不是每帧。NavMeshAgent 的 updatePosition 和 updateRotation 在远处敌人身上可以关掉靠近再开。这些优化在完整工程里不一定都做了但你接手后迟早要补提前知道比事后救火强。4.3 关卡节奏与刷怪逻辑FPS 关卡节奏靠刷怪波次控制。简单做法是触发器分区玩家进入区域激活一波敌人清完开下一波。刷怪点用空物体标记敌人从预制体实例化。// 波次刷怪清空当前波后延迟刷下一波 IEnumerator SpawnWave(int waveIndex) { foreach (Transform point in spawnPoints) { Instantiate(enemyPrefab, point.position, point.rotation); } yield return new WaitUntil(() aliveEnemies 0); // 等待清场 yield return new WaitForSeconds(3f); // 喘息时间 if (waveIndex 1 totalWaves) StartCoroutine(SpawnWave(waveIndex 1)); }aliveEnemies 计数要在敌人死亡时递减用事件或接口回调都行。喘息时间 3 秒是节奏点太短玩家没时间换弹补给太长战斗断档。波次之间可以放补给点这是关卡设计的常见手法。这套逻辑简单但配合场景分区和音效提示战斗节奏就出来了。5. 避坑与排查这几个坑我踩过不止一次5.1 输入无响应新旧输入系统混用现象工程跑起来WASD 和鼠标都没反应Console 无报错。原因工程启用了新 Input System 包但脚本还在用 Input.GetAxis 旧 API两者没配兼容。解决Project Settings 的 Player 里把 Active Input Handling 改成 Both或者把脚本迁移到新输入系统的 InputAction。迁移时注意新系统的 Action 要在 Inspector 里绑定光写代码不绑资产一样没反应。5.2 射线打不中敌人LayerMask 配错现象开枪有音效、弹药在减但敌人不掉血。原因hitMask 没包含敌人所在层或者敌人碰撞体是 Trigger 而射线默认不检测 Trigger。解决检查敌人 Layer 是否在 hitMask 里Physics.Raycast 加 QueryTriggerInteraction.Collide 参数或者把敌人碰撞体改成非 Trigger。这个坑隐蔽在于「看起来一切正常」只有加 Debug.DrawRay 画出射线才看得出打到了哪。5.3 打包后黑屏或场景丢失现象编辑器里跑得好好的打包出来黑屏。原因Build Settings 里没把场景加进 Scenes In Build或者场景加载用的是场景名但打包后路径变了。解决File 的 Build Settings 里确认所有场景按顺序加入加载统一用 SceneManager.LoadScene 的场景名而非索引索引在场景增删后会错位。另外注意异步加载的 allowSceneActivation 逻辑在打包后行为一致但进度条 UI 如果挂在被销毁的场景里会丢。5.4 敌人卡在墙角或原地抖动现象敌人追击时贴着墙不动或者在两个状态间高频切换。原因NavMesh 烘焙的 Agent Radius 小于碰撞体半径寻路路径贴墙导致物理碰撞卡住状态切换没有缓冲距离。解决重新烘焙 NavMeshAgent Radius 调大到略大于碰撞体状态机里加脱战和退出攻击的缓冲系数如 1.2 到 1.5 倍。抖动问题九成是边界条件没留余量。5.5 换弹期间仍能开火或弹药负数现象狂点左键时换弹和开火同时触发弹药扣成负数。原因开火判断没检查 isReloading 状态换弹协程和开火 Update 并发。解决开火入口加 if (isReloading) return弹药扣减前判断 currentAmmo 0换弹开始时把状态锁置位协程结束再复位。状态锁要用成员变量而非局部变量否则协程内外看不到同一份状态。6. 二次开发与验证把工程改成自己的东西拿到完整工程最终目的是改成自己的项目而不是永远跑原版。二次开发的第一步是替换玩家和武器模型保持脚本挂载点不变只换 Mesh 和动画。模型替换后要重新对齐相机位置和武器挂点常见做法是在玩家预制体下留一个 WeaponSocket 空物体武器实例化时挂到该节点这样换模型不用改代码。第二步是数值重标定。原工程的移动速度、射速、伤害是按它的关卡尺度调的换到你的地图要重测。我一般会做一个测试场景放一排不同距离的靶子从 5 米到 50 米跑一遍射击确认弹道和伤害衰减符合预期。验证方法很土但有效录屏慢放看射线命中点和准星是否对齐看换弹动画和弹药刷新是否同步。第三步是性能验证。用 Profiler 看三块CPU 的 AI 更新耗时、渲染的 Draw Call、GC 的每帧分配。FPS 工程常见的性能问题是每帧 new 对象导致 GC 卡顿比如射击时每次 new 一个 RaycastHit 数组改成复用成员变量就好。Draw Call 高就把静态场景标记 Static 合批敌人用 GPU Instancing。验证项方法合格线射击命中靶场慢放对比准星偏差小于准星半径换弹同步录屏逐帧看动画与弹药误差小于 0.1 秒AI 性能Profiler 看 AI 模块单帧小于 2ms打包运行真机跑完整关卡无黑屏、无报错从那以后我每次接手别人的 Unity 工程都强制先走一遍「跑通 → 画调用链 → 改一个参数验证 → 打包一次」的流程不跑通打包绝不往下改因为编辑器里的正常和打包后的正常是两回事。希望这份拆解能帮到你少走几段我走过的弯路。本文还有配套的精品资源点击获取
