🤖 Bot Discord.js v14

This repository contains a bot template for discord.js@v14. It use external handler (developped by cleboost djs-core ans some submodule). The bot is designed with a handler to easily create commands, buttons, selections and other fun interactions.

---

🛠️ Prerequisites

Before using this bot, make sure you have:

• Node.js (min v18): To develop and run the script.
• Javascript IDE: A development environment to edit the code like Visual Studio Code (free), WebStorm (paid).

🚀 Installation

1. Clone this repository to your local system.
2. Open the project in your development environment.
3. Go to src/ folder, it contains the main bot script.
4. Edit .env with your bot token.
5. Customize config.ts with your settings (optional).
6. Install NPM package with pnpm i command (you can use npm i or yarn but pnpm is recommended).
7. Start bot with pnpm run start (or npm run start or yarn run start).

🛠️ Build

1. Build the project with pnpm run build (you can customize build options in build script in package.json for obfuscation, etc.)
2. You can now run the bot with node dist/index.js
3. If you use prisma, be sure to run npx prisma generate before building and copy the prisma & node_modules folders to the dist folder
4. You can also get all content of the dist folder and put it in a zip file to deploy it on a server

---

⚙️ Included Sqlite native

This project includes Sqlite natively and exemples of usage in the commands. You can use it to store data, like user's money, server's settings, etc.

📜 Default commands available:

• 📚 /help Dynamically generates help message with existing commands (in redev)
• ⛔ /stop Stops the bot (admin command)
• 🧪 /test Empty command for testing purposes (devOnly command)
• 🏓 /ping Displays bot latency (in ms)
• 🔍 /autocomplete Demo command showcasing autocomplete functionality
• Example commands for various options

---

💡 Particularities :

• Admin category commands are not shown in /help and require being registered (Discord ID) in the config.json owner array 👑
• Commands marked as devOnly: true require being a developer to execute and should be registered in the config.json dev array 💻
• Configurations are cached in the client, accessible by client.config
• DB is cached in the client, accessible by client.db
• Cooldown is in seconds but resets on each bot restart; it's disabled for devOnly commands ⏱️
• You can launch the bot with npm run dev, in which case the bot restarts with each save you make, otherwise use node index.js or npm run start
• Buttons and commands can have categories: create a folder and place the file inside (see examples)
• Debug mode enabled by default, configuration in .env

🛠️ SubCommand :

This projet allow you to create sub command like /command subcommand. To do it, you can check exemple in src/interactions/commands/utils/handler.ts and src/interactions/commands/utils/handler/button.ts As you can see, you need to create the regitred command where you define name of your command, description, default permission, sub command. In subfolder with same name of your command, you can create subcommand. Subcommand files need to have same name of the subcommand.

---

🔍 AutoComplete :

This project includes an autocomplete demo command that shows how to implement interactive command options. Check the example in src/interactions/commands/utils/autocomplete.ts to see how to:

• Add string options with .setAutocomplete(true)
• Handle autocomplete interactions with .autoComplete() method
• Provide dynamic suggestions to users as they type

---

🤝 Contribution

Contributions are welcome! If you want to improve this bot or add new features, feel free to submit a pull request.

⚖️ License

This project is licensed under MIT - see the LICENSE link for more details. 📜