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

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

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

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

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

找到BUG了？代码问题想吐槽？欢迎加入 技术 & 吹水群：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.1: 输入pip install -r requirements.txt安装依赖

1.2：如果您是第一次运行脚本，还请选择：检测更新-全部更新~

2：确认游戏语言为简体中文，按键配置皆为默认，灵敏度皆为默认值

3：如果你的电脑分辨率为2560*1440，请将游戏分辨率调为1920*1080（窗口化）
如果你的电脑分辨率为1920*1080，请将游戏分辨率调为1920*1080（全屏幕）

4：战斗为游戏自带的自动战斗，确保你的队伍有足够实力平推小怪
(如启用了沿用自动战斗设定，请把config.json里的 "auto_battle_persistence" 改成 1)

5：建议不要在地图上追踪任何东西，并且人物初始位置最好在观景车厢

6：开怪角色请使用远程攻击角色，目前推荐三月七，跑图效果较稳定

7：开启Honkai_Star_Rail.bat等待程序自动运行至可输入地图编号处

8：如果你不知道地图编号是什么，或是你想要重头开始跑图，输入"0"后回车

9：在等待开始五秒期间，请点回游戏画面，确保没有开启任何菜单及界面，并等待程序运行

10：程序运行期间，请勿移动键盘及鼠标，如果移动了极有可能造成偏离或撞墙的问题

11：使用模拟器请使用1280*720p分辨率，默认为夜神模拟器，其他模拟器使用请先连接上adb(模拟器卡顿可能会吞操作)

12：跑图过程中出问题了不想跑了想返回主菜单了可以用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": ""
}

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：遇到问题,请先确定你使用的是最新版本记得看文档

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

1：模拟宇宙正在开发

✔ 2：GUI开发

3：后续将会新增找宝箱、锄大地顺带捡垃圾等功能

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