> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/readme.md).

# Welcome

Welcome to **EnchantedMobs 2**, a configurable plugin that adds level-scaled powers to naturally spawned monsters.

The plugin focuses on extending vanilla combat rather than replacing it:

* Monsters keep their normal AI and behavior.
* Powers are assembled from YAML using triggers, conditions, modifiers, and abilities.
* Visual effects are used selectively so ordinary enhanced mobs remain practical on production servers.
* Difficulty can scale with nearby players and coexist with custom items, enchantments, weapons, skills, and companion systems.

## What changed in 2.0.0?

Version 2.0.0 replaces the old per-event implementation with one unified execution model:

1. A **trigger** creates a runtime context.
2. Typed **conditions** decide whether the power continues.
3. Typed **modifiers** change event values such as damage, healing, projectile data, explosion yield, or revive health.
4. Ordered **abilities** apply the configured effects.

The update also adds reusable registries for abilities, conditions, modifiers, and custom triggers; new control-flow actions such as `any_of`; new player and movement actions; improved projectile tracking; many new bundled powers; and per-power display hiding with `hide-name`.

{% hint style="warning" %}
Custom power files written for 1.x may require changes. Read the [2.0.0 migration guide](/info/2.0.0-migration.md) before updating a production server.
{% endhint %}

## Recommended reading

* [2.0.0 migration guide](/info/2.0.0-migration.md)
* [Mob Powers](/configs/mob-powers.md)
* [Power conditions](/configs/power-conditions.md)
* [Power modifiers](/configs/power-modifiers.md)
* [Ability common options](/configs/info-of-abilities.md)

## Links

### Get the plugin

* **SpigotMC:** [Premium](https://www.spigotmc.org/resources/enchantedmobs-dynamic-mob-abilities-and-player-scaling-difficulty-1-21-3-26-1-1.133242/)
* **Polymart:** [Premium](https://voxel.shop/product/9464/enchantedmobs)
* **BuiltByBit:** [Premium](https://builtbybit.com/resources/enchantedmobs.97592/)

### Get support

Support is provided through the [Discord server](https://discord.gg/RZajEybhBw). Please read the server rules and plugin license before requesting assistance.

Users in mainland China who purchased the plugin may use QQ group `815351827` with proof of purchase.