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

# Configuration (config.yml)

```yaml
tool-id: 'sword-tool'      # the EdTools tool this addon drives
debug: false

combat:
  hit-distance: 6          # how close a player must be to hit a zone mob (a zone may override it)
  damage: '{skin-damage} + %edtools_leveling_level_mob-level% * 2 + %edtools_leveling_level_mob-prestige% * 25'
  damage-booster: 'sword-damage, damage'   # EdTools booster economies multiplying the damage ('' = none)
  auto-hit:
    enabled: true          # click once, keep swinging
    interval-ticks: 10
  hurt-effect-cooldown-millis: 150
  kill-currency: 'mob-kills'
  kill-currency-amount: 1
  hit-sound: 'ENTITY_PLAYER_ATTACK_STRONG'
  bossbar:
    enabled: true
    display: '{mob-name} &7[&c{health}&7/&4{max-health}&7]'   # {mob-name} = the mob's bossbar-name
    color: 'red'
  damage-hologram:
    enabled: true
    display: '&c⚔ &f{damage}'
    show-to-others: true               # global sessions: the others see your hits too
    others-display: '&7{player} &c⚔ &f{damage}'
    life-ticks: 25
  reward-hologram:
    enabled: true
    display: '&e+{amount} {currency-name}'
    rise: 1.5              # blocks the text floats up (it pops in, glides up and shrinks away)
    life-ticks: 40         # how long the animation lasts
  death-effect:
    particle: 'SOUL'
    count: 12
    sound: 'ENTITY_GENERIC_DEATH'

zones:
  default-respawn-ticks: 60

server-mobs:
  enabled: true
  disabled-worlds: [spawn]
  damage: '2 + {skin-damage} / 5 + %edtools_leveling_level_mob-level% * 0.5'
  override-damage: true
  enchant-radius: 12
  trigger-enchants: true
  reward-hologram: true
  reward-unlisted-mobs: true
  rosestacker:
    enabled: true
    reward-whole-stack: false

wand:
  material: 'BLAZE_ROD'
  name: '&c&lMob Wand &7({zone} &8/ &7{mob})'
  lore: [...]
  preview-ticks: 200
```

`damage` and `server-mobs.damage` accept `{skin-damage}` (the equipped skin tier's damage), placeholders and math, so the sword can follow the skins, the mob level, the prestige, a rebirth level or anything PlaceholderAPI exposes. The value is cached for half a second per player. See [Sword, skins & damage](/p/edmobswords/features/sword-and-damage.md).

## Boosters

Give the `sword-damage-booster` item of EdTools' `boosters.yml` (or `/boosters global sword-damage 2 600`) to multiply the sword damage; give a `mob-coins` booster to multiply the coins. Crystals, skins and attributes that boost `mob-coins` apply as for any currency.

`messages.yml` holds every player-facing line of the addon.
