<!-- markdownlint-disable MD028 MD029 MD033 MD041 -->
<div align="center">
  <img alt="LOGO" src="/assets/logo.png" width="256" height="256" />

# MaaNTE

  <p align="center">
    MAA異環小助手
    <br/>
    <a href="/docs/eng/README_en.md">English</a> | <a href="/README.md">简体中文</a> | <a href="/docs/README_zh-tw.md">繁體中文</a> | <a href="https://github.com/1bananachicken/MaaNTE/issues">报告 Bug</a>
  </p>

  <p align="center">
    <img src="https://img.shields.io/badge/Platform-Windows-0078D7?style=flat-square&logo=Windows" alt="Platform" />
    <img src="https://img.shields.io/badge/Language-Python%20%2F%20PipeLine-blue?style=flat-square&logo=Python" alt="Language" />
    <img alt="license" src="https://img.shields.io/github/license/1bananachicken/MaaNTE?style=flat-square">
    <br>
    <a href="https://maafw.com/" target="_blank"><img alt="website" src="https://raw.githubusercontent.com/MaaXYZ/MaaFramework/refs/heads/main/docs/static/maafw.svg"></a>
    <a href="https://mirrorchyan.com/zh/projects?rid=MaaNTE" target="_blank"><img alt="mirrorc" src="https://raw.githubusercontent.com/MaaXYZ/MaaFramework/refs/heads/main/docs/static/mirrorc-zh.svg"></a>
    <a href="https://space.bilibili.com/3546893080594665" target="_blank"><img alt="Bilibili" src="https://img.shields.io/badge/Bilibili-MaaNTE--Official-00A1D6?logo=bilibili"></a>
    <a href="https://discord.gg/e6mPMRYQpR" target="_blank"><img alt="Discord" src="https://img.shields.io/badge/Discord-MaaNTE--Official-5865F2?logo=discord"></a>
    <br/>
    <img alt="commit" src="https://img.shields.io/github/commit-activity/m/1bananachicken/MaaNTE?&style=flat-square&logo=github&color=darkgreen">
    <img src="https://img.shields.io/github/stars/1bananachicken/MaaNTE?style=flat-square&logo=github&color=darkgreen" alt="Stars" />
  </p>

