generated from MaaXYZ/MaaPracticeBoilerplate
-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
30 changed files
with
3,046 additions
and
378 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,96 +1,90 @@ | ||
<!-- markdownlint-disable MD033 MD041 --> | ||
<p align="center"> | ||
<img alt="LOGO" src="https://cdn.jsdelivr.net/gh/MaaAssistantArknights/design@main/logo/maa-logo_512x512.png" width="256" height="256" /> | ||
</p> | ||
# MCCA | ||
|
||
<div align="center"> | ||
基于全新架构的 交错战线 小助手。图像技术 + 模拟控制,解放双手! | ||
由 [MaaFramework](https://github.com/MaaXYZ/MaaFramework) 强力驱动! | ||
|
||
# MaaPracticeBoilerplate | ||
## 功能介绍 | ||
|
||
</div> | ||
目前已有的功能: | ||
|
||
本仓库为 [MaaFramework](https://github.com/MaaXYZ/MaaFramework) 所提供的项目模板,开发者可基于此模板直接创建自己的 MaaXXX 项目。 | ||
1. 启动游戏 | ||
2. 每日免费礼包 | ||
3. 每日探索(只使用自然回复的燃料) | ||
4. 模拟军演(只打第一个,次数耗尽为止) | ||
5. 基建(换班+好友换抽) | ||
6. 周本(只刷第一关,需提前配好至少一队,二队可刷好感) | ||
7. 领取奖励(邮箱+每日+通行证) | ||
8. 关闭游戏 | ||
|
||
> **MaaFramework** 是基于图像识别技术、运用 [MAA](https://github.com/MaaAssistantArknights/MaaAssistantArknights) 开发经验去芜存菁、完全重写的新一代自动化黑盒测试框架。 | ||
> 低代码的同时仍拥有高扩展性,旨在打造一款丰富、领先、且实用的开源库,助力开发者轻松编写出更好的黑盒测试程序,并推广普及。 | ||
## 使用说明 | ||
|
||
下载地址:<https://github.com/MaaXYZ/MCCA/releases> | ||
|
||
## 即刻开始 | ||
### Windows | ||
|
||
- [📄入门文档](https://github.com/MaaXYZ/MaaFramework/blob/main/docs/zh_cn/1.1-%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B.md) | ||
- [🎞️视频教程](https://www.bilibili.com/video/BV1yr421E7MW) | ||
- 对于绝大部分用户,请下载 `MCCA-win-x86_64-vXXX.zip` | ||
- 若确定自己的电脑是 arm 架构,请下载 `MCCA-win-aarch64-vXXX.zip` | ||
- 解压后运行 `MaaPiCli.exe` 即可 | ||
|
||
## 如何开发 | ||
### macOS | ||
|
||
0. 使用右上角 `Use this template` - `Create a new repository` 来基于本模板创建您自己的项目。 | ||
- 若使用 Intel 处理器,请下载 `MCCA-macos-x86_64-vXXX.zip` | ||
- 若使用 M1, M2 等 arm 处理器,请下载 `MCCA-macos-aarch64-vXXX.zip` | ||
- 使用方式: | ||
|
||
1. 完整克隆本项目及子项目(地址请修改为您基于本模板创建的新项目地址)。 | ||
```bash | ||
chmod a+x MaaPiCli | ||
./MaaPiCli | ||
``` | ||
|
||
```bash | ||
git clone --recursive https://github.com/MaaXYZ/MaaPracticeBoilerplate.git | ||
``` | ||
|
||
**请注意,一定要完整克隆子项目,不要漏了 `--recursive`,也不要下载 zip 包!** | ||
### Linux | ||
|
||
2. 下载 MaaFramework 的 [Release 包](https://github.com/MaaXYZ/MaaFramework/releases),解压到 `deps` 文件夹中。 | ||
~~用 Linux 的大佬应该不需要我教~~ | ||
|
||
3. 配置资源文件。 | ||
## 其他说明 | ||
|
||
```bash | ||
python ./configure.py | ||
``` | ||
- 添加 `-d` 参数可跳过交互直接运行任务,如 `./MaaPiCli.exe -d` | ||
- 反馈问题请附上日志文件 `debug/maa.log`,谢谢! | ||
|
||
4. 按需求修改 `assets` 中的资源文件,请参考 MaaFramework 相关文档。 | ||
## 图形化界面 | ||
|
||
- 可使用 [MaaDebugger](https://github.com/MaaXYZ/MaaDebugger) 进行调试; | ||
- 也可以在本地安装后测试: | ||
先凑活用吧( | ||
|
||
1. 执行安装脚本 | ||
## How to build | ||
|
||
```bash | ||
python ./install.py | ||
``` | ||
**如果你要编译源码才看这节,否则直接 [下载](https://github.com/MaaXYZ/MCCA/releases) 即可** | ||
|
||
2. 运行 `install/MaaPiCli.exe` | ||
|
||
5. 完成开发工作后,上传您的代码并发布版本。 | ||
0. 完整克隆本项目及子项目 | ||
|
||
```bash | ||
# 配置 git 信息(仅第一次需要,后续不用再配置) | ||
git config user.name "您的 GitHub 昵称" | ||
git config user.email "您的 GitHub 邮箱" | ||
# 提交修改 | ||
git add . | ||
git commit -m "XX 新功能" | ||
git push origin HEAD -u | ||
git clone --recursive https://github.com/MaaXYZ/MCCA.git | ||
``` | ||
|
||
6. 发布您的版本 | ||
|
||
需要先修改仓库设置 `Settings` - `Actions` - `General` - `Read and write permissions` - `Save` | ||
1. 下载 MaaFramework 的 [Release 包](https://github.com/MaaXYZ/MaaFramework/releases),解压到 `deps` 文件夹中 | ||
2. 安装 | ||
|
||
```bash | ||
# CI 检测到 tag 会自动进行发版 | ||
git tag v1.0.0 | ||
git push origin v1.0.0 | ||
```python | ||
python ./install.py | ||
``` | ||
|
||
## 生态共建 | ||
生成的二进制及相关资源文件在 `install` 目录下 | ||
|
||
## 开发相关 | ||
|
||
MAA 正计划建设为一类项目,而非舟的单一软件。 | ||
- [MaaFramework 快速开始](https://github.com/MaaXYZ/MaaFramework/blob/main/docs/zh_cn/1.1-%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B.md) | ||
|
||
若您的项目依赖于 MaaFramework,我们欢迎您将它命名为 MaaXXX, MXA, MAX 等等。当然,这是许可而不是限制,您也可以自由选择其他与 MAA 无关的名字,完全取决于您自己的想法! | ||
## Join us | ||
|
||
同时,我们也非常欢迎在 [最佳实践列表](https://github.com/MaaXYZ/MaaFramework#%E6%9C%80%E4%BD%B3%E5%AE%9E%E8%B7%B5) 中添加上您的项目! | ||
- MCCA 开发交流 QQ 群:513065464 | ||
- MaaFramework 开发交流 QQ 群: 595990173 | ||
|
||
## 鸣谢 | ||
|
||
本项目由 **[MaaFramework](https://github.com/MaaXYZ/MaaFramework)** 强力驱动! | ||
|
||
感谢以下开发者对本项目作出的贡献(下面链接改成你自己的项目地址): | ||
|
||
<a href="https://github.com/MaaXYZ/MaaFramework/graphs/contributors"> | ||
<img src="https://contrib.rocks/image?repo=MaaXYZ/MaaFramework&max=1000" /> | ||
<a href="https://github.com/MaaXYZ/MCCA/graphs/contributors"> | ||
<img src="https://contrib.rocks/image?repo=MaaXYZ/MCCA&max=1000" /> | ||
</a> | ||
|
Oops, something went wrong.