For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 for the full list with descriptions.

For data fields and more details, see Mob Item Drops.

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:

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

💎 [Card Drop] Marky obtained Poring Card!

{{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 for details.

See Message Routing for more about formats, conditions, and multi-channel routing.

Last updated