Server Companion Documentation

Learn how to configure and customize Server Companion for your Discord server

Anti Invite Scam

The Anti Invite Scam plugin automatically detects and removes Discord invite links posted in your server that lead to potentially malicious servers.

Dashboard Configuration Options

Enabled by default

The Anti Invite Scam protection on by default to protect your community.

Reporting scams to us with the /feedback command

These are the scams that our communities have reported to use and we activley defend against.

URL Block Lists

The URL Block Lists feature protects your community from malicious links including redirect links, malware, and inappropriate content. Our database contains over 800,000 confirmed malicious URLs.

Dashboard Configuration Options

Enabled by default

Toggle URL blocking protection.

Block Categories

URLs that are blocked:

  • Phishing
  • Malware
  • Adult Content
  • Scam Sites
  • URL Shorteners
  • Crypto Scams

Auto Responder

The Auto Responder system allows you to set up automatic responses to common questions, providing 24/7 support for your community members.

Dashboard Configuration Options

Enabled by default

Toggle the Auto Responder system on or off for your server.

Response Triggers

Create keyword or phrase triggers that will activate automatic responses.

Response Content

Customize the content of responses, including text, images, and embeds.

Welcome Messages

Customize welcome messages for new members joining your server, including safety information about common Discord scams.

Dashboard Configuration Options

Enable/Disable

Toggle welcome messages on or off for your server.

Welcome Message

Dynamic custom welcome messages.

  • Title
  • two fields for content 4000 charectors each.
  • Your servers branding

Direct Message

The wecome message is a Direct Message, we also send a informational DM to give information on recent scams that are been deployed on the discord platform.

Spam Detection

The Spam Detection system identifies and moderates repeated messages across channels to maintain a clean communication environment.

Dashboard Configuration Options

Enable/Disable

Toggle spam detection on or off for your server.

Detection Sensitivity

