sc2ai 0.0.8 → 0.2.0

data/sig/sc2ai.rbs

@@ -23,86 +23,10 @@ module Sc2
   class Error < StandardError
   end
 
-  # Holds game data from tech tree and Api::ResponseData
-  # Called once on game start
-  class Data
-    # sord warn - Api::ResponseData wasn't able to be resolved to a constant in this project
-    # _@param_ `data`
-    def initialize: (Api::ResponseData data) -> void
-
-    # sord warn - Api::AbilityData wasn't able to be resolved to a constant in this project
-    # sord warn - "Hash<Integer, Api::AbilityData] indexed data" does not appear to be a type
-    # Indexes ability data by ability id
-    # 
-    # _@param_ `abilities`
-    # 
-    # _@return_ — Hash<Integer, Api::AbilityData] indexed data
-    def abilities_from_proto: (::Array[Api::AbilityData] abilities) -> SORD_ERROR_HashIntegerApiAbilityDataindexeddata
-
-    # Indexes unit data by id
-    # 
-    # _@param_ `units`
-    # 
-    # _@return_ — indexed data
-    def units_from_proto: (::Array[Api::UnitTypeData] units) -> ::Hash[Integer, Api::UnitTypeData]
-
-    # sord warn - Api::UpgradeData wasn't able to be resolved to a constant in this project
-    # sord warn - "Hash<Integer, Api::UpgradeData] indexed data" does not appear to be a type
-    # Indexes upgrades data by id
-    # 
-    # _@param_ `upgrades`
-    # 
-    # _@return_ — Hash<Integer, Api::UpgradeData] indexed data
-    def upgrades_from_proto: (::Array[Api::UpgradeData] upgrades) -> SORD_ERROR_HashIntegerApiUpgradeDataindexeddata
-
-    # sord omit - no YARD type given for "effects", using untyped
-    # sord omit - no YARD return type given, using untyped
-    def effects_from_proto: (untyped effects) -> untyped
-
-    # sord omit - no YARD type given for "buffs", using untyped
-    # sord omit - no YARD return type given, using untyped
-    def buffs_from_proto: (untyped buffs) -> untyped
-
-    # sord omit - no YARD return type given, using untyped
-    # Overrides unit data from api to implement fixes or change context
-    # i.e. Api::UnitTypeId::ORBITALCOMMAND cost is cost-to-upgrade instead of CC + Orbital combined cost.
-    # Run once. Depends on all data already being set.
-    def override_unit_data: () -> untyped
-
-    # sord omit - no YARD return type given, using untyped
-    # Fixes mineral_cost, vespene_cost and food_required values
-    def correct_unit_type_costs: () -> untyped
-
-    # sord omit - no YARD return type given, using untyped
-    # Fixes mineral_cost_sum, vespene_cost_sum
-    def correct_unit_type_sum: () -> untyped
-
-    # sord warn - Api::AbilityData wasn't able to be resolved to a constant in this project
-    # _@return_ — AbilityId => AbilityData
-    attr_accessor abilities: (::Hash[Integer, Api::AbilityData] | untyped)
-
-    # _@return_ — UnitId => UnitTypeData
-    attr_accessor units: (::Hash[Integer, Api::UnitTypeData] | untyped)
-
-    # sord warn - Api::UpgradeData wasn't able to be resolved to a constant in this project
-    # _@return_ — UpgradeId => UpgradeData
-    attr_accessor upgrades: (::Hash[Integer, Api::UpgradeData] | untyped)
-
-    # sord omit - no YARD type given for :buffs, using untyped
-    # Not particularly useful data. Just use BuffId directly
-    #   @return [Hash<Integer, Api::BuffData>] BuffId => BuffData
-    attr_accessor buffs: untyped
-
-    # sord omit - no YARD type given for :effects, using untyped
-    # Not particularly useful data. Just use EffectId directly
-    #   @return [Hash<Integer, Api::EffectData>] EffectId => EffectData
-    attr_accessor effects: untyped
-  end
-
   # Helps determine common paths to sc2 install dir, executable and maps.
   # It maintains some semblance of compatibility with python-sc2 config
   # 
-  # ENV['SC2PATH'] can be set manually to Starcraft 2 base directory for Linux
+  # ENV['SC2PATH'] can be set manually to StarCraft 2 base directory for Linux
   # ENV['SC2PF'] can and should be manually set to "WineLinux" when running Wine
   # Credit to Hannes, Sean and Burny for setting the standard
   class Paths
@@ -453,28 +377,8 @@ module Sc2
     # _@see_ `#join_game` — for options
     attr_accessor interface_options: ::Hash[untyped, untyped]
 
-    # sord warn - Api::Race::NoRace wasn't able to be resolved to a constant in this project
-    # sord warn - Api::Race::Terran wasn't able to be resolved to a constant in this project
-    # sord warn - Api::Race::Zerg wasn't able to be resolved to a constant in this project
-    # sord warn - Api::Race::Protoss wasn't able to be resolved to a constant in this project
-    # sord warn - Api::Race::Random wasn't able to be resolved to a constant in this project
-    # sord warn - Api::Race::NoRace wasn't able to be resolved to a constant in this project
-    # sord warn - Api::Race::Terran wasn't able to be resolved to a constant in this project
-    # sord warn - Api::Race::Zerg wasn't able to be resolved to a constant in this project
-    # sord warn - Api::Race::Protoss wasn't able to be resolved to a constant in this project
-    # sord warn - Api::Race::Random wasn't able to be resolved to a constant in this project
-    # _@return_ — if Observer
-    # 
-    # _@return_ — if is_a? Bot, Human, BotProcess
-    # 
-    # _@return_ — if is_a? Bot, Human, BotProcess
-    # 
-    # _@return_ — if is_a? Bot, Human, BotProcess
-    # 
-    # _@return_ — if specified random and in-game race hasn't been scouted yet
-    # 
-    # _@return_ — if is_a? forgetful person
-    attr_accessor race: (Api::Race::NoRace | Api::Race::Terran | Api::Race::Zerg | Api::Race::Protoss | Api::Race::Random)?
+    # _@return_ — Api::Race enum
+    attr_accessor race: Integer
 
     # _@return_ — in-game name
     attr_accessor name: String
@@ -766,6 +670,35 @@ module Sc2
       # _@param_ `color` — default white
       def debug_draw_sphere: (point: Api::Point, ?radius: Float, ?color: Api::Color?) -> void
 
+      # sord warn - Api::Position wasn't able to be resolved to a constant in this project
+      # sord omit - no YARD return type given, using untyped
+      # Renders a block on the floor, drawn by 4 lines
+      # Pass in either a pos (Position/Unit) or exact x * y coordinates
+      # Optional indentation adds padding on borders inward
+      # 
+      # _@param_ `pos`
+      # 
+      # _@param_ `x`
+      # 
+      # _@param_ `y`
+      # 
+      # _@param_ `color`
+      # 
+      # _@param_ `indent` — default 0.05. should be lower than < 1.0
+      # 
+      # ```ruby
+      # debug_tile(x: 12.3, y: 4.56, color: Api::Color.new(r: 255, g: 0, b: 0))
+      # debug_tile(some_unit)
+      # debug_tile(some_unit.pos)
+      # ```
+      def debug_tile: (
+                        ?(Api::Unit | Api::Position)? pos,
+                        ?x: (Float | Integer)?,
+                        ?y: (Float | Integer)?,
+                        ?color: Api::Color?,
+                        ?indent: Float
+                      ) -> untyped
+
       # Possible values:
       #  Api::DebugGameState::Show_map
       #  Api::DebugGameState::Control_enemy
@@ -1058,12 +991,16 @@ module Sc2
       # _@return_ — unit tag array
       def unit_tags_from_source: ((Integer | ::Array[Integer] | Api::Unit | Sc2::UnitGroup) source) -> ::Array[Integer]
 
+      # sord omit - no YARD type given for "upgrade_id", using untyped
+      # Returns true if this upgrade has finished researching
+      def upgrade_completed?: (untyped upgrade_id) -> bool
+
       # Returns the upgrade ids which are researching or queued
       # Not set for enemy.
       def upgrades_in_progress: () -> ::Array[Integer]
 
       # sord omit - no YARD type given for "upgrade_id", using untyped
-      # Returns the upgrade ids which are researching or queued
+      # Returns true if the upgrade is busy researching
       def upgrade_in_progress?: (untyped upgrade_id) -> bool
 
       # sord omit - no YARD type given for "unit_type_id", using untyped
@@ -1164,7 +1101,7 @@ module Sc2
       attr_accessor previous: (Sc2::Player::PreviousState | untyped)
 
       # _@return_ — geo and map helper functions
-      attr_accessor geo: (Sc2::Player::Geometry | untyped)
+      attr_accessor geo: (Sc2::Player::Geo | untyped)
     end
 
     # A specialized type of player instance which each player has one of
@@ -1187,12 +1124,16 @@ module Sc2
       # _@return_ — Api::Race if race detected, false otherwise
       def detect_race_from_units: () -> (bool | Integer)
 
+      # sord omit - no YARD type given for "upgrade_id", using untyped
+      # Returns true if this upgrade has finished researching
+      def upgrade_completed?: (untyped upgrade_id) -> bool
+
       # Returns the upgrade ids which are researching or queued
       # Not set for enemy.
       def upgrades_in_progress: () -> ::Array[Integer]
 
       # sord omit - no YARD type given for "upgrade_id", using untyped
-      # Returns the upgrade ids which are researching or queued
+      # Returns true if the upgrade is busy researching
       def upgrade_in_progress?: (untyped upgrade_id) -> bool
 
       # sord omit - no YARD type given for "unit_type_id", using untyped
@@ -1338,924 +1279,962 @@ module Sc2
       def initialize: (?name: String?) -> void
     end
 
-    # WARNING! Debug methods will not be available on Ladder
-    # This provides debug helper functions for RequestDebug
-    module Debug
-      # sord warn - Api::DebugCommand wasn't able to be resolved to a constant in this project
-      # Queues debug command for performing later
-      # 
-      # _@param_ `debug_command`
-      def queue_debug_command: (Api::DebugCommand debug_command) -> void
+    # Holds map and geography helper functions
+    class Geo
+      # sord omit - no YARD type given for "bot", using untyped
+      def initialize: (untyped _bot) -> void
 
-      # sord warn - Size wasn't able to be resolved to a constant in this project
-      # Prints debug text top left corner
-      # 
-      # _@param_ `text` — will respect newlines
+      # Gets the map tile width. Range is 1-255.
+      # Effected by crop_to_playable_area
+      def map_width: () -> Integer
+
+      # Gets the map tile height. Range is 1-255.
+      # Effected by crop_to_playable_area
+      def map_height: () -> Integer
+
+      # Center of the map
+      def map_center: () -> Api::Point2D
+
+      # Returns zero to map_width as range
       # 
-      # _@param_ `size` — of font, default 14px
-      def debug_print: (String text, ?size: Size) -> void
+      # _@return_ — 0 to map_width
+      def map_range_x: () -> ::Range[untyped]
 
-      # sord warn - Size wasn't able to be resolved to a constant in this project
-      # Prints text on screen from top and left
+      # Returns zero to map_height as range
       # 
-      # _@param_ `text` — will respect newlines
+      # _@return_ — 0 to map_height
+      def map_range_y: () -> ::Range[untyped]
+
+      # Returns zero to map_width-1 as range
+      def map_tile_range_x: () -> ::Range[untyped]
+
+      # Returns zero to map_height-1 as range
+      def map_tile_range_y: () -> ::Range[untyped]
+
+      # Returns whether a x/y (integer) is placeable as per minimap image data.
+      # It does not say whether a position is occupied by another building.
+      # One pixel covers one whole block. Corrects floats on your behalf
       # 
-      # _@param_ `left_percent` — range 0..100. percent from left of screen
+      # _@param_ `x`
       # 
-      # _@param_ `top_percent` — range 0..100. percent from top of screen
+      # _@param_ `y`
       # 
-      # _@param_ `color` — default white
+      # _@return_ — whether tile is placeable?
       # 
-      # _@param_ `size` — of font, default 14px
-      def debug_text_screen: (
-                               String text,
-                               ?left_percent: Numeric,
-                               ?top_percent: Numeric,
-                               ?color: Api::Color?,
-                               ?size: Size
-                             ) -> void
+      # _@see_ `Sc2::Player#pathable?` — for detecting obstructions
+      def placeable?: (x: (Float | Integer), y: (Float | Integer)) -> bool
 
-      # sord warn - Size wasn't able to be resolved to a constant in this project
-      # Prints text on screen at 3d world position
-      # 
-      # _@param_ `text` — will respect newlines
+      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
+      # Returns a parsed placement_grid from bot.game_info.start_raw.
+      # Each value in [row][column] holds a boolean value represented as an integer
+      # It does not say whether a position is occupied by another building.
+      # One pixel covers one whole block. Rounds fractionated positions down.
+      def parsed_placement_grid: () -> Numo::Bit
+
+      # Whether this tile is where an expansion is supposed to be placed.
+      # To see if a unit/structure is blocking an expansion, pass their coordinates to this method.
       # 
-      # _@param_ `point` — point in the world, i.e. unit.pos
+      # _@param_ `x`
       # 
-      # _@param_ `color` — default white
+      # _@param_ `y`
       # 
-      # _@param_ `size` — of font, default 14px
-      def debug_text_world: (
-                              String text,
-                              point: Api::Point,
-                              ?color: Api::Color?,
-                              ?size: Size
-                            ) -> void
+      # _@return_ — true if location has creep on it
+      def expo_placement?: (x: (Float | Integer), y: (Float | Integer)) -> bool
 
-      # Draws a line between two Api::Point's for color
+      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
+      # Returns a grid where only the expo locations are marked
+      def expo_placement_grid: () -> Numo::Bit
+
+      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
+      # Returns a grid where only placement obstructions are marked
+      # includes Tumors and lowered Supply Depots
+      def placement_obstruction_grid: () -> Numo::Bit
+
+      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
+      # Returns a grid where powered locations are marked true
+      def parsed_power_grid: () -> Numo::Bit
+
+      # Returns whether a x/y block is powered. Only fully covered blocks are true.
+      # One pixel covers one whole block. Corrects float inputs on your behalf.
       # 
-      # _@param_ `p0` — the first point
+      # _@param_ `x`
       # 
-      # _@param_ `p1` — the second point
+      # _@param_ `y`
       # 
-      # _@param_ `color` — default white
-      def debug_draw_line: (p0: Api::Point, p1: Api::Point, ?color: Api::Color?) -> void
+      # _@return_ — true if location is powered
+      def powered?: (x: (Float | Integer), y: (Float | Integer)) -> bool
 
