hullcss-discord-bot/README.md

2.4 KiB

HullCSS Discord Bot

This bot is a multipurpose discord bot for The Hull Computer Science Society Discord server.


This bot features multiple command types from:

  • Admin
  • Embeds
  • Fun
  • General
  • Slash Commands

Alongside commands, this bot also features:

  • Auto threading in #coursework-help channel to keep it clean
  • Auto embedding of events for information and archiving
  • Select menu role system within #roles
  • Rule agreement button embed with #code-of-conduct

Installation

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.

🐋 Docker

Due to the Publish.yml workflow, the newest build will automatically be pushed to DockerHub.

docker run -d \
--name=hullcss \
-p 6001:6001 \
-e DISCORD_TOKEN='INSERT DISCORD TOKEN' \
-e PREFIX='!' \
--restart unless-stopped \
kieranr27/hullcss:main

Or if you are using Docker Compose

docker compose up -d

Using a tool like Ouroboros, you can automatically update containers without the need for restarts.

👷 Manual

  • Clone the repo
  • Remove the .template from .env.template
  • Replace INSERT DISCORD TOKEN with your Discord token.
  • Run npm i to install packages
  • Run node . to run the bot

Contributions

While this bot is maintained by Kieran, contributors are welcome!

  • Contribution guidelines are coming soon.

License

hullcss-discord-bot is licensed under the MIT License. The full license text is included in the LICENSE file in this repository. TLDR legal have a great summary of the license if you're interested.