1. 項(xiàng)目概述為什么要在Lyra里折騰淘汰賽如果你正在看這篇文章大概率是和我一樣被UE5 Lyra這個(gè)官方示例項(xiàng)目給“迷住”了。它就像一個(gè)官方出品的、五臟俱全的“游戲框架樣板間”里面塞滿了Gameplay Ability SystemGAS、Experience、Game Feature Plugin等現(xiàn)代UE5游戲開發(fā)的核心模塊。但樣板間終究是樣板間我們得學(xué)會(huì)怎么在里面“裝修”甚至“加蓋樓層”。今天要聊的就是基于Lyra的Experience和控件模式Control Mode從零開始搭建一個(gè)淘汰賽模式。聽起來有點(diǎn)復(fù)雜別怕我們一步步來。淘汰賽模式的核心邏輯其實(shí)很清晰多個(gè)玩家或隊(duì)伍同場競技被擊敗即出局直到?jīng)Q出最后的勝者。但在Lyra的框架下實(shí)現(xiàn)它難點(diǎn)不在于這個(gè)邏輯本身而在于如何優(yōu)雅地、符合Lyra設(shè)計(jì)哲學(xué)地將這個(gè)邏輯“嵌入”到現(xiàn)有的Experience系統(tǒng)中。這涉及到如何利用Lyra的控件模式來管理玩家在不同階段如準(zhǔn)備、戰(zhàn)斗、觀戰(zhàn)、結(jié)算的輸入和視角如何通過Experience的Action來動(dòng)態(tài)加載和卸載游戲規(guī)則以及如何與Lyra已有的隊(duì)伍、重生、傷害系統(tǒng)進(jìn)行對接。我之所以花時(shí)間研究這個(gè)是因?yàn)槲野l(fā)現(xiàn)很多教程只講Lyra的單個(gè)模塊比如GAS怎么用或者Experience怎么配置但很少告訴你如何把這些模塊像樂高一樣組合起來去實(shí)現(xiàn)一個(gè)具體的、復(fù)雜的游戲模式。而淘汰賽恰好是一個(gè)能串聯(lián)起Experience生命周期、玩家狀態(tài)管理、UI交互和游戲規(guī)則邏輯的絕佳練手項(xiàng)目。通過它你能深刻理解Lyra框架下“狀態(tài)驅(qū)動(dòng)”和“模塊化”的設(shè)計(jì)思想這比你單純看文檔要實(shí)在得多。2. 核心思路拆解用Experience和控件模式搭建游戲流程骨架在動(dòng)手寫一行代碼之前我們必須把Lyra處理游戲模式的思路吃透。傳統(tǒng)UE項(xiàng)目里我們可能習(xí)慣在GameMode藍(lán)圖里寫一大堆邏輯。但在Lyra里GameMode更像一個(gè)“空殼”或“協(xié)調(diào)者”真正的游戲規(guī)則被拆解到了Experience體驗(yàn)和與之關(guān)聯(lián)的Game Feature Plugin游戲功能插件中。2.1 Lyra Experience你的游戲規(guī)則集裝箱你可以把Experience理解為一個(gè)游戲模式的“定義文件”或“配置清單”。一個(gè)Lyra Experience資產(chǎn)LyraExperienceDefinition里主要包含兩大部分要加載的游戲功能插件Game Feature Plugins這是模塊化的游戲玩法。比如Lyra自帶了ShooterCore射擊核心、TopDownArena俯視角競技場等插件。我們的淘汰賽規(guī)則最終也會(huì)打包成一個(gè)獨(dú)立的Game Feature Plugin。要執(zhí)行的Action列表Actions這是在Experience加載過程中或加載后執(zhí)行的一系列操作。這是關(guān)鍵我們可以通過編寫自定義的Action在特定時(shí)機(jī)做特定的事例如AddComponents給Pawn或PlayerState添加組件比如給我們淘汰賽管理者組件。Grant Abilities和Grant Gameplay Effects給玩家授予能力和效果。Apply Gameplay Effect to Self給自己應(yīng)用一個(gè)效果。Change Control Mode改變玩家的控件模式這是我們實(shí)現(xiàn)狀態(tài)切換的核心。我們的淘汰賽模式本質(zhì)上就是創(chuàng)建一個(gè)新的Experience。在這個(gè)Experience里我們會(huì)引用Lyra基礎(chǔ)的功能插件如ShooterCore提供射擊和移動(dòng)能力。創(chuàng)建一個(gè)我們自己的Game Feature Plugin比如叫EliminationTournament里面包含淘汰賽的核心邏輯組件和UI。在Experience的Action列表中精心編排一系列Action來初始化淘汰賽、設(shè)置初始控件模式、并在比賽過程中根據(jù)事件如玩家死亡觸發(fā)模式切換。2.2 控件模式管理玩家輸入與視角的“狀態(tài)機(jī)”控件模式是Lyra中一個(gè)非常精巧的設(shè)計(jì)它抽象了玩家在游戲中的不同“狀態(tài)”。每個(gè)控件模式定義了輸入映射Input Mapping當(dāng)前狀態(tài)下玩家可以按哪些鍵這些鍵觸發(fā)什么操作。鼠標(biāo)行為Mouse Behavior鼠標(biāo)是鎖定在屏幕中心、自由移動(dòng)、還是隱藏。視角目標(biāo)View Target玩家看哪里是自己的Pawn還是另一個(gè)Actor比如觀戰(zhàn)時(shí)的其他玩家Lyra內(nèi)置了幾種控件模式例如Living活著時(shí)的模式可以移動(dòng)、射擊。Death死亡時(shí)的模式通常限制移動(dòng)但可以旋轉(zhuǎn)視角可能彈出死亡UI。Spectating觀戰(zhàn)模式可以自由切換觀看目標(biāo)。UIOnly僅UI模式游戲畫面暫?；蚰：裹c(diǎn)全在UI上用于主菜單、商店。對于淘汰賽我們需要定義自己的控件模式或者復(fù)用并擴(kuò)展內(nèi)置模式。例如Elimination_Waiting比賽開始前的等待模式。玩家可能被限制在一個(gè)準(zhǔn)備區(qū)只能移動(dòng)和簡單交互不能攻擊。Elimination_Living比賽中的生存模式。繼承自Living但可能附加一些淘汰賽特有的UI如剩余玩家數(shù)。Elimination_Eliminated被淘汰后的模式。這比普通的Death更復(fù)雜玩家可能需要進(jìn)入“幽靈觀戰(zhàn)”狀態(tài)可以自由飛行觀看其他玩家戰(zhàn)斗并有一個(gè)專屬的淘汰賽結(jié)算UI顯示自己的排名。Elimination_Results整場比賽結(jié)束后的結(jié)算模式。所有玩家進(jìn)入一個(gè)展示排行榜、播放勝利動(dòng)畫的界面。為什么這么設(shè)計(jì)因?yàn)榭丶Ｊ綄ⅰ巴婕夷茏鍪裁础焙汀巴婕铱吹绞裁础边@兩個(gè)關(guān)注點(diǎn)從雜亂的游戲邏輯中剝離出來。當(dāng)玩家狀態(tài)改變時(shí)如從“活著”變?yōu)椤氨惶蕴蔽覀冎恍枰{(diào)用一句Set Control Mode輸入、視角、UI都會(huì)自動(dòng)切換到對應(yīng)的配置代碼清晰且易于維護(hù)。2.3 淘汰賽流程與狀態(tài)轉(zhuǎn)換結(jié)合Experience的Action和控件模式我們可以勾勒出淘汰賽的完整流程Experience加載游戲開始Action:AddComponents- 給游戲狀態(tài)GameState添加一個(gè)EliminationTournamentComponent淘汰賽管理器。Action:Change Control Mode- 將所有玩家初始設(shè)置為Elimination_Waiting模式。管理器初始化讀取玩家列表分配唯一ID初始化排行榜設(shè)置初始倒計(jì)時(shí)。準(zhǔn)備階段Waiting玩家處于Elimination_Waiting模式可以在準(zhǔn)備區(qū)自由移動(dòng)、跳躍但武器被禁用。UI顯示“比賽即將開始剩余X秒”。倒計(jì)時(shí)結(jié)束管理器廣播事件OnTournamentStart。戰(zhàn)斗階段Living事件觸發(fā)Action或管理器直接調(diào)用將所有玩家的控件模式切換為Elimination_Living。玩家武器被啟用可以互相攻擊。管理器開始監(jiān)聽所有玩家的OnDeath事件。玩家淘汰Eliminated當(dāng)玩家Pawn的Death標(biāo)簽被添加Lyra GAS機(jī)制時(shí)EliminationTournamentComponent捕獲該事件。管理器記錄該玩家淘汰時(shí)間更新排行榜。將該玩家的控件模式切換為Elimination_Eliminated。檢查剩余存活玩家數(shù)。如果只剩1人進(jìn)入結(jié)算階段。結(jié)算階段Results管理器廣播OnTournamentEnd事件。將所有存活玩家的控件模式切換為Elimination_Results。將所有已被淘汰玩家的控件模式也從Eliminated切換為Results讓他們也能看到最終排名。展示最終排行榜、播放冠軍動(dòng)畫、提供“返回大廳”或“再來一局”的選項(xiàng)。這個(gè)流程的核心驅(qū)動(dòng)力是事件。Experience的Action、玩家死亡事件、定時(shí)器事件它們觸發(fā)狀態(tài)改變而狀態(tài)改變直接體現(xiàn)為控件模式的切換。3. 實(shí)戰(zhàn)搭建一步步創(chuàng)建淘汰賽Experience理論說完了我們進(jìn)入實(shí)戰(zhàn)。假設(shè)你已經(jīng)有了一個(gè)可運(yùn)行的Lyra項(xiàng)目建議從Epic Games Launcher下載官方示例。我們將從創(chuàng)建Game Feature Plugin開始。3.1 創(chuàng)建淘汰賽游戲功能插件在UE編輯器中打開Tools-New Plugin。選擇Game Feature模板給它起個(gè)名字比如EliminationTournament。確保Show in Content Browser勾選這樣我們才能在內(nèi)容瀏覽器里看到它的內(nèi)容。點(diǎn)擊Create。UE會(huì)在你的項(xiàng)目Plugins目錄下生成這個(gè)插件并自動(dòng)打開插件的內(nèi)容文件夾通常為/Game/EliminationTournament。為什么用Game Feature Plugin因?yàn)樗峁┝送昝赖母綦x性。淘汰賽的所有資產(chǎn)藍(lán)圖、UI、數(shù)據(jù)表和代碼都可以放在這個(gè)插件里。未來你想在其他項(xiàng)目或用例中復(fù)用這個(gè)模式直接遷移整個(gè)插件即可不會(huì)污染主項(xiàng)目代碼。3.2 設(shè)計(jì)核心數(shù)據(jù)資產(chǎn)與組件在動(dòng)手寫邏輯前先設(shè)計(jì)好數(shù)據(jù)結(jié)構(gòu)。創(chuàng)建淘汰賽設(shè)置數(shù)據(jù)資產(chǎn)Data Asset在插件內(nèi)容目錄下右鍵Miscellaneous-Data Asset。選擇EliminationTournamentSettings作為父類這個(gè)類需要我們先創(chuàng)建。這個(gè)數(shù)據(jù)資產(chǎn)用于配置一局淘汰賽的參數(shù)例如PrepareTime準(zhǔn)備階段時(shí)長秒。MaxPlayers最大玩家數(shù)。RespawnAllowed是否允許復(fù)活在淘汰賽中通常為false。WinCondition勝利條件枚舉如LastManStanding個(gè)人賽LastTeamStanding團(tuán)隊(duì)賽。將其命名為DA_Elimination_Default。創(chuàng)建淘汰賽管理器組件Component這個(gè)組件應(yīng)該附加到GameState上因?yàn)樗枰獧?quán)威地管理全局比賽狀態(tài)。你可以用C創(chuàng)建EliminationTournamentComponent類繼承自UActorComponent。如果只用藍(lán)圖可以創(chuàng)建GameStateComponent的子類藍(lán)圖。關(guān)鍵屬性TournamentSettings指向我們上面創(chuàng)建的DA_Elimination_Default。CurrentState當(dāng)前比賽狀態(tài)枚舉Waiting, InProgress, Finished。AlivePlayers存活玩家ID或Controller的數(shù)組。EliminatedPlayers被淘汰玩家信息的數(shù)組包含玩家ID、淘汰時(shí)間、排名。TournamentStartTime比賽開始的世界時(shí)間。關(guān)鍵函數(shù)/事件OnPlayerEliminated(PlayerState)當(dāng)玩家死亡時(shí)調(diào)用。CheckWinCondition()檢查是否滿足結(jié)束條件。StartTournament()從準(zhǔn)備階段過渡到戰(zhàn)斗階段。FinishTournament(Winner)結(jié)束比賽進(jìn)入結(jié)算。創(chuàng)建玩家淘汰賽狀態(tài)組件Component附加到PlayerState上用于存儲(chǔ)玩家個(gè)人的淘汰賽相關(guān)數(shù)據(jù)。屬性如bIsEliminated,EliminationTime,CurrentRank。這樣設(shè)計(jì)符合Lyra的架構(gòu)將個(gè)人狀態(tài)與全局狀態(tài)分離。3.3 定義自定義控件模式Lyra的控件模式定義在LyraPawnData資產(chǎn)里。我們需要擴(kuò)展它。找到或創(chuàng)建PawnData在Lyra內(nèi)容中搜索LyraPawnData通常有一個(gè)PDA_Default。為了不影響原版最好復(fù)制一份到我們的插件目錄重命名為PDA_Elimination。添加自定義控件模式在PDA_Elimination的Control Modes數(shù)組里添加新的條目。Elimination_Waiting:Input Mapping: 可以復(fù)用Living的映射但我們需要在后續(xù)的Ability中禁用武器輸入?；蛘邉?chuàng)建一個(gè)刪除了武器相關(guān)Action的專屬輸入映射。Mouse Behavior:ConstrainedAndHidden游戲內(nèi)標(biāo)準(zhǔn)模式。View Target:ViewTarget_Pawn看自己的Pawn。Elimination_Eliminated:Input Mapping: 需要一個(gè)新的映射IMC_Spectator包含切換觀戰(zhàn)目標(biāo)如上一玩家/下一玩家、自由飛行等操作。Mouse Behavior:ConstrainedAndHidden或ConstrainedOnly取決于你是否要顯示鼠標(biāo)來操作UI。View Target:ViewTarget_Spectator一個(gè)可以附著在其他Pawn上或自由移動(dòng)的Spectator Pawn。Elimination_Results:Input Mapping:IMC_UIOnly只保留確認(rèn)、返回等UI操作。Mouse Behavior:FreeAndVisible鼠標(biāo)可見用于操作UI。View Target: 可以是一個(gè)固定的攝像機(jī)Actor拍攝領(lǐng)獎(jiǎng)臺(tái)場景。注意創(chuàng)建新的輸入映射上下文Input Mapping Context, IMC是必須的。你需要在項(xiàng)目設(shè)置中定義新的輸入Action如NextSpectator,PrevSpectator然后在新的IMC里將這些Action映射到按鍵。3.4 構(gòu)建淘汰賽Experience資產(chǎn)這是將所有部分串聯(lián)起來的“總指揮”。在插件內(nèi)容目錄右鍵Miscellaneous-Experience Definition創(chuàng)建XP_EliminationTournament。Game Feature Plugins添加ShooterCore基礎(chǔ)射擊功能和我們剛創(chuàng)建的EliminationTournament插件。Actions這是重頭戲按順序添加Action 1: Add ComponentsTarget:GameStateComponent Class: 選擇我們創(chuàng)建的EliminationTournamentComponent。這一步在游戲一開始就把我們的比賽管理器掛載到GameState上。Action 2: Apply Gameplay Effect to SelfTarget:Pawn(或PlayerState)Gameplay Effect: 選擇一個(gè)用于初始化或重置玩家狀態(tài)的效果。例如一個(gè)清除上一局遺留負(fù)面效果、重置血量的GE。Action 3: Change Control ModeTarget:PawnControl Mode:Elimination_Waiting這一步將所有玩家初始狀態(tài)設(shè)為等待。Action 4: Grant Abilities(可選用于等待階段)Target:Pawn授予一些僅限于等待階段的能力比如一個(gè)GA_DisableWeapon它監(jiān)聽輸入但阻止武器開火。Action 5: 自定義Action (Start Tournament Timer)我們需要一個(gè)自定義的Action來啟動(dòng)管理器的準(zhǔn)備階段倒計(jì)時(shí)。這通常需要你編寫一個(gè)C的UGameFeatureAction子類比如GameFeatureAction_StartTournamentTimer它在執(zhí)行時(shí)獲取GameState上的EliminationTournamentComponent并調(diào)用StartPreparationTimer函數(shù)。然后將這個(gè)Action類配置到Experience中。如何讓Experience生效在Lyra中通常通過LyraFrontEnd地圖的UI來選擇Experience或者通過游戲?qū)嵗鼼ameInstance設(shè)置默認(rèn)Experience。對于測試最簡單的方法是在世界設(shè)置World Settings里將GameMode覆蓋為LyraGameMode并在LyraGameMode的Default Experience屬性中直接引用我們創(chuàng)建的XP_EliminationTournament。4. 核心邏輯實(shí)現(xiàn)詳解狀態(tài)同步與事件驅(qū)動(dòng)有了骨架現(xiàn)在需要填充肌肉和神經(jīng)——也就是讓各個(gè)部分動(dòng)起來的邏輯。4.1 淘汰賽管理器的網(wǎng)絡(luò)同步EliminationTournamentComponent必須運(yùn)行在服務(wù)器上并且關(guān)鍵狀態(tài)需要同步到所有客戶端。在C類中使用Replicated宏標(biāo)記需要同步的變量如CurrentStateAlivePlayersEliminatedPlayers。重寫GetLifetimeReplicatedProps函數(shù)使用DOREPLIFETIME注冊這些變量。對于事件如OnTournamentStart可以使用多播RPCUFUNCTION(NetMulticast, Reliable)來通知所有客戶端。// 示例頭文件聲明 UPROPERTY(ReplicatedUsingOnRep_CurrentState) ETournamentState CurrentState; UFUNCTION() void OnRep_CurrentState(); UFUNCTION(NetMulticast, Reliable) void Multicast_OnTournamentStarted(); // 在cpp中實(shí)現(xiàn)復(fù)制 void UEliminationTournamentComponent::GetLifetimeReplicatedProps(TArrayFLifetimeProperty OutLifetimeProps) const { Super::GetLifetimeReplicatedProps(OutLifetimeProps); DOREPLIFETIME(UEliminationTournamentComponent, CurrentState); // ... 其他變量 }4.2 監(jiān)聽玩家死亡事件這是淘汰賽運(yùn)轉(zhuǎn)的觸發(fā)器。在Lyra中玩家死亡通常通過GAS的GameplayTag來標(biāo)識(shí)。在淘汰賽管理器初始化時(shí)BeginPlay遍歷所有玩家控制器或PlayerState。為每個(gè)玩家的Pawn或ASCAbility System Component添加一個(gè)GameplayTag事件監(jiān)聽器監(jiān)聽State.Dead標(biāo)簽。// 偽代碼 if (PlayerASC) { PlayerASC-RegisterGameplayTagEvent(GameplayTags.State_Dead, EGameplayTagEventType::NewOrRemoved).AddUObject(this, UEliminationTournamentComponent::OnPlayerDeathTagChanged); }在回調(diào)函數(shù)OnPlayerDeathTagChanged中當(dāng)檢測到State.Dead被添加New時(shí)調(diào)用OnPlayerEliminated函數(shù)。重要細(xì)節(jié)確保在玩家重生或離開時(shí)移除監(jiān)聽器防止內(nèi)存泄漏和錯(cuò)誤回調(diào)。4.3 控件模式的權(quán)威切換控件模式的切換必須在服務(wù)器端進(jìn)行然后同步到客戶端。Lyra提供了Set Control Mode的RPC。在淘汰賽管理器中當(dāng)事件觸發(fā)如玩家淘汰、比賽開始服務(wù)器調(diào)用目標(biāo)PlayerController上的函數(shù)來改變控件模式。Lyra的PlayerController通常有一個(gè)LyraPlayerController組件或接口來處理這個(gè)。你需要找到正確的方法。通常模式是if (ALyraPlayerController* LyraPC CastALyraPlayerController(PlayerController)) { if (ULyraHeroComponent* HeroComponent LyraPC-GetHeroComponent()) { HeroComponent-SetControlMode(TargetControlMode); } }客戶端接收到模式切換指令后會(huì)更新本地輸入映射和視角邏輯。4.4 UI與數(shù)據(jù)的綁定淘汰賽需要專屬的UI來顯示倒計(jì)時(shí)、存活人數(shù)、排行榜。創(chuàng)建UI控件在插件內(nèi)創(chuàng)建W_EliminationHUD用于游戲內(nèi)信息和W_EliminationResults用于結(jié)算。數(shù)據(jù)綁定UI需要實(shí)時(shí)反映管理器的數(shù)據(jù)。使用Lyra常用的CommonGame模塊中的GameStateComponent觀察者模式或簡單的定時(shí)查詢。在UI的NativeConstruct中獲取游戲世界的GameState然后找到EliminationTournamentComponent。將組件的屬性如AlivePlayersCount綁定到UI文本的更新事件上。對于需要復(fù)雜列表的排行榜可以監(jiān)聽EliminatedPlayers數(shù)組的復(fù)制回調(diào)OnRep然后刷新UI列表。模式切換與UI當(dāng)控件模式切換到Elimination_Eliminated時(shí)可以觸發(fā)顯示W(wǎng)_EliminationResults個(gè)人淘汰視圖并隱藏W_EliminationHUD。這可以通過控件模式關(guān)聯(lián)的UI Action來實(shí)現(xiàn)也可以在PlayerController中根據(jù)當(dāng)前控件模式主動(dòng)管理UI的顯示隱藏。5. 配置流程全記錄與避坑指南讓我們從頭到尾以一個(gè)新項(xiàng)目的視角過一遍完整的配置和測試流程。這里會(huì)遇到很多坑我會(huì)把關(guān)鍵步驟和注意事項(xiàng)標(biāo)出來。5.1 環(huán)境準(zhǔn)備與插件創(chuàng)建獲取并打開Lyra項(xiàng)目從Epic Games啟動(dòng)器下載“Lyra Game”示例項(xiàng)目。用UE5.1或更高版本打開。創(chuàng)建插件打開編輯器Tools-New Plugin-Game Feature命名為EliminationTournament?？狱c(diǎn)1創(chuàng)建后務(wù)必重啟編輯器或者至少點(diǎn)擊Tools-Reload Project否則插件模塊可能無法正確加載導(dǎo)致你找不到新建的類。啟用插件在Edit-Plugins中確保EliminationTournament插件已啟用。5.2 數(shù)據(jù)與組件創(chuàng)建藍(lán)圖路徑假設(shè)我們主要使用藍(lán)圖C部分僅作概念參考。創(chuàng)建數(shù)據(jù)結(jié)構(gòu)在插件內(nèi)容瀏覽器創(chuàng)建Data Asset父類選擇DataAsset先創(chuàng)建基礎(chǔ)資產(chǎn)。創(chuàng)建藍(lán)圖類BP_EliminationSettings添加需要的配置變量?？狱c(diǎn)2DataAsset本身只是一個(gè)容器你需要先創(chuàng)建一個(gè)繼承自DataAsset的藍(lán)圖類才能添加自定義變量。直接創(chuàng)建的Data Asset是空的實(shí)例。創(chuàng)建管理器組件創(chuàng)建藍(lán)圖類父類搜索GameStateComponentLyra提供的一個(gè)有用的基類。命名為BP_EliminationManager。添加變量TournamentSettings類型為你的BP_EliminationSettingsCurrentState枚舉AlivePlayerListPlayerState數(shù)組EliminatedPlayerList自定義結(jié)構(gòu)體數(shù)組。在BeginPlay事件中初始化變量并嘗試獲取所有PlayerState存入AlivePlayerList。修改PawnData在Lyra內(nèi)容中如/Game/Characters/Heroes/找到PDA_Default復(fù)制到插件目錄重命名為PDA_Elimination。打開PDA_Elimination在Control Modes里添加新行。Control Mode Name填Elimination_WaitingInput Mapping可以先選IMC_Default后續(xù)再改View Mode選ViewTarget_Pawn。同樣方法添加Elimination_Eliminated和Elimination_Results。Elimination_Eliminated的View Mode可能需要選ViewTarget_Camera并指定一個(gè)觀戰(zhàn)攝像機(jī)類這需要額外設(shè)置?？狱c(diǎn)3直接修改Lyra原有的PDA_Default風(fēng)險(xiǎn)很高可能導(dǎo)致其他模式出錯(cuò)。務(wù)必使用副本。5.3 構(gòu)建Experience并測試創(chuàng)建Experience在插件內(nèi)創(chuàng)建Experience Definition命名為XP_Elimination。Game Feature Plugins添加ShooterCore和EliminationTournament。Actions點(diǎn)擊加號(hào)首先添加GameFeatureAction_AddComponents。在細(xì)節(jié)面板Component List里添加一項(xiàng)Component Class選擇我們創(chuàng)建的BP_EliminationManagerTarget選擇GameState。再添加一個(gè)GameFeatureAction_ChangeControlMode。Control Mode選擇Elimination_Waiting需要提前在PDA_Elimination中定義好。Target選擇Pawn。配置游戲模式打開你想測試的地圖如Arena示例地圖。打開World Settings窗口 - 世界設(shè)置。將GameMode Override設(shè)置為LyraGameMode。選中LyraGameMode后在細(xì)節(jié)面板找到Default Experience將其設(shè)置為我們的XP_Elimination?？狱c(diǎn)4LyraGameMode可能還需要正確的PawnData。在它的Default Pawn Data屬性中選擇我們修改過的PDA_Elimination。這是確保控件模式生效的關(guān)鍵一步。運(yùn)行測試點(diǎn)擊播放Play。如果一切配置正確游戲開始時(shí)你的角色應(yīng)該處于Elimination_Waiting模式。如何驗(yàn)證控件模式可以臨時(shí)在BP_EliminationManager的BeginPlay里打印一條日志或者更專業(yè)點(diǎn)在PlayerController里獲取當(dāng)前控件模式并打印。如果模式不對檢查1) Experience的Action是否執(zhí)行2) PawnData是否正確分配給GameMode和Pawn3) 控件模式名稱是否拼寫正確。5.4 實(shí)現(xiàn)狀態(tài)切換邏輯藍(lán)圖示例在BP_EliminationManager中開始比賽函數(shù)輸入無。邏輯設(shè)置CurrentState為InProgress遍歷AlivePlayerList調(diào)用一個(gè)自定義接口Set Control Mode需要自己創(chuàng)建或直接調(diào)用PlayerController上的函數(shù)將模式設(shè)為Elimination_Living。同時(shí)啟動(dòng)一個(gè)定時(shí)器用于后續(xù)邏輯?？狱c(diǎn)5在藍(lán)圖中直接調(diào)用其他Actor的函數(shù)確保有有效的引用。最好通過游戲狀態(tài)GameState獲取所有PlayerController。玩家淘汰函數(shù)輸入PlayerState。邏輯從AlivePlayerList中移除該玩家添加到EliminatedPlayerList并記錄時(shí)間。調(diào)用該玩家的Set Control Mode接口切換為Elimination_Eliminated。檢查AlivePlayerList數(shù)量如果1調(diào)用FinishTournament函數(shù)。結(jié)束比賽函數(shù)輸入獲勝者PlayerState。邏輯設(shè)置CurrentState為Finished。遍歷所有玩家將其控件模式切換為Elimination_Results。在UI上顯示最終排行榜。如何觸發(fā)“開始比賽”可以暴露一個(gè)Start Tournament的命令Exec函數(shù)在開發(fā)時(shí)用控制臺(tái)調(diào)用?；蛘吒玫氖窃诠芾砥鰾eginPlay時(shí)設(shè)置一個(gè)5秒的延遲然后自動(dòng)調(diào)用StartTournament進(jìn)行測試。6. 常見問題與調(diào)試技巧實(shí)錄在搭建過程中我踩遍了幾乎所有能踩的坑。這里把最常見的問題和解決方法列出來希望能幫你節(jié)省大量時(shí)間。6.1 控件模式不生效癥狀游戲開始后角色仍然使用默認(rèn)的Living模式可以開槍而不是等待模式。排查步驟檢查Experience加載在XP_Elimination的Actions里確保ChangeControlModeAction的Control Mode屬性下拉菜單里能正確顯示出你定義的Elimination_Waiting。如果顯示為None或紅色說明PawnData沒有正確關(guān)聯(lián)或控件模式名拼寫錯(cuò)誤。檢查PawnData關(guān)聯(lián)確認(rèn)LyraGameMode的Default Pawn Data屬性設(shè)置的是你修改過的PDA_Elimination。同時(shí)檢查角色的PawnData組件如果有是否也被覆蓋了。檢查執(zhí)行順序ChangeControlModeAction是否在AddComponents之后理論上順序影響不大但確保它不在一個(gè)條件分支里被跳過。使用調(diào)試命令Lyra通常提供了控制臺(tái)命令來查看和切換控件模式。在游戲運(yùn)行時(shí)按“~”打開控制臺(tái)嘗試輸入ShowControlMode或SetControlMode Elimination_Waiting命令名可能不同需查閱Lyra代碼。如果命令生效說明系統(tǒng)是工作的問題在配置如果命令無效可能是基礎(chǔ)框架有問題。6.2 玩家死亡事件無法捕獲癥狀玩家被打死但淘汰賽管理器沒有任何反應(yīng)。排查步驟確認(rèn)死亡標(biāo)簽首先確認(rèn)Lyra中玩家死亡的Gameplay Tag是什么。通常是State.Dead。你可以在角色被擊殺時(shí)打印其ASC的所有標(biāo)簽來確認(rèn)。檢查監(jiān)聽時(shí)機(jī)確保你在管理器的BeginPlay之后玩家的ASC已經(jīng)有效時(shí)才添加監(jiān)聽。可以考慮在OnPostLogin事件玩家加入時(shí)為每個(gè)玩家添加監(jiān)聽。檢查網(wǎng)絡(luò)角色BP_EliminationManager必須運(yùn)行在服務(wù)器端Has Authority。確保它被添加到了GameState服務(wù)器權(quán)威而不是客戶端的某個(gè)Actor上。在藍(lán)圖中關(guān)鍵邏輯前可以加一個(gè)Authority分支判斷。打印日志在監(jiān)聽器的回調(diào)函數(shù)里打印日志確認(rèn)函數(shù)被觸發(fā)了。如果沒有說明監(jiān)聽沒加上如果觸發(fā)了但沒執(zhí)行淘汰邏輯檢查回調(diào)函數(shù)內(nèi)部的邏輯。6.3 UI不更新或顯示錯(cuò)誤癥狀排行榜是空的或者存活人數(shù)不變化。排查步驟數(shù)據(jù)綁定時(shí)機(jī)UI在構(gòu)造時(shí)Construct可能GameState或管理器還未創(chuàng)建。嘗試在Event Pre Construct或Event Initialized事件中延遲一小段時(shí)間如0.1秒再嘗試獲取管理器引用。復(fù)制變量確保BP_EliminationManager中需要在客戶端顯示的變量如AlivePlayerList,CurrentState設(shè)置了Replicated。在藍(lán)圖中勾選變量詳情的Replication下的Replicated。使用事件驅(qū)動(dòng)更新不要只在UI的Tick里查詢數(shù)據(jù)。在管理器中當(dāng)AlivePlayerList或EliminatedPlayerList發(fā)生變化時(shí)在OnRep事件中觸發(fā)一個(gè)多播事件或委托。UI綁定這個(gè)委托來刷新顯示。這比輪詢更高效、更及時(shí)。檢查UI層級確保你的HUD或結(jié)果UI沒有被其他UI如Lyra自帶的HUD覆蓋。調(diào)整它的ZOrder屬性或者檢查它是否被添加到了正確的視圖port。6.4 游戲功能插件未加載癥狀Experience中配置的插件內(nèi)容如自定義的控件模式、組件在游戲中完全找不到。排查步驟檢查插件狀態(tài)主編輯器菜單Edit-Plugins確認(rèn)EliminationTournament插件已啟用并且右下角沒有錯(cuò)誤提示。檢查.uplugin文件有時(shí).uplugin文件配置錯(cuò)誤會(huì)導(dǎo)致插件加載失敗。檢查插件目錄下的.uplugin文件確保Modules部分配置正確特別是LoadingPhase。對于Game Feature PluginLoadingPhase通常是PostConfigInit。查看輸出日志啟動(dòng)游戲時(shí)打開Output Log窗口Window - Developer Tools - Output Log過濾“LogGameFeatures”或“Plugin”關(guān)鍵詞查看是否有加載錯(cuò)誤信息。重啟編輯器這是解決UE插件相關(guān)玄學(xué)問題的萬能第一步。徹底關(guān)閉編輯器再重新打開項(xiàng)目。6.5 網(wǎng)絡(luò)同步問題癥狀服務(wù)器上一切正常但客戶端看不到其他玩家被淘汰或者排行榜不同步。排查步驟區(qū)分Authority和Remote在任何關(guān)鍵邏輯處用Switch Has Authority節(jié)點(diǎn)明確區(qū)分服務(wù)器和客戶端該執(zhí)行的邏輯。比如切換控件模式、修改AlivePlayerList的操作必須放在Authority分支。善用OnRep事件對于復(fù)制的變量不要直接在其他地方讀取它的值來驅(qū)動(dòng)重要邏輯。應(yīng)該在變量的OnRep事件中編寫響應(yīng)邏輯。例如在AlivePlayerList的OnRep事件中更新UI的存活人數(shù)顯示。使用可靠RPC對于關(guān)鍵的一次性事件如“比賽開始”、“玩家X被淘汰”使用Multicast可靠RPC來確保所有客戶端都能收到。對于頻繁更新的數(shù)據(jù)如位置才考慮不可靠RPC或?qū)傩詮?fù)制。打包測試很多網(wǎng)絡(luò)問題在PIE編輯器內(nèi)播放的多客戶端模式下表現(xiàn)不明顯。務(wù)必使用Launch功能打包項(xiàng)目或者使用獨(dú)立的客戶端-服務(wù)器進(jìn)行測試這是發(fā)現(xiàn)同步問題的唯一可靠方法。搭建Lyra的淘汰賽模式是一個(gè)深入理解其現(xiàn)代化架構(gòu)的絕佳過程。它強(qiáng)迫你去思考狀態(tài)管理、事件驅(qū)動(dòng)、網(wǎng)絡(luò)同步和模塊化設(shè)計(jì)。雖然初期配置繁瑣但一旦跑通你會(huì)發(fā)現(xiàn)后續(xù)添加新功能比如不同地圖規(guī)則、特殊道具、連勝獎(jiǎng)勵(lì)會(huì)變得非常模塊化和清晰。最大的收獲不是做出了一個(gè)模式而是掌握了在Lyra這套框架下思考和解決問題的方法。當(dāng)你再去看Lyra的其他部分比如如何添加一個(gè)新技能、一個(gè)新道具思路都會(huì)豁然開朗。