-      # Draws a box around position xy at base of z. Good for structure boxing.
+      # Returns whether a x/y block is pathable as per minimap
+      # One pixel covers one whole block. Corrects float inputs on your behalf.
       # 
-      # _@param_ `point`
+      # _@param_ `x`
       # 
-      # _@param_ `radius` — default one tile wide, 1.0
+      # _@param_ `y`
       # 
-      # _@param_ `color` — default white. min(r,b) is used for both r&b
+      # _@return_ — whether tile is patahble
+      def pathable?: (x: (Float | Integer), y: (Float | Integer)) -> bool
+
+      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
+      # Gets the pathable areas as things stand right now in the game
+      # Buildings, minerals, structures, etc. all result in a nonpathable place
+      # 
+      # _@return_ — Numo array
       # 
       # ```ruby
-      # # Draws a box on structure placement grid
-      # debug_draw_box(point: unit.pos, radius: unit.footprint_radius)
+      # parsed_pathing_grid[0,0] # reads bottom left corner
+      # # use helper function #pathable
+      # pathable?(x: 0, y: 0) # reads bottom left corner
       # ```
-      # 
-      # _@note_ — Api::Color RGB is broken for this command. Will use min(r,b)
-      # 
-      # _@note_ — Z index is elevated 0.02 so the line is visible and doesn't clip through terrain
-      def debug_draw_box: (point: Api::Point, ?radius: Float, ?color: Api::Color?) -> void
+      def parsed_pathing_grid: () -> Numo::Bit
 
-      # Debug draws a sphere at position with a radius in color
+      # sord omit - no YARD return type given, using untyped
+      # Clears pathing-grid dependent objects like placements.
+      # Called when pathing grid gets updated
+      def clear_cached_pathing_grid: () -> untyped
+
+      # Returns the terrain height (z) at position x and y
+      # Granularity is per placement grid block, since this comes from minimap image data.
       # 
-      # _@param_ `point`
+      # _@param_ `x`
       # 
-      # _@param_ `radius` — default one tile wide, 1.0
+      # _@param_ `y`
       # 
-      # _@param_ `color` — default white
-      def debug_draw_sphere: (point: Api::Point, ?radius: Float, ?color: Api::Color?) -> void
+      # _@return_ — z axis position between -16 and 16
+      def terrain_height: (x: (Float | Integer), y: (Float | Integer)) -> Float
 
-      # Possible values:
-      #  Api::DebugGameState::Show_map
-      #  Api::DebugGameState::Control_enemy
-      #  Api::DebugGameState::Food
-      #  Api::DebugGameState::Free
-      #  Api::DebugGameState::All_resources
-      #  Api::DebugGameState::God
-      #  Api::DebugGameState::Minerals
-      #  Api::DebugGameState::Gas
-      #  Api::DebugGameState::Cooldown
-      #  Api::DebugGameState::Tech_tree
-      #  Api::DebugGameState::Upgrade
-      #  Api::DebugGameState::Fast_build
+      # Returns the terrain height (z) at position x and y for a point
       # 
-      # _@param_ `command` — one of Api::DebugGameState::*
-      def debug_game_state: (Integer command) -> void
+      # _@param_ `position`
+      # 
+      # _@return_ — z axis position between -16 and 16
+      def terrain_height_for_pos: (Sc2::Position position) -> Float
 
-      # Spawns a quantity of units under an owner at position given
+      # sord warn - Numo::SFloat wasn't able to be resolved to a constant in this project
+      # Returns a parsed terrain_height from bot.game_info.start_raw.
+      # Each value in [row][column] holds a float value which is the z height
       # 
-      # _@param_ `unit_type_id` — Api::UnitTypeId::*
+      # _@return_ — Numo array
+      def parsed_terrain_height: () -> Numo::SFloat
+
+      # Returns one of three Integer visibility indicators at tile for x & y
       # 
-      # _@param_ `owner` — typically you are 1 and 2 is enemy (see @common.player_id)
+      # _@param_ `x`
       # 
-      # _@param_ `pos` — position in 2d
+      # _@param_ `y`
       # 
-      # _@param_ `quantity` — default 1
-      def debug_create_unit: (
-                               unit_type_id: Integer,
-                               owner: Integer,
-                               pos: Api::Point2D,
-                               ?quantity: Integer
-                             ) -> void
+      # _@return_ — 0=Hidden,1= Snapshot,2=Visible
+      def visibility: (x: (Float | Integer), y: (Float | Integer)) -> Integer
 
-      # Kills a target unit or unit tag
+      # Returns whether the point (tile) is currently in vision
       # 
-      # _@param_ `unit_tags` — one or many unit tags to kill
-      def debug_kill_unit: (unit_tags: (Integer | ::Array[Integer])) -> void
-
-      # Hangs, crashes and exits the Sc2 client. DO NOT USE.
+      # _@param_ `x`
       # 
-      # _@param_ `test` — one of Api::DebugTestProcess::Test::Crash, Api::DebugTestProcess::Test::Hang, Api::DebugTestProcess::Test::Exit
+      # _@param_ `y`
       # 
-      # _@param_ `delay_ms` — default 0, how long this test is delayed
-      def debug_test_process: (test: Integer, ?delay_ms: Integer) -> void
+      # _@return_ — true if fog is completely lifted
+      def map_visible?: (x: (Float | Integer), y: (Float | Integer)) -> bool
 
-      # sord omit - no YARD return type given, using untyped
-      # Useful only for single-player "curriculum" maps
+      # Returns whether point (tile) has been seen before or currently visible
       # 
-      # _@param_ `score` — sets the score
-      def debug_set_score: (?score: Float) -> untyped
-
-      # Ends game with a specified result of either Surrender or DeclareVictory
+      # _@param_ `x`
       # 
-      # _@param_ `end_result` — either 1/2.  Api::DebugEndGame::EndResult::Surrender or Api::DebugEndGame::EndResult::DeclareVictory
-      def debug_end_game: (end_result: Integer) -> void
+      # _@param_ `y`
+      # 
+      # _@return_ — true if partially or fully lifted fog
+      def map_seen?: (x: (Float | Integer), y: (Float | Integer)) -> bool
 
-      # Sets unit_value Energy, Life or Shields for a specific unit tag to given value
+      # Returns whether the point (tile) has never been seen/explored before (dark fog)
       # 
-      # _@param_ `unit_tag`
+      # _@param_ `x`
       # 
-      # _@param_ `unit_value` — 1=Energy,2=Life,3=Shields one of Api::DebugSetUnitValue::UnitValue::*
+      # _@param_ `y`
       # 
-      # _@param_ `value` — the value which the attribute will be set to
-      def debug_set_unit_value: (unit_tag: Integer, unit_value: Integer, value: Float) -> void
-
-      # sord omit - no YARD return type given, using untyped
-      # Sends actions via api and flushes debug_commands_queue
-      def perform_debug_commands: () -> untyped
-
-      # Empties and resets @debug_queue
-      def clear_debug_command_queue: () -> void
+      # _@return_ — true if fog of war is fully dark
+      def map_unseen?: (x: (Float | Integer), y: (Float | Integer)) -> bool
 
-      # sord omit - no YARD type given for :debug_command_queue, using untyped
-      # Holds debug commands which will be queued off each time we step forward
-      attr_accessor debug_command_queue: untyped
+      # sord warn - Numo::SFloat wasn't able to be resolved to a constant in this project
+      # Returns a parsed map_state.visibility from bot.observation.raw_data.
+      # Each value in [row][column] holds one of three integers (0,1,2) to flag a vision type
+      # 
+      # _@return_ — Numo array
+      # 
+      # _@see_ `#visibility` — for reading from this value
+      def parsed_visibility_grid: () -> Numo::SFloat
 
-      # sord warn - Api::Action wasn't able to be resolved to a constant in this project
-      # sord warn - Api::Action wasn't able to be resolved to a constant in this project
-      attr_accessor debug_commands_queue: ::Array[Api::Action]
-    end
+      # Returns whether a tile has creep on it, as per minimap
+      # One pixel covers one whole block. Corrects float inputs on your behalf.
+      # 
+      # _@param_ `x`
+      # 
+      # _@param_ `y`
+      # 
+      # _@return_ — true if location has creep on it
+      def creep?: (x: (Float | Integer), y: (Float | Integer)) -> bool
 
-    # Helper methods for working with units
-    module Units
-      # Returns the upgrade ids which are researching or queued
-      # Not set for enemy.
-      def upgrades_in_progress: () -> ::Array[Integer]
+      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
+      # Provides parsed minimap representation of creep spread
+      # Caches for 4 frames
+      # 
+      # _@return_ — Numo array
+      def parsed_creep: () -> Numo::Bit
 
-      # sord omit - no YARD type given for "upgrade_id", using untyped
-      # Returns the upgrade ids which are researching or queued
-      def upgrade_in_progress?: (untyped upgrade_id) -> bool
+      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
+      # sord omit - no YARD return type given, using untyped
+      # TODO: Remove this method if it has no use. Build points uses this code directly for optimization.
+      # Reduce the dimensions of a grid by merging cells using length x length squares.
+      # Merged cell keeps it's 1 value only if all merged cells are equal to 1, else 0
+      # 
+      # _@param_ `input_grid` — Bit grid like parsed_pathing_grid or parsed_placement_grid
+      # 
+      # _@param_ `length` — how many cells to merge, i.e. 3 for finding 3x3 placement
+      def divide_grid: (Numo::Bit input_grid, Integer length) -> untyped
 
-      # sord omit - no YARD type given for "unit_type_id", using untyped
-      # For this unit type, tells you how many are in progress by checking orders for all it's sources.
-      def units_in_progress: (untyped unit_type_id) -> Integer
+      # Returns own 2d start position as set by initial camera
+      # This differs from position of first base structure
+      def start_position: () -> Api::Point2D
 
-      # Returns static [Api::UnitTypeData] for a unit
-      # 
-      # _@param_ `unit` — Api::UnitTypeId or Api::Unit
-      def unit_data: ((Integer | Api::Unit) unit) -> Api::UnitTypeData
+      # Returns the enemy 2d start position
+      def enemy_start_position: () -> Api::Point2D
 
-      # sord warn - Api::AbilityData wasn't able to be resolved to a constant in this project
-      # Returns static [Api::AbilityData] for an ability
+      # Gets expos and surrounding minerals
+      # The index is a build location for an expo and the value is a UnitGroup, which has minerals and geysers
       # 
-      # _@param_ `ability_id` — Api::AbilityId::*
-      def ability_data: (Integer ability_id) -> Api::AbilityData
-
-      # sord warn - Api::UpgradeData wasn't able to be resolved to a constant in this project
-      # Returns static [Api::UpgradeData] for an upgrade id
+      # _@return_ — Location => UnitGroup of resources (minerals+geysers)
       # 
-      # _@param_ `upgrade_id` — Api::UpgradeId::*
-      def upgrade_data: (Integer upgrade_id) -> Api::UpgradeData
+      # ```ruby
+      # random_expo = geo.expansions.keys.sample #=> Point2D
+      # expo_resources = geo.expansions[random_expo] #=> UnitGroup
+      # alive_minerals = expo_resources.minerals & neutral.minerals
+      # geysers = expo_resources.geysers
+      # ```
+      def expansions: () -> ::Hash[Api::Point2D, UnitGroup]
 
-      # Checks unit data for an attribute value
+      # Returns a list of 2d points for expansion build locations
+      # Does not contain mineral info, but the value can be checked against geo.expansions
       # 
-      # _@param_ `unit` — Api::UnitTypeId or Api::Unit
+      # _@return_ — points where expansions can be placed
       # 
-      # _@param_ `attribute` — Api::Attribute, i.e. Api::Attribute::Mechanical or :Mechanical
+      # ```ruby
+      # random_expo = expansion_points.sample
+      # expo_resources = geo.expansions[random_expo]
+      # ```
+      def expansion_points: () -> ::Array[Api::Point2D]
+
+      # Returns a slice of #expansions where a base hasn't been built yet
+      # The has index is a build position and the value is a UnitGroup of resources for the base
       # 
-      # _@return_ — whether unit has attribute
+      # _@return_ — Location => UnitGroup of resources (minerals+geysers)
       # 
       # ```ruby
-      # unit_has_attribute?(Api::UnitTypeId::SCV, Api::Attribute::Mechanical)
-      # unit_has_attribute?(units.workers.first, :Mechanical)
-      # unit_has_attribute?(Api::UnitTypeId::SCV, :Mechanical)
+      # # Lets find the nearest unoccupied expo
+      # expo_pos = expansions_unoccupied.keys.min { |p2d| p2d.distance_to(structures.hq.first) }
+      # # What minerals/geysers does it have?
+      # puts expansions_unoccupied[expo_pos].minerals # or expansions[expo_pos]... => UnitGroup
+      # puts expansions_unoccupied[expo_pos].geysers # or expansions[expo_pos]... => UnitGroup
       # ```
-      def unit_has_attribute?: ((Integer | Api::Unit) unit, Symbol attribute) -> bool
+      def expansions_unoccupied: () -> ::Hash[Api::Point2D, UnitGroup]
 
-      # Creates a unit group from all_units with matching tag
+      # Gets minerals for a base or base position
       # 
-      # _@param_ `tags` — array of unit tags
-      def unit_group_from_tags: (::Array[Integer] tags) -> Sc2::UnitGroup
-
-      # sord omit - no YARD type given for "unit_type_id", using untyped
-      # Sums the cost (mineral/vespene/supply) of unit type used for internal spend trackers
-      # This is called internally when building/morphing/training
-      def subtract_cost: (untyped unit_type_id) -> void
-
-      # sord omit - no YARD type given for "unit_type_id:", using untyped
-      # sord omit - no YARD type given for "quantity:", using untyped
-      # Checks whether you have the resources to construct quantity of unit type
-      def can_afford?: (unit_type_id: untyped, ?quantity: untyped) -> bool
+      # _@param_ `base` — base Unit or Position
+      # 
+      # _@return_ — UnitGroup of minerals for the base
+      def minerals_for_base: ((Api::Unit | Sc2::Position) base) -> Sc2::UnitGroup
 
-      # sord omit - no YARD type given for "upgrade_id", using untyped
-      # Checks whether you have the resources to
-      def can_afford_upgrade?: (untyped upgrade_id) -> bool
+      # Gets geysers for a base or base position
+      # 
+      # _@param_ `base` — base Unit or Position
+      # 
+      # _@return_ — UnitGroup of geysers for the base
+      def geysers_for_base: ((Api::Unit | Sc2::Position) base) -> Sc2::UnitGroup
 
-      # Returns whether Query Available Ability is true for unit and tag
-      # Queries API if necessary. Uses batching in the background.
+      # Gets geysers which have not been taken for a base or base position
       # 
-      # _@param_ `unit_tag`
+      # _@param_ `base` — base Unit or Position
       # 
