sc2ai 0.0.0.pre → 0.0.3

data/lib/sc2ai/api/upgrade_id.rb

@@ -0,0 +1,312 @@
+# Generated from stableid.json, do not edit.
+
+module Api
+  # Constant reference of Upgrade ids
+  module UpgradeId
+    NULL = 0
+    CARRIERLAUNCHSPEEDUPGRADE = 1
+    GLIALRECONSTITUTION = 2
+    TUNNELINGCLAWS = 3
+    CHITINOUSPLATING = 4
+    HISECAUTOTRACKING = 5
+    TERRANBUILDINGARMOR = 6
+    TERRANINFANTRYWEAPONSLEVEL1 = 7
+    TERRANINFANTRYWEAPONSLEVEL2 = 8
+    TERRANINFANTRYWEAPONSLEVEL3 = 9
+    NEOSTEELFRAME = 10
+    TERRANINFANTRYARMORSLEVEL1 = 11
+    TERRANINFANTRYARMORSLEVEL2 = 12
+    TERRANINFANTRYARMORSLEVEL3 = 13
+    REAPERSPEED = 14
+    STIMPACK = 15
+    SHIELDWALL = 16
+    PUNISHERGRENADES = 17
+    SIEGETECH = 18
+    HIGHCAPACITYBARRELS = 19
+    BANSHEECLOAK = 20
+    MEDIVACCADUCEUSREACTOR = 21
+    RAVENCORVIDREACTOR = 22
+    HUNTERSEEKER = 23
+    DURABLEMATERIALS = 24
+    PERSONALCLOAKING = 25
+    GHOSTMOEBIUSREACTOR = 26
+    TERRANVEHICLEARMORSLEVEL1 = 27
+    TERRANVEHICLEARMORSLEVEL2 = 28
+    TERRANVEHICLEARMORSLEVEL3 = 29
+    TERRANVEHICLEWEAPONSLEVEL1 = 30
+    TERRANVEHICLEWEAPONSLEVEL2 = 31
+    TERRANVEHICLEWEAPONSLEVEL3 = 32
+    TERRANSHIPARMORSLEVEL1 = 33
+    TERRANSHIPARMORSLEVEL2 = 34
+    TERRANSHIPARMORSLEVEL3 = 35
+    TERRANSHIPWEAPONSLEVEL1 = 36
+    TERRANSHIPWEAPONSLEVEL2 = 37
+    TERRANSHIPWEAPONSLEVEL3 = 38
+    PROTOSSGROUNDWEAPONSLEVEL1 = 39
+    PROTOSSGROUNDWEAPONSLEVEL2 = 40
+    PROTOSSGROUNDWEAPONSLEVEL3 = 41
+    PROTOSSGROUNDARMORSLEVEL1 = 42
+    PROTOSSGROUNDARMORSLEVEL2 = 43
+    PROTOSSGROUNDARMORSLEVEL3 = 44
+    PROTOSSSHIELDSLEVEL1 = 45
+    PROTOSSSHIELDSLEVEL2 = 46
+    PROTOSSSHIELDSLEVEL3 = 47
+    OBSERVERGRAVITICBOOSTER = 48
+    GRAVITICDRIVE = 49
+    EXTENDEDTHERMALLANCE = 50
+    HIGHTEMPLARKHAYDARINAMULET = 51
+    PSISTORMTECH = 52
+    ZERGMELEEWEAPONSLEVEL1 = 53
+    ZERGMELEEWEAPONSLEVEL2 = 54
+    ZERGMELEEWEAPONSLEVEL3 = 55
+    ZERGGROUNDARMORSLEVEL1 = 56
+    ZERGGROUNDARMORSLEVEL2 = 57
+    ZERGGROUNDARMORSLEVEL3 = 58
+    ZERGMISSILEWEAPONSLEVEL1 = 59
+    ZERGMISSILEWEAPONSLEVEL2 = 60
+    ZERGMISSILEWEAPONSLEVEL3 = 61
+    OVERLORDSPEED = 62
+    OVERLORDTRANSPORT = 63
+    BURROW = 64
+    ZERGLINGATTACKSPEED = 65
+    ZERGLINGMOVEMENTSPEED = 66
+    HYDRALISKSPEED = 67
+    ZERGFLYERWEAPONSLEVEL1 = 68
+    ZERGFLYERWEAPONSLEVEL2 = 69
+    ZERGFLYERWEAPONSLEVEL3 = 70
+    ZERGFLYERARMORSLEVEL1 = 71
+    ZERGFLYERARMORSLEVEL2 = 72
+    ZERGFLYERARMORSLEVEL3 = 73
+    INFESTORENERGYUPGRADE = 74
+    CENTRIFICALHOOKS = 75
+    BATTLECRUISERENABLESPECIALIZATIONS = 76
+    BATTLECRUISERBEHEMOTHREACTOR = 77
+    PROTOSSAIRWEAPONSLEVEL1 = 78
+    PROTOSSAIRWEAPONSLEVEL2 = 79
+    PROTOSSAIRWEAPONSLEVEL3 = 80
+    PROTOSSAIRARMORSLEVEL1 = 81
+    PROTOSSAIRARMORSLEVEL2 = 82
+    PROTOSSAIRARMORSLEVEL3 = 83
+    WARPGATERESEARCH = 84
+    HALTECH = 85
+    CHARGE = 86
+    BLINKTECH = 87
+    ANABOLICSYNTHESIS = 88
+    OBVERSEINCUBATION = 89
+    VIKINGJOTUNBOOSTERS = 90
+    ORGANICCARAPACE = 91
+    INFESTORPERISTALSIS = 92
+    ABDOMINALFORTITUDE = 93
+    HYDRALISKSPEEDUPGRADE = 94
+    BANELINGBURROWMOVE = 95
+    COMBATDRUGS = 96
+    STRIKECANNONS = 97
+    TRANSFORMATIONSERVOS = 98
+    PHOENIXRANGEUPGRADE = 99
+    TEMPESTRANGEUPGRADE = 100
+    NEURALPARASITE = 101
+    LOCUSTLIFETIMEINCREASE = 102
+    ULTRALISKBURROWCHARGEUPGRADE = 103
+    ORACLEENERGYUPGRADE = 104
+    RESTORESHIELDS = 105
+    PROTOSSHEROSHIPWEAPON = 106
+    PROTOSSHEROSHIPDETECTOR = 107
+    PROTOSSHEROSHIPSPELL = 108
+    REAPERJUMP = 109
+    INCREASEDRANGE = 110
+    ZERGBURROWMOVE = 111
+    ANIONPULSECRYSTALS = 112
+    TERRANVEHICLEANDSHIPWEAPONSLEVEL1 = 113
+    TERRANVEHICLEANDSHIPWEAPONSLEVEL2 = 114
+    TERRANVEHICLEANDSHIPWEAPONSLEVEL3 = 115
+    TERRANVEHICLEANDSHIPARMORSLEVEL1 = 116
+    TERRANVEHICLEANDSHIPARMORSLEVEL2 = 117
+    TERRANVEHICLEANDSHIPARMORSLEVEL3 = 118
+    FLYINGLOCUSTS = 119
+    ROACHSUPPLY = 120
+    IMMORTALREVIVE = 121
+    DRILLCLAWS = 122
+    CYCLONELOCKONRANGEUPGRADE = 123
+    CYCLONEAIRUPGRADE = 124
+    LIBERATORMORPH = 125
+    ADEPTSHIELDUPGRADE = 126
+    LURKERRANGE = 127
+    IMMORTALBARRIER = 128
+    ADEPTKILLBOUNCE = 129
+    ADEPTPIERCINGATTACK = 130
+    CINEMATICMODE = 131
+    CURSORDEBUG = 132
+    MAGFIELDLAUNCHERS = 133
+    EVOLVEGROOVEDSPINES = 134
+    EVOLVEMUSCULARAUGMENTS = 135
+    BANSHEESPEED = 136
+    MEDIVACRAPIDDEPLOYMENT = 137
+    RAVENRECALIBRATEDEXPLOSIVES = 138
+    MEDIVACINCREASESPEEDBOOST = 139
+    LIBERATORAGRANGEUPGRADE = 140
+    DARKTEMPLARBLINKUPGRADE = 141
+    RAVAGERRANGE = 142
+    RAVENDAMAGEUPGRADE = 143
+    CYCLONELOCKONDAMAGEUPGRADE = 144
+    ARESCLASSWEAPONSSYSTEMVIKING = 145
+    AUTOHARVESTER = 146
+    HYBRIDCPLASMAUPGRADEHARD = 147
+    HYBRIDCPLASMAUPGRADEINSANE = 148
+    INTERCEPTORLIMIT4 = 149
+    INTERCEPTORLIMIT6 = 150
+    def self._330MMBARRAGECANNONS = 151
+    NOTPOSSIBLESIEGEMODE = 152
+    NEOSTEELFRAME_2 = 153
+    NEOSTEELANDSHRIKETURRETICONUPGRADE = 154
+    OCULARIMPLANTS = 155
+    CROSSSPECTRUMDAMPENERS = 156
+    ORBITALSTRIKE = 157
+    CLUSTERBOMB = 158
+    SHAPEDHULL = 159
+    SPECTRETOOLTIPUPGRADE = 160
+    ULTRACAPACITORS = 161
+    VANADIUMPLATING = 162
+    COMMANDCENTERREACTOR = 163
+    REGENERATIVEBIOSTEEL = 164
+    CELLULARREACTORS = 165
+    BANSHEECLOAKEDDAMAGE = 166
+    DISTORTIONBLASTERS = 167
+    EMPTOWER = 168
+    SUPPLYDEPOTDROP = 169
+    HIVEMINDEMULATOR = 170
+    FORTIFIEDBUNKERCARAPACE = 171
+    PREDATOR = 172
+    SCIENCEVESSEL = 173
+    DUALFUSIONWELDERS = 174
+    ADVANCEDCONSTRUCTION = 175
+    ADVANCEDMEDICTRAINING = 176
+    PROJECTILEACCELERATORS = 177
+    REINFORCEDSUPERSTRUCTURE = 178
+    MULE = 179
+    ORBITALRELAY = 180
+    RAZORWIRE = 181
+    ADVANCEDHEALINGAI = 182
+    TWINLINKEDFLAMETHROWERS = 183
+    NANOCONSTRUCTOR = 184
+    CERBERUSMINES = 185
+    HYPERFLUXOR = 186
+    TRILITHIUMPOWERCELLS = 187
+    PERMANENTCLOAKGHOST = 188
+    PERMANENTCLOAKSPECTRE = 189
+    ULTRASONICPULSE = 190
+    SURVIVALPODS = 191
+    ENERGYSTORAGE = 192
+    FULLBORECANISTERAMMO = 193
+    CAMPAIGNJOTUNBOOSTERS = 194
+    MICROFILTERING = 195
+    PARTICLECANNONAIR = 196
+    VULTUREAUTOREPAIR = 197
+    PSIDISRUPTOR = 198
+    SCIENCEVESSELENERGYMANIPULATION = 199
+    SCIENCEVESSELPLASMAWEAPONRY = 200
+    SHOWGATLINGGUN = 201
+    TECHREACTOR = 202
+    TECHREACTORAI = 203
+    TERRANDEFENSERANGEBONUS = 204
+    X88TNAPALMUPGRADE = 205
+    HURRICANEMISSILES = 206
+    MECHANICALREBIRTH = 207
+    MARINESTIMPACK = 208
+    DARKTEMPLARTACTICS = 209
+    CLUSTERWARHEADS = 210
+    CLOAKDISTORTIONFIELD = 211
+    DEVASTATORMISSILES = 212
+    DISTORTIONTHRUSTERS = 213
+    DYNAMICPOWERROUTING = 214
+    IMPALERROUNDS = 215
+    KINETICFIELDS = 216
+    BURSTCAPACITORS = 217
+    HAILSTORMMISSILEPODS = 218
+    RAPIDDEPLOYMENT = 219
+    REAPERSTIMPACK = 220
+    REAPERD8CHARGE = 221
+    TYCHUS05BATTLECRUISERPENETRATION = 222
+    VIRALPLASMA = 223
+    FIREBATJUGGERNAUTPLATING = 224
+    MULTILOCKTARGETINGSYSTEMS = 225
+    TURBOCHARGEDENGINES = 226
+    DISTORTIONSENSORS = 227
+    INFERNALPREIGNITERS = 228
+    HELLIONCAMPAIGNINFERNALPREIGNITER = 229
+    NAPALMFUELTANKS = 230
+    AUXILIARYMEDBOTS = 231
+    JUGGERNAUTPLATING = 232
+    MARAUDERLIFEBOOST = 233
+    COMBATSHIELD = 234
+    REAPERU238ROUNDS = 235
+    MAELSTROMROUNDS = 236
+    SIEGETANKSHAPEDBLAST = 237
+    TUNGSTENSPIKES = 238
+    BEARCLAWNOZZLES = 239
+    NANOBOTINJECTORS = 240
+    STABILIZERMEDPACKS = 241
+    HALOROCKETS = 242
+    SCAVENGINGSYSTEMS = 243
+    EXTRAMINES = 244
+    ARESCLASSWEAPONSSYSTEM = 245
+    WHITENAPALM = 246
+    VIRALMUNITIONS = 247
+    JACKHAMMERCONCUSSIONGRENADES = 248
+    FIRESUPPRESSIONSYSTEMS = 249
+    FLARERESEARCH = 250
+    MODULARCONSTRUCTION = 251
+    EXPANDEDHULL = 252
+    SHRIKETURRET = 253
+    MICROFUSIONREACTORS = 254
+    WRAITHCLOAK = 255
+    SINGULARITYCHARGE = 256
+    GRAVITICTHRUSTERS = 257
+    YAMATOCANNON = 258
+    DEFENSIVEMATRIX = 259
+    DARKPROTOSS = 260
+    TERRANINFANTRYWEAPONSULTRACAPACITORSLEVEL1 = 261
+    TERRANINFANTRYWEAPONSULTRACAPACITORSLEVEL2 = 262
+    TERRANINFANTRYWEAPONSULTRACAPACITORSLEVEL3 = 263
+    TERRANINFANTRYARMORSVANADIUMPLATINGLEVEL1 = 264
+    TERRANINFANTRYARMORSVANADIUMPLATINGLEVEL2 = 265
+    TERRANINFANTRYARMORSVANADIUMPLATINGLEVEL3 = 266
+    TERRANVEHICLEWEAPONSULTRACAPACITORSLEVEL1 = 267
+    TERRANVEHICLEWEAPONSULTRACAPACITORSLEVEL2 = 268
+    TERRANVEHICLEWEAPONSULTRACAPACITORSLEVEL3 = 269
+    TERRANVEHICLEARMORSVANADIUMPLATINGLEVEL1 = 270
+    TERRANVEHICLEARMORSVANADIUMPLATINGLEVEL2 = 271
+    TERRANVEHICLEARMORSVANADIUMPLATINGLEVEL3 = 272
+    TERRANSHIPWEAPONSULTRACAPACITORSLEVEL1 = 273
+    TERRANSHIPWEAPONSULTRACAPACITORSLEVEL2 = 274
+    TERRANSHIPWEAPONSULTRACAPACITORSLEVEL3 = 275
+    TERRANSHIPARMORSVANADIUMPLATINGLEVEL1 = 276
+    TERRANSHIPARMORSVANADIUMPLATINGLEVEL2 = 277
+    TERRANSHIPARMORSVANADIUMPLATINGLEVEL3 = 278
+    HIREKELMORIANMINERSPH = 279
+    HIREDEVILDOGSPH = 280
+    HIRESPARTANCOMPANYPH = 281
+    HIREHAMMERSECURITIESPH = 282
+    HIRESIEGEBREAKERSPH = 283
+    HIREHELSANGELSPH = 284
+    HIREDUSKWINGPH = 285
+    HIREDUKESREVENGE = 286
+    TOSHEASYMODE = 287
+    VOIDRAYSPEEDUPGRADE = 288
+    SMARTSERVOS = 289
+    ARMORPIERCINGROCKETS = 290
+    CYCLONERAPIDFIRELAUNCHERS = 291
+    RAVENENHANCEDMUNITIONS = 292
+    DIGGINGCLAWS = 293
+    CARRIERCARRIERCAPACITY = 294
+    CARRIERLEASHRANGEUPGRADE = 295
+    TEMPESTGROUNDATTACKUPGRADE = 296
+    MICROBIALSHROUD = 297
+    SUNDERINGIMPACT = 298
+    AMPLIFIEDSHIELDING = 299
+    PSIONICAMPLIFIERS = 300
+    SECRETEDCOATING = 301
+    ENHANCEDSHOCKWAVES = 302
+    HURRICANETHRUSTERS = 303
+    INTERFERENCEMATRIX = 304
+  end
+end

