> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edautofighter/introduction.md).

# Introduction

Welcome to the official documentation for EdAutofighter. This guide provides a comprehensive overview of every feature, configuration, and command available in the plugin.

EdAutofighter is a packet-based per-player autofighter for EdDungeons. It spawns a client-side clone of the player that walks to zone mobs and fights them through EdDungeons' auto-hit pipeline, fueled by a per-player time balance with a configurable daily limit, purchasable upgrades, and selectable target modes.

**Key features:**

* **Packet-only clone** — no real entity is spawned; the fighter is a packet NPC visible only to its owner, wearing their skin, armor and EdDungeons sword.
* **Autofighter Time** — a per-player resource earned via commands (votes, crates, ranks...) and drained only while the fighter is active.
* **Daily limit** — caps how much time can be used per day, with its own reset timer.
* **Upgrades** — Speed, Daily Limit and Target upgrades bought with any EdDungeons currency.
* **Target modes** — Random, Nearest, Enhanced or Boss targeting.
* **Fully configurable GUIs** — file-based menu templates with placeholders, requirements and click actions.
* **H2 storage** — player data lives in an embedded database with periodic autosaves.

## 🚀 Installation

1. Download the latest version of the EdAutofighter plugin (`.jar` file).
2. Place the `EdAutofighter.jar` file into your server's `plugins` folder.
3. Ensure you have the required dependency installed: **EdDungeons** (the autofighter drives its zone auto-hit pipeline through the EdDungeons API). **PlaceholderAPI** is supported as an optional dependency.
4. Restart your server. The plugin will generate its default configuration files in the `plugins/EdAutofighter/` directory.

{% hint style="warning" %}
EdAutofighter **requires EdDungeons** to be installed and enabled — the fighter can only be spawned inside an EdDungeons zone.
{% endhint %}