🤖 Discord.js Handler

Production-Ready Discord Bot Framework with Modular Architecture

⚡ Quick Start • 🎯 Commands • 📖 Documentation • 🤝 Contribute

---

📖 Table of Contents

Click to expand

• ✨ Features
• 🚀 Quick Start
• 🎯 Commands
• ➕ Adding Commands
• 🛠️ Development
• 🤝 Contributing
• 🏆 Contributors

---

✨ Features

🔮 Latest Discord.js v14.14.1 Most recent Discord API features	🧩 Modular Architecture Clean separation of concerns	⚡ Slash Commands Native slash command support	🎛️ Prefix Commands Backward compatibility
🛡️ Production-Ready Robust error handling	📦 Lightweight Minimal dependencies	🔥 Hot Reloading Easy development	🧰 Developer-Friendly Simple API

---

🚀 Quick Start

Prerequisites

• ✅ Node.js 18.0.0+
• ✅ npm 7.0.0+
• ✅ Discord Bot Token

Installation

# Clone 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
nano .env # Add your tokens

# Deploy slash commands
npm run deploy

# Start bot
npm start

Environment Variables

Variable	Description	Required
DISCORD_TOKEN	Bot token from Discord Developer Portal	✅
CLIENT_ID	Discord application ID	✅
GUILD_ID	Test guild ID (optional)	❌

---

🎯 Commands

Slash Commands

Command	Description
/ping	Check bot latency
/server	Display server info
/user	Show user info
/userinfo	User statistics
/uptime	Bot uptime

Prefix Commands

Command	Description
!help	Display help
!info	Bot information
!time	Server time

---

➕ Adding New Commands

Slash Command Example

// src/slashcommands/ping.js
const { SlashCommandBuilder } = require('discord.js');

module.exports = {
  data: new SlashCommandBuilder()
    .setName('ping')
    .setDescription('Check bot latency'),
  async execute(interaction) {
    await interaction.reply('🏓 Pong!');
  },
};

Prefix Command Example

// src/prefixcommands/help.js
module.exports = {
  name: 'help',
  description: 'Display commands',
  execute(message, args) {
    message.reply('Commands: !help, !info, !time');
  },
};

Event Handler Example

// src/events/ready.js
module.exports = {
  name: 'ready',
  once: true,
  execute(client) {
    console.log(`✅ Ready as ${client.user.tag}`);
  },
};

---

🛠️ Development

Scripts

npm run deploy   # Deploy slash commands
npm start        # Start production
npm run dev      # Development mode
npm install      # Install deps

Project Structure

discord-js-handler/
├── src/
│   ├── events/           # Event handlers
│   ├── prefixcommands/   # Prefix commands
│   ├── slashcommands/    # Slash commands
│   ├── deploy-commands.js
│   └── index.js
├── .env.example
├── package.json
└── README.md

---

🤝 Contributing

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

Quick Steps

1. ⭐ Star the repository
2. Find an issue with good first issue label
3. Comment "I would like to work on this"
4. Wait for assignment
5. Fork & create branch: git checkout -b feature/your-feature
6. Submit PR

Issue Labels

• good first issue - Perfect for newcomers
• help wanted - Extra attention needed
• bug - Something broken
• enhancement - New feature
• documentation - Update docs

---

🏆 Top Contributors

Rank	Contributor	Commits
🥇	TrivCodez	13+
🥈	Ramanand-Shirbhate	2
🥉	KunalTiwari-git	2
4	dromero14521	1
5	ixhxpns	1

---

📜 License

MIT License - see LICENSE for details.

---

Made with ❤️ by the IN3PIRE Team

View Projects • Join Discord

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