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

Mob Deaths

Logs monster kills (MVPs, mini-bosses) to Discord

Announce MVP and boss kills to your Discord server. Great for tracking who's hunting bosses and celebrating big kills with your community.

Action

mob_death

When It's Used

This script triggers automatically when:

  • A player kills a monster matching the configured type

  • Mob death logging is enabled in channels.conf

Why Use It

  • Track MVP hunters - See who's farming bosses

  • Community engagement - Celebrate big kills together

  • Server activity - Know when MVPs are being hunted

  • Detect issues - Spot suspicious kill patterns

Server Configuration

In conf/channels.conf, add these settings in the discord: { } block:

Setting
Type
Default
Description

ragnasync_mob_death_log_enabled

bool

false

Enable mob death logging

ragnasync_mob_death_log_channel_id

string

""

Discord channel for announcements

ragnasync_mob_death_log_types

string

"all"

Which monsters to log (comma-separated)

Monster Types

This filter takes a comma-separated, case-insensitive list of mob classes.

Token
What Gets Logged

all

Every mob class (default)

normal

Regular mobs — very spammy, logs every kill across your whole server

miniboss

Mini-boss monsters

mvp

MVPs

Multiple types: "mvp,miniboss", "mvp,miniboss,normal", etc.

Message Format

When a player kills an MVP, Discord shows a formatted log:

Format: Account ID | Char ID | Character Name | Monster Name | Time

Data Fields

Field
Type
Description

player_name

string

Character who killed the monster

mob_name

string

Monster name

mob_id

int

Monster ID

account_id

int

Player's account ID

char_id

int

Player's character ID

channel

string

Discord channel ID

Examples

MVP-Only Announcements

Log only MVP kills to a public channel:

Include Mini-Bosses

For more comprehensive boss tracking:

Staff Monitoring Channel

Send to a private channel for staff review:

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

{{src_template}}

🏆 [Marky] killed Poring!

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