Command Reference

Command Documentation

Every command available in Miwa, organized by module. Use the tabs to browse by cog.

Activity & Quotas

Staff quota tracking, live leaderboards, snapshot archives, and personal activity stats.

Setup & Configuration

CommandDescription
-lb create [type] [duration] [title]Create a new live activity leaderboard in the channel. Type: `text` or `voice`. Duration: `24h`, `3d`, `7d`, `1w`, `14d`, `never`/`0` for indefinite.
-lb edit [title] [color]Edit the title or embed color of the current live leaderboard.
-lb concludeManually force-conclude the active leaderboard early. Preserves snapshot.
-lb resumeResume / un-conclude a concluded leaderboard without resetting scores.
-lb unconcludeUnconclude a concluded leaderboard and resume tracking.
-lb extend Extend an active or concluded leaderboard deadline by the given duration (e.g. `3d`, `1w`).
-lb resend
aliases: -lb summon, -lb recall
Re-send the leaderboard message back into chat if it was accidentally deleted (works on both active and concluded boards).
-lb restart [duration]
aliases: -lb reset
Restart the leaderboard with a new duration, resetting the activity baseline.
-lb deletePermanently delete the live leaderboard and all associated data.
-lb listList all active and concluded leaderboards in the server.
-lb infoView full configuration details for the current live leaderboard.
-quota setup [type] [duration] [title]
/quota setup
Create a new live quota leaderboard. Types: `text` (messages) or `voice` (minutes). Duration: `24h`, `3d`, `7d`, `1w`, `14d`, or `never`/`0` for indefinite tracking.
-quota add @Role
/quota add
Attach a quota target (messages or voice minutes) to a staff role on a leaderboard.
-quota set @User
/quota set, /quota edit_user
Set or override the activity quota target for an individual member.
-quota user @User
/quota user
Alias for `-quota set`. Assign or edit a personal quota for a specific user.
-quota remove @Role/@User
/quota remove
Remove a quota assignment from a role or individual member.
-quota edit [link/id]
/quota edit, /quota edit_role
Edit role/member quota requirements, or customize leaderboard settings (title, color, duration, mode).
-quota mode
/quota mode
Set multi-role conflict resolution mode: `highest`, `lowest`, or `stack`.
-quota resume
/quota resume
Resume / un-conclude a concluded quota board without resetting scores.
-quota unconcludeUnconclude a concluded quota board and resume tracking.
-quota extend Extend the quota deadline (e.g. `3d`, `1w`).
-quota resend
aliases: -quota summon
Re-send the quota leaderboard message if deleted. Works on both active and concluded boards.
-quota restart [duration]Restart quota tracking with a new duration, resetting member scores.
-quota concludeManually force-conclude the quota board early.

Viewing

CommandDescription
-quota list
/quota list
List all configured role and individual member quotas for this server.
-quota leaderboard
/quota leaderboard
Open the interactive paginated quota leaderboard with live countdown.
-quota me
/quota me
View your personal activity stats, board progress, and quota progress bars.
-myquotaShortcut — view your own personal quota status and progress. Alias: `-quotame`.

Snapshots

CommandDescription
-snapshot view
/activity snapshot_view
Open the interactive multi-page viewer for an archived historical leaderboard cycle with `.txt` export.
-snapshot list
/activity snapshot_list
List all saved snapshots for this server with their IDs and dates.

VC Leveling

Voice channel activity tracking, XP leveling, level roles, and progress rank cards.

Viewing

CommandDescription
-vc me [@user]
/vc me, /rank
Display a personal voice rank card with pink XP progress bar, server standing, level, and lifetime XP. Optionally check another member's stats.
-vc lb
/vc leaderboard
Open the interactive voice leaderboard with custom triangle navigation arrows and jump controls.
-levelsAlias for `-vc lb`. View highest-ranking voice members.
-roles
/vc roles
View all configured level-up role rewards.

Setup & Configuration

