BurnySc2 · BurnySc2 · Jun 27, 2025 · Jan 17, 2025 · Jun 5, 2025 · Jun 26, 2025
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -84,7 +84,7 @@ jobs:
           rm -rf sc2/dicts/__pycache__ sc2/dicts_old/__pycache__
 
       - name: Upload generated dicts folder as artifact
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: Generated_dicts
           path: sc2/dicts
@@ -333,7 +333,7 @@ jobs:
           echo "Upload htmlcov folder because it was mounted in container, so it will be available in host machine"
 
       - name: Upload htmlcov/ folder as artifact
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: Coverage_report
           path: htmlcov

diff --git a/data/data.json b/data/data.json
diff --git a/examples/watch_replay.py b/examples/watch_replay.py
@@ -40,4 +40,4 @@ async def on_step(self, iteration: int):
     assert (
         replay_path.is_file()
     ), "Run worker_rush.py in the same folder first to generate a replay. Then run watch_replay.py again."
-    run_replay(my_observer_ai, replay_path=replay_path)
+    run_replay(my_observer_ai, replay_path=str(replay_path))
diff --git a/sc2/bot_ai_internal.py b/sc2/bot_ai_internal.py
@@ -476,9 +476,10 @@ def _prepare_start(
         self.realtime: bool = realtime
         self.base_build: int = base_build
 
-        self.race: Race = Race(self.game_info.player_races[self.player_id])
-
-        if len(self.game_info.player_races) == 2:
+        # Get the player's race. As observer, get Race.NoRace=0
+        self.race: Race = Race(self.game_info.player_races.get(self.player_id, 0))
+        # Get the enemy's race only if we are not observer (replay) and the game has 2 players
+        if self.player_id > 0 and len(self.game_info.player_races) == 2:
             self.enemy_race: Race = Race(self.game_info.player_races[3 - self.player_id])
 
         self._distances_override_functions(self.distance_calculation_method)

diff --git a/sc2/client.py b/sc2/client.py
@@ -432,7 +432,7 @@ async def move_camera(self, position: Unit | Units | Point2 | Point3) -> None:
             )
         )
 
-    async def obs_move_camera(self, position: Unit | Units | Point2 | Point3) -> None:
+    async def obs_move_camera(self, position: Unit | Units | Point2 | Point3, distance: float = 0) -> None:
         """Moves observer camera to the target position. Only works when observing (e.g. watching the replay).
 
         :param position:"""
@@ -444,7 +444,9 @@ async def obs_move_camera(self, position: Unit | Units | Point2 | Point3) -> Non
         await self._execute(
             obs_action=sc_pb.RequestObserverAction(
                 actions=[
-                    sc_pb.ObserverAction(camera_move=sc_pb.ActionObserverCameraMove(world_pos=position.as_Point2D))
+                    sc_pb.ObserverAction(
+                        camera_move=sc_pb.ActionObserverCameraMove(world_pos=position.as_Point2D, distance=distance)
+                    )
                 ]
             )
         )

diff --git a/sc2/dicts/generic_redirect_abilities.py b/sc2/dicts/generic_redirect_abilities.py
@@ -2,6 +2,7 @@
 # ANY CHANGE WILL BE OVERWRITTEN
 
 from sc2.ids.ability_id import AbilityId
+
 # from sc2.ids.buff_id import BuffId
 # from sc2.ids.effect_id import EffectId
 
@@ -118,6 +119,7 @@
     AbilityId.CANCEL_STASISTRAP: AbilityId.CANCEL,
     AbilityId.CANCEL_VOIDRAYPRISMATICALIGNMENT: AbilityId.CANCEL,
     AbilityId.CHANNELSNIPE_CANCEL: AbilityId.CANCEL,
+    AbilityId.COMMANDCENTERTRANSPORT_COMMANDCENTERTRANSPORT: AbilityId.LOAD,
     AbilityId.CYBERNETICSCORERESEARCH_PROTOSSAIRARMORLEVEL1: AbilityId.RESEARCH_PROTOSSAIRARMOR,
     AbilityId.CYBERNETICSCORERESEARCH_PROTOSSAIRARMORLEVEL2: AbilityId.RESEARCH_PROTOSSAIRARMOR,
     AbilityId.CYBERNETICSCORERESEARCH_PROTOSSAIRARMORLEVEL3: AbilityId.RESEARCH_PROTOSSAIRARMOR,