-      # _@param_ `ability_id`
-      def unit_ability_available?: (unit_tag: Integer, ability_id: Integer) -> bool
+      # _@return_ — UnitGroup of geysers for the base
+      def geysers_open_for_base: ((Api::Unit | Sc2::Position) base) -> Sc2::UnitGroup
 
-      # sord warn - Api::Observation wasn't able to be resolved to a constant in this project
-      # sord omit - no YARD return type given, using untyped
-      # Divides raw data units into various attributes on every step
-      # Note, this needs to be fast.
+      # _@param_ `base` — base Unit or Position
       # 
-      # _@param_ `observation`
-      def parse_observation_units: (Api::Observation observation) -> untyped
+      # _@return_ — UnitGroup of resources (minerals+geysers)
+      def resources_for_base: ((Api::Unit | Sc2::Position) base) -> Sc2::UnitGroup
 
-      # Returns alliance based on whether you are a player or an enemy
+      # Gets gasses for a base or base position
       # 
-      # _@return_ — :Self or :Enemy from Api::Alliance
-      def own_alliance: () -> Symbol
+      # _@param_ `base` — base Unit or Position
+      # 
+      # _@return_ — UnitGroup of geysers for the base
+      def gas_for_base: ((Api::Unit | Sc2::Position) base) -> Sc2::UnitGroup
 
-      # Returns enemy alliance based on whether you are a player or an enemy
+      # sord omit - no YARD type given for "in_power:", using untyped
+      # Gets buildable point grid for squares of size, i.e. 3 = 3x3 placements
+      # Uses pathing grid internally, to ignore taken positions
+      # Does not query the api and is generally fast.
       # 
-      # _@return_ — :Self or :Enemy from Api::Alliance
-      def enemy_alliance: () -> Symbol
+      # _@param_ `length` — length of the building, 2 for depot/pylon, 3 for rax/gate
+      # 
+      # _@param_ `on_creep` — whether this build location should be on creep
+      # 
+      # _@return_ — Array of [x,y] tuples
+      def build_coordinates: (length: Integer, ?on_creep: bool, ?in_power: untyped) -> ::Array[::Array[[Float, Float]]]
 
-      # sord omit - no YARD type given for "unit", using untyped
-      # sord omit - no YARD return type given, using untyped
-      # Issues units/structure callbacks for units which are new
-      def issue_new_unit_callbacks: (untyped unit) -> untyped
-
-      # sord omit - no YARD type given for "unit", using untyped
-      # sord omit - no YARD type given for "previous_unit", using untyped
-      # sord omit - no YARD return type given, using untyped
-      # Issues callbacks for units over time, such as damaged or type changed
-      def issue_existing_unit_callbacks: (untyped unit, untyped previous_unit) -> untyped
-
-      attr_accessor all_units: (Sc2::UnitGroup | untyped)
-
-      # _@return_ — a group of placeholder structures
-      attr_accessor units: Sc2::UnitGroup
-
-      # sord omit - no YARD type given for :structures, using untyped
-      # A full list of all your structures (non-units)
-      attr_accessor structures: untyped
-
-      # sord omit - no YARD type given for :placeholders, using untyped
-      # A list of structures which haven't started
-      attr_accessor placeholders: untyped
-
-      # _@return_ — a group of neutral units
-      attr_accessor neutral: Sc2::UnitGroup
-
-      # _@return_ — a group of neutral units
-      attr_accessor effects: Sc2::UnitGroup
-
-      # sord omit - no YARD type given for :upgrades_completed, using untyped
-      # Returns the upgrade ids you have acquired such as weapon upgrade and armor upgrade ids.
-      # Shorthand for observation.raw_data.player.upgrade_ids
-      attr_reader upgrades_completed: untyped
-
-      # sord warn - Api::RadarRing wasn't able to be resolved to a constant in this project
-      # sord warn - Api::RadarRing wasn't able to be resolved to a constant in this project
-      # _@return_ — an array of radar rings sources
-      attr_accessor power_sources: ::Array[Api::RadarRing]
-
-      # sord omit - no YARD type given for :radar_rings, using untyped
-      # An array of Sensor tower rings as per minimap. It has a `pos` and a `radius`
-      attr_accessor radar_rings: untyped
-
-      # sord omit - no YARD type given for :_all_seen_unit_tags, using untyped
-      # Privately keep track of all seen Unit tags (excl structures) in order to detect new created units
-      attr_accessor _all_seen_unit_tags: untyped
-
-      # sord omit - no YARD type given for :all_seen_unit_tags, using untyped
-      # Privately keep track of all seen Unit tags (excl structures) in order to detect new created units
-      attr_accessor all_seen_unit_tags: untyped
-
-      # _@return_ — group of Units and Structures effected
-      attr_accessor event_units_damaged: Sc2::UnitGroup
-
-      # sord omit - no YARD type given for :event_units_destroyed, using untyped
-      # TODO: Unit buff disabled, because it calls back too often (mineral in hand). Put back if useful
-      # Units (Unit/Structure) on which a new buff_ids appeared this frame
-      # See which buffs via: unit.buff_ids - unit.previous.buff_ids
-      # Read this on_step. Alternative to callback on_unit_buffed
-      # attr_accessor :event_units_buffed
-      attr_accessor event_units_destroyed: untyped
-    end
+      # Gets a buildable location for a square of length, near target. Chooses from random amount of nearest locations.
+      # For robustness, it is advised to set `random` to, i.e. 3, to allow choosing the 3 nearest possible places, should one location be blocked.
+      # For zerg, the buildable locations are only on creep.
+      # Internally creates a kdtree for building locations based on pathable, placeable and creep
+      # 
+      # _@param_ `length` — length of the building, 2 for depot/pylon, 3 for rax/gate
+      # 
+      # _@param_ `target` — near where to find a placement
+      # 
+      # _@param_ `random` — number of nearest points to randomly choose from. 1 for nearest point.
+      # 
+      # _@param_ `in_power` — whether this must be on a power field
+      # 
+      # _@return_ — buildable location, nil if no buildable location found
+      def build_placement_near: (
+                                  length: Integer,
+                                  target: (Api::Unit | Sc2::Position),
+                                  ?random: Integer,
+                                  ?in_power: bool
+                                ) -> Api::Point2D?
 
-    # Holds action list and queues batch
-    module Actions
-      # sord warn - Api::Action wasn't able to be resolved to a constant in this project
-      # Queues action for performing end of step
+      # Draws a grid within a unit (pylon/prisms) radius, then selects points which are placeable
       # 
-      # _@param_ `action`
-      def queue_action: (Api::Action action) -> void
+      # _@param_ `source` — either a pylon or a prism
+      # 
+      # _@param_ `unit_type_id` — optionally, the unit you wish to place. Stalkers are widest, so use default nil for a mixed composition warp
+      # 
+      # _@return_ — an array of 2d points where theoretically placeable
+      def warp_points: (source: Api::Unit, ?unit_type_id: Api::Unit?) -> ::Array[Api::Point2D]
 
-      # sord omit - no YARD return type given, using untyped
-      # Queues a Api::ActionRaw. Perform ability on unit_tags optionally on target_world_space_pos/target_unit_tag
+      # Finds points in a straight line.
+      # In a line, on the angle of source->target point, starting at source+offset, in increments find points on the line up to max distance
       # 
-      # _@param_ `unit_tags`
+      # _@param_ `source` — location from which we go
       # 
-      # _@param_ `ability_id`
+      # _@param_ `target` — location towards which we go
       # 
-      # _@param_ `queue_command` — shift+command
+      # _@param_ `offset` — how far from source to start
       # 
-      # _@param_ `target_world_space_pos`
+      # _@param_ `increment` — how far apart to gets, i.e. increment = unit.radius*2 to space units in a line
       # 
-      # _@param_ `target_unit_tag`
-      def action_raw_unit_command: (
-                                     unit_tags: ::Array[Integer],
-                                     ability_id: Integer,
-                                     ?queue_command: bool,
-                                     ?target_world_space_pos: Api::Point2D?,
-                                     ?target_unit_tag: Integer?
-                                   ) -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      # Queues a Api::ActionRawUnitCommand.
-      # Send accepts a Api::Unit, tag or tags and targets Api::Point2D or unit.tag
+      # _@param_ `count` — number of points to retrieve
       # 
-      # _@param_ `units` — can be an Api::Unit, array of Api::Unit#tag or single tag
+      # _@return_ — points up to a max of count
+      def points_nearest_linear: (
+                                   source: Sc2::Position,
+                                   target: Sc2::Position,
+                                   ?offset: Float,
+                                   ?increment: Float,
+                                   ?count: Integer
+                                 ) -> ::Array[Api::Point2D]
+
+      # Gets a random point near a location with a positive/negative offset applied to both x and y
       # 
-      # _@param_ `ability_id`
+      # _@param_ `pos`
       # 
-      # _@param_ `target` — is a unit, unit tag or a Api::Point2D
+      # _@param_ `offset`
       # 
-      # _@param_ `queue_command` — shift+command
-      def action: (
-                    units: (::Array[Integer] | Integer | Api::Unit),
-                    ability_id: Integer,
-                    ?target: (Api::Unit | Integer | Api::Point2D)?,
-                    ?queue_command: bool
-                  ) -> untyped
+      # ```ruby
+      # Randomly randomly adjust both x and y by a range of -3.5 or +3.5
+      # geo.point_random_near(point: structures.hq.first, offset: 3.5)
+      # ```
+      def point_random_near: (pos: Sc2::Position, ?offset: Float) -> Api::Point2D
 
-      # sord omit - no YARD return type given, using untyped
-      # Builds target unit type using units as source at optional target
+      # _@param_ `pos`
       # 
-      # _@param_ `units` — can be an Api::Unit, array of Api::Unit#tag or single tag
+      # _@param_ `radius`
+      def point_random_on_circle: (pos: Sc2::Position, ?radius: Float) -> Api::Point2D
+
+      # _@return_ — player with active connection
+      attr_accessor bot: (Sc2::Player | untyped)
+    end
+
+    # WARNING! Debug methods will not be available on Ladder
+    # This provides debug helper functions for RequestDebug
+    module Debug
+      # sord warn - Api::DebugCommand wasn't able to be resolved to a constant in this project
+      # Queues debug command for performing later
       # 
-      # _@param_ `unit_type_id` — Api::UnitTypeId the unit type you wish to build
+      # _@param_ `debug_command`
+      def queue_debug_command: (Api::DebugCommand debug_command) -> void
+
+      # sord warn - Size wasn't able to be resolved to a constant in this project
+      # Prints debug text top left corner
       # 
-      # _@param_ `target` — is a unit tag or a Api::Point2D. Nil for addons/orbital
+      # _@param_ `text` — will respect newlines
       # 
-      # _@param_ `queue_command` — shift+command
-      def build: (
-                   units: (::Array[Integer] | Integer | Api::Unit),
-                   unit_type_id: Integer,
-                   ?target: (Api::Point2D | Integer)?,
-                   ?queue_command: bool
-                 ) -> untyped
+      # _@param_ `size` — of font, default 14px
+      def debug_print: (String text, ?size: Size) -> void
 
-      # sord omit - no YARD return type given, using untyped
-      # Warps in unit type at target (location or pylon) with optional source units (warp gates)
-      # When not specifying the specific warp gate(s), all warpgates will be used
+      # sord warn - Size wasn't able to be resolved to a constant in this project
+      # Prints text on screen from top and left
       # 
-      # _@param_ `unit_type_id` — Api::UnitTypeId the unit type you wish to build
+      # _@param_ `text` — will respect newlines
       # 
-      # _@param_ `queue_command` — shift+command
+      # _@param_ `left_percent` — range 0..100. percent from left of screen
       # 
-      # _@param_ `target` — is a unit tag or a Api::Point2D
+      # _@param_ `top_percent` — range 0..100. percent from top of screen
       # 
-      # _@param_ `units`
-      def warp: (
-                  unit_type_id: Integer,
-                  target: (Api::Point2D | Integer),
-                  queue_command: bool,
-                  ?units: (::Array[Integer] | Integer | Api::Unit)?
-                ) -> untyped
+      # _@param_ `color` — default white
+      # 
+      # _@param_ `size` — of font, default 14px
+      def debug_text_screen: (
+                               String text,
+                               ?left_percent: Numeric,
+                               ?top_percent: Numeric,
+                               ?color: Api::Color?,
+                               ?size: Size
+                             ) -> void
 
-      # sord omit - no YARD return type given, using untyped
-      # Research a specific upgrade
+      # sord warn - Size wasn't able to be resolved to a constant in this project
+      # Prints text on screen at 3d world position
       # 
-      # _@param_ `units` — can be an Api::Unit, array of Api::Unit#tag or single tag
+      # _@param_ `text` — will respect newlines
       # 
-      # _@param_ `upgrade_id` — Api::UpgradeId to research
+      # _@param_ `point` — point in the world, i.e. unit.pos
       # 
-      # _@param_ `queue_command` — shift+command
-      def research: (units: (::Array[Integer] | Integer | Api::Unit), upgrade_id: Integer, ?queue_command: bool) -> untyped
+      # _@param_ `color` — default white
+      # 
+      # _@param_ `size` — of font, default 14px
+      def debug_text_world: (
+                              String text,
+                              point: Api::Point,
+                              ?color: Api::Color?,
+                              ?size: Size
+                            ) -> void
 
-      # Toggles auto-cast ability for units
+      # Draws a line between two Api::Point's for color
       # 
-      # _@param_ `units` — can be an Api::Unit, array of Tags or single Tag
+      # _@param_ `p0` — the first point
       # 
-      # _@param_ `ability_id`
-      def action_raw_toggle_autocast: (units: (::Array[Integer] | Integer | Api::Unit), ability_id: Integer) -> void
+      # _@param_ `p1` — the second point
+      # 
+      # _@param_ `color` — default white
+      def debug_draw_line: (p0: Api::Point, p1: Api::Point, ?color: Api::Color?) -> void
 
-      # Toggles auto-cast ability for units
+      # Draws a box around position xy at base of z. Good for structure boxing.
       # 
       # _@param_ `point`
-      def action_raw_camera_move: (point: Api::Point) -> void
-
-      # sord warn - Api::Point2I wasn't able to be resolved to a constant in this project
-      # sord warn - Api::Point2I wasn't able to be resolved to a constant in this project
-      # Issues spatial unit command. Target is either target_screen_coord or target_minimap_coord.
       # 
-      # _@param_ `ability_id`
+      # _@param_ `radius` — default one tile wide, 1.0
       # 
-      # _@param_ `target_screen_coord`
+      # _@param_ `color` — default white. min(r,b) is used for both r&b
       # 
