hullcss-discord-bot/README.md

57 lines
1.8 KiB
Markdown
Raw Normal View History

2022-07-01 18:38:19 +01:00
<div align="center">
2022-07-01 18:34:27 +01:00
2022-07-01 18:38:19 +01:00
![icon_2](https://user-images.githubusercontent.com/32241933/176943810-d3016868-d91b-49cc-9461-ae01b7ffa44d.png)
2022-07-01 18:33:56 +01:00
2022-07-01 18:46:51 +01:00
## HullCSS Discord Bot
2022-07-01 18:33:56 +01:00
This bot is a multipurpose discord bot for The Hull Computer Science Society Discord server.
<img src="https://img.shields.io/badge/discord.js-v13-7354F6?logo=discord&logoColor=white&style=flat-square" />
2022-07-01 18:38:19 +01:00
</div align="center">
2022-05-11 12:44:44 +01:00
2022-07-01 18:46:51 +01:00
---
2022-05-11 12:44:44 +01:00
This bot features multiple command types from:
* Admin
* Embeds
* Fun
* General
2022-06-27 11:45:43 +01:00
* Slash Commands
Alongside commands, this bot also features:
2022-07-01 18:33:56 +01:00
* Auto threading in `#coursework-help` channel to keep it clean
2022-06-27 11:45:43 +01:00
* Auto embedding of events for information and archiving
2022-07-01 18:33:56 +01:00
* Select menu role system within `#roles`
* Rule agreement button embed with `#code-of-conduct`
2022-06-27 11:45:43 +01:00
2022-06-12 10:57:45 +01:00
---
## Installation
2022-06-12 11:09:58 +01:00
**This is a private bot used for a specific purpose within a specific discord server however if you do want to run the bot for testing purposes or deploy it to a new location. Follow the instructions below.**
2022-06-12 10:57:45 +01:00
2022-06-12 11:09:58 +01:00
### 🐋 Docker
2022-06-12 10:54:11 +01:00
Due to the [Publish.yml](.github/workflows/publish.yml) workflow, the newest build will automatically be pushed to dockerhub.
2022-06-12 11:09:58 +01:00
2022-06-12 10:54:11 +01:00
```docker
docker run -d \
--name=hullcss \
-p 6001:6001 \
-e DISCORD_TOKEN='INSERT DISCORD TOKEN' \
-e PREFIX='!' \
--restart unless-stopped \
kieranr27/hullcss:latest
```
2022-06-12 10:57:45 +01:00
Using a tool like [Ouroboros](https://github.com/pyouroboros/ouroboros), you can automatically update containers without the need for restarts.
2022-06-12 11:09:58 +01:00
### 👷 Manual
- Clone the repo
- Remove the `.template` from `.env.template`
- Add Discord Bot Token where `DISCORD_TOKEN` is within the `.env` file
2022-06-12 11:09:58 +01:00
- Run `npm i`
2022-06-12 11:21:25 +01:00
- Run `node .`
2022-06-12 11:09:58 +01:00
2022-06-12 10:57:45 +01:00
---
## Contributions
2022-05-11 12:44:44 +01:00
While this bot is maintained by [Kieran](https://github.com/KieranRobson), contributors are welcome!
2022-06-12 10:57:45 +01:00
- Contribution guidelines are coming soon.