📄Channels Config

The channels.conf file configures the in-game channel system and RagnaSync integration settings. This file is located in your rAthena server's conf/channels.conf.

RagnaSync Discord Integration

The discord block contains all RagnaSync-specific settings for connecting your Ragnarok server to Discord.

Connection Settings

discord: {
    // Discord Server Settings
    ragnasync_discord_id: ""        // Your Discord server ID
    ragnasync_discord_guid: ""      // Discord server GUID from RagnaSync

    // Ragnarok Server Client Settings
    ragnasync_client_guid: ""       // Your RagnaSync client GUID

    // RagnaSync Service Host
    ragnasync_host_name: "ragnasync.com"  // RagnaSync service hostname

    // Connection Retry Settings
    ragnasync_retry_first: 300      // First retry delay in seconds (default: 5 minutes)
    ragnasync_retry_delay: 1800     // Delay between retries (default: 30 minutes)
    ragnasync_retry_max: 3          // Max retry attempts, 0 = infinite
    ragnasync_enabled: true         // Auto-connect on server boot
}

Setting	Default	Description
ragnasync_discord_id	""	The Discord server ID where messages will be sent
ragnasync_discord_guid	""	GUID assigned to your Discord server by RagnaSync
ragnasync_client_guid	""	Your Ragnarok client's unique identifier in RagnaSync
ragnasync_host_name	"ragnasync.com"	Hostname of the RagnaSync service
ragnasync_retry_first	300	Seconds before first reconnection attempt (5 min)
ragnasync_retry_delay	1800	Seconds between subsequent retries (30 min)
ragnasync_retry_max	3	Maximum connection attempts (0 = unlimited)
ragnasync_enabled	true	Whether to auto-connect when server starts

@Command Logging

Log GM commands to a Discord channel for moderation and audit purposes.

// @Command logging to Discord
ragnasync_at_command_log_enabled: false
ragnasync_at_command_log_group_min: 99
ragnasync_at_command_log_channel_id: "1234567890"

Setting	Default	Description
ragnasync_at_command_log_enabled	false	Enable @command logging
ragnasync_at_command_log_group_min	99	Minimum group ID to log (99 = GM only)
ragnasync_at_command_log_channel_id	""	Discord channel ID for command logs

Mob Item Drop Logging

Log rare item drops from monsters to Discord.

// Mob item drop logging
ragnasync_mob_item_drop_log_enabled: false
ragnasync_mob_item_drop_log_min_rate: 500
ragnasync_mob_item_drop_log_channel_id: "1234567890"

Setting	Default	Description
ragnasync_mob_item_drop_log_enabled	false	Enable drop logging
ragnasync_mob_item_drop_log_min_rate	500	Minimum rate to log (500 = 5%)
ragnasync_mob_item_drop_log_channel_id	""	Discord channel for drop logs

Drop Rate Values:

• 10000 = 100%

• 1000 = 10%

• 500 = 5%

• 100 = 1%

• 10 = 0.1%

Homunculus Item Drop Logging

Log item drops from Homunculus kills.

ragnasync_hom_item_drop_log_enabled: false
ragnasync_hom_item_drop_log_min_rate: 500
ragnasync_hom_item_drop_log_channel_id: "1234567890"

Mercenary Item Drop Logging

Log item drops from Mercenary kills.

ragnasync_merc_item_drop_log_enabled: false
ragnasync_merc_item_drop_log_min_rate: 500
ragnasync_merc_item_drop_log_channel_id: "1234567890"

Mob Death Logging

Log when specific mob types are killed (MVP, Mini-boss, or normal mobs).

// Mob death logging
ragnasync_mob_death_log_enabled: false
ragnasync_mob_death_log_type: "mvp"
ragnasync_mob_death_log_channel_id: "1234567890"

Setting	Default	Description
ragnasync_mob_death_log_enabled	false	Enable death logging
ragnasync_mob_death_log_type	"mvp"	Type: "mvp", "miniboss", or "normal"
ragnasync_mob_death_log_channel_id	""	Discord channel for death logs

@request Command Logging

Log player support requests to Discord for staff monitoring.

ragnasync_at_request_command_enabled: false
ragnasync_at_request_command_channel_id: "1234567890"

Channel Discord Linking

Any in-game channel can be linked to Discord by adding the discord_channel_id property to its configuration.

Public Channel Example

{
    name: "#global"
    alias: "[Global]"
    color: "White"
    type: "CHAN_TYPE_PUBLIC"
    delay: 1000
    autojoin: true
    leave: false
    chat: true
    discord_channel_id: "1234567890"  // Link to Discord channel
},

Private Channel Default

Private channels can also have a default Discord link:

private_channel: {
    allow: true
    color: "Default"
    delay: 1000
    max_member: 1000
    discord_channel_id: 1234567890   // Default Discord channel for private channels
}

Channel Types

Type	Description
CHAN_TYPE_PUBLIC	Open channels anyone can join
CHAN_TYPE_ALLY	Guild alliance channels
CHAN_TYPE_MAP	Map-specific local channels

Available Colors

colors: {
    Default: "0xffffff"
    Red: "0xff0000"
    Blue: "0x83cfe9"
    Orange: "0xe57c00"
    Cyan: "0x00b89d"
    Yellow: "0xffff90"
    Green: "0x28bf00"
    White: "0xFFFFFF"
    Purple: "0xD67FFF"
    LightGreen: "0xB6FF00"
    Normal: "0x00ff00"
}

Getting Your Discord IDs

See Installation for instructions on obtaining your Discord Server ID and Channel IDs.

The ragnasync_discord_guid and ragnasync_client_guid are provided by RagnaSync during installation.