NinjaBot: Getting Started

Getting Started With NinjaBot

Table of Contents

• Adding NinjaBot to Your Discord Server
• Discover Commands to use
• Help!

Adding NinjaBot

To add NinjaBot to your Discord Server, you'll need to use one of two links to get started.

To use NinjaBot as a general purpose bot, and not use any of the administrative command functionality, you can use this link.

To use NinjaBot as a bot that can also perform some administrative tasks (kicking/banning users, and managing messages), you can use this link.

You'll need to have the Manage Server permission yourself in order to use those links to add the bot to your server.

Discover Commands

While the primary purpose of NinjaBot was originally commands for World of Warcraft and Rocket League(coming soon!), there are some other commands you can use that range from having some fun, to server administration.

You can always use !help to get general help, as well as check out the following posts: 

Help!

Has something gone terribly wrong, or just isn't working quite right? You can get help for NinjaBot in the following places:

Feature Enhancements/Requests

• Please submit as an issue on GitHub: 
  https://github.com/gngrninja/NinjaBotCore/issues

General Help

• Ninja Hangout Discord Server: 
  https://discord.gg/MgvJuaV

NinjaBot is Down!

• You can use the Discord server link above, or contact me here.

NinjaBot: World of Warcraft Commands

World of Warcraft Commands

Table of Contents

• Associating Your Discord Server With a Guild in WoW

• Automatically Watch logs from Warcraftlogs.com

• Performing Armory Lookups

• Getting Logs From Warcraft Logs

• Auctions (currently being fixed/updated)

• WoWProgress Ranking

• Realm Lookup

• Get Gear List

• Get Top 10 From Warcraftlogs (currently being fixed/updated)

• Raider.IO player lookup (beta)

• Raider.IO guild lookup

• M+ Affix Lookup

Associating Your Discord Server With a Guild on WoW

You can associate NinjaBot with your guild on WoW. A lot of the other commands will use the Discord server -> WoW guild association by default.

Setting guild association

Permissions: 

• This command requires that the user/issuer is at least able to kick members from the Discord server
  *reasoning* If the user can kick people, they can probably be trusted to change the bot's Discord server <-> WoW realm association

To associate your server with your guild in WoW, use the following command:
*Region currently can be either US/EU.

!set-guild realmname, guildname, region

Example 1 (us):

!set-guild azgalor, wheresmymoneyman

Example 2 (eu):

!set-guild silvermoon, rome in a day, eu

Getting guild association

To get the current server <-> guild association, use the following command:

!get-guild

Example:

!get-guild

Automatically Watch Logs From Warcraftlogs.com

NinjaBot can automatically post the latest report found from Warcraftlogs.com To enable this feature, simply type the following in the channel you'd like the logs auto-posted to:

!watch-logs

Example:

Performing an Armory Lookup

NinjaBot can perform armory look ups. 

To look someone up, use

!armory charactername

or

!armory charactername realmname

or

!armory charactername realmname region

The command will first try to find someone that is in the guild that is associated with your Discord server. If there is no match there, it will then look for the top match in all of armory. Region can be either us or eu. For help on using the command, simply use !armory.

Example 1:

!armory oceanbr

(this will find oceanbreeze, as that is my character name, and it matches that based on the fact that I am member of the guild associated with my Discord server)

Example 2:

!armory swolja eonar

Example 3(eu)

!armory slaqua silvermoon eu

Getting Logs (Via Warcraftlogs.com)

NinjaBot can get you the latest three parses from Warcraft Logs associated with your guild. This command (in its default state) also relies on the Discord server <-> WoW guild association.

To get the latest logs, use:

!logs

or 

!logs realmname, guildname

or

!logs realmname, guildname, region

Region can be either us or eu.

Example 1:

!logs

(I doubt there are any for the guild I'm in, so below is the result of that)

Example 2:

!logs thunderlord, ur key ur carry

Example 3(eu):

!logs silvermoon, rome in a day, eu

Example 4 (personal logs by username):

!logs name gngrninja

Auctions

NinjaBot can list the most commonly used items for crafting/raiding in the latest expansion. The command will perform a lookup based on the realm your Discord <-> guild association is set to.

To list out the auctions, use:

!wow auctions

or 

!wow auctions realmname

Example 1:

!wow auctions

Example 2:

!wow auctions area-52

WoWProgress Rankings

NinjaBot can get rankings from WoWProgress.

To perform a lookup (which will use your Discord <-> guild association by default), use:

!wow rankings

or

!wow rankings realmname, guildname

or 

!wow rankings realmname, guildname, region

Region can be either eu or us.

Example 1:

!wow rankings

Example 2:

!wow rankings destromath, deviant

Lookup Realm Information

NinjaBot can lookup information for a given realm.
This command will default to the region set with !set-guild.
To lookup a realm, use:

!realm-info realmname

Example:

!realm-info thunderlord

List a character's gear

To get started with the !gearlist command, you can simply type:

!gearlist

Example 1 (guild match):

!gearlist ocean

Example 2 (realm and name match):

!gearlist swolja eonar

Example 3 (eu)

!gearlist slaqua silvermoon eu

Top 10s from Warcraftlogs

NinjaBot can get the top 10 dps/hps from the latest raid. To get started, use:

!top10

Example (list):

!top10 list

Example (first fight, all from realm):

!top10 1

Example (first fight, guild only, normal):

!top10 1, guild, dps, normal

Raider IO Player Lookup

NinjaBot can lookup player information from Raider.IO.

Use the following command for help:

!rpi

Example (for finding player gypsy):

!rpi gypsy

Raider IO Guild Lookup

To lookup your guild’s stats from Raider.IO, use:

!guildstats

M+ Affix Lookup

NinjaBot can lookup the current week’s affixes by using:

!affixes