Skip to content
/ LunaBot Public

Open-Source General purpose discord bot featuring fun commands and moderation utilities!

License

Notifications You must be signed in to change notification settings

Spelis/LunaBot

Repository files navigation

💫 Luna - The ✨celestial✨ Discord Bot ⭐

Luna is a Discord bot meant to bring fun, utility and more to your server.

What's better? Luna is Completely FREE and OPEN SOURCE!

Note: Luna is currently in development and there may be bugs or missing features. Feel free to report any bugs or suggestions in the issues tab.

Here at Luna, we believe in the power of the community. We want to make Luna the best it can be for you and your server. If you want to contribute to Luna, you can do so by forking this repository and making a PR.

Ready to get started? Click here to invite LunaBot to your server!


GitHub Issues GitHub Pull Requests

📋 Table of Contents
  1. ❔ About
  2. 🚀 Installation
  3. 🏃‍➡️ Running Luna
  4. 🗺️ Roadmap
  5. 🤝 Contributing
  6. ✉️ Support
  7. 📄 License
  8. 💖 Acknowledgments

✔️ Features

Have fun with Luna's many diverse features!

  • Playing Music with Luna's music bot!
  • Moderating your server with Awesome moderation commands!
  • Fun with games, random images, and more!
  • Utilities like information about users, servers, and more!

🚀 Installation

For pre-hosted instances, you can invite Luna to your server using this link here

✅ Requirements and dependencies

Python 3.13 or higher is recommended to run Luna. You can download it here. Older versions may work, but you may also encounter issues.

The rest of the requirements you can install by running the following commands:

python -m venv .venv and activate it

pip install -r requirements.txt

🏃‍➡️ Running Luna

NOTE: Make sure you are in the root of the repository, that you have your bot token in the .env file and that you have activated your virtual environment.

Now, all that's left is to run the bot.

python main.py

Or you could use the Docker container to run Luna!

docker build -t lunabot . docker run lunabot

🗺️ Roadmap

no roadmap yet... maybe contribute?

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated!

How to contribute

  1. Fork the project.
    git clone https://github.com/Spelis/LunaBot.git
  2. Create your feature branch:
    git checkout -b feature/amazing-feature
  3. Commit your changes:
    git commit -m "Add some amazing feature"
  4. Push to the branch:
    git push origin feature/amazing-feature
  5. Open a pull request.

For more detailed guidelines, check out CONTRIBUTING.md.

✉️ Support

If you encounter any issues or have questions, feel free to:

  • Open an issue in the Issues tab.
  • Reach out via email at spelis@duck.com.
  • Contact me or hyscript on discord: @spelis, @hyscript7

We’re here to help!

📄 License

This project is licensed under the MIT License - feel free to use, modify, and distribute this project in accordance with the license terms.

💖 Acknowledgments

I would like to express my deepest gratitude to the following individuals and organizations:

  • HyScript7 - for the use of his amazing programming skills and him being a good friend. and for the readme
  • Rapptz' Discord.py - for making an amazing library!.
  • You! - for your support and contributions!

About

Open-Source General purpose discord bot featuring fun commands and moderation utilities!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published