sc2ai 0.1.0 → 0.3.0

data/lib/sc2ai/api/tech_tree_data.rb

@@ -13,7 +13,13 @@ module Api
     {ability: Api::AbilityId::UPGRADETOORBITAL_ORBITALCOMMAND,
      required_building: Api::UnitTypeId::BARRACKS}},
                                                Api::UnitTypeId::BARRACKS =>
-  {Api::UnitTypeId::MARINE =>
+  {Api::UnitTypeId::BARRACKSTECHLAB =>
+    {ability: Api::AbilityId::BUILD_TECHLAB_BARRACKS,
+     requires_placement_position: true},
+   Api::UnitTypeId::BARRACKSREACTOR =>
+    {ability: Api::AbilityId::BUILD_REACTOR_BARRACKS,
+     requires_placement_position: true},
+   Api::UnitTypeId::MARINE =>
     {ability: Api::AbilityId::BARRACKSTRAIN_MARINE},
    Api::UnitTypeId::REAPER =>
     {ability: Api::AbilityId::BARRACKSTRAIN_REAPER},
@@ -25,7 +31,13 @@ module Api
     {ability: Api::AbilityId::BARRACKSTRAIN_MARAUDER,
      requires_techlab: true}},
                                                Api::UnitTypeId::FACTORY =>
-  {Api::UnitTypeId::HELLION =>
+  {Api::UnitTypeId::FACTORYTECHLAB =>
+    {ability: Api::AbilityId::BUILD_TECHLAB_FACTORY,
+     requires_placement_position: true},
+   Api::UnitTypeId::FACTORYREACTOR =>
+    {ability: Api::AbilityId::BUILD_REACTOR_FACTORY,
+     requires_placement_position: true},
+   Api::UnitTypeId::HELLION =>
     {ability: Api::AbilityId::FACTORYTRAIN_HELLION},
    Api::UnitTypeId::CYCLONE => {ability: Api::AbilityId::TRAIN_CYCLONE},
    Api::UnitTypeId::WIDOWMINE =>
@@ -41,7 +53,13 @@ module Api
     {ability: Api::AbilityId::TRAIN_HELLBAT,
      required_building: Api::UnitTypeId::ARMORY}},
                                                Api::UnitTypeId::STARPORT =>
-  {Api::UnitTypeId::MEDIVAC =>
+  {Api::UnitTypeId::STARPORTTECHLAB =>
+    {ability: Api::AbilityId::BUILD_TECHLAB_STARPORT,
+     requires_placement_position: true},
+   Api::UnitTypeId::STARPORTREACTOR =>
+    {ability: Api::AbilityId::BUILD_REACTOR_STARPORT,
+     requires_placement_position: true},
+   Api::UnitTypeId::MEDIVAC =>
     {ability: Api::AbilityId::STARPORTTRAIN_MEDIVAC},
    Api::UnitTypeId::VIKINGFIGHTER =>
     {ability: Api::AbilityId::STARPORTTRAIN_VIKINGFIGHTER},
@@ -56,6 +74,20 @@ module Api
     {ability: Api::AbilityId::STARPORTTRAIN_BATTLECRUISER,
      requires_techlab: true,
      required_building: Api::UnitTypeId::FUSIONCORE}},
+                                               Api::UnitTypeId::FACTORYFLYING =>
+  {Api::UnitTypeId::FACTORYTECHLAB =>
+    {ability: Api::AbilityId::BUILD_TECHLAB_FACTORY,
+     requires_placement_position: true},
+   Api::UnitTypeId::FACTORYREACTOR =>
+    {ability: Api::AbilityId::BUILD_REACTOR_FACTORY,
+     requires_placement_position: true}},
+                                               Api::UnitTypeId::STARPORTFLYING =>
+  {Api::UnitTypeId::STARPORTTECHLAB =>
+    {ability: Api::AbilityId::BUILD_TECHLAB_STARPORT,
+     requires_placement_position: true},
+   Api::UnitTypeId::STARPORTREACTOR =>
+    {ability: Api::AbilityId::BUILD_REACTOR_STARPORT,
+     requires_placement_position: true}},
                                                Api::UnitTypeId::SCV =>
   {Api::UnitTypeId::COMMANDCENTER =>
     {ability: Api::AbilityId::TERRANBUILD_COMMANDCENTER,
@@ -104,6 +136,13 @@ module Api
    Api::UnitTypeId::FUSIONCORE =>
     {ability: Api::AbilityId::TERRANBUILD_FUSIONCORE,
      required_building: Api::UnitTypeId::STARPORT,
+     requires_placement_position: true}},
+                                               Api::UnitTypeId::BARRACKSFLYING =>
+  {Api::UnitTypeId::BARRACKSTECHLAB =>
+    {ability: Api::AbilityId::BUILD_TECHLAB_BARRACKS,
+     requires_placement_position: true},
+   Api::UnitTypeId::BARRACKSREACTOR =>
+    {ability: Api::AbilityId::BUILD_REACTOR_BARRACKS,
      requires_placement_position: true}},
                                                Api::UnitTypeId::RAVEN =>
   {Api::UnitTypeId::AUTOTURRET =>
@@ -780,16 +819,28 @@ module Api
     Api::UnitTypeId::ORBITALCOMMAND],
                                     Api::UnitTypeId::PLANETARYFORTRESS => [Api::UnitTypeId::COMMANDCENTER],
                                     Api::UnitTypeId::ORBITALCOMMAND => [Api::UnitTypeId::COMMANDCENTER],
+                                    Api::UnitTypeId::BARRACKSTECHLAB =>
+  [Api::UnitTypeId::BARRACKS, Api::UnitTypeId::BARRACKSFLYING],
+                                    Api::UnitTypeId::BARRACKSREACTOR =>
+  [Api::UnitTypeId::BARRACKS, Api::UnitTypeId::BARRACKSFLYING],
                                     Api::UnitTypeId::MARINE => [Api::UnitTypeId::BARRACKS],
                                     Api::UnitTypeId::REAPER => [Api::UnitTypeId::BARRACKS],
                                     Api::UnitTypeId::GHOST => [Api::UnitTypeId::BARRACKS],
                                     Api::UnitTypeId::MARAUDER => [Api::UnitTypeId::BARRACKS],
+                                    Api::UnitTypeId::FACTORYTECHLAB =>
+  [Api::UnitTypeId::FACTORY, Api::UnitTypeId::FACTORYFLYING],
+                                    Api::UnitTypeId::FACTORYREACTOR =>
+  [Api::UnitTypeId::FACTORY, Api::UnitTypeId::FACTORYFLYING],
                                     Api::UnitTypeId::HELLION => [Api::UnitTypeId::FACTORY],
                                     Api::UnitTypeId::CYCLONE => [Api::UnitTypeId::FACTORY],
                                     Api::UnitTypeId::WIDOWMINE => [Api::UnitTypeId::FACTORY],
                                     Api::UnitTypeId::SIEGETANK => [Api::UnitTypeId::FACTORY],
                                     Api::UnitTypeId::THOR => [Api::UnitTypeId::FACTORY],
                                     Api::UnitTypeId::HELLIONTANK => [Api::UnitTypeId::FACTORY],
+                                    Api::UnitTypeId::STARPORTTECHLAB =>
+  [Api::UnitTypeId::STARPORT, Api::UnitTypeId::STARPORTFLYING],
+                                    Api::UnitTypeId::STARPORTREACTOR =>
+  [Api::UnitTypeId::STARPORT, Api::UnitTypeId::STARPORTFLYING],
                                     Api::UnitTypeId::MEDIVAC => [Api::UnitTypeId::STARPORT],
                                     Api::UnitTypeId::VIKINGFIGHTER => [Api::UnitTypeId::STARPORT],
                                     Api::UnitTypeId::LIBERATOR => [Api::UnitTypeId::STARPORT],

data/lib/sc2ai/connection/connection_listener.rb

@@ -6,21 +6,21 @@ module Sc2
     # noinspection RubyUnusedLocalVariable
     module ConnectionListener
       # Called when connection established to application
-      # @param connection [Sc2Ai::Connection]
+      # @param connection [Sc2::Connection]
       # noinspection
       def on_connected(connection)
         Sc2.logger.debug { "#{self.class}.#{__method__} #{connection}" }
       end
 
       # Called while waiting on connection to application
-      # @param connection [Sc2Ai::Connection]
+      # @param connection [Sc2::Connection]
       # noinspection Lint/UnusedMethodArgument
       def on_connection_waiting(connection)
         Sc2.logger.debug { "#{self.class}.#{__method__} #{connection}" }
       end
 
       # Called when disconnected from application
-      # @param connection [Sc2Ai::Connection]
+      # @param connection [Sc2::Connection]
       # noinspection Lint/UnusedMethodArgument
       def on_disconnect(connection)
         Sc2.logger.debug { "#{self.class}.#{__method__} #{connection}" }

data/lib/sc2ai/connection/requests.rb

@@ -24,7 +24,7 @@ module Sc2
       end
 
       # Send to host and all clients for game to begin.
-      # @param race [Google::Protobuf::EnumValue] Api::Race
+      # @param race [Integer] see {Api::Race}
       # @param name [String] player name
       # @param server_host [String] hostname or ip of sc2 client
       # @param port_config [Sc2::PortConfig] port config auto or basic, using start port
@@ -51,16 +51,14 @@ module Sc2
           server_ports: port_config.server_port_set,
           client_ports: port_config.client_port_sets,
           options: Api::InterfaceOptions.new(
-            {
-              raw: true,
-              score: false,
-              feature_layer: feature_layer_interface_options(enable_feature_layer),
-              show_cloaked: true,
-              show_burrowed_shadows: true,
-              show_placeholders: true,
-              raw_affects_selection: Sc2.ladder?,
-              raw_crop_to_playable_area: true
-            }.merge!(interface_options)
+            raw: true,
+            score: false,
+            feature_layer: feature_layer_interface_options(enable_feature_layer),
+            show_cloaked: true,
+            show_burrowed_shadows: true,
+            show_placeholders: true,
+            raw_affects_selection: Sc2.ladder?,
+            raw_crop_to_playable_area: true, **interface_options
           )
         )
       end
@@ -103,7 +101,7 @@ module Sc2
       #     pp observer.api.start_replay(
       #       replay_path: Pathname("./replays/test.SC2Replay").realpath
       #     )
-      #     while observer.status == :in_replay
+      #     while observer.status == :IN_REPLAY
       #       #   Step forward
       #       observer.api.step(1)
       #       #   fresh observation info
@@ -124,27 +122,25 @@ module Sc2
 
         interface_options ||= {}
         send_request_for start_replay: Api::RequestStartReplay.new(
-          {
-            replay_path: replay_path.to_s,
-            replay_data: replay_data,
-            map_data: map_data,
-            realtime: false,
-            disable_fog: true,
-            record_replay: record_replay,
-            observed_player_id: 0,
-            options: Api::InterfaceOptions.new(
-              {
-                raw: true,
-                score: true,
-                feature_layer: feature_layer_interface_options(true),
-                show_cloaked: true,
-                show_burrowed_shadows: true,
-                show_placeholders: true,
-                raw_affects_selection: false,
-                raw_crop_to_playable_area: true
-              }.merge!(interface_options)
-            )
-          }.merge(options)
+          replay_path: replay_path.to_s,
+          replay_data: replay_data,
+          map_data: map_data,
+          realtime: false,
+          disable_fog: true,
+          record_replay: record_replay,
+          observed_player_id: 0,
+          options: Api::InterfaceOptions.new(
+            raw: true,
+            score: true,
+            feature_layer: feature_layer_interface_options(true),
+            show_cloaked: true,
+            show_burrowed_shadows: true,
+            show_placeholders: true,
+            raw_affects_selection: false,
+            raw_crop_to_playable_area: true,
+            **interface_options
+          ),
+          **options
         )
       end
 
@@ -425,8 +421,8 @@ module Sc2
       #      Api::Request.new(observation: RequestObservation)
       #    )[:observation]
       def send_request_for(**kwargs)
-        response = send_request(Api::Request.new(kwargs))
-        response[kwargs.keys.first.to_s]
+        response = send_request(Api::Request.new(**kwargs))
+        response.send(kwargs.keys.first)
       end
 
       private

data/lib/sc2ai/connection/status_listener.rb

@@ -5,7 +5,7 @@ module Sc2
     # Callbacks when game status changes
     module StatusListener
       # Called when game status changes
-      # @param status [:launched, :in_game, :in_replay, :ended, :quit, :unknown] game state, i.e. :in_game, :ended, :launched
+      # @param status [:LAUNCHED, :IN_GAME, :IN_REPLAY, :ENDED, :QUIT, :UNKNOWN] game state, i.e. :IN_GAME, :ENDED, :LAUNCHED
       # noinspection
       def on_status_change(status)
         Sc2.logger.debug { "#{self.class}.#{__method__} #{status}" }

data/lib/sc2ai/connection.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "async"
-require "async/io/stream"
 require "async/http/endpoint"
 require "async/websocket"
 require_relative "connection/requests"
@@ -139,7 +138,7 @@ module Sc2
 
     attr_writer :status, :listeners
 
-    # @return [HTTP::Endpoint] websocket url for establishing protobuf connection
+    # @return [::Async::HTTP::Endpoint] websocket url for establishing protobuf connection
     def endpoint
       Async::HTTP::Endpoint.parse("ws://#{@host}:#{@port}/sc2api")
     end

data/lib/sc2ai/local_play/client.rb

@@ -115,7 +115,7 @@ module Sc2
 
     # @!attribute task
     # The async task running Sc2. Used when interrupting.
-    # @return [Async::Task]
+    # @return [::Async::Task]
     attr_accessor :task
 
     # @private
@@ -151,7 +151,7 @@ module Sc2
 
     # @private
     # Reads bundled versions.json
-    # @return [JSON] contents of versions.json
+    # @return [Array] JSON contents of versions.json
     def versions_json
       JSON.load_file(Paths.gem_data_versions_path)
     end

data/lib/sc2ai/local_play/match.rb

@@ -72,6 +72,11 @@ module Sc2
             ClientManager.stop(player_index) # unless keep_clients_alive
           end
         end
+        # Here, Api players are busy Joining and we wait for map loads
+        # Let's use this time for quick housekeeping before the match
+        run_task.async do
+          Process.warmup
+        end
       rescue
         # no op - clean exit from game may cause ws disconnection error
       end.wait
@@ -116,7 +121,7 @@ module Sc2
     # Gets a Sc2 client from Sc2::ClientManager and connects them
     def connect_players
       # Depending on number of players, api has different ready states
-      ready_statuses = (api_players.size > 1) ? [:launched] : %i[launched ready]
+      ready_statuses = (api_players.size > 1) ? [:LAUNCHED] : %i[LAUNCHED READY]
 
       # For each player, attempt to connect and retry once after closing Sc2 in worst-case
       api_players.each_with_index do |player, i|
@@ -149,7 +154,7 @@ module Sc2
       api_players.each do |player|
         # Clean surrender locally. Lapizistik taught me bad things.
         def player.leave_game
-          debug_end_game(end_result: :Surrender)
+          debug_end_game(end_result: :SURRENDER)
         end
       end
     end

data/lib/sc2ai/overrides/async/process/child.rb

@@ -8,7 +8,7 @@ module Async
       def initialize(*args, **options)
         # Setup a cross-thread notification pipe - nio4r can't monitor pids unfortunately:
         pipe = ::IO.pipe
-        @input = Async::IO::Generic.new(pipe.first)
+        @input = pipe.first
         @output = pipe.last
 
         @exit_status = nil

data/lib/sc2ai/paths.rb

@@ -12,19 +12,26 @@ module Sc2
   # Credit to Hannes, Sean and Burny for setting the standard
   class Paths
     # Platform name for Windows
+    # @return [String] "Windows"
     PF_WINDOWS = "Windows"
     # Platform name for WSL1
+    # @return [String] "WSL"
     PF_WSL1 = "WSL1"
     # Platform name for WSL2
+    # @return [String] "WSL2"
     PF_WSL2 = "WSL2"
     # Platform name macOS
+    # @return [String] "Darwin"
     PF_DARWIN = "Darwin"
     # Platform name Linux
+    # @return [String] "Linux"
     PF_LINUX = "Linux"
     # Platform name for Wine
+    # @return [String] "WineLinux"
     PF_WINE = "WineLinux"
 
     # Where within user directory to locate ExecuteInfo.txt
+    # @return [Hash<String, String>] PF_* => "/path/to/StarCraft II"
     BASE_DIR = {
       PF_WINDOWS => "C:/Program Files (x86)/StarCraft II",
       PF_WSL1 => "/mnt/c/Program Files (x86)/StarCraft II",
@@ -35,6 +42,7 @@ module Sc2
     }.freeze
 
     # Where within user directory to locate ExecuteInfo.txt
+    # @return [Hash<String, String>] PF_* => "/path/to/ExecuteInfo.txt"
     EXEC_INFO_PATH = {
       PF_WINDOWS => "Documents/StarCraft II/ExecuteInfo.txt",
       PF_WSL1 => "Documents/StarCraft II/ExecuteInfo.txt",
@@ -45,6 +53,7 @@ module Sc2
     }.freeze
 
     # Path helper for finding executable
+    # @return [Hash<String, String>] PF_* => "SC2_binary.exe"
     BIN_PATH = {
       PF_WINDOWS => "SC2_x64.exe",
       PF_WSL1 => "SC2_x64.exe",
@@ -56,6 +65,7 @@ module Sc2
 
     # Working directory sub-folder per platform.
     # Used when spawning client process on some platforms.
+    # @return [Hash<String, String>] PF_* => "Directory"
     WORKING_DIR = {
       PF_WINDOWS => "Support64",
       PF_WSL1 => "Support64",
@@ -74,7 +84,7 @@ module Sc2
 
       # Bucketed platform names follows convention
       # Uses ENV['SC2PF'] if configured. This is the only way to set "WineLinux"
-      # @return ["Windows","WSL1","WSL2","Darwin","Linux","WineLinux"] string platform name
+      # @return [String] string platform name
       def platform
         return ENV.fetch("SC2PF", nil) unless ENV["SC2PF"].to_s.strip.empty?
 
@@ -252,7 +262,7 @@ module Sc2
       end
 
       # Loads version data
-      # @return [JSON] versions.json
+      # @return [Array] versions.json
       def version_json
         JSON.load_file(Pathname(__dir__.to_s).join("../data/versions.json"))
       end

data/lib/sc2ai/player/actions.rb

@@ -148,8 +148,8 @@ module Sc2
 
       # Issues spatial unit command. Target is either target_screen_coord or target_minimap_coord.
       # @param ability_id [Api::AbilityId]
-      # @param target_screen_coord [Api::Point2I]
-      # @param target_minimap_coord [Api::Point2I]
+      # @param target_screen_coord [Api::PointI]
+      # @param target_minimap_coord [Api::PointI]
       # @param queue_command [Boolean] shift+command
       # @return [void]
       def action_spatial_unit_command(ability_id:, target_screen_coord: nil, target_minimap_coord: nil, queue_command: false)
@@ -166,7 +166,7 @@ module Sc2
       end
 
       # Simulates a click on the minimap to move the camera.
-      # @param center_minimap [Api::Point2I]
+      # @param center_minimap [Api::PointI]
       # @return [void]
       #
       def action_spatial_camera_move(center_minimap:)
@@ -182,10 +182,10 @@ module Sc2
       # Issues spatial unit select point command. Target is either target_screen_coord or target_minimap_coord.
       # @param type [Integer] 1,2,3,4 = Api::ActionSpatialUnitSelectionPoint::Type::*
       #   enum Type {
-      #     Select = 1;         // Equivalent to normal click. Changes selection to unit.
-      #     Toggle = 2;         // Equivalent to shift+click. Toggle selection of unit.
-      #     AllType = 3;        // Equivalent to control+click. Selects all units of a given type.
-      #     AddAllType = 4;     // Equivalent to shift+control+click. Selects all units of a given type.
+      #     SELECT = 1;         // EQUIVALENT TO NORMAL CLICK. CHANGES SELECTION TO UNIT.
+      #     TOGGLE = 2;         // EQUIVALENT TO SHIFT+CLICK. TOGGLE SELECTION OF UNIT.
+      #     ALL_TYPE = 3;        // EQUIVALENT TO CONTROL+CLICK. SELECTS ALL UNITS OF A GIVEN TYPE.
+      #     ADD_ALL_TYPE = 4;     // EQUIVALENT TO SHIFT+CONTROL+CLICK. SELECTS ALL UNITS OF A GIVEN TYPE.
       #   }
       # @param selection_screen_coord [Api::PointI]
       # @return [void]
@@ -221,11 +221,11 @@ module Sc2
       # Populated if Feature Layer or Render interface is enabled.
       # @param action [Integer] 1-5 = Api::ActionControlGroup::ControlGroupAction::*
       #   enum ControlGroupAction {
-      #     Recall = 1;             // Equivalent to number hotkey. Replaces current selection with control group.
-      #     Set = 2;                // Equivalent to Control + number hotkey. Sets control group to current selection.
-      #     Append = 3;             // Equivalent to Shift + number hotkey. Adds current selection into control group.
-      #     SetAndSteal = 4;        // Equivalent to Control + Alt + number hotkey. Sets control group to current selection. Units are removed from other control groups.
-      #     AppendAndSteal = 5;     // Equivalent to Shift + Alt + number hotkey. Adds current selection into control group. Units are removed from other control groups.
+      #     RECALL = 1;             // EQUIVALENT TO NUMBER HOTKEY. REPLACES CURRENT SELECTION WITH CONTROL GROUP.
+      #     SET = 2;                // EQUIVALENT TO CONTROL + NUMBER HOTKEY. SETS CONTROL GROUP TO CURRENT SELECTION.
+      #     APPEND = 3;             // EQUIVALENT TO SHIFT + NUMBER HOTKEY. ADDS CURRENT SELECTION INTO CONTROL GROUP.
+      #     SET_AND_STEAL = 4;        // EQUIVALENT TO CONTROL + ALT + NUMBER HOTKEY. SETS CONTROL GROUP TO CURRENT SELECTION. UNITS ARE REMOVED FROM OTHER CONTROL GROUPS.
+      #     APPEND_AND_STEAL = 5;     // EQUIVALENT TO SHIFT + ALT + NUMBER HOTKEY. ADDS CURRENT SELECTION INTO CONTROL GROUP. UNITS ARE REMOVED FROM OTHER CONTROL GROUPS.
       #   }
       # @param control_group_index [Integer] 0-9
       # @return [void]
@@ -280,10 +280,10 @@ module Sc2
       # @param type [Integer] 1-4 = Api::ActionSelectIdleWorker::Type::*
       #
       #   enum Type {
-      #     Set = 1;        // Equivalent to click with no modifiers. Replaces selection with single idle worker.
-      #     Add = 2;        // Equivalent to shift+click. Adds single idle worker to current selection.
-      #     All = 3;        // Equivalent to control+click. Selects all idle workers.
-      #     AddAll = 4;     // Equivalent to shift+control+click. Adds all idle workers to current selection.
+      #     SET = 1;        // EQUIVALENT TO CLICK WITH NO MODIFIERS. REPLACES SELECTION WITH SINGLE IDLE WORKER.
+      #     ADD = 2;        // EQUIVALENT TO SHIFT+CLICK. ADDS SINGLE IDLE WORKER TO CURRENT SELECTION.
+      #     ALL = 3;        // EQUIVALENT TO CONTROL+CLICK. SELECTS ALL IDLE WORKERS.
+      #     ADD_ALL = 4;     // EQUIVALENT TO SHIFT+CONTROL+CLICK. ADDS ALL IDLE WORKERS TO CURRENT SELECTION.
       #   }
       def action_ui_select_idle_worker(type:)
         queue_action Api::Action.new(
@@ -299,15 +299,15 @@ module Sc2
       # @param type [Integer] 1-4 = Api::ActionMultiPanel::Type::*
       # @param unit_index [Integer] n'th unit on panel
       #   enum Type {
-      #     SingleSelect = 1;         // Click on icon
-      #     DeselectUnit = 2;         // Shift Click on icon
-      #     SelectAllOfType = 3;      // Control Click on icon.
-      #     DeselectAllOfType = 4;    // Control+Shift Click on icon.
+      #       SINGLE_SELECT = 1;         // CLICK ON ICON
+      #       DESELECT_UNIT = 2;         // SHIFT CLICK ON ICON
+      #       SELECT_ALL_OF_TYPE = 3;      // CONTROL CLICK ON ICON.
+      #       DESELECT_ALL_OF_TYPE = 4;    // CONTROL+SHIFT CLICK ON ICON.
+      #   }
+      #   message ActionMultiPanel {
+      #     optional Type type = 1;
+      #     optional int32 unit_index = 2;
       #   }
-      # message ActionMultiPanel {
-      #   optional Type type = 1;
-      #   optional int32 unit_index = 2;
-      # }
       def action_ui_multi_panel(type:, unit_index:)
         queue_action Api::Action.new(
           action_ui: Api::ActionUI.new(
@@ -359,8 +359,8 @@ module Sc2
 
       # Send a chat message
       # @param message [String] to send
-      # @param channel [Integer] 1-2, default:Team  Api::ActionChat::Channel::Broadcast = 1, Api::ActionChat::Channel::Team = 2
-      def action_chat(message, channel: Api::ActionChat::Channel::Team)
+      # @param channel [Integer] 1-2, default:TEAM  Api::ActionChat::Channel::BROADCAST = 1, Api::ActionChat::Channel::TEAM = 2
+      def action_chat(message, channel: Api::ActionChat::Channel::TEAM)
         queue_action Api::Action.new(
           action_chat: Api::ActionChat.new(
             channel: channel,
@@ -371,24 +371,43 @@ module Sc2
 
       private
 
+      # @private
+      # Clears action errors. The list should be empty before we
+      # do build the errors from our batch action of this step
+      def clear_action_errors
+        @action_errors = []
+      end
+
       # Sends actions via api and flushes action_queue
+      # @return [Api::ResponseAction, nil]
       def perform_actions
-        # request_actions = []
-        # @action_queue.each do |queue_type, actions|
-        #   request_actions.push(actions)
-        # end
-
-        @api.action(@action_queue) unless @action_queue.empty?
+        return nil if @action_queue.empty?
+
+        response_action = @api.action(@action_queue)
+        if callback_defined?(:on_action_errors)
+          # Clear action errors
+          clear_action_errors
+          # Loop over every executed action response
+          response_action.result.each_with_index do |action_result, i|
+            next if action_result == Api::ActionResult::SUCCESS
+            executed_action = @action_queue[i]
+            next unless [Api::ActionRaw, Api::ActionUI].include?(executed_action.action_type) # undetectable Api::ActionSpatial,
+
+            @action_errors << Api::ActionError.new(
+              unit_tag: executed_action.unit_tags.first,
+              ability_id: executed_action.ability_id,
+              result: action_result
+            )
+          end
+        end
         clear_action_queue
+        response_action
       end
 
       # Empties and resets @action_queue
       # @return [void]
       def clear_action_queue
         @action_queue = []
-        # TYPES.each do |type|
-        #   @action_queue[type] = []
-        # end
       end
 
       # Returns an array of unit tags from a variety of sources