> 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/features/getting-started.md).

# Getting started

## What the first start creates

In `plugins/EdTools/`:

| File                                                  | What it is                                                              |
| ----------------------------------------------------- | ----------------------------------------------------------------------- |
| `tools/sword-tool/config.yml`                         | the sword OmniTool (lore, enchant format, skins, `server-mobs` rewards) |
| `tools/sword-tool/skins/*.yml`                        | wooden, golden and diamond sword skins                                  |
| `zones/main-mobs.yml`                                 | the mob zone                                                            |
| `enchants/sword-*.yml`                                | the sword enchants                                                      |
| `guis/sword.yml`                                      | the sword enchants menu                                                 |
| `currencies/mob-coins.yml`                            | the currency the enchants cost                                          |
| `currencies/mob-kills.yml`                            | +1 per kill; it levels the `mob-level` track                            |
| `leveling/mob-level.yml`, `leveling/mob-prestige.yml` | progression                                                             |

A `main-mobs` line is also added to `actionbar.yml` and `xpbar.yml` (only if there is none yet).

In `plugins/EdMobSwords/`: `config.yml`, `messages.yml` and `mobs/*.yml` (the mob templates).

{% hint style="info" %}
Existing files are never overwritten. Delete a file to get the default back on the next start.
{% endhint %}

## Set up the arena

1. Open `plugins/EdTools/zones/main-mobs.yml` and set `world`, `min-corner` and `max-corner` to the area of your arena, like any other EdTools zone. Restart (zones are read at startup) or run `/edmobswords reload`, which also loads the zone into EdTools.
2. Get a wand: `/edmobswords wand main-mobs zombie`.
3. Right-click the blocks where a zombie should stand. Swap the mob with another wand (`/edmobswords wand main-mobs skeleton`) and keep placing.
4. Sneak + right-click to see every spawn point of the zone; left-click a block to remove the closest point.

Walk into the arena: EdTools swaps the player's tool to the sword and the mobs appear — shared with everyone else in the arena (global session) or private (alone session). Left-click a mob to attack it (auto-hit keeps swinging), right-click the sword to open the enchants menu. Damage comes from the sword skins, the mob level and sword-damage boosters — see [Sword, skins & damage](/p/edmobswords/features/sword-and-damage.md).

## Give the sword

New players get the tool EdTools gives on first login (`omnitool.default-tool`). The sword is selected automatically when they enter a mob zone. To hand it out manually: `/edmobswords give <player>` (swaps their OmniTool to the sword, or gives one if they have none).

## More zones

Copy `main-mobs.yml`, change the corners and keep the `mobs:` section - any EdTools zone file with a `mobs:` section is a mob zone. See [Mob zones & the wand](/p/edmobswords/features/mob-zones.md).