CommandDescription
-vc enable
/vc enable
Enable VC tracking and leveling for this server.
-vc disable
/vc disable
Disable VC tracking and leveling for this server.
-vc toggleToggle VC tracking on or off.
-vc setrole @Role
/vc set_role
Assign a role reward that is automatically granted when a member reaches the specified level.
-vc removerole
/vc remove_role
Remove the level role reward for the given level.
-vc rolemode
/vc set_role_mode
Set how level roles behave: `stack` (keep all earned roles) or `replace` (only keep the highest earned role).
-vc sync [@member]
/vc sync
Re-sync voice level roles for a member or the entire server. Restores missing roles that got plucked out or purged, and cleans up outdated roles.

XP Boosts

CommandDescription
-vc boost add @Role
/vc boost_add
Grant members with that role a voice XP bonus multiplier (e.g. `1.5x` or `2.0x`). Stacks additively.
-vc boost remove @Role
/vc boost_remove
Remove the XP boost from a role.
-vc boost list
/vc boosts
View all configured XP boost roles and their multipliers.

Customization

CommandDescription
-vc bar <6 emojis>
/vc set_bar
Set six custom emojis for the level XP progress bar (start_filled, mid_filled, end_filled, start_empty, mid_empty, end_empty).

Admin Controls

CommandDescription
-vc bonus @User Add bonus XP minutes to a member manually.
-vc setxp @User Forcefully set a member's XP to an exact value.
-vc removexp @User Remove XP from a member.
-vc resetuser @UserCompletely wipe a member's voice XP and level data.
-vc resetserverCompletely wipe ALL member voice data for this server. Irreversible.
-vc blacklist @UserBlacklist a user from gaining voice XP.
-vc unblacklist @UserRemove a user from the voice XP blacklist.
-exempt channel #vcExclude an AFK or music channel from awarding voice XP.

Media Channels

Media-only channel enforcement and granular content-type restrictions with optional auto-threading.

Media-Only

