Docs & guides

Everything Hootus does, written down.

Step-by-step guides for raiders, raid leads, and admins. A tour of the web app. Every slash command in one list. Read the one you need and get back to the game.

Start with the basics Contact the team

17 guides27 slash commands87 subcommands

Guides

Read it once, then stop thinking about it.

Each guide covers one job end to end, and links on to the next one. Follow the Next link at the bottom of any page and you walk the whole set in order.

Start hereGetting started with HootusNew here? Start with this and follow the trail through every guide.

Everyday use

Verify, raid, and keep your characters straight

New membersGetting verifiedLink your WoW character so Hootus gives you the right roles.MembersYour characters and gearAdd alts, set your main, and sync your gear from the armory.MembersFinding a group with LFGPost or join a group for a dungeon, heroic, scenario, or challenge mode.MembersSoft reservesReserve the drops you want, and how officers set it up.Raid leadsRunning a raid, start to finishCreate it, let people sign up, lock it, pull everyone into voice, and finish up.Raid leadsMoving people in the plannerDrag-drop groups, Auto Fill, handle tentatives, and post the lineup to Discord.OfficersPUGs, recruiting, and lootPUG invites and cleanup, applications and auto-invites, soft reserves and loot.OfficersWhen verification goes wrongSomeone came out a guest, stuck in review, or kept the wrong roles. What each standing means and which command fixes it.

For admins

Stand the bot up and wire it to your server

AdminsSetting up HootusGet the bot onto your server and through the setup wizard.AdminsRoles, permissions, and featuresControl who can do what, which roles the bot hands out, and which features are on.AdminsChannels and notificationsWire duties to channels, route every notice, and set up self-assign ping roles.AdminsVerification and member messagesChoose how members get verified, and write the welcome, rules, and bot copy.OfficersRaid automation and groupsReminders, auto-lock and start, approvals, empty-group cleanup, and LFM post defaults.OfficersRecruitment and applicationsOpen recruitment, set your needs, build the application form and apply page.OfficersRoster, members, and promotionsInactivity thresholds, roster sync and import, dashboard focus, and rank promotions.AdminsServer basics: time, addons, and bot healthTimezone and resets, the member addon list, and fixing the bot's permissions.

On the web

What each page of the web app is for.

The web is the companion, not the replacement. Everything here has a Discord equivalent, it is just easier with a mouse.

GuildSee all your guild members, their characters, who's been active, and who's gone quiet. Officers can promote members, add alts, and kick.

CharactersView and manage your characters. Sync your equipped gear straight from the Blizzard API. Set which character is your main.

RaidsSee upcoming raids and sign up for the role you want, tank, healer, or DPS. Check who else is going.

PlannerOfficers and raid leads create and manage raid events. Set dates, times, lock rosters, and drag-drop group compositions.

LFGLooking for group. Post a group request for a dungeon or heroic and find people to run with.

ProfileSet your away status so the bot skips raid nudges while you're offline. Control which DM reminders you receive.

SettingsAdmins configure channels, roles, permissions, verification, raid automation, and recruitment for the server.

In Discord

Every command Hootus knows.

Type the slash in any channel and Discord fills in the rest. You never have to remember the arguments. Commands that split into subcommands list them underneath.

Everyone

/helpHow Hootus works: commands, guides, and where to get help
/verifyVerify your character and get your guild roles
/whoisLook up who owns a character
/characterManage characters, alts, and lookups
- addAdd an alt character
- removeRemove an alt character
- listList all characters for a user
- setmainChange your main character
- setspecSet your active talent spec
- setroleSet your raid role (tank, healer, or dps)
- infoShow detailed character info for a user or search by character name
- lookupLook up a WoW character via the Blizzard API
- linkConnect Battle.net and import every character on your account
/gearCheck a character's equipped gear
/rosterBrowse and search the guild roster
- listShow the guild roster as HootusPlootus last synced it from Blizzard
- findSearch the guild roster with filters
- compQuick raid composition overview
- raiderRaid composition for verified raiders only
- readyShow raid-ready players by role or class
/lfgGroup finder for dungeons, heroics, and pickup raids.
- createCreate a new LFG group
- listShow all active LFG groups (officer/leader view)
- cancelCancel an LFG group for good
- editEdit an LFG group
- finishFinish an LFG group and clean up
- browseSee active groups and which roles you can fill (member view)
/awayMark yourself away, clear it, or see who is out
- setMark yourself away for a while
- backClear away status
- listShow who is away right now
/notificationsControl the DMs Hootus sends you and the pings you get in channels
- dmsChoose which DMs Hootus sends you
- tagsChoose which pings you get in channels
/raiderToggle your raider role on or off
/addonsBrowse recommended addons for the guild
/gbankGuild bank requests and collections.
- requestAsk to take items out of the guild bank (an officer approves)
- listList open guild bank requests (officer view)
- needStart a collection with targets (officer)
- needsSee active collections and their progress
- helpHow guild bank requests and collections work
/pingCheck the bot's latency
/versionShow which version of Hootus is currently flying

