This is the Rust version of the discord bot created for FBT Heaven
Add extra info and context
+105
-12
+105
-12
README.md
+105
-12
README.md
···
1
-
# FBT Security - Rust
2
-
3
-
This is the source code for the FBTHeaven discord bot.
4
-
5
-
I am the developer for version 2.0, it has been a stale unmaintained project for months but I didn't want my source to just wither untouched so I removed the API keys and added a hand full of `// TODO:`s to the code for you to find what discord IDs you need to change and what other keys you need to provide.
6
-
7
-
You will need a [Redis DB](https://redis.io/) for a bunch of features, no guide on setting one up atm (or possibly every, we'll see how I feel later)
8
-
You can also update a [Meilisearch DB](https://www.meilisearch.com/) with the same data, that one command is easy to comment out if you don't want to use that too
9
-
10
-
I might clean this up further or add a branch for the old python version in the future.
11
-
12
-
good luck whoever may look upon my first large Rust project
1
+
# FBT Security - Rust
2
+
3
+
This is the source code for the FBTHeaven discord bot.
4
+
5
+
## about
6
+
7
+
I am the developer for version 2.0, it has been a stale unmaintained project for months but I didn't want my source to just wither untouched so I removed the API keys and added a hand full of `// TODO:`s to the code for you to find what discord IDs you need to change and what other keys you need to provide.
8
+
9
+
You will need a [Redis DB](https://redis.io/) for a bunch of features, no guide on setting one up atm (or possibly every, we'll see how I feel later)
10
+
You can also update a [Meilisearch DB](https://www.meilisearch.com/) with the same data, that one command is easy to comment out if you don't want to use that too
11
+
12
+
## redis layout
13
+
14
+
The db is split into 8 "folders".
15
+
Redis is a key:value DB meaning you have just the name of the DB entry and then it's value, an example of this is the entry `user:0000000000000000000` which is an entry in the user "folder".
16
+
17
+
here are the "folders" and their descriptions:
18
+
19
+
- `authed-server-users:<DiscordServerID>`
20
+
- This is a Redis [SET](https://redis.io/docs/latest/develop/data-types/sets/) of discord user IDs who are authenticated in the server in the DB entry
21
+
- `cleared-suer:<DiscordUserID>`
22
+
- this is a [JSON](https://redis.io/docs/latest/develop/data-types/json/) entry of users who are cleared as okay in the DB after being flagged
23
+
- Json format:
24
+
25
+
```JSON
26
+
{
27
+
"user_id": "0000000000000000000",
28
+
"username": "TestUsername#0001",
29
+
"where_found": "Name of guild",
30
+
"reason": "Admin enters custom reason here"
31
+
}
32
+
```
33
+
34
+
- `feedback:<timestamp>-<DiscordUserID>-<DiscordUserName>`
35
+
- This is just a [String](https://redis.io/docs/latest/develop/data-types/strings/) containing whatever feedback they put in the feedback command
36
+
- `guild-settings:<DiscordGuildID>`
37
+
- This is a [JSON](https://redis.io/docs/latest/develop/data-types/json/) entry containing if the server has auto kick enabled or not as well as the channel id for bot announcements
38
+
39
+
```json
40
+
{
41
+
"channel_id": "0000000000000000000",
42
+
"kick": true,
43
+
"server_name": "Name of the guild"
44
+
}
45
+
```
46
+
47
+
- `monitroted-guild:<DiscordGuildID>`
48
+
- This is a [JSON](https://redis.io/docs/latest/develop/data-types/json/) entry containing info about tracked servers. this is only inside of the `_deprecated.rs` as it was a hold over from the old Python verion's SQLite DB. more info about this one will come with the Python source code later™️
49
+
50
+
```json
51
+
{
52
+
"guild_name": "Example guild name",
53
+
"guild_id": "0000000000000000000",
54
+
"invite_link": "https://discord.gg/example",
55
+
"updated": "Never",
56
+
"status": "Unknown"
57
+
}
58
+
```
59
+
60
+
- `status:commands-executed`
61
+
- this is a simple [String](https://redis.io/docs/latest/develop/data-types/strings/) entry to track how many commands have run since the feature was implemented, it appears at the bottom of the `/about` command
62
+
- `user:<DiscordUserID>`
63
+
- This is the largest list of entries in the DB.
64
+
- These are [JSON](https://redis.io/docs/latest/develop/data-types/json/) entries for users who are uploaded via scrapped discords, more info on that in the next section
65
+
66
+
```json
67
+
{
68
+
"vrc_id": "ID/Profile URL enetered on a per user basis",
69
+
"username": "DiscordUsername",
70
+
"discord_id": "0000000000000000000",
71
+
"offences": [
72
+
{
73
+
"guild_id": "0000000000000000000",
74
+
"reason": "Reason for adding to list. typically name of discord server found, date and a key from the /key command",
75
+
"image": "URL(s) to image(s) if user was added manually for evidence",
76
+
"extra": "Other text here, mainly for links to extra files"
77
+
}
78
+
]
79
+
}
80
+
```
81
+
82
+
- `kick-whitelist`
83
+
- This is a [SET](https://redis.io/docs/latest/develop/data-types/sets/) that I didn't put in a folder for some reason. It holds a list of DiscordUserIDs that should be ignored when running the `/excel` command.
84
+
85
+
# scrape discords
86
+
87
+
So the main use of this bot origionally was as follows:
88
+
89
+
- scrape discord using [DiscordChatExporter](https://github.com/Tyrrrz/DiscordChatExporter)
90
+
- run resulting .csv files though [my old parser](https://github.com/BuyMyMojo/discord-chat-parser)
91
+
- resulting file to the bot using the `/excel` command
92
+
93
+
This was to be used to scrape servers of bad actors such as VRC model rippers and leakers, it would add every user found inside the server into the DB with a description of the server that they are found in.
94
+
95
+
Once in the DB whenever the user joined a server with the FBT bot active the server owner/mods would get notified of a bad actor joining or optionally it would auto kick these accounts.
96
+
97
+
# that's all folks
98
+
99
+
I might clean this up further or add a branch for the old python version in the future.
100
+
101
+
good luck whoever may look upon my first large Rust project
102
+
103
+
<p style="color: rgba(0, 0, 0, 0)">
104
+
There is no database files or user entries here, look somewhere else <3
105
+
</p>