👋 Welcomer Bot 👋

Welcomer is a self-hosted Discord bot that sends a fully customised welcome card with a generated banner image whenever someone joins your server. No dashboard, no commands needed to configure it - everything is set in one config file.

✨ What's New in v2.0.0

Fully customisable via config.
Animated GIF support - GIF backgrounds render as a fully animated output image, not a static frame.
Auto Role - Automatically assign one or more roles when a member joins. Just add the role IDs to the config.
Invite Tracker - See who invited each new member, the invite code they used, and how many times that code has been used - all shown directly in the welcome card.
Test command - /test_welcomer lets admins preview the card without waiting for a real join.

🖼️ Features

Flexible backgrounds - gradient colours, remote image URL, or a local file (JPG, PNG, WebP, GIF)
Custom fonts - drop any .ttf file into the assets folder and set it in the config
Placeholders - {user}, {username}, {server}, {count} in both card text and banner text
Fully toggleable - every element of the card can be individually shown or hidden

⚙️ Commands

/test_welcomer Preview the welcome card using your own account

📋 Requirements

Node.js 24+
Discord bot token
Server Members Intent enabled in the Discord Developer Portal

🚀 Setup

Download and extract the files
Run npm install
Fill in your .env file

Set your welcome channel ID and customise the card in src/config.js
Run npm start
Need help? Join the support server: Click Here

🔄 Updating

Stop the bot
Backup your src/config.js - it contains your channel and card configuration and will be overwritten
Delete the src/ folder
Input the new src/ folder and overwrite package.json, CHANGELOG and README.md files
Restore your src/config.js values from the backup
Delete the node_modules/ folder and package-lock.json
Run

Start the bot (npm start)

Your .env and assets/ folder are not touched - your token, background images, and custom fonts are preserved.