A TypeScript Discord bot that automates introductions for new members. Users complete introduction and "working on" forms to earn the "Dodo Builder" role.
- Auto-sends introduction prompts to new members
- Dual forms: introduction + work project sharing
- Awards "Dodo Builder" role upon completion
- Creates public threads for work discussions
- Moderator tools:
/ping-introand/clear-dmcommands
- Create bot in Discord Developer Portal
- Enable intents: Server Members, Message Content, Direct Messages
- Ensure bot role is higher than "Dodo Builder" role
git clone <repository-url>
cd dodo-discord-bot
npm install
cp .env.example .env
# Edit .env with your Discord credentialsnpm run dev # Development
npm start # Production| Variable | Description | Required |
|---|---|---|
DISCORD_TOKEN |
Bot token | ✅ |
CLIENT_ID |
Bot client ID | ✅ |
INTRO_CHANNEL_ID |
#introductions channel | ✅ |
WORKING_ON_CHANNEL_ID |
#working-on channel | ✅ |
MOD_ROLE_ID |
Moderator role ID | ✅ |
DODO_BUILDER_ROLE_ID |
Builder role ID | ✅ |
GUILD_ID |
Guild ID (optional) | ❌ |
/ping-intro [user]- Trigger intro flow (mods only)/clear-dm- Clear bot DMs (only for the user who runs it)/move-message [message id]- Move a message to the #get-help channel (mods only)!move-message- Move a message to the #get-help channel (mods only, you will need to reply to the message you want to move)/bot-answer [message id]- Answer a question in any text channel (mods only)!bot-answer- Answer a question in any text channel (mods only, you will need to reply to the message you want to answer)
docker build -t dodo-discord-bot .
docker run --env-file .env dodo-discord-botnpm run build # Compile TypeScript
npm run dev # Development with auto-reload- Bot not responding: Check env vars and permissions
- DMs not sent: Users need DMs enabled from server members
- Commands not working: Verify bot permissions and role hierarchy