> For the complete documentation index, see [llms.txt](https://axiomemu.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://axiomemu.gitbook.io/docs/data/plugins.md).

# Plugins

Plugin configuration for modular server features

Plugins are modular features that extend GameServer functionality. Each plugin can be enabled or disabled independently.

See also: [Data overview](/docs/data/data.md) for where plugins sit within the shared game content tree.

## Available Plugins

### Characters (`Data/Plugins/Characters/`)

| Plugin                                                   | File                  | Purpose                                                            |
| -------------------------------------------------------- | --------------------- | ------------------------------------------------------------------ |
| [Reset System](/docs/data/plugins/resetsystem.md)        | `ResetSystem.xml`     | Character reset and grand reset progression                        |
| [VIP System](/docs/data/plugins/vipsystem.md)            | `VIP/VIPSystem.xml`   | Premium membership tiers and benefits                              |
| [SkillTweaks](/docs/data/plugins/skilltweaks.md)         | `SkillTweaks.xml`     | Per-skill attack speed scaling + mounted-cast override             |
| [BotBuffer](/docs/data/plugins/botbuffer.md)             | `BotBuffer.xml`       | NPC bot buffers with per-bot equipment and gates                   |
| [CustomCombo](/docs/data/plugins/customcombo.md)         | `CustomCombo.xml`     | Cross-class combo skill definitions                                |
| [CustomStartItem](/docs/data/plugins/customstartitem.md) | `CustomStartItem.xml` | Per-class starter items, buffs, currency                           |
| [Catch-Up System](/docs/data/plugins/catchup.md)         | `CatchUpSystem.xml`   | Scaled EXP, drop and zen bonuses for characters behind the leaders |

### Items (`Data/Plugins/Items/`)

| Plugin                                                     | File                                                                             | Purpose                                                                                                                                     |
| ---------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| [ChaosMix](/docs/data/plugins/chaosmix.md)                 | `ChaosMix/ChaosMix_Recipes.xml`, `ChaosMix_Formulas.xml`, `ChaosMix_Options.xml` | Chaos machine recipes, formulas, options                                                                                                    |
| [Jewels Bank](/docs/data/plugins/jewelsbank.md)            | `JewelsBank/JewelsBank.xml`                                                      | Account-wide jewel storage system                                                                                                           |
| [CustomItemVisual](/docs/data/plugins/customitemvisual.md) | `CustomItemVisual.xml`                                                           | Client-side item visual overrides                                                                                                           |
| [CustomJewel](/docs/data/plugins/customjewel.md)           | `CustomJewel.xml`                                                                | Custom jewel definitions and filters                                                                                                        |
| [ItemEffect](/docs/data/plugins/itemeffect.md)             | `ItemEffect.xml`                                                                 | Custom consumable buffs (paid plugin)                                                                                                       |
| [ItemSellPost](/docs/data/plugins/itemsellpost.md)         | `ItemSellPost.xml`                                                               | Sell-post chat broadcast                                                                                                                    |
| [WarehousePage](/docs/data/plugins/warehousepage.md)       | `WarehousePage.xml`                                                              | Multi-page warehouse expansions                                                                                                             |
| [CustomPets](/docs/data/plugins/custompets.md)             | `CustomPets.xml`                                                                 | Custom pets and rideable mounts                                                                                                             |
| [ItemEmitters](/docs/data/plugins/itememitters.md)         | `ItemEmitters.xml`                                                               | Particle emitters attached to items                                                                                                         |
| [ItemImplicit](/docs/data/plugins/itemimplicit.md)         | `ItemImplicit.xml`                                                               | Per-class, per-item-range implicit bonuses (wizardry / curse / scepter pet damage, book success rate) - replaces `Item.xml MagicDamageRate` |
| [TooltipExpansion](/docs/data/plugins/tooltipexpansion.md) | `TooltipExpansion.xml`                                                           | Extra tooltip labels and borders driven by option filters                                                                                   |
| [SummonItem](/docs/data/plugins/summonitem.md)             | `SummonItem.xml`                                                                 | Drop an item to spawn scaled monsters with their own loot bag (paid plugin)                                                                 |

### Events (`Data/Plugins/Events/`)

| Plugin                                                   | File                  | Purpose                                                         |
| -------------------------------------------------------- | --------------------- | --------------------------------------------------------------- |
| [EventTimerInfo](/docs/data/plugins/eventtimerinfo.md)   | `EventTimerInfo.xml`  | Event timer display and tooltips                                |
| [CustomArena](/docs/data/plugins/customarena.md)         | `CustomArena.xml`     | Scheduled PvP arenas                                            |
| [CustomEventDrop](/docs/data/plugins/customeventdrop.md) | `CustomEventDrop.xml` | Scheduled item-drop events                                      |
| [EntryLimits](/docs/data/plugins/entrylimits.md)         | `EntryLimits.xml`     | Daily / weekly entry limits per account for events and dungeons |

### World (`Data/Plugins/World/`)

| Plugin                                                           | File                       | Purpose                                                                                                                |
| ---------------------------------------------------------------- | -------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| [MuHelperPickup](/docs/data/plugins/muhelperpickup.md)           | `MuHelperPickup.xml`       | Auto-pickup item configuration                                                                                         |
| [StressBotPlugin](/docs/data/plugins/stressbotplugin.md)         | `StressBotPlugin.xml`      | Stress testing with fake players                                                                                       |
| [CustomMonster](/docs/data/plugins/custommonster.md)             | `CustomMonster.xml`        | Per-monster stat multipliers and kill rewards                                                                          |
| [CustomMonsterVisual](/docs/data/plugins/custommonstervisual.md) | `CustomMonsterVisual.xml`  | Client-side monster visual overrides                                                                                   |
| [Bosses](/docs/data/plugins/bosses.md)                           | `Bosses.xml`               | Bosses that scale with players, track contribution, give personal rewards by rank and show a boss HP bar (paid plugin) |
| [Bestiary](/docs/data/plugins/bestiary.md)                       | `../Bestiary/Bestiary.xml` | Kill counts per monster family unlock permanent bonuses against that family; map mastery gives +EXP (paid plugin)      |
| [RespawnRate](/docs/data/plugins/respawnrate.md)                 | `RespawnRate.xml`          | Monster respawn speed: global %, per-map % and faster respawn on crowded maps                                          |
| [CustomMove](/docs/data/plugins/custommove.md)                   | `CustomMove.xml`           | Custom slash-command teleports                                                                                         |
| [Downgrade](/docs/data/plugins/downgrade.md)                     | `Downgrade.xml`            | Disable classes, NPCs and systems to emulate an earlier season                                                         |

### Social (`Data/Plugins/Social/`)

| Plugin                                           | File              | Purpose                                                                     |
| ------------------------------------------------ | ----------------- | --------------------------------------------------------------------------- |
| [PostCommand](/docs/data/plugins/postcommand.md) | `PostCommand.xml` | Global chat /post command                                                   |
| [Rank Badges](/docs/data/plugins/badges.md)      | `Badges.xml`      | Emblems beside player names and name colours, earned by rules (paid plugin) |

### Quests (`Data/Plugins/Quests/`)

| Plugin                                              | File                    | Purpose                                           |
| --------------------------------------------------- | ----------------------- | ------------------------------------------------- |
| [Custom Quests](/docs/data/plugins/customquests.md) | `Quests/NNN - Name.xml` | Server-defined quests with objectives and rewards |

### Lucky Spin (`Data/Plugins/LuckySpin/`)

| Plugin                                        | File                              | Purpose                                                          |
| --------------------------------------------- | --------------------------------- | ---------------------------------------------------------------- |
| [Lucky Spin](/docs/data/plugins/luckyspin.md) | `Config.xml`, `000.xml`-`031.xml` | Prize wheels with charges, recharge schedules and per-slot rates |

### Bridge (`Data/Plugins/Bridge/`)

| Plugin                                 | File         | Purpose                                                                                     |
| -------------------------------------- | ------------ | ------------------------------------------------------------------------------------------- |
| [Bridge](/docs/data/plugins/bridge.md) | `Config.xml` | Exports gameplay events to [BridgeServer](/docs/bridgeserver/bridgeserver.md) (paid add-on) |

## Plugin Architecture

Every plugin loads from one XML file under `Data/Plugins/<Category>/`. The root element is the plugin name; child structure varies per plugin (some use `<Settings>/<Requirements>/<Rewards>`, others use flat attribute lists, and some use per-entry nodes like `<Item>` or `<Skill>`). Refer to each plugin's own page for the exact schema.

## Common Attributes

### Enable / Enabled Attribute

Most plugin root elements have an enable switch on the root node. Attribute name and value format vary:

```xml
<ResetSystem Enabled="true">
<JewelsBank Enable="1">
<StressBotPlugin Enabled="false">
```

Setting the flag to `false` / `0` disables the plugin. When disabled, plugins skip their XML load path and register no handlers.

{% hint style="info" %}
Check each plugin's doc for the exact attribute name - `Enable` vs `Enabled` is not uniform across plugins.
{% endhint %}

### Index References

Plugins use index numbers to link related configurations:

```xml
<Settings>
    <Setting Index="0" ... />  <!-- Referenced by SettingsIndex -->
</Settings>
<Requirements>
    <Requirement SettingsIndex="0" ... />  <!-- Uses Setting Index 0 -->
</Requirements>
```

## Configuration Reload

Some plugins support live configuration reload without server restart. Commands vary per plugin; `/reload plugins` covers several of them (including SkillTweaks). Check individual plugin documentation for reload support and exact command.

{% hint style="warning" %}
Always verify dependencies are configured before enabling dependent plugins. Related shared configs live in the [GameServer Common.dat](/docs/gameserver/common-dat.md) and [Event.dat](/docs/gameserver/event-dat.md) files.
{% endhint %}

### Dungeons (`Data/Plugins/Dungeons/`)

| Plugin                                                 | File                      | Purpose                                                                     |
| ------------------------------------------------------ | ------------------------- | --------------------------------------------------------------------------- |
| [Dungeons (Instances)](/docs/data/plugins/dungeons.md) | `Dungeons/NNN - Name.xml` | Tiered, timed, per-player instanced dungeons on existing maps (paid plugin) |

### Achievements (`Data/Plugins/Achievements/`)

| Plugin                                             | File                                             | Purpose                                                                                                                 |
| -------------------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| [Achievements](/docs/data/plugins/achievements.md) | `Achievements/NN - Category.xml`, `Settings.xml` | Categorized, tiered achievements with claimable rewards and points; card-grid window from the Window Menu (paid plugin) |