-      # _@param_ `target_minimap_coord`
+      # ```ruby
+      # # Draws a box on structure placement grid
+      # debug_draw_box(point: unit.pos, radius: unit.footprint_radius)
+      # ```
       # 
-      # _@param_ `queue_command` — shift+command
-      def action_spatial_unit_command: (
-                                         ability_id: Api::AbilityId,
-                                         ?target_screen_coord: Api::Point2I?,
-                                         ?target_minimap_coord: Api::Point2I?,
-                                         ?queue_command: bool
-                                       ) -> void
-
-      # sord warn - Api::Point2I wasn't able to be resolved to a constant in this project
-      # Simulates a click on the minimap to move the camera.
+      # _@note_ — Api::Color RGB is broken for this command. Will use min(r,b)
       # 
-      # _@param_ `center_minimap`
-      def action_spatial_camera_move: (center_minimap: Api::Point2I) -> void
+      # _@note_ — Z index is elevated 0.02 so the line is visible and doesn't clip through terrain
+      def debug_draw_box: (point: Api::Point, ?radius: Float, ?color: Api::Color?) -> void
 
-      # Issues spatial unit select point command. Target is either target_screen_coord or target_minimap_coord.
+      # Debug draws a sphere at position with a radius in color
       # 
-      # _@param_ `type` — 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. }
+      # _@param_ `point`
       # 
-      # _@param_ `selection_screen_coord`
-      def action_spatial_unit_selection_point: (?_type: Integer, ?selection_screen_coord: Api::PointI?) -> void
+      # _@param_ `radius` — default one tile wide, 1.0
+      # 
+      # _@param_ `color` — default white
+      def debug_draw_sphere: (point: Api::Point, ?radius: Float, ?color: Api::Color?) -> void
 
-      # sord warn - Api::RectangleI wasn't able to be resolved to a constant in this project
-      # Issue rectangle select
+      # sord warn - Api::Position wasn't able to be resolved to a constant in this project
+      # sord omit - no YARD return type given, using untyped
+      # Renders a block on the floor, drawn by 4 lines
+      # Pass in either a pos (Position/Unit) or exact x * y coordinates
+      # Optional indentation adds padding on borders inward
       # 
-      # _@param_ `selection_screen_coord` — rectangle coordinates
+      # _@param_ `pos`
       # 
-      # _@param_ `selection_add` — default false Equivalent to shift+drag. Adds units to selection. default false
-      def action_spatial_unit_selection_rect: (selection_screen_coord: Api::RectangleI, ?selection_add: bool) -> void
-
-      # Perform action on control group like setting or recalling, use in conjunction with unit selection.
-      # Populated if Feature Layer or Render interface is enabled.
+      # _@param_ `x`
       # 
-      # _@param_ `action` — 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. }
+      # _@param_ `y`
       # 
-      # _@param_ `control_group_index` — 0-9
-      def action_ui_control_group: (action: Integer, control_group_index: Integer) -> void
-
-      # Selects army (F2)
+      # _@param_ `color`
       # 
-      # _@param_ `selection_add` — default false To add to other selected items
-      def action_ui_select_army: (?selection_add: bool) -> void
-
-      # Selects warp gates (Protoss)
+      # _@param_ `indent` — default 0.05. should be lower than < 1.0
       # 
-      # _@param_ `selection_add` — default false To add to other selected items
-      def action_ui_select_warp_gates: (?selection_add: bool) -> void
-
-      # Selects larva (Zerg)
-      def action_ui_select_larva: () -> void
+      # ```ruby
+      # debug_tile(x: 12.3, y: 4.56, color: Api::Color.new(r: 255, g: 0, b: 0))
+      # debug_tile(some_unit)
+      # debug_tile(some_unit.pos)
+      # ```
+      def debug_tile: (
+                        ?(Api::Unit | Api::Position)? pos,
+                        ?x: (Float | Integer)?,
+                        ?y: (Float | Integer)?,
+                        ?color: Api::Color?,
+                        ?indent: Float
+                      ) -> untyped
 
-      # sord omit - no YARD return type given, using untyped
-      # Select idle workers
+      # Possible values:
+      #  Api::DebugGameState::Show_map
+      #  Api::DebugGameState::Control_enemy
+      #  Api::DebugGameState::Food
+      #  Api::DebugGameState::Free
+      #  Api::DebugGameState::All_resources
+      #  Api::DebugGameState::God
+      #  Api::DebugGameState::Minerals
+      #  Api::DebugGameState::Gas
+      #  Api::DebugGameState::Cooldown
+      #  Api::DebugGameState::Tech_tree
+      #  Api::DebugGameState::Upgrade
+      #  Api::DebugGameState::Fast_build
       # 
-      # _@param_ `type` — 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. }
-      def action_ui_select_idle_worker: (_type: Integer) -> untyped
+      # _@param_ `command` — one of Api::DebugGameState::*
+      def debug_game_state: (Integer command) -> void
 
-      # sord omit - no YARD return type given, using untyped
-      # Multi-panel actions for select/deselect
-      # message ActionMultiPanel {
-      #   optional Type type = 1;
-      #   optional int32 unit_index = 2;
-      # }
+      # Spawns a quantity of units under an owner at position given
       # 
-      # _@param_ `type` — 1-4 = Api::ActionMultiPanel::Type::*
+      # _@param_ `unit_type_id` — Api::UnitTypeId::*
       # 
-      # _@param_ `unit_index` — 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. }
-      def action_ui_multi_panel: (_type: Integer, unit_index: Integer) -> untyped
+      # _@param_ `owner` — typically you are 1 and 2 is enemy (see @common.player_id)
+      # 
+      # _@param_ `pos` — position in 2d
+      # 
+      # _@param_ `quantity` — default 1
+      def debug_create_unit: (
+                               unit_type_id: Integer,
+                               owner: Integer,
+                               pos: Api::Point2D,
+                               ?quantity: Integer
+                             ) -> void
 
-      # sord omit - no YARD return type given, using untyped
-      # Cargo panel actions for unloading units.
+      # Kills a target unit or unit tag
       # 
-      # _@param_ `unit_index` — index of unit to unload
-      def action_ui_cargo_panel_unload: (unit_index: Integer) -> untyped
+      # _@param_ `unit_tags` — one or many unit tags to kill
+      def debug_kill_unit: (unit_tags: (Integer | ::Array[Integer])) -> void
+
+      # Hangs, crashes and exits the Sc2 client. DO NOT USE.
+      # 
+      # _@param_ `test` — one of Api::DebugTestProcess::Test::Crash, Api::DebugTestProcess::Test::Hang, Api::DebugTestProcess::Test::Exit
+      # 
+      # _@param_ `delay_ms` — default 0, how long this test is delayed
+      def debug_test_process: (test: Integer, ?delay_ms: Integer) -> void
 
       # sord omit - no YARD return type given, using untyped
-      # Remove unit from production queue
+      # Useful only for single-player "curriculum" maps
       # 
-      # _@param_ `unit_index` — target unit index
-      def action_ui_production_panel_remove_from_queue: (unit_index: Integer) -> untyped
+      # _@param_ `score` — sets the score
+      def debug_set_score: (?score: Float) -> untyped
 
-      # sord omit - no YARD return type given, using untyped
-      # Toggle autocast on selected unit. Also possible with raw actions using a unit target.
+      # Ends game with a specified result of either Surrender or DeclareVictory
       # 
-      # _@param_ `ability_id` — Api::AbilityId::* ability
-      def action_ui_toggle_autocast: (ability_id: Integer) -> untyped
+      # _@param_ `end_result` — either 1/2.  Api::DebugEndGame::EndResult::Surrender or Api::DebugEndGame::EndResult::DeclareVictory
+      def debug_end_game: (end_result: Integer) -> void
 
-      # sord omit - no YARD return type given, using untyped
-      # Send a chat message
+      # Sets unit_value Energy, Life or Shields for a specific unit tag to given value
       # 
-      # _@param_ `message` — to send
+      # _@param_ `unit_tag`
       # 
-      # _@param_ `channel` — 1-2, default:Team  Api::ActionChat::Channel::Broadcast = 1, Api::ActionChat::Channel::Team = 2
-      def action_chat: (String message, ?channel: Integer) -> untyped
+      # _@param_ `unit_value` — 1=Energy,2=Life,3=Shields one of Api::DebugSetUnitValue::UnitValue::*
+      # 
+      # _@param_ `value` — the value which the attribute will be set to
+      def debug_set_unit_value: (unit_tag: Integer, unit_value: Integer, value: Float) -> void
 
       # sord omit - no YARD return type given, using untyped
-      # Sends actions via api and flushes action_queue
-      def perform_actions: () -> untyped
+      # Sends actions via api and flushes debug_commands_queue
+      def perform_debug_commands: () -> untyped
 
-      # Empties and resets @action_queue
-      def clear_action_queue: () -> void
+      # Empties and resets @debug_queue
+      def clear_debug_command_queue: () -> void
 
-      # Returns an array of unit tags from a variety of sources
-      # noinspection RubyMismatchedReturnType
-      # 
-      # _@param_ `source` — unit tag, tags, unit or unit group
-      # 
-      # _@return_ — unit tag array
-      def unit_tags_from_source: ((Integer | ::Array[Integer] | Api::Unit | Sc2::UnitGroup) source) -> ::Array[Integer]
+      # sord omit - no YARD type given for :debug_command_queue, using untyped
+      # Holds debug commands which will be queued off each time we step forward
+      attr_accessor debug_command_queue: untyped
 
       # sord warn - Api::Action wasn't able to be resolved to a constant in this project
-      attr_accessor action_queue: ::Array[Api::Action]
+      # sord warn - Api::Action wasn't able to be resolved to a constant in this project
+      attr_accessor debug_commands_queue: ::Array[Api::Action]
     end
 
-    # Holds map and geography helper functions
-    class Geometry
-      # sord omit - no YARD type given for "bot", using untyped
-      def initialize: (untyped _bot) -> void
+    # Helper methods for working with units
+    module Units
+      # sord omit - no YARD type given for "upgrade_id", using untyped
+      # Returns true if this upgrade has finished researching
+      def upgrade_completed?: (untyped upgrade_id) -> bool
 
-      # Gets the map tile width. Range is 1-255.
-      # Effected by crop_to_playable_area
-      def map_width: () -> Integer
+      # Returns the upgrade ids which are researching or queued
+      # Not set for enemy.
+      def upgrades_in_progress: () -> ::Array[Integer]
 
-      # Gets the map tile height. Range is 1-255.
-      # Effected by crop_to_playable_area
-      def map_height: () -> Integer
+      # sord omit - no YARD type given for "upgrade_id", using untyped
+      # Returns true if the upgrade is busy researching
+      def upgrade_in_progress?: (untyped upgrade_id) -> bool
 
-      # Center of the map
-      def map_center: () -> Api::Point2D
+      # sord omit - no YARD type given for "unit_type_id", using untyped
+      # For this unit type, tells you how many are in progress by checking orders for all it's sources.
+      def units_in_progress: (untyped unit_type_id) -> Integer
 
-      # Returns zero to map_width as range
+      # Returns static [Api::UnitTypeData] for a unit
       # 
-      # _@return_ — 0 to map_width
-      def map_range_x: () -> ::Range[untyped]
+      # _@param_ `unit` — Api::UnitTypeId or Api::Unit
+      def unit_data: ((Integer | Api::Unit) unit) -> Api::UnitTypeData
 
-      # Returns zero to map_height as range
+      # sord warn - Api::AbilityData wasn't able to be resolved to a constant in this project
+      # Returns static [Api::AbilityData] for an ability
       # 
-      # _@return_ — 0 to map_height
-      def map_range_y: () -> ::Range[untyped]
-
-      # Returns zero to map_width-1 as range
-      def map_tile_range_x: () -> ::Range[untyped]
+      # _@param_ `ability_id` — Api::AbilityId::*
+      def ability_data: (Integer ability_id) -> Api::AbilityData
 
-      # Returns zero to map_height-1 as range
-      def map_tile_range_y: () -> ::Range[untyped]
+      # sord warn - Api::UpgradeData wasn't able to be resolved to a constant in this project
+      # Returns static [Api::UpgradeData] for an upgrade id
+      # 
+      # _@param_ `upgrade_id` — Api::UpgradeId::*
+      def upgrade_data: (Integer upgrade_id) -> Api::UpgradeData
 
-      # Returns whether a x/y (integer) is placeable as per minimap image data.
-      # It does not say whether a position is occupied by another building.
-      # One pixel covers one whole block. Corrects floats on your behalf
+      # Checks unit data for an attribute value
       # 
-      # _@param_ `x`
+      # _@param_ `unit` — Api::UnitTypeId or Api::Unit
       # 
-      # _@param_ `y`
+      # _@param_ `attribute` — Api::Attribute, i.e. Api::Attribute::Mechanical or :Mechanical
       # 
-      # _@return_ — whether tile is placeable?
+      # _@return_ — whether unit has attribute
       # 
-      # _@see_ `Sc2::Player#pathable?` — for detecting obstructions
-      def placeable?: (x: (Float | Integer), y: (Float | Integer)) -> bool
-
-      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
-      # Returns a parsed placement_grid from bot.game_info.start_raw.
-      # Each value in [row][column] holds a boolean value represented as an integer
-      # It does not say whether a position is occupied by another building.
-      # One pixel covers one whole block. Rounds fractionated positions down.
-      def parsed_placement_grid: () -> Numo::Bit
+      # ```ruby
+      # unit_has_attribute?(Api::UnitTypeId::SCV, Api::Attribute::Mechanical)
+      # unit_has_attribute?(units.workers.first, :Mechanical)
+      # unit_has_attribute?(Api::UnitTypeId::SCV, :Mechanical)
+      # ```
+      def unit_has_attribute?: ((Integer | Api::Unit) unit, Symbol attribute) -> bool
 
-      # Whether this tile is where an expansion is supposed to be placed.
-      # To see if a unit/structure is blocking an expansion, pass their coordinates to this method.
-      # 
-      # _@param_ `x`
-      # 
-      # _@param_ `y`
+      # Creates a unit group from all_units with matching tag
       # 
-      # _@return_ — true if location has creep on it
-      def expo_placement?: (x: (Float | Integer), y: (Float | Integer)) -> bool
+      # _@param_ `tags` — array of unit tags
+      def unit_group_from_tags: (::Array[Integer] tags) -> Sc2::UnitGroup
 
-      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
-      # Returns a grid where ony the expo locations are marked
-      def expo_placement_grid: () -> Numo::Bit
+      # sord omit - no YARD type given for "unit_type_id", using untyped
+      # Sums the cost (mineral/vespene/supply) of unit type used for internal spend trackers
+      # This is called internally when building/morphing/training
+      def subtract_cost: (untyped unit_type_id) -> void
 
