Documentation | PvPCraft Discord Bot
Prefixes default to /, // and !! but can be changed in your servers settings page.
This documentation is primarily about text commands.
General notes
By default, most permissions are unset and default to false make sure to read the permissions section to learn how to activate commands and choose who can use them.
When running commands for the bot make sure not to include <> or [], they are only there to tell you what you need to edit. Things in <> are required for the command to run while things in [] are optional.
If you don't have pvpcraft yet click here to invite him
Settings & Permissions
Permissions are the cornerstone of every system of PvPCraft they allow you to limit commands to a specific channel, role or user in whatever way you deem fit.
If you are familiar with linux commands this chart should be enough. Just remember more specific things inherit from less specific things.
| command | description | node |
|---|---|---|
| perms set <allow|deny|remove> <node>[ --channel <channel>][ --role <role>][ --user <user>] | sets permission nodes | Discord Perm Administrator |
| perms list | displays a link to the website with the current permissions setup | Discord Perm Administrator |
| perms hardreset | removes all user defined permissions | Server Owner |
| setting | generates a link that will allow anyone with admin perms to configure part of the bot through a web ui | Admin |
Though few, these commands form the most powerful permissions system known to Discord. Look at another module and find a node, something like music.play
If you want to give away all commands beginning with music, you can add the wildcard *, eg: music.*.
To allow a permission node for everyone in all text channels, for example enabling music for everyone in all text channels:
/perms set allow music.*
You can then constrain that a bit more by adding one of the optional adjustments onto the end of it. Let's see how it looks when we constrain the node to one channel.
/perms set allow music.* --channel #djs
In this case we allow the users to use all the music commands in the text chat #djs which limits the spam created by users running these commands.
Say you want to keep forceskip for your admin team though. To do this you would first deny the users the forceskip permission. Then allow it for your admin role(s).
This example builds on top of the previous channel specific permission. If you want server-wide music commands remove the --channel #djs from the following commands.
/perms set deny music.forceskip --channel #djs
/perms set allow music.forceskip --channel #djs --role @Admin
Music
Note: Music is disabled at the moment due to youtube decreasing our api limits, and due to them taking action against other music bots it will likely not return.
The Music module allows you to setup the bot to play a queue of songs in a voice channel.
If the music lags I apologise in advance... There is not much that can be done about that at the moment, and really it boils down to more server space, which costs money. If you want to help out, the bot has a Patreon and a Paypal.
Soundcloud and some other random websites are supported by the /play command.
| command | description | node |
|---|---|---|
| init | temporarily binds the bot to the voice channel the user is in, and the text channel the command was used in | music.init |
| destroy | un-binds the bot from it's current voice and text channel. | music.destroy |
| play <search term | video link | playlist > | plays the song or playlist in the bound channel | music.play |
| skip [target] | votes to skips the song at index in queue or the currently playing song | music.voteskip |
| skip [target] -f | force skips the song at index in queue or the currently playing song | music.forceskip |
| pause | pauses the current song | music.pause |
| resume | resumes the current song | music.resume |
| list | lists the contents of the queue | music.list |
| link | displays a link to the currently playing song | music.link |
| time | displays the current time into the song | music.time |
| clear [--user <user>] | clears the queue, if a user is supplied only clears that user from the queue | music.clear |
| volume [volume] | if volume is provided it sets the volume, if not it displays the volume | music.volume.set or/and music.volume.list |
| shuffle | shuffles the current queue | music.shuffle |
Notes
Denying access to a voice channel
The permission node music.initinto can be assigned to a music channel to allow users to init the bot into that channel.
By default all users have this node so it must be expressly denied so if you want to limit the bot to one voice channel
you would use:
/perms set deny music.initinto
then you have to allow it in the voice channel of your choosing using
/perms set allow music.initinto --channel That Music Channel
Remember that music channels can't be mentioned so you need to type out the name Exactly.
Song Limit
You can also limit the number of songs a single user can queue using the numbers mechanic to the permission system.
By giving the permission node music.songcount a specific number you can choose who gets to queue how many songs.
For example to apply a 10 songs in queue cap to all users you can use:
/perms set 10 music.songcount
It can also be targeted at a specific group, user or/and channel the same way any permissions command can be.
Giveaways
Giveaways allow you to host giveaways on your Discord server. At the moment, only one giveaway can be hosted on each Discord server.
PvPCraft's giveaway module allows you to choose who can enter the giveaway, as well as assign roles/users of your choosing the ability to draw.
| command | description | node |
|---|---|---|
| giveaway <enable|disable>[ --channel <channel>] | enables or disables the giveaways. If no channel is provided it will use the last one used, or if none has been used the channel the message was sent in. | admin.giveaway.setup |
| gclear | clears all entries | admin.giveaway.clear |
| gcount | counts all entries | admin.giveaway.count |
| gdraw [count] | draws one or more winners | admin.giveaway.draw |
| enter | enters a giveaway | giveaway.enter |
Moderation
Moderation module, mod log was moved into feeds, this is now just purge, to disable the old one use /setlog disable.
| command | description | node |
|---|---|---|
| purge [count][ --user <user>][ --before <message id>][ --after <message id>][-d] | purges the text channel of messages | moderation.tools.purge |
If used the -d flag will drop messages purged using the command instead of logging them.
Feeds Manager
This is similar to the permissions system but for events like Warframe alerts and/or moderation log events.
| command | description | node |
|---|---|---|
| feeds <start|stop> <feed node>[ --channel <channel>] | enables or disables a specific feed within a channel. | feeds.manage |
| find <node> | checks where a certain node goes | feeds.find |
Warning: Privacy
Make sure to inform users if message content could be included in logs from channels they are a part of. As the server admin you are responsible for doing so. If you want to log content in all channels we suggest setting up a welcome message to let users know.
Available feeds
| feed node | description | permission node |
|---|---|---|
| moderation.message.deleted | Logs message deletes | msglog.whitelist.message.deleted |
| moderation.message.updated | Logs message edits | msglog.whitelist.message.updated |
| moderation.channel.created | Logs channel creation | |
| moderation.channel.deleted | Logs channel deletion | |
| moderation.channel.updated | Logs channel edits | |
| moderation.server.updated | Logs server updates | |
| moderation.role.created | Logs role creation | |
| moderation.role.updated | Logs edits to roles | |
| moderation.role.deleted | Logs role deletion | |
| moderation.member.added | Logs joins | |
| moderation.member.removed | Logs leaves/kicks | |
| moderation.member.banned | Logs user bans | |
| moderation.member.unbanned | Logs use unbans | |
| moderation.member.updated | Logs server specific user changes | msglog.whitelist.member.updated |
| moderation.user | Logs user changes | msglog.whitelist.user |
| moderation.voice.join | Logs voice joins | msglog.whitelist.voice.join |
| moderation.voice.switch | Logs voice moves | msglog.whitelist.voice.switch |
| moderation.voice.leave | Logs voice leaves | msglog.whitelist.voice.leave |
So for example once you have allowed yourself the permissions node required (feeds.manage, see the permissions section at the top) you can run the following command to log just users joining voice.
/feeds start moderation.voice.join
Which will then be logged into the text channel the command was run in. If you want to log multiple similar events a * can be used to reduce the commands required. For example to log all message events you can use.
/feeds start moderation.message.*
Be warned that unlike permissions you can't start moderation.* then stop moderation.voice in order to get everything but voice, with feeds everything but voice must be started. Also if you have given yourself * you will have to deny yourself the white-list nodes for message deletes and edits if you want your own messages to be logged when they are deleted.
Warframe
| command | description | node |
|---|---|---|
| deal | gets Darvo’s daily deals | warframe.deal |
| trader | gets the current voidtrader info | warframe.trader |
| trial | gets links to the current trial statistics | warframe.trial |
| wiki <item name> | searches the wiki for an item | warframe.wiki |
| sortie | gets the current sortie | warframe.sortie |
| rift | gets the current fissures | warframe.rift |
| farm | gets a random farming guide | warframe.farm |
| damage | gets Telkhines damage table | warframe.damage |
| primeaccess | gets the prime access info | warframe.access |
| update | gets the current update and/or hotfix | warframe.update |
| armor | does some armor calculations | warframe.armor |
| alert[s] | gets the current alerts | warframe.alert |
| alert[s] enable --channel <channel> | Enable alert tracking | admin.warframe.alerts |
| alert[s] add <item> | Adds an item to the items that are being tracked | admin.warframe.alerts |
| alert[s] remove <item> | Removes an item from the items that are being tracked | admin.warframe.alerts |
| alert[s] join <item> | Allows a user to get notifications when an item comes up | warframe.alerts.join |
| alert[s] leave <item> | Stops notifying a user about when an item comes up | warframe.alerts.leave |
| alert[s] list | Lists all the items users join or/and leave | warframe.alerts.list |
Misc
If a user has the permission node warframe.misc.soon the user will reply to soon with soon:tm:
Ranks
Requirements
The PvPCraft bot must have a role that is higher than the rank you want it to add to users and it must have the Discord permission Manage Roles.
Notes:
If a rank is added with the visible name of joinrole it will not be visible on the /rank list output and it will
be added to users as they join the Discord server.
The visible name of a rank is the label for the rank that is visible to the users running /list or /rank join.
| command | description | node |
|---|---|---|
| rank add <visible name> --role <mention or exact name of an existing role> | adds the role from --role to the list of joinable ranks under the name of <visible name> | admin.rank.add |
| rank remove <visible name> | removes a rank from the list of join-able ranks | admin.rank.remove |
| rank join <visible name> | adds the user of the command to the rank they request | rank.join.use && rank.join.<visible name> |
| rank leave <visible name> | removes the user of the command from the rank they request | rank.leave.use && rank.leave.<visible name> |
| rank list | Lists all of the ranks | rank.list |
Examples
If you want to simply allow all users to join all the ranks you've added to the rank list you can run
/perms set allow rank.*
If you want to add a rank to the list make sure you have admin.rank.add then run
/rank add member --role @member
where the first member is the label for the rank you want users to see, and the @member is a mention for or the exact
name of the role you want added to the user when they run /rank join member
Pokemon
| command | description | node |
|---|---|---|
| pokemon <pokemon> | searches for a Pokemon | pokemon.pokemon |
| shiny <pokemon> | searches for a shiny | pokemon.shiny |
| pokestat <pokemon> | gets a Pokemon’s stats | pokemon.pokestat |
| hiddenability <pokemon> | fetches a Pokemon’s hidden ability | pokemon.hiddenability |
Minecraft
| command | description | node |
|---|---|---|
| mcping <server address> | Pings a Minecraft server and displays some info about it. | minecraft.mcping |
| mcavatar <minecraft username> | Displays a user's Minecraft avatar | minecraft.avatar |
| mcskin <minecraft username> | Displays a user's Minecraft skin | minecraft.mcskin |
| mcwiki <search term> | Searches the minecraft wiki with a supplied search term | minecraft.mcwiki |
| mcauth --host <host> --username <username> --password <password> [--https <true or false>][--port <\port>][--bridgeAllMessages <true or false>] | Links a minecraft server with JSONApi installed on it to discord | admin.minecraft.mcauth |
Utilities
Displays some misc info about servers and users and stuff.
| command | description | node |
|---|---|---|
| server | Displays some info about the server | utils.serverinfo |
| user <user mention> | Displays some info about the user | utils.userinfo |
| ping | Displays the bot's ping | utils.ping |
| lmgtfy <thing to google for them> | returns a let me google that for you link. | utils.lmgtfy |
| status | displays the bot's current status | utils.status |
| getshardedinfo | displays the global information about the bot's connections | utils.getshardedinfo |
Cleverbot
Warning: Currently Disabled
The API this uses is currently failing more than working, for status updates you can try their slack
Normal functionality
If the user has the permission node cleverbot.misc respond to any messages in which they mention the bot with a
message from Cleverbot.
Welcome
Welcomes users to the server
| command | description | node |
|---|---|---|
| setwelcome <welcome message | false>[ -p][ --channel <channel>] | Sets the welcome message | admin.welcome.set |
flag -p means the bot will private message the user.
Variables
| variable | result |
|---|---|
| $mention | is replaced by a mention for the user eg @macdja38 |
| $server | replaced by the servers name |
| $user | replaced by the username of the user |
Chess
Warning, chess module does not save the current games anywhere, if the bot restarts (which it does at least once a day) your current game will randomly get deleted. Issue that tracks this is here
Games are scooped to a channel, only one game can happen per channel at any time.
| command | description | node |
|---|---|---|
| start | starts the game | game.chess.start |
| move <chess move in algebraic chess notation> | makes a move | game.chess.move |
| end | ends the game | game.chess.end |
Help
Help module... displays a link to this website
| node | description |
|---|---|
| help | display link to help website |