> 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/edmobswords/readme.md).

# Introduction

EdMobSwords documentation.

EdMobSwords is an addon for **EdTools** that adds a **Mob Sword**: an OmniTool that fights mobs the way the pickaxe and hoe mine blocks.

* Players walk into a **mob zone** (a normal EdTools regen zone), the sword is selected for them and **packet mobs** appear on the spawn points you placed with the **mob wand** — shared by everyone in a global session (you see the others fighting them) or private in an alone session. Nothing is a real entity on the server.
* Damage comes from the **sword skins** (a `damage` per tier), the mob level and **sword damage boosters**.
* Every swing can proc one of **26 animated sword enchants** (plus 2 potion-effect enchants), all upgraded from the sword menu with **Mob Coins**, all levelled, prestiged and toggled through EdTools like any other enchant.
* Works with **EdPerks**: the sword carries its own perk and Attack Perks raise its damage.
* The sword also works on the **real mobs of your server** (RoseStacker stacks included) with the same enchants and its own reward table.

Everything the sword needs is created inside the `plugins/EdTools/` folder on first start, so you configure it exactly where you configure the other tools.

## Installation

1. Install EdTools and PlaceholderAPI. RoseStacker is optional.
2. Put `EdMobSwords.jar` in your `plugins` folder and start the server.
3. Follow [Getting started](/p/edmobswords/features/getting-started.md).

Developers: see the [EdMobSwords API](/p/edmobswords/api/edmobswords-api.md).

## Requirements

* EdTools 2.0.25+ (the build that ships the runtime-loader API and zone events).
* Paper 1.20.4 and every version EdTools/EdLib support.