-      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
-      # Returns a grid where powered locations are marked true
-      def parsed_power_grid: () -> Numo::Bit
+      # sord omit - no YARD type given for "unit_type_id:", using untyped
+      # sord omit - no YARD type given for "quantity:", using untyped
+      # Checks whether you have the resources to construct quantity of unit type
+      def can_afford?: (unit_type_id: untyped, ?quantity: untyped) -> bool
 
-      # Returns whether a x/y block is powered. Only fully covered blocks are true.
-      # One pixel covers one whole block. Corrects float inputs on your behalf.
-      # 
-      # _@param_ `x`
-      # 
-      # _@param_ `y`
-      # 
-      # _@return_ — true if location is powered
-      def powered?: (x: (Float | Integer), y: (Float | Integer)) -> bool
+      # sord omit - no YARD type given for "upgrade_id", using untyped
+      # Checks whether you have the resources to
+      def can_afford_upgrade?: (untyped upgrade_id) -> bool
 
-      # Returns whether a x/y block is pathable as per minimap
-      # One pixel covers one whole block. Corrects float inputs on your behalf.
+      # Returns whether Query Available Ability is true for unit and tag
+      # Queries API if necessary. Uses batching in the background.
       # 
-      # _@param_ `x`
+      # _@param_ `unit_tag`
       # 
-      # _@param_ `y`
+      # _@param_ `ability_id`
+      def unit_ability_available?: (unit_tag: Integer, ability_id: Integer) -> bool
+
+      # sord warn - Api::Observation wasn't able to be resolved to a constant in this project
+      # sord omit - no YARD return type given, using untyped
+      # Divides raw data units into various attributes on every step
+      # Note, this needs to be fast.
       # 
-      # _@return_ — whether tile is patahble
-      def pathable?: (x: (Float | Integer), y: (Float | Integer)) -> bool
+      # _@param_ `observation`
+      def parse_observation_units: (Api::Observation observation) -> untyped
 
-      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
-      # Gets the pathable areas as things stand right now in the game
-      # Buildings, minerals, structures, etc. all result in a nonpathable place
+      # Returns alliance based on whether you are a player or an enemy
       # 
-      # _@return_ — Numo array
+      # _@return_ — :Self or :Enemy from Api::Alliance
+      def own_alliance: () -> Symbol
+
+      # Returns enemy alliance based on whether you are a player or an enemy
       # 
-      # ```ruby
-      # parsed_pathing_grid[0,0] # reads bottom left corner
-      # # use helper function #pathable
-      # pathable?(x: 0, y: 0) # reads bottom left corner
-      # ```
-      def parsed_pathing_grid: () -> Numo::Bit
+      # _@return_ — :Self or :Enemy from Api::Alliance
+      def enemy_alliance: () -> Symbol
 
+      # sord omit - no YARD type given for "unit", using untyped
       # sord omit - no YARD return type given, using untyped
-      # Clears pathing-grid dependent objects like placements.
-      # Called when pathing grid gets updated
-      def clear_cached_pathing_grid: () -> untyped
+      # Issues units/structure callbacks for units which are new
+      def issue_new_unit_callbacks: (untyped unit) -> untyped
 
-      # Returns the terrain height (z) at position x and y
-      # Granularity is per placement grid block, since this comes from minimap image data.
-      # 
-      # _@param_ `x`
-      # 
-      # _@param_ `y`
-      # 
-      # _@return_ — z axis position between -16 and 16
-      def terrain_height: (x: (Float | Integer), y: (Float | Integer)) -> Float
+      # sord omit - no YARD type given for "unit", using untyped
+      # sord omit - no YARD type given for "previous_unit", using untyped
+      # sord omit - no YARD return type given, using untyped
+      # Issues callbacks for units over time, such as damaged or type changed
+      def issue_existing_unit_callbacks: (untyped unit, untyped previous_unit) -> untyped
 
-      # Returns the terrain height (z) at position x and y for a point
-      # 
-      # _@param_ `position`
-      # 
-      # _@return_ — z axis position between -16 and 16
-      def terrain_height_for_pos: (Sc2::Position position) -> Float
+      attr_accessor all_units: (Sc2::UnitGroup | untyped)
 
-      # sord warn - Numo::SFloat wasn't able to be resolved to a constant in this project
-      # Returns a parsed terrain_height from bot.game_info.start_raw.
-      # Each value in [row][column] holds a float value which is the z height
-      # 
-      # _@return_ — Numo array
-      def parsed_terrain_height: () -> Numo::SFloat
+      # _@return_ — a group of placeholder structures
+      attr_accessor units: Sc2::UnitGroup
+
+      # sord omit - no YARD type given for :structures, using untyped
+      # A full list of all your structures (non-units)
+      attr_accessor structures: untyped
+
+      # sord omit - no YARD type given for :placeholders, using untyped
+      # A list of structures which haven't started
+      attr_accessor placeholders: untyped
+
+      # _@return_ — a group of neutral units
+      attr_accessor neutral: Sc2::UnitGroup
+
+      # _@return_ — a group of neutral units
+      attr_accessor effects: Sc2::UnitGroup
+
+      # sord omit - no YARD type given for :upgrades_completed, using untyped
+      # Returns the upgrade ids you have acquired such as weapon upgrade and armor upgrade ids.
+      # Shorthand for observation.raw_data.player.upgrade_ids
+      attr_reader upgrades_completed: untyped
+
+      # sord warn - Api::RadarRing wasn't able to be resolved to a constant in this project
+      # sord warn - Api::RadarRing wasn't able to be resolved to a constant in this project
+      # _@return_ — an array of radar rings sources
+      attr_accessor power_sources: ::Array[Api::RadarRing]
+
+      # sord omit - no YARD type given for :radar_rings, using untyped
+      # An array of Sensor tower rings as per minimap. It has a `pos` and a `radius`
+      attr_accessor radar_rings: untyped
+
+      # sord omit - no YARD type given for :_all_seen_unit_tags, using untyped
+      # Privately keep track of all seen Unit tags (excl structures) in order to detect new created units
+      attr_accessor _all_seen_unit_tags: untyped
+
+      # sord omit - no YARD type given for :all_seen_unit_tags, using untyped
+      # Privately keep track of all seen Unit tags (excl structures) in order to detect new created units
+      attr_accessor all_seen_unit_tags: untyped
+
+      # _@return_ — group of Units and Structures effected
+      attr_accessor event_units_damaged: Sc2::UnitGroup
+
+      # sord omit - no YARD type given for :event_units_destroyed, using untyped
+      # TODO: Unit buff disabled, because it calls back too often (mineral in hand). Put back if useful
+      # Units (Unit/Structure) on which a new buff_ids appeared this frame
+      # See which buffs via: unit.buff_ids - unit.previous.buff_ids
+      # Read this on_step. Alternative to callback on_unit_buffed
+      # attr_accessor :event_units_buffed
+      attr_accessor event_units_destroyed: untyped
+    end
 
-      # Returns one of three Integer visibility indicators at tile for x & y
-      # 
-      # _@param_ `x`
-      # 
-      # _@param_ `y`
+    # Holds action list and queues batch
+    module Actions
+      # sord warn - Api::Action wasn't able to be resolved to a constant in this project
+      # Queues action for performing end of step
       # 
-      # _@return_ — 0=Hidden,1= Snapshot,2=Visible
-      def visibility: (x: (Float | Integer), y: (Float | Integer)) -> Integer
+      # _@param_ `action`
+      def queue_action: (Api::Action action) -> void
 
-      # Returns whether the point (tile) is currently in vision
-      # 
-      # _@param_ `x`
+      # sord omit - no YARD return type given, using untyped
+      # Queues a Api::ActionRaw. Perform ability on unit_tags optionally on target_world_space_pos/target_unit_tag
       # 
-      # _@param_ `y`
+      # _@param_ `unit_tags`
       # 
-      # _@return_ — true if fog is completely lifted
-      def map_visible?: (x: (Float | Integer), y: (Float | Integer)) -> bool
-
-      # Returns whether point (tile) has been seen before or currently visible
+      # _@param_ `ability_id`
       # 
-      # _@param_ `x`
+      # _@param_ `queue_command` — shift+command
       # 
-      # _@param_ `y`
+      # _@param_ `target_world_space_pos`
       # 
-      # _@return_ — true if partially or fully lifted fog
-      def map_seen?: (x: (Float | Integer), y: (Float | Integer)) -> bool
+      # _@param_ `target_unit_tag`
+      def action_raw_unit_command: (
+                                     unit_tags: ::Array[Integer],
+                                     ability_id: Integer,
+                                     ?queue_command: bool,
+                                     ?target_world_space_pos: Api::Point2D?,
+                                     ?target_unit_tag: Integer?
+                                   ) -> untyped
 
-      # Returns whether the point (tile) has never been seen/explored before (dark fog)
-      # 
-      # _@param_ `x`
+      # sord omit - no YARD return type given, using untyped
+      # Queues a Api::ActionRawUnitCommand.
+      # Send accepts a Api::Unit, tag or tags and targets Api::Point2D or unit.tag
       # 
-      # _@param_ `y`
+      # _@param_ `units` — can be an Api::Unit, array of Api::Unit#tag or single tag
       # 
-      # _@return_ — true if fog of war is fully dark
-      def map_unseen?: (x: (Float | Integer), y: (Float | Integer)) -> bool
-
-      # sord warn - Numo::SFloat wasn't able to be resolved to a constant in this project
-      # Returns a parsed map_state.visibility from bot.observation.raw_data.
-      # Each value in [row][column] holds one of three integers (0,1,2) to flag a vision type
+      # _@param_ `ability_id`
       # 
-      # _@return_ — Numo array
+      # _@param_ `target` — is a unit, unit tag or a Api::Point2D
       # 
-      # _@see_ `#visibility` — for reading from this value
-      def parsed_visibility_grid: () -> Numo::SFloat
+      # _@param_ `queue_command` — shift+command
+      def action: (
+                    units: (::Array[Integer] | Integer | Api::Unit),
+                    ability_id: Integer,
+                    ?target: (Api::Unit | Integer | Api::Point2D)?,
+                    ?queue_command: bool
+                  ) -> untyped
 
-      # Returns whether a tile has creep on it, as per minimap
-      # One pixel covers one whole block. Corrects float inputs on your behalf.
+      # sord omit - no YARD return type given, using untyped
+      # Builds target unit type using units as source at optional target
       # 
-      # _@param_ `x`
+      # _@param_ `units` — can be an Api::Unit, array of Api::Unit#tag or single tag
       # 
-      # _@param_ `y`
+      # _@param_ `unit_type_id` — Api::UnitTypeId the unit type you wish to build
       # 
-      # _@return_ — true if location has creep on it
-      def creep?: (x: (Float | Integer), y: (Float | Integer)) -> bool
-
-      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
-      # Provides parsed minimap representation of creep spread
-      # Caches for 4 frames
+      # _@param_ `target` — is a unit tag or a Api::Point2D. Nil for addons/orbital
       # 
-      # _@return_ — Numo array
-      def parsed_creep: () -> Numo::Bit
+      # _@param_ `queue_command` — shift+command
+      def build: (
+                   units: (::Array[Integer] | Integer | Api::Unit),
+                   unit_type_id: Integer,
+                   ?target: (Api::Point2D | Integer)?,
+                   ?queue_command: bool
+                 ) -> untyped
 
-      # sord warn - Numo::Bit wasn't able to be resolved to a constant in this project
       # sord omit - no YARD return type given, using untyped
-      # TODO: Remove this method if it has no use. Build points uses this code directly for optimization.
-      # Reduce the dimensions of a grid by merging cells using length x length squares.
-      # Merged cell keeps it's 1 value only if all merged cells are equal to 1, else 0
+      # Warps in unit type at target (location or pylon) with optional source units (warp gates)
+      # When not specifying the specific warp gate(s), all warpgates will be used
       # 
-      # _@param_ `input_grid` — Bit grid like parsed_pathing_grid or parsed_placement_grid
+      # _@param_ `unit_type_id` — Api::UnitTypeId the unit type you wish to build
       # 
-      # _@param_ `length` — how many cells to merge, i.e. 3 for finding 3x3 placement
-      def divide_grid: (Numo::Bit input_grid, Integer length) -> untyped
-
-      # Returns own 2d start position as set by initial camera
-      # This differs from position of first base structure
-      def start_position: () -> Api::Point2D
-
-      # Returns the enemy 2d start position
-      def enemy_start_position: () -> Api::Point2D
-
-      # Gets expos and surrounding minerals
-      # The index is a build location for an expo and the value is a UnitGroup, which has minerals and geysers
+      # _@param_ `queue_command` — shift+command
       # 
-      # _@return_ — Location => UnitGroup of resources (minerals+geysers)
+      # _@param_ `target` — is a unit tag or a Api::Point2D
       # 
-      # ```ruby
-      # random_expo = geo.expansions.keys.sample #=> Point2D
-      # expo_resources = geo.expansions[random_expo] #=> UnitGroup
-      # alive_minerals = expo_resources.minerals & neutral.minerals
-      # geysers = expo_resources.geysers
-      # ```
-      def expansions: () -> ::Hash[Api::Point2D, UnitGroup]
+      # _@param_ `units`
+      def warp: (
+                  unit_type_id: Integer,
+                  target: (Api::Point2D | Integer),
+                  queue_command: bool,
+                  ?units: (::Array[Integer] | Integer | Api::Unit)?
+                ) -> untyped
 
-      # Returns a list of 2d points for expansion build locations
-      # Does not contain mineral info, but the value can be checked against geo.expansions
+      # sord omit - no YARD return type given, using untyped
+      # Research a specific upgrade
       # 
-      # _@return_ — points where expansions can be placed
+      # _@param_ `units` — can be an Api::Unit, array of Api::Unit#tag or single tag
       # 
-      # ```ruby
-      # random_expo = expansion_points.sample
-      # expo_resources = geo.expansions[random_expo]
-      # ```
-      def expansion_points: () -> ::Array[Api::Point2D]
+      # _@param_ `upgrade_id` — Api::UpgradeId to research
+      # 
+      # _@param_ `queue_command` — shift+command
+      def research: (units: (::Array[Integer] | Integer | Api::Unit), upgrade_id: Integer, ?queue_command: bool) -> untyped
 
-      # Returns a slice of #expansions where a base hasn't been built yet
-      # The has index is a build position and the value is a UnitGroup of resources for the base
+      # Toggles auto-cast ability for units
       # 
-      # _@return_ — Location => UnitGroup of resources (minerals+geysers)
+      # _@param_ `units` — can be an Api::Unit, array of Tags or single Tag
       # 
