Features
- Auto-generated welcome images with member avatar, server branding, and modern design
- Animated GIFs when your server has an animated icon
- Custom backgrounds — server banner, discovery splash, or your own uploaded image
- Three display modes — image + text, image only, or text only
- 24 color presets for username, text, accent line, and border
- Up to 4 link buttons for rules, roles, guides, or social links
- Ping & delete — temporary ping message that auto-deletes
- Instant preview — test your welcome message before going live
Getting Started
- Invite the Bot — Needs Send Messages, Embed Links, and Attach Files permissions.
- Run
/setup— Opens the interactive configuration panel. - Set Channel — Choose where welcome messages are sent. The bot auto-enables when you set a channel.
- Customize — Edit your welcome message, set a background, and choose colors.
- Test — Use the test feature to preview exactly how your welcome message will look.
- Fine-tune — Adjust colors, borders, animation, and ping settings.
The /setup Command
Everything is configured through /setup (Administrator only). The panel has 4 sections:
Basic Setup
- Set Channel — Choose the welcome channel. Validates bot permissions automatically.
- Enable/Disable — Toggle the welcome system on or off.
- Test Welcome — Send a test welcome message to the configured channel.
- View Config — See your current configuration summary.
Customization
- Edit Message — Set title (100 chars), message (1000 chars), and display mode.
- Background — Upload a custom background image, or submit empty to reset.
- View Placeholders — See all available placeholder variables.
- Reset All — Reset config and delete custom background (with confirmation).
Extra
- Add Link — Add a clickable button (name: 12 chars, URL: must be https). Max 4 buttons.
- Remove Link — Remove an existing link button.
- View Links — List all configured link buttons.
- Accent Color — Choose from 24 preset colors or none.
Advanced Settings
- Font Color — Set username, text, and accent line colors (24 presets each).
- Border Settings — Choose border color and width (1–50px).
- Toggle Animation — Enable/disable animated server icon in welcome images.
- Ping & Delete — Configure a temporary ping message with custom text, channel, and auto-delete duration (1–300 seconds).
Customization
Display Modes
| Mode | Description |
|---|---|
| Both | Welcome image and text message in a container with link buttons (default) |
| Image Only | Just the generated image, falls back to text if image fails |
| Text Only | Text message with link buttons, no image |
Welcome Image
The bot generates a welcome image featuring:
- Circular member avatar
- “WELCOME” text with accent line
- Member display name and server name with icon
- Customizable border and accent decorations
Background: Uses your custom upload, server banner, or discovery splash. If none are set, a default background is used.
Animated images: When your server has an animated icon and animation is enabled, the welcome image is animated.
Colors
24 preset colors available for all color settings:
blurple, white, black, gray, silver, red, maroon, orange, coral, gold, yellow, lime, green, olive, teal, cyan, turquoise, blue, navy, indigo, purple, magenta, pink, brown
Background Upload
- Supported formats: PNG, JPG, JPEG, WebP, GIF, BMP
- Max file size: 10MB
- Resized to 1920x1080 if larger
Placeholders
Use these in your welcome title and message:
| Placeholder | Description |
|---|---|
{display_name} | User’s display name |
{user_name} | User’s username |
{user_mention} | @mention the user |
{user} | @mention the user (alias) |
{server_name} | Server name |
{server} | Server name (alias) |
{member_count} | Total member count |
{join_date} | Join date (Month DD, YYYY) |
Example: Welcome to {server_name}, {user_mention}! You're member #{member_count}.
Ping & Delete
Send a temporary ping message when a member joins that auto-deletes after a set time.
- Channel: Can be different from the welcome channel
- Message: Must contain
{user}for the mention - Duration: 1–300 seconds
- Runs independently from the welcome message
Limits
| Setting | Limit |
|---|---|
| Link Buttons | 4 per server |
| Button Name | 12 characters |
| Welcome Title | 100 characters |
| Welcome Message | 1000 characters |
| Border Width | 1–50 pixels |
| Ping Delete Duration | 1–300 seconds |
| Background Max Size | 10MB |