Officers & raid leads

/raidRaid event management
- createCreate a new raid event
- requestAsk the raid team to create a raid you can run once an officer approves it
- quickSpin up a public pug raid right now: pick the raid, get the invite links
- listShow upcoming raids
- startStart the raid: lock signups, create voice channels
- pullPull signed-up raiders from gather channels into your voice channel
- inviteGive someone already in this server the raid thread and voice, no application needed
- reopenUndo a start: reopen signups, remove voice channels
- cancelCancel a raid event
- finishFinish raid and clean up channels
- attendancePost the "who showed up?" attendance widget for a raid
- kickRemove a player from a raid
- moveMove a player to a different group
- relocateMove a raid post to a different channel
- groupsShow group assignments for a raid
- pug-inviteGet the invite links for a raid that takes pugs (web signup, Discord signup, voice comms)
- notifyDM the opted-in PUG pool about a raid so they can sign up
- statusView detailed raid status and suggestions
- editEdit a raid (date, time, title, notes, softres, tactics, run purpose, public signup)
- plannerGet the raid planner link
- lootSubmit Gargul loot log for a finished raid
- logAttach a Warcraft Logs report to a raid
- template listList saved raid templates for this guild
- template deleteDelete a saved raid template
/raid-seriesManage recurring raid series
- listShow this server's recurring raid series
- pausePause a series so it stops generating new raids
- resumeResume a paused series
- stopStop a series permanently
- editEdit a series name, interval, or post timing
/rollcallAsk who is coming and get the answer by class, spec and role
- newOpen a roll call and ask the guild who is in
- closeClose a roll call and post the headcount
- listShow the roll calls still taking answers
/pugPUG pool tools for raid leaders
- linkGet the current Discord PUG invite link to share with pickups
- poolList the PUG pool: who is opted in, who never answered, who opted out
- blockBlock a PUG from every raid, or from one raid only
- removeRemove a PUG from the pool without blocking them
- blocklistList PUGs blocked from the pool
- unblockUnblock a PUG so they can apply again
/pendingShow pending member applications with approve/deny buttons
/officer-verifyVerify a user on their behalf and assign roles
/ginviteInvite users to the guild
- raidSend a DM to a Discord user with raid PUG verification buttons
- memberGenerate a verification link for a prospective full member
- tokenGenerate a fresh open invite link to share in recruitment threads
/notesOfficer notes on members
- addAdd a private note to a member
- listRead the notes on a member
- removeDelete a note
/demoteMove a member to social: take the raider rank off and clear their away status
/dormancySee which verified members have gone quiet (officers only)

Admins

/hootusAsk Hootus what it makes of a member, or of this whole server
- checkWhat Hootus makes of a member, or of this whole server
/setupGet a fresh link to the HootusPlootus web setup wizard
/manageMember and bot management
- member resetRemove a member record so they can verify again from scratch
- member roleManually set a user's character info, assign roles, and rename them
- member promoteChange a member's guild rank
- membership setCount someone as a member here, or stop counting them
- membership clearDrop the override and go back to what the roster says
- membership listShow every membership override currently set in this server
- welcomeRe-post the welcome and verification buttons for a member
- welcome-panelPost the welcome embed with verification buttons in this channel
- wow-guildSet the WoW guild and realm used for roster sync
- syncForce an immediate guild roster sync from Blizzard API
- archive-threadLock and archive a raid thread now, without waiting for the day-after cleanup
- refresh-embedsRe-render existing raid and LFG embeds to pick up style changes

Quick answers

The six things people ask first.

Anything longer than a sentence lives in a guide. Anything the guides miss goes to the team.

The full FAQ Ask the team

How do I join a raid?
Click your role (Tank, Healer, or DPS) on the raid post in Discord, or open the raid on the web and sign up there.
How do I add an alt?
Use /character add in Discord, or go to Characters on the web and click Add character.
I left the guild by accident, what happens?
The bot will eventually move you to Guest. Contact an officer to get re-verified.
The bot isn't responding.
Use /ping in Discord. If it doesn't reply, contact your server admin.
Where do I set up raid channels?
Admins go to Settings → Channels on the web.
Can I use Hootus without Discord?
No. The bot needs to be in your Discord server. The web is a companion, not a replacement.

Nothing left to read

Five minutes from invite to first signup.

The guides above cover the whole set, but you do not need them to start. Add the bot, walk the wizard, and post a raid.

Add to Discord See how it works

What shipped lately