Introduction
Katana is the perfect multi-purpose bot to spice up your server. The bot is community driven and can also be grown with your help.
About this Bot
The bot provides both Fun and Moderation features . The bot is hosted 24/7 and you can be reassured about it's uptime.
Technology
The bot is built with python using the guilded.py library.
We're currently working on our own image API to provide fast image-manipulation commands.
Getting Started
To get started with our bot is fairly easy and we have done our best to make it simpler for you.
In-bot help
There is a in-bot help command that you can use in your server if you don't know the usage of some commands.
You also have the option to get help on all the bot commands right through this Website.
Important: Your Server's privacy must be set to public aka discoverable, else some commands won't work.
Use .recache after updating your Server-Settings.
Adding the bot
To add the bot to your server click here.
This does need you to either be the owner of the server or have "manage server" permissions.
Commands
Syntax:
- < > : Required Argument
- [ ] : Optional Argument
Moderation
- Kick
Description : Let's you kick a Member from the Server.
Usage : .kick < member > [ reason ]
Example : .kick @hoemotion you're rude!
Note : Executing this command requires Kick-Members permissions.
- Ban
Description : Let's you ban a Member from the Server.
Usage : .ban < member > [ reason ]
Example : .ban @hoemotion self-advertising isn't allowed here!
Note : Executing this command requires Ban-Members permissions.
- Unban
Description : Let's you remove a User from the Server-Ban-List.
Usage : .unban < user >
Example : .unban hoemotion
Note : Executing this command requires Ban-Members permissions.
- Purge
Description : Let's you Purge up to 50 messages in a channel.
Usage : .purge < limit >
Example : .purge 30
Aliases: clear
Note : Executing this command requires Manage-Messages permissions.
- Mute
Description : Let's you mute a Member in the Server.
Usage : .mute < member > [ reason ]
Example : .mute @hoemotion mass pinging admins
Note : Executing this command requires Kick-Members permissions. Your Server must have a role called Muted.
- Unmute
Description : Let's you unmute a Member in the Server.
Usage : .unmute < member > [ reason ]
Example : .unmute @hoemotion
Note : Executing this command requires Kick-Members permissions. Your Server must have a role called Muted.
- Temp-Mute
Description : Let's you temporarily mute a Member in the Server, the Member will be automatically unmuted after the given duration.
Usage : .mute < duration > < member >
Example : .tempmute 1w3d @hoemotion
Note : Executing this command requires Kick-Members permissions. Your Server must have a role called Muted.
- Award-XP
Description : Let's you add/remove XP from a Member. Minimum is -1000 and maximum 1000 (API limitation).
Usage : .award-xp < amount > < member >
Example : .award-xp 69 @hoemotion
Note : Executing this command requires Manage-XP permissions.
Utility
- Avatar
Description : Get the avatar of the specified Member.
Usage : .av [ member ]
Example : .av @hoemotion
Aliases: avatar, pfp
- Banner
Description : Get the banner of the specified Member.
Usage : .banner [ member ]
Example : .banner @hoemotion
- AFK
Description : Sets you an AFK status which will be removed once you send a message again.
Usage : .afk [ note ]
Example : .afk coding smth. really important
Note : Once you get mentioned or get a reply to one of your messages while being AFK, the bot will automatically tell the user your AFK note.
- Server-Info
Description : Get informations about the Server.
Usage/Example : .server
Aliases: serverinfo, server-info
Note : The Role count won't work if your Server's privacy is set to Private.
- User-Info
Description : Get informations about the User.
Usage : .user [ member ]
Example : .user @hoemotion
Aliases: whois, userinfo, user-info
Note : The User-Roles-List won't work if your Server's privacy is set to Private. If no Member was specified, you will get your own informations.
- Roles
Description : Get a Roles-List of the Server.
Usage/Example : .roles
Note : This command won't work if your Server's privacy is set to Private.
- About
Description : Get informations about the Bot.
Usage/Example : .about
- Invite
Description : Get the Invite-Link of the Bot.
Usage/Example : .invite
- Ping
Description : Get the Ping of the Bot and the API.
Usage/Example : .ping
Funie
- RPS
Description : Play a round of rock, paper, scissor against the Bot or a Server member!
Usage : .rps [ @member ]
Example : .rps @hoemotion
Note : People who can access the moderator view (seeing private messages) might be cheating.. LMAO
- 8ball
Description : Ask the Bot a question which can be answered with a yes or no and see the results.
Usage : .8ball < question >
Example : .8ball is discord better than guilded?
Note : We don't analyse the question with an AI or something like that, the answers are randomly chosen.
- Rate
Description : Give the Bot a topic and it will rate it for you.
Usage : .rate < topic >
Example : .rate cheese
Note : We don't store your topics in a database, however the given rate is unchangeable since we use a secret math formula :o
- Higher-Lower Game
Description : Play the Higher-Lower guessing game.
Usage/Example : .hl
Snipe
- Snipe
Description : Snipes the given deleted Message, if no number was given, it will automatically snipe the last deleted message.
Usage : .snipe [ 1 - 10 ]
Example : .snipe 4
Note : You cannot Snipe messages by admins/moderators unless you have Manage-Messages permissions.
- Edit-Snipe
Description : Snipes the given edited Message, if no number was given, it will automatically snipe the last edited message.
Usage : .esnipe [ 1 - 10 ]
Example : .esnipe 4
Note : You cannot Snipe messages by admins/moderators unless you have Manage-Messages permissions.
- User-Snipe
Description : Snipes the given deleted message of the target member.
Usage : .usnipe < 1 - 10 > < @member >1>
Example : .usnipe 4 @hoemotion
Note : You cannot Snipe messages by admins/moderators unless you have Manage-Messages permissions.
- User-Edit-Snipe
Description : Snipes the given edited message of the target member.
Usage : .uesnipe < 1 - 10 > < @member >
Example : .uesnipe 4 @hoemotion
Note : You cannot Snipe messages by admins/moderators unless you have Manage-Messages permissions.
Giveaway
- Giveaway
Description : Creates a new Giveaway.
Usage/Example : .giveaway
Aliases: gstart, g-start
Note : Executing this command requires Manage-Server permissions. You will be asked for details about the Giveaway when you run the command.
- Stop Giveaway
Description : Stops a giveaway manually.
Usage : .gstop < giveaway id >
Example : .gstop TijmF83V2
Aliases: g-stop, g-cancel, gcancel
Note : Executing this command requires Manage-Server permissions.
- Delete Giveaway
Description : Deletes a giveaway.
Usage : .gdelete < giveaway id >
Example : .gdelete TijmF83V2
Aliases: g-delete
Note : Executing this command requires Manage-Server permissions.
- Join Giveaway
Description : Join a Giveaway by it's ID.
Usage : .gjoin < giveaway id >
Example : .gjoin TijmF83V2
Aliases: g-join
- Leave Giveaway
Description : Leave a Giveaway by it's ID.
Usage : .gleave < giveaway id >
Example : .gleave TijmF83V2
Aliases: g-leave, gquit, g-quit
- Show Giveaway
Description : Obtain informations about a Giveaway by it's ID.
Usage : .show-giveaway < giveaway id >
Example : .show-giveaway TijmF83V2
Aliases: giveaway-info
- Lock Giveaway
Description : Locks a giveaway
Usage : .glock < giveaway id >
Example : .glock TijmF83V2
Aliases: g-lock
Note : Executing this command requires Manage-Server permissions.
- Unlock Giveaway
Description : Unlocks a giveaway
Usage : .gunlock < giveaway id >
Example : .gunlock TijmF83V2
Aliases: g-unlock
Note : Executing this command requires Manage-Server permissions.
- Block Giveaway
Description : Blocks a Member from joining a specific giveaway
Usage : .gblock < giveaway id > < member >
Example : .gblock TijmF83V2 @hoemotion
Aliases: g-block
Note : Executing this command requires Manage-Server permissions.
- Unblock Giveaway
Description : Unblocks a Member from joining a specific giveaway
Usage : .gunblock < giveaway id > < member >
Example : .gunblock TijmF83V2 @hoemotion
Aliases: g-unblock
Note : Executing this command requires Manage-Server permissions.
- Whitelist Giveaway
Description : Whitelists a Role for joining a specific giveaway
Usage : .gwhitelist < giveaway id > < role >
Example : .gwhitelist TijmF83V2 @Veteran
Aliases: g-whitelist
Note : Executing this command requires Manage-Server permissions.
- Unwhitelist Giveaway
Description : Unwhitelists a Role for joining a specific giveaway
Usage : .gunwhitelist < giveaway id > < role >
Example : .gunwhitelist TijmF83V2 @Veteran
Aliases: g-unwhitelist
Note : Executing this command requires Manage-Server permissions.
Config
- Prefix
Description : Tells the prefix for the Bot in the Server
Usage/Example : @Katana / @Katana prefix
- Set-Prefix
Description : Let's you change the prefix for the Bot in the Server
Usage/Example : .set-prefix
Note : Executing this command requires Manage-Server permissions. The Bot will ask you for the new Prefix.
- Recache
Description : Let's you recache the Server, use this when you made changes in a Server.
Usage/Example : .recache
Note : Executing this command requires Manage-Server permissions.
TicTacToe
- TicTacToe
Description : Let's you play a round of TicTacToe against a Server Member
Usage : .ttt < member >
Example : .ttt @hoemotion
- Place
Description : Places an X or O at the marked place
Usage : .place < 1-9 >
Example : .place 6
- End
Description : Ends the current round.
Usage/Example : .recache
Connect 4
- 4play
Description : Let's you play a round of Connect 4 against a Server Member
Usage : .4play < member >
Example : .4play @hoemotion
Aliases: 4-play, connect-4, connect-four
Animation
- List of all animation commands
punch, awakward, blush, cry, dance, hug, nom, poke, wave, angry, bite, bored, cuddle, happy, kiss, pat, slap