實戰(zhàn)：角色控制器、武器射擊與AI狀態(tài)機全解析)
簡介一套可在 Unity3D 中直接運行的 FPS 游戲完整工程源碼面向希望掌握第一人稱射擊玩法和聯(lián)機對戰(zhàn)實現(xiàn)的中初級開發(fā)者可用于學(xué)習(xí)項目搭建與功能拆解。壓縮包內(nèi)共 1609 個文件其中包含大量場景與資源索引用的 bin、info、meta 文件以及核心的 asset、prefab、mat、cs 等工程配置和腳本文件整體約 38.91MB。已有 2409 人瀏覽學(xué)習(xí)。借助這套工程可以系統(tǒng)查看 FPS 項目的基礎(chǔ)目錄結(jié)構(gòu)、角色移動與射擊邏輯、資源管理方式并了解 Unity3D 中通過網(wǎng)絡(luò)庫同步玩家狀態(tài)的基本思路。對于正在規(guī)劃自己的多人 FPS 原型、需要一份可運行參考代碼的開發(fā)者來說具有一定的對照和借鑒價值。1. Untiy3D_FPS 不是成品游戲是一套能直接跑的 FPS 框架拿到 Untiy3D_FPS 這個資源包先別急著想著“導(dǎo)入就能玩”。它不是一個完整可發(fā)行的 FPS 游戲而是一套把射擊游戲從零搭到可玩狀態(tài)的框架工程角色控制器、鼠標視角、武器射擊與換彈、敵人 AI、命中反饋和基礎(chǔ) UI 全都在里面。它最省事的地方是——你不必從空場景開始去建角色、寫相機、調(diào)物理直接打開場景就能跑適合正在做 FPS 畢業(yè)設(shè)計、想快速驗證核心玩法的人。更值錢的是它把“怎么組合起來”演示了一遍控制器怎么掛、相機放哪一層、武器腳本為什么這么寫照著它的結(jié)構(gòu)能省掉一周的試錯。2. 角色控制器Rigidbody 選型、視角分離與手感參數(shù)FPS 里的“走路手感”是第一個分水嶺。這套工程用的是 Rigidbody 方案而不是 Unity 自帶的 CharacterController很多剛?cè)腴T的開發(fā)者會在這個選擇上翻車原因值得先講清楚。2.1 為什么不用 CharacterController 而用 RigidbodyCharacterController 自帶 Move 接口用起來像“推著膠囊走”好處是寫起來簡單、不會穿墻壞處是它不走物理引擎碰上移動平臺、爆炸沖擊波、子彈擊退這些需要物理反饋的場景就要額外寫很多補丁邏輯。Rigidbody 方案讓角色真的“睡”在物理系統(tǒng)里障礙物阻擋、斜坡滑行、被炸彈炸飛都是免費送的代價是會遇到抖動、穿模這些物理調(diào)參問題。這套工程的控制器大致長這樣using UnityEngine; public class FPSController : MonoBehaviour { [Header(移動參數(shù))] [SerializeField] private float moveSpeed 6f; // 普通行走速度 [SerializeField] private float sprintSpeed 9f; // 疾跑速度 [SerializeField] private float jumpForce 5f; // 跳躍初速度 [SerializeField] private float groundCheckDistance 0.2f; private Rigidbody rb; private bool isGrounded; void Start() { rb GetComponentRigidbody(); rb.freezeRotation true; // 凍結(jié)旋轉(zhuǎn)防止物理引擎把角色撞倒 rb.interpolation RigidbodyInterpolation.Interpolate; // 減少運動抖動 } void FixedUpdate() { // 地面檢測向腳下射一條短射線比 OnCollisionStay 更穩(wěn)定 isGrounded Physics.Raycast(transform.position, Vector3.down, groundCheckDistance); if (Input.GetButtonDown(Jump) isGrounded) { rb.AddForce(Vector3.up * jumpForce, ForceMode.Impulse); } float h Input.GetAxis(Horizontal); float v Input.GetAxis(Vertical); Vector3 moveDir transform.right * h transform.forward * v; moveDir Vector3.ClampMagnitude(moveDir, 1f); float targetSpeed Input.GetKey(KeyCode.LeftShift) ? sprintSpeed : moveSpeed; // MovePosition 在物理幀里移動受碰撞約束不會直接瞬移穿墻 rb.MovePosition(transform.position moveDir * targetSpeed * Time.fixedDeltaTime); } }這段代碼有三個容易被忽略的點。第一rb.interpolation InterpolateRigidbody 默認在低幀率下會有明顯的“一格一格”移動開了插值后畫面會順滑很多這是 FPS 手感的第一步。第二ClampMagnitude是必要的因為鍵盤輸入從斜方向同時按下時Vector3的長度會變成 1.414 倍不截斷的話斜著跑會比正著跑速度快很多。第三跳躍檢測放在Update里、物理移動放在FixedUpdate里標準做法因為FixedUpdate的調(diào)用頻率固定而跳躍輸入是逐幀的放在Update里響應(yīng)最及時。2.2 鼠標視角Pitch/Yaw 分離消除萬向鎖相機視角是 FPS 最容易做出“暈 3D 感”的部分。很多人直接對相機物體做RotateAround結(jié)果抬頭到 90 度后視角開始亂轉(zhuǎn)這是歐拉角的萬向鎖問題。這套工程的處理方式是水平旋轉(zhuǎn)Yaw作用在角色身上垂直旋轉(zhuǎn)Pitch只作用在相機上兩者徹底分離。using UnityEngine; public class MouseLook : MonoBehaviour { [Header(靈敏度)] [SerializeField] private float mouseSensitivity 2f; [SerializeField] private float pitchMin -85f; // 低頭下限 [SerializeField] private float pitchMax 85f; // 抬頭上限 private float pitch; // 當(dāng)前俯仰角 void Start() { Cursor.lockState CursorLockMode.Locked; // 鎖定鼠標光標到屏幕中心 } void Update() { float mouseX Input.GetAxis(Mouse X) * mouseSensitivity; float mouseY Input.GetAxis(Mouse Y) * mouseSensitivity; // 水平旋轉(zhuǎn)旋轉(zhuǎn)角色節(jié)點 transform.parent.Rotate(0f, mouseX, 0f); // 垂直旋轉(zhuǎn)使用歐拉角累加并夾緊避免萬向鎖 pitch - mouseY; pitch Mathf.Clamp(pitch, pitchMin, pitchMax); transform.localRotation Quaternion.Euler(pitch, 0f, 0f); } }掛載方式是相機作為角色的子物體MouseLook掛在相機上transform.parent指向角色。這么做的好處是角色模型的轉(zhuǎn)身和相機視角的左右轉(zhuǎn)動完全同步而上下俯仰不會帶動整個身體旋轉(zhuǎn)——從第三人稱視角看角色是“轉(zhuǎn)頭”而不是整個身體都跟著低頭。Cursor.lockState用CursorLockMode.Locked而不用Confined因為 Locked 才能保證射擊游戲里鼠標不撞到屏幕邊緣。2.3 手感參數(shù)怎么調(diào)一張表和兩個檢查點有了代碼還需要參數(shù)這套工程把參數(shù)都暴露在 Inspector 里方便在編輯狀態(tài)下隨時改。給一組我試過比較穩(wěn)的初始值作為參考參數(shù)建議范圍默認值說明moveSpeed486低于 4 像走路高于 8 轉(zhuǎn)向會漂sprintSpeed8129需要和 FOV 聯(lián)動效果更好jumpForce465高于 6 跳躍滯空時間過長mouseSensitivity1.532和鼠標設(shè)備 DPI 相關(guān)不是絕對標準pitchMax / pitchMin8090±85留 5 度余量避免邊緣抖動兩個檢查點第一個跑起來時感覺“飄”還是“沉”。飄就降移動速度或者增大drag值沉就檢查是不是drag設(shè)太高了導(dǎo)致慣性感過大。第二個轉(zhuǎn)身快速滑鼠標時有沒有掉幀感有的話檢查相機的Field of View默認 60 度在高速轉(zhuǎn)向時容易暈調(diào)到 7080 度會明顯改善。手感調(diào)試沒有絕對公式但先把這兩點檢查完再去動其他參數(shù)能減少很多盲目試錯。3. 武器系統(tǒng)與射擊邏輯射線檢測、散布、換彈與彈藥數(shù)據(jù)角色能走了下一步就是能打人。這套工程的武器模塊做了三個層次射擊模式、彈藥換彈、后坐力與散布分別是“能不能打”“打多少發(fā)”“打得準不準”三層問題。3.1 單發(fā)/連發(fā)/霰彈三種射擊模式在一套腳本里武器腳本的核心不是子彈而是“開火判定”。這套工程默認用射線檢測模擬子彈——從槍口向正前方打一條Ray如果射線碰到了帶IDamageable接口的對象就執(zhí)行傷害邏輯。射線檢測比彈道物體物理子彈性能高很多而且不需要處理子彈飛行速度、碰撞反彈這類問題適合原型階段。using UnityEngine; public class WeaponController : MonoBehaviour { [Header(武器屬性)] public float damage 25f; public float range 100f; public float fireRate 0.12f; // 連發(fā)間隔秒 public int maxAmmo 30; public int currentAmmo; [Header(射擊模式)] public bool isAutomatic true; // true連發(fā)false單發(fā) public int pellets 1; // 1普通單發(fā)1 為霰彈 [Header(散布)] public float spreadAngle 1.5f; // 準星擴散角度 private float nextFireTime; void Start() currentAmmo maxAmmo; public void TryFire() { bool canShoot isAutomatic ? Input.GetButton(Fire1) : Input.GetButtonDown(Fire1); if (!canShoot || Time.time nextFireTime || currentAmmo 0) return; nextFireTime Time.time fireRate; currentAmmo--; for (int i 0; i pellets; i) { // 每次開火給一個隨機方向偏轉(zhuǎn)模擬彈道散布 Vector3 dir Camera.main.transform.forward; dir Quaternion.Euler( Random.Range(-spreadAngle, spreadAngle), Random.Range(-spreadAngle, spreadAngle), 0f) * dir; if (Physics.Raycast(Camera.main.transform.position, dir, out RaycastHit hit, range)) { // 命中接口調(diào)用Unity 中常見的是 hit.collider.GetComponentIDamageable() } } } void Update() TryFire(); // 簡化寫法實際工程會放在 Input 事件回調(diào)里 }幾個參數(shù)是決定手感的關(guān)鍵。spreadAngle的單位是角度不是像素距離1.5 度意味著在 100 米外子彈會偏離約 2.6 米打遠程精度要求高的場景要降到 0.5 度以下。fireRate是射擊間隔0.12 秒相當(dāng)于每分鐘 500 發(fā)這是沖鋒槍級別的射速如果要做步槍手感調(diào)到 0.150.2 更合適。pellets設(shè)為 8 就是霰彈槍但注意每顆彈丸都獨立計算散布和傷害所以霰彈槍近距離傷害爆發(fā)極高需要在數(shù)值上做距離衰減。3.2 彈藥與換彈數(shù)值同步比開槍邏輯更值得關(guān)注射擊邏輯本身好寫真正容易出 bug 的是彈藥系統(tǒng)和 UI 同步。這套工程里彈藥分兩層彈匣容量currentAmmo和后備彈藥reserveAmmo。換彈不是瞬間完成的要用協(xié)程模擬換彈動畫的耗時。public class AmmoSystem : MonoBehaviour { public int reserveAmmo 90; // 后備彈藥 public int magSize 30; // 彈匣容量 public float reloadTime 2.2f; // 換彈耗時 public int currentAmmo; public bool isReloading; void Start() currentAmmo magSize; public IEnumerator Reload() { if (isReloading || currentAmmo magSize) yield break; isReloading true; yield return new WaitForSeconds(reloadTime); // 等換彈動畫播放完 // 從后備彈藥中取出補滿彈匣所需數(shù)量 int need magSize - currentAmmo; int take Mathf.Min(need, reserveAmmo); currentAmmo take; reserveAmmo - take; isReloading false; } }換彈的邊界情況很多如果彈匣是滿的按 R 不應(yīng)該觸發(fā)換彈如果后備彈藥為 0換彈應(yīng)該直接不開始并提示玩家角色在換彈空隙死亡協(xié)程卻還在跑會導(dǎo)致復(fù)活后彈藥被憑空補充。解決后兩個問題的方法是在協(xié)程開頭和結(jié)尾都檢查isReloading狀態(tài)、在角色死亡時停掉所有協(xié)程并重置彈藥狀態(tài)。數(shù)值同步上UI 的彈藥顯示直接用currentAmmo / reserveAmmo不要在 UI 里再做一次加減運算否則很容易出現(xiàn)“換完彈顯示 31 發(fā)”這種尷尬的數(shù)字。3.3 后坐力與準星擴散調(diào)手感像調(diào)音后坐力在代碼層很直接就是開火時給相機加一個向上的脈沖角度然后讓它慢慢回落。但這套工程里真正的調(diào)節(jié)重點是“準星擴散”——不開火時準星是收緊的持續(xù)開火時擴散變大?；鸷笾饾u恢復(fù)。這個機制比單純的屏幕抖動更能影響手感。常見的做法是維護一個currentSpread變量每次開火增加一個固定量每幀衰減回去public float baseSpread 0.5f; // 靜止時最小散布 public float maxSpread 5f; // 連續(xù)射擊后最大散布 public float spreadIncrease 0.3f; // 每發(fā)增量 public float spreadRecover 2f; // 每秒恢復(fù)量 private float currentSpread; void UpdateSpread() { if (currentSpread baseSpread) currentSpread - spreadRecover * Time.deltaTime; currentSpread Mathf.Clamp(currentSpread, baseSpread, maxSpread); // 準星 UI 的寬度和這個值綁定 }所有槍支手感調(diào)到最后都會變成一個“數(shù)值表格”——射速、后坐力、散步恢復(fù)速度三者互為犄角。射速快但回復(fù)慢的槍手感是一路飄上去的射速慢但回復(fù)快的槍適合點射型玩法。這個參數(shù)組合沒有唯一解只能照著自己玩起來的感覺微調(diào)。我一般會把連發(fā)武器的spreadIncrease調(diào)到 0.30.4 之間這樣 10 發(fā)左右能明顯感到散布變大而不是前 5 發(fā)就糊成一團。4. 敵人 AI 與命中反饋狀態(tài)機、NavMesh 與傷害數(shù)字打靶場景能走通之后就要面對 FPS 的第二塊硬骨頭敵人。這套工程的敵人做了一個最基礎(chǔ)但結(jié)構(gòu)正確的狀態(tài)機加上 NavMesh 尋路沒有堆復(fù)雜算法但足夠撐起一個可玩的關(guān)卡。4.1 狀態(tài)機先寫對再談智能敵人的 AI 狀態(tài)可以精簡為四個巡邏、追擊、攻擊、死亡。不用一開始就上行為樹普通 FPS 的敵人用狀態(tài)機完全夠用而且調(diào)試起來更直觀。核心邏輯是每幀根據(jù)和玩家的距離切換狀態(tài)public enum EnemyState { Patrol, Chase, Attack, Dead } public class EnemyAI : MonoBehaviour { public EnemyState state EnemyState.Patrol; public float chaseRange 15f; // 發(fā)現(xiàn)玩家的距離 public float attackRange 8f; // 開火距離 public float loseRange 25f; // 丟失玩家的距離大于 chaseRange 才合理 private Transform player; void Update() { if (state EnemyState.Dead) return; float dist Vector3.Distance(transform.position, player.position); if (dist attackRange) state EnemyState.Attack; else if (dist chaseRange) state EnemyState.Chase; else if (dist loseRange) // 用更大距離判斷丟失避免玩家一閃身就回去巡邏 state EnemyState.Patrol; } }這里最容易忽略的細節(jié)是loseRange要大于chaseRange。如果追擊和丟失用同一個距離判斷玩家站在 14.5 米處反復(fù)橫跳敵人就會在巡邏和追擊之間抽搐。這屬于經(jīng)典的“狀態(tài)機搖擺”問題做法就是給進入狀態(tài)和退出狀態(tài)設(shè)置不同的閾值形成一個遲滯區(qū)間。另外狀態(tài)切換不一定要每幀檢測可以每 0.2 秒執(zhí)行一次省掉大量性能開銷敵人肉眼也看不出區(qū)別。4.2 NavMesh 烘焙參數(shù)決定敵人會不會卡墻角NavMesh 是 Unity 內(nèi)置的導(dǎo)航網(wǎng)格系統(tǒng)敵人靠它在場景里找路。烘焙之前要檢查三個參數(shù)Agent Radius代理半徑、Agent Height代理高度、Max Slope最大爬坡角。參數(shù)建議值說明Agent Radius0.30.5過大會讓敵人走不進窄通道過小會貼墻Agent Height1.52以敵人的膠囊體高度為準不要超過門框Max Slope3045超過 45 度的樓梯會被標記為不可走Step Height0.3臺階高度大于此值會需要繞路實際踩坑點在于烘焙完之后敵人還是會走到網(wǎng)格邊緣然后卡住。這種情況多半是目標點玩家位置在 NavMesh 外面——比如玩家站在一個未烘焙的平臺上NavMesh 找不到通往目標點的路徑。處理方式是追擊時先對玩家坐標做一次NavMesh.SamplePosition把目標點拉回最近的可行走位置而不是直接塞給尋路組件。public NavMeshAgent agent; public Transform player; void Chase() { // 將目標點投影到 NavMesh 上偏移最大 2 米 if (NavMesh.SamplePosition(player.position, out NavMeshHit hit, 2f, NavMesh.AllAreas)) { agent.SetDestination(hit.position); } }如果不做這一步玩家站上箱子后敵人會一直在原地打轉(zhuǎn)看起來像是在“隔空推墻”。調(diào)試這類問題的時候不要直接猜邏輯錯誤先在 Scene 視圖把NavMesh和NavMeshAgent的路徑勾選顯示出來路徑的終點在哪一眼就能看到。4.3 傷害判定與命中反饋為什么子彈“沒打中”敵人的碰撞體、武器的射線檢測、傷害接口三者要能對接上需要提前定好 Layer。這套工程的做法是敵人放在Enemy層玩家放在Player層射線檢測時只檢測 Enemy 層避免子彈打到自己和友方單位。[SerializeField] LayerMask enemyLayer; void Fire() { if (Physics.Raycast(ray, out RaycastHit hit, range, enemyLayer)) { if (hit.collider.TryGetComponentIDamageable(out IDamageable target)) target.TakeDamage(damage); } }這里有一個常見的“沒打中”假象子彈確實碰到了敵人的碰撞體但傷害接口掛在敵人根節(jié)點上而射線碰到的碰撞體在子節(jié)點比如手臂GetComponent只能拿到子節(jié)點自己的組件接口自然就調(diào)不到。解決方式有兩個要么在子節(jié)點上也掛傷害接口并轉(zhuǎn)發(fā)給根節(jié)點要么用GetComponentInParent向上查找。我會在碰撞體子物體上放一個空腳本轉(zhuǎn)發(fā)因為GetComponentInParent在深層級的消耗不算小。這層問題理解了后面去做爆頭、部位傷害就順理成章——給頭部單獨掛一個碰撞體和IDamageable實現(xiàn)接口里傳入傷害倍率即可。5. 踩坑實錄五個讓角色打不出傷害的常見問題這套工程我前后跑了三遍每次重裝 Unity 版本都會踩到新坑。下面的問題不分順序全部是從實際運行中一條條記下來的有現(xiàn)象、有原因、有解法按這幾個方向排查能省下大量搜論壇的時間。5.1 運行即報 NullReferenceException現(xiàn)象打開場景點 PlayConsole 面板立刻彈出一堆NullReferenceException提示某個腳本的組件引用為空。角色站在原地不動相機無法旋轉(zhuǎn)。原因腳本 Inspector 上拖拽的引用丟失了。常見于 Unity 版本跨大版本升級比如從 2018 升到 2020序列化字段的m_FileID變化導(dǎo)致引用斷開但腳本本身還掛著。解決先把出問題的腳本組件移除再重新添加。如果工程里引用很多就用腳本批量掃描為空引用選中所有預(yù)制體后檢查每個SerializedObject的FindProperty是否有objectReferenceValue null。找到后重新拖拽賦值即可。更省事的方案是這類引用全部改成在Awake里用GetComponent獲取Inspector 只暴露數(shù)據(jù)參數(shù)不暴露對象引用。5.2 子彈對著敵人打卻沒有任何反應(yīng)現(xiàn)象準星已經(jīng)對準敵人開槍射擊動畫正常播放、彈藥正常消耗但敵人的血條紋絲不動。原因射線檢測沒有命中敵人。大概率是 Layer 過濾的問題——Physics.Raycast默認檢測所有 Layer 是沒有問題的但如果按 4.3 的做法給射線傳了enemyLayer參數(shù)而敵人的 Collider 被放到了別的 Layer比如 Default那射線就會直接穿透敵人。解決在 Inspector 里確認敵人的碰撞體所在 Layer再檢查代碼里傳入的 LayerMask 是否包含該層。調(diào)試時先用Debug.DrawRay畫一條射線看看方向和終點命中點如果和敵人位置偏差超過碰撞體半徑還要檢查射線方向是否確實是從準星中心發(fā)出的。這一步排查完順手把敵人所在 Layer 統(tǒng)一改成 Enemy。5.3 換彈動畫播完但彈藥沒補上現(xiàn)象換彈過程中彈藥顯示 0/90動畫結(jié)束后還是 0/90但后備彈藥沒有減少。原因協(xié)程里的yield return new WaitForSeconds(reloadTime)被中斷了。常見的是角色在換彈期間死亡或切換武器腳本被禁用或者 GameObject 被 SetActive(false)協(xié)程直接終止后續(xù)的補彈代碼根本沒執(zhí)行。解決換彈邏輯不能用裸協(xié)程收尾要加一個“完成標志位”。我的做法是public IEnumerator ReloadRoutine() { isReloading true; yield return new WaitForSeconds(reloadTime); if (this null || !gameObject.activeInHierarchy) yield break; // 安全校驗 currentAmmo Mathf.Min(magSize, currentAmmo reserveAmmo); isReloading false; }另外把換彈開始和補彈完成都通過UnityEvent發(fā)給 UI這樣即使協(xié)程中斷UI 也能響應(yīng)狀態(tài)變化去顯示“換彈被打斷”玩家不會產(chǎn)生“我按了 R 為什么沒反應(yīng)”的困惑。5.4 角色轉(zhuǎn)身時相機抖動畫面出現(xiàn)殘影現(xiàn)象快速左右晃動鼠標時主相機的畫面會出現(xiàn)輕微的“回擺”轉(zhuǎn)到某個角度時抖動非常明顯。原因相機旋轉(zhuǎn)沒有和角色旋轉(zhuǎn)完全同步。如果MouseLook直接掛在主相機上而主相機同時又是某個槍械子物體的父節(jié)點槍械的后坐力動畫有時會在同一幀里修改相機局部旋轉(zhuǎn)兩套旋轉(zhuǎn)邏輯疊加。解決把相機和武器徹底分離。主相機只掛 MouseLook 腳本控制旋轉(zhuǎn)武器模型掛在自己的空物體節(jié)點下用相機旋轉(zhuǎn)后LateUpdate里疊加后坐力偏移。注意LateUpdate的執(zhí)行順序永遠在Update之后這樣可以保證玩家看到的畫面是先完成視角轉(zhuǎn)動、再疊加后坐力而不是反過來。5.5 AI 卡墻角或者追出 NavMesh 邊界現(xiàn)象敵人在墻角來回走機器人導(dǎo)航路徑在 Scene 視圖里顯示為碎線有時直接走穿墻體到網(wǎng)格外面。原因NavMesh 烘焙時 Agent Radius 設(shè)置和墻體厚度不匹配。墻體邊緣如果只有 0.2 米厚而 Agent Radius 設(shè)了 0.5烘焙出來的可行走區(qū)域會自動把墻邊約 0.5 米的范圍劃為不可走敵人只能“隔空碰壁”。解決把墻體做成實體 Mesh 再烘焙不要用只有 Collider 沒有 Renderer 的隱形墻Agent Radius 調(diào)整到小于通道寬度的 1/2。如果敵人已經(jīng)出了 NavMesh說明目標點投影偏差太大參考 4.2 的NavMesh.SamplePosition把目標偏移量從 2 米縮小到 0.5 米并檢查場景中是否有懸空平臺的邊緣沒被烘焙覆蓋。6. 導(dǎo)入后的第一件事重構(gòu)目錄結(jié)構(gòu)和跑通驗證清單拿到這套 Untiy3D_FPS 工程我會建議你先花半小時重構(gòu)目錄把資源和代碼分開再把驗證清單跑一遍。很多工程“能跑”和“能改”是兩回事亂糟糟的目錄里找腳本比寫腳本更浪費時間。推薦的清理方向是四個頂級文件夾Assets/ Scripts/ -- 控制器、武器、AI、UI 全部按模塊拆子目錄 Prefabs/ -- 角色、敵人、掉落的彈藥包 Models/ -- 角色模型和武器模型 Scenes/ -- 主場景和測試場景分開搬動文件后第一件事是重新保存場景并檢查預(yù)制體的引用有沒有斷開Unity 會自動維護 GUID 引用但偶爾會漏。然后按下面的清單跑一遍冒煙測試點 Play 后 Console 無報錯相機視角能自由旋轉(zhuǎn)角色移動方向跟隨視角不會斜移加速射擊 10 發(fā)彈藥減少 10準星散射逐漸變大換彈后彈藥正確補充換彈期間無法繼續(xù)開火敵人能發(fā)現(xiàn)玩家、能追擊、進入射程后開火擊殺敵人后掉落物能正確拾取這套工程最大的價值不是那幾行代碼而是它的組織方式。從那以后我每次拿到別人的 Unity 工程都會先干三件事檢查 Layer 規(guī)劃、刪掉場景里的 Missing Script、把腳本掛載方式統(tǒng)一成GetComponent兜底。這三個習(xí)慣幫我避開了九成以上的運行時報錯。這個 FPS 包也一樣——先跑通再看結(jié)構(gòu)改出第一個屬于自己的武器再動那些參數(shù)去調(diào)手感希望幫到你。本文還有配套的精品資源點擊獲取 Unity FPS游戲框架開發(fā)實戰(zhàn)：角色控制器、武器射擊與AI狀態(tài)機全解析
簡介一套可在 Unity3D 中直接運行的 FPS 游戲完整工程源碼面向希望掌握第一人稱射擊玩法和聯(lián)機對戰(zhàn)實現(xiàn)的中初級開發(fā)者可用于學(xué)習(xí)項目搭建與功能拆解。壓縮包內(nèi)共 1609 個文件其中包含大量場景與資源索引用的 bin、info、meta 文件以及核心的 asset、prefab、mat、cs 等工程配置和腳本文件整體約 38.91MB。已有 2409 人瀏覽學(xué)習(xí)。借助這套工程可以系統(tǒng)查看 FPS 項目的基礎(chǔ)目錄結(jié)構(gòu)、角色移動與射擊邏輯、資源管理方式并了解 Unity3D 中通過網(wǎng)絡(luò)庫同步玩家狀態(tài)的基本思路。對于正在規(guī)劃自己的多人 FPS 原型、需要一份可運行參考代碼的開發(fā)者來說具有一定的對照和借鑒價值。1. Untiy3D_FPS 不是成品游戲是一套能直接跑的 FPS 框架拿到 Untiy3D_FPS 這個資源包先別急著想著“導(dǎo)入就能玩”。它不是一個完整可發(fā)行的 FPS 游戲而是一套把射擊游戲從零搭到可玩狀態(tài)的框架工程角色控制器、鼠標視角、武器射擊與換彈、敵人 AI、命中反饋和基礎(chǔ) UI 全都在里面。它最省事的地方是——你不必從空場景開始去建角色、寫相機、調(diào)物理直接打開場景就能跑適合正在做 FPS 畢業(yè)設(shè)計、想快速驗證核心玩法的人。更值錢的是它把“怎么組合起來”演示了一遍控制器怎么掛、相機放哪一層、武器腳本為什么這么寫照著它的結(jié)構(gòu)能省掉一周的試錯。2. 角色控制器Rigidbody 選型、視角分離與手感參數(shù)FPS 里的“走路手感”是第一個分水嶺。這套工程用的是 Rigidbody 方案而不是 Unity 自帶的 CharacterController很多剛?cè)腴T的開發(fā)者會在這個選擇上翻車原因值得先講清楚。2.1 為什么不用 CharacterController 而用 RigidbodyCharacterController 自帶 Move 接口用起來像“推著膠囊走”好處是寫起來簡單、不會穿墻壞處是它不走物理引擎碰上移動平臺、爆炸沖擊波、子彈擊退這些需要物理反饋的場景就要額外寫很多補丁邏輯。Rigidbody 方案讓角色真的“睡”在物理系統(tǒng)里障礙物阻擋、斜坡滑行、被炸彈炸飛都是免費送的代價是會遇到抖動、穿模這些物理調(diào)參問題。這套工程的控制器大致長這樣using UnityEngine; public class FPSController : MonoBehaviour { [Header(移動參數(shù))] [SerializeField] private float moveSpeed 6f; // 普通行走速度 [SerializeField] private float sprintSpeed 9f; // 疾跑速度 [SerializeField] private float jumpForce 5f; // 跳躍初速度 [SerializeField] private float groundCheckDistance 0.2f; private Rigidbody rb; private bool isGrounded; void Start() { rb GetComponentRigidbody(); rb.freezeRotation true; // 凍結(jié)旋轉(zhuǎn)防止物理引擎把角色撞倒 rb.interpolation RigidbodyInterpolation.Interpolate; // 減少運動抖動 } void FixedUpdate() { // 地面檢測向腳下射一條短射線比 OnCollisionStay 更穩(wěn)定 isGrounded Physics.Raycast(transform.position, Vector3.down, groundCheckDistance); if (Input.GetButtonDown(Jump) isGrounded) { rb.AddForce(Vector3.up * jumpForce, ForceMode.Impulse); } float h Input.GetAxis(Horizontal); float v Input.GetAxis(Vertical); Vector3 moveDir transform.right * h transform.forward * v; moveDir Vector3.ClampMagnitude(moveDir, 1f); float targetSpeed Input.GetKey(KeyCode.LeftShift) ? sprintSpeed : moveSpeed; // MovePosition 在物理幀里移動受碰撞約束不會直接瞬移穿墻 rb.MovePosition(transform.position moveDir * targetSpeed * Time.fixedDeltaTime); } }這段代碼有三個容易被忽略的點。第一rb.interpolation InterpolateRigidbody 默認在低幀率下會有明顯的“一格一格”移動開了插值后畫面會順滑很多這是 FPS 手感的第一步。第二ClampMagnitude是必要的因為鍵盤輸入從斜方向同時按下時Vector3的長度會變成 1.414 倍不截斷的話斜著跑會比正著跑速度快很多。第三跳躍檢測放在Update里、物理移動放在FixedUpdate里標準做法因為FixedUpdate的調(diào)用頻率固定而跳躍輸入是逐幀的放在Update里響應(yīng)最及時。2.2 鼠標視角Pitch/Yaw 分離消除萬向鎖相機視角是 FPS 最容易做出“暈 3D 感”的部分。很多人直接對相機物體做RotateAround結(jié)果抬頭到 90 度后視角開始亂轉(zhuǎn)這是歐拉角的萬向鎖問題。這套工程的處理方式是水平旋轉(zhuǎn)Yaw作用在角色身上垂直旋轉(zhuǎn)Pitch只作用在相機上兩者徹底分離。using UnityEngine; public class MouseLook : MonoBehaviour { [Header(靈敏度)] [SerializeField] private float mouseSensitivity 2f; [SerializeField] private float pitchMin -85f; // 低頭下限 [SerializeField] private float pitchMax 85f; // 抬頭上限 private float pitch; // 當(dāng)前俯仰角 void Start() { Cursor.lockState CursorLockMode.Locked; // 鎖定鼠標光標到屏幕中心 } void Update() { float mouseX Input.GetAxis(Mouse X) * mouseSensitivity; float mouseY Input.GetAxis(Mouse Y) * mouseSensitivity; // 水平旋轉(zhuǎn)旋轉(zhuǎn)角色節(jié)點 transform.parent.Rotate(0f, mouseX, 0f); // 垂直旋轉(zhuǎn)使用歐拉角累加并夾緊避免萬向鎖 pitch - mouseY; pitch Mathf.Clamp(pitch, pitchMin, pitchMax); transform.localRotation Quaternion.Euler(pitch, 0f, 0f); } }掛載方式是相機作為角色的子物體MouseLook掛在相機上transform.parent指向角色。這么做的好處是角色模型的轉(zhuǎn)身和相機視角的左右轉(zhuǎn)動完全同步而上下俯仰不會帶動整個身體旋轉(zhuǎn)——從第三人稱視角看角色是“轉(zhuǎn)頭”而不是整個身體都跟著低頭。Cursor.lockState用CursorLockMode.Locked而不用Confined因為 Locked 才能保證射擊游戲里鼠標不撞到屏幕邊緣。2.3 手感參數(shù)怎么調(diào)一張表和兩個檢查點有了代碼還需要參數(shù)這套工程把參數(shù)都暴露在 Inspector 里方便在編輯狀態(tài)下隨時改。給一組我試過比較穩(wěn)的初始值作為參考參數(shù)建議范圍默認值說明moveSpeed486低于 4 像走路高于 8 轉(zhuǎn)向會漂sprintSpeed8129需要和 FOV 聯(lián)動效果更好jumpForce465高于 6 跳躍滯空時間過長mouseSensitivity1.532和鼠標設(shè)備 DPI 相關(guān)不是絕對標準pitchMax / pitchMin8090±85留 5 度余量避免邊緣抖動兩個檢查點第一個跑起來時感覺“飄”還是“沉”。飄就降移動速度或者增大drag值沉就檢查是不是drag設(shè)太高了導(dǎo)致慣性感過大。第二個轉(zhuǎn)身快速滑鼠標時有沒有掉幀感有的話檢查相機的Field of View默認 60 度在高速轉(zhuǎn)向時容易暈調(diào)到 7080 度會明顯改善。手感調(diào)試沒有絕對公式但先把這兩點檢查完再去動其他參數(shù)能減少很多盲目試錯。3. 武器系統(tǒng)與射擊邏輯射線檢測、散布、換彈與彈藥數(shù)據(jù)角色能走了下一步就是能打人。這套工程的武器模塊做了三個層次射擊模式、彈藥換彈、后坐力與散布分別是“能不能打”“打多少發(fā)”“打得準不準”三層問題。3.1 單發(fā)/連發(fā)/霰彈三種射擊模式在一套腳本里武器腳本的核心不是子彈而是“開火判定”。這套工程默認用射線檢測模擬子彈——從槍口向正前方打一條Ray如果射線碰到了帶IDamageable接口的對象就執(zhí)行傷害邏輯。射線檢測比彈道物體物理子彈性能高很多而且不需要處理子彈飛行速度、碰撞反彈這類問題適合原型階段。using UnityEngine; public class WeaponController : MonoBehaviour { [Header(武器屬性)] public float damage 25f; public float range 100f; public float fireRate 0.12f; // 連發(fā)間隔秒 public int maxAmmo 30; public int currentAmmo; [Header(射擊模式)] public bool isAutomatic true; // true連發(fā)false單發(fā) public int pellets 1; // 1普通單發(fā)1 為霰彈 [Header(散布)] public float spreadAngle 1.5f; // 準星擴散角度 private float nextFireTime; void Start() currentAmmo maxAmmo; public void TryFire() { bool canShoot isAutomatic ? Input.GetButton(Fire1) : Input.GetButtonDown(Fire1); if (!canShoot || Time.time nextFireTime || currentAmmo 0) return; nextFireTime Time.time fireRate; currentAmmo--; for (int i 0; i pellets; i) { // 每次開火給一個隨機方向偏轉(zhuǎn)模擬彈道散布 Vector3 dir Camera.main.transform.forward; dir Quaternion.Euler( Random.Range(-spreadAngle, spreadAngle), Random.Range(-spreadAngle, spreadAngle), 0f) * dir; if (Physics.Raycast(Camera.main.transform.position, dir, out RaycastHit hit, range)) { // 命中接口調(diào)用Unity 中常見的是 hit.collider.GetComponentIDamageable() } } } void Update() TryFire(); // 簡化寫法實際工程會放在 Input 事件回調(diào)里 }幾個參數(shù)是決定手感的關(guān)鍵。spreadAngle的單位是角度不是像素距離1.5 度意味著在 100 米外子彈會偏離約 2.6 米打遠程精度要求高的場景要降到 0.5 度以下。fireRate是射擊間隔0.12 秒相當(dāng)于每分鐘 500 發(fā)這是沖鋒槍級別的射速如果要做步槍手感調(diào)到 0.150.2 更合適。pellets設(shè)為 8 就是霰彈槍但注意每顆彈丸都獨立計算散布和傷害所以霰彈槍近距離傷害爆發(fā)極高需要在數(shù)值上做距離衰減。3.2 彈藥與換彈數(shù)值同步比開槍邏輯更值得關(guān)注射擊邏輯本身好寫真正容易出 bug 的是彈藥系統(tǒng)和 UI 同步。這套工程里彈藥分兩層彈匣容量currentAmmo和后備彈藥reserveAmmo。換彈不是瞬間完成的要用協(xié)程模擬換彈動畫的耗時。public class AmmoSystem : MonoBehaviour { public int reserveAmmo 90; // 后備彈藥 public int magSize 30; // 彈匣容量 public float reloadTime 2.2f; // 換彈耗時 public int currentAmmo; public bool isReloading; void Start() currentAmmo magSize; public IEnumerator Reload() { if (isReloading || currentAmmo magSize) yield break; isReloading true; yield return new WaitForSeconds(reloadTime); // 等換彈動畫播放完 // 從后備彈藥中取出補滿彈匣所需數(shù)量 int need magSize - currentAmmo; int take Mathf.Min(need, reserveAmmo); currentAmmo take; reserveAmmo - take; isReloading false; } }換彈的邊界情況很多如果彈匣是滿的按 R 不應(yīng)該觸發(fā)換彈如果后備彈藥為 0換彈應(yīng)該直接不開始并提示玩家角色在換彈空隙死亡協(xié)程卻還在跑會導(dǎo)致復(fù)活后彈藥被憑空補充。解決后兩個問題的方法是在協(xié)程開頭和結(jié)尾都檢查isReloading狀態(tài)、在角色死亡時停掉所有協(xié)程并重置彈藥狀態(tài)。數(shù)值同步上UI 的彈藥顯示直接用currentAmmo / reserveAmmo不要在 UI 里再做一次加減運算否則很容易出現(xiàn)“換完彈顯示 31 發(fā)”這種尷尬的數(shù)字。3.3 后坐力與準星擴散調(diào)手感像調(diào)音后坐力在代碼層很直接就是開火時給相機加一個向上的脈沖角度然后讓它慢慢回落。但這套工程里真正的調(diào)節(jié)重點是“準星擴散”——不開火時準星是收緊的持續(xù)開火時擴散變大?；鸷笾饾u恢復(fù)。這個機制比單純的屏幕抖動更能影響手感。常見的做法是維護一個currentSpread變量每次開火增加一個固定量每幀衰減回去public float baseSpread 0.5f; // 靜止時最小散布 public float maxSpread 5f; // 連續(xù)射擊后最大散布 public float spreadIncrease 0.3f; // 每發(fā)增量 public float spreadRecover 2f; // 每秒恢復(fù)量 private float currentSpread; void UpdateSpread() { if (currentSpread baseSpread) currentSpread - spreadRecover * Time.deltaTime; currentSpread Mathf.Clamp(currentSpread, baseSpread, maxSpread); // 準星 UI 的寬度和這個值綁定 }所有槍支手感調(diào)到最后都會變成一個“數(shù)值表格”——射速、后坐力、散步恢復(fù)速度三者互為犄角。射速快但回復(fù)慢的槍手感是一路飄上去的射速慢但回復(fù)快的槍適合點射型玩法。這個參數(shù)組合沒有唯一解只能照著自己玩起來的感覺微調(diào)。我一般會把連發(fā)武器的spreadIncrease調(diào)到 0.30.4 之間這樣 10 發(fā)左右能明顯感到散布變大而不是前 5 發(fā)就糊成一團。4. 敵人 AI 與命中反饋狀態(tài)機、NavMesh 與傷害數(shù)字打靶場景能走通之后就要面對 FPS 的第二塊硬骨頭敵人。這套工程的敵人做了一個最基礎(chǔ)但結(jié)構(gòu)正確的狀態(tài)機加上 NavMesh 尋路沒有堆復(fù)雜算法但足夠撐起一個可玩的關(guān)卡。4.1 狀態(tài)機先寫對再談智能敵人的 AI 狀態(tài)可以精簡為四個巡邏、追擊、攻擊、死亡。不用一開始就上行為樹普通 FPS 的敵人用狀態(tài)機完全夠用而且調(diào)試起來更直觀。核心邏輯是每幀根據(jù)和玩家的距離切換狀態(tài)public enum EnemyState { Patrol, Chase, Attack, Dead } public class EnemyAI : MonoBehaviour { public EnemyState state EnemyState.Patrol; public float chaseRange 15f; // 發(fā)現(xiàn)玩家的距離 public float attackRange 8f; // 開火距離 public float loseRange 25f; // 丟失玩家的距離大于 chaseRange 才合理 private Transform player; void Update() { if (state EnemyState.Dead) return; float dist Vector3.Distance(transform.position, player.position); if (dist attackRange) state EnemyState.Attack; else if (dist chaseRange) state EnemyState.Chase; else if (dist loseRange) // 用更大距離判斷丟失避免玩家一閃身就回去巡邏 state EnemyState.Patrol; } }這里最容易忽略的細節(jié)是loseRange要大于chaseRange。如果追擊和丟失用同一個距離判斷玩家站在 14.5 米處反復(fù)橫跳敵人就會在巡邏和追擊之間抽搐。這屬于經(jīng)典的“狀態(tài)機搖擺”問題做法就是給進入狀態(tài)和退出狀態(tài)設(shè)置不同的閾值形成一個遲滯區(qū)間。另外狀態(tài)切換不一定要每幀檢測可以每 0.2 秒執(zhí)行一次省掉大量性能開銷敵人肉眼也看不出區(qū)別。4.2 NavMesh 烘焙參數(shù)決定敵人會不會卡墻角NavMesh 是 Unity 內(nèi)置的導(dǎo)航網(wǎng)格系統(tǒng)敵人靠它在場景里找路。烘焙之前要檢查三個參數(shù)Agent Radius代理半徑、Agent Height代理高度、Max Slope最大爬坡角。參數(shù)建議值說明Agent Radius0.30.5過大會讓敵人走不進窄通道過小會貼墻Agent Height1.52以敵人的膠囊體高度為準不要超過門框Max Slope3045超過 45 度的樓梯會被標記為不可走Step Height0.3臺階高度大于此值會需要繞路實際踩坑點在于烘焙完之后敵人還是會走到網(wǎng)格邊緣然后卡住。這種情況多半是目標點玩家位置在 NavMesh 外面——比如玩家站在一個未烘焙的平臺上NavMesh 找不到通往目標點的路徑。處理方式是追擊時先對玩家坐標做一次NavMesh.SamplePosition把目標點拉回最近的可行走位置而不是直接塞給尋路組件。public NavMeshAgent agent; public Transform player; void Chase() { // 將目標點投影到 NavMesh 上偏移最大 2 米 if (NavMesh.SamplePosition(player.position, out NavMeshHit hit, 2f, NavMesh.AllAreas)) { agent.SetDestination(hit.position); } }如果不做這一步玩家站上箱子后敵人會一直在原地打轉(zhuǎn)看起來像是在“隔空推墻”。調(diào)試這類問題的時候不要直接猜邏輯錯誤先在 Scene 視圖把NavMesh和NavMeshAgent的路徑勾選顯示出來路徑的終點在哪一眼就能看到。4.3 傷害判定與命中反饋為什么子彈“沒打中”敵人的碰撞體、武器的射線檢測、傷害接口三者要能對接上需要提前定好 Layer。這套工程的做法是敵人放在Enemy層玩家放在Player層射線檢測時只檢測 Enemy 層避免子彈打到自己和友方單位。[SerializeField] LayerMask enemyLayer; void Fire() { if (Physics.Raycast(ray, out RaycastHit hit, range, enemyLayer)) { if (hit.collider.TryGetComponentIDamageable(out IDamageable target)) target.TakeDamage(damage); } }這里有一個常見的“沒打中”假象子彈確實碰到了敵人的碰撞體但傷害接口掛在敵人根節(jié)點上而射線碰到的碰撞體在子節(jié)點比如手臂GetComponent只能拿到子節(jié)點自己的組件接口自然就調(diào)不到。解決方式有兩個要么在子節(jié)點上也掛傷害接口并轉(zhuǎn)發(fā)給根節(jié)點要么用GetComponentInParent向上查找。我會在碰撞體子物體上放一個空腳本轉(zhuǎn)發(fā)因為GetComponentInParent在深層級的消耗不算小。這層問題理解了后面去做爆頭、部位傷害就順理成章——給頭部單獨掛一個碰撞體和IDamageable實現(xiàn)接口里傳入傷害倍率即可。5. 踩坑實錄五個讓角色打不出傷害的常見問題這套工程我前后跑了三遍每次重裝 Unity 版本都會踩到新坑。下面的問題不分順序全部是從實際運行中一條條記下來的有現(xiàn)象、有原因、有解法按這幾個方向排查能省下大量搜論壇的時間。5.1 運行即報 NullReferenceException現(xiàn)象打開場景點 PlayConsole 面板立刻彈出一堆NullReferenceException提示某個腳本的組件引用為空。角色站在原地不動相機無法旋轉(zhuǎn)。原因腳本 Inspector 上拖拽的引用丟失了。常見于 Unity 版本跨大版本升級比如從 2018 升到 2020序列化字段的m_FileID變化導(dǎo)致引用斷開但腳本本身還掛著。解決先把出問題的腳本組件移除再重新添加。如果工程里引用很多就用腳本批量掃描為空引用選中所有預(yù)制體后檢查每個SerializedObject的FindProperty是否有objectReferenceValue null。找到后重新拖拽賦值即可。更省事的方案是這類引用全部改成在Awake里用GetComponent獲取Inspector 只暴露數(shù)據(jù)參數(shù)不暴露對象引用。5.2 子彈對著敵人打卻沒有任何反應(yīng)現(xiàn)象準星已經(jīng)對準敵人開槍射擊動畫正常播放、彈藥正常消耗但敵人的血條紋絲不動。原因射線檢測沒有命中敵人。大概率是 Layer 過濾的問題——Physics.Raycast默認檢測所有 Layer 是沒有問題的但如果按 4.3 的做法給射線傳了enemyLayer參數(shù)而敵人的 Collider 被放到了別的 Layer比如 Default那射線就會直接穿透敵人。解決在 Inspector 里確認敵人的碰撞體所在 Layer再檢查代碼里傳入的 LayerMask 是否包含該層。調(diào)試時先用Debug.DrawRay畫一條射線看看方向和終點命中點如果和敵人位置偏差超過碰撞體半徑還要檢查射線方向是否確實是從準星中心發(fā)出的。這一步排查完順手把敵人所在 Layer 統(tǒng)一改成 Enemy。5.3 換彈動畫播完但彈藥沒補上現(xiàn)象換彈過程中彈藥顯示 0/90動畫結(jié)束后還是 0/90但后備彈藥沒有減少。原因協(xié)程里的yield return new WaitForSeconds(reloadTime)被中斷了。常見的是角色在換彈期間死亡或切換武器腳本被禁用或者 GameObject 被 SetActive(false)協(xié)程直接終止后續(xù)的補彈代碼根本沒執(zhí)行。解決換彈邏輯不能用裸協(xié)程收尾要加一個“完成標志位”。我的做法是public IEnumerator ReloadRoutine() { isReloading true; yield return new WaitForSeconds(reloadTime); if (this null || !gameObject.activeInHierarchy) yield break; // 安全校驗 currentAmmo Mathf.Min(magSize, currentAmmo reserveAmmo); isReloading false; }另外把換彈開始和補彈完成都通過UnityEvent發(fā)給 UI這樣即使協(xié)程中斷UI 也能響應(yīng)狀態(tài)變化去顯示“換彈被打斷”玩家不會產(chǎn)生“我按了 R 為什么沒反應(yīng)”的困惑。5.4 角色轉(zhuǎn)身時相機抖動畫面出現(xiàn)殘影現(xiàn)象快速左右晃動鼠標時主相機的畫面會出現(xiàn)輕微的“回擺”轉(zhuǎn)到某個角度時抖動非常明顯。原因相機旋轉(zhuǎn)沒有和角色旋轉(zhuǎn)完全同步。如果MouseLook直接掛在主相機上而主相機同時又是某個槍械子物體的父節(jié)點槍械的后坐力動畫有時會在同一幀里修改相機局部旋轉(zhuǎn)兩套旋轉(zhuǎn)邏輯疊加。解決把相機和武器徹底分離。主相機只掛 MouseLook 腳本控制旋轉(zhuǎn)武器模型掛在自己的空物體節(jié)點下用相機旋轉(zhuǎn)后LateUpdate里疊加后坐力偏移。注意LateUpdate的執(zhí)行順序永遠在Update之后這樣可以保證玩家看到的畫面是先完成視角轉(zhuǎn)動、再疊加后坐力而不是反過來。5.5 AI 卡墻角或者追出 NavMesh 邊界現(xiàn)象敵人在墻角來回走機器人導(dǎo)航路徑在 Scene 視圖里顯示為碎線有時直接走穿墻體到網(wǎng)格外面。原因NavMesh 烘焙時 Agent Radius 設(shè)置和墻體厚度不匹配。墻體邊緣如果只有 0.2 米厚而 Agent Radius 設(shè)了 0.5烘焙出來的可行走區(qū)域會自動把墻邊約 0.5 米的范圍劃為不可走敵人只能“隔空碰壁”。解決把墻體做成實體 Mesh 再烘焙不要用只有 Collider 沒有 Renderer 的隱形墻Agent Radius 調(diào)整到小于通道寬度的 1/2。如果敵人已經(jīng)出了 NavMesh說明目標點投影偏差太大參考 4.2 的NavMesh.SamplePosition把目標偏移量從 2 米縮小到 0.5 米并檢查場景中是否有懸空平臺的邊緣沒被烘焙覆蓋。6. 導(dǎo)入后的第一件事重構(gòu)目錄結(jié)構(gòu)和跑通驗證清單拿到這套 Untiy3D_FPS 工程我會建議你先花半小時重構(gòu)目錄把資源和代碼分開再把驗證清單跑一遍。很多工程“能跑”和“能改”是兩回事亂糟糟的目錄里找腳本比寫腳本更浪費時間。推薦的清理方向是四個頂級文件夾Assets/ Scripts/ -- 控制器、武器、AI、UI 全部按模塊拆子目錄 Prefabs/ -- 角色、敵人、掉落的彈藥包 Models/ -- 角色模型和武器模型 Scenes/ -- 主場景和測試場景分開搬動文件后第一件事是重新保存場景并檢查預(yù)制體的引用有沒有斷開Unity 會自動維護 GUID 引用但偶爾會漏。然后按下面的清單跑一遍冒煙測試點 Play 后 Console 無報錯相機視角能自由旋轉(zhuǎn)角色移動方向跟隨視角不會斜移加速射擊 10 發(fā)彈藥減少 10準星散射逐漸變大換彈后彈藥正確補充換彈期間無法繼續(xù)開火敵人能發(fā)現(xiàn)玩家、能追擊、進入射程后開火擊殺敵人后掉落物能正確拾取這套工程最大的價值不是那幾行代碼而是它的組織方式。從那以后我每次拿到別人的 Unity 工程都會先干三件事檢查 Layer 規(guī)劃、刪掉場景里的 Missing Script、把腳本掛載方式統(tǒng)一成GetComponent兜底。這三個習(xí)慣幫我避開了九成以上的運行時報錯。這個 FPS 包也一樣——先跑通再看結(jié)構(gòu)改出第一個屬于自己的武器再動那些參數(shù)去調(diào)手感希望幫到你。本文還有配套的精品資源點擊獲取