> 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

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            |
| [SkillSpeedScale](/docs/data/plugins/skillspeedscale.md) | `SkillSpeedScale.xml` | Per-skill attack speed scaling                   |
| [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         |

### 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          |

### 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       |

### 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          |
| [CustomMove](/docs/data/plugins/custommove.md)                   | `CustomMove.xml`          | Custom slash-command teleports                |

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

| Plugin                                           | File              | Purpose                   |
| ------------------------------------------------ | ----------------- | ------------------------- |
| [PostCommand](/docs/data/plugins/postcommand.md) | `PostCommand.xml` | Global chat /post command |

## 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 SkillSpeedScale). 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 %}