Thanks to Zap for Collaborations on Samantha.py codes, Love you Homie ❤️
and Special Thanks to 🐧 rsetiawan7 for Collaborations on Samantha.py as Docker Guru.
This project is open to anyone who wants to contribute, large or small! Whether you noticed a typo or want to add a whole new feature, go for it!
Large additions should be discussed in issues or on Discord first. If you're new to Python, ask me on discord for where to start and you can use Samantha as a starting point for a contribution.
To run the app, you need:
- A Discord Bot, with
server member intent
andpresence intent
.. obviously.. click here - A Discord server to test - you can't use the Wholesome Series Videos Discord Server to do tests
- Python version 3.8.6
- A MongoDB Server for levelling and warning system (Pick one)
- A Good Code IDE, obviously.. I recommend you Visual Studio Code
If you don't own/admin a Discord server, creating one is simple, you can do it from the same menu you join discord servers from.
Thanks to 🐧 rsetiawan7, Samantha Supports running on Docker. but.. the Active Docker Images has been used for Production Purposes as a Private Repository.
You "could" technically run it on Docker, I have provide you the essence of it (Dockerfile and github actions settings).
I assume you already know how to do it, Please Refer to Docker
folder to Getting Started. Thanks. 😉
-
first, you need to install the Python and MongoDB (Optional) you can see the docs for python and mongodb
-
after that, you can install the required files, with pip (python package manager thingy)
pip install -r "requirements.txt"
-
next stop, copy your bot token in the end of
main.py
.
-
if you want the levelling systems.
-
after that, you need to make a database on mongodb, refer to this guide. the database name should be
discord
and the collation name islevelling
-
and then, you can add the mongodb links on
cogs/levelsys.py
-
-
if you don't want the levelling systems.
- If you're didn't want levelling system, just delete this file
cogs/levelsys.py
- If you're didn't want levelling system, just delete this file
So, basically.. Warning systems are connected with cogs/mute.py
and cogs/kick.py
. so in order to use those two commands, you need to use warning systems, otherwise.. it will erroring all over the place.
-
To use the Warning systems (assuming you already create a database named
discord
), just create another collation, the name ismuted
,kicks
, andwarning
-
and then, you can add the mongodb links on
cogs/warnsys.py
,cogs/mute.py
, andcogs/kick.py
-
if you don't use the levelling systems.
-
you need to make a database on mongodb, refer to this guide. the database name should be
discord
and the collation name ismuted
,kicks
, andwarning
-
and then, you can add the mongodb links on
cogs/warnsys.py
,cogs/mute.py
, andcogs/kick.py
-
-
Whenever you're ready, You can start the bot with this commands.
py main.py
= for windowspython3 main.py
= for linux
and, Voila! You've setup the bot!
Contributions of any kind welcome!