Management

Configure server management features including logs, welcome messages, and automation

Introduction

The Management configuration file (management.json) controls various server management features including logging, welcome/goodbye messages, auto-roles, auto-responses, suggestions, and other automation features.

Logs

The logging system records various server events to designated channels.

types

Type: Object

Enable or disable specific log types. Each log type can be toggled individually.

logs: {
    types: {
        channel_create: true,
        channel_delete: true,
        channel_update: true,
        emoji_create: true,
        emoji_delete: true,
        emoji_update: true,
        member_join: true,
        member_leave: true,
        member_update: true,
        member_roles_update: true,
        invite_create: true,
        invite_delete: true,
        invite_update: true,
        message_delete: true,
        message_update: true,
        role_create: true,
        role_delete: true,
        role_update: true,
        sticker_create: true,
        sticker_delete: true,
        sticker_update: true,
        thread_create: true,
        thread_delete: true,
        voice_state: true,
        command_execute: true,
        direct_message: true,
    },
}

Set any log type to false to disable that specific log.

exclude_message_logs

Type: Array of Strings

List of channel IDs to exclude from message edit/delete logging.

exclude_message_logs: [
    "123456789012345678",
    "234567890123456789",
]

Messages edited or deleted in these channels won't create log entries.

exclude_channel_edit_logs

Type: Array of Strings

List of channel IDs to exclude from channel edit logging.

exclude_channel_edit_logs: []

Welcome Message

Configure automated welcome messages for new members.

enabled

Type: Boolean

Enables or disables the welcome message feature.

welcome_message: {
    enabled: true,
}

display_type

Type: String

Type of welcome message to send.

Available Options:

"IMAGE" - Welcome card/image
"EMBED" - Text embed (configured in lang.json)
"BOTH" - Both image and embed

display_type: "IMAGE"

image

Type: Object

Configuration for the welcome image. Only applies when display_type is "IMAGE" or "BOTH".

image: {
    title: "Welcome %user%",
    description_text: "Member #%member_size%",
}

Available Placeholders:

%user% - Username
%member_size% - Total member count
%user_created% - Account creation date
%user_joined% - Server join date
%invited_by% - Who invited them
%invites_by_invitor% - Inviter's invite count

Custom Images: To change the welcome background image, upload new images to ./logs/images/welcome/ directory.

mention_user

Type: Boolean

Whether to mention the user in their welcome message.

mention_user: true

emoji

Type: Object

Auto-react to welcome messages with an emoji.

emoji: {
    enabled: false,
    emoji: "👋",
}

enabled - Whether emoji reactions are active emoji - Emoji to react with (Unicode or custom emoji ID)

send_after_verification

Type: Boolean

Whether to wait until the user verifies before sending the welcome message.

send_after_verification: false

When true: Welcome message only sent after verification When false: Welcome message sent immediately on join

dm_message

Type: Boolean

Whether to send an additional welcome message to the user's DMs.

dm_message: false

DM message content is configured in the lang.json file.

Goodbye Message

Configure automated goodbye messages when members leave.

enabled

Type: Boolean

Enables or disables the goodbye message feature.

goodbye_message: {
    enabled: false,
}

display_type

Type: String

Type of goodbye message to send.

Available Options:

"IMAGE" - Goodbye card/image
"EMBED" - Text embed (configured in lang.json)
"BOTH" - Both image and embed

display_type: "IMAGE"

image

Type: Object

Configuration for the goodbye image.

image: {
    title: "Goodbye %user%",
    description_text: "Member #%member_size%",
}

Available Placeholders:

%user% - Username
%member_size% - Total member count

Custom Images: To change the goodbye background image, upload new images to ./logs/images/goodbye/ directory.

emoji

Type: Object

Auto-react to goodbye messages with an emoji.

emoji: {
    enabled: false,
    emoji: "👋",
}

Auto Role

Automatically assign roles to new members when they join.

enabled

Type: Boolean

Enables or disables auto-role assignment.

auto_role: {
    enabled: false,
}

roles_to_add

Type: Array of Strings

List of role IDs to automatically assign to new members.

roles_to_add: ['804354038987882588', '123456789012345678']

Common use cases:

Member role (if verification is disabled)
Unverified role (if verification is enabled)
Notification roles

Auto Thread Reaction

Automatically react to new threads in forum channels.

enabled

Type: Boolean

Enables or disables auto thread reactions.

auto_thread_reaction: {
    enabled: false,
}

parent_id

Type: String

Forum channel ID where this feature applies.

parent_id: "1155463362377961615"

emojis

Type: Array of Strings

List of emojis to react with on new threads.

emojis: ["✅", "❌"]

Supports both Unicode emojis and custom emoji IDs.

Auto Message Response

Automatically respond to messages containing specific keywords/patterns.

enabled

Type: Boolean

Enables or disables auto-response system.

auto_message_response: {
    enabled: false,
}

keywords

Type: Array of Objects

List of keyword patterns and their responses.

keywords: [
    {
        regex: "ip|server address",
        predefined_message_id: "server_ip",
        auto_delete_after_seconds: 20,
        permission_role: "everyone",
        ticket_only: false,
    },
]

regex - Regular expression pattern to match (e.g., "store", "ip|server") predefined_message_id - ID of message created with /sendmsg command auto_delete_after_seconds - Auto-delete response after X seconds, or false to keep permanently permission_role - Permission level required (from permission config) ticket_only - Whether response only triggers in ticket channels

