> 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/edevents/features/integrations.md).

# Plugin Integrations

EdEvents talks to the host plugins only through their public APIs and Bukkit events. Exactly one host is used; it is detected at startup (`host-plugin: AUTO`). Without a supported plugin, vanilla block breaks, kills and damage are tracked and `[GIVE-ECO]` is unavailable.

## EdPrison

* **Blocks**: `EdPrisonBlockBreakEvent` (EdPrison batches hand-mined blocks every few seconds, so scores update in steps) plus `EdPrisonBlocksExplodedEvent` for enchant explosions and fills (only with `objective.count-enchant-blocks: true`). Batched blocks carry no material, so `filter.blocks` cannot be used on EdPrison.
* **Currency earned**: the multiplier event (`EdPrisonAddMultiplierCurrency`) — currency paid with multipliers (block currencies, enchant `givecurrency` with `affectMulti`).
* **Currencies**: every currency and level track (`tokens`, `money`, `rankup`...). Numbers are formatted with EdPrison's notation settings.
* **Action bar**: appended to `actionbar.format` / `formats` (module `actionbar`) with `actionbar.addon-separator`.
* **`[HOST]`**: EdPrison command lists (`[HOST] [GIVEECO] tokens 100`, `[HOST] [PLAYER] warp mine`, plain console commands, `if(...) then` conditions).

## PinnaPrison

* **Blocks**: `BlockMineEvent` for every hand-mined block (with material, so `filter.blocks` works) and `BlocksBrokenEvent` for enchant, bomb, drill and autominer sweeps (only with `objective.count-enchant-blocks: true`).
* **Currency earned**: `CurrencyChangeEvent` of type ADD.
* **Currencies**: every file in `currencies/` with its display name; numbers use `format.yml`.
* **Action bar**: appended to the leveling bar / overrides through the display addon API with `actionbar.addon-separator` (`display.yml`); shown alone when PinnaPrison has nothing to show.
* **`[HOST]`**: PinnaPrison action strings (`[HOST] give-eco tokens 50k`, `[HOST] cmessage &aHi`, `[HOST] open-gui shop`...).
* `require-host-tool` checks the PinnaPrison pickaxe.

## EdTools

* **Blocks**: `EdToolsBreakBlockEvent` for the player's own swings (with material) and `EdToolsBlocksBrokenEvent` for enchant batches (only with `objective.count-enchant-blocks: true`).
* **Currency earned**: `EdToolsCurrencyAddEvent`.
* **Currencies**: every file in `currencies/`; numbers use `%edtools_notation_%`.
* **Action bar**: appended to the zone bar (`actionbar.yml` → `zones`) with `addon-separator`.
* **`[HOST]`**: EdTools action strings (`[HOST] [console] ...`, `[HOST] [menu] backpack`...).
* `require-host-tool` checks that the player carries an OmniTool.

## EdDungeons

* **Mobs killed**: `EdDungeosMobDeathEvent` — zone mobs are packet entities, so only this counts. Mob filters match the mob config id (`cow-legendary`), its tier (`legendary`) and `boss` (mobs with `is-boss: true`).
* **Damage dealt**: `EdDungeonsSwingSwordEvent` (every hit, enchant hits included).
* **Currency earned**: `EdDungeonsCurrencyAddEvent` (boosted payouts).
* **Currencies**: every file in `currencies/` plus external ones; numbers use `%eddungeons_notation_%`.
* **Action bar**: appended to `actionbar.yml` → `display` for players in a zone with `addon-separator`.
* **`[HOST]`**: EdDungeons action strings (`[HOST] [give-eco] souls 100`, `[HOST] [menu] zones`...).
* `require-host-tool` checks that the player carries the dungeon sword.

## PlaceholderAPI

Optional. Enables `%placeholders%` inside every text and the `edevents` expansion ([Placeholders](/p/edevents/features/placeholders.md)).