@@ -204,7 +206,6 @@
     AbilityId.MORPHTOSWARMHOSTBURROWEDMP_CANCEL: AbilityId.CANCEL,
     AbilityId.MOVE_BATTLECRUISER: AbilityId.MOVE,
     AbilityId.MOVE_MOVE: AbilityId.MOVE,
-    AbilityId.NULL_NULL: AbilityId.CANCEL,
     AbilityId.PATROL_BATTLECRUISER: AbilityId.PATROL,
     AbilityId.PATROL_PATROL: AbilityId.PATROL,
     AbilityId.PHASINGMODE_CANCEL: AbilityId.CANCEL,

diff --git a/sc2/dicts/unit_abilities.py b/sc2/dicts/unit_abilities.py
@@ -1,8 +1,9 @@
 # THIS FILE WAS AUTOMATICALLY GENERATED BY "generate_dicts_from_data_json.py" DO NOT CHANGE MANUALLY!
 # ANY CHANGE WILL BE OVERWRITTEN
 
-from sc2.ids.unit_typeid import UnitTypeId
 from sc2.ids.ability_id import AbilityId
+from sc2.ids.unit_typeid import UnitTypeId
+
 # from sc2.ids.buff_id import BuffId
 # from sc2.ids.effect_id import EffectId
 
@@ -528,6 +529,7 @@
         AbilityId.ATTACK_ATTACK,
         AbilityId.BURROWDOWN_HYDRALISK,
         AbilityId.HOLDPOSITION_HOLD,
+        AbilityId.HYDRALISKFRENZY_HYDRALISKFRENZY,
         AbilityId.MORPH_LURKER,
         AbilityId.MOVE_MOVE,
         AbilityId.PATROL_PATROL,

diff --git a/sc2/dicts/unit_research_abilities.py b/sc2/dicts/unit_research_abilities.py
@@ -1,14 +1,14 @@
 # THIS FILE WAS AUTOMATICALLY GENERATED BY "generate_dicts_from_data_json.py" DO NOT CHANGE MANUALLY!
 # ANY CHANGE WILL BE OVERWRITTEN
 
-from sc2.ids.unit_typeid import UnitTypeId
-from sc2.ids.ability_id import AbilityId
-from sc2.ids.upgrade_id import UpgradeId
 # from sc2.ids.buff_id import BuffId
 # from sc2.ids.effect_id import EffectId
-
 from typing import Union
 