-      # ```ruby
-      # # Lets find the nearest unoccupied expo
-      # expo_pos = expansions_unoccupied.keys.min { |p2d| p2d.distance_to(structures.hq.first) }
-      # # What minerals/geysers does it have?
-      # puts expansions_unoccupied[expo_pos].minerals # or expansions[expo_pos]... => UnitGroup
-      # puts expansions_unoccupied[expo_pos].geysers # or expansions[expo_pos]... => UnitGroup
-      # ```
-      def expansions_unoccupied: () -> ::Hash[Api::Point2D, UnitGroup]
+      # _@param_ `ability_id`
+      def action_raw_toggle_autocast: (units: (::Array[Integer] | Integer | Api::Unit), ability_id: Integer) -> void
 
-      # Gets minerals for a base or base position
-      # 
-      # _@param_ `base` — base Unit or Position
+      # Toggles auto-cast ability for units
       # 
-      # _@return_ — UnitGroup of minerals for the base
-      def minerals_for_base: ((Api::Unit | Sc2::Position) base) -> Sc2::UnitGroup
+      # _@param_ `point`
+      def action_raw_camera_move: (point: Api::Point) -> void
 
-      # Gets geysers for a base or base position
+      # sord warn - Api::Point2I wasn't able to be resolved to a constant in this project
+      # sord warn - Api::Point2I wasn't able to be resolved to a constant in this project
+      # Issues spatial unit command. Target is either target_screen_coord or target_minimap_coord.
       # 
-      # _@param_ `base` — base Unit or Position
+      # _@param_ `ability_id`
       # 
-      # _@return_ — UnitGroup of geysers for the base
-      def geysers_for_base: ((Api::Unit | Sc2::Position) base) -> Sc2::UnitGroup
-
-      # Gets geysers which have not been taken for a base or base position
+      # _@param_ `target_screen_coord`
       # 
-      # _@param_ `base` — base Unit or Position
+      # _@param_ `target_minimap_coord`
       # 
-      # _@return_ — UnitGroup of geysers for the base
-      def geysers_open_for_base: ((Api::Unit | Sc2::Position) base) -> Sc2::UnitGroup
+      # _@param_ `queue_command` — shift+command
+      def action_spatial_unit_command: (
+                                         ability_id: Api::AbilityId,
+                                         ?target_screen_coord: Api::Point2I?,
+                                         ?target_minimap_coord: Api::Point2I?,
+                                         ?queue_command: bool
+                                       ) -> void
 
-      # _@param_ `base` — base Unit or Position
+      # sord warn - Api::Point2I wasn't able to be resolved to a constant in this project
+      # Simulates a click on the minimap to move the camera.
       # 
-      # _@return_ — UnitGroup of resources (minerals+geysers)
-      def resources_for_base: ((Api::Unit | Sc2::Position) base) -> Sc2::UnitGroup
+      # _@param_ `center_minimap`
+      def action_spatial_camera_move: (center_minimap: Api::Point2I) -> void
 
-      # Gets gasses for a base or base position
+      # Issues spatial unit select point command. Target is either target_screen_coord or target_minimap_coord.
       # 
-      # _@param_ `base` — base Unit or Position
+      # _@param_ `type` — 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. }
       # 
-      # _@return_ — UnitGroup of geysers for the base
-      def gas_for_base: ((Api::Unit | Sc2::Position) base) -> Sc2::UnitGroup
+      # _@param_ `selection_screen_coord`
+      def action_spatial_unit_selection_point: (?_type: Integer, ?selection_screen_coord: Api::PointI?) -> void
 
-      # sord omit - no YARD type given for "in_power:", using untyped
-      # Gets buildable point grid for squares of size, i.e. 3 = 3x3 placements
-      # Uses pathing grid internally, to ignore taken positions
-      # Does not query the api and is generally fast.
-      # 
-      # _@param_ `length` — length of the building, 2 for depot/pylon, 3 for rax/gate
+      # sord warn - Api::RectangleI wasn't able to be resolved to a constant in this project
+      # Issue rectangle select
       # 
-      # _@param_ `on_creep` — whether this build location should be on creep
+      # _@param_ `selection_screen_coord` — rectangle coordinates
       # 
-      # _@return_ — Array of [x,y] tuples
-      def build_coordinates: (length: Integer, ?on_creep: bool, ?in_power: untyped) -> ::Array[::Array[[Float, Float]]]
+      # _@param_ `selection_add` — default false Equivalent to shift+drag. Adds units to selection. default false
+      def action_spatial_unit_selection_rect: (selection_screen_coord: Api::RectangleI, ?selection_add: bool) -> void
 
-      # Gets a buildable location for a square of length, near target. Chooses from random amount of nearest locations.
-      # For robustness, it is advised to set `random` to, i.e. 3, to allow choosing the 3 nearest possible places, should one location be blocked.
-      # For zerg, the buildable locations are only on creep.
-      # Internally creates a kdtree for building locations based on pathable, placeable and creep
-      # 
-      # _@param_ `length` — length of the building, 2 for depot/pylon, 3 for rax/gate
-      # 
-      # _@param_ `target` — near where to find a placement
-      # 
-      # _@param_ `random` — number of nearest points to randomly choose from. 1 for nearest point.
+      # Perform action on control group like setting or recalling, use in conjunction with unit selection.
+      # Populated if Feature Layer or Render interface is enabled.
       # 
-      # _@param_ `in_power` — whether this must be on a power field
+      # _@param_ `action` — 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. }
       # 
-      # _@return_ — buildable location, nil if no buildable location found
-      def build_placement_near: (
-                                  length: Integer,
-                                  target: (Api::Unit | Sc2::Position),
-                                  ?random: Integer,
-                                  ?in_power: bool
-                                ) -> Api::Point2D?
+      # _@param_ `control_group_index` — 0-9
+      def action_ui_control_group: (action: Integer, control_group_index: Integer) -> void
 
-      # Draws a grid within a unit (pylon/prisms) radius, then selects points which are placeable
-      # 
-      # _@param_ `source` — either a pylon or a prism
-      # 
-      # _@param_ `unit_type_id` — optionally, the unit you wish to place. Stalkers are widest, so use default nil for a mixed composition warp
+      # Selects army (F2)
       # 
-      # _@return_ — an array of 2d points where theoretically placeable
-      def warp_points: (source: Api::Unit, ?unit_type_id: Api::Unit?) -> ::Array[Api::Point2D]
+      # _@param_ `selection_add` — default false To add to other selected items
+      def action_ui_select_army: (?selection_add: bool) -> void
 
-      # Finds points in a straight line.
-      # In a line, on the angle of source->target point, starting at source+offset, in increments find points on the line up to max distance
+      # Selects warp gates (Protoss)
       # 
-      # _@param_ `source` — location from which we go
+      # _@param_ `selection_add` — default false To add to other selected items
+      def action_ui_select_warp_gates: (?selection_add: bool) -> void
+
+      # Selects larva (Zerg)
+      def action_ui_select_larva: () -> void
+
+      # sord omit - no YARD return type given, using untyped
+      # Select idle workers
       # 
-      # _@param_ `target` — location towards which we go
+      # _@param_ `type` — 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. }
+      def action_ui_select_idle_worker: (_type: Integer) -> untyped
+
+      # sord omit - no YARD return type given, using untyped
+      # Multi-panel actions for select/deselect
+      # message ActionMultiPanel {
+      #   optional Type type = 1;
+      #   optional int32 unit_index = 2;
+      # }
       # 
-      # _@param_ `offset` — how far from source to start
+      # _@param_ `type` — 1-4 = Api::ActionMultiPanel::Type::*
       # 
-      # _@param_ `increment` — how far apart to gets, i.e. increment = unit.radius*2 to space units in a line
+      # _@param_ `unit_index` — 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. }
+      def action_ui_multi_panel: (_type: Integer, unit_index: Integer) -> untyped
+
+      # sord omit - no YARD return type given, using untyped
+      # Cargo panel actions for unloading units.
       # 
-      # _@param_ `count` — number of points to retrieve
+      # _@param_ `unit_index` — index of unit to unload
+      def action_ui_cargo_panel_unload: (unit_index: Integer) -> untyped
+
+      # sord omit - no YARD return type given, using untyped
+      # Remove unit from production queue
       # 
-      # _@return_ — points up to a max of count
-      def points_nearest_linear: (
-                                   source: Sc2::Position,
-                                   target: Sc2::Position,
-                                   ?offset: Float,
-                                   ?increment: Float,
-                                   ?count: Integer
-                                 ) -> ::Array[Api::Point2D]
+      # _@param_ `unit_index` — target unit index
+      def action_ui_production_panel_remove_from_queue: (unit_index: Integer) -> untyped
 
-      # Gets a random point near a location with a positive/negative offset applied to both x and y
+      # sord omit - no YARD return type given, using untyped
+      # Toggle autocast on selected unit. Also possible with raw actions using a unit target.
       # 
-      # _@param_ `pos`
+      # _@param_ `ability_id` — Api::AbilityId::* ability
+      def action_ui_toggle_autocast: (ability_id: Integer) -> untyped
+
+      # sord omit - no YARD return type given, using untyped
+      # Send a chat message
       # 
-      # _@param_ `offset`
+      # _@param_ `message` — to send
       # 
-      # ```ruby
-      # Randomly randomly adjust both x and y by a range of -3.5 or +3.5
-      # geo.point_random_near(point: structures.hq.first, offset: 3.5)
-      # ```
-      def point_random_near: (pos: Sc2::Position, ?offset: Float) -> Api::Point2D
+      # _@param_ `channel` — 1-2, default:Team  Api::ActionChat::Channel::Broadcast = 1, Api::ActionChat::Channel::Team = 2
+      def action_chat: (String message, ?channel: Integer) -> untyped
 
-      # _@param_ `pos`
+      # sord omit - no YARD return type given, using untyped
+      # Sends actions via api and flushes action_queue
+      def perform_actions: () -> untyped
+
+      # Empties and resets @action_queue
+      def clear_action_queue: () -> void
+
+      # Returns an array of unit tags from a variety of sources
+      # noinspection RubyMismatchedReturnType
       # 
-      # _@param_ `radius`
-      def point_random_on_circle: (pos: Sc2::Position, ?radius: Float) -> Api::Point2D
+      # _@param_ `source` — unit tag, tags, unit or unit group
+      # 
+      # _@return_ — unit tag array
+      def unit_tags_from_source: ((Integer | ::Array[Integer] | Api::Unit | Sc2::UnitGroup) source) -> ::Array[Integer]
 
-      # _@return_ — player with active connection
-      attr_accessor bot: (Sc2::Player | untyped)
+      # sord warn - Api::Action wasn't able to be resolved to a constant in this project
+      attr_accessor action_queue: ::Array[Api::Action]
     end
 
     # Holds game state
@@ -2360,12 +2339,16 @@ module Sc2
       # _@param_ `bot`
       def after_reset: (Sc2::Player::Bot _bot) -> untyped
 
+      # sord omit - no YARD type given for "upgrade_id", using untyped
+      # Returns true if this upgrade has finished researching
+      def upgrade_completed?: (untyped upgrade_id) -> bool
+
       # Returns the upgrade ids which are researching or queued
       # Not set for enemy.
       def upgrades_in_progress: () -> ::Array[Integer]
 
       # sord omit - no YARD type given for "upgrade_id", using untyped
-      # Returns the upgrade ids which are researching or queued
+      # Returns true if the upgrade is busy researching
       def upgrade_in_progress?: (untyped upgrade_id) -> bool
 
       # sord omit - no YARD type given for "unit_type_id", using untyped
@@ -2483,117 +2466,84 @@ module Sc2
     end
   end
 
-  # Command line utilities
-  class Cli < Thor
-    def self.exit_on_failure?: () -> bool
-
-    # sord omit - no YARD return type given, using untyped
-    # downloads and install SC2 v4.10
-    def setup410: () -> untyped
-
-    # sord omit - no YARD return type given, using untyped
-    def ladderconfig: () -> untyped
-
-    # sord omit - no YARD return type given, using untyped
-    def laddermatch: () -> untyped
-
-    class New < Thor::Group
-      include Thor::Actions
-
-      # sord omit - no YARD return type given, using untyped
-      def self.source_root: () -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      def checkname: () -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      def create_target: () -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      def create_boot: () -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      def create_example_match: () -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      def create_gemfile: () -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      def create_botfile: () -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      def create_ignorefile: () -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      def copy_api: () -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      def bye: () -> untyped
-    end
-
-    # Populating "./build" with our source...
-    # - Symlink executable ./build/bin/ladder to ./.build/botname for ladder
-    # - copy our source to .build, sans .ladderignore
-    # copy .build to docker
-    # bundle install on docker
-    # zipping up code + ruby + gems
-    # get zip, clean up
-    # stop docker
-    # standard:disable Style/GlobalVars
-    class Ladderzip < Thor::Group
-      include Thor::Actions
-
-      # sord omit - no YARD return type given, using untyped
-      def docker_exists: () -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      def set_compose_file: () -> untyped
-
-      # sord omit - no YARD return type given, using untyped
-      def bot_validation: () -> untyped
+  # Holds game data from tech tree and Api::ResponseData
+  # Called once on game start
+  class Data
+    # sord warn - Api::ResponseData wasn't able to be resolved to a constant in this project
+    # _@param_ `data`
+    def initialize: (Api::ResponseData data) -> void
 
-      # sord omit - no YARD return type given, using untyped
-      def self.source_paths: () -> untyped
+    # sord warn - Api::AbilityData wasn't able to be resolved to a constant in this project
+    # sord warn - "Hash<Integer, Api::AbilityData] indexed data" does not appear to be a type
+    # Indexes ability data by ability id
+    # 
+    # _@param_ `abilities`
+    # 
+    # _@return_ — Hash<Integer, Api::AbilityData] indexed data
+    def abilities_from_proto: (::Array[Api::AbilityData] abilities) -> SORD_ERROR_HashIntegerApiAbilityDataindexeddata
 
-      # sord omit - no YARD return type given, using untyped
-      def self.source_root: () -> untyped
+    # Indexes unit data by id
+    # 
+    # _@param_ `units`
+    # 
+    # _@return_ — indexed data
+    def units_from_proto: (::Array[Api::UnitTypeData] units) -> ::Hash[Integer, Api::UnitTypeData]
 
-      # sord omit - no YARD return type given, using untyped
-      def ensure_build_dir: () -> untyped
+    # sord warn - Api::UpgradeData wasn't able to be resolved to a constant in this project
+    # sord warn - "Hash<Integer, Api::UpgradeData] indexed data" does not appear to be a type
+    # Indexes upgrades data by id
+    # 
+    # _@param_ `upgrades`
+    # 
+    # _@return_ — Hash<Integer, Api::UpgradeData] indexed data
+    def upgrades_from_proto: (::Array[Api::UpgradeData] upgrades) -> SORD_ERROR_HashIntegerApiUpgradeDataindexeddata
 
