TJ Discord Level-Up Bot

Discord bot for a student-org server, with:

• Major role assignment panel for #📌role-assign
• XP + leveling system with anti-spam cooldown
• Level reward roles
• Rank and leaderboard slash commands

1) Create the Discord App/Bot

1. Go to the Discord Developer Portal
2. Create application -> Bot -> copy bot token
3. Enable these Privileged Gateway Intents:
   • Message Content Intent
   • Server Members Intent
4. OAuth2 -> URL Generator:
   • Scopes: bot, applications.commands
   • Bot permissions:
     • Manage Roles
     • Send Messages
     • Read Message History
     • View Channels
5. Invite the bot to your server.

2) Install + Configure

npm install
cp .env.example .env

Update .env:

DISCORD_TOKEN=...
CLIENT_ID=...
SERVER_ID=YOUR_SERVER_ID

3) Start the bot

npm run start

4) First-time server setup

1. Make sure your server has these roles (exact names):
   • Accounting
   • Finance
   • Leadership & Strategic Innovation
   • Marketing
   • Management
   • Management Information Systems
   • Supply Chain Management
   • Technology & Innovation Management
   • Business Administration / Undecided
2. In Discord, run:
   • /setup-role-assign
3. Optional level reward roles:
   • /set-level-role level:5 role:@YourRole
   • /set-level-role level:10 role:@YourRole
   • /set-level-role level:20 role:@YourRole

Commands

• /setup-role-assign - Posts/refreshes major role panel
• /rank - Shows your current level and XP
• /leaderboard - Shows top 10 members by XP/level
• /set-level-role - Admin command to map a level to a role

Notes

• The bot stores data in data/guild-config.json
• If role assignment fails, ensure bot role is above major roles in server role hierarchy