> For the complete documentation index, see [llms.txt](https://docs.ragnasync.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ragnasync.com/event-logs/drops/merc-item-drop-log.md).

# Mercenary Drops

Logs rare item drops when a player's mercenary kills a monster

Logs item drops when a **player's mercenary** lands the killing blow on a monster.

**Action:** `merc_item_drop`

## Why Use It

* **Track mercenary-assisted farming** separately from direct player kills
* **Monitor mercenary usage patterns** across player types
* **Distinguish mercenary farming** from homunculus and player kills

## Configuration

```
ragnasync_merc_item_drop_log_enabled: true
ragnasync_merc_item_drop_log_channel_id: "YOUR_CHANNEL_ID"
ragnasync_merc_item_drop_log_min_rate: 500
ragnasync_merc_item_drop_log_types: "all"
```

| Setting      | Description                                                                                                                        | Default |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `enabled`    | Enable/disable logging                                                                                                             | `false` |
| `channel_id` | Discord channel for drop logs                                                                                                      | -       |
| `min_rate`   | Minimum drop rate to log (500 = 5%)                                                                                                | `500`   |
| `types`      | Item categories — `all`, `healing`, `usable`, `etc`, `armor`, `weapon`, `card`, `petegg`, `petarmor`, `ammo`, `shadowgear`, `cash` | `all`   |

Tokens are comma-separated and case-insensitive. See [Item Drop Types](/getting-started/channels-conf.md#item-drop-types) for the full list with descriptions.

{% hint style="warning" %}
This filter is **item categories**, not mob classes. `"mvp,miniboss"` won't work — those aren't item types and every token will be rejected (watch for `[Warning]: Unknown item type '...'` at map-server startup).
{% endhint %}

For data fields and more details, see [Mob Item Drops](/event-logs/drops/mob-item-drop-log.md).

## Custom Messages

Want to customize how these messages look? Head to the **Message Routes** page on your dashboard, set the format to **Custom Message**, and compose your own template using `{{placeholder}}` syntax.

**Example template:**

```
:crossed_swords: {{player_name}}'s mercenary got {{item_name}} from {{mob_name}}! ({{rate}})
```

**Available placeholders for this event:**

| Placeholder        | Example                                        |
| ------------------ | ---------------------------------------------- |
| `{{player_name}}`  | Marky                                          |
| `{{mob_name}}`     | Poring                                         |
| `{{mob_id}}`       | 1002                                           |
| `{{item_name}}`    | Apple                                          |
| `{{item_id}}`      | 512                                            |
| `{{rate}}`         | 50.00%                                         |
| `{{rate_raw}}`     | 5000                                           |
| `{{src_template}}` | :gem: \[Card Drop] Marky obtained Poring Card! |

{% hint style="info" %}
`{{src_template}}` contains the pre-formatted message from your game server's `[template: ...]` field. If your server doesn't send one, it resolves to empty. See [Message Templates](/ragnascript/message-templates.md) for details.
{% endhint %}

See [Message Routing](/ragnascript/message-routing.md) for more about formats, conditions, and multi-channel routing.