<!-- markdownlint-disable MD033 MD041 -->
<p align="center">
  <img alt="LOGO" src="https://maaend.com/MaaEnd-Tiny-512.png" width="256" height="256" />
</p>

<div align="center">

# MaaEnd

<!-- prettier-ignore-start -->
<!-- markdownlint-disable-next-line MD036 -->
_✨ MAA Helper for The End ✨_
<!-- prettier-ignore-end -->

Powered by [MaaFramework](https://github.com/MaaXYZ/MaaFramework) & [MXU](https://github.com/MistEO/MXU)

Actively under development 🎉…

[简体中文](https://github.com/MaaEnd/MaaEnd/blob/v2/README.md) | [English](https://github.com/MaaEnd/MaaEnd/blob/v2/README.en.md)

</div>

## 📖 Notes

This project is **under rapid development**, so you may occasionally encounter small bugs 🐛 (we are working hard to squash them!).

If you run into any issues, feel free to open an [ISSUE](https://github.com/MaaEnd/MaaEnd/issues). We will look into it as soon as possible. More fun features are on the way, stay tuned ✨

> 💡 **Tip**: MaaEnd will auto-update to newer versions. No manual update is required.

## ✨ Features

- 🎁 **One-click preset scenes**: Daily Full, Quick Daily, Realtime Assist, and Essence Farming are all bundled as ready-to-use presets, so common setups are only one-click away. ✨
- 🎮 **Real-time early-game assistant**: The helper keeps watching the screen and fills in key actions on demand, so you can stay focused on exploration and progression. ✨
    - **Auto story**: Skip dialogue, choose branches intelligently, and speed through story scenes when needed.
    - **Interaction handling**: Auto click tutorial guides, flip manuals, tap to continue, and close archive/voice panels without the usual frantic clicking.
    - **Combat assistance**: Auto basic attacks, dodges, skills, ultimates, combo skills, and target lock to keep fights smooth.
    - **Auto loot**: Picks up shiny drops and gathering points automatically so fewer resources slip by.
    - **Convenience actions**: Quick teleport confirmation and auto zipline support make traversal much faster.
    - **Puzzle helper**: Run into a puzzle while exploring? Let the AI solve it on the spot, or switch to the dedicated `🧩 Solve Puzzle` task.
    - **Petting**: Yes, petting support is here too - especially handy together with auto loot. 🐾
- 🧩 **Puzzle Master**: Fast puzzle solving with single-run, loop, and demo-only modes for both practical use and learning.
- 💎 **Essence filtering**: Smart essence recognition with automatic lock/discard behavior based on weapon rarity, essence type, and extra rules. ✨
- 🎱 **Essence farming**: Automatically challenges heavy silt points, supports repeated runs, reward claiming, and post-battle essence filtering in one flow.
- 🌿 **Environment Monitoring**: Automatically clears environment monitoring tasks so routine combat-and-travel work can be handed off.
- ⚔️ **Protocol Space**: Automatically spends sanity on Protocol Space runs with selectable reward routes, making stamina cleanup much easier.
- 🌾 **Eco Farm**: Handles harvesting, planting, and watering, and can also tidy up your bag before and after the run.
- 🧺 **Auto resource gathering**: Follows outdoor gathering routes automatically to collect as many field resources as possible.
- 🎁 **Operator gift delivery**: Automatically heads to the contact desk, gives a gift to an operator, and collects the return gift if available.
- 🔫 **Armory upgrades & production**: Weapon upgrades, gear crafting, simple crafting, and batch simple crafting all help cut down repetitive progression work. 💪
- 💰 **Auto trading/reselling**: Combines stockpiling with flexible-demand goods selling, helping you watch profit margins and manage vouchers more easily. 💸
- 🛒 **Sell Products**: Automatically exchanges products at each outpost into vouchers so you can skip the repetitive clicks.
- 🚚 **Delivery jobs**: Supports full accept-and-forward flows, accept-only mode, and pack-only mode, with per-region toggles.
- 🌆 **Commission snatching**: Automatically grabs commissions from the list and can continue with depot-node routing when configured.
- 💳 **Credit shop purchasing**: Auto-buy credit shop items with support for priorities, discounts, reserve thresholds, and credit-gain linkage.
- 🐌 **Inventory transfer**: Move warehouse stock across regions on the Di Jiang ship in batches - great for batteries, ores, sand leaves, and other stored goods.
- 📐 **Blueprint porter**: Batch import blueprints, intelligently parse share codes or messy text, and get building plans in place with far less manual work.
- 🎁 **Base tasks**: Collect base outputs, restock, and manage clue collection/placement/gifting in one go.
- 🤝 **Visit friends**: Automatically visits friends and handles production assistance plus intel exchange as part of the routine.
- 👥 **Batch friend requests**: Send friend requests in bulk, either to specific UIDs or to strangers, without entering them one by one.
- 💬 **Baker message cleanup**: Clears Baker conversation messages automatically so those chat prompts do not pile up.
- 📅 **Daily automation**: Daily rewards, Simulation Space rewards, encyclopedia red dots, production manual rewards, and more can all be cleaned up in one sweep. ✅
- 💊 **Emergency sanity medication**: One-click emergency sanity medication use saves you a step. 💊
- 💻 **Multi-platform support**: Supports PC (`Win32` default / background / foreground) and Android (`ADB`), so MaaEnd can tag along wherever you play. 🐟

## 🛠️ Developer Guide

Want to contribute or dig deeper into how MaaEnd works? Check out the [developer documentation index](https://github.com/MaaEnd/MaaEnd/blob/v2/docs/en_us/developers/README.md) (Chinese: [zh_cn/README.md](https://github.com/MaaEnd/MaaEnd/blob/v2/docs/zh_cn/developers/README.md)).

We welcome contributions from all developers. Let’s make MaaEnd even better together! 💪

## 💖 Thanks to Contributors

Huge thanks to all contributors who helped build MaaEnd! 🎉 You are all awesome.

[![Contributors](https://contrib.rocks/image?repo=MaaEnd/MaaEnd&max=1000)](https://github.com/MaaEnd/MaaEnd/graphs/contributors)

With your support, MaaEnd continues to grow and improve. ❤️

## 💬 Community

Come hang out and chat with everyone:

- 💬 **User QQ Group**: [1097256935](https://qm.qq.com/q/2AK5MoVfOQ)  
  For usage questions, feature requests, and casual chatting.
- 👨‍💻 **Developer QQ Group**: [1072587329](https://qm.qq.com/q/EyirQpBiW4)  
  Dedicated to development discussion. (For general usage questions, please go to the user group above.)

## ☕ Support Us

If MaaEnd has saved you a lot of time, consider buying the developers a coffee.

Your support is the biggest motivation for us to keep improving MaaEnd! 💖

[<img width="200" alt="Sponsor us" src="https://pic1.afdiancdn.com/static/img/welcome/button-sponsorme.png">](https://afdian.com/a/misteo)
