sudobot/trunk/README.md

<p align="center">
<img src="https://res.cloudinary.com/rakinar2/image/upload/v1659628446/SudoBot-new_cvwphw.png" height="200px" width="200px">
</p>

<h1 align="center">SudoBot</h1>

<p align="center">
<a href="https://github.com/onesoft-sudo/sudobot/actions/workflows/build.yml"><img src="https://github.com/onesoft-sudo/sudobot/actions/workflows/build.yml/badge.svg" alt="Build"></a>
<img src="https://img.shields.io/github/license/onesoft-sudo/sudobot?label=License" alt="GitHub">
<img src="https://img.shields.io/github/package-json/v/onesoft-sudo/sudobot?label=Version" alt="GitHub package.json version">
<img src="https://img.shields.io/github/commit-activity/w/onesoft-sudo/sudobot?label=Commit%20Activity" alt="GitHub commit activity">
</p>

<p align="center">
A Discord bot for moderation purposes.
</p>

### Features

- Strong automoderation system with tools like anti-spam and anti-raid
- Useful moderation tools 
- Secure
- Fun commands

### Getting started

You can request an invite for SudoBot [here](https://sudobot.everything-server.ml/).
Alternatively, you can create your own Discord API application and then host SudoBot.

### Setup for Custom Hosting

First, download the latest release or clone the repo by running:

```
git clone https://github.com/onesoft-sudo/sudobot
```

Then go inside the project directory, and run the following commands:

```
mkdir config tmp storage logs
touch logs/join-leave.log
echo "{}" > config/snippets.json
cp sample-config.json config/config.json
npm install -D
```

Then open up the `config/config.json` file and change at least the following:

```json
{
    "global": {
        "id": "set your home guild id",
        "owners": ["set owner user ids here"],
        ...
    },
    "guild id here": {
       "prefix": "-",
       "mod_role": "the mod role, users having it will be able to use the bot",
       "gen_role": "general role id, which all users have",
       "mute_role": "the muted role id",
       "admin": "the admin role id. users having it will be immune to sudobot.",
       ...
    }
}
```

**Note**: `...` means other options that exist in the config, you can edit them to customize the settings, but not required.

Build the project:

```
npm run build
```

Deploy slash commands globally:

```
node deploy-commands.js
```

Start the bot:

```
npm start
```

And if everything was configured correctly, you should not see an error and the bot should say `Logged in as [tag]!`.
Then you can run the following command in Discord to make sure everything is working:

```
-about
```

That should show the bot information.
Congratulations! You've successfully set up your own instance of SudoBot!

### Support

- **Email**: [email protected]
- **Discord Server**: [Support Server Invite](https://discord.gg/892GWhTzgs)
1	rakin	168	<p align="center">
2	rakin	211	<img src="https://res.cloudinary.com/rakinar2/image/upload/v1659628446/SudoBot-new_cvwphw.png" height="200px" width="200px">
3	rakin	168	</p>
4	rakin	9
5	rakin	168	<h1 align="center">SudoBot</h1>
6	rakin	9
7	rakin	168	<p align="center">
8			<a href="https://github.com/onesoft-sudo/sudobot/actions/workflows/build.yml"><img src="https://github.com/onesoft-sudo/sudobot/actions/workflows/build.yml/badge.svg" alt="Build"></a>
9			<img src="https://img.shields.io/github/license/onesoft-sudo/sudobot?label=License" alt="GitHub">
10			<img src="https://img.shields.io/github/package-json/v/onesoft-sudo/sudobot?label=Version" alt="GitHub package.json version">
11			<img src="https://img.shields.io/github/commit-activity/w/onesoft-sudo/sudobot?label=Commit%20Activity" alt="GitHub commit activity">
12			</p>
13	rakin	9
14	rakin	168	<p align="center">
15			A Discord bot for moderation purposes.
16			</p>
17	rakin	173
18	rakin	179	### Features
19
20			- Strong automoderation system with tools like anti-spam and anti-raid
21			- Useful moderation tools
22			- Secure
23			- Fun commands
24
25	rakin	173	### Getting started
26
27			You can request an invite for SudoBot [here](https://sudobot.everything-server.ml/).
28			Alternatively, you can create your own Discord API application and then host SudoBot.
29
30			### Setup for Custom Hosting
31
32			First, download the latest release or clone the repo by running:
33
34			```
35			git clone https://github.com/onesoft-sudo/sudobot
36			```
37
38			Then go inside the project directory, and run the following commands:
39
40			```
41	rakin	176	mkdir config tmp storage logs
42			touch logs/join-leave.log
43	rakin	173	echo "{}" > config/snippets.json
44	rakin	176	cp sample-config.json config/config.json
45	rakin	173	npm install -D
46			```
47
48	rakin	176	Then open up the `config/config.json` file and change at least the following:
49
50			```json
51			{
52			"global": {
53			"id": "set your home guild id",
54			"owners": ["set owner user ids here"],
55			...
56			},
57			"guild id here": {
58			"prefix": "-",
59			"mod_role": "the mod role, users having it will be able to use the bot",
60			"gen_role": "general role id, which all users have",
61			"mute_role": "the muted role id",
62			"admin": "the admin role id. users having it will be immune to sudobot.",
63			...
64			}
65			}
66			```
67
68	rakin	178	Note: `...` means other options that exist in the config, you can edit them to customize the settings, but not required.
69
70	rakin	173	Build the project:
71
72			```
73			npm run build
74			```
75
76			Deploy slash commands globally:
77
78			```
79			node deploy-commands.js
80			```
81
82			Start the bot:
83
84			```
85			npm start
86			```
87	rakin	176
88	rakin	177	And if everything was configured correctly, you should not see an error and the bot should say `Logged in as [tag]!`.
89	rakin	176	Then you can run the following command in Discord to make sure everything is working:
90
91			```
92			-about
93			```
94
95			That should show the bot information.
96			Congratulations! You've successfully set up your own instance of SudoBot!
97
98			### Support
99
100			- Email: [email protected]
101			- Discord Server: [Support Server Invite](https://discord.gg/892GWhTzgs)