🎁Mob Item Drops

Logs rare item drops when a player directly kills a monster

The MobItemDropScript handles item drop logging when a player directly kills a monster.

Action

mob_item_drop

When It's Used

This script is triggered when:

• A player lands the killing blow on a monster

• The monster drops an item with a drop rate at or below the configured threshold

• Mob item drop logging is enabled in the server configuration

Why Use It

• Track valuable drops from normal gameplay where players are actively hunting

• Monitor rare card drops across the server

• Celebrate player achievements by announcing rare drops to Discord

• Audit drop rates to ensure game balance

Server Configuration

In conf/channels.conf:

// Player item drop logging
ragnasync_mob_item_drop_log_enabled: true
ragnasync_mob_item_drop_log_channel_id: "YOUR_CHANNEL_ID"
ragnasync_mob_item_drop_log_min_rate: 100
ragnasync_mob_item_drop_log_types: "mvp,miniboss,card"

Setting	Description	Default
enabled	Enable/disable this logging type	false
channel_id	Discord channel ID to send messages to	-
min_rate	Minimum drop rate to log (500 = 5%, 100 = 1%)	500
types	Mob types to log: all, mvp, miniboss, card	all

Drop Rate Values:

Value	Rate
10000	100%
1000	10%
500	5%
100	1%
10	0.1%

Message Format

The script sends formatted messages to Discord using monospace code blocks:

With drop rate (≤100%):

💎 Item Drop:     | PlayerName       | Poring           | Apple                | 5.00%   |

Without drop rate (>100%):

💎 Item Drop:     | PlayerName       | Poring           | Apple                |

The columns are: Player, Monster, Item, and Drop Rate (hidden for common drops over 100%).

Each drop type uses a unique emoji:

• 💎 Mob drops (player kills)

• ⚔️ Mercenary drops

• 🐾 Homunculus drops

Data Fields

Field	Type	Description
player_name	string	Name of the player who killed the monster
mob_name	string	Name of the monster that was killed
mob_id	int	Monster ID
item_name	string	Name of the dropped item
item_id	int	Item ID
rate	float	Drop rate (e.g., 500 = 5.00%)
account_id	int	Player's account ID
char_id	int	Player's character ID
channel	string	Discord channel ID

Example Use Cases

Card Drop Alerts Only

Set a very low threshold to only log card drops:

ragnasync_mob_item_drop_log_min_rate: 2  // Only 0.02% or rarer

All Rare Drops

Log anything 10% or rarer:

ragnasync_mob_item_drop_log_min_rate: 1000

Custom Templates

Want to customize how your drop messages look? You can add a [template: ...] field to create your own format instead of the default table layout.

Example:

[template: :gem: {{player_name}} got {{item_name}} from {{mob_name}}! ({{rate}})]

Result: 💎 Marky got Apple from Poring! (0.25%)

See Message Templates for all available placeholders and examples.