AtariBot for Discord (Build 1.0.44)
AtariBot is a multi-purpose bot with many features for moderation, fun and administration.
## Table of Contents
* [Getting Started](https://github.com/sEbi3/AtariBot/blob/master/#getting-started)
* [Set up your own bot application](https://github.com/sEbi3/AtariBot/blob/master/#set-up-your-own-bot-application)
* [Installation](https://github.com/sEbi3/AtariBot/blob/master/#installation)
* [Change or add permissions to commands](https://github.com/sEbi3/AtariBot/blob/master/#change-or-add-permissions-to-commands)
* [Contributing](https://github.com/sEbi3/AtariBot/blob/master/#contributing)
## This bot was built with:
*
.NET 6.0
*
DSharpPlus v4.0.1
*
DSharpPlus.CommandsNext v4.0.1
*
DSharpPlus.Interactivity v4.0.1
## Current Features
* Every command has a description for the
function
,
arguments
,
permissions
,
aliases
and on how to use the commands.
* Permissions are set for each command.
* In this case normal users can't execute commands used by moderators or administartors.
* A lot of embeds were used for the commands in order to make it looks more clean and easier to read.
* This bot adds many commands for moderation, administration, information and fun.
* Take a look at the
DSharpPlus Documentation
in order to create your own commands.
* You can also add commands for youself easily by taking a look at the default commands in order to see how they were made.
## Getting Started
### Set up your own bot application
1. Download the source code of the bot
[here].
2. Visit the
Discord Developer Portal and go to
Applications
.
3. Create a new Application and open it.
4. Go to the
Bot
tab on the left side and
add a new Bot
.
5. Copy the
Token
and paste it into the
program.cs
class here:
```cs
discord = new DiscordClient(new DiscordConfiguration
{
Token = "Paste your Token here",
TokenType = TokenType.Bot, MinimumLogLevel = Microsoft.Extensions.Logging.LogLevel.Debug,
});
```
6. Go back to the
Discord Developer Portal and go into the
General Information
tab.
7. Now copy the
Application ID
and open
[this URL] on a new tab and change the
Application ID
from
711550600286044201
to the one you copied.
8. Refresh the page and choose your discord server in the dropdown list. The bot will now join your server.
### Installation
1. Create a new
Console App (.NET)
project.
2. Add the source code into your project by dragging and dropping all files and folders into your project directory.
3. Add the
DSharpPlus API to your project. (Use the
NuGet Manager
for adding the API.)
4. Change everything to your liking. (Have a look above on how to create a
bot application
)
5. Now you only need to
compile the program
. In order to start your bot, go into your project files and start the
AtariBot.exe
.
The bot is only online when the
AtariBot.exe
is running. If you want to have the bot online 24/7, you need to rent a server and start the
AtariBot.exe
from the server. (For uploading the files, you need to use a program that supports FTP.)
### Change or add permissions to commands
1. Go into one of the Modules. (In this case I use the
MiscModule
.).
2. Now find the command where you want to change the permissions. (In this case I use the
msg
command.).
3. After you have found the command, find the following
if statement
:
```cs
if (!ctx.Member.PermissionsIn(ctx.Channel).HasPermission(Permissions.BanMembers)) {
//If the user has not enough permissions, this block of code runs.
}
else {
//If the user has enough permissions, this block of code runs.
}
```
4. The only thing you need to change are the permissions in the statement. (For example: from
Permissions.BanMembers
to
Permissions.Administrator
.)
5. If you don't want any permissions to be required in order to use a command, just leave the
if statement
away.
## Contributing
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request