与WSL三大平台完整教程)
如何安装配置python-sc2开发环境Windows、Linux(Wine)与WSL三大平台完整教程【免费下载链接】python-sc2A StarCraft II bot api client library for Python 3项目地址: https://gitcode.com/gh_mirrors/pyt/python-sc2python-sc2 是一款面向 Python 3 的《星际争霸 II》Bot API 客户端库能让你用不到二十行代码写出一个可运行的 AI 机器人。本文是 Windows、LinuxWine与 WSL 三大平台的安装配置完整教程新手跟着做即可完成 python-sc2 开发环境搭建并跑通第一个 Bot。1️⃣ 准备工作环境要求清单动手前先核对这份准备清单前置条件要求说明Python3.9最高 3.14用python --version检查星际争霸 II 客户端已安装并更新需 3.16.1Build 55958及以上游戏地图至少 1 张库不内置地图需单独下载⚠️ 注意安装并使用该库即表示你同意暴雪的《AI and Machine Learning License》。克隆仓库并安装库PyPI 包名为burnysc2见pyproject.tomlgit clone https://gitcode.com/gh_mirrors/pyt/python-sc2 pip install --upgrade burnysc22️⃣ Windows 平台最快上手的 3 个步骤安装星际争霸 II保持默认安装路径C:\Program Files (x86)\StarCraft II安装库pip install --upgrade burnysc2下载官方地图解压到游戏Maps目录的子目录中如install-dir/Maps/Ladder2017Season1/库会默认读取Documents\StarCraft II\ExecuteInfo.txt来定位你的安装目录逻辑在sc2/paths.py所以只要走默认路径安装装完即可直接运行。3️⃣ Linux 平台用 Wine 运行 SC2 的配置方法Linux 上需要通过 Wine或 Lutris安装并运行 Windows 版 SC2。安装完成后设置以下 3 个环境变量写入.bashrc或在 IDE 中配置均可export SC2PFWineLinux export WINE/usr/bin/wine export SC2PATH/home/你的用户名/Games/battlenet/drive_c/Program Files (x86)/StarCraft II/SC2PF指定平台类型覆盖系统的自动检测WINE指向 wine 可执行文件也可换成 Lutris 自带的 wine 二进制SC2PATH指向 SC2 安装根目录如果你用 PyCharm也可以在Run - Edit Configurations - Environment Variables中设置。不设置SC2PATH时库会默认查找~/.wine/drive_c/Program Files (x86)/StarCraft II。4️⃣ WSL 平台WSL1 与 WSL2 配置区别python-sc2 会自动检测 WSL检测逻辑在sc2/wsl.py并默认启动 Windows 版的星际争霸 IIWSL1基本无需配置系统可能弹出防火墙提示允许 Python 通过即可WSL2拥有独立虚拟网络必须配置两个主机变量否则游戏会卡在黑屏export SC2CLIENTHOST你的WindowsIP export SC2SERVERHOST0.0.0.0Windows IP 可在 PowerShell 或 CMD 中运行ipconfig /all查看。若写入.bashrc记得加上export前缀。如果你想改由 Linux 侧的游戏运行 Bot把环境变量SC2_WSL_DETECT设为0即可关闭 WSL 自动检测import os os.environ[SC2_WSL_DETECT] 05️⃣ 地图下载与正确放置位置地图类型放置位置示例暴雪官方地图Maps下的子目录Maps/Ladder2017Season1/AI Arena 天梯地图Maps的根目录Maps/AcropolisLE.SC2Map 天梯地图必须放在根目录否则天梯回放将无法解析这是新手最容易踩的坑。不确定该下载哪些地图可以参考项目 CI 使用的地图脚本dockerfiles/download_maps.sh和测试脚本test/travis_test_script.py。6️⃣ 验证环境运行你的第一个 Bot一切就绪后直接运行官方示例 Bot 验证环境python examples/zerg/worker_rush.py如果 SC2 窗口自动打开异虫工人集体进攻敌方基地说明环境搭建成功 。examples/目录还内置了丰富的参考项目examples/protoss/cannon_rush.py神族机枪炮塔rushexamples/terran/proxy_rax.py人族前压机枪厂examples/zerg/hydralisk_push.py异虫刺蛇推进examples/bot_vs_bot.py两个 Bot 对战examples/watch_replay.py观看回放7️⃣ 常见问题 FAQQ1提示 SC2 二进制文件太旧怎么办把客户端更新到 3.16.1Build 55958及以上版本库启动时会自动校验版本号逻辑在sc2/paths.py。Q2WSL2 下游戏一直黑屏连不上 Bot说明SC2CLIENTHOST/SC2SERVERHOST未配置或未生效库启动时会打印警告请回到第 4 节检查环境变量。Q3能和 DeepMind 的 pysc2 同时安装吗两者都占用sc2包名无法共存请用虚拟环境隔离。Q4想无图形界面headless运行 Bot项目提供了 Docker 方案dockerfiles/Dockerfile会构建一个仅包含 SC2 Linux 二进制与地图的轻量镜像用法见docs_generate/text_files/docker.rst。8️⃣ 下一步学习资源环境搭建完成后推荐从这些位置继续深入docs_generate/完整 API 文档源Sphinx涵盖 BotAI、单位、游戏状态等模块sc2/bot_ai.pyBot 核心基类你的机器人将继承自BotAIexamples/competitive/可参加天梯的竞技 Bot 项目test/测试脚本与性能基准测试至此python-sc2 开发环境在三大平台的安装配置就完成了。跑通第一个 Bot 后就可以开始动手编写属于自己的星际争霸 II 机器人逻辑【免费下载链接】python-sc2A StarCraft II bot api client library for Python 3项目地址: https://gitcode.com/gh_mirrors/pyt/python-sc2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何安装配置python-sc2开发环境：Windows、Linux(Wine)与WSL三大平台完整教程
如何安装配置python-sc2开发环境Windows、Linux(Wine)与WSL三大平台完整教程【免费下载链接】python-sc2A StarCraft II bot api client library for Python 3项目地址: https://gitcode.com/gh_mirrors/pyt/python-sc2python-sc2 是一款面向 Python 3 的《星际争霸 II》Bot API 客户端库能让你用不到二十行代码写出一个可运行的 AI 机器人。本文是 Windows、LinuxWine与 WSL 三大平台的安装配置完整教程新手跟着做即可完成 python-sc2 开发环境搭建并跑通第一个 Bot。1️⃣ 准备工作环境要求清单动手前先核对这份准备清单前置条件要求说明Python3.9最高 3.14用python --version检查星际争霸 II 客户端已安装并更新需 3.16.1Build 55958及以上游戏地图至少 1 张库不内置地图需单独下载⚠️ 注意安装并使用该库即表示你同意暴雪的《AI and Machine Learning License》。克隆仓库并安装库PyPI 包名为burnysc2见pyproject.tomlgit clone https://gitcode.com/gh_mirrors/pyt/python-sc2 pip install --upgrade burnysc22️⃣ Windows 平台最快上手的 3 个步骤安装星际争霸 II保持默认安装路径C:\Program Files (x86)\StarCraft II安装库pip install --upgrade burnysc2下载官方地图解压到游戏Maps目录的子目录中如install-dir/Maps/Ladder2017Season1/库会默认读取Documents\StarCraft II\ExecuteInfo.txt来定位你的安装目录逻辑在sc2/paths.py所以只要走默认路径安装装完即可直接运行。3️⃣ Linux 平台用 Wine 运行 SC2 的配置方法Linux 上需要通过 Wine或 Lutris安装并运行 Windows 版 SC2。安装完成后设置以下 3 个环境变量写入.bashrc或在 IDE 中配置均可export SC2PFWineLinux export WINE/usr/bin/wine export SC2PATH/home/你的用户名/Games/battlenet/drive_c/Program Files (x86)/StarCraft II/SC2PF指定平台类型覆盖系统的自动检测WINE指向 wine 可执行文件也可换成 Lutris 自带的 wine 二进制SC2PATH指向 SC2 安装根目录如果你用 PyCharm也可以在Run - Edit Configurations - Environment Variables中设置。不设置SC2PATH时库会默认查找~/.wine/drive_c/Program Files (x86)/StarCraft II。4️⃣ WSL 平台WSL1 与 WSL2 配置区别python-sc2 会自动检测 WSL检测逻辑在sc2/wsl.py并默认启动 Windows 版的星际争霸 IIWSL1基本无需配置系统可能弹出防火墙提示允许 Python 通过即可WSL2拥有独立虚拟网络必须配置两个主机变量否则游戏会卡在黑屏export SC2CLIENTHOST你的WindowsIP export SC2SERVERHOST0.0.0.0Windows IP 可在 PowerShell 或 CMD 中运行ipconfig /all查看。若写入.bashrc记得加上export前缀。如果你想改由 Linux 侧的游戏运行 Bot把环境变量SC2_WSL_DETECT设为0即可关闭 WSL 自动检测import os os.environ[SC2_WSL_DETECT] 05️⃣ 地图下载与正确放置位置地图类型放置位置示例暴雪官方地图Maps下的子目录Maps/Ladder2017Season1/AI Arena 天梯地图Maps的根目录Maps/AcropolisLE.SC2Map 天梯地图必须放在根目录否则天梯回放将无法解析这是新手最容易踩的坑。不确定该下载哪些地图可以参考项目 CI 使用的地图脚本dockerfiles/download_maps.sh和测试脚本test/travis_test_script.py。6️⃣ 验证环境运行你的第一个 Bot一切就绪后直接运行官方示例 Bot 验证环境python examples/zerg/worker_rush.py如果 SC2 窗口自动打开异虫工人集体进攻敌方基地说明环境搭建成功 。examples/目录还内置了丰富的参考项目examples/protoss/cannon_rush.py神族机枪炮塔rushexamples/terran/proxy_rax.py人族前压机枪厂examples/zerg/hydralisk_push.py异虫刺蛇推进examples/bot_vs_bot.py两个 Bot 对战examples/watch_replay.py观看回放7️⃣ 常见问题 FAQQ1提示 SC2 二进制文件太旧怎么办把客户端更新到 3.16.1Build 55958及以上版本库启动时会自动校验版本号逻辑在sc2/paths.py。Q2WSL2 下游戏一直黑屏连不上 Bot说明SC2CLIENTHOST/SC2SERVERHOST未配置或未生效库启动时会打印警告请回到第 4 节检查环境变量。Q3能和 DeepMind 的 pysc2 同时安装吗两者都占用sc2包名无法共存请用虚拟环境隔离。Q4想无图形界面headless运行 Bot项目提供了 Docker 方案dockerfiles/Dockerfile会构建一个仅包含 SC2 Linux 二进制与地图的轻量镜像用法见docs_generate/text_files/docker.rst。8️⃣ 下一步学习资源环境搭建完成后推荐从这些位置继续深入docs_generate/完整 API 文档源Sphinx涵盖 BotAI、单位、游戏状态等模块sc2/bot_ai.pyBot 核心基类你的机器人将继承自BotAIexamples/competitive/可参加天梯的竞技 Bot 项目test/测试脚本与性能基准测试至此python-sc2 开发环境在三大平台的安装配置就完成了。跑通第一个 Bot 后就可以开始动手编写属于自己的星际争霸 II 机器人逻辑【免费下载链接】python-sc2A StarCraft II bot api client library for Python 3项目地址: https://gitcode.com/gh_mirrors/pyt/python-sc2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考