data/lib/sc2ai/cli/cli.rb

@@ -0,0 +1,177 @@
+require "thor"
+
+require "sc2ai/cli/new"
+require "sc2ai/cli/ladderzip"
+
+module Sc2
+  # Command line utilities
+  # standard:disable Style/GlobalVars
+  class Cli < Thor
+    # Silence!
+    class << self
+      def exit_on_failure?
+        true
+      end
+    end
+
+    register(Sc2::Cli::New, "new", "new BOTNAME RACE", "Creates botname folder with bot template")
+    register(Sc2::Cli::Ladderzip, "ladderzip", "ladderzip BOTNAME", "Prepares a zip via docker for supplied aiarena bot name")
+
+    # TODO: Use thor's #ask and other methods helpers of raw $stdin and puts.
+    desc "setup410", "Downloads and install SC2 v4.10"
+    # downloads and install SC2 v4.10
+    def setup410
+      say " "
+      say "This script sets up SC2 at version 4.10, which we use competitively."
+      say "Press any key to continue..."
+      ask ""
+
+      say "You must accept the Blizzard® Starcraft® II AI and Machine Learning License at"
+      say "https://blzdistsc2-a.akamaihd.net/AI_AND_MACHINE_LEARNING_LICENSE.html"
+      say "It is PERMISSIVE and grants you freedoms over the standard EULA."
+      say "We do not record this action, but depend on software goverend by that license to continue."
+      puts 'If you accept, type "iagreetotheeula" (without quotes) and press ENTER to continue:'
+
+      while $stdin.gets.chomp != "iagreetotheeula"
+        say ""
+        puts 'Type "iagreetotheeula" (without quotes) and press ENTER to continue:'
+      end
+      say ""
+      say ""
+      say "Great decision."
+
+      require "sc2ai"
+      Async do
+        Sc2.logger.level = :fatal
+        say "SC2 will launch a blank window, be unresponsive, but download about 100mb in the background."
+        say "Let it finish and close itself."
+        say "Press ENTER if you understand."
+        ask ""
+
+        say ""
+        say ""
+        say "This will only take a minute..."
+
+        Sc2.config.version = nil
+        client = Sc2::ClientManager.obtain(0)
+        if Gem.win_platform?
+          sleep(10)
+        end
+        observer = Sc2::Player::Observer.new
+        observer.connect(host: client.host, port: client.port)
+        setup_replay = Sc2::Paths.gem_root.join("data", "setup", "setup.SC2Replay")
+        observer.api.replay_info(
+          replay_data: File.binread(setup_replay),
+          download_data: true
+        )
+
+        # Auto-detect executable path and ensure it matched exactly
+        base_build = "75689"
+        path = Sc2::Paths.executable(base_build: base_build)
+        if path.include?(base_build) && Pathname(path).exist?
+          say " "
+          say "Success. Download complete.", :green
+          say " "
+        else
+          say "Error. Slightly worrying, but no fear.", :red
+          say "To manually setup, grab the latest ladder maps and add them to your map folder."
+          say "Grab the latest maps from https://aiarena.net/wiki/maps/"
+          say "Detected map folder: #{Sc2::Paths.maps_dir}"
+          say "Then, download any recent replay from https://aiarena.net/ and double click to launch"
+        end
+
+        observer.api.quit
+        observer.disconnect
+        say "Generating sc2ai.yml to always use 4.10..."
+        Sc2.config.config_file.write({"version" => "4.10"}.to_yaml.to_s)
+        say ""
+        say "Done. You're good to go.", :green
+      ensure
+        Sc2::ClientManager.stop(0)
+      end
+    end
+
+    desc "ladderconfig", "Prints out how you're configured for the ladder."
+    def ladderconfig
+      require "sc2ai"
+      unless Pathname("./boot.rb").exist?
+        raise Sc2::Error, "boot.rb not found. Bot started from wrong directory."
+      end
+
+      require "./boot"
+      # Debug
+      Sc2.logger.info "Bot class: #{$bot.class}"
+      Sc2.logger.info "Config:"
+      Sc2.logger.info "  in-game name: #{$bot.name}"
+      Sc2.logger.info "  race: #{Api::Race.lookup($bot.race)}"
+      Sc2.logger.info "  realtime: #{$bot.realtime}"
+      Sc2.logger.info "  step_count: #{$bot.step_count}"
+      Sc2.logger.info "  enable_feature_layer: #{$bot.enable_feature_layer}"
+      Sc2.logger.info "  interface_options: #{$bot.interface_options}"
+    end
+
+    # desc "ladderzip", "Uses docker to cross-compile a compatible binary for the ladder"
+    # def ladderzip
+    # end
+
+    # desc "ladderquickzip", "Ladder zip, if you have no additional gems installed."
+    # long_desc <<-LONGDESC
+    #   `sc2ai ladderzip_basic` will download a portable ruby and gems, then copy your bot files into a zip file.
+    #
+    #   If you have added any gems which need compiling, this option is not for you.
+    #   Any gems built with native extensions will likely not be targeting the linux platform and be nonfunctional.
+    #
+    #   For a cross-platform build, use ladderzip instead. This will launch a Docker container to compile a zip for you.
+    # LONGDESC
+    # def ladderquickzip
+    #   raise Sc2::Error, "Not yet implemented."
+    # end
+
+    desc "laddermatch", "Joins a ladder match as per aiarena spec"
+    option :GamePort, required: true, desc: "SC2 port. Corresponds to SC2 launch option '-port'"
+    option :LadderServer, required: true, desc: "SC2 server ip or hostname"
+    option :StartPort, required: true, desc: "Match port range calculated starting at this port."
+    option :OpponentId, desc: "Unique identifier"
+    option :RealTime, type: :boolean, default: false, desc: "Forces realtime flag"
+    def laddermatch
+      require "sc2ai"
+
+      unless Sc2.ladder?
+        raise Sc2::Error, "This command is only for competing on aiarena.net"
+      end
+
+      unless Pathname("./boot.rb").exist?
+        raise Sc2::Error, "boot.rb not found. Bot started from wrong directory."
+      end
+
+      Sc2.logger.level = :info
+
+      require "./boot"
+
+      # Ladder specific overrides
+      $bot.realtime = true if options[:RealTime]
+      $bot.opponent_id = options[:OpponentId] if options[:OpponentId]
+
+      Async do
+        $bot.connect(host: options[:LadderServer], port: options[:GamePort])
+        $bot.join_game(
+          server_host: options[:LadderServer],
+          port_config: Sc2::Ports.port_config_basic(start_port: options[:StartPort], num_players: 2)
+        )
+        $bot.add_listener($bot, klass: Sc2::Connection::StatusListener)
+        $bot.play
+      end.wait
+    end
+
+    # desc "install APP_NAME", "install one of the available apps"   # [4]
+    # method_options :force => :boolean, :alias => :string           # [5]
+    # def install(name)
+    #   user_alias = options[:alias]
+    #   if options.force?
+    #     # do something
+    #   end
+    #   # other code
+    # end
+  end
+  # standard:enable Style/GlobalVars
+end

