🤖 ValkyrieCore: Your Gateway to Bot Development! 🚀

A robust foundation for creating powerful Discord bots with modern features and best practices!

---

🌟 Welcome to the ValkyrieCore, a Discord Bot Template!

This project provides a solid foundation for creating a Discord bot using discordx and discord.js v14, designed with scalability and ease of use in mind.

🎮 Features That Power Your Bot

📊 Bot Info Dashboard Detailed startup metrics showing users, guilds, commands, and system specs.	🛡️ Robust Error Handling Error tracking with console output and Components V2 cards in a Discord channel.
📝 Command Logging Track command usage with Components V2 cards sent to your designated channel.	🔄 Hybrid Sharding Efficient sharding system using worker threads for better scalability and performance.
⚡ Performance Optimized Built with efficiency in mind to handle commands quickly and reliably.	❓ Interactive Help Menu Category dropdown when multiple command groups exist, with slash command links.

🚀 Requirements

• Bun
• Discord Account

🛠️ Setup Guide

1. Download the latest release (click on 'Source code (zip)').

2. Extract and move the files to your desired location.

3. Install Bun:

   • Mac/Linux:

     curl -fsSL https://bun.sh/install | bash

   • Windows:

     powershell -c "irm bun.sh/install.ps1 | iex"

4. Navigate to your project folder:

   cd /path/to/your/extracted/source

5. Rename .env.example to .env and fill in your bot's details:

   • Bot Token Guide

6. Install dependencies:

   bun install

7. Start the bot:

   bun start

   For local watch without sharding:

   bun run dev

📸 Screenshots

Bot Info

🤝 Contributing

We welcome contributions to improve this template! If you'd like to contribute:

1. Fork the repository
2. Create a new branch for your feature or bug fix:

   git checkout -b feature/your-feature-name

3. Make your changes and commit them with a clear, descriptive message:

   git commit -m 'Add feature: brief description of your changes'

4. Push your changes to your fork:

   git push origin feature/your-feature-name

5. Open a Pull Request against the main repository's main branch

Please run bun run lint before opening a Pull Request. We appreciate detailed descriptions to help with the review process.

📜 License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details. (It's mostly "Share the love, and keep it open!")

🙏 Acknowledgements

• discord.js for the powerful Discord API wrapper
• discordx for the decorator-based command framework
• Bun for the blazing fast JavaScript runtime
• All our contributors and supporters who help improve this template

📬 Support & Community

Got questions or need help? Join our Discord server for support and to connect with other bot developers!

---

💻 Crafted with ❤️ by Valhalla-Development

🐛 Spotted an issue? | 💡 Got an idea? | 🤔 Need help?

🔝 Back to Top