-      # sord omit - no YARD return type given, using untyped
-      def create_executable: () -> untyped
+    # sord omit - no YARD type given for "effects", using untyped
+    # sord omit - no YARD return type given, using untyped
+    def effects_from_proto: (untyped effects) -> untyped
 
-      # sord omit - no YARD return type given, using untyped
-      def start_container: () -> untyped
+    # sord omit - no YARD type given for "buffs", using untyped
+    # sord omit - no YARD return type given, using untyped
+    def buffs_from_proto: (untyped buffs) -> untyped
 
-      # sord omit - no YARD return type given, using untyped
-      def populate_build: () -> untyped
+    # sord omit - no YARD return type given, using untyped
+    # Overrides unit data from api to implement fixes or change context
+    # i.e. Api::UnitTypeId::ORBITALCOMMAND cost is cost-to-upgrade instead of CC + Orbital combined cost.
+    # Run once. Depends on all data already being set.
+    def override_unit_data: () -> untyped
 
-      # sord omit - no YARD return type given, using untyped
-      def copy_build_to_docker: () -> untyped
+    # sord omit - no YARD return type given, using untyped
+    # Fixes mineral_cost, vespene_cost and food_required values
+    def correct_unit_type_costs: () -> untyped
 
-      # sord omit - no YARD return type given, using untyped
-      def link_ladder: () -> untyped
+    # sord omit - no YARD return type given, using untyped
+    # Fixes mineral_cost_sum, vespene_cost_sum
+    def correct_unit_type_sum: () -> untyped
 
-      # sord omit - no YARD return type given, using untyped
-      def install_gems: () -> untyped
+    # sord omit - no YARD return type given, using untyped
+    # Adds placement_length to units if applicable
+    def decorate_unit_type_placement_length: () -> untyped
 
-      # sord omit - no YARD return type given, using untyped
-      def compress: () -> untyped
+    # sord warn - Api::AbilityData wasn't able to be resolved to a constant in this project
+    # _@return_ — AbilityId => AbilityData
+    attr_accessor abilities: (::Hash[Integer, Api::AbilityData] | untyped)
 
-      # sord omit - no YARD return type given, using untyped
-      def retreive_zip: () -> untyped
+    # _@return_ — UnitId => UnitTypeData
+    attr_accessor units: (::Hash[Integer, Api::UnitTypeData] | untyped)
 
-      # sord omit - no YARD return type given, using untyped
-      def clean: () -> untyped
+    # sord warn - Api::UpgradeData wasn't able to be resolved to a constant in this project
+    # _@return_ — UpgradeId => UpgradeData
+    attr_accessor upgrades: (::Hash[Integer, Api::UpgradeData] | untyped)
 
-      # sord omit - no YARD return type given, using untyped
-      def stop_container: () -> untyped
+    # sord omit - no YARD type given for :buffs, using untyped
+    # Not particularly useful data. Just use BuffId directly
+    #   @return [Hash<Integer, Api::BuffData>] BuffId => BuffData
+    attr_accessor buffs: untyped
 
-      # sord omit - no YARD return type given, using untyped
-      def bye: () -> untyped
-    end
+    # sord omit - no YARD type given for :effects, using untyped
+    # Not particularly useful data. Just use EffectId directly
+    #   @return [Hash<Integer, Api::EffectData>] EffectId => EffectData
+    attr_accessor effects: untyped
   end
 
   # Manages client connection to the Api
@@ -2613,13 +2563,12 @@ module Sc2
     # Closes Connection to client
     def close: () -> void
 
-    # sord omit - no YARD return type given, using untyped
     # Add a listener of specific callback type
     # 
     # _@param_ `listener`
     # 
     # _@param_ `klass`
-    def add_listener: (Object listener, klass: (Module[Sc2::Connection::ConnectionListener] | Module[Sc2::Connection::StatusListener])) -> untyped
+    def add_listener: (Object listener, klass: (Module[Sc2::Connection::ConnectionListener] | Module[Sc2::Connection::StatusListener])) -> void
 
     # sord omit - no YARD return type given, using untyped
     # Removes a listener of specific callback type
@@ -3275,14 +3224,14 @@ module Sc2
   class UnitGroup
     include Enumerable
     extend Forwardable
-    TYPE_WORKER: untyped
-    TYPE_GAS_STRUCTURE: untyped
-    TYPE_MINERAL: untyped
-    TYPE_GEYSER: untyped
-    TYPE_REJECT_DEBRIS: untyped
+    TYPE_WORKER: ::Array[Integer]
+    TYPE_GAS_STRUCTURE: ::Array[Integer]
+    TYPE_MINERAL: ::Array[Integer]
+    TYPE_GEYSER: ::Array[Integer]
+    TYPE_REJECT_DEBRIS: ::Array[Integer]
     TYPE_TECHLAB: untyped
-    TYPE_REACTOR: untyped
-    TYPE_BASES: untyped
+    TYPE_REACTOR: ::Array[Integer]
+    TYPE_BASES: ::Array[Integer]
 
     # _@param_ `units` — default to be added.
     # 
@@ -3535,7 +3484,7 @@ module Sc2
     def pos_centroid: () -> Api::Point2D?
 
     # Our first unit's bot object.
-    # Returns nil if units are empty, so use safetly operator bot&.method(...)
+    # Returns nil if units are empty, so use safety operator bot&.method(...)
     # 
     # _@return_ — player with active connection
     def bot: () -> Sc2::Player?
@@ -3557,7 +3506,7 @@ module Sc2
     # _@param_ `target` — is a unit tag or a Api::Point2D. Nil for addons/orbital
     # 
     # _@param_ `queue_command` — shift+command
-    def build: (unit_type_id: Integer, ?target: (Api::Point2D | Integer)?, ?queue_command: bool) -> untyped
+    def build: (unit_type_id: Integer, ?target: (Api::Point2D | Api::Unit | Integer)?, ?queue_command: bool) -> untyped
 
     # sord omit - no YARD return type given, using untyped
     # Warps in unit type at target (location or pylon)
@@ -3685,6 +3634,12 @@ module Sc2
     # ```
     def reject_attribute: ((Integer | ::Array[Integer]) attributes) -> UnitGroup
 
+    # Selects units you own
+    # i.e. @bot.all_units.owned # => Units you own
+    # 
+    # _@return_ — workers
+    def owned: () -> Sc2::UnitGroup
+
     # Selects worker units
     # 
     # _@return_ — workers
@@ -3746,7 +3701,7 @@ module Sc2
     # Selects only units which do not have orders
     def idle: () -> untyped
 
-    # Selects units which have this ability available\
+    # Selects units which have this ability available
     # Queries API if necessary
     # 
     # _@param_ `ability_id`
@@ -3754,6 +3709,11 @@ module Sc2
     # _@return_ — units which have the ability available
     def ability_available?: (Integer ability_id) -> UnitGroup
 
+    # Checks whether any unit's first order matches these abilities
+    # 
+    # _@param_ `ability_ids` — accepts one or an array of Api::AbilityId
+    def is_performing_ability?: ((Integer | ::Array[Integer]) ability_ids) -> bool
+
     # Selects mineral fields
     # 
     # _@return_ — mineral fields
@@ -3800,6 +3760,11 @@ module Sc2
     # _@return_ — larva
     def larva: () -> Sc2::UnitGroup
 
+    # Selects eggs. Eggs come from Larva and turn into Units.
+    # 
+    # _@return_ — eggs
+    def eggs: () -> Sc2::UnitGroup
+
     # Selects queens
     # 
     # _@return_ — queens
@@ -3885,14 +3850,14 @@ module Sc2
     # @private
     # Negative selector allowing unit group "ug.not." filter
     class UnitGroupNotSelector < Sc2::UnitGroup
-      TYPE_WORKER: untyped
-      TYPE_GAS_STRUCTURE: untyped
-      TYPE_MINERAL: untyped
-      TYPE_GEYSER: untyped
-      TYPE_REJECT_DEBRIS: untyped
+      TYPE_WORKER: ::Array[Integer]
+      TYPE_GAS_STRUCTURE: ::Array[Integer]
+      TYPE_MINERAL: ::Array[Integer]
+      TYPE_GEYSER: ::Array[Integer]
+      TYPE_REJECT_DEBRIS: ::Array[Integer]
       TYPE_TECHLAB: untyped
-      TYPE_REACTOR: untyped
-      TYPE_BASES: untyped
+      TYPE_REACTOR: ::Array[Integer]
+      TYPE_BASES: ::Array[Integer]
 
       # sord infer - argument name in single @param inferred as "unit_group"
       def initialize: ((Api::Unit | ::Hash[Integer, Api::Unit] | ::Array[Api::Unit] | Sc2::UnitGroup)? unit_group) -> void
@@ -4232,8 +4197,8 @@ module Sc2
     # _@param_ `player_index`
     def stop: (Integer player_index) -> void
 
-    # sord omit - no YARD return type given, using untyped
-    def stop_all: () -> untyped
+    # Stops all clients
+    def stop_all: () -> void
 
     def initialize: () -> void
 
@@ -8550,6 +8515,17 @@ module Api
     # _@return_ — this unit from the previous frame or nil if it wasn't present
     def previous: () -> Api::Unit?
 
+    # Returns whether a unit is alive or not
+    # Useful for cached Unit objects to see if they are still relevant.
+    # 
+    # _@return_ — alive
+    def is_alive?: () -> bool
+
+    # Replaces protobuf values with latest from game
+    # 
+    # _@return_ — true if refreshed or false unchanged
+    def refresh!: () -> bool
+
     # sord warn - Api::Attribute wasn't able to be resolved to a constant in this project
     # Returns static [Api::UnitTypeData] for a unit
     def attributes: () -> ::Array[Api::Attribute]
@@ -8690,7 +8666,7 @@ module Api
     # _@param_ `target` — is a unit tag or a Api::Point2D. Nil for addons/orbital
     # 
     # _@param_ `queue_command` — shift+command
-    def build: (unit_type_id: Integer, ?target: (Api::Point2D | Integer)?, ?queue_command: bool) -> untyped
+    def build: (unit_type_id: Integer, ?target: (Api::Point2D | Api::Unit | Integer)?, ?queue_command: bool) -> untyped
 
     # sord omit - no YARD return type given, using untyped
     # Issues repair command on target
@@ -8756,7 +8732,12 @@ module Api
     # _@param_ `target` — optionally check if unit is engaged with specific target
     def is_repairing?: (?target: (Api::Unit | Integer)?) -> bool
 
-    # Checks whether the unit has
+    # Checks whether a unit is gathering or returning gathered minerals/gas
+    # 
+    # _@return_ — true if either gathering or returning, false otherwise
+    def is_harvesting?: () -> bool
+
+    # Checks whether a unit's first order for ability
     # 
     # _@param_ `ability_ids` — accepts one or an array of Api::AbilityId
     def is_performing_ability?: ((Integer | ::Array[Integer]) ability_ids) -> bool
@@ -8860,6 +8841,9 @@ module Api
     # For Terran builds a tech lab add-on on the current structure
     def build_tech_lab: (?queue_command: untyped) -> void
 
+    # sord omit - no YARD return type given, using untyped
+    def target_for_addon_placement: () -> untyped
+
     # sord omit - no YARD return type given, using untyped
     # Warps in unit type at target (location or pylon)
     # Only works if the source is a Warp Gate
@@ -8916,7 +8900,7 @@ module Api
     # sord omit - no YARD type given for "g:", using untyped
     # sord omit - no YARD type given for "b:", using untyped
     # For lines: r & b are swapped.
-    def initialize: (r: untyped, g: untyped, b: untyped) -> void
+    def initialize: (?r: untyped, ?g: untyped, ?b: untyped) -> void
 
     # Adds additional functionality to message class Api::Color
     module ClassMethods
@@ -8969,7 +8953,7 @@ module Api
     # sord omit - no YARD type given for "g:", using untyped
     # sord omit - no YARD type given for "b:", using untyped
     # For lines: r & b are swapped.
-    def initialize: (r: untyped, g: untyped, b: untyped) -> void
+    def initialize: (?r: untyped, ?g: untyped, ?b: untyped) -> void
   end
 
   # Protobuf virtual class.
@@ -9158,6 +9142,9 @@ module Api
     # sord omit - no YARD type given for "other", using untyped
     def eql?: (untyped other) -> bool
 
+    # Returns self
+    def to_p2d: () -> self
+
     # sord omit - no YARD type given for "z:", using untyped
     # Create a new 3d Point, by adding a y axis.
     def to_3d: (?z: untyped) -> Api::Point
@@ -9751,6 +9738,17 @@ module Api
     # _@return_ — this unit from the previous frame or nil if it wasn't present
     def previous: () -> Api::Unit?
 
+    # Returns whether a unit is alive or not
+    # Useful for cached Unit objects to see if they are still relevant.
+    # 
+    # _@return_ — alive
+    def is_alive?: () -> bool
+
+    # Replaces protobuf values with latest from game
+    # 
+    # _@return_ — true if refreshed or false unchanged
+    def refresh!: () -> bool
+
     # sord warn - Api::Attribute wasn't able to be resolved to a constant in this project
     # Returns static [Api::UnitTypeData] for a unit
     def attributes: () -> ::Array[Api::Attribute]
@@ -9891,7 +9889,7 @@ module Api
     # _@param_ `target` — is a unit tag or a Api::Point2D. Nil for addons/orbital
     # 
     # _@param_ `queue_command` — shift+command
-    def build: (unit_type_id: Integer, ?target: (Api::Point2D | Integer)?, ?queue_command: bool) -> untyped
+    def build: (unit_type_id: Integer, ?target: (Api::Point2D | Api::Unit | Integer)?, ?queue_command: bool) -> untyped
 
     # sord omit - no YARD return type given, using untyped
     # Issues repair command on target
@@ -9957,7 +9955,12 @@ module Api
     # _@param_ `target` — optionally check if unit is engaged with specific target
     def is_repairing?: (?target: (Api::Unit | Integer)?) -> bool
 
-    # Checks whether the unit has
+    # Checks whether a unit is gathering or returning gathered minerals/gas
+    # 
+    # _@return_ — true if either gathering or returning, false otherwise
+    def is_harvesting?: () -> bool
+
+    # Checks whether a unit's first order for ability
     # 
     # _@param_ `ability_ids` — accepts one or an array of Api::AbilityId
     def is_performing_ability?: ((Integer | ::Array[Integer]) ability_ids) -> bool
@@ -10061,6 +10064,9 @@ module Api
     # For Terran builds a tech lab add-on on the current structure
     def build_tech_lab: (?queue_command: untyped) -> void
 
+    # sord omit - no YARD return type given, using untyped
+    def target_for_addon_placement: () -> untyped
+
     # sord omit - no YARD return type given, using untyped
     # Warps in unit type at target (location or pylon)
     # Only works if the source is a Warp Gate
