Rework of Bot: README updated
This commit is contained in:
parent
86b53caba6
commit
87c67d4280
71
README.md
71
README.md
@ -1,6 +1,6 @@
|
|||||||
# Akuma Matata
|
# Akuma Matata
|
||||||
|
|
||||||
A Discord Bot written in Python using the Rewrite API wrapper
|
A Discord Bot written in Python using the Rewrite API Wrapper
|
||||||
|
|
||||||
## Getting Started
|
## Getting Started
|
||||||
|
|
||||||
@ -17,10 +17,8 @@ Depending on your OS and environment you need to type `python3` or another equiv
|
|||||||
1. Go to [your Discord's App Overview](https://discordapp.com/developers/applications/me) and create a new app.
|
1. Go to [your Discord's App Overview](https://discordapp.com/developers/applications/me) and create a new app.
|
||||||
2. Scroll down and "Create a Bot User"
|
2. Scroll down and "Create a Bot User"
|
||||||
3. Reveal and copy Token of your new Bot
|
3. Reveal and copy Token of your new Bot
|
||||||
4. Open [settings.json](settings.json) and paste your Token into the quotes after `"token":`
|
4. Start the Bot (see below)
|
||||||
5. Open Discord, enable Developer Mode (Settings > Appearance) and copy your own ID
|
5. The Bot will ask you for the Token. Paste it.
|
||||||
6. Open [settings.json](settings.json) and paste your ID into the quotes after `"maintainer":`
|
|
||||||
6. Start the Bot (see below)
|
|
||||||
7. Go to [your Discord's App Overview](https://discordapp.com/developers/applications/me) again and open the Bot
|
7. Go to [your Discord's App Overview](https://discordapp.com/developers/applications/me) again and open the Bot
|
||||||
8. Click on "Generate OAuth2 URL" and give the bot `Administrator` Bot Permissions
|
8. Click on "Generate OAuth2 URL" and give the bot `Administrator` Bot Permissions
|
||||||
9. Open the generated URL and add the Bot to your Server
|
9. Open the generated URL and add the Bot to your Server
|
||||||
@ -32,59 +30,8 @@ Depending on your OS and environment you need to type `python3` or another equiv
|
|||||||
|
|
||||||
### Configuration
|
### Configuration
|
||||||
|
|
||||||
In your bot folder are two configuration files: `settings.json` and `server.json`.
|
|
||||||
|
|
||||||
##### settings.json
|
|
||||||
|
|
||||||
- `token`
|
|
||||||
|
|
||||||
The bot token your bot is using.
|
|
||||||
|
|
||||||
- `prefix`
|
|
||||||
|
|
||||||
The bot needs a prefix to distinguish messages adressed to him.
|
|
||||||
|
|
||||||
- `description`
|
|
||||||
|
|
||||||
A description of the bot, printed when calling `help`.
|
|
||||||
|
|
||||||
- `game`
|
|
||||||
|
|
||||||
Sets the "Playing" message of your bot, placed after a help command
|
|
||||||
|
|
||||||
- `extensions`
|
|
||||||
|
|
||||||
A list of all extensions the bot will automatically load after starting. You can add more members either manually or by passing `True` as second argument to `load <ext>`
|
|
||||||
|
|
||||||
- `maintainer`
|
|
||||||
|
|
||||||
ID of the user with privileges to maintain the bot. Only this user can load, unload and reload extensions.
|
|
||||||
|
|
||||||
##### server.json
|
|
||||||
*You can either edit this file manually or use the respective moderation commands.*
|
|
||||||
|
|
||||||
As soon as the bot joins a server, it will fill `server.json` automatically with an dictionary identified by the server ID with the following keys:
|
|
||||||
|
|
||||||
- `adminRole`
|
|
||||||
|
|
||||||
Everyone with the given role has the permissions to run admin commands of the bot
|
|
||||||
|
|
||||||
- `modRole`
|
|
||||||
|
|
||||||
Everyone with the given role has the permissions to run mod commands of the bot
|
|
||||||
|
|
||||||
- `joinMessage`
|
|
||||||
|
|
||||||
A Message every user gets when he joins your server.
|
|
||||||
|
|
||||||
- `suggestionChannel`
|
|
||||||
|
|
||||||
A designated channel for the bot's suggest function. See `help suggest` for more informations
|
|
||||||
|
|
||||||
- `modChannel`
|
|
||||||
|
|
||||||
A channel the bot is using for logging moderation commands.
|
|
||||||
|
|
||||||
|
The configuration files for the bot are now stored in %APPDATA%, $XDG_CONFIG_HOME or ~/.config. The specific directory for these files is `Akumatic/Akuma-Matata`. However is a direct interaction with them not necessary anymore.
|
||||||
|
|
||||||
|
|
||||||
## Add your own extensions
|
## Add your own extensions
|
||||||
@ -92,7 +39,9 @@ It is easy to create a new extension on your own. First you need to create a new
|
|||||||
|
|
||||||
You'll need this code in the newly created file:
|
You'll need this code in the newly created file:
|
||||||
```
|
```
|
||||||
class Name():
|
from discord.ext import commands
|
||||||
|
|
||||||
|
class Name(commands.Cog):
|
||||||
def __init__(self, bot):
|
def __init__(self, bot):
|
||||||
self.bot = bot
|
self.bot = bot
|
||||||
|
|
||||||
@ -107,11 +56,15 @@ Instead of using `@bot.command()` you'll need to use `@commands.command()`.
|
|||||||
|
|
||||||
The first argument of a method needs to be `self`.
|
The first argument of a method needs to be `self`.
|
||||||
|
|
||||||
|
After implementing all your functions, you just need to load the extension with the following command in any channel your bot can listen to: `load <extension>`
|
||||||
|
|
||||||
|
If you add `true`to your command, the extension will be added to your configuration files and gets automatically loaded on start.
|
||||||
|
|
||||||
##### An Example:
|
##### An Example:
|
||||||
```
|
```
|
||||||
from discord.ext import commands
|
from discord.ext import commands
|
||||||
|
|
||||||
class PingPong():
|
class PingPong(commands.Cog):
|
||||||
def __init__(self, bot):
|
def __init__(self, bot):
|
||||||
self.bot = bot
|
self.bot = bot
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user