feat(Core/Scripting): add OnBeforeArenaCheckWinConditions hook for mod-arena-replay compatibility (azerothcore#19856)

Author: Helias

src/server/game/Battlegrounds/Arena.cpp

@@ -192,6 +192,9 @@ void Arena::RemovePlayerAtLeave(Player* player)
 
 void Arena::CheckWinConditions()
 {
+    if (!sScriptMgr->OnBeforeArenaCheckWinConditions(this))
+        return;
+
     if (!GetAlivePlayersCountByTeam(TEAM_ALLIANCE) && GetPlayersCountByTeam(TEAM_HORDE))
         EndBattleground(TEAM_HORDE);
     else if (GetPlayersCountByTeam(TEAM_ALLIANCE) && !GetAlivePlayersCountByTeam(TEAM_HORDE))

src/server/game/Scripting/ScriptDefines/ArenaScript.cpp

@@ -34,6 +34,11 @@ bool ScriptMgr::CanSaveToDB(ArenaTeam* team)
     CALL_ENABLED_BOOLEAN_HOOKS(ArenaScript, ARENAHOOK_CAN_SAVE_TO_DB, !script->CanSaveToDB(team));
 }
 
+bool ScriptMgr::OnBeforeArenaCheckWinConditions(Battleground* const bg)
+{
+    CALL_ENABLED_BOOLEAN_HOOKS(ArenaScript, ARENAHOOK_ON_BEFORE_CHECK_WIN_CONDITION, !script->OnBeforeArenaCheckWinConditions(bg));
+}
+
 ArenaScript::ArenaScript(const char* name, std::vector<uint16> enabledHooks)
     : ScriptObject(name, ARENAHOOK_END)
 {

src/server/game/Scripting/ScriptDefines/ArenaScript.h

@@ -27,6 +27,7 @@ enum ArenaHook
     ARENAHOOK_CAN_ADD_MEMBER,
     ARENAHOOK_ON_GET_POINTS,
     ARENAHOOK_CAN_SAVE_TO_DB,
+    ARENAHOOK_ON_BEFORE_CHECK_WIN_CONDITION,
     ARENAHOOK_END
 };
 
@@ -44,6 +45,8 @@ class ArenaScript : public ScriptObject
 
     virtual void OnGetPoints(ArenaTeam* /*team*/, uint32 /*memberRating*/, float& /*points*/) { }
 
+    [[nodiscard]] virtual bool OnBeforeArenaCheckWinConditions(Battleground* const /* bg */) { return true; }
+
     [[nodiscard]] virtual bool CanSaveToDB(ArenaTeam* /*team*/) { return true; }
 };
 

src/server/game/Scripting/ScriptMgr.h

@@ -646,6 +646,7 @@ class ScriptMgr
     bool CanAddMember(ArenaTeam* team, ObjectGuid PlayerGuid);
     void OnGetPoints(ArenaTeam* team, uint32 memberRating, float& points);
     bool CanSaveToDB(ArenaTeam* team);
+    bool OnBeforeArenaCheckWinConditions(Battleground* const bg);
 
 public: /* MiscScript */