Welcomer

Give your new members a warm welcome!

Some of the features of this module require a Premium Subscription to function. You can however use the module with a free subscription.

The Welcomer module will allow you to send custom welcome banners, messages, reactions, and add roles to users when they join the server. This module will also allow you to send a message when a user is kicked or banned, all in one.

Common Issues

Experiencing issues with the module? Check out the common issues below. If your issue is not listed in this page, make sure your module is updated to the latest version. If you are still experiencing issues with the module, join our support server to ask for further help.

Message not sending

If your welcome message is not being sent, try the following steps:

  1. Check the Discord server permissions of your bot: make sure your bot has the "Send messages" and "View Channel" permissions and that there are no overwrites for the selected channel, or just give your bot the "Administrator" permissions.

  2. Check if your bot intents (message intent) are enabled on the Discord Developer Portal. Ensure the message intent is also enabled in the settings page. See Privileged Intent Options for more info.

  3. If you're still experiencing issues, join our support server to ask for further help.

Welcome card not working

If the welcome card isn't working/sending you can try:

  1. Check if the image URL is a valid file type (PNG, JPG, JPEG). A valid image url should end with .png, .jpg or .jpeg.

  2. Don't use Discord attachment links: after some time, they expire and cannot be used outside of Discord (including BotGhost).

  3. If you're still experiencing issues, join our support server for further assistance.


Settings

Welcome Card

Customize the card to your liking. You can configure many different aspects of the card as below.

Features in this section are limited to Premium users.

[👑] Welcome Card

TypeDetails

Disabled

If the welcome cards are disabled then no cards will be sent when a user joins the server.

Send to a channel

This selection type will send the welcome card to a specified channel when someone joins.

Message the user

This dropdown type will send a direct message to the user.

Send to a channel and message the user

If this option is selected it will send the message to both the channel and the user's direct messages.

[👑] Channel

Select a channel from your server to send the welcome card to.

[👑] Background

Choose a custom background from your card. You have 3 options for this. Depending on the option chosen it will change the background color.

If "Plain Color" is chosen, you will simply choose from the default color panel.

[👑] Background - Color

This allows you to select the background color that will be used for the card.

Example Card

[👑] Title Color

This section represents the color for the title of the welcome card.

[👑] Description Color

This section represents the color for the description of the welcome card.

[👑] Avatar Border Color

This section represents the color for the avatar border of the welcome card.

This section is how you can edit the banner title for the welcome card. Variables can be used.

This field is how you can edit the banner's description. Variables can be used as well.

[👑] Channel Reactions

Choose up to 5 reactions that can be added to the welcome card message.

[👑] DM Reactions

Choose up to 5 reactions that can be added to the welcome card Direct message.

Message on Join

When enabled, this action allows for a message to be sent to a specific channel.

Channel

Select the channel from this dropdown for the message to be sent to.

Welcome Message

This field is where you input the welcome message for when the user joins. You are able to pick from either plain text or embed response types. You are also able to use the {card} variable inside the image url section of the embed response type to show your welcome card in the same message. Some variables can also be used, such as {user}.

Reactions

Choose up to 5 reactions that can be added to the message.

Direct message on Join

When enabled, this action allows for a message to be sent as a direct message to the user who joined.

Welcome Direct Message

This field is where you input the welcome message for when the user joins. You are able to pick from either plain text or embed response types. You are also able to use the {card} variable inside the image url section of the embed response type to show your welcome card in the same message. Some variables can also be used, such as {user}.

Reactions

Choose up to 5 emoji that can be added to the direct message.

Add Role on Join

When this switch is enabled, it acts as an auto-role feature for the server, adding any roles from the server to the user who joined.

Roles to add on join

This section is where you can add any roles you wish from any server the bot is in. The roles will be added to the user from the respective server they joined.

Wait for rules acceptance

Enabling this switch will add the roles only after the user has accepted the server rules from the membership screening page. The server must have this setup for this to function correctly.

Message on Leave

Define whether you wish to enable or disable the message that gets sent when a user leaves the server.

Channel

Select the channel from the dropdown that the message will get sent to upon a user leaving.

Leave message

This field is where you will input the message that gets sent when the user leaves. Variables can be used. You can also choose from either a plain text or embed response type.

Reactions

Choose up to 5 reactions to be added to the message.

Message on Kick

Define whether you wish to enable or disable the message that gets sent when a user is kicked from the server.

Channel

Select the channel from the dropdown that the message will get sent to upon a user that gets kicked.

Kick message

This field is where you will input the message that gets sent when the user is kicked. Variables can be used. You can also choose from either a plain text or embed response type.

Reactions

Choose up to 5 reactions to be added to the message.

Message on Ban

Define whether you wish to enable or disable the message that gets sent when a user is banned from the server.

Channel

Select the channel from the dropdown that the message will get sent to upon a user that gets banned.

Ban message

This field is where you will input the message that gets sent when the user is banned. Variables can be used. You can also choose from either a plain text or embed response type.

Reactions

Choose up to 5 reactions to be added to the message.


Events

In this area, you can view and modify the events of the Welcomer module. Below you may find some information on each event of the module.

Joins Handler

This event contains the welcoming card, the message on join, and the role addition.

Leaves and Kicks Handler

These events contain the message on leave and the message on kick.

Bans Handler

This event contains the message on ban.


It's advised that you do not edit the commands and events unless you have a good understanding of BotGhost and its Command Builder. If you encounter any issues, you might want to reset the module for it to work again as intended.

Additionally, a copy of the edited commands / events will be created if you update the module.

Last updated