[MaaFramework](https://github.com/MaaXYZ/MaaFramework) によって強力に駆動されています！

</div>

> [!Caution]
>
> 最近、多くのアカウントがこのソフトウェアを二次配布し、さらには公式アカウントを偽装する事例が発生しています。 非公式な手段で入手したソフトウェアには**ウイルスが含まれている可能性**があり、一般的に最新のバージョンではありませんので、注意して見分けてください。
>
>最近、私たちはこのプロジェクトの名を借りてウイルスを広める行為があることを発見しました。ダウンロードする際は公式のチャネルを確認してください。

> [!Tip]
>
> 本プロジェクトはまだ初期開発段階にあり、PRやIssueの提出を歓迎します。

> [!Tip]
>
> bili.com 公式: [MaaNTE-Official](https://space.bilibili.com/3546893080594665)
>
> QQ Group 1: 1103323319 (満員)
>
> QQ Group 2: 1101147419 (満員)
>
> QQ Group 3: 1075143235 (満員)
>
> QQ Group 4: 713114598

# ⚠️免責事項とリスク警告

> [!Note]
>
> 本ソフトウェアはサードパーティ製ツールであり、ゲーム画面を認識し、通常の操作をシミュレートすることで、『異環』のゲームプレイを簡素化するものです。本プロジェクトは関連する法律および規制を遵守しています。本プロジェクトはユーザーの反復作業を簡素化することを目的としており、ゲームのバランスを損なったり、不公平な優位性を提供したりすることはありません。また、ゲームファイルやデータを改変することもありません。
>
> 本プロジェクトはオープンソースかつ無料であり、学習および交流の目的でのみご利用ください。商業目的や営利目的での使用はご遠慮ください。開発チームは本プロジェクトに関する最終な解釈権をします。本ソフトウェアの使用に起因するいかなる問題についても、本プロジェクトおよび開発者は一切の責任を負いません。

> [!Caution]
>
> 根据[ゲーム運営の公平性に関するお知らせ](https://nte.perfectworld.com/jp/article/news/gamebroad/20260206/260831.html )：
>
> 非公式ツールなど、ゲームの公平性を損なうツールの使用を固く禁止いたします。加速器やチートプログラム、マクロスクリプトなどの外部ツールの利用行為は厳しく取り締まり、違反が確認された場合は厳正に対処いたします。違反行為には、オートプレイ、スキルのスピードアップ、無敵化、瞬間移動、ゲーム内データの改ざんなどが含まれますが、これらに限られません。確認された場合、事実に基づきアカウント停止等の措置を取らせていただきます。
>
> **あなたは、このツールを使用することによって生じる可能性のあるすべてのリスクを十分に理解し、自発的に引き受けるべきです。**

## 🧾オープンソースライセンス

このソフトウェアは [GNU Affero General Public License v3.0 only](https://spdx.org/licenses/AGPL-3.0-only.html) をオープンソースで使用します。

## ✨機能一覧

- 🎣 自动钓鱼
  - 🐟 自動釣り
  - 🪝 自動で餌を買う
- 🥤 自動でコーヒーを作る
  - 🔨 すべての顧客を追い出す
- 💰 自動的にカフェの収益を抽出する
  - 📦 自動補充貨物
- 💎 自動で報酬を受け取る
  - 🎁 アクティブ度
  - 📅 環期賞令
- 🕛 リアルタイム支援
  - 🗼 自動传送
  - ⏩ 自動でストーリーをスキップ
- ⚔️ 自動回避
  - 🛡️ 音声認識に基づく自動回避/反撃
- 🎵 自動超強音
  - 🥁 循環演奏迷星叫
- 🎹 自動演奏ピアノ
  - 📂 任意のMIDIインポートをサポート

## ❓よくある質問

### 📄トラブルシューティングマニュアル

まずは[トラブルシューティングマニュアル](../jp/トラブルシューティングマニュアル.md)に行って、解決策を探してください。

### 🤔どうやって起動するかわからない？

- 普通のユーザーはリリース版をダウンロードしてください。開発の必要がある場合は、リポジトリをクローンしてください。

## 💡注目事項

ゲームは1280x720の解像度でウィンドウモードで実行する必要があり、釣りの新しいアルゴリズムは120フレームでの実行をサポートしています。

## 💻开发指南

<details><summary>点击展开</summary>

MaaNTE开发者群: 1092630280

### 快速开始

0. 配置环境

- 安装 python>=3.11
- 建议使用vscode作为IDE进行开发，并安装 [vscode插件“maa-support”](https://marketplace.visualstudio.com/items?itemName=nekosu.maa-support) 进行调试

1. Fork项目

- 点击 `Fork`，继续点击 `Create Fork`

2. 克隆自己 fork 的项目到本地，并拉取子模块

```bash
git clone --recursive https://github.com/<你的用户名>/MaaNTE.git
```

3. 下载MaaFramework的 [release包](https://github.com/MaaXYZ/MaaFramework/releases)，解压到 `deps` 文件夹中

4. 提交PR

- 新功能开发请提交到dev分支

更多开发文档可以参考 [M9A文档站](https://1999.fan/zh_cn/develop/development.html)

</details>

## ❤️謝辞

### オープンソースプロジェクト

- [MaaFramework](https://github.com/MaaXYZ/MaaFramework)
  基于图像识别的自动化黑盒测试框架
- [MXU](https://github.com/MistEO/MXU)
  MaaFramework Next UI
- [MaaAssistantArknights](https://github.com/MaaAssistantArknights/MaaAssistantArknights)
  《明日方舟》小助手，全日常一键长草！
- [MaaEnd](https://github.com/MaaEnd/MaaEnd)
  基于视觉 AI 的「明日方舟：终末地」自动化工具
- [M9A](https://github.com/MAA1999/M9A)
  重返未来：1999 小助手
- ~~[MFAAvalonia](https://github.com/SweetSmellFox/MFAAvalonia)
  基于 Avalonia UI 构建的 MaaFramework 通用 GUI 解决方案~~

### 貢献者/参加者

テストと開発に参加してくれたすべての開発者に感謝します(´▽`ʃ♡ƪ)

[![Contributors](https://contributors-img.web.app/image?repo=1bananachicken/MaaNTE&max=1000)](https://github.com/1bananachicken/MaaNTE/graphs/contributors)

## ☕私たちにコーヒーをください。

もしMaaNTEがあなたの時間を大いに節約してくれたなら、開発者にコーヒーを奢ってあげてはいかがでしょうか？

あなたのサポートが私たちの継続的な更新の最大の原動力です🥰。

[<img width="200" alt="赞助我们" src="https://pic1.afdiancdn.com/static/img/welcome/button-sponsorme.png">](https://afdian.com/a/MaaNTE)

## ⭐Star History

もしこのソフトウェアがあなたに役立つと思ったら、ぜひスターを押してください！~（ウェブページの最上部右上角の小さな星）、これが私たちへの最大のサポートです！
<a href="https://www.star-history.com/?repos=1bananachicken%2FMaaNTE&type=date&legend=top-left">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=1bananachicken/MaaNTE&type=date&theme=dark&legend=top-left" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=1bananachicken/MaaNTE&type=date&legend=top-left" />
   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=1bananachicken/MaaNTE&type=date&legend=top-left" />
 </picture>
</a>
