LOGO # MaaAssistantArknights
C++
platform
license commit stars

[简体中文](../readme.md) | [繁體中文](../zh-tw/readme.md) | [English](../en-us/readme.md) | [日本語](../ja-jp/readme.md) | [한국어](../ko-kr/readme.md) MAA는 MAA Assistant Arknights의 약자입니다 명일방주 어시스턴트 이미지 인식을 기반으로, 한 번의 클릭만으로 그날의 모든 작업을 끝내드립니다! 개발 진행 중입니다 ✿✿ヽ(°▽°)ノ✿
## 개요 - 자동 전투, 아이템 드랍 인식, [펭귄 물류](https://penguin-stats.io/)로의 자동 업로드 - 기반시설 자동 배치, 오퍼레이터 효율과 시설 내 최적 배치방안 자동 계산 - 자동 공개모집과 선택적 즉시 모집, [펭귄 물류](https://penguin-stats.io/result/stage/recruit/recruit)와 [Yituliu](https://yituliu.site/maarecruitdata)로의 자동 업로드 - 친구 방문, 크레딧 획득과 아이템 구매, 일일 임무와 보상까지 한 번에! - 통합전략에서의 오리지늄각뿔과 양초 획득을 위한 자동 전투, 오퍼레이터와 레벨의 자동 인식 - 전투 JSON 파일을 통한 자동 전투용 전략 복사! [영상 데모](https://www.bilibili.com/video/BV1H841177Fk/) - 새로운 기능: 창고 인식! [펭귄 물류 ArkPlanner](https://penguin-stats.cn/planner), [arkn.lolicon.app](https://arkn.lolicon.app/#/material)과 [ark-nights.com](https://ark-nights.com/settings)로의 내보내기 지원 말로만 설명하기보다는 사진으로 보여드리겠습니다! ![Screenshot 2023-02-04 011534](https://user-images.githubusercontent.com/61264540/216660360-dc8b96b4-2daa-41d1-a6fc-024886861e4c.png) ![Screenshot 2023-02-04 013950](https://user-images.githubusercontent.com/61264540/216660420-2b0c759e-f8fd-48bf-ae7f-112105faa3a4.png) ## 다운로드 [안정 버전](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases/latest)
[베타 버전](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases) ## 사용 방법 ### 기본 설정 1. [에뮬레이터 지원](./1.3-에뮬레이터_지원.md) 문서를 참고하여 에뮬레이터/기기를 설정해 주세요. 2. 에뮬레이터/기기의 해상도를 `1280 × 720` 또는 그 이상의 `16:9` 비율인 해상도로 맞춰주세요. 3. 어시스턴트 시작! 자세한 내용은 [사용자 설명서](./1.1-사용자_설명서.md)를 참조해 주세요. ## FAQ - 프로그램이 실행하자마자 곧바로 튕겨요 - 연결 오류가 발생해요/ADB 경로를 어떻게 작성해야 하는지 모르겠어요 - 연결은 성공했는데, 그대로 멈춰 버렸어요 - 연결 설정(포트 등)을 바꾸고 싶어요 - 다운로드 속도가 너무 느려요/미러 사이트가 접속이 안 돼요 - 다운로드 도중에 “로그인”이나 “인증”이라는 메시지가 떠요 [FAQ](./1.2-FAQ.md) 문서를 참조해 주세요. ## 해외 서버 지원 현재 인터내셔널 클라이언트(영어 클라이언트), 일본 클라이언트, 한국 클라이언트, 중국어 번체 클라이언트의 대부분의 기능을 지원하고 있습니다. 다만, 해외 사용자 수가 적고 프로젝트 인력이 부족한 관계로 많은 기능이 충분히 테스트되지 않았으니 직접 경험해 보시기 바랍니다.
버그가 발생하거나 특정 기능에 대한 강력한 수요가 있는 경우 문제 및 토론에 오신 것을 환영합니다. 그리고 MAA를 구축하는 데 자유롭게 참여하십시오! [해외클라이언트현지화](#해외클라이언트현지화)을 참조하십시오. ## 관련 프로젝트 - 새 GUI: [MaaAsstElectronUI](https://github.com/MaaAssistantArknights/MaaAsstElectronUI) (현재 개발 중입니다. 도움은 환영합니다!) - [전략 파일 저장소](https://prts.plus): [프론트엔드](https://github.com/MaaAssistantArknights/maa-copilot-frontend) - 백엔드: [MaaBackendCenter](https://github.com/MaaAssistantArknights/MaaBackendCenter) (현재 개발 중입니다. 도움은 환영합니다!) - [공식 웹사이트](https://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) - ~~아이템 드랍 인식: [Penguin Stats recognizer](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++ ZIP 라이브러리: [zlib](https://github.com/madler/zlib) - C++ Gzip 라이브러리: [gzip-hpp](https://github.com/mapbox/gzip-hpp) - 안드로이드 터치 이벤트 구현: [minitouch](https://github.com/openstf/minitouch) - 안드로이드 터치 이벤트 구현: [MaaTouch](https://github.com/MaaAssistantArknights/MaaTouch) - WPF MVVM 프레임워크: [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) ### 데이터 소스 - ~~공개모집 데이터: [ArkTools](https://www.bigfun.cn/tools/aktools/hr)~~ - ~~오퍼레이터/기반시설 데이터: [PRTS Arknights Wiki (Chinese)](http://prts.wiki/)~~ - 스테이지 데이터: [Penguin Stats](https://penguin-stats.io/) - 게임 데이터/리소스: [Arknights Game Resource](https://github.com/yuanyan3060/ArknightsGameResource) - ~~게임 데이터: [Arknights Game Data](https://github.com/Kengxxiao/ArknightsGameData)~~ ### 기여자 MAA의 개선을 위한 개발/테스트에 기여해준 모든 친구들에게 감사드립니다! (\*´▽｀)ノノ [![Contributors](https://contributors-img.web.app/image?repo=MaaAssistantArknights/MaaAssistantArknights)](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors) ## 개발 관련 정보 ### Windows 1. 사전 구축된 타사 라이브러리를 다운로드합니다. ```cmd python maadeps-download.py ``` 2. Visual Studio 2022로 `MAA.sln`을 열고 `MaaWpfGui`를 마우스 오른쪽 버튼으로 클릭하고 시작 프로젝트로 설정합니다. 3. `MaaWpfGui` - 속성 - 디버깅 - 로컬 디버깅 활성화를 마우스 오른쪽 버튼으로 클릭합니다(따라서 C++ Core에 중단점을 걸 수 있습니다). 4. (선택 사항) PR을 제출하려는 경우 [clang-format support](../en-us/2.2-DEVELOPMENT.md#using-clang-format-in-visual-studio)를 활성화하는 것이 좋습니다. ### Linux/MacOS [Linux_튜토리얼](../en-us/2.1-LINUX_TUTORIAL.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) - [통합](../en-us/3.1-INTEGRATION.md) - [콜백 형식](../en-us/3.2-CALLBACK_SCHEMA.md) - [임무 형식](../en-us/3.4-TASK_SCHEMA.md) - [전략 형식](../en-us/3.3-COPILOT_SCHEMA.md) ### 해외클라이언트현지화 [해외 클라이언트 현지화](../en-us/2.5-OVERSEAS_CLIENTS_ADAPTATION.md) 문서를 참고하세요. 대부분의 경우 CN 서버에서 이미 지원하는 기능들은 스크린샷과 간단한 JSON 파일 조작만으로도 타 서버에서 사용 가능합니다. ### GitHub에 익숙치 않은 사용자용 가이드 [Development](../en-us/2.2-DEVELOPMENT.md#introduction-to-github-pull-request-flow) ### Issue Bot 자세한 내용은 [Issue Bot 사용방법](../en-us/2.3-ISSUE_BOT_USAGE.md)을 참조해 주세요. ## 주의사항 - 이 프로그램의 로고는 AGPL 3.0 라이센스의 적용 대상이 아닙니다. [耗毛](https://weibo.com/u/3251357314)와 Vie 두 명의 아티스트와 프로그램의 개발자들이 모든 권리를 가집니다. 프로젝트가 AGPL 3.0 라이센스 하에 있다고 하더라도 프로그램의 로고는 동의 없이 사용되어서는 안 되며, 동의 없는 상업적 이용 또한 금지됩니다. - 이 프로그램은 오픈소스이자 무료이며 학습 및 커뮤니케이션 전용입니다. 이 프로그램을 이용해 장비값이나 시간당 수수료 등을 대가로 서비스를 제공하는 판매자로 인해 발생하는 문제와 결과는 프로그램의 개발자들에게는 책임이 없습니다. ## 광고 사용자 그룹: [Telegram](https://t.me/+Mgc2Zngr-hs3ZjU1), [QQ 그룹](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)
[전략 JSON 공유](https://prts.plus)
[빌리빌리 라이브](https://live.bilibili.com/2808861): 코딩 과정을 밤마다 방송하고 있습니다. 이 프로그램에 대부분의 시간을 할애하고 있습니다.
[명일방주 무관 기술 공유 & 만담 (QQ 그룹)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2): 지옥 같아요!
[개발자 그룹 (QQ 그룹)](https://jq.qq.com/?_wv=1027&k=JM9oCk3C) 프로그램이 도움이 된다고 생각하시면 Star를 눌러주세요! (페이지 우측 상단의 작은 별) 저희에게 가장 큰 도움이 됩니다!