A standalone plugin for python SC2 api
This module is inspired by plays like this one TY map positioning (notice how the army splits into groups, covering different areas, tanks are tucked in corners, and so on)
Hopefully with the interface provided here, you will be able to build plays like that one!
it is meant to be a tool(extension) for BurnySc2
Thanks A lot to DrInfy for solving one of the biggest challenges, finding rare choke points.
check out his work
-
Sharpy for rapid bot development.
-
sc2pathlib a high performance rust module with python interface for pathfinding
More Examples reside in the Documentation
Example bot usage can be found in dummybot.py
Example:
import pickle
import lzma
from MapData import MapData
from utils import import_bot_instance
#if its from BurnySc2 it is compressed
# https://github.com/BurnySc2/python-sc2/tree/develop/test/pickle_data
YOUR_FILE_PATH = 'some_directory/map_file'
with lzma.open(YOUR_FILE_PATH, "rb") as f:
raw_game_data, raw_game_info, raw_observation = pickle.load(f)
# mocking a bot object to initalize the map, this is for when you want to do this while not in a game,
# if you want to use it in a game just pass in the bot object like shown below
bot = import_bot_instance(raw_import_bot_instancegame_data, raw_game_info, raw_observation)
# And then you can instantiate a MapData Object like so
map_data = MapData(bot)
# plot the entire labeled map
map_data.plot_map()
# red dots or X are vision blockers,
# ramps are marked with white dots
# ramp top center is marked with '^'
# gas geysers are yellow spades
# MDRampss are marked with R<region_label>
# height span is with respect to : light = high , dark = low
# ChokeArea is marked with green heart suites
# Corners are marked with a red 'V' 
Tested Maps ( AiArena and SC2ai ladder map pool) :
['AbyssalReefLE.xz',
'AutomatonLE.xz',
'DeathAuraLE.xz', # currently fails on ground pathing
'EphemeronLE.xz',
'EternalEmpireLE.xz',
'EverDreamLE.xz',
'GoldenWallLE.xz',
'IceandChromeLE.xz',
'NightshadeLE.xz',
'PillarsofGoldLE.xz',
'SimulacrumLE.xz',
'SubmarineLE.xz',
'Triton.xz',
'WorldofSleepersLE.xz',
'ZenLE.xz']