+from sc2.ids.ability_id import AbilityId
+from sc2.ids.unit_typeid import UnitTypeId
+from sc2.ids.upgrade_id import UpgradeId
+
 RESEARCH_INFO: dict[UnitTypeId, dict[UpgradeId, dict[str, Union[AbilityId, bool, UnitTypeId, UpgradeId]]]] = {
     UnitTypeId.ARMORY: {
         UpgradeId.TERRANSHIPWEAPONSLEVEL1: {"ability": AbilityId.ARMORYRESEARCH_TERRANSHIPWEAPONSLEVEL1},

diff --git a/sc2/dicts/unit_tech_alias.py b/sc2/dicts/unit_tech_alias.py
@@ -2,6 +2,7 @@
 # ANY CHANGE WILL BE OVERWRITTEN
 
 from sc2.ids.unit_typeid import UnitTypeId
+
 # from sc2.ids.buff_id import BuffId
 # from sc2.ids.effect_id import EffectId
 

diff --git a/sc2/dicts/unit_train_build_abilities.py b/sc2/dicts/unit_train_build_abilities.py
@@ -1,13 +1,13 @@
 # THIS FILE WAS AUTOMATICALLY GENERATED BY "generate_dicts_from_data_json.py" DO NOT CHANGE MANUALLY!
 # ANY CHANGE WILL BE OVERWRITTEN
 
-from sc2.ids.unit_typeid import UnitTypeId
-from sc2.ids.ability_id import AbilityId
 # from sc2.ids.buff_id import BuffId
 # from sc2.ids.effect_id import EffectId
-
 from typing import Union
 
+from sc2.ids.ability_id import AbilityId
+from sc2.ids.unit_typeid import UnitTypeId
+
 TRAIN_INFO: dict[UnitTypeId, dict[UnitTypeId, dict[str, Union[AbilityId, bool, UnitTypeId]]]] = {
     UnitTypeId.BARRACKS: {
         UnitTypeId.GHOST: {

diff --git a/sc2/dicts/unit_trained_from.py b/sc2/dicts/unit_trained_from.py
@@ -2,6 +2,7 @@
 # ANY CHANGE WILL BE OVERWRITTEN
 
 from sc2.ids.unit_typeid import UnitTypeId
+
 # from sc2.ids.buff_id import BuffId
 # from sc2.ids.effect_id import EffectId
 
@@ -23,7 +24,7 @@
     UnitTypeId.COLOSSUS: {UnitTypeId.ROBOTICSFACILITY},
     UnitTypeId.COMMANDCENTER: {UnitTypeId.SCV},
     UnitTypeId.CORRUPTOR: {UnitTypeId.LARVA},
-    UnitTypeId.CREEPTUMOR: {UnitTypeId.CREEPTUMOR, UnitTypeId.CREEPTUMORBURROWED, UnitTypeId.QUEEN},
+    UnitTypeId.CREEPTUMOR: {UnitTypeId.CREEPTUMORBURROWED, UnitTypeId.QUEEN},
     UnitTypeId.CREEPTUMORQUEEN: {UnitTypeId.QUEEN},
     UnitTypeId.CYBERNETICSCORE: {UnitTypeId.PROBE},
     UnitTypeId.CYCLONE: {UnitTypeId.FACTORY},

diff --git a/sc2/dicts/unit_unit_alias.py b/sc2/dicts/unit_unit_alias.py
@@ -2,6 +2,7 @@
 # ANY CHANGE WILL BE OVERWRITTEN
 
 from sc2.ids.unit_typeid import UnitTypeId
+
 # from sc2.ids.buff_id import BuffId
 # from sc2.ids.effect_id import EffectId
 

diff --git a/sc2/dicts/upgrade_researched_from.py b/sc2/dicts/upgrade_researched_from.py
@@ -3,6 +3,7 @@
 
 from sc2.ids.unit_typeid import UnitTypeId
 from sc2.ids.upgrade_id import UpgradeId
+
 # from sc2.ids.buff_id import BuffId
 # from sc2.ids.effect_id import EffectId
 

diff --git a/sc2/game_info.py b/sc2/game_info.py
@@ -10,7 +10,7 @@
 import numpy as np
 
 from sc2.pixel_map import PixelMap
-from sc2.player import Player, Race
+from sc2.player import Player
 from sc2.position import Point2, Rect, Size
 
 
@@ -237,7 +237,7 @@ def __init__(self, proto) -> None:
         self.map_ramps: list[Ramp] = None  # Filled later by BotAI._prepare_first_step
         # pyre-ignore[8]
         self.vision_blockers: frozenset[Point2] = None  # Filled later by BotAI._prepare_first_step
-        self.player_races: dict[int, Race] = {
+        self.player_races: dict[int, int] = {
             p.player_id: p.race_actual or p.race_requested for p in self._proto.player_info
         }
         self.start_locations: list[Point2] = [

diff --git a/sc2/generate_ids.py b/sc2/generate_ids.py
@@ -76,6 +76,9 @@ def parse_data(self, data) -> dict[str, Any]:
             key = v["buttonname"]
             remapid = v.get("remapid")
 
+            if key == "" and v["index"] == 0:
+                key = v["name"]
+
             if (not key) and (remapid is None):
                 assert v["buttonname"] == ""
                 continue

diff --git a/sc2/ids/__init__.py b/sc2/ids/__init__.py
@@ -1,5 +1,6 @@
 # pyre-ignore-all-errors[14]
 from __future__ import annotations
+
 # DO NOT EDIT!
 # This file was automatically generated by "generate_ids.py"