mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-18 02:10:21 +08:00
189 lines
14 KiB
Markdown
189 lines
14 KiB
Markdown
<div align="center">
|
||
|
||
<img alt="LOGO" src="https://cdn.jsdelivr.net/gh/MaaAssistantArknights/design@main/logo/maa-logo_512x512.png" width="256" height="256" />
|
||
|
||
# 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">
|
||
</div>
|
||
<div>
|
||
<img alt="stars" src="https://img.shields.io/github/stars/MaaAssistantArknights/MaaAssistantArknights?style=social">
|
||
<img alt="GitHub all releases" src="https://img.shields.io/github/downloads/MaaAssistantArknights/MaaAssistantArknights/total?style=social">
|
||
</div>
|
||
<br>
|
||
|
||
[简体中文](../readme.md) | [繁體中文](../zh-tw/readme.md) | [English](../en-us/readme.md) | [日本語](../ja-jp/readme.md) | [한국어](../ko-kr/readme.md)
|
||
|
||
MAAは、MAA Assistant Arknightsです。
|
||
|
||
アークナイツゲームアシスタント
|
||
|
||
画像認識技術に基づいて、ワンクリックですべてのデイリーリクエストを完了します!
|
||
|
||
絶賛開発中 ✿✿ヽ(°▽°)ノ✿<br>
|
||
|
||
</div>
|
||
|
||
## 機能一覧
|
||
|
||
- 自動作戦、ドロップ認識および[PenguinStats](https://penguin-stats.io/)へデータアップロード
|
||
- 自動基地シフト、オペレーター効率計算、単一設備内に最適なソリューション
|
||
- 自動公開求人、緊急招集票を使う、使い切るのもサポート。[PenguinStats](https://penguin-stats.io/result/stage/recruit/recruit)と[Yituliu](https://yituliu.site/maarecruitdata)へ公開求人データのアップロード
|
||
- 戦友訪問、FP収集、買い物、デイリーリワード収集、ワンクリックして全自動操作!
|
||
- 統合戦略自動作戦、オペレーターとレベルの自動認識、源石錐とキャンドルの自動収集!(現在JPはベータ対応)
|
||
- 作業JSONファイルをインポートし、自動操作も可能! [ビデオデモ](https://www.bilibili.com/video/BV1H841177Fk/)(現在JP未対応/中文)
|
||
- 倉庫のアイテム認識機能(ベータ) [Arkplanner](https://penguin-stats.io/planner)/[ARK-NIGHTS.com](https://ark-nights.com/settings)と[アークナイツ ツールボックス](https://arkn.lolicon.app/#/material)へ出力可能!使用方法はツール内文章を参照してください。
|
||
- C、Python、Java、Rust、Golang、Java HTTP、Rust HTTPなどの多種多様なインターフェースに対応、統合や呼び出しが簡単で、自分好みにMAAをカスタマイズできます!
|
||
|
||
UIを見れば使い方もすぐ分かる!<br>
|
||
|
||

|
||

|
||
|
||
## ダウンロードリンク
|
||
|
||
[安定版](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases/latest)<br>
|
||
[ベータ版](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases)
|
||
|
||
## マニュアル
|
||
|
||
### 基本設定
|
||
|
||
1. [エミュレータのサポート](./1.3-エミュレータのサポート.md)を参照して、対応するエミュレーターの操作に進んでください。
|
||
2. エミュレータ解像度を `16:9`、`1280 * 720` 以上に変更してください。それより大きい解像度でも大丈夫です。
|
||
<br>YostarENでは、ゲームインターフェイスの問題から、解像度を`1920 * 1080`に変更することをお勧めします。
|
||
3. ゲームスタート!
|
||
|
||
詳しいマニュアルは[MAA使用説明書](./1.1-詳細説明.md)を参照してください。
|
||
|
||
## よくある質問
|
||
|
||
- 起動する際にソフトウェアがクラッシュする。
|
||
- 接続エラー、adbパスがわからない場合。
|
||
- 認識エラー、またはオペレーション開始した後に反応がない。
|
||
- ダウンロードが中途半端になり "ログイン"/"認証 "のプロンプトが出る。
|
||
|
||
[よくある質問](./1.2-よくある質問.md)を参照してください。
|
||
|
||
## サーバーに応じてサポートされる機能
|
||
|
||
現在、国際クライアント(英語クライアント)、日本語クライアント、韓国語クライアント、繁体字中国語クライアントのほとんどの機能がサポートされています。 ただし、海外ユーザーの少なさとプロジェクト要員不足により、十分に検証できていない機能も多いので、ぜひ体験してみてください。<br>
|
||
バグに遭遇した場合、または特定の機能に対する強い要望がある場合は、[Issues](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues) and [Discussions](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions) で質問してください。 MAA の構築にご参加ください。[海外クライアント対応](#グローバル版を含む海外クライアントの対応について) を参照してください
|
||
|
||
## 主な関連プロジェクト
|
||
|
||
- New Framework: [MaaFramework](https://github.com/MaaAssistantArknights/MaaFramework)
|
||
- 新しいGUI:[MaaAsstElectronUI](https://github.com/MaaAssistantArknights/MaaAsstElectronUI)
|
||
- [作業シェアサイト](https://www.prts.plus):[フロントエンド](https://github.com/MaaAssistantArknights/maa-copilot-frontend)
|
||
- バックエンド:[MaaBackendCenter](https://github.com/MaaAssistantArknights/MaaBackendCenter)
|
||
- [公式ウェブサイト](https://www.maa.plus): [フロントエンド](https://github.com/MaaAssistantArknights/maa-website)
|
||
- Deep Learning: [MaaAI](https://github.com/MaaAssistantArknights/MaaAI)
|
||
|
||
## 謝辞
|
||
|
||
### オープンソースライブラリ
|
||
|
||
- 画像認識ライブラリ:[opencv](https://github.com/opencv/opencv.git)
|
||
- ~~テキスト認識ライブラリ:[chineseocr_lite](https://github.com/DayBreak-u/chineseocr_lite.git)~~
|
||
- テキスト認識ライブラリ:[PaddleOCR](https://github.com/PaddlePaddle/PaddleOCR)
|
||
- ML Deployment: [FastDeploy](https://github.com/PaddlePaddle/FastDeploy)
|
||
- ML accelerator: [onnxruntime](https://github.com/microsoft/onnxruntime)
|
||
- ~~ステージドロップ認識:[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)
|
||
- Android タッチ イベント: [minitouch](https://github.com/openstf/minitouch)
|
||
- Android タッチ イベント: [MaaTouch](https://github.com/MaaAssistantArknights/MaaTouch)
|
||
- 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/)
|
||
- ゲームのデータとリソース:[アークナイツのクライアント資料](https://github.com/yuanyan3060/ArknightsGameResource)
|
||
- ~~ゲームデータ:[アークナイツのゲームデータ](https://github.com/Kengxxiao/ArknightsGameData)~~
|
||
|
||
### 貢献/協力者
|
||
|
||
MAAをより良くするために開発・テストに貢献してくれたすべての方々に感謝します! (\*´▽`)ノノ
|
||
|
||
[](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors)
|
||
|
||
## 開発について
|
||
|
||
### Windows
|
||
|
||
1. ビルド済みのサードパーティ ライブラリをダウンロードします。
|
||
|
||
```cmd
|
||
python maadeps-download.py
|
||
```
|
||
|
||
2. Visual Studio 2022 で `MAA.sln` を開き、`MaaWpfGui` を右クリックして、スタートアップ プロジェクトとして設定します。
|
||
3. `MaaWpfGui` を右クリックし、[プロパティ] - [デバッグ] - [ローカル デバッグを有効にする] を選択します (これにより、C++ コアにブレークポイントを掛けることができます)。
|
||
4. (オプション) PR を送信する場合は、[clang-formatを有効にする](./2.2-プルリクエスト.md)を有効にすることをお勧めします。
|
||
|
||
### Linux | macOS
|
||
|
||
[Linuxチュートリアル](./2.1-Linuxチュートリアル.md)を参照してください。
|
||
|
||
### API
|
||
|
||
- [Cインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/include/AsstCaller.h):[統合例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Cpp/main.cpp)
|
||
- [Pythonインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Python/asst/asst.py):[統合例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Python/sample.py)
|
||
- [Golangインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/master/src/Golang/):[統合例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Golang/maa/maa.go)
|
||
- [Dartインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/master/src/Dart)
|
||
- [Javaインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Java/src/main/java/com/iguigui/maaj/easySample/MaaCore.java):[統合例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Java/src/main/java/com/iguigui/maaj/easySample/MaaJavaSample.java)
|
||
- [Java HTTPインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Java/Readme.md)
|
||
- [Rustインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/master/src/Rust/src/maa_sys):[HTTPインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/master/src/Rust)
|
||
- [TypeScriptインターフェース](https://github.com/MaaAssistantArknights/MaaAsstElectronUI/tree/main/packages/main/coreLoader)
|
||
- [統合ドキュメント](./3.1-統合ドキュメント.md)
|
||
- [コールバックAPI](./3.2-コールバックAPI.md)
|
||
- [タスクAPI](./3.4-タスクAPI.md)
|
||
- [自動作戦API](./3.3-自動作戦API.md)
|
||
|
||
### グローバル版を含む海外クライアントの対応について
|
||
|
||
[海外版クライアントの対応について](./2.5-OVERSEAS_CLIENTS_ADAPTATION.md)をご覧ください。大陸版で既にサポートされている機能を他地域クライアントへ移植するための必要作業の大半は、簡単なJSONの修正と(作業に必要な)スクリーンショットの提出で済みます。。
|
||
|
||
### 開発に参加したいがGitHubの使い方がよくわかりません
|
||
|
||
[Githubプルリクエストのプロセス](./2.2-プルリクエスト.md)
|
||
|
||
### Issue bot
|
||
|
||
詳細については[Issue bot 使用方法](./2.3-IssueBot使う方.md)を参照してください。
|
||
|
||
## 免責事項
|
||
|
||
- 本ソフトウェアのロゴはAGPL 3.0ライセンスを使用しており、オープンソースではなく、[耗毛](https://weibo.com/u/3251357314)とVie、2人のアーティストと開発者がすべての権利を留保しています。「AGPL 3.0ライセンスに基づいて許可されている」という理由で、許可がない場合に本ソフトウェアのロゴを無断で使用することは禁止しております。また、許可なく商業目的で本ソフトウェアのロゴを無断で使用することも禁止しております。
|
||
- 本ソフトウェアはオープンソースで無料であり、学習と研究のみの目的としています。販売者が本ソフトウェアの料金を請求する場合は、デバイスや時間の料金である可能性があります。発生した問題と結果は、本ソフトウェアとは一切関係ありません。
|
||
|
||
## 広告
|
||
|
||
ユーザー研究グループQQグループ:[QQグループ](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)<br>
|
||
ユーザー研究グループTGグループ:[Telegram](https://t.me/+Mgc2Zngr-hs3ZjU1)<br>
|
||
自動作戦JSON作業シェア:[prts.plus](https://prts.plus)<br>
|
||
ビリビリ生放送:[ビリビリ生放送](https://live.bilibili.com/2808861) 毎晩ライブでコーディングします、最近はずっとこのソフトウェアのプログラミングをしていることが多いです。<br>
|
||
<br>
|
||
技術研究(アークナイツ無関係):[インボリューション・ヘル!(QQグループ)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)<br>
|
||
開発者グループ:[QQグループ](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)<br>
|
||
|
||
ソフトウェアが役立つと思うなら、Star(ページの右上隅にある星)をクリックしてください。私たちにとって最高のサポートです!
|