# 🧙‍♂️ Scum Mage - Your Discord Dungeons & Dragons Bot 🎲

![rsz_308353954-095ed753-7e22-49fb-aee3-f2f6b518771e](https://github.com/Skumbl/Scum_Mage_Bot/assets/111002282/ee363914-2cee-4710-8a62-74372550f2f4)

Scum Mage is a versatile Discord bot designed specifically for Dungeons & Dragons enthusiasts. With a range of commands tailored to enhance your tabletop RPG experience, Scum Mage simplifies complex tasks, facilitates gameplay mechanics, and provides valuable resources, all within your Discord server.

## ⚔️ Features

- **Dice Rolling**: Execute intricate dice expressions effortlessly using the `/roll` command.
- **Percentile Dice**: Generate random percentage values with the `/percentile` command.
- **Initiative Tracking**: Manage initiative order seamlessly with commands like `/join`, `/npc-join`, and `/custom-join`.
- **Initiative Visualizer**: View and notify those in the initiative order when it's their turn with the `/display` command.
- **Utility Commands**: Clear up clutter in your chat using the `/clear` command or access valuable resources via `/tools`.
## 🚀 Getting Started

To add Scum Mage to your Discord server and start enjoying its features, follow these simple steps:

1. **Invite Scum Mage**: [Click here](https://top.gg/bot/1149502978835877919) to invite Scum Mage to your server.

2. **Usage Documentation**: Refer to the provided user manual or type `/help` within your Discord server to explore available commands and their usage.

3. **You're ready to cast spells and slay dragons!**

## 📚 Dependencies

Scum Mage is built on top of the following libraries and APIs:

- [interactions.py](https://interactions-py.github.io/interactions.py/): Main API for handling Discord interactions. 
- [d20](https://pypi.org/project/d20/): Dice engine serving as the base for dice rolling functionalities
* other dependencies can be found in the requirements.txt file in the git. 
## 🤝 Contributions

Contributions to Scum Mage are welcome! If you encounter any issues, have suggestions for improvements, or want to contribute new features, feel free to open an issue or submit a pull request on [GitHub](https://github.com/Skumbl/Scum_Mage_Bot).

## ☕️ Support

If you find Scum Mage helpful and would like to support its development, consider buying the developer a coffee:

[![Buy Me a Coffee](https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png)](https://www.buymeacoffee.com/scumble)

## 📝 License

This project is licensed under the MIT License

Scum Mage

Scum Mage: Your Grimy Wizard Discord Bot for Complex Dice Rolls & Initiative Tracking in DnD Adventures! 🧙‍♂️🎲

التصويت لـScum Mage

هل ترغب في دعمنا؟