Leurs - Discord Balance Bot

A feature-rich Discord bot designed to enhance your server experience with economy, moderation, music integration, and utility commands.

🌟 Features

💰 Economy System

• Virtual currency management with wallet and bank accounts
• Betting and gambling mechanics
• Job market with multiple career paths
• Daily rewards and income opportunities

🛡️ Advanced Moderation

• Comprehensive user management (ban, kick, mute, jail)
• Warning system with history tracking
• Smart message deletion with cached search
• Role management and automatic role restoration
• Nickname management with history

🎵 Last.fm Integration

• Real-time music tracking and display
• Server-wide now playing overview
• User music statistics and profiles
• Scrobble counts and listening history

📊 Leveling System

• XP-based progression system
• Server leaderboards
• Visual progress bars
• Level-based rewards

⚙️ Administrative Tools

• Automated role saving and restoration
• Message caching and advanced search
• Custom embed creation
• Auto-reactions and reaction roles
• Bulk message management

🎯 Utility Commands

• Birthday tracking and reminders
• Timezone management
• Custom quote generation
• Random lyric display
• Information and help commands

🚀 Quick Start

1. Clone the repository

   git clone https://github.com/IM23d/discord-balance-bot.git
   cd discord-balance-bot

2. Install dependencies

   pip install -r requirements.txt

3. Set up environment variables

   • Create a .env file
   • Add your Discord bot token and other required API keys

4. Run the bot

   python main.py

📚 Documentation

For detailed command documentation, setup guides, and configuration options, visit our comprehensive documentation website:

📖 docs.leurs.ch

The documentation includes:

• Complete command reference
• Setup and configuration guides
• API integration tutorials
• Troubleshooting guides
• Developer resources

🎮 Command Preview

Category	Examples
Economy	-balance, -beg, -gamble, -deposit
Jobs	-jobs, -work, -buyjob, -myjobs
Moderation	-warn, -ban, -mute, -jail
Music	-np, -lastfm, -servernowplaying
Levels	-rank, -leveltop, -setlevel
Utility	-info, -birthday, -timezone

🤝 Contributing

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

👥 Team

• @bettercallmilan - Lead Developer
• @FlorianRuby - Developer
• @seakyy - Developer
• @lhilfiker - Contributor

📄 License

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

🔗 Links

• Documentation: docs.leurs.ch
• Issues: GitHub Issues
• Pull Requests: GitHub PRs

⭐ Support

If you find this project helpful, please consider giving it a star! It helps us reach more users and contributors.

---

Made with ❤️ by the Leurs Team