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
  • Set up your own bot application
  • Installation
  • Change or add permissions to commands
• 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:

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:

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