53 lines
1.5 KiB
Markdown
53 lines
1.5 KiB
Markdown
# muzovkantV2
|
|
### shitty (half-)vibecoded discord bot
|
|
## overall
|
|
you can use this as a base for your discord bot by writing your own [cogs](/cogs/), installing cogs from repositories, or as is.
|
|
|
|
## installation
|
|
1. clone the repo
|
|
```bash
|
|
git clone https://github.com/rejnronuzz/muzovkantv2.git
|
|
cd muzovkantv2
|
|
```
|
|
2. install the requirements. you might need to enter a venv on some systems.
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
3. insert your discord bot token into the .env file.
|
|
*it should look something like this:*
|
|
```
|
|
DISCORD_TOKEN=abc123abc
|
|
```
|
|
you can then edit the configs of main.py and the configs of each cog to your liking.
|
|
|
|
## usage
|
|
the bot is running when the main.py script is running.
|
|
|
|
### systemd service
|
|
you can configure a systemd service for this bot.
|
|
[systemd_service.sh](systemd_service.sh) is ONLY for systemd systems.
|
|
|
|
(*tested on Ubuntu 24.04*)
|
|
|
|
simply do:
|
|
```
|
|
chmod +x systemd_service.sh
|
|
./systemd_service.sh
|
|
```
|
|
the systemd service will now start and auto start on reboot.
|
|
|
|
### updating with systemd service
|
|
keep in mind that after updating with the systemd service enabled, you will need to restart the service.
|
|
so the update workflow looks something like this:
|
|
```
|
|
git pull origin main
|
|
sudo systemctl restart muzovkantv2
|
|
```
|
|
|
|
## contacting
|
|
if you have any feedback, contact me on git issues or/and discord. if you want to add any functionality to this bot, make a PR.
|
|
when submitting a bug report, make sure to attach the bot.log files. they generate automatically in root directory.
|
|
|
|
|
|
|