NinjaBot

NinjaBot is a Discord bot written in C#.

It's primary focus is to help out guilds in World of Warcraft.

This project has been an awesome way for me to learn C#, feel free to toss in a pull request if there's a better way to do something!

Getting Started

(note) Blizzard has recently changed their API a bit. I am re-working NinjaBot accordingly. Some commands have not been worked over, but the core functionality should still be there. That include guild associations, and log posting for retail and classic. (conversion to local timezones for logs will have to be re-added at a later date)

Outside of that, there may be issues, and I will be fixing them as I see them come up.

The first thing you'll need to do is invite the bot to your server. It will need permissions to read and post messages at the very minimum. If you wish to use NinjaBot to assist with admin tasks (kicking/banning users, message management, etc), please use this link.

There are a limited number of classic WoW commands now available. You can associate your guild, and watch/get logs from Warcraft logs. Currently there is no way to get classic armory or guild information via the API, and I'll be watching to see when/if things get added!

More information on the bot and getting started here.

Associating your guild (Retail WoW)

Associating a WoW guild with your Discord server allows you to use the Warcraft Logs watching command, as well as some autocomplete features for guild member names when using various WoW commands.

To associate your guild with NinjaBot, use the following command:

!set-guild realmName, guildName, region

Here are some examples of using the command:

US (also the default if no region is specified)

!set-guild Destromath, NinjaBread Men, us

EU

!set-guild Silvermoon, Rome in a Day, eu

RU

!set-guild Ревущий фьорд, Порейдим месяц, ru

Associating your guild (Classic WoW)

To associate your classic WoW guild with NinjaBot, use the following command:

!set-guildc "guild name" "realm" "region"

Valid regions: US, EU, KR, TW, and CN

NinjaBot will associate what you enter as the guild attached to your server. That data will then be used to watch / retrieve logs from Warcraft Logs.

Example:

US (also the default if no region is specified)

!set-guildc "Disorder" "Rattlegore"

WoW Commands

Warcraft Logs Auto Log Poster (Retail and Classic)

To use the auto log poster, use this command in the channel you want them automatically posted to:

!watch-logs

You can use the same exact command to disable the auto log posting, and then use it again to enable it (in the channel you want them posted to).

Warcraft Logs Last Three Logs

To get the last three of your guild's logs, use:

!logs

Warcraft Logs Last Three Logs (Classic WoW)

To get the last three of your guild's logs, use:

!logsc

World of Warcraft Commands

Raider.IO Player Information Lookup

Command Help:

!rpi

Try to find character (first in guild, then best guess)

!rpi characterName

Long form version to try to find someone not in the same region

!rpi characterName realmName region(us or eu)

Raider.IO Guild Information

!guildstats

Armory lookup (soon to be rolled into rpi where it counts)

!armory characterName

Gearlist

List out a character's gear, including heart of azeroth level. Links to the Wowhead page for the gear.

!gearlist characterName

Server Enhancement Commands

NinjaBot can greet people leaving the server, and notify the server when someone leaves. The messages the bot uses are customizable.

Visit the NinjaBot website for more information.

Help!

If you're having trouble using any of the WoW commands, the first thing to try is re-associating your WoW guild with your Discord server. If that doesn't help, check out the following resources below:

Discord Chat

NinjaBot Website

Feel free to open an issue here for any bugs or problems you come across!

Enjoy.