⚔️ Ragnarok: Multi-Purpose Discord Bot 🚀

AI, economy, moderation, fun, and utility features in one modern Discord bot.

---

🌟 Welcome to Ragnarok!

Ragnarok is a multi-purpose Discord bot built with discordx and discord.js v14. It includes AI chat with persistent history, economy systems, moderation tools, fun commands, and server utilities.

🎮 Features That Power Ragnarok

🤖 OpenRouter AI Chat Use slash commands and mention/reply flow with persistent history and per-guild controls.	⚙️ AI Control Panel Configure AI globally in /config and per-channel via /aichannels.
💰 Economy + Progression Server economy systems, XP/levels, and interactive component-driven command flows.	🗄️ MongoDB Persistence Mongoose-backed persistence for bot data, configs, AI usage, and history.
🎨 Components V2 UI Modern Discord Components V2 containers for cleaner, richer in-app interfaces.	🛡️ Moderation + Utility Practical moderation, server configuration, and utility tools for day-to-day management.

🚀 Requirements

• Bun - Fast JavaScript runtime
• Discord Bot Application with bot token
• Optional external service keys (OpenRouter, Valhalla)

🛠️ Setup Guide

1. Clone the repository:

   git clone https://github.com/Valhalla-Development/Ragnarok.git

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 configure your settings:

   • Required: Bot token and MongoDB URI
   • Bot Token Guide
   • Channel ID Guide

6. Install dependencies:

   bun install

7. Start the bot:

   bun run start

🤝 Contributing

We welcome contributions to improve Ragnarok! 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 ensure your code follows the existing patterns and include clear descriptions in your Pull Request. Focus on performance and user experience improvements.

📜 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
• MongoDB for persistence
• OpenRouter for AI model routing

📬 Support & Community

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

---

💻 Crafted with ❤️ by Valhalla-Development Built on the ValkyrieCore Discord bot template.

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

🔝 Back to Top