python-sc2地图与建筑放置深度解析GameInfo与find_placement让建筑永远建对位置【免费下载链接】python-sc2A StarCraft II bot api client library for Python 3项目地址: https://gitcode.com/gh_mirrors/pyt/python-sc2python-sc2是 StarCraft II 的 Python 机器人开发库本文带你掌握它的地图情报系统GameInfo与自动建筑寻位函数find_placement从斜坡识别到建筑精确落点新手也能让机器人一次建对不再出现建在斜坡、卡在角落的尴尬。️ GameInfo开局就拿到整张地图的情报对局开始后python-sc2会自动解析地图把所有看不见摸不着的地形信息变成结构化数据全部挂在game_info对象上。它是后续所有建筑决策的地基。属性类型作用map_size宽高地图整体尺寸playable_area矩形区域可玩范围找位时不会跑出边界pathing_grid像素网格每个格子能否通行0/1placement_grid像素网格每个格子能否放置建筑0/1terrain_height像素网格每个格子的高度0~255斜坡识别全靠它map_ramps斜坡列表自动识别出的全部斜坡Ramp对象start_locations坐标列表全部出生点位置player_start_location坐标我方出生点游戏开始后填充这些原始数据在 game_info.py 的GameInfo.__init__中初始化其中placement_grid直接决定了建筑能否落地——后面find_placement的每一步判断底层都是它在说话。 小知识点游戏开始时程序还会通过可通行但不可放置的格子差异自动算出斜坡点和视野遮挡点代码在 _find_ramps_and_vision_blockers你不需要手工标注地图。 Ramp斜坡自动识别 现成的建筑套餐python-sc2把每张地图的斜坡识别成了 Ramp 对象并预计算了人族/神族最常用的建筑点位。对新手来说这是最省心的放置方式——不用自己算坐标。常用属性速查属性含义典型用途upper/lower斜坡顶端 / 底端格子集合判断斜坡朝向top_center/bottom_center斜坡顶部 / 底部中心点距离比较、锁定主基地barracks_correct_placement兵营正确位置保证旁边放得下加成建筑人族主基地双 Depot 兵营depot_in_middle中间 Depot 位置卡斜坡ramp wallcorner_depots两侧 Depot 位置卡斜坡、堵门protoss_wall_buildings神族堵墙两座建筑位置神族墙wall-inprotoss_wall_warpin神族传送堵墙单位位置配合堵墙战术通过self.main_base_ramp可直接拿到离出生点最近的主基地斜坡查找逻辑在 bot_ai.py它对不同地图如 5 个顶端点位的特殊图都做了兼容处理。# 斜坡上一键套餐位置无需任何计算 ramp self.main_base_ramp barracks_pos ramp.barracks_correct_placement # 兵营已考虑加成建筑空间 depot_pos ramp.depot_in_middle # 卡斜坡中间的 Depot wall_poses ramp.protoss_wall_buildings # 神族堵墙的两座建筑 find_placement找不到就自动绕一圈找当预设位置被占、或者你想把建筑摆在某个目标点附近时就轮到 find_placement 出场了。它的搜索策略非常直观先检查near目标点本身能不能放放不了就以目标点为圆心按环向外扩展每一环按placement_step步长采样一圈候选点每环批量向引擎查询可放置性找到第一个有解的环就返回位置超过max_distance仍未找到返回None。参数说明参数默认值说明building必填要放置的建筑UnitTypeId或AbilityIdnear必填目标中心点Point2如基地坐标max_distance20向外搜索的最大半径找不到返回Nonerandom_alternativeTrue多个可行点时随机选一个避免每局走位一样placement_step2环上采样步长越大建筑间距越大addon_placeFalse额外校验旁边能放下人族加成建筑硬编码逻辑⚙️ 实战GameInfo × Ramp × find_placement 的组合拳下面是典型的先预设、后备用、再验证三步走来自 mass_reaper.py 等示例 bot 的思路# 1️⃣ 优先用斜坡预设位一次建对 pos self.main_base_ramp.barracks_correct_placement # 2️⃣ 放不下了就围绕基地自动找一圈 if pos is None: pos await self.find_placement( UnitTypeId.BARRACKS, self.townhalls.random.position, placement_step4, # 步长拉大兵营之间留出空隙 ) # 3️⃣ 最终确认这个位置真的合法再指派工人 if pos and (await self.can_place(UnitTypeId.BARRACKS, [pos]))[0]: worker self.select_build_worker(pos) if worker: worker.build(UnitTypeId.BARRACKS, pos)官方示例里还有很多现成用法可以参考mass_reaper.py围绕最远矿工和基地放置 Depot、兵营proxy_rax.py前压兵营ramp_wall.py教科书级斜坡卡位配合Ramp属性warpgate_push.py用find_placement精确放置单位。⚠️ 常见坑与调优建议max_distance别贪大默认 20 足够常规场景设得太大一旦附近全被占满多出来的搜索环都在空耗帧时间。placement_step决定建筑间距示例中兵营用 4、Depot 用 3就是为了避免建筑挤成一团。想更紧凑就把步长调小。addon_place是人族专用逻辑它硬编码了人族加成建筑bot_ai.py神族/虫族的旁边放得下别的建筑需自行用can_place二次校验。随机性是把双刃剑random_alternativeTrue让对局更不可预测但会让行为不可复现调试时建议关掉固定落点方便排查。找不到位置就跳过find_placement返回None时正确做法是这一帧放弃、下帧重试而不是硬建到旧位置。批量查询更省性能can_place 支持一次传入多个坐标批量验证比循环调用can_place_single高效得多。 关键文件与延伸阅读资源位置斜坡类与建筑预设位Ramp 类地图数据初始化GameInfo 类主基地斜坡查找main_base_ramp核心寻位算法find_placement放置合法性验证can_place / can_place_single更多属性文档docs_generate/game_info、docs_generate/bot_ai总结一句话能用Ramp预设位就用预设位find_placement负责兜底can_place负责最终把关——三件套配合你的机器人从此建筑零失误。【免费下载链接】python-sc2A StarCraft II bot api client library for Python 3项目地址: https://gitcode.com/gh_mirrors/pyt/python-sc2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考