嗨！点点我！点点我！点点我！

简体中文 | 繁体中文 | English | 文档

崩坏：星穹铁道小助手|StarRailAssistant|StarRailAssistant

该脚本仍然处于测试阶段，可能会出现奇奇怪怪的BUG

寻路撞墙？走的路径不对？嫌弃路线太慢？现在beta-2.7新增加地图录制功能
你现在可以使用tool目录下的record_v7.2.py自行录制地图路径，包你走到满意 XD

找到BUG了？代码问题想吐槽？欢迎加入 技术 & 吹水群：QQ 群1(可能满了)|QQ 群2|QQ频道|Telegram Group

该脚本当前版本仅支持 缩放150%，屏幕分辨率2560x1440，现在在大改动中，尽快解决屏幕旋转适配问题

免责声明

本软件是一个外部工具旨在自动化崩坏星轨的游戏玩法。它被设计成仅通过现有用户界面与游戏交互,并遵守相关法律法规。该软件包旨在提供简化和用户通过功能与游戏交互,并且它不打算以任何方式破坏游戏平衡或提供任何不公平的优势。该软件包不会以任何方式修改任何游戏文件或游戏代码。

This software is open source, free of charge and for learning and exchange purposes only. The developer team has the final right to interpret this project. All problems arising from the use of this software are not related to this project and the developer team. If you encounter a merchant using this software to practice on your behalf and charging for it, it may be the cost of equipment and time, etc. The problems and consequences arising from this software have nothing to do with it.

本软件开源、免费，仅供学习交流使用。开发者团队拥有本项目的最终解释权。使用本软件产生的所有问题与本项目与开发者团队无关。若您遇到商家使用本软件进行代练并收费，可能是设备与时间等费用，产生的问题及后果与本软件无关。

请注意，根据MiHoYo的 崩坏:星穹铁道的公平游戏宣言:

"严禁使用外挂、加速器、脚本或其他破坏游戏公平性的第三方工具。"
"一经发现，米哈游（下亦称“我们”）将视违规严重程度及违规次数，采取扣除违规收益、冻结游戏账号、永久封禁游戏账号等措施。"

使用说明

1. 安装Python 3.11 (其他版本安装依赖项时会有很多问题)
   1. 输入pip install -r requirements.txt安装依赖
2. 如果您是第一次运行脚本，还请选择：检测更新-全部更新~
3. 下载最新版星穹铁道小助手
4. 解压文件，并进入文件夹
5. 复制文件夹路径
6. 右键开始菜单，选择终端管理员，输入cd 刚刚复制的路径
7. 输入pip config set global.index-url https://mirrors.aliyun.com/pypi/simple设置国内pip源
8. 输入pip install -r requirements.txt安装依赖
9. 输入Python Honkai_Star_Rail.py运行星穹铁道小助手
10. 使用模拟器请使用1280*720p分辨率，默认为夜神模拟器，其他模拟器使用请先连接上adb(模拟器卡顿可能会吞操作)
11. 跑图过程中出问题了不想跑了想返回主菜单了可以用Ctrl+C并默念爱门

配置文件说明

{
    "real_width": 0, (实际宽度)
    "auto_battle_persistence": 0, (游戏内是否开启自动自动，填1则为开启)
    "real_height": 0, (实际长度)
    "github_proxy": "", (github代理)
    "rawgithub_proxy": "", (github代理)
    "webhook_url": "",
    "start": true, (是否第一次运行脚本)
    "temp_version": "20230515205738",
    "star_version": "20230515220742",
    "level": "INFO",
    "adb": "127.0.0.1:62001",（62001为adb端口）
    "adb_path": "temp\\adb\\adb",（adb文件路径）
    "proxies": "",
    "move_excursion": 0（移动偏移）
}

脚本录制 感谢@AlisaCat

1. WASD移动，X是进战斗，鼠标左键是打障碍物，F键是交互，禁止用鼠标移动视角，只能使用方向键左右来移动视角（脚本运行后方向键左右会映射鼠标移动），录制期间能且只能按动键盘上的一个有效按键（也就是不能同时按下多键），脚本只会录制按键按下时间和移动的视角，不会录制停顿的时间（可以慢慢一个键一个键录制，保证录制准确性），录制完成后F9停止录制并保存。
2. 完成后将会生成output(时间).json文件，请把他重命名替换成你要更改的地图json，并且将传送点截图重命名并保存到temp即可使用 （就可以申请到map分支提交，或者交给管理提交）
3. 地图json中的空白填写示例：

   {
       "name": "乌拉乌拉-1",       （地图json名为1-1_1.json）
       "author": "Starry-Wind",   （作者名，第二作者不能覆盖第一作者名称）
       "start": [           （开局传送地图识别图片，并将鼠标移动至图片中间并按下按键）
           {"map": 1},         （按下m键打开地图）
           {"temp\\orientation_1.jpg": 1.5},     （识别到orientation_1.jpg图片后，将鼠标移动至图片中间并按下按键）
           {"temp\\map_1.jpg": 2},               （具体图片自己看，一般为该区域名"乌拉乌拉"的地图文字）
           {"temp\\map_1_point_1.jpg": 1.5},       （第一个传送点的图片）
           {"temp\\transfer.jpg": 1.5}              （"传送"字的图片）
       ]
   }

注意事项

1. 识图为截取游戏画面，所以不能有任何覆盖
2. 支持地图 空间站「黑塔」、雅利洛VI、仙舟「罗浮」
3. 如果你发现地图有撞墙问题，可以协助更新地图文件提交到这里
4. 请使用三月七来跑图以获得最佳体验
5. 遇到问题,请先确定你使用的是最新版本记得看文档

⭐如果喜欢，点个星星~⭐

未来目标

• 模拟宇宙正在开发
• GUI开发
• 后续将会新增找宝箱、锄大地顺带捡垃圾等功能

贡献

问题反馈 | PR 提交

欢迎各种形式的贡献，包括但不限于：错误修复、代码改进、功能添加、问题反馈。

• StarRailAssistant 的 main 分支是稳定的版本，所有开发均在 main-beta 分支进行。所以如果你想开 Pull Request，你的 commits 需要提交至 main-beta。

贡献者

感谢以下贡献者对本项目做出的贡献

Star History