Discord Community bot
Hello, I'm Miunie the comMIUNIEty bot. 👋
I'm a community bot for Discord written in C# using the Discord .NET library.
The goal of this project is to create a solid general-purpose bot that can be easily extended and used in new and interesting ways.
Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
Prerequisites
- The recommended IDE is Visual Studio 2017 Community.
- Using Visual Studio Installer make sure you installed
.NET Core cross-platform development
.- Visual Studio Installer should be automatically installed with VS 2017 Community.
Installing
This is a step by step guide to get Miunie ready on your machine and ready for development.
Getting the source
- Fork the repository.
- Navigate to your fork.
- Clone your fork to your local machine.
Setting up the environment
-
The root directory of the project contains
CommunityBot.sln
, this is a Visual Studio solution file and you can open it with Visual Studio (see prerequisites). -
After the solution is loaded, right-click the CommunityBot project through the Solution Explorer in Visual Studio (It has a little C# in a green box icon by default) and go to Properties. Under Debug, you will see an
Application arguments:
field. You can paste your bot token there. Application arguments are already added to.gitignore
so you don't have to worry about accidentally making it public. -
Once you save your changes from the previous step, you can compile and run the application.
- In Visual Studio, a common way of doing this is with the
F5
orCtrl + F5
shortcut.
- In Visual Studio, a common way of doing this is with the
-
Try it out
- The bot you have assigned with your token should now be online. Try to mention him and say hello!
@MyBot Hello
If you get a response back, everything is ready for development.
Running the tests
To run Unit Tests in Visual Studio, you use the Ctrl + R, A
shortcut or go to Test > Run > All Tests
.
Deployment
To publish a version of Miunie and run it on a machine, you can use this tutorial that walks you through the process.
Built With
- .NET Core 2.0 - Platform used
- Discord .NET - Discord API wrapper library
- ❤️ Love and Care 💙
Contributing
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
Versioning
There is currently no versioning system used. Feel free to create a new Issue suggesting one.
Authors
- Petr Sedláček - Initial work - PetrSpelos
See also the list of contributors who participated in this project.
License
This project is licensed under the MIT License - see the LICENSE.md file for details
Acknowledgments
- This project is possible thanks to the amazing Discord .NET library.
- Thank you to all people who contributed, especially those coming from my Discord tutorial.
- If you're still not sure about the way to contribute, there's a simple tutorial video I made.