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