mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-16 17:57:01 +08:00
190 lines
12 KiB
Markdown
190 lines
12 KiB
Markdown
<div align="center">
|
||
|
||
<img alt="LOGO" src="https://user-images.githubusercontent.com/18511905/148931479-23aef436-2fc1-4c1e-84c9-bae17be710a5.png" width=360 height=270/>
|
||
|
||
# MaaAssistantArknights
|
||
|
||
<br>
|
||
<div>
|
||
<img alt="C++" src="https://img.shields.io/badge/c++-20-%2300599C?logo=cplusplus">
|
||
</div>
|
||
<div>
|
||
<img alt="platform" src="https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-blueviolet">
|
||
</div>
|
||
<div>
|
||
<img alt="license" src="https://img.shields.io/github/license/MaaAssistantArknights/MaaAssistantArknights">
|
||
<img alt="commit" src="https://img.shields.io/github/commit-activity/m/MaaAssistantArknights/MaaAssistantArknights?color=%23ff69b4">
|
||
<img alt="stars" src="https://img.shields.io/github/stars/MaaAssistantArknights/MaaAssistantArknights?style=social">
|
||
</div>
|
||
<br>
|
||
|
||
[简体中文](README.md) | [繁體中文](README_zh-TW.md) | [English](README_en-US.md) | [日本語](README_ja-JP.md)
|
||
|
||
MAAは、MAA Assistant Arknightsです。
|
||
|
||
アークナイツゲームアシスタント
|
||
|
||
画像認識技術に基づいて、ワンクリックですべてのデイリーリクエストを完了します！
|
||
|
||
絶賛開発中 ✿✿ヽ(°▽°)ノ✿
|
||
|
||
</div>
|
||
|
||
## 機能一覧
|
||
|
||
- 自動作戦、ドロップ認識および[PenguinStats](https://penguin-stats.io/)へデータアップロード（ドロップ認識はJPも対応予定）
|
||
- 自動基地シフト、オペレーター効率計算、単一設備内に最適なソリューション（現在JPは未対応）
|
||
- 自動公開求人、緊急招集票を使う、使い切るのもサポート。[PenguinStats](https://penguin-stats.io/result/stage/recruit/recruit)と[Yituliu](https://yituliu.site/maarecruitdata)へ公開求人データのアップロード
|
||
- 戦友訪問、FP収集、買い物、デイリーリワード収集、ワンクリックして全自動操作！（現在JPは未対応）
|
||
- 統合戦略自動作戦、オペレーターとレベルの自動認識、源石錐とキャンドルの自動収集！（現在JPはベータ対応）
|
||
- 作業JSONファイルをインポートし、自動操作も可能！ [ビデオデモ](https://www.bilibili.com/video/BV14u411673q/)（現在JP未対応/中文）
|
||
- **新機能！倉庫のアイテム認識機能（アルファ）** [Arkplanner](https://penguin-stats.io/planner)/[ARK-NIGHTS.com](https://ark-nights.com/settings)と[アークナイツ ツールボックス](https://arkn.lolicon.app/#/material)へ出力可能！使用方法はツール内文章を参照してください。
|
||
|
||
UIを見れば使い方もすぐ分かる！
|
||
|
||
|
||
|
||
<!--JP未対応のため一旦隠す [image](https://user-images.githubusercontent.com/99072975/172045163-e9ead337-eb62-4f9f-a354-9e302f767a52.png) -->
|
||
|
||
## ダウンロードリンク
|
||
|
||
***初めて使用する場合 `MaaBundle-vX.Y.Z.zip` をダウンロードしてください***
|
||
|
||
***初めて使用する場合 `MaaBundle-vX.Y.Z.zip` をダウンロードしてください***
|
||
|
||
***初めて使用する場合 `MaaBundle-vX.Y.Z.zip` をダウンロードしてください***
|
||
|
||
[安定版](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases/latest)
|
||
[ベータ版](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases)
|
||
|
||
ダウンロードが遅い場合はfastgitミラーを試してみてください
|
||
|
||
[fastgitミラー安定版](https://hub.fastgit.xyz/MaaAssistantArknights/MaaAssistantArknights/releases/latest)
|
||
[fastgitミラーベータ版](https://hub.fastgit.xyz/MaaAssistantArknights/MaaAssistantArknights/releases)
|
||
|
||
## マニュアル
|
||
|
||
### 基本設定
|
||
|
||
1. [エミュレータのサポート](docs/ja-jp/1.3-エミュレータのサポート.md)を参照して、対応するエミュレーターの操作に進んでください。
|
||
2. エミュレータ解像度を `16:9`、`1280 * 720` 以上に変更してください。それより大きい解像度でも大丈夫です。
|
||
3. ゲームスタート！
|
||
|
||
詳しいマニュアルは[MAA使用説明書](docs/ja-jp/1.1-詳細説明.md)を参照してください。
|
||
|
||
## よくある質問
|
||
|
||
- 起動する際にソフトウェアがクラッシュする。
|
||
- 接続エラー、adbパスがわからない場合。
|
||
- 認識エラー、またはオペレーション開始した後に反応がない。
|
||
- カスタムポート設定について。
|
||
|
||
[よくある質問](docs/ja-jp/1.2-よくある質問.md)を参照してください。
|
||
|
||
## サーバーに応じてサポートされる機能
|
||
|
||
- アメリカサーバー
|
||
作戦、戦友訪問、レワード収集、統合戦略（ベータ版）、公開求人認識の機能がサポートされている。
|
||
サポート内容については[README](resource/global/YoStarEN/readme.md)を参照してください。
|
||
- 日本サーバー
|
||
作戦、自動公開求人、戦友訪問、レワード収集、統合戦略（ベータ版）、公開求人認識の機能がサポートされている。
|
||
サポート内容については[README](resource/global/YoStarJP/readme.md)を参照してください。
|
||
- 韓国サーバー
|
||
基本的な作戦機能のみサポートされている。
|
||
サポート内容については[README](resource/global/YoStarKR/readme.md)を参照してください。
|
||
- TXWYサーバー
|
||
基本的な作戦、自動公開求人、公開求人認識の機能がサポートされている。
|
||
サポート内容については[README](resource/global/txwy/readme.md)を参照してください。
|
||
|
||
海外サーバーのユーザーが不足しており、基本的な機能しかサポートされていません。要件があれば[提案](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions)ページで提案をお願い致します。~~いっしょにMAAの開発に協力しましょう~~
|
||
|
||
## 主な関連プロジェクト
|
||
|
||
- 新しいGUI：[MaaAsstElectronUI](https://github.com/MaaAssistantArknights/MaaAsstElectronUI) （開発中、貢献歓迎！）
|
||
- 更新サーバー：[MaaDownloadServer](https://github.com/MaaAssistantArknights/MaaDownloadServer)
|
||
- 公式ウェブサイト <https://www.maa.plus>：[maa-website](https://github.com/MaaAssistantArknights/maa-website)
|
||
- 作業シェアサイト <https://www.prts.plus>：[フロントエンド](https://github.com/MaaAssistantArknights/maa-copilot-frontend)、[バックエンド](https://github.com/MaaAssistantArknights/MaaCopilotServer)
|
||
|
||
## 謝辞
|
||
|
||
### オープンソースライブラリ
|
||
|
||
- 画像認識ライブラリ：[opencv](https://github.com/opencv/opencv.git)
|
||
- ~~テキスト認識ライブラリ：[chineseocr_lite](https://github.com/DayBreak-u/chineseocr_lite.git)~~
|
||
- テキスト認識ライブラリ：[PaddleOCR](https://github.com/PaddlePaddle/PaddleOCR)
|
||
- ~~ステージドロップ認識：[PenguinStats認識](https://github.com/penguin-statistics/recognizer)~~
|
||
- マップタイル認識：[Arknights-Tile-Pos](https://github.com/yuanyan3060/Arknights-Tile-Pos)
|
||
- C++ JSONライブラリ：[meojson](https://github.com/MistEO/meojson.git)
|
||
- C++ オペレーターパーサー：[calculator](https://github.com/kimwalisch/calculator)
|
||
- ~~C++ base64エンコードとデコード：[cpp-base64](https://github.com/ReneNyffenegger/cpp-base64)~~
|
||
- C++ 圧縮・解凍ライブラリ：[zlib](https://github.com/madler/zlib)
|
||
- C++ Gzipカプセル化ライブラリ：[gzip-hpp](https://github.com/mapbox/gzip-hpp)
|
||
- WPF MVVWフレームワーク：[Stylet](https://github.com/canton7/Stylet)
|
||
- WPFコントロールライブラリ：[HandyControl](https://github.com/HandyOrg/HandyControl)
|
||
- C# JSONライブラリ：[Newtonsoft.Json](https://github.com/JamesNK/Newtonsoft.Json)
|
||
- ダウンローダー：[aria2](https://github.com/aria2/aria2)
|
||
|
||
### データソース
|
||
|
||
- ~~公開求人データ：[アークナイツツール](https://www.bigfun.cn/tools/aktools/hr)~~
|
||
- オペレーターおよび基地データ：[PRTSアークナイツ中国語WIKI](http://prts.wiki/)
|
||
- ステージデータ：[PenguinStatsデータ統計](https://penguin-stats.io/)
|
||
- ゲームデータとリソース：[アークナイツbotリソース](https://github.com/yuanyan3060/Arknights-Bot-Resource)
|
||
|
||
### 貢献/協力者
|
||
|
||
MAAをより良くするために開発・テストに貢献してくれたすべての方々に感謝します！ (\*´▽｀)ノノ
|
||
|
||
[](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors)
|
||
|
||
## 開発について
|
||
|
||
### Windows
|
||
|
||
- Visual Studio 2022で `MeoAssistantArknights.sln` を開きます。環境がすでに構成されています。
|
||
- clang-formatのサポートを有効にすることをお勧めします。詳細については、[Visual Studioでclang-formatを有効にする](docs/ja-jp/2.2-プルリクエスト.md)を参照してください。
|
||
|
||
### Linux | macOS
|
||
|
||
[Linuxチュートリアル](docs/ja-jp/2.1-Linuxチュートリアル.md)を参照してください。
|
||
|
||
### API
|
||
|
||
- [Cインターフェース](include/AsstCaller.h)：[統合例](tools/TestCaller/main.cpp)
|
||
- [Pythonインターフェース](src/Python/asst.py)：[統合例](src/Python/sample.py)
|
||
- [Golangインターフェース](src/Golang/maa/)：[統合例](src/Golang/cli.go)（メンテナンスが停止しました orz）
|
||
- [Dartインターフェース](src/dart/)
|
||
- [Javaインターフェース](src/Java/Maaj/src/main/java/com/iguigui/maaj/easySample/MeoAssistant.java)：[統合例](src/Java/Maaj/src/main/java/com/iguigui/maaj/easySample/MaaJavaSample.java)
|
||
- [Rustインターフェース](src/Rust/src/maa_sys/)：[HTTPインターフェース](src/Rust)
|
||
- [HTTPインターフェース](src/Java/Maaj/Readme.md)
|
||
- [統合ドキュメント](docs/ja-jp/3.1-統合ドキュメント.md)
|
||
- [コールバックAPI](docs/ja-jp/3.2-コールバックAPI.md)
|
||
- [タスクAPI](docs/ja-jp/3.4-タスクAPI.md)
|
||
- [自動作戦API](docs/ja-jp/3.3-自動作戦API.md)
|
||
|
||
### Issue bot
|
||
|
||
- `Add {LABEL_NAME}`を使用してタグを追加し、`Remove {LABEL_NAME}` を使用してタグを削除できます。
|
||
- `close #{ISSUE_NUMBER}` または `fix #{ISSUE_NUMBER}` を使用してissueに `fixed` タグを追加できます。
|
||
|
||
詳細については[Issue bot 使用方法](docs/ja-jp/2.3-IssueBot使う方.md)を参照してください。
|
||
|
||
### 開発に参加したいがGitHubの使い方がよくわかりません
|
||
|
||
[Githubプルリクエストのプロセス](docs/ja-jp/2.2-プルリクエスト.md)
|
||
|
||
## 免責事項
|
||
|
||
- 本ソフトウェアのロゴはAGPL 3.0ライセンスを使用しており、オープンソースではなく、絵師[耗毛](https://weibo.com/u/3251357314)および本ソフトウェアのすべての開発者がすべての権利を留保しています。「AGPL 3.0ライセンスに基づいて許可されている」という理由で、許可がない場合に本ソフトウェアのロゴを無断で使用することは禁止しております。また、許可なく商業目的で本ソフトウェアのロゴを無断で使用することも禁止しております。
|
||
- 本ソフトウェアはオープンソースで無料であり、学習と研究のみの目的としています。販売者が本ソフトウェアの料金を請求する場合は、デバイスや時間の料金である可能性があります。発生した問題と結果は、本ソフトウェアとは一切関係ありません。
|
||
|
||
## 広告
|
||
|
||
[ユーザー研究グループ（Telegram）](https://t.me/+Mgc2Zngr-hs3ZjU1)
|
||
自動作戦JSON作業シェア：<https://www.prts.plus>、[QQグループ1（満員）](https://jq.qq.com/?_wv=1027&k=ig786LJZ)、[QQグループ2（満員）](https://jq.qq.com/?_wv=1027&k=R3oleoKc)、[QQグループ3（満員）](https://jq.qq.com/?_wv=1027&k=mKdOnhWV)、[QQグループ4](https://jq.qq.com/?_wv=1027&k=ABkU8mCR)
|
||
[ビリビリ生放送](https://live.bilibili.com/2808861)：毎晩ライブでコーディングします、最近はずっとこのソフトウェアのプログラミングをしていることが多いです。
|
||
[アークナイツ無関係技術研究 & チャットグループ（QQ）](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)：インボリューション・ヘル！
|
||
[開発者グループ（QQ）](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)
|
||
|
||
ソフトウェアが役立つと思うなら、Star（ページの右上隅にある星）をクリックしてください。私たちにとって最高のサポートです！
|