|
1 |
| -# ETIT-Master-JS |
| 1 | +# ➤ ETIT-Master-JS |
2 | 2 |
|
3 | 3 | [](https://ko-fi.com/G2G54TZ2T)
|
4 | 4 |
|
5 |
| -<p align="center"> |
6 |
| - <br/> |
7 |
| - <img src="./images/Zap.gif" width="300px"> |
8 |
| - <br/> |
9 |
| - <br/> |
10 |
| -See <a href="https://github.com/Chr1s70ph/ETIT-Master-JS/wiki"><span style="text-align:center">here</a> how to use and configure the bot</span> |
11 |
| -</p> |
| 5 | +- [➤ ETIT-Master-JS](#-etit-master-js) |
| 6 | + - [➤ Install](#-install) |
| 7 | + - [➤ Features](#-features) |
| 8 | + - [➤ Configuration](#-configuration) |
12 | 9 |
|
13 |
| -- [ETIT-Master-JS](#etit-master-js) |
14 |
| - - [Install](#install) |
15 |
| - - [Configuration](#configuration) |
16 |
| - - [Prefix](#prefix) |
17 |
| - - [Presence](#presence) |
18 |
| - - [IDs](#ids) |
19 |
| - - [ServerID](#serverid) |
20 |
| - - [ChannelIDs](#channelids) |
21 |
| - - [Subject](#subject) |
22 |
| - - [UserIDs](#userids) |
23 |
| - - [RoleIDs](#roleids) |
24 |
| - - [Calendars](#calendars) |
25 |
| - - [Bot Token](#bot-token) |
26 |
| - |
27 |
| -## Install |
| 10 | +## ➤ Install |
28 | 11 |
|
29 | 12 | Clone the repository, `cd` into it and run `npm install`.
|
30 | 13 |
|
31 |
| ---- |
32 |
| - |
33 |
| -> # OUTDATED |
34 |
| -> This whole README is outdated, but I dont want to update it :) |
35 |
| -> |
36 |
| -> The code is documented in such a way, that everything (should) be self explainatory. |
37 |
| -
|
38 |
| ---- |
39 |
| - |
40 |
| -## Configuration |
41 |
| - |
42 |
| -Rename `EXAMPLE_config.json` to `config.json`. |
43 |
| -Here you can set your prefix, channelIDs, roleIDs, Bot-Token and rich presence of the bot. |
44 |
| - |
45 |
| -### Prefix |
46 |
| - |
47 |
| -Simply set the value of the `prefix` key to whatever prefix you want the bot to use |
48 |
| - |
49 |
| -### Presence |
50 |
| - |
51 |
| -The entries in `#presence` are counting. Increment new entry keys by one. |
52 |
| -`activity#name` is the text that is displayed as the bots presence. |
53 |
| -For valid `activity#type` values check [here](https://discord.js.org/#/docs/main/stable/typedef/ActivityType). |
54 |
| - |
55 |
| -### IDs |
56 |
| - |
57 |
| -#### ServerID |
58 |
| - |
59 |
| -Here you can set the server-ID of the server you want the bot to operate in. |
60 |
| - |
61 |
| -#### ChannelIDs |
62 |
| - |
63 |
| - Set bottest to the channel-ID of the channel, you want the bot to send the startup message to. |
64 |
| - |
65 |
| -##### Subject |
66 |
| - |
67 |
| -Here you can set the names of the channels you want the bot to send the notifications to. |
68 |
| -> NOTE: The key-values **have** to be included in the event name in your calendar. |
69 |
| -> Make sure you have the same key-values as your subject role-IDs |
70 |
| -
|
71 |
| -#### UserIDs |
72 |
| - |
73 |
| - Set the botUserID to your bots user ID |
74 |
| - |
75 |
| -#### RoleIDs |
76 |
| - |
77 |
| - Set adminRole to your servers Admin-Role-ID and add the Developer-Role-ID |
78 |
| -These are used to check if a user has the right to use bot commands. |
79 |
| - |
80 |
| -**Subjects** |
81 |
| -Set the subjects to the role-IDs of your event roles. These are the roles that are pinged, when an event is sent. |
82 |
| -> NOTE: The key-values have to be included in the event name in your calendar. |
83 |
| -> Make sure you have the same key-values as your subject channel-IDs |
84 |
| -
|
85 |
| ---- |
86 |
| - |
87 |
| -### Calendars |
88 |
| - |
89 |
| -You can add as many calendars as you want. |
90 |
| -Check [here](https://support.google.com/calendar/answer/37111?hl=en) on how to get your ical Link. |
91 |
| -Simply scroll down to the bottom and copy your `Secret address in iCal format`. |
92 |
| -<img src="images/icalLink.png"> |
93 |
| - |
94 |
| ---- |
95 |
| - |
96 |
| -### Bot Token |
97 |
| - |
98 |
| -Check [here](https://github.com/reactiflux/discord-irc/wiki/Creating-a-discord-bot-&-getting-a-token) on how to get the bot token of your bot, or create a new bot. |
99 |
| - |
| 14 | +## ➤ Features |
| 15 | + |
| 16 | +- [x] Calendar |
| 17 | +- [x] ChatGPT |
| 18 | +- [x] Exams |
| 19 | +- [x] Mensa |
| 20 | +- [x] Multi Language Support |
| 21 | +- [x] Presences |
| 22 | +- [x] Quicklinks |
| 23 | +- [x] Random Facts |
| 24 | +- [x] Random Gifs |
| 25 | +- [x] Role Assignment |
| 26 | +- [x] Table of Contents generation |
| 27 | +- [x] TextGears |
| 28 | +- [x] Timetable |
| 29 | +- [x] Timetable Reminders |
| 30 | +- [x] User info |
| 31 | +- [x] Welcome Messages |
| 32 | + |
| 33 | +## ➤ Configuration |
| 34 | + |
| 35 | +This is the whole configuration file with sensitive information. You can copy it and fill in your own values. |
| 36 | + |
| 37 | +The only required value is `botToken`, which you can get from the [Discord Developer Portal](https://discord.com/developers/applications). |
| 38 | + |
| 39 | +**privte/sensitive.json:** |
| 40 | + |
| 41 | +```json |
| 42 | +{ |
| 43 | + "textgears_api_key": "<your api key>", |
| 44 | + "tenor": { |
| 45 | + "Key": "<your api key>", |
| 46 | + "Filter": "off", |
| 47 | + "Locale": "en_US", |
| 48 | + "MediaFilter": "minimal", |
| 49 | + "DateFormat": "D/MM/YYYY - H:mm:ss A" |
| 50 | + }, |
| 51 | + "mensa": { |
| 52 | + "user": "<your username>", |
| 53 | + "password": "<your password>", |
| 54 | + "base_url": "<your base url>", |
| 55 | + "api": "<your api path>", |
| 56 | + "additional_info": "<your additional info path>" |
| 57 | + }, |
| 58 | + "calendars": { |
| 59 | + "calendar_1": "<your calendar url>", |
| 60 | + "calendar_2": "<your calendar url>", |
| 61 | + }, |
| 62 | + "botToken": "<your bot token>", |
| 63 | + "openai_token": "<your openai token>", |
| 64 | +} |
| 65 | +``` |
0 commit comments