Reference
Commands
Your guide to all 13 slash commands and 3 right-click apps, the same guide /help opens in Discord.
- Works anywhere
- Add WordCounter to your apps and use these in DMs, group chats and servers without WordCounter.
- Server with WordCounter
- These only work in servers that have WordCounter. Add it to a server.
- Permissions
- A command that's only for staff says which permission you need. Every command needs WordCounter to have View Channel, Send Messages and Embed Links where you use it, and each one lists anything else it needs. The invite link gives WordCounter all of these.
/advertisement
Works anywhere
About WordCounter
Posts a card about WordCounter for anyone to see: a pixel-art poster of WordCounter over Earth with signs for what it counts, a short pitch, a line on each part of it, and Add to server, Support server and Website buttons. Anyone can post it, to show a friend or a server what WordCounter does. It's your reply to the command, so Discord shows who posted it. Nobody is pinged.
- WordCounter needs
- Attach Files, for the poster
/analyze_chat single_user
Server with WordCounter
Past messages
Counts one member's past messages using Discord's message search, usually in a few minutes. If search isn't available for the server, it reads channel history instead. Messages already counted live are skipped and gaps when tracking was off are filled in, so nothing is counted twice, and each member is analyzed once (Allow re-analysis in /settings clears them first to redo it). Set keywords in /settings first if they should count in old messages. A progress card shows how far it's got.
- You need
- Manage Server
- WordCounter needs
- Read Message History in the channels it counts
-
target
member
required
- The member whose past messages to count
/analyze_chat swears
Server with WordCounter
Past messages
Reads past messages for swears and adds them to the Swears leaderboard. Nobody is fined, and wallets, debts and streaks don't change.
- You need
- Manage Server
- WordCounter needs
- Read Message History in the channels it counts
/analyze_chat whole_server
Server with WordCounter
Past messages
Reads every tracked channel, voice chat and thread, active and archived, once, and credits each past message to its author, for every member who hasn't been analyzed yet. Messages already counted live are skipped, so nothing is counted twice. Progress is saved every minute, so if WordCounter restarts mid-run it picks up where it stopped on its own. Channels it can't read are listed at the end so you know what was left out. One analysis runs in a server at a time.
- You need
- Manage Server
- WordCounter needs
- Read Message History in the channels it counts
/help
Works anywhere
About WordCounter
Opens WordCounter's guide. It starts on a welcome page under WordCounter's banner: what it counts, how to find your way, and good commands to start with for everyone and for server staff. Previous and Next flip through the pages on stats and leaderboards, settings, counting past messages, the swear jar and WordCounter itself, and every page has Add to server, Support server and Website buttons. Only you can turn the pages. Choose ephemeral to see it privately. When WordCounter joins a server, it posts a welcome with the same banner in the server's system channel, or the first channel where it can attach a picture, pointing staff to /settings and /help, with Botzilla and its game from the same lab. Nobody is pinged.
- WordCounter needs
- Attach Files, for the banner
-
ephemeral
yes or no
- Only show the help menu to you (default: no)
/keyword list
Server with WordCounter
Keywords
Lists the keywords this server counts, 30 a page. Staff add and remove them in /settings, and the keywords tab of /leaderboard shows who says each one most.
/leaderboard
Server with WordCounter
Stats
Shows who leads the server: the top three on a pixel-art podium on Cradle Station's observation deck, with their pictures, then ten members a page. Buttons switch between words, messages, attachments (files, stickers and links), emojis, keywords and swears, and Previous and Next page through. The keywords tab shows who says each tracked keyword most. Pick a channel to rank only what was said there, with that channel's month-by-month history under the list. Members who left show by name. Only the person who ran it can press its buttons, and nobody is pinged. It works once tracking is on in /settings.
- WordCounter needs
- Attach Files, for the podium
-
channel
channel
- Only count activity in this channel
/settings
Server with WordCounter
Settings
Opens WordCounter's settings privately. Choose how tracking works: the whole server with an ignore list, only the channels and categories you pick, or off. Tracking or ignoring a category covers every channel in it. Add and remove keywords, then use the Data & Reset Tools to reset counts for a member, a channel or both, let a member be re-analyzed from scratch, or reset the whole server. Nothing is counted until you pick channels or turn on whole server mode. Only the person who opened it can press its buttons.
- You need
- Manage Server
/stats user
Server with WordCounter
Stats
Your stats card, or another member's when you pick one: their picture and name, their words on WordCounter's flip counter, and their messages, attachments and emojis. Leave the member out to see your own. Under it come their totals (keywords too), then a page for each month with a channel-by-channel breakdown. Pick a month from the menu or page through with Previous and Next. Only you can use the controls. It works once tracking is on in /settings.
- WordCounter needs
- Attach Files, for the stats card
-
user
member
- The member to show statistics for (you, if left out)
/swearjar goal
Server with WordCounter
Swear jar
What the swear jar is saving up for, like a movie night, and how close it is. When the jar collects enough, WordCounter posts once in the goal's channel, and pings @everyone there only if staff chose that.
/swearjar settings
Server with WordCounter
Swear jar
Opens the swear jar's settings privately. Turn it on or off, pick money or your own server tokens and what each tier costs, turn English and Polish swears on or off (English is on and Polish off until you choose), add, remove or move words on the list, choose where it listens with exceptions per channel and a switch for age-restricted channels, turn on delete mode, pick the weekly Potty Mouth role and the clean streak role, and set a goal. Every swear costs, by tier, and debt is only paid back by clean days. It stays off until you turn it on.
- You need
- Manage Server
- WordCounter needs
- Add Reactions for the 🫙 reaction, Manage Messages for delete mode, Manage Roles for the Potty Mouth and clean streak roles (its role above them), and Mention Everyone if a goal pings @everyone
/swearjar top
Server with WordCounter
Swear jar
Four rankings: who swears most, who owes most, who has saved most and who has the longest clean streak, with buttons to switch between them and pages of ten. Members who left show by name, and nobody is pinged.
/swearjar wallet
Server with WordCounter
Swear jar
Shows a member's swear jar on an archive shelf, filled with gold coins for what they've saved or red IOU slips for what they owe, beside their picture, the amount, their clean streak and how many swears they've been fined for. Leave member empty to see your own. It works once staff turn the jar on in /swearjar settings.
- WordCounter needs
- Attach Files, for the jar picture
-
member
member
- Whose wallet to show (yours if you leave it empty)