CommandDescription
-media set [#channel]
/media set
Make a channel media-only. Non-media messages are deleted. Every upload automatically receives a dedicated discussion thread.
-media remove [#channel]
/media remove
Disable media-only mode and remove automated threading from the channel.
-media list
/media list
List all channels currently configured as media-only.
-media autothread Toggle auto-threading on media posts globally for media-only channels.

Content Enforcement

CommandDescription
-enforce [#channel] [threads: on|off]
/enforce set
Enforce a specific content type in a channel. Types: `gif`, `voice`/`vn`, `image`, `video`, `media`, `emoji`, `text`. Auto-threading optional on media types, not available on text/emoji.
-enforce remove [#channel]
/enforce remove
Remove all message-type restrictions from a channel.
-enforce list
/enforce list
List all channels currently running message-type enforcement.

Auto Reactions

CommandDescription
-autoreact add [#channel]
/autoreact add
Automatically react to new messages with up to 10 configured emojis.
-autoreact remove [#channel] [emoji]
/autoreact remove
Remove a specific emoji auto-reaction or clear all reactions for a channel.
-autoreact list
/autoreact list
List all auto-reaction channels and their configured emojis.

Sticky Messages

Persistent channel anchors that automatically repost at the bottom of chat when new messages arrive.

Management

CommandDescription
-sticky set #channel
/sticky set
Set a sticky text message in a channel. Reposts automatically at the bottom whenever new chat activity occurs.
-sticky remove [#channel]
/sticky remove
Remove the sticky message from a channel.
-sticky list
/sticky list
List all active sticky messages across the server (max 5 per server).
/sticky set-embedSet a sticky message with a full rich embed using title, description, and color parameters via modal.

Staff Applications

Full modal application pipeline with custom questions, review panels, and one-click accept/deny/discuss.

Submitting

CommandDescription
-apply [name]
/apply
Submit an application for an open position or role. Opens an interactive modal questionnaire. If only one form is open, selects it automatically.

Setup & Configuration

CommandDescription
-app edit
/app edit
Open the interactive management dashboard with direct buttons and channel selector to configure review channel, title, description, questions, or toggle status.
-app create [#channel] [title]
/app create
Create a new application form. `name` is the short identifier (e.g. `staff`, `mod`). Optionally specify the review channel and display title directly.
-app delete
/app delete
Permanently delete an application form and all associated configurations.
-app list
/app list
List all application forms configured in this server.
-app view
/app view
View full configuration details and all questions for an application form.
-app channel [#channel]
/app channel
Set the staff review log channel where submission embeds and review action buttons are posted.
-app cooldown
/app cooldown
Set a reapplication cooldown per user (e.g. `7d`, `24h`, `0` to disable).
-app toggle
/app toggle
Open or close an application form. Closed forms cannot be applied to.
-app description
/app description
Set a short description shown on the application panel before applicants begin the questionnaire.
-app panel [#channel] [description]
/app panel
Post an interactive Apply panel for a single form (direct modal), a comma-separated group of forms (selective dropdown), or all open forms ('all').

Questions

CommandDescription
-app question add
/app question_add
Add a question to an application form. Supports multi-page submission modals up to 20 questions.
-app question remove
/app question_remove
Remove a question by its number from an application form.
-app question clear
/app question_clear
Clear all questions from an application form.
-app question export
/app question_export
Export an application form's questions as a downloadable .csv file.
-app question import [mode] [text]
/app question_import
Import questions into an application form from an uploaded .csv/.txt file or pasted text (replace or append modes).

Roles & Permissions

CommandDescription
-app role accept [@role]
/app role (accept)
Role automatically granted to an applicant when their application is accepted by staff.
-app role required [@role]
/app role (required)
Role required to be held by a member in order to submit an application.
-app role reviewer [@role]
/app role (reviewer)
Staff role that is permitted to review and take action on submissions.

Clan Tags

Post and search server clan tags in the global forum tag registry.

Tags

CommandDescription
-tag post
/tag post
Post a clan tag (based on your Discord server's guild badge) into the designated forum channel. Must have a guild badge equipped.
-tag lookup [starts_with]
/tag lookup
Search the global tag registry with pagination. Filter by starting letter, tag length, or tag type (Alpha/Symbol). Sort alphabetically or by date.

Admin Setup

CommandDescription
-tag setforum #forum
/tag_admin set_forum
Set the designated forum channel where clan tag posts are created. (Admin only.)
-tag setlog #channel
/tag_admin set_log_channel
Set the text channel where tag post activity is logged. (Admin only.)
-tag blacklist add @user
/tag_admin blacklist_add
Blacklist a user from posting tags. (Admin only.)
-tag blacklist remove @user
/tag_admin blacklist_remove
Remove a user from the tag post blacklist. (Admin only.)
-tag blacklist list
/tag_admin blacklist_list
List all users currently blacklisted from posting tags. (Admin only.)

Fun & Games

Interactive fun commands and pranks.

Fun

CommandDescription
-cf
/coinflip
Flip a coin with Miwa. Returns Heads or Tails with a custom embed.
-owolock @user
/owolock
Toggle owolock on a member. While active, Miwa regenerates their messages as owo-ified text via webhook (case-insensitive).
-owolock list
/owolock_list
List all currently owolocked members in the server.

Admin

Bot configuration, module toggles, command enable/disable, and server-specific prefix management.

Help

CommandDescription
-help [category]Open the interactive help center with a category dropdown. Optionally pass a category name directly.

Utility

CommandDescription
-invite
/invite
Get Miwa's invite link to add her to another server.
-sync [guild_id]
/sync
Force an immediate slash command sync to the current guild. Bot owner only.
-ping
/ping
Check the bot's current response latency.

Bot Config

CommandDescription
-module enable Enable an entire module (cog) and all its commands.
-module disable Disable an entire module (cog) for this server.
-module listView all available modules and their current enabled/disabled state.
-cmd enable Enable a specific command by its key (e.g. `image.media`).
-cmd disable Disable a specific command by its key.
-cmd listView all available command keys and their current state.
-config prefix Change the bot prefix for this server (default: `-`).