Adjust how sensitive the spam detection should be:

  • Number of duplicate messages
  • The duration of seconds to detect in
  • Action to take (warn, kick, ban

Logging

Logs are logged in the automod channel.

Feedback System

The Feedback System allows you to provide feedback, report bugs, or request features directly through Discord.

Feedback

You can create feedback in the following categories:

  • General Feedback
  • Feature Request
  • Bug Report
  • Custom categories

Account Age Verification

The Account Age Verification feature prevents newly created accounts from joining your server, reducing the risk of repeat offenders and spam accounts.

Dashboard Configuration Options

Enable/Disable

Toggle account age verification on or off for your server.

Minimum Account Age

Set the minimum required age for Discord accounts joining your server:

  • 1 hour
  • 1 day
  • 3 days
  • 1 week
  • 2 weeks
  • 1 month
  • Custom value

Action on Rejection

Choose what happens when an account is too new:

  • Block join with message

Logging

Logs are logged in the automod channel.

Anti Raid Protection

The Anti Raid Protection system monitors join rates and automatically takes action when a potential raid is detected.

Dashboard Configuration Options

Enable/Disable

Toggle anti raid protection on or off for your server.

Raid Detection Settings

Configure the conditions that trigger raid protection:

  • Number of joins (default: 10)
  • Time window in seconds (default: 10)

Lockdown Duration

Set how long the server should be locked for new joins after a raid is detected:

  • 15 minutes
  • 30 minutes
  • 1 hour (default)
  • 3 hours
  • 6 hours

Auto Recovery

After the lockdown period has elapsed joining will be re-enabled.

Logging

Logs are logged in the automod channel.

Anti Server Update

The Anti Server Update feature provides control over which roles can modify server settings such as server name, description, icon, and verification level.

Feature Overview

By default, only server owners can make changes to core server settings. This feature allows server owners to grant specific roles permission to make these changes while maintaining security.

Discord Commands

/anti_serverupdate authorize <role>

Authorize a specific role to make changes to server settings. This includes:

  • Server name
  • Server description
  • Server icon
  • Verification level

Can only be used by the server owner

/anti_serverupdate list

Displays a list of all roles that are currently authorized to make changes to server settings.

By default, this will only show the server owner as authorized.

Can be used by anyone with Manage Server permission

/anti_serverupdate unauthorize <role>

Removes authorization from a previously authorized role. After using this command, members with this role will no longer be able to modify server settings.

Can only be used by the server owner

Security Benefits

This feature helps protect your server from unauthorized changes that could negatively impact your community:

  • Prevents compromised moderator accounts from changing critical server settings
  • Creates an audit trail of who makes server changes
  • Allows flexibility in role permissions while maintaining security

Dashboard Configuration Options

Authorized Roles

View and manage which roles can modify server settings through an easy-to-use interface.

Logging

All server setting changes are logged to the audit log channel, including who made the change and what was modified.

Birthday Messages

The Birthday Messages feature automatically sends customized messages to users on their birthday, creating a more personal and friendly server environment.

Feature Overview

This feature uses the birthdate information from Discord user profiles to detect when it's a member's birthday and send them a personalized message. This helps build community and makes members feel valued.

Discord Commands

/birthdaymessage

Create or customize the birthday message that will be sent to your server members on their birthday.

You can customize the following elements:

  • Message Title - The title displayed at the top of the birthday message
  • Message Banner - Custom text banner to make the message more visually appealing
  • Birthday Message - The personalized text content of the message

Can be used by server administrators and moderators

Requirements

For this feature to work, users need to:

  • Have their birthday set in their Discord profile
  • Have server privacy settings configured to allow the bot to access this information

Dashboard Configuration Options

Enable/Disable

Toggle birthday messages on or off for your server.

Message Channel

Select which channel birthday messages should be sent to. You can choose between:

  • A specific public channel
  • Direct message to the user
  • Both options

Message Customization

Customize your birthday messages with:

  • Message Title - Create an eye-catching title
  • Message Banner - Upload a custom image banner
  • Birthday Message - Write a personalized message

Social Media Notifications

The Social Media Notifications feature allows you to receive automatic updates when new content is posted on various platforms, keeping your community informed about their favorite creators.

Supported Platforms

YouTube

Get notified when new videos are uploaded to specific YouTube channels.

  • Required identifier: Channel ID (starts with UC)
  • Example: UC1234567890abcdef

Need help finding a channel ID? Use our YouTube Channel ID Finder tool to easily extract IDs from any YouTube channel URL.

Twitch

Receive notifications when followed Twitch streamers go live.

  • Required identifier: Channel name
  • Example: ninja or captainshack

Reddit

Stay updated with new posts from your favorite subreddits.

  • Required identifier: Subreddit name (without r/)
  • Example: programming

RSS

Subscribe to any RSS feed to receive notifications about new articles or posts.

  • Required identifier: Full RSS feed URL
  • Example: https://example.com/feed.xml

Vimeo

Get notified when new videos are uploaded to Vimeo channels.

  • Required identifier: Channel ID or username
  • Example: user123456 or channelname

Discord Commands

/social add <platform> <identifier>

Add a subscription for notifications from the specified platform and channel/user.

  • Platform: Choose from youtube, twitch, reddit, rss, or vimeo
  • Identifier: The platform-specific identifier (see above)

Requires Manage Server permission

/social list

Display a list of all social media subscriptions for your server, including their notification status.

Anyone can use this command

/social delete <platform> <identifier>

Remove a subscription from your server.

Requires Manage Server permission

/social set_channel <platform> <channel>

Set which Discord text channel should receive notifications for a specific platform.

You can set different notification channels for each platform type.

Requires Manage Channels permission

Setup Tips

  • After adding a subscription, you must set a notification channel using the /social set_channel command
  • The bot must have "Send Messages" and "Embed Links" permissions in the notification channel
  • For YouTube channels, you must use the channel ID (starting with UC), not the channel name
  • RSS feeds are validated before being accepted to ensure they're properly formatted

YouTube Channel ID Finder Tool

Finding the correct YouTube channel ID can sometimes be challenging. To make this process easier, we've created a dedicated tool that helps you extract the channel ID from any YouTube URL.

Access YouTube Channel ID Finder

Telegram Integration

The Telegram Integration feature allows you to connect your Telegram groups with your Discord server, enabling seamless message forwarding between platforms.

How It Works

Messages posted in configured Telegram groups are automatically forwarded to designated channels in your Discord server, helping you keep all communications in sync and ensuring that members on either platform don't miss important messages.

Discord Commands

/telegram list

Displays all currently tracked Telegram chat IDs for your server.

Requires administrator permission

/telegram add <group_name>

Add a Telegram group to track by its exact group name.

The bot must be a member of the Telegram group for this to work.

Requires administrator permission

/telegram set_channel <channel>

Set which Discord text channel should receive forwarded messages from Telegram.

Requires administrator permission

/telegram delete <chat_id>

Remove a tracked Telegram chat ID from your server's configuration.

Requires administrator permission

/telegram get_chat_id_info

Get information on how to retrieve your Telegram chat ID.

This provides instructions for adding our bot to your Telegram group and using the /get_chat_id command there.

Requires administrator permission

Setup Instructions

  1. Add the Server Companion bot to your Telegram group
  2. Type the command /get_chat_id in your Telegram group
  3. Copy the chat ID that the bot provides
  4. In Discord, use /telegram add <group_name> with your group's exact name OR use the chat ID you received
  5. Set a notification channel with /telegram set_channel #your-channel

Notes & Limitations

  • Only text messages are currently forwarded from Telegram to Discord
  • The bot must have "Send Messages" and "Embed Links" permissions in the designated Discord channel
  • For best results, the Telegram bot should have admin privileges in the Telegram group
  • There might be a short delay (usually a few seconds) between when a message is sent on Telegram and when it appears in Discord

Advanced Moderation

The Advanced Moderation system provides server staff with a comprehensive suite of tools to maintain order in your Discord community with full accountability and logging.

Available Commands

/ban <user> <reason>

Permanently ban a user from the server with a specified reason. The user will receive a DM notification about the ban and the reason, if possible.

Requires ban permissions or an authorized role

/unban <user_id> <reason>

Unban a previously banned user with a specified reason. The action is logged to the audit channel.

Requires ban permissions or an authorized role

/tempban <user> <duration> <reason>

Temporarily ban a user for a specified duration (minutes). The user will be automatically unbanned after the duration expires.

  • Duration can be set up to 4 weeks (40320 minutes)
  • The system automatically tracks and processes unbans when the time expires

Requires ban permissions or an authorized role

/kick <user> <reason>

Remove a user from the server with the ability to rejoin later. The user receives a DM notification with the kick reason.

Requires kick permissions or an authorized role

/mute <user> <duration> <reason>

Temporarily mute (timeout) a user for a specified duration in minutes. The user can remain in the server but cannot send messages or join voice channels.

Requires moderate members permission or an authorized role

/unmute <user> <reason>

Remove a timeout from a user before its scheduled expiration.

Requires moderate members permission or an authorized role

/server_stats

Display detailed statistics about your server including:

  • General server information (owner, creation date, boost level)
  • Channel statistics (text, voice, categories)
  • Member counts (total, online, humans, bots)
  • Role information

Requires authorized role configuration

Permissions System

The Advanced Moderation system uses a role-based permissions system that allows server administrators to control which roles can use specific moderation commands.

/sync_moderation

Initialize or update the moderation settings for your server. This command should be run when you first add the bot or if you need to reset moderation configurations.

Requires administrator permission

Logging and Accountability

All moderation actions are automatically logged to the "automod" channel (if it exists) with detailed information:

  • Which moderator performed the action
  • Which user was affected
  • What action was taken
  • The reason provided
  • Whether a DM notification was successfully sent

For temporary actions like tempban and mute, the log also includes:

  • Duration of the penalty
  • Scheduled removal time shown in user's local timezone