data/lib/sc2ai/cli/ladderzip.rb

@@ -0,0 +1,173 @@
+module Sc2
+  # Command line utilities
+  class Cli < Thor
+    # 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
+
+      # Define arguments and options
+      argument :botname, desc: "Your bot name as on aiarena.net. Will be used as a filename (alphanumeric, no spaces)."
+      desc "Builds a ladder zip using docker (requires docker)"
+
+      def docker_exists
+        if Kernel.system("docker --version", out: File::NULL, err: File::NULL)
+          say_status("docker", "found", :green)
+        else
+          say_status("docker", "not found", :red)
+          say("Please install 'docker' and/or ensure it's in your PATH to continue.")
+          raise SystemExit
+        end
+
+        if Kernel.system("docker info", out: File::NULL, err: File::NULL)
+          say_status("docker engine", "found", :green)
+        else
+          say("  ")
+          say_status("docker engine", "offline", :red)
+          say("Please start docker engine. If you have Docker Desktop installed, open it before retrying.")
+          raise SystemExit
+        end
+      end
+
+      def set_compose_file
+        @compose_file = Sc2::Paths.gem_root
+          .join("lib", "docker_build", "docker-compose-ladderzip.yml")
+          .expand_path.to_s
+      end
+
+      def bot_validation
+        if Pathname("./boot.rb").exist?
+          say_status("detected boot.rb", "found", :green)
+        else
+          say_status("detected boot.rb", "not found", :red)
+          raise Sc2::Error, "boot.rb not found. Bot started from wrong directory."
+        end
+
+        require "./boot"
+
+        if $bot.is_a? Sc2::Player
+          say_status("instance $bot", $bot.class, :green)
+        else
+          say_status("instance $bot", $bot.class, :red)
+          raise Sc2::Error, "$bot instance nil or not Sc2::Player. Review boot.rb to ensure it creates $bot."
+        end
+      end
+
+      def self.source_paths
+        [Pathname(".").expand_path.to_s]
+      end
+
+      def self.source_root
+        Paths.template_root.to_s
+      end
+
+      def ensure_build_dir
+        empty_directory "./.build"
+      end
+
+      def create_executable
+        template("ladderzip/bin/ladder", "./.build/bin/ladder")
+        # This fails on Windows. creating by hand in #link_ladder function below.
+        # create_link("./.build/#{botname}", "./bin/ladder")
+      end
+
+      def start_container
+        cmd = "docker compose -f #{@compose_file} up bot -d --force-recreate"
+        Kernel.system(cmd)
+      end
+
+      def populate_build
+        # Manually parse *ignore file. Not doing a docker build on this simply to abuse dockerignore.
+        ignore_pattern = File.open("./.ladderignore").each_line
+          .collect(&:strip)
+          .reject { |pt| pt&.start_with?("#") || pt&.size&.zero? }
+        ignore_pattern << "**.build/*"
+        ignore_pattern << "**.ruby/*"
+
+        include_pattern = ignore_pattern.select { |pt| pt&.start_with?("!") }
+        ignore_pattern -= include_pattern
+
+        include_pattern.collect! { |pt| pt.delete_prefix("!") }
+
+        files = Dir.glob("**/*")
+
+        ignored_files = files
+          .select { |f| ignore_pattern.any? { |p| File.fnmatch?(p, f) } }
+          .reject { |f| include_pattern.any? { |p| File.fnmatch?(p, f) } }
+
+        files -= ignored_files unless ignored_files.nil?
+
+        files.each do |file|
+          next if File.directory?(file)
+          copy_file file, "./.build/#{file}"
+        end
+      end
+
+      def copy_build_to_docker
+        say_status("docker", "copying source...", :cyan)
+        cmd = "docker compose -f #{@compose_file} cp ./.build/. bot:/root/ruby-builder/"
+        Kernel.system(cmd)
+      end
+
+      def link_ladder
+        say_status("docker", "linking executable...", :cyan)
+        cmd = "docker compose -f #{@compose_file} exec --workdir /root/ruby-builder bot ln -s ./bin/ladder ./#{botname}"
+        Kernel.system(cmd)
+      end
+
+      def install_gems
+        say_status("docker", "bundle install...", :cyan)
+        cmd = "docker compose -f #{@compose_file} exec --workdir /root/ruby-builder bot bundle install"
+        Kernel.system(cmd)
+      end
+
+      def compress
+        say_status("docker", "compress ladder zip...", :cyan)
+        cmd = "docker compose -f #{@compose_file} exec --workdir /root/ruby-builder bot zip -qry9 /root/build.zip ."
+        Kernel.system(cmd)
+      end
+
+      def retreive_zip
+        say_status("docker", "pulling 'build.zip'", :green)
+        cmd = "docker compose -f #{@compose_file} cp bot:/root/build.zip ."
+        Kernel.system(cmd)
+        if File.exist?("./build.zip")
+          say_status("docker", "pulled 'build.zip' ok", :green)
+        else
+          say_status("docker", "error pulling 'build.zip'", :red)
+          exit
+        end
+        cmd = "docker compose -f #{@compose_file} exec bot rm /root/build.zip"
+        Kernel.system(cmd)
+      end
+
+      def clean
+        remove_file "./.build"
+      end
+
+      def stop_container
+        cmd = "docker compose --progress=plain -f #{@compose_file} stop bot"
+        Kernel.system(cmd)
+      end
+
+      def bye
+        say ""
+        say "Your bot is ready to upload. Use the file 'build.zip'."
+        say ""
+        say "A friendly reminder that since you passed \"#{botname}\", "
+        say "aiarena expects your bot to be named exactly that."
+        say "If the names mismatch, simply rerun this command with the correct BOTNAME."
+        say ""
+        say "Good luck."
+      end
+    end
+    # standard:enable Style/GlobalVars
+  end
+end