Creating Responses:

Use /sendmsg to create a custom message
Save it with a predefined message ID
Reference that ID in predefined_message_id

Auto Crosspost

Automatically publish messages in announcement channels.

enabled

Type: Boolean

Enables or disables auto-crossposting.

auto_crosspost: {
    enabled: false,
}

channel_ids

Type: Array of Strings

List of announcement channel IDs to auto-publish.

channel_ids: ["123456789012345678"]

When empty: All announcement channels are affected When populated: Only specified channels are affected

Scheduled Messages

Send predefined messages at scheduled times.

enabled

Type: Boolean

Enables or disables scheduled messages.

scheduled_messages: {
    enabled: false,
}

messages

Type: Array of Objects

List of scheduled messages to send.

messages: [
    {
        channel_id: "1266773588619427840",
        predefined_message_id: "daily_announcement",
        weekly: {
            monday: ["12:00", "18:00"],
            tuesday: ["14:22"],
            wednesday: ["14:00"],
            thursday: ["10:00"],
            friday: ["12:00"],
            saturday: ["20:00"],
            sunday: [],
        },
    },
]

channel_id - Channel where message is sent predefined_message_id - ID of message created with /sendmsg weekly - Schedule with 24-hour time format in UTC timezone

Important: Use "0:00" for midnight, not "24:00". Times are in your set timezone.

Suggestions

Configure the suggestion system behavior.

disable_suggestion_threads

Type: Boolean

Whether to disable automatic thread creation for suggestions.

suggestions: {
    disable_suggestion_threads: false,
}

seperate_suggestion_channels

Type: Boolean

Move approved/denied suggestions to separate channels.

seperate_suggestion_channels: false

When true: Approved/denied suggestions move to dedicated channels When false: All suggestions stay in the pending channel

allow_message_suggestions

Type: Boolean

Allow users to submit suggestions by simply typing in the suggestion channel.

allow_message_suggestions: false

When true: Messages in suggestion channel create suggestions When false: Must use /suggest command

category_based_colors

Type: Boolean

Use different colors for suggestion embeds based on category.

category_based_colors: false

Requires suggestion_categories to be configured.

suggestion_categories

Type: Array of Objects

Define suggestion categories with custom colors.

suggestion_categories: [
    {
        name: "General",
        color: "#3498DB",
    },
    {
        name: "Discord",
        color: "#E74C3C",
    },
]

name - Category name color - Hex color code (leave empty for default)

Role Saving

Save and restore user roles when they leave and rejoin.

enabled

Type: Boolean

Enables or disables role saving.

role_saving: {
    enabled: false,
}

bypass_auto_roles

Type: Boolean

Whether to skip auto-roles if saved roles exist.

bypass_auto_roles: false

When true: Auto-roles won't apply if user has saved roles When false: Both saved roles and auto-roles are applied

blacklisted_roles

Type: Array of Strings

Roles that should not be saved or restored.

blacklisted_roles: ["123456789012345678"]

Common use cases:

Temporary roles (muted, etc.)
Event-specific roles
Roles that should be earned again

Custom Boost Message

enable_custom_boost_message

Type: Boolean

Send a custom message when someone boosts the server.

enable_custom_boost_message: true

Message content is configured in the lang.json file.

Support Voice Call Notification

Ping staff when someone joins a support voice channel.

support_voice_channels

Type: Array of Strings

List of support voice channel IDs.

support_voice_call_notification: {
    support_voice_channels: ["123456789012345678"],
}

When empty: Feature is disabled

mention_roles

Type: Array of Strings

Roles to mention when someone joins a support voice channel.

mention_roles: ["804354037662220289"]

Complete Configuration Example

Here's a production-ready management configuration:

{
    config: {
        logs: {
            types: {
                channel_create: true,
                channel_delete: true,
                member_join: true,
                member_leave: true,
                message_delete: true,
                message_update: true,
                // Enable only the logs you need
            },
            exclude_message_logs: [],
            exclude_channel_edit_logs: [],
        },

        welcome_message: {
            enabled: true,
            display_type: "IMAGE",
            image: {
                title: "Welcome %user%",
                description_text: "Member #%member_size%",
            },
            mention_user: true,
            emoji: {
                enabled: true,
                emoji: "👋",
            },
            send_after_verification: false,
            dm_message: false,
        },

        goodbye_message: {
            enabled: true,
            display_type: "IMAGE",
            image: {
                title: "Goodbye %user%",
                description_text: "We'll miss you!",
            },
            emoji: {
                enabled: false,
                emoji: "👋",
            },
        },

        auto_role: {
            enabled: true,
            roles_to_add: ['804354038987882588'],
        },

        auto_thread_reaction: {
            enabled: false,
            parent_id: "",
            emojis: [],
        },

        auto_message_response: {
            enabled: false,
            keywords: [],
        },

        auto_crosspost: {
            enabled: false,
            channel_ids: [],
        },

        scheduled_messages: {
            enabled: false,
            messages: [],
        },

        suggestions: {
            disable_suggestion_threads: false,
            seperate_suggestion_channels: false,
            allow_message_suggestions: false,
            category_based_colors: false,
            suggestion_categories: [],
        },

        role_saving: {
            enabled: false,
            bypass_auto_roles: false,
            blacklisted_roles: [],
        },

        enable_custom_boost_message: true,

        support_voice_call_notification: {
            support_voice_channels: [],
            mention_roles: [],
        }
    }
}

Last updated 8 months ago