Skip to content

Commit ffacb02

Browse files
committed
feat: README.md
1 parent 84f96de commit ffacb02

File tree

3 files changed

+59
-0
lines changed

3 files changed

+59
-0
lines changed

README.md

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
# GroupQuotes
2+
3+
<img style="display: block; margin: 0 auto" src="img/GroupQuotes Logo.png" alt="Logo" width="200"/>
4+
<br>
5+
GroupQuotes is a Discord bot that let's you save and display quotes in your Discord server.
6+
7+
<br>
8+
9+
<button style="display: block; margin: 0 auto; background-color: #734c7a; border-radius: 25px; padding: 0.4rem 1rem;">
10+
<a style="color: white; font-size: 1.5rem;" href="https://discord.com/oauth2/authorize?client_id=784990646893150249&permissions=8&scope=bot">Invite GroupQuotes to your server!</a>
11+
</button>
12+
13+
---
14+
15+
## About
16+
17+
This bot was written in TypeScript using the [discordjs](https://discord.js.org/#/) library, alongside MongoDB and Redis as the databases. Quotes are stored in seperate collections per server in the MongoDB database, and Redis is used to store which text channel in the Discord server is set as the gallery channel.
18+
19+
---
20+
21+
## How to run
22+
23+
While this bot is already being hosted and has a global invite link that can be used on any server, you can run an instance yourself.
24+
25+
### Run:
26+
27+
`npm install` and then
28+
29+
`npm run start`
30+
31+
or `ts-node src/index.ts`
32+
33+
### Environment Variables
34+
35+
The following environment variables are used in the bot:
36+
37+
#### **BOT_TOKEN**
38+
39+
The token of the bot from the Discord Developer Portal.
40+
41+
#### **APPLICATION_ID**
42+
43+
The id of the Discord Application for the bot from the Discord Developer Portal.
44+
45+
#### **MONGO_USER** and **MONGO_PASSWORD**
46+
47+
Username and password for the MongoDB instance.
48+
49+
#### **REDIS_USER** and **REDIS_PASSWORD**
50+
51+
Username and password for the Redis instance.
52+
53+
---
54+
55+
## Future Plans and Known Bugs
56+
57+
- Being able to save multiple quotes at once, ie. a small conversation comprised of two to five quotes, is down the roadmap.
58+
59+
- Currently, for listing quotes, the bot uses a [package](https://www.npmjs.com/package/discordjs-button-embed-pagination) for creating paginated embed messages that contains functionality for flipping through pages. This package has an issue where if there is only one page of messages, hitting any of the buttons results in an "Interaction failed" message (it does not seem to crash the bot at least). In the future, this package might be replaced with a fixed, forked version, or an in house solution for paginated embeds.

img/GroupQuotes Logo.png

221 KB
Loading

img/GroupQuotes Logo.psd

6.18 MB
Binary file not shown.

0 commit comments

Comments
 (0)