Valve 最新 CS2 更新帶來大量新腳本 API,包括人質事件、控制台 convar 存取以及擴充的 GameRules 控制。我們分析這對你的伺服器和客戶端模組有何影響。
變更內容
最新的 CS2 更新是針對腳本的修補,擴展了社群模組的 API 介面。主要新增包括:新的 Instance.Precache 物件與載入狀態檢查、完整的 CSHostage 類別與拾取/救援事件、頂層 Console 匯出用於 convar 操作,以及集中管理回合與隊伍的 GameRules 匯出。部分方法已被移動並標記為棄用,同時修正了幾個列舉值不匹配的問題。
對對局的影響
對競技對局而言,最明顯的變化是 radar_element 現在可以在所有遊戲模式中顯示於雷達上,而不僅限於 Rush 模式。這表示自訂雷達元素(如玩家標記或目標指示)將在所有模式中可見,可能影響資訊收集與團隊協調。伺服器管理員應注意 Console.SetConvar 不受 sv_cheats 限制且同步執行——在進行中的對局中請謹慎使用。新的 GameRules 方法用於暖身、回合終止和隊伍分數操作,讓伺服器管理員能更精確控制對局流程,這對錦標賽設定或自訂遊戲模式很有用。
選手筆記
如果你是模組開發者,新的 CSHostage API 和事件讓建立人質相關遊戲模式或 HUD 元素更容易。Console 匯出簡化了 convar 存取,無需透過 Instance。請記住,已移動的方法(如 Instance.IsWarmupPeriod)仍然可用但已棄用,請更新你的腳本以使用 GameRules 的對應方法。CSWeaponAttackType 和 CSTeamMoneyReason 列舉值的修正意味著你現有依賴這些值的腳本可能需要調整——檢查程式碼中是否有硬編碼的數字。此外,記錄的警告現在包含 JS 呼叫堆疊和參數詳細資訊,這有助於除錯,但可能產生更冗長的日誌。
該不該改設定?
對大多數玩家來說,不需要更改遊戲內設定。但如果你使用自訂 HUD 或雷達模組,請確認與新的 HUD_TEAMMENU_VISIBLE 和 HUD_CHAT_VISIBLE 類別的相容性。伺服器管理員應檢查任何使用 Console.SetConvar 的腳本,確保它們不會在對局中意外更改 convar。map_workshop 的自動完成改進對地圖製作者來說是便利性提升。
選手備忘
- 新的
CSHostageAPI:使用Instance.OnHostagePickUpStart、OnHostagePickUpAbort、OnHostagePickUp、OnHostageDrop、OnHostageRescue、OnHostageKill處理事件。 Console匯出:GetConvar*和SetConvar用於 convar 存取;SetConvar忽略sv_cheats並同步執行。GameRules匯出:StartWarmup、EndWarmup、GetTeamScore、AddTeamScore、TerminateRound;已移動的方法如IsWarmupPeriod現在位於此處,但在Instance中仍保留為棄用。- 雷達元素現在在所有遊戲模式中運作。
- 修正
CSWeaponAttackType和CSTeamMoneyReason的列舉值不匹配;檢查你的腳本。 - 警告現在包含呼叫堆疊和參數詳細資訊;預期日誌會更有用。