Documentation

# Getting Started

NinjaBot is a feature-rich Discord bot designed for gaming communities, especially World of Warcraft players. This guide will help you get NinjaBot set up on your server.

Quick Start

Invite NinjaBot to your server
Use /help to see available commands
Configure settings via the dashboard

# Inviting the Bot

Choose the permission level that fits your server's needs. All features are free.

Basic

WoW lookups, Warcraft Logs, Raider.IO, PvP, activity watchers, fun commands

Invite (Basic)

+ Moderation

All Basic features plus kick, ban, manage messages, moderate members

Invite (+ Moderation)


                                # Basic permissions:

                                VIEW_CHANNEL • SEND_MESSAGES • EMBED_LINKS • ATTACH_FILES

                                READ_MESSAGE_HISTORY • USE_EXTERNAL_EMOJIS • ADD_REACTIONS

                                USE_APPLICATION_COMMANDS


                                # + Moderation adds:

                                KICK_MEMBERS • BAN_MEMBERS • MANAGE_MESSAGES • MODERATE_MEMBERS

# Permissions

Here's what each permission is used for:

Basic Permissions

Permission	Used For
View Channel	See channels to respond in
Send Messages	Respond to commands
Embed Links	Rich embeds for WoW data, logs, etc.
Attach Files	Send images and files
Read Message History	Context for activity watchers
Use External Emojis	Display custom emoji in responses
Add Reactions	React to messages for polls, etc.
Use Application Commands	Slash commands

+ Moderation Permissions

Permission	Used For
Kick Members	/kick command
Ban Members	/ban command
Manage Messages	/clear command to bulk delete messages
Moderate Members	/timeout command

# Slash Commands

NinjaBot uses Discord's native slash commands. Simply type / in any channel to see available commands.


                                $ /help

                                Shows all available commands and categories

For a complete list of commands, check out the Command Reference.

# Configuration

Configure NinjaBot for your server through the web dashboard:

Login with your Discord account
Select your server from the dashboard
Adjust settings as needed

Open Dashboard →

# Changelog

Changelog

[v3.0.0] - Changes since v2.3.7

New Commands

/char - Unified character lookup combining Raider.IO, Armory, and WarcraftLogs

Tabbed views: Overview, Gear, Logs, M+, PvP, Achievements
Individual boss parses with direct fight links
Rank display (#11/7,279 format)
Save characters with /setchar, autocomplete from history

/top10 - Server and guild rankings revamp

Boss autocomplete search
Interactive DPS/HPS and difficulty toggles
Boss navigation buttons
Server vs Guild scope toggle

/realm-watch - Realm status notifications

Get alerts when realms go up/down
Channel or DM delivery

/housing-collection - Decor collection tracker

Progress bar and collection stats
Browse missing items with pagination
Wowhead links and item details

Renamed Commands

/donate → /support-ninjabot

Enhancements

Help - Paginated with First/Prev/Next/Last buttons
Polls - "View Voters" button on non-anonymous polls
Greetings - Separate toggles for welcome and goodbye messages (/toggle-greetings, /toggle-partings)
Word Filter - Detects leet speak, accented characters, and other obfuscation; now available to server admins (was bot-owner only)
Log Monitoring - Smarter checking intervals based on guild activity

Bug Fixes

Fixed missing bosses in encounter dropdown
Fixed boss dropdown showing wrong order
Fixed realm watch autocomplete not finding subscriptions
Fixed crash when guild roster is empty
Fixed /top10 title saying "Top 10" when fewer players available

View full release history on GitHub →