@@ -10085,11 +10091,7 @@ module Api
 
   # Protobuf virtual class.
   class UnitTypeData < Google::Protobuf::AbstractMessage
-    include Api::UnitTypeExtension
     include Api::UnitTypeDataExtension
-
-    # sord omit - no YARD return type given, using untyped
-    def mood: () -> untyped
   end
 
   # Protobuf virtual class.
@@ -10165,19 +10167,261 @@ module Api
   end
 
   # Protobuf virtual enum.
-  class Race < Google::Protobuf::AbstractMessage
+  module Race
+    NoRace: untyped
+    Terran: untyped
+    Zerg: untyped
+    Protoss: untyped
+    Random: untyped
+  end
+
+  # Protobuf virtual enum.
+  module PlayerType
+    Participant: untyped
+    Computer: untyped
+    Observer: untyped
   end
 
   # Protobuf virtual enum.
-  class PlayerType < Google::Protobuf::AbstractMessage
+  module Difficulty
+    VeryEasy: untyped
+    Easy: untyped
+    Medium: untyped
+    MediumHard: untyped
+    Hard: untyped
+    Harder: untyped
+    VeryHard: untyped
+    CheatVision: untyped
+    CheatMoney: untyped
+    CheatInsane: untyped
   end
 
   # Protobuf virtual enum.
-  class Difficulty < Google::Protobuf::AbstractMessage
+  module AIBuild
+    RandomBuild: untyped
+    Rush: untyped
+    Timing: untyped
+    Power: untyped
+    Macro: untyped
+    Air: untyped
   end
 
   # Protobuf virtual enum.
-  class AIBuild < Google::Protobuf::AbstractMessage
+  module ActionResult
+    Success: untyped
+    NotSupported: untyped
+    Error: untyped
+    CantQueueThatOrder: untyped
+    Retry: untyped
+    Cooldown: untyped
+    QueueIsFull: untyped
+    RallyQueueIsFull: untyped
+    NotEnoughMinerals: untyped
+    NotEnoughVespene: untyped
+    NotEnoughTerrazine: untyped
+    NotEnoughCustom: untyped
+    NotEnoughFood: untyped
+    FoodUsageImpossible: untyped
+    NotEnoughLife: untyped
+    NotEnoughShields: untyped
+    NotEnoughEnergy: untyped
+    LifeSuppressed: untyped
+    ShieldsSuppressed: untyped
+    EnergySuppressed: untyped
+    NotEnoughCharges: untyped
+    CantAddMoreCharges: untyped
+    TooMuchMinerals: untyped
+    TooMuchVespene: untyped
+    TooMuchTerrazine: untyped
+    TooMuchCustom: untyped
+    TooMuchFood: untyped
+    TooMuchLife: untyped
+    TooMuchShields: untyped
+    TooMuchEnergy: untyped
+    MustTargetUnitWithLife: untyped
+    MustTargetUnitWithShields: untyped
+    MustTargetUnitWithEnergy: untyped
+    CantTrade: untyped
+    CantSpend: untyped
+    CantTargetThatUnit: untyped
+    CouldntAllocateUnit: untyped
+    UnitCantMove: untyped
+    TransportIsHoldingPosition: untyped
+    BuildTechRequirementsNotMet: untyped
+    CantFindPlacementLocation: untyped
+    CantBuildOnThat: untyped
+    CantBuildTooCloseToDropOff: untyped
+    CantBuildLocationInvalid: untyped
+    CantSeeBuildLocation: untyped
+    CantBuildTooCloseToCreepSource: untyped
+    CantBuildTooCloseToResources: untyped
+    CantBuildTooFarFromWater: untyped
+    CantBuildTooFarFromCreepSource: untyped
+    CantBuildTooFarFromBuildPowerSource: untyped
+    CantBuildOnDenseTerrain: untyped
+    CantTrainTooFarFromTrainPowerSource: untyped
+    CantLandLocationInvalid: untyped
+    CantSeeLandLocation: untyped
+    CantLandTooCloseToCreepSource: untyped
+    CantLandTooCloseToResources: untyped
+    CantLandTooFarFromWater: untyped
+    CantLandTooFarFromCreepSource: untyped
+    CantLandTooFarFromBuildPowerSource: untyped
+    CantLandTooFarFromTrainPowerSource: untyped
+    CantLandOnDenseTerrain: untyped
+    AddOnTooFarFromBuilding: untyped
+    MustBuildRefineryFirst: untyped
+    BuildingIsUnderConstruction: untyped
+    CantFindDropOff: untyped
+    CantLoadOtherPlayersUnits: untyped
+    NotEnoughRoomToLoadUnit: untyped
+    CantUnloadUnitsThere: untyped
+    CantWarpInUnitsThere: untyped
+    CantLoadImmobileUnits: untyped
+    CantRechargeImmobileUnits: untyped
+    CantRechargeUnderConstructionUnits: untyped
+    CantLoadThatUnit: untyped
+    NoCargoToUnload: untyped
+    LoadAllNoTargetsFound: untyped
+    NotWhileOccupied: untyped
+    CantAttackWithoutAmmo: untyped
+    CantHoldAnyMoreAmmo: untyped
+    TechRequirementsNotMet: untyped
+    MustLockdownUnitFirst: untyped
+    MustTargetUnit: untyped
+    MustTargetInventory: untyped
+    MustTargetVisibleUnit: untyped
+    MustTargetVisibleLocation: untyped
+    MustTargetWalkableLocation: untyped
+    MustTargetPawnableUnit: untyped
+    YouCantControlThatUnit: untyped
+    YouCantIssueCommandsToThatUnit: untyped
+    MustTargetResources: untyped
+    RequiresHealTarget: untyped
+    RequiresRepairTarget: untyped
+    NoItemsToDrop: untyped
+    CantHoldAnyMoreItems: untyped
+    CantHoldThat: untyped
+    TargetHasNoInventory: untyped
+    CantDropThisItem: untyped
+    CantMoveThisItem: untyped
+    CantPawnThisUnit: untyped
+    MustTargetCaster: untyped
+    CantTargetCaster: untyped
+    MustTargetOuter: untyped
+    CantTargetOuter: untyped
+    MustTargetYourOwnUnits: untyped
+    CantTargetYourOwnUnits: untyped
+    MustTargetFriendlyUnits: untyped
+    CantTargetFriendlyUnits: untyped
+    MustTargetNeutralUnits: untyped
+    CantTargetNeutralUnits: untyped
+    MustTargetEnemyUnits: untyped
+    CantTargetEnemyUnits: untyped
+    MustTargetAirUnits: untyped
+    CantTargetAirUnits: untyped
+    MustTargetGroundUnits: untyped
+    CantTargetGroundUnits: untyped
+    MustTargetStructures: untyped
+    CantTargetStructures: untyped
+    MustTargetLightUnits: untyped
+    CantTargetLightUnits: untyped
+    MustTargetArmoredUnits: untyped
+    CantTargetArmoredUnits: untyped
+    MustTargetBiologicalUnits: untyped
+    CantTargetBiologicalUnits: untyped
+    MustTargetHeroicUnits: untyped
+    CantTargetHeroicUnits: untyped
+    MustTargetRoboticUnits: untyped
+    CantTargetRoboticUnits: untyped
+    MustTargetMechanicalUnits: untyped
+    CantTargetMechanicalUnits: untyped
+    MustTargetPsionicUnits: untyped
+    CantTargetPsionicUnits: untyped
+    MustTargetMassiveUnits: untyped
+    CantTargetMassiveUnits: untyped
+    MustTargetMissile: untyped
+    CantTargetMissile: untyped
+    MustTargetWorkerUnits: untyped
+    CantTargetWorkerUnits: untyped
+    MustTargetEnergyCapableUnits: untyped
+    CantTargetEnergyCapableUnits: untyped
+    MustTargetShieldCapableUnits: untyped
+    CantTargetShieldCapableUnits: untyped
+    MustTargetFlyers: untyped
+    CantTargetFlyers: untyped
+    MustTargetBuriedUnits: untyped
+    CantTargetBuriedUnits: untyped
+    MustTargetCloakedUnits: untyped
+    CantTargetCloakedUnits: untyped
+    MustTargetUnitsInAStasisField: untyped
+    CantTargetUnitsInAStasisField: untyped
+    MustTargetUnderConstructionUnits: untyped
+    CantTargetUnderConstructionUnits: untyped
+    MustTargetDeadUnits: untyped
+    CantTargetDeadUnits: untyped
+    MustTargetRevivableUnits: untyped
+    CantTargetRevivableUnits: untyped
+    MustTargetHiddenUnits: untyped
+    CantTargetHiddenUnits: untyped
+    CantRechargeOtherPlayersUnits: untyped
+    MustTargetHallucinations: untyped
+    CantTargetHallucinations: untyped
+    MustTargetInvulnerableUnits: untyped
+    CantTargetInvulnerableUnits: untyped
+    MustTargetDetectedUnits: untyped
+    CantTargetDetectedUnits: untyped
+    CantTargetUnitWithEnergy: untyped
+    CantTargetUnitWithShields: untyped
+    MustTargetUncommandableUnits: untyped
+    CantTargetUncommandableUnits: untyped
+    MustTargetPreventDefeatUnits: untyped
+    CantTargetPreventDefeatUnits: untyped
+    MustTargetPreventRevealUnits: untyped
+    CantTargetPreventRevealUnits: untyped
+    MustTargetPassiveUnits: untyped
+    CantTargetPassiveUnits: untyped
+    MustTargetStunnedUnits: untyped
+    CantTargetStunnedUnits: untyped
+    MustTargetSummonedUnits: untyped
+    CantTargetSummonedUnits: untyped
+    MustTargetUser1: untyped
+    CantTargetUser1: untyped
+    MustTargetUnstoppableUnits: untyped
+    CantTargetUnstoppableUnits: untyped
+    MustTargetResistantUnits: untyped
+    CantTargetResistantUnits: untyped
+    MustTargetDazedUnits: untyped
+    CantTargetDazedUnits: untyped
+    CantLockdown: untyped
+    CantMindControl: untyped
+    MustTargetDestructibles: untyped
+    CantTargetDestructibles: untyped
+    MustTargetItems: untyped
+    CantTargetItems: untyped
+    NoCalldownAvailable: untyped
+    WaypointListFull: untyped
+    MustTargetRace: untyped
+    CantTargetRace: untyped
+    MustTargetSimilarUnits: untyped
+    CantTargetSimilarUnits: untyped
+    CantFindEnoughTargets: untyped
+    AlreadySpawningLarva: untyped
+    CantTargetExhaustedResources: untyped
+    CantUseMinimap: untyped
+    CantUseInfoPanel: untyped
+    OrderQueueIsFull: untyped
+    CantHarvestThatResource: untyped
+    HarvestersNotRequired: untyped
+    AlreadyTargeted: untyped
+    CantAttackWeaponsDisabled: untyped
+    CouldntReachTarget: untyped
+    TargetIsOutOfRange: untyped
+    TargetIsTooClose: untyped
+    TargetIsOutOfArc: untyped
+    CantFindTeleportLocation: untyped
+    InvalidItemClass: untyped
+    CantFindCancelOrder: untyped
   end
 
   # Adds additional functionality to message object Api::Point2D
@@ -10188,6 +10432,9 @@ module Api
     # sord omit - no YARD type given for "other", using untyped
     def eql?: (untyped other) -> bool
 
+    # Returns self
+    def to_p2d: () -> self
+
     # sord omit - no YARD type given for "z:", using untyped
     # Create a new 3d Point, by adding a y axis.
     def to_3d: (?z: untyped) -> Api::Point
@@ -10205,12 +10452,6 @@ module Api
     end
   end
 
-  # Adds additional functionality to message object Api::Unit
-  module UnitTypeExtension
-    # sord omit - no YARD return type given, using untyped
-    def mood: () -> untyped
-  end
-
   # Adds additional functionality to message object Api::PowerSource
   module PowerSourceExtension
     include Sc2::Position
@@ -10381,6 +10622,14 @@ module Api
     # 
     # _@return_ — sum of vespene gas costs
     attr_accessor vespene_cost_sum: (Integer | untyped)
+
+    # Length of tiles to build.
+    # i.e. 5 for any Base-type (5x5)
+    # i.e. 3 for Barracks (3x3)
+    # i.e. 2 for Supply Depot (2x2)
+    # 
+    # _@return_ — side-length for placement
+    attr_accessor placement_length: (Integer | untyped)
   end
 
   # This module make sure that a read from method ability_id always returns the proper source id
@@ -10389,63 +10638,4 @@ module Api
     # i.e. Api::AbilityId::ATTACK_BATTLECRUISER returns generic Api::AbilityId::ATTACK
     def ability_id: () -> Integer
   end
-end
-
-# Array extensions
-class Array
-  # Turns an Array of Api::Unit into a Sc2::UnitGroup
-  # 
-  # _@return_ — array converted to a unit group
-  def to_unit_group: () -> Sc2::UnitGroup
-
-  # Creates a Point2D from 0,1 as x,y
-  def to_p2d: () -> Api::Point2D
-end
-
-# Kernel extensions
-module Kernel
-  # sord omit - no YARD return type given, using untyped
-  # Sets $VERBOSE to +nil+ for the duration of the block and back to its original
-  # value afterwards.
-  # 
-  #   silence_warnings do
-  #     value = noisy_call # no warning voiced
-  #   end
-  # 
-  #   noisy_call # warning voiced
-  def silence_warnings: () -> untyped
-
-  # sord omit - no YARD return type given, using untyped
-  # Sets $VERBOSE to +nil+ for the duration of the block and back to its original
-  # value afterwards.
-  # 
-  #   silence_warnings do
-  #     value = noisy_call # no warning voiced
-  #   end
-  # 
-  #   noisy_call # warning voiced
-  def self.silence_warnings: () -> untyped
-
-  # sord omit - no YARD type given for "flag", using untyped
-  # sord omit - no YARD return type given, using untyped
-  # Sets $VERBOSE for the duration of the block and back to its original
-  # value afterwards.
-  def with_warnings: (untyped flag) -> untyped
-
-  # sord omit - no YARD type given for "flag", using untyped
-  # sord omit - no YARD return type given, using untyped
-  # Sets $VERBOSE for the duration of the block and back to its original
-  # value afterwards.
-  # noinspection RubyGlobalVariableNamingConvention
-  def self.with_warnings: (untyped flag) -> untyped
-end
-
-module Async
-  module Process
-    class Child
-      # sord omit - no YARD type given for "*args", using untyped
-      # sord omit - no YARD type given for "**options", using untyped
-      def initialize: (*untyped args, **untyped options) -> void
-    end
-  end
 end