跳躍游戲?qū)崙?zhàn)：角色控制器、瓦片地圖與敵人AI)
做平臺(tái)跳躍游戲最容易被卡住的并不是“讓角色跳起來(lái)”這件事而是地圖是怎么鋪的、敵人是怎么動(dòng)起來(lái)的、角色碰到地面為什么不會(huì)被彈飛。很多新手照著別人的視頻敲代碼角色明明能跑能跳一旦想自己做一關(guān)就發(fā)現(xiàn) TileMap 怎么都碰撞不上敵人只會(huì)原地抖最后只能放棄。這篇文章的主角是 Godot。我會(huì)用一個(gè) 2 小時(shí)能跑通的平臺(tái)跳躍實(shí)戰(zhàn)流程把三件事徹底講明白玩家控制器怎么寫(xiě)、瓦片地圖怎么鋪才不會(huì)穿模、敵人 AI 怎么從“只會(huì)走”變成“會(huì)追蹤”。整個(gè)過(guò)程基于 Godot 4.x 的實(shí)際工程代碼可以直接復(fù)制到你的項(xiàng)目里運(yùn)行。先給一個(gè)明確判斷Godot 是目前做 2D 平臺(tái)跳躍游戲性?xún)r(jià)比最高的引擎之一。它不是“勉強(qiáng)能用來(lái)教學(xué)”而是連物理、動(dòng)畫(huà)、場(chǎng)景管理、導(dǎo)出發(fā)布都做成了完整閉環(huán)。你不需要在代碼里手寫(xiě)碰撞檢測(cè)也不需要自己管理游戲循環(huán)這2小時(shí)真正要學(xué)的是節(jié)點(diǎn)怎么組織、信號(hào)怎么通信、有限狀態(tài)機(jī)怎么落地這三件通用能力。讀完本文你會(huì)得到一個(gè)可運(yùn)行的平臺(tái)跳躍最小工程、一套瓦片地圖關(guān)卡搭建流程、一個(gè)帶巡邏與追蹤邏輯的敵人 AI 模板。這些代碼不是一次性 demo而是可以直接往正式項(xiàng)目遷移的骨架。1. 先想清楚2 小時(shí)做完到底做完什么很多人打開(kāi) Godot 會(huì)懵是因?yàn)榫庉嬈骼锶敲姘搴桶粹o不知道從哪里開(kāi)始。在動(dòng)手之前我建議把“2小時(shí)完成目標(biāo)”拆成四個(gè)驗(yàn)收點(diǎn)玩家角色可以左右移動(dòng)、跳躍、下落碰到地面不會(huì)穿透。關(guān)卡地圖是用瓦片畫(huà)出來(lái)的而不是用一個(gè)個(gè) Sprite 拼的。地圖上的平臺(tái)有真實(shí)碰撞角色能站在上面。有一個(gè)敵人平時(shí)左右巡邏玩家靠近后切換成追蹤狀態(tài)。這四個(gè)點(diǎn)對(duì)應(yīng)的是四個(gè)核心系統(tǒng)角色控制器、輸入映射、瓦片地圖 碰撞層、敵人 AI 狀態(tài)機(jī)。把這四個(gè)系統(tǒng)打通你的項(xiàng)目骨架就立住了。用 2 小時(shí)做完的含義不是“2 小時(shí)寫(xiě)完全部代碼”而是“2 小時(shí)理解并跑通最小閉環(huán)”。后面你要加雙段跳、加攻擊、加機(jī)關(guān)都是在最小閉環(huán)上做增量而已。為什么要選平臺(tái)跳躍因?yàn)樗且粋€(gè)“麻雀雖小五臟俱全”的游戲類(lèi)型。角色運(yùn)動(dòng)、物理碰撞、地圖編輯、敵人行為、動(dòng)畫(huà)切換、音效觸發(fā)這些商業(yè)游戲里最常見(jiàn)的問(wèn)題在一款平臺(tái)跳躍里全都會(huì)出現(xiàn)。你在 2 小時(shí)里踩過(guò)的坑后面做任何 2D 游戲都繞不開(kāi)。2. 基礎(chǔ)概念節(jié)點(diǎn)、場(chǎng)景、信號(hào)Godot 的三大支柱寫(xiě)代碼之前先建立一套正確的認(rèn)知模型。Godot 的一切都由三件事構(gòu)成節(jié)點(diǎn)Node、場(chǎng)景Scene、信號(hào)Signal。節(jié)點(diǎn)是最小功能單元。它有類(lèi)型比如CharacterBody2D表示“一個(gè)可以被物理移動(dòng)的角色”Sprite2D表示“顯示一張圖片”CollisionShape2D表示“一個(gè)碰撞形狀”。你在場(chǎng)景里看到的每一個(gè)東西都是節(jié)點(diǎn)。場(chǎng)景就是節(jié)點(diǎn)的組合。你可以把一個(gè)角色做成一個(gè)場(chǎng)景里面包含Sprite2D、CollisionShape2D、腳本節(jié)點(diǎn)甚至子節(jié)點(diǎn)然后用一個(gè).tscn文件保存需要的時(shí)候?qū)嵗?。這個(gè)“場(chǎng)景即預(yù)制體”的思路讓代碼復(fù)用變得非常自然。信號(hào)是節(jié)點(diǎn)之間的通信機(jī)制。當(dāng)一個(gè)事件發(fā)生時(shí)比如按鈕被按下、敵人撞到墻節(jié)點(diǎn)會(huì)發(fā)射信號(hào)其他節(jié)點(diǎn)可以監(jiān)聽(tīng)并做出反應(yīng)。它比直接對(duì)象引用更解耦是 Godot 組織代碼的核心方式。以下面這個(gè)角色身體節(jié)點(diǎn)為例Player (CharacterBody2D) ├── Sprite2D ├── CollisionShape2D └── Camera2DCharacterBody2D負(fù)責(zé)物理移動(dòng)Sprite2D負(fù)責(zé)顯示外觀CollisionShape2D決定碰撞范圍Camera2D讓鏡頭跟隨。你不需要把這些代碼寫(xiě)在一個(gè)類(lèi)里只需要把節(jié)點(diǎn)掛在場(chǎng)景樹(shù)上事情就自然分工了。這種設(shè)計(jì)帶來(lái)的好處是你改動(dòng)畫(huà)時(shí)不碰物理代碼改碰撞時(shí)不碰邏輯代碼。作為新手一開(kāi)始就建立這種分層意識(shí)后面代碼不會(huì)變成一坨漿糊。3. 環(huán)境準(zhǔn)備下載 Godot 4.x 并創(chuàng)建項(xiàng)目第一步是下載引擎。打開(kāi) Godot 官網(wǎng)下載 4.x 最新穩(wěn)定版。建議選擇標(biāo)準(zhǔn)版不需要 .NET 版因?yàn)楸疚拇a使用 GDScript不涉及 C#。解壓后雙擊可執(zhí)行文件就能打開(kāi)編輯器不需要安裝依賴(lài)也不向系統(tǒng)寫(xiě)額外配置這點(diǎn)比很多游戲引擎清爽得多。接下來(lái)創(chuàng)建項(xiàng)目。打開(kāi) Godot點(diǎn)擊“新建項(xiàng)目”New Project。項(xiàng)目名稱(chēng)填GodotPlatformer。項(xiàng)目路徑選擇一個(gè)你能找到的目錄。渲染器保持默認(rèn)Forward Plus點(diǎn)擊“創(chuàng)建”。創(chuàng)建完成后你會(huì)看到 Godot 的主編輯器。建議先把界面大致過(guò)一遍左側(cè)是場(chǎng)景面板中間是視口游戲畫(huà)面右側(cè)是檢查器面板下方是輸出面板?，F(xiàn)在不需要記所有按鈕只需要知道你要的資源在哪里可以找到。在編寫(xiě)代碼之前先配置輸入映射。平臺(tái)跳躍最少需要三個(gè)輸入動(dòng)作move_left、move_right、jump。打開(kāi)菜單欄的“項(xiàng)目” - “項(xiàng)目設(shè)置”切到“輸入映射”Input Map標(biāo)簽頁(yè)。在底部輸入動(dòng)作名點(diǎn)擊“添加”。然后為每個(gè)動(dòng)作分配快捷鍵move_left鍵盤(pán) A 或左方向鍵。move_right鍵盤(pán) D 或右方向鍵。jump空格鍵或 W 或上方向鍵。輸入映射做得好不好直接影響手感。建議把多個(gè)按鍵映射到同一個(gè)動(dòng)作上避免玩家只能用一個(gè)鍵操作。4. 玩家控制器從移動(dòng)、跳躍到下落的完整實(shí)現(xiàn)現(xiàn)在創(chuàng)建玩家角色場(chǎng)景。在文件系統(tǒng)面板右鍵點(diǎn)擊res://選擇“新建場(chǎng)景”選擇根節(jié)點(diǎn)為CharacterBody2D命名為Player。保存為player.tscn。選中Player節(jié)點(diǎn)在檢查器中添加子節(jié)點(diǎn)Sprite2D顯示角色外觀。課堂上為了方便你可以創(chuàng)建一個(gè) 32x32 的ColorRect臨時(shí)替代或者準(zhǔn)備一張小圖片。CollisionShape2D添加一個(gè)RectangleShape2D尺寸設(shè)置成 32x32位置稍微偏移到角色中心。Camera2D讓鏡頭跟隨玩家。新建腳本命名為player.gd附加到Player節(jié)點(diǎn)上。代碼如下# 文件路徑player.gd extends CharacterBody2D export var speed: float 300.0 export var jump_velocity: float -400.0 export var gravity: float 980.0 func _physics_process(delta: float) - void: # 重力只有不在地面時(shí)才累加 if not is_on_floor(): velocity.y gravity * delta # 水平方向輸入返回 -1.0 到 1.0 之間的值 var direction : Input.get_axis(move_left, move_right) if direction ! 0: velocity.x direction * speed else: # 沒(méi)有輸入時(shí)平滑減速防止角色滑冰 velocity.x move_toward(velocity.x, 0, speed) # 跳躍只允許在地面時(shí)起跳 if Input.is_action_just_pressed(jump) and is_on_floor(): velocity.y jump_velocity move_and_slide()這段代碼的核心是move_and_slide()。它做了三件事根據(jù)velocity更新位置、檢測(cè)碰撞、自動(dòng)把角色推到地面或墻上。這也是CharacterBody2D和普通Node2D最大的區(qū)別——你不需要手寫(xiě)碰撞檢測(cè)引擎已經(jīng)幫你處理了。gravity用export導(dǎo)出意味著你可以在檢查器里直接調(diào)數(shù)值。手感調(diào)優(yōu)時(shí)這幾個(gè)參數(shù)非常關(guān)鍵speed決定移動(dòng)速度建議 250 到 350。jump_velocity決定跳躍高度負(fù)數(shù)表示向上-350 到 -450 比較合適。gravity決定下落加速度900 到 1200 會(huì)讓角色“有重量感”。把腳本保存后切回場(chǎng)景把Player節(jié)點(diǎn)拖到視口中按 F6 運(yùn)行當(dāng)前場(chǎng)景。你會(huì)發(fā)現(xiàn)角色已經(jīng)能在地面上移動(dòng)和跳躍了。真正容易踩坑的地方是為什么我加了重力角色卻一直往下掉答案通常是場(chǎng)景里沒(méi)有地面或者地面沒(méi)有碰撞形狀。所以下一步就是做瓦片地圖。5. 瓦片地圖搭建TileSet 與 TileMapLayer 實(shí)戰(zhàn)Godot 4.3 之后原來(lái)的TileMap節(jié)點(diǎn)被拆分成了TileMapLayer。每個(gè)TileMapLayer只負(fù)責(zé)一層瓦片結(jié)構(gòu)更清晰。如果你的 Godot 版本還是 4.2命名仍是TileMap但概念幾乎一致。瓦片地圖的核心是TileSet資源。它定義了“有哪些瓦片”“每個(gè)瓦片多大”“哪些瓦片有碰撞”。5.1 創(chuàng)建 TileSet在文件系統(tǒng)面板中右鍵 - 新建資源選擇TileSet保存為world_tileset.tres。選中這個(gè)TileSet資源在檢查器面板中點(diǎn)擊“添加圖塊集”Add Atlas Source。點(diǎn)擊新出現(xiàn)的 sources 下的空位選擇你的瓦片圖集圖片。如果你沒(méi)有現(xiàn)成素材可以先用一張純色 PNG 或者截圖軟件做一張簡(jiǎn)單的 16x16 地面圖。設(shè)置Tile Size為 16x16 或者你的素材實(shí)際像素尺寸。這里的關(guān)鍵是圖集素材里的瓦片必須是等尺寸的格子圖。如果你的原圖是 64x64 像素的 4x4 素材那么每個(gè)瓦片尺寸應(yīng)該是 16x16。5.2 為瓦片設(shè)置物理碰撞瓦片地圖如果沒(méi)有物理形狀角色會(huì)直接穿過(guò)去。選中TileSet資源后在Physics Layers部分點(diǎn)擊“添加圖層”然后回到瓦片選擇的視圖中選中需要碰撞的瓦片點(diǎn)擊“添加碰撞多邊形”在瓦片畫(huà)布上框選碰撞區(qū)域。這一步非常容易漏。如果你發(fā)現(xiàn)地圖畫(huà)出來(lái)了但角色掉下去先檢查這個(gè)瓦片是否被分配了Physics Layer和Collision Polygon。5.3 創(chuàng)建 TileMapLayer 并繪制關(guān)卡回到主場(chǎng)景新建一個(gè)節(jié)點(diǎn)選擇TileMapLayer命名為Ground。把剛才的world_tileset.tres拖到它的Tile Set屬性中。選中Ground節(jié)點(diǎn)在工具欄上會(huì)多出瓦片繪制工具。你可以用鉛筆工具在畫(huà)布中畫(huà)出地面、平臺(tái)、墻體。繪制時(shí)建議遵循一條原則同一層的瓦片只畫(huà)同一種用途。地面層畫(huà)的是物理碰撞的磚塊裝飾層可以畫(huà)花花草草碰撞層放的是尖刺等傷害地形。不要把所有東西堆在一層否則后面做玩法邏輯時(shí)會(huì)很難處理。如果場(chǎng)景需要一個(gè)雙層結(jié)構(gòu)你可以再添加一個(gè)TileMapLayer一上一下互不干擾。# 腳本方式創(chuàng)建 TileSet 的參考寫(xiě)法可用于程序化生成 var tile_set : TileSet.new() var source : TileSetAtlasSource.new() source.texture preload(res://assets/tileset.png) source.texture_region_size Vector2i(16, 16) tile_set.add_source(source, 0)這段代碼不是必須寫(xiě)在項(xiàng)目里的但它說(shuō)明了TileSet的底層結(jié)構(gòu)一個(gè)TileSetAtlasSource對(duì)應(yīng)一張圖集texture_region_size決定瓦片切割尺寸。理解這一點(diǎn)你就知道為什么素材必須是規(guī)整網(wǎng)格圖了。5.4 驗(yàn)證碰撞效果回到Player場(chǎng)景把Player節(jié)點(diǎn)保存后在主場(chǎng)景中實(shí)例化一個(gè)Player。再給地面TileMapLayer添加一個(gè)StaticBody2D下的CollisionShape2D其實(shí)不需要瓦片地圖的 Physics Layer 會(huì)自動(dòng)產(chǎn)生碰撞體引擎會(huì)把瓦片上的碰撞多邊形合并成靜態(tài)碰撞體。這正是瓦片地圖比逐塊擺StaticBody2D高效的原因。按 F5 運(yùn)行主場(chǎng)景玩家應(yīng)該能站在瓦片地面上跳躍后能落回地面。如果你發(fā)現(xiàn)角色的腳部位置不對(duì)微調(diào)CollisionShape2D的位置即可。6. 敵人 AI從巡邏到追蹤的狀態(tài)機(jī)實(shí)現(xiàn)平臺(tái)跳躍里的敵人不需要像格斗游戲 AI 那么復(fù)雜但至少要有一個(gè)可擴(kuò)展的行為框架。這里我用一個(gè)簡(jiǎn)單的有限狀態(tài)機(jī)FSM來(lái)組織敵人行為。狀態(tài)機(jī)的思想是敵人的行為可以被劃分為若干個(gè)不重疊的狀態(tài)每個(gè)狀態(tài)有自己的一套行為邏輯狀態(tài)之間通過(guò)條件切換。平臺(tái)跳躍里最常見(jiàn)的是兩個(gè)狀態(tài)PATROL巡邏和CHASE追蹤。創(chuàng)建敵人場(chǎng)景根節(jié)點(diǎn)同樣選用CharacterBody2D保存為enemy.tscn。新建enemy.gd代碼如下# 文件路徑enemy.gd extends CharacterBody2D enum State { PATROL, CHASE } export var patrol_speed: float 80.0 export var chase_speed: float 150.0 export var detection_range: float 200.0 export var wall_check_distance: float 8.0 var state: State State.PATROL var direction: int 1 var player: Node2D func _ready() - void: # 尋找玩家建議玩家節(jié)點(diǎn)加入 player 分組 player get_tree().get_first_node_in_group(player) func _physics_process(delta: float) - void: # 判斷是否切換狀態(tài) if player and global_position.distance_to(player.global_position) detection_range: state State.CHASE else: state State.PATROL match state: State.PATROL: patrol(delta) State.CHASE: chase(delta) func patrol(delta: float) - void: velocity.x direction * patrol_speed # 檢測(cè)前方是否有墻壁 if is_on_wall(): direction * -1 # 檢測(cè)前方是否為懸崖 var target_position : global_position Vector2(direction * 20, 0) var space_state : get_world_2d().direct_space_state var query : PhysicsRayQueryParameters2D.create( global_position, target_position ) query.exclude [self] var result : space_state.intersect_ray(query) # 如果前方?jīng)]有地面就掉頭 if result.is_empty(): direction * -1 move_and_slide() func chase(delta: float) - void: if not player: return var to_player: Vector2 player.global_position - global_position direction 1 if to_player.x 0 else -1 velocity.x direction * chase_speed # 簡(jiǎn)單跳躍如果前方有障礙嘗試跳一下 if is_on_wall(): velocity.y -300.0 move_and_slide()這段代碼解釋幾個(gè)重要點(diǎn)狀態(tài)切換條件玩家與敵人距離小于detection_range時(shí)進(jìn)入追蹤。這個(gè)寫(xiě)法適合作為最小原型但實(shí)際項(xiàng)目中你可能需要“視野檢測(cè)”也就是說(shuō)敵人在玩家背后時(shí)不應(yīng)該被看到。is_on_wall()和move_and_slide()的配合當(dāng)敵人碰到墻壁時(shí)is_on_wall()會(huì)返回true因此可以安全地翻轉(zhuǎn)方向。這是平臺(tái)跳躍敵人最常用的巡邏方式。射線檢測(cè)懸崖通過(guò)PhysicsRayQueryParameters2D向敵人前方打一條射線。如果前方?jīng)]有地面說(shuō)明前面是懸崖敵人掉頭。這段代碼是巡邏 AI 的“防墜崖”關(guān)鍵。追蹤狀態(tài)的簡(jiǎn)單跳躍當(dāng)追蹤時(shí)撞到墻直接給一個(gè)向上的velocity.y讓敵人嘗試跳過(guò)障礙。這個(gè)邏輯很粗糙但它足以應(yīng)對(duì)簡(jiǎn)單地形。如果你希望敵人碰到玩家時(shí)對(duì)玩家造成傷害還需要給敵人添加一個(gè)Area2D或檢查碰撞體。最簡(jiǎn)單的做法是給敵人加一個(gè)子節(jié)點(diǎn)Area2D覆蓋敵人身體范圍然后監(jiān)聽(tīng)body_entered信號(hào)。這樣就把“敵人”和“傷害判定”解耦了。# 在 enemy.gd 中添加 func _on_damage_area_body_entered(body: Node2D) - void: if body.has_method(take_damage): body.take_damage(1)這個(gè)on_damage_area_body_entered函數(shù)可以在編輯器的信號(hào)頁(yè)簽中自動(dòng)連接也可以在代碼中手動(dòng)連接。當(dāng)敵人觸碰玩家角色時(shí)就調(diào)用玩家身上的take_damage方法。通過(guò)這種方式你新增任何“可受傷體”時(shí)只要給它加一個(gè)take_damage函數(shù)敵人邏輯完全不用改。把敵人場(chǎng)景拖入主場(chǎng)景按 F5 運(yùn)行。玩家靠近敵人時(shí)敵人會(huì)切換成追蹤離遠(yuǎn)了敵人會(huì)恢復(fù)巡邏。如果你發(fā)現(xiàn)敵人從平臺(tái)邊緣掉下去多半是patrol()里的射線邏輯沒(méi)有執(zhí)行——檢查一下射線query.exclude [self]防止射線打到敵人自己的碰撞體。7. 運(yùn)行效果與驗(yàn)證路徑寫(xiě)完代碼后你需要有一套判斷“是否成功”的驗(yàn)證方法而不是只看畫(huà)面“好像能動(dòng)”。第一層驗(yàn)證按住右鍵觀察角色是否向右移動(dòng)按空格角色是否跳躍下落是否流暢。如果角色跳得很高或很飄調(diào)低jump_velocity如果角色貼地滑行調(diào)高gravity或減小friction相關(guān)參數(shù)。第二層驗(yàn)證在地圖不同位置測(cè)試。跑過(guò)整個(gè)關(guān)卡檢查角色是否會(huì)在某些瓦片邊緣卡住跳躍后是否能落在窄平臺(tái)上。瓦片碰撞邊緣卡人是平臺(tái)跳躍最常見(jiàn)的手感問(wèn)題。遇到這種情況可以把瓦片的碰撞多邊形稍微內(nèi)縮一點(diǎn)或者在TileSet中設(shè)置瓦片的y_sort_origin和碰撞邊距。第三層驗(yàn)證把敵人放在一個(gè)平臺(tái)上看它是否來(lái)回巡邏把玩家放在detection_range內(nèi)看敵人是否會(huì)切換追蹤。如果敵人只在原地抖動(dòng)檢查direction是否有多次翻轉(zhuǎn)。注意is_on_wall()只在move_and_slide()之后才更新所以不要在同一幀內(nèi)連續(xù)翻轉(zhuǎn)兩次方向。第三層驗(yàn)證中最推薦的方式是利用 Godot 的調(diào)試面板。按 F5 運(yùn)行游戲后按 F12 打開(kāi)底部調(diào)試器切到“遠(yuǎn)程場(chǎng)景樹(shù)”你可以實(shí)時(shí)看到場(chǎng)景中每個(gè)節(jié)點(diǎn)的屬性。用這種方式檢查敵人的velocity數(shù)值是否正常、檢測(cè)范圍是否覆蓋到了玩家。很多“看不見(jiàn)的 bug”在遠(yuǎn)程場(chǎng)景樹(shù)里一眼就能看出來(lái)。8. 常見(jiàn)問(wèn)題與排查方法我把新手在做這個(gè)項(xiàng)目時(shí)最常遇到的問(wèn)題整理成一張表。遇到問(wèn)題時(shí)先按這個(gè)表逐項(xiàng)排查。問(wèn)題現(xiàn)象可能原因排查方式解決方案角色一直往下掉穿破地圖瓦片沒(méi)有物理碰撞層選中 TileSet檢查 Physics Layers 是否添加瓦片上是否有碰撞多邊形為地面瓦片添加 Physics Layer 和 Collision Polygon角色跳躍后浮空、下不來(lái)重力沒(méi)有生效檢查_(kāi)physics_process里是否調(diào)用了velocity.y gravity * delta補(bǔ)充重力累加邏輯角色左右滑冰、慣性太大沒(méi)有水平減速或減速值太小觀察松開(kāi)按鍵后velocity.x是否歸零用move_toward(velocity.x, 0, speed)調(diào)大減速速度敵人只往一個(gè)方向走不回頭掉頭邏輯沒(méi)觸發(fā)打印is_on_wall()和射線結(jié)果檢查碰撞形狀是否正常射線exclude是否錯(cuò)誤包含敵人自身敵人追蹤時(shí)速度極快或極慢chase_speed值不合理檢查chase_speed導(dǎo)出值根據(jù)游戲設(shè)計(jì)調(diào)參或者增加加速度玩家和敵人重疊時(shí)沒(méi)有傷害沒(méi)有傷害判定區(qū)檢查敵人是否有Area2D是否連接了body_entered添加Area2D并連接信號(hào)瓦片邊緣卡住角色瓦片碰撞多邊形和圖形像素不完全貼合縮放查看瓦片物理形狀在 TileSet 中微調(diào)碰撞多邊形或讓平臺(tái)邊緣使用半瓦設(shè)計(jì)這些問(wèn)題的共同點(diǎn)是它們大多不是代碼邏輯錯(cuò)而是資源、碰撞、信號(hào)連接這些“工程細(xì)節(jié)”錯(cuò)了。所以排查時(shí)不要一上來(lái)就盯著代碼先檢查節(jié)點(diǎn)結(jié)構(gòu)再檢查碰撞形狀最后看打印輸出。9. 最佳實(shí)踐與工程建議到這里核心功能已經(jīng)跑通了。但要把 demo 變成真正的項(xiàng)目還需要建立幾個(gè)工程習(xí)慣。9.1 用分組管理玩家和敵人在腳本中用get_tree().get_first_node_in_group(player)查找玩家比硬編碼場(chǎng)景引用更靈活。在 Godot 中點(diǎn)擊玩家節(jié)點(diǎn)在檢查器中設(shè)置Groups為player之后任何腳本都能通過(guò)分組找到它。同理敵人也可以統(tǒng)一放到enemies分組方便批量處理。9.2 把數(shù)值抽成導(dǎo)出變量export var speed: float 300.0允許你在檢查器中直接調(diào)整速度、重力、檢測(cè)范圍等參數(shù)不必為了調(diào)手感反復(fù)修改代碼。團(tuán)隊(duì)協(xié)作時(shí)策劃也可以直接在編輯器中調(diào)參而不用碰代碼。這是 Godot 工作流的重要體驗(yàn)。9.3 用 Autoload 管理全局狀態(tài)當(dāng)你在多個(gè)場(chǎng)景之間切換比如從主菜單進(jìn)入關(guān)卡玩家血量、金幣、關(guān)卡進(jìn)度這些數(shù)據(jù)不能隨著場(chǎng)景銷(xiāo)毀而丟失。這時(shí)可以創(chuàng)建一個(gè) Autoload 腳本比如GameState.gd在項(xiàng)目設(shè)置 - Autoload 中注冊(cè)它然后你在任何腳本中都能用GameState訪問(wèn)全局變量。平臺(tái)跳躍只是起點(diǎn)這個(gè)模式在后續(xù)做存檔、計(jì)分、設(shè)置界面時(shí)非常關(guān)鍵。9.4 物理層與碰撞層分開(kāi)Godot 的物理引擎支持多個(gè)碰撞層和碰撞掩碼。建議把玩家、敵人、地面、傷害區(qū)域分別放到不同的物理層。這樣你可以在“傷害區(qū)域”上只響應(yīng)玩家而不響應(yīng)敵人在地面上只響應(yīng)所有實(shí)體而不響應(yīng)裝飾。剛開(kāi)始也許不會(huì)出錯(cuò)但場(chǎng)景復(fù)雜后沒(méi)有合理的物理層規(guī)劃碰撞組會(huì)互相干擾。9.5 素材與代碼分離這一點(diǎn)很多新手會(huì)忽略。把瓦片素材、角色素材、音頻素材分別放在assets目錄下的子目錄中。腳本放在scripts目錄場(chǎng)景放在scenes目錄。文件命名全部用小寫(xiě)加下劃線。項(xiàng)目規(guī)模變大后你會(huì)感謝這個(gè)分類(lèi)習(xí)慣。9.6 使用版本控制Godot 項(xiàng)目本質(zhì)上就是文本文件加素材文件非常適合用 Git 管理。在項(xiàng)目根目錄初始化 Git并注意把.godot/目錄加入.gitignore這個(gè)目錄是編輯器緩存不應(yīng)該提交。版本控制不是為了“用高級(jí)工具”而是為了讓你頻繁改動(dòng)時(shí)能隨時(shí)回到“能運(yùn)行的狀態(tài)”。10. 總結(jié)與后續(xù)學(xué)習(xí)方向現(xiàn)在你已經(jīng)跑通了一個(gè)最小可玩的 Godot 平臺(tái)跳躍項(xiàng)目角色可以移動(dòng)、跳躍、下落地圖是用 TileSet 和 TileMapLayer 搭建的帶物理碰撞敵人擁有巡邏、轉(zhuǎn)向、追蹤和簡(jiǎn)單跳躍的有限狀態(tài)機(jī)行為。這套東西放到任何一個(gè) 2D 平臺(tái)跳躍項(xiàng)目里都是最基礎(chǔ)的底座。接下來(lái)有三條進(jìn)階路線按你自己的興趣選第一條是深化動(dòng)作系統(tǒng)。給玩家添加 Coyote Time離開(kāi)平臺(tái)后短暫允許跳躍、Jump Buffer跳躍鍵預(yù)輸入、可變跳躍高度這些細(xì)節(jié)會(huì)明顯提升手感。手感優(yōu)化是平臺(tái)跳躍的核心競(jìng)爭(zhēng)力值得花時(shí)間研究。第二條是擴(kuò)展關(guān)卡玩法。在 TileMapLayer 上增加更多地形類(lèi)型比如移動(dòng)平臺(tái)、單向平臺(tái)、可破壞磚塊結(jié)合信號(hào)機(jī)制制作機(jī)關(guān)和觸發(fā)器。平臺(tái)跳躍的關(guān)卡設(shè)計(jì)空間很大你可以用本文的瓦片系統(tǒng)快速搭建多個(gè)關(guān)卡原型。第三條是完善敵人 AI。給敵人增加視野錐、攻擊狀態(tài)、投擲物行為或者引入導(dǎo)航系統(tǒng)做更復(fù)雜的巡邏路徑。當(dāng)你真正理解狀態(tài)機(jī)之后擴(kuò)展新的敵人類(lèi)型只需要增加一個(gè)狀態(tài)分支而不是推倒重寫(xiě)。最后提醒一句如果你在實(shí)現(xiàn)過(guò)程中遇到 TileSet 物理碰撞不起作用的問(wèn)題不要急著懷疑引擎。Godot 的瓦片碰撞設(shè)計(jì)得很穩(wěn)定絕大多數(shù)情況是漏了某個(gè)物理層設(shè)置。把今天的排查表收藏好下次遇到類(lèi)似問(wèn)題直接對(duì)照?，F(xiàn)在打開(kāi) Godot把玩家角色先跑起來(lái)。剩下的事情代碼會(huì)告訴你下一步該做什么。建議收藏備用也需要?jiǎng)邮謱?shí)踐。 Godot 4平臺(tái)跳躍游戲?qū)崙?zhàn)：角色控制器、瓦片地圖與敵人AI
做平臺(tái)跳躍游戲最容易被卡住的并不是“讓角色跳起來(lái)”這件事而是地圖是怎么鋪的、敵人是怎么動(dòng)起來(lái)的、角色碰到地面為什么不會(huì)被彈飛。很多新手照著別人的視頻敲代碼角色明明能跑能跳一旦想自己做一關(guān)就發(fā)現(xiàn) TileMap 怎么都碰撞不上敵人只會(huì)原地抖最后只能放棄。這篇文章的主角是 Godot。我會(huì)用一個(gè) 2 小時(shí)能跑通的平臺(tái)跳躍實(shí)戰(zhàn)流程把三件事徹底講明白玩家控制器怎么寫(xiě)、瓦片地圖怎么鋪才不會(huì)穿模、敵人 AI 怎么從“只會(huì)走”變成“會(huì)追蹤”。整個(gè)過(guò)程基于 Godot 4.x 的實(shí)際工程代碼可以直接復(fù)制到你的項(xiàng)目里運(yùn)行。先給一個(gè)明確判斷Godot 是目前做 2D 平臺(tái)跳躍游戲性?xún)r(jià)比最高的引擎之一。它不是“勉強(qiáng)能用來(lái)教學(xué)”而是連物理、動(dòng)畫(huà)、場(chǎng)景管理、導(dǎo)出發(fā)布都做成了完整閉環(huán)。你不需要在代碼里手寫(xiě)碰撞檢測(cè)也不需要自己管理游戲循環(huán)這2小時(shí)真正要學(xué)的是節(jié)點(diǎn)怎么組織、信號(hào)怎么通信、有限狀態(tài)機(jī)怎么落地這三件通用能力。讀完本文你會(huì)得到一個(gè)可運(yùn)行的平臺(tái)跳躍最小工程、一套瓦片地圖關(guān)卡搭建流程、一個(gè)帶巡邏與追蹤邏輯的敵人 AI 模板。這些代碼不是一次性 demo而是可以直接往正式項(xiàng)目遷移的骨架。1. 先想清楚2 小時(shí)做完到底做完什么很多人打開(kāi) Godot 會(huì)懵是因?yàn)榫庉嬈骼锶敲姘搴桶粹o不知道從哪里開(kāi)始。在動(dòng)手之前我建議把“2小時(shí)完成目標(biāo)”拆成四個(gè)驗(yàn)收點(diǎn)玩家角色可以左右移動(dòng)、跳躍、下落碰到地面不會(huì)穿透。關(guān)卡地圖是用瓦片畫(huà)出來(lái)的而不是用一個(gè)個(gè) Sprite 拼的。地圖上的平臺(tái)有真實(shí)碰撞角色能站在上面。有一個(gè)敵人平時(shí)左右巡邏玩家靠近后切換成追蹤狀態(tài)。這四個(gè)點(diǎn)對(duì)應(yīng)的是四個(gè)核心系統(tǒng)角色控制器、輸入映射、瓦片地圖 碰撞層、敵人 AI 狀態(tài)機(jī)。把這四個(gè)系統(tǒng)打通你的項(xiàng)目骨架就立住了。用 2 小時(shí)做完的含義不是“2 小時(shí)寫(xiě)完全部代碼”而是“2 小時(shí)理解并跑通最小閉環(huán)”。后面你要加雙段跳、加攻擊、加機(jī)關(guān)都是在最小閉環(huán)上做增量而已。為什么要選平臺(tái)跳躍因?yàn)樗且粋€(gè)“麻雀雖小五臟俱全”的游戲類(lèi)型。角色運(yùn)動(dòng)、物理碰撞、地圖編輯、敵人行為、動(dòng)畫(huà)切換、音效觸發(fā)這些商業(yè)游戲里最常見(jiàn)的問(wèn)題在一款平臺(tái)跳躍里全都會(huì)出現(xiàn)。你在 2 小時(shí)里踩過(guò)的坑后面做任何 2D 游戲都繞不開(kāi)。2. 基礎(chǔ)概念節(jié)點(diǎn)、場(chǎng)景、信號(hào)Godot 的三大支柱寫(xiě)代碼之前先建立一套正確的認(rèn)知模型。Godot 的一切都由三件事構(gòu)成節(jié)點(diǎn)Node、場(chǎng)景Scene、信號(hào)Signal。節(jié)點(diǎn)是最小功能單元。它有類(lèi)型比如CharacterBody2D表示“一個(gè)可以被物理移動(dòng)的角色”Sprite2D表示“顯示一張圖片”CollisionShape2D表示“一個(gè)碰撞形狀”。你在場(chǎng)景里看到的每一個(gè)東西都是節(jié)點(diǎn)。場(chǎng)景就是節(jié)點(diǎn)的組合。你可以把一個(gè)角色做成一個(gè)場(chǎng)景里面包含Sprite2D、CollisionShape2D、腳本節(jié)點(diǎn)甚至子節(jié)點(diǎn)然后用一個(gè).tscn文件保存需要的時(shí)候?qū)嵗?。這個(gè)“場(chǎng)景即預(yù)制體”的思路讓代碼復(fù)用變得非常自然。信號(hào)是節(jié)點(diǎn)之間的通信機(jī)制。當(dāng)一個(gè)事件發(fā)生時(shí)比如按鈕被按下、敵人撞到墻節(jié)點(diǎn)會(huì)發(fā)射信號(hào)其他節(jié)點(diǎn)可以監(jiān)聽(tīng)并做出反應(yīng)。它比直接對(duì)象引用更解耦是 Godot 組織代碼的核心方式。以下面這個(gè)角色身體節(jié)點(diǎn)為例Player (CharacterBody2D) ├── Sprite2D ├── CollisionShape2D └── Camera2DCharacterBody2D負(fù)責(zé)物理移動(dòng)Sprite2D負(fù)責(zé)顯示外觀CollisionShape2D決定碰撞范圍Camera2D讓鏡頭跟隨。你不需要把這些代碼寫(xiě)在一個(gè)類(lèi)里只需要把節(jié)點(diǎn)掛在場(chǎng)景樹(shù)上事情就自然分工了。這種設(shè)計(jì)帶來(lái)的好處是你改動(dòng)畫(huà)時(shí)不碰物理代碼改碰撞時(shí)不碰邏輯代碼。作為新手一開(kāi)始就建立這種分層意識(shí)后面代碼不會(huì)變成一坨漿糊。3. 環(huán)境準(zhǔn)備下載 Godot 4.x 并創(chuàng)建項(xiàng)目第一步是下載引擎。打開(kāi) Godot 官網(wǎng)下載 4.x 最新穩(wěn)定版。建議選擇標(biāo)準(zhǔn)版不需要 .NET 版因?yàn)楸疚拇a使用 GDScript不涉及 C#。解壓后雙擊可執(zhí)行文件就能打開(kāi)編輯器不需要安裝依賴(lài)也不向系統(tǒng)寫(xiě)額外配置這點(diǎn)比很多游戲引擎清爽得多。接下來(lái)創(chuàng)建項(xiàng)目。打開(kāi) Godot點(diǎn)擊“新建項(xiàng)目”New Project。項(xiàng)目名稱(chēng)填GodotPlatformer。項(xiàng)目路徑選擇一個(gè)你能找到的目錄。渲染器保持默認(rèn)Forward Plus點(diǎn)擊“創(chuàng)建”。創(chuàng)建完成后你會(huì)看到 Godot 的主編輯器。建議先把界面大致過(guò)一遍左側(cè)是場(chǎng)景面板中間是視口游戲畫(huà)面右側(cè)是檢查器面板下方是輸出面板?，F(xiàn)在不需要記所有按鈕只需要知道你要的資源在哪里可以找到。在編寫(xiě)代碼之前先配置輸入映射。平臺(tái)跳躍最少需要三個(gè)輸入動(dòng)作move_left、move_right、jump。打開(kāi)菜單欄的“項(xiàng)目” - “項(xiàng)目設(shè)置”切到“輸入映射”Input Map標(biāo)簽頁(yè)。在底部輸入動(dòng)作名點(diǎn)擊“添加”。然后為每個(gè)動(dòng)作分配快捷鍵move_left鍵盤(pán) A 或左方向鍵。move_right鍵盤(pán) D 或右方向鍵。jump空格鍵或 W 或上方向鍵。輸入映射做得好不好直接影響手感。建議把多個(gè)按鍵映射到同一個(gè)動(dòng)作上避免玩家只能用一個(gè)鍵操作。4. 玩家控制器從移動(dòng)、跳躍到下落的完整實(shí)現(xiàn)現(xiàn)在創(chuàng)建玩家角色場(chǎng)景。在文件系統(tǒng)面板右鍵點(diǎn)擊res://選擇“新建場(chǎng)景”選擇根節(jié)點(diǎn)為CharacterBody2D命名為Player。保存為player.tscn。選中Player節(jié)點(diǎn)在檢查器中添加子節(jié)點(diǎn)Sprite2D顯示角色外觀。課堂上為了方便你可以創(chuàng)建一個(gè) 32x32 的ColorRect臨時(shí)替代或者準(zhǔn)備一張小圖片。CollisionShape2D添加一個(gè)RectangleShape2D尺寸設(shè)置成 32x32位置稍微偏移到角色中心。Camera2D讓鏡頭跟隨玩家。新建腳本命名為player.gd附加到Player節(jié)點(diǎn)上。代碼如下# 文件路徑player.gd extends CharacterBody2D export var speed: float 300.0 export var jump_velocity: float -400.0 export var gravity: float 980.0 func _physics_process(delta: float) - void: # 重力只有不在地面時(shí)才累加 if not is_on_floor(): velocity.y gravity * delta # 水平方向輸入返回 -1.0 到 1.0 之間的值 var direction : Input.get_axis(move_left, move_right) if direction ! 0: velocity.x direction * speed else: # 沒(méi)有輸入時(shí)平滑減速防止角色滑冰 velocity.x move_toward(velocity.x, 0, speed) # 跳躍只允許在地面時(shí)起跳 if Input.is_action_just_pressed(jump) and is_on_floor(): velocity.y jump_velocity move_and_slide()這段代碼的核心是move_and_slide()。它做了三件事根據(jù)velocity更新位置、檢測(cè)碰撞、自動(dòng)把角色推到地面或墻上。這也是CharacterBody2D和普通Node2D最大的區(qū)別——你不需要手寫(xiě)碰撞檢測(cè)引擎已經(jīng)幫你處理了。gravity用export導(dǎo)出意味著你可以在檢查器里直接調(diào)數(shù)值。手感調(diào)優(yōu)時(shí)這幾個(gè)參數(shù)非常關(guān)鍵speed決定移動(dòng)速度建議 250 到 350。jump_velocity決定跳躍高度負(fù)數(shù)表示向上-350 到 -450 比較合適。gravity決定下落加速度900 到 1200 會(huì)讓角色“有重量感”。把腳本保存后切回場(chǎng)景把Player節(jié)點(diǎn)拖到視口中按 F6 運(yùn)行當(dāng)前場(chǎng)景。你會(huì)發(fā)現(xiàn)角色已經(jīng)能在地面上移動(dòng)和跳躍了。真正容易踩坑的地方是為什么我加了重力角色卻一直往下掉答案通常是場(chǎng)景里沒(méi)有地面或者地面沒(méi)有碰撞形狀。所以下一步就是做瓦片地圖。5. 瓦片地圖搭建TileSet 與 TileMapLayer 實(shí)戰(zhàn)Godot 4.3 之后原來(lái)的TileMap節(jié)點(diǎn)被拆分成了TileMapLayer。每個(gè)TileMapLayer只負(fù)責(zé)一層瓦片結(jié)構(gòu)更清晰。如果你的 Godot 版本還是 4.2命名仍是TileMap但概念幾乎一致。瓦片地圖的核心是TileSet資源。它定義了“有哪些瓦片”“每個(gè)瓦片多大”“哪些瓦片有碰撞”。5.1 創(chuàng)建 TileSet在文件系統(tǒng)面板中右鍵 - 新建資源選擇TileSet保存為world_tileset.tres。選中這個(gè)TileSet資源在檢查器面板中點(diǎn)擊“添加圖塊集”Add Atlas Source。點(diǎn)擊新出現(xiàn)的 sources 下的空位選擇你的瓦片圖集圖片。如果你沒(méi)有現(xiàn)成素材可以先用一張純色 PNG 或者截圖軟件做一張簡(jiǎn)單的 16x16 地面圖。設(shè)置Tile Size為 16x16 或者你的素材實(shí)際像素尺寸。這里的關(guān)鍵是圖集素材里的瓦片必須是等尺寸的格子圖。如果你的原圖是 64x64 像素的 4x4 素材那么每個(gè)瓦片尺寸應(yīng)該是 16x16。5.2 為瓦片設(shè)置物理碰撞瓦片地圖如果沒(méi)有物理形狀角色會(huì)直接穿過(guò)去。選中TileSet資源后在Physics Layers部分點(diǎn)擊“添加圖層”然后回到瓦片選擇的視圖中選中需要碰撞的瓦片點(diǎn)擊“添加碰撞多邊形”在瓦片畫(huà)布上框選碰撞區(qū)域。這一步非常容易漏。如果你發(fā)現(xiàn)地圖畫(huà)出來(lái)了但角色掉下去先檢查這個(gè)瓦片是否被分配了Physics Layer和Collision Polygon。5.3 創(chuàng)建 TileMapLayer 并繪制關(guān)卡回到主場(chǎng)景新建一個(gè)節(jié)點(diǎn)選擇TileMapLayer命名為Ground。把剛才的world_tileset.tres拖到它的Tile Set屬性中。選中Ground節(jié)點(diǎn)在工具欄上會(huì)多出瓦片繪制工具。你可以用鉛筆工具在畫(huà)布中畫(huà)出地面、平臺(tái)、墻體。繪制時(shí)建議遵循一條原則同一層的瓦片只畫(huà)同一種用途。地面層畫(huà)的是物理碰撞的磚塊裝飾層可以畫(huà)花花草草碰撞層放的是尖刺等傷害地形。不要把所有東西堆在一層否則后面做玩法邏輯時(shí)會(huì)很難處理。如果場(chǎng)景需要一個(gè)雙層結(jié)構(gòu)你可以再添加一個(gè)TileMapLayer一上一下互不干擾。# 腳本方式創(chuàng)建 TileSet 的參考寫(xiě)法可用于程序化生成 var tile_set : TileSet.new() var source : TileSetAtlasSource.new() source.texture preload(res://assets/tileset.png) source.texture_region_size Vector2i(16, 16) tile_set.add_source(source, 0)這段代碼不是必須寫(xiě)在項(xiàng)目里的但它說(shuō)明了TileSet的底層結(jié)構(gòu)一個(gè)TileSetAtlasSource對(duì)應(yīng)一張圖集texture_region_size決定瓦片切割尺寸。理解這一點(diǎn)你就知道為什么素材必須是規(guī)整網(wǎng)格圖了。5.4 驗(yàn)證碰撞效果回到Player場(chǎng)景把Player節(jié)點(diǎn)保存后在主場(chǎng)景中實(shí)例化一個(gè)Player。再給地面TileMapLayer添加一個(gè)StaticBody2D下的CollisionShape2D其實(shí)不需要瓦片地圖的 Physics Layer 會(huì)自動(dòng)產(chǎn)生碰撞體引擎會(huì)把瓦片上的碰撞多邊形合并成靜態(tài)碰撞體。這正是瓦片地圖比逐塊擺StaticBody2D高效的原因。按 F5 運(yùn)行主場(chǎng)景玩家應(yīng)該能站在瓦片地面上跳躍后能落回地面。如果你發(fā)現(xiàn)角色的腳部位置不對(duì)微調(diào)CollisionShape2D的位置即可。6. 敵人 AI從巡邏到追蹤的狀態(tài)機(jī)實(shí)現(xiàn)平臺(tái)跳躍里的敵人不需要像格斗游戲 AI 那么復(fù)雜但至少要有一個(gè)可擴(kuò)展的行為框架。這里我用一個(gè)簡(jiǎn)單的有限狀態(tài)機(jī)FSM來(lái)組織敵人行為。狀態(tài)機(jī)的思想是敵人的行為可以被劃分為若干個(gè)不重疊的狀態(tài)每個(gè)狀態(tài)有自己的一套行為邏輯狀態(tài)之間通過(guò)條件切換。平臺(tái)跳躍里最常見(jiàn)的是兩個(gè)狀態(tài)PATROL巡邏和CHASE追蹤。創(chuàng)建敵人場(chǎng)景根節(jié)點(diǎn)同樣選用CharacterBody2D保存為enemy.tscn。新建enemy.gd代碼如下# 文件路徑enemy.gd extends CharacterBody2D enum State { PATROL, CHASE } export var patrol_speed: float 80.0 export var chase_speed: float 150.0 export var detection_range: float 200.0 export var wall_check_distance: float 8.0 var state: State State.PATROL var direction: int 1 var player: Node2D func _ready() - void: # 尋找玩家建議玩家節(jié)點(diǎn)加入 player 分組 player get_tree().get_first_node_in_group(player) func _physics_process(delta: float) - void: # 判斷是否切換狀態(tài) if player and global_position.distance_to(player.global_position) detection_range: state State.CHASE else: state State.PATROL match state: State.PATROL: patrol(delta) State.CHASE: chase(delta) func patrol(delta: float) - void: velocity.x direction * patrol_speed # 檢測(cè)前方是否有墻壁 if is_on_wall(): direction * -1 # 檢測(cè)前方是否為懸崖 var target_position : global_position Vector2(direction * 20, 0) var space_state : get_world_2d().direct_space_state var query : PhysicsRayQueryParameters2D.create( global_position, target_position ) query.exclude [self] var result : space_state.intersect_ray(query) # 如果前方?jīng)]有地面就掉頭 if result.is_empty(): direction * -1 move_and_slide() func chase(delta: float) - void: if not player: return var to_player: Vector2 player.global_position - global_position direction 1 if to_player.x 0 else -1 velocity.x direction * chase_speed # 簡(jiǎn)單跳躍如果前方有障礙嘗試跳一下 if is_on_wall(): velocity.y -300.0 move_and_slide()這段代碼解釋幾個(gè)重要點(diǎn)狀態(tài)切換條件玩家與敵人距離小于detection_range時(shí)進(jìn)入追蹤。這個(gè)寫(xiě)法適合作為最小原型但實(shí)際項(xiàng)目中你可能需要“視野檢測(cè)”也就是說(shuō)敵人在玩家背后時(shí)不應(yīng)該被看到。is_on_wall()和move_and_slide()的配合當(dāng)敵人碰到墻壁時(shí)is_on_wall()會(huì)返回true因此可以安全地翻轉(zhuǎn)方向。這是平臺(tái)跳躍敵人最常用的巡邏方式。射線檢測(cè)懸崖通過(guò)PhysicsRayQueryParameters2D向敵人前方打一條射線。如果前方?jīng)]有地面說(shuō)明前面是懸崖敵人掉頭。這段代碼是巡邏 AI 的“防墜崖”關(guān)鍵。追蹤狀態(tài)的簡(jiǎn)單跳躍當(dāng)追蹤時(shí)撞到墻直接給一個(gè)向上的velocity.y讓敵人嘗試跳過(guò)障礙。這個(gè)邏輯很粗糙但它足以應(yīng)對(duì)簡(jiǎn)單地形。如果你希望敵人碰到玩家時(shí)對(duì)玩家造成傷害還需要給敵人添加一個(gè)Area2D或檢查碰撞體。最簡(jiǎn)單的做法是給敵人加一個(gè)子節(jié)點(diǎn)Area2D覆蓋敵人身體范圍然后監(jiān)聽(tīng)body_entered信號(hào)。這樣就把“敵人”和“傷害判定”解耦了。# 在 enemy.gd 中添加 func _on_damage_area_body_entered(body: Node2D) - void: if body.has_method(take_damage): body.take_damage(1)這個(gè)on_damage_area_body_entered函數(shù)可以在編輯器的信號(hào)頁(yè)簽中自動(dòng)連接也可以在代碼中手動(dòng)連接。當(dāng)敵人觸碰玩家角色時(shí)就調(diào)用玩家身上的take_damage方法。通過(guò)這種方式你新增任何“可受傷體”時(shí)只要給它加一個(gè)take_damage函數(shù)敵人邏輯完全不用改。把敵人場(chǎng)景拖入主場(chǎng)景按 F5 運(yùn)行。玩家靠近敵人時(shí)敵人會(huì)切換成追蹤離遠(yuǎn)了敵人會(huì)恢復(fù)巡邏。如果你發(fā)現(xiàn)敵人從平臺(tái)邊緣掉下去多半是patrol()里的射線邏輯沒(méi)有執(zhí)行——檢查一下射線query.exclude [self]防止射線打到敵人自己的碰撞體。7. 運(yùn)行效果與驗(yàn)證路徑寫(xiě)完代碼后你需要有一套判斷“是否成功”的驗(yàn)證方法而不是只看畫(huà)面“好像能動(dòng)”。第一層驗(yàn)證按住右鍵觀察角色是否向右移動(dòng)按空格角色是否跳躍下落是否流暢。如果角色跳得很高或很飄調(diào)低jump_velocity如果角色貼地滑行調(diào)高gravity或減小friction相關(guān)參數(shù)。第二層驗(yàn)證在地圖不同位置測(cè)試。跑過(guò)整個(gè)關(guān)卡檢查角色是否會(huì)在某些瓦片邊緣卡住跳躍后是否能落在窄平臺(tái)上。瓦片碰撞邊緣卡人是平臺(tái)跳躍最常見(jiàn)的手感問(wèn)題。遇到這種情況可以把瓦片的碰撞多邊形稍微內(nèi)縮一點(diǎn)或者在TileSet中設(shè)置瓦片的y_sort_origin和碰撞邊距。第三層驗(yàn)證把敵人放在一個(gè)平臺(tái)上看它是否來(lái)回巡邏把玩家放在detection_range內(nèi)看敵人是否會(huì)切換追蹤。如果敵人只在原地抖動(dòng)檢查direction是否有多次翻轉(zhuǎn)。注意is_on_wall()只在move_and_slide()之后才更新所以不要在同一幀內(nèi)連續(xù)翻轉(zhuǎn)兩次方向。第三層驗(yàn)證中最推薦的方式是利用 Godot 的調(diào)試面板。按 F5 運(yùn)行游戲后按 F12 打開(kāi)底部調(diào)試器切到“遠(yuǎn)程場(chǎng)景樹(shù)”你可以實(shí)時(shí)看到場(chǎng)景中每個(gè)節(jié)點(diǎn)的屬性。用這種方式檢查敵人的velocity數(shù)值是否正常、檢測(cè)范圍是否覆蓋到了玩家。很多“看不見(jiàn)的 bug”在遠(yuǎn)程場(chǎng)景樹(shù)里一眼就能看出來(lái)。8. 常見(jiàn)問(wèn)題與排查方法我把新手在做這個(gè)項(xiàng)目時(shí)最常遇到的問(wèn)題整理成一張表。遇到問(wèn)題時(shí)先按這個(gè)表逐項(xiàng)排查。問(wèn)題現(xiàn)象可能原因排查方式解決方案角色一直往下掉穿破地圖瓦片沒(méi)有物理碰撞層選中 TileSet檢查 Physics Layers 是否添加瓦片上是否有碰撞多邊形為地面瓦片添加 Physics Layer 和 Collision Polygon角色跳躍后浮空、下不來(lái)重力沒(méi)有生效檢查_(kāi)physics_process里是否調(diào)用了velocity.y gravity * delta補(bǔ)充重力累加邏輯角色左右滑冰、慣性太大沒(méi)有水平減速或減速值太小觀察松開(kāi)按鍵后velocity.x是否歸零用move_toward(velocity.x, 0, speed)調(diào)大減速速度敵人只往一個(gè)方向走不回頭掉頭邏輯沒(méi)觸發(fā)打印is_on_wall()和射線結(jié)果檢查碰撞形狀是否正常射線exclude是否錯(cuò)誤包含敵人自身敵人追蹤時(shí)速度極快或極慢chase_speed值不合理檢查chase_speed導(dǎo)出值根據(jù)游戲設(shè)計(jì)調(diào)參或者增加加速度玩家和敵人重疊時(shí)沒(méi)有傷害沒(méi)有傷害判定區(qū)檢查敵人是否有Area2D是否連接了body_entered添加Area2D并連接信號(hào)瓦片邊緣卡住角色瓦片碰撞多邊形和圖形像素不完全貼合縮放查看瓦片物理形狀在 TileSet 中微調(diào)碰撞多邊形或讓平臺(tái)邊緣使用半瓦設(shè)計(jì)這些問(wèn)題的共同點(diǎn)是它們大多不是代碼邏輯錯(cuò)而是資源、碰撞、信號(hào)連接這些“工程細(xì)節(jié)”錯(cuò)了。所以排查時(shí)不要一上來(lái)就盯著代碼先檢查節(jié)點(diǎn)結(jié)構(gòu)再檢查碰撞形狀最后看打印輸出。9. 最佳實(shí)踐與工程建議到這里核心功能已經(jīng)跑通了。但要把 demo 變成真正的項(xiàng)目還需要建立幾個(gè)工程習(xí)慣。9.1 用分組管理玩家和敵人在腳本中用get_tree().get_first_node_in_group(player)查找玩家比硬編碼場(chǎng)景引用更靈活。在 Godot 中點(diǎn)擊玩家節(jié)點(diǎn)在檢查器中設(shè)置Groups為player之后任何腳本都能通過(guò)分組找到它。同理敵人也可以統(tǒng)一放到enemies分組方便批量處理。9.2 把數(shù)值抽成導(dǎo)出變量export var speed: float 300.0允許你在檢查器中直接調(diào)整速度、重力、檢測(cè)范圍等參數(shù)不必為了調(diào)手感反復(fù)修改代碼。團(tuán)隊(duì)協(xié)作時(shí)策劃也可以直接在編輯器中調(diào)參而不用碰代碼。這是 Godot 工作流的重要體驗(yàn)。9.3 用 Autoload 管理全局狀態(tài)當(dāng)你在多個(gè)場(chǎng)景之間切換比如從主菜單進(jìn)入關(guān)卡玩家血量、金幣、關(guān)卡進(jìn)度這些數(shù)據(jù)不能隨著場(chǎng)景銷(xiāo)毀而丟失。這時(shí)可以創(chuàng)建一個(gè) Autoload 腳本比如GameState.gd在項(xiàng)目設(shè)置 - Autoload 中注冊(cè)它然后你在任何腳本中都能用GameState訪問(wèn)全局變量。平臺(tái)跳躍只是起點(diǎn)這個(gè)模式在后續(xù)做存檔、計(jì)分、設(shè)置界面時(shí)非常關(guān)鍵。9.4 物理層與碰撞層分開(kāi)Godot 的物理引擎支持多個(gè)碰撞層和碰撞掩碼。建議把玩家、敵人、地面、傷害區(qū)域分別放到不同的物理層。這樣你可以在“傷害區(qū)域”上只響應(yīng)玩家而不響應(yīng)敵人在地面上只響應(yīng)所有實(shí)體而不響應(yīng)裝飾。剛開(kāi)始也許不會(huì)出錯(cuò)但場(chǎng)景復(fù)雜后沒(méi)有合理的物理層規(guī)劃碰撞組會(huì)互相干擾。9.5 素材與代碼分離這一點(diǎn)很多新手會(huì)忽略。把瓦片素材、角色素材、音頻素材分別放在assets目錄下的子目錄中。腳本放在scripts目錄場(chǎng)景放在scenes目錄。文件命名全部用小寫(xiě)加下劃線。項(xiàng)目規(guī)模變大后你會(huì)感謝這個(gè)分類(lèi)習(xí)慣。9.6 使用版本控制Godot 項(xiàng)目本質(zhì)上就是文本文件加素材文件非常適合用 Git 管理。在項(xiàng)目根目錄初始化 Git并注意把.godot/目錄加入.gitignore這個(gè)目錄是編輯器緩存不應(yīng)該提交。版本控制不是為了“用高級(jí)工具”而是為了讓你頻繁改動(dòng)時(shí)能隨時(shí)回到“能運(yùn)行的狀態(tài)”。10. 總結(jié)與后續(xù)學(xué)習(xí)方向現(xiàn)在你已經(jīng)跑通了一個(gè)最小可玩的 Godot 平臺(tái)跳躍項(xiàng)目角色可以移動(dòng)、跳躍、下落地圖是用 TileSet 和 TileMapLayer 搭建的帶物理碰撞敵人擁有巡邏、轉(zhuǎn)向、追蹤和簡(jiǎn)單跳躍的有限狀態(tài)機(jī)行為。這套東西放到任何一個(gè) 2D 平臺(tái)跳躍項(xiàng)目里都是最基礎(chǔ)的底座。接下來(lái)有三條進(jìn)階路線按你自己的興趣選第一條是深化動(dòng)作系統(tǒng)。給玩家添加 Coyote Time離開(kāi)平臺(tái)后短暫允許跳躍、Jump Buffer跳躍鍵預(yù)輸入、可變跳躍高度這些細(xì)節(jié)會(huì)明顯提升手感。手感優(yōu)化是平臺(tái)跳躍的核心競(jìng)爭(zhēng)力值得花時(shí)間研究。第二條是擴(kuò)展關(guān)卡玩法。在 TileMapLayer 上增加更多地形類(lèi)型比如移動(dòng)平臺(tái)、單向平臺(tái)、可破壞磚塊結(jié)合信號(hào)機(jī)制制作機(jī)關(guān)和觸發(fā)器。平臺(tái)跳躍的關(guān)卡設(shè)計(jì)空間很大你可以用本文的瓦片系統(tǒng)快速搭建多個(gè)關(guān)卡原型。第三條是完善敵人 AI。給敵人增加視野錐、攻擊狀態(tài)、投擲物行為或者引入導(dǎo)航系統(tǒng)做更復(fù)雜的巡邏路徑。當(dāng)你真正理解狀態(tài)機(jī)之后擴(kuò)展新的敵人類(lèi)型只需要增加一個(gè)狀態(tài)分支而不是推倒重寫(xiě)。最后提醒一句如果你在實(shí)現(xiàn)過(guò)程中遇到 TileSet 物理碰撞不起作用的問(wèn)題不要急著懷疑引擎。Godot 的瓦片碰撞設(shè)計(jì)得很穩(wěn)定絕大多數(shù)情況是漏了某個(gè)物理層設(shè)置。把今天的排查表收藏好下次遇到類(lèi)似問(wèn)題直接對(duì)照?，F(xiàn)在打開(kāi) Godot把玩家角色先跑起來(lái)。剩下的事情代碼會(huì)告訴你下一步該做什么。建議收藏備用也需要?jiǎng)邮謱?shí)踐。