🤖 Discord.js Handler

Production-ready Discord.js v14 bot handler with slash commands, event system, and modular architecture

⚡ Quick Start • 🎯 Commands • ➕ Add Commands • 🤝 Contribute

✨ Features

• 🔮 Latest Discord.js v14.14.1 - Built with the most recent Discord API features
• 🧩 Modular Architecture - Clean separation of commands and events
• ⚡ Slash Commands Ready - Native support for Discord's slash commands
• 🎛️ Prefix Commands - Traditional command support for backward compatibility
• 🛡️ Production-Ready - Robust error handling and logging
• 📦 Lightweight - Minimal dependencies with maximum performance
• 🔥 Hot Reloading - Easy command and event development
• 🧰 Developer-Friendly - Simple API for creating new features

🚀 Tech Stack

• Discord.js - Discord API library
• Node.js - JavaScript runtime
• dotenv - Environment management

⚡ Quick Start

Prerequisites

• Node.js 18.0.0 or higher
• npm 7.0.0 or higher
• A Discord bot token (Get one here)

Installation

# Clone the repository
git clone https://github.com/IN3PIRE/discord-js-handler.git
cd discord-js-handler

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your favorite editor and add your tokens
nano .env

# Deploy slash commands (required)
npm run deploy

# Start the bot
npm start

Environment Variables

Variable	Description	Required
DISCORD_TOKEN	Your bot token from Discord Developer Portal	✅ Yes
CLIENT_ID	Your Discord application ID	✅ Yes
GUILD_ID	Test guild ID (optional, for guild-specific commands)	❌ No

🎯 Commands

Slash Commands

Command	Description
/ping	Check bot latency and API response time
/server	Display detailed server information
/user	Show basic user information
/userinfo	Display comprehensive user statistics
/uptime	Show how long the bot has been running

Prefix Commands

Command	Description
!help	Display available commands and usage
!info	Show bot information and statistics
!time	Display current server time

➕ Adding New Commands

Create Slash Commands

Create a new file in src/slashcommands/:

const { SlashCommandBuilder } = require('discord.js');

module.exports = {
  data: new SlashCommandBuilder()
    .setName('commandname')
    .setDescription('Description of what this command does'),
  
  async execute(interaction) {
    // Your command logic here
    await interaction.reply('Command executed successfully!');
  },
};

Create Prefix Commands

Create a new file in src/prefixcommands/:

module.exports = {
  name: 'commandname',
  description: 'Description of what this command does',
  
  execute(message, args) {
    // Your command logic here
    message.reply('Command executed successfully!');
  },
};

Create Event Handlers

Create a new file in src/events/:

module.exports = {
  name: 'eventName', // Event name from Discord.js
  once: false, // true = execute once, false = execute on every event
  
  execute(...args) {
    // Your event logic here
    console.log('Event triggered:', this.name);
  },
};

🛠️ Development

Available Scripts

# Deploy slash commands globally
npm run deploy

# Start the bot in production
npm start

# Start with auto-restart on file changes (requires nodemon)
npm run dev

# Install dependencies
npm install

Project Structure

discord-js-handler/
├── src/
│   ├── events/           # Event handlers
│   ├── prefixcommands/   # Prefix-based commands
│   ├── slashcommands/    # Slash commands
│   ├── deploy-commands.js # Command deployment script
│   └── index.js          # Main bot file
├── .env.example        # Environment template
├── .gitignore           # Git ignore rules
├── package.json         # Dependencies and scripts
└── README.md            # Documentation

🤝 Contributing

We love your input! We want to make contributing as easy and transparent as possible. Please read our detailed Contributing Guide for the full process.

🌟 Star Requirement

⚠️ IMPORTANT: You must ⭐ star this repository before your PR can be merged

🚀 Quick Contribution Steps

1. ⭐ Star the repo (top-right corner) - Required for PR merge
2. Find an issue: Look for good first issue or help wanted labels
3. Comment: Say "I would like to work on this" on the issue
4. Wait for assignment: Don't start until officially assigned
5. Fork & create branch: git checkout -b feature/amazing-feature
6. Submit PR: Follow our contribution guidelines

🏷️ Issue Labels

• good first issue - Perfect for newcomers
• help wanted - Extra attention needed
• bug - Something isn't working
• enhancement - New feature or improvement
• documentation - Docs need updating

Why the star requirement?

• ✨ Shows support for the project
• 👤 Verifies human contributors
• 🫂 Makes you part of our community

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Support

If you like this project, please give it a ⭐ star!

---

Made with ❤️ by the IN3PIRE Team

View our other projects • Join our Discord