Welcome System
AtomicBot includes a fully customizable Welcome System that greets new members,
assigns roles automatically, and posts your custom welcome message in the channel of your choice.
All configuration is handled through the /welcome command.
Who Can Use This?
Only users with your Bot Admin Role (stored in admin_role_id inside
guild_servers) can run the /welcome command.
This is different from Discord server admins — it is controlled in your bot settings.
Choose which channel new-member welcome messages appear in.
/welcome setchannel <channel>
- You must select a text channel.
- Used automatically whenever someone joins.
- Stored in
welcome_channel_id.
You can fully customize your welcome message and use placeholders that are replaced dynamically.
/welcome setmessage "Hey {user}, welcome to {server}! You are member #{member_count}."
Available Placeholders
{user}– the new member’s @mention{server}– your Discord server name{member_count}– total member count{owner}– the server owner's user ID
The message is stored in welcome_message.
Assign a role to every new member who joins the server.
/welcome setrole <role>
- Useful for starter roles, muted roles, member roles, etc.
- Stored in
welcome_role_id.
/welcome toggle true /welcome toggle false
- true → welcome messages enabled
- false → welcome system disabled
Stored in welcome_enabled.
The /welcome preview command renders your current message using live placeholder data:
/welcome preview
The bot generates an embed showing:
- The final rendered welcome text
- The channel it will be sent to
- The joiner’s avatar
- The server name as the embed title
Troubleshooting
- No welcome message? → Make sure welcome is enabled.
- Bot isn’t posting? → Channel might be missing permissions.
- Role not assigned? → Bot needs "Manage Roles" above that role.
- Preview fails? → No welcome message or channel not set.
- Missing placeholders? → Re-check your message formatting.