Skip to content
Dashboard

FAQ & troubleshooting

Miwi FAQ and troubleshooting: quick fixes for commands not showing, missing permissions, music, premium and more.

Miwi doesn't respond to prefix commands#

Use the slash version (/help) or mention Miwi (@Miwi help) - both always work. Check the prefix by mentioning Miwi. Make sure the channel isn't ignored in /settings setup and that Miwi can see and send messages there.

"I'm missing permissions: …"#

Give Miwi's role the permissions listed and move it above the roles it has to manage. See Permissions & roles. /owner scan lists everything worth fixing.

A command says I can't use it#

Commands need the same permission you'd need to do the action yourself. Server managers can add a manager role in /settings setup.

"Only the person who ran the command can use these buttons"#

Buttons and menus belong to whoever opened them. Run the command yourself to get your own.

Antinuke did nothing#

It's probably still in test mode (it only reports), or that protection is off. Check /antinuke settings. Miwi never punishes an action Discord didn't record in the audit log.

Antinuke punished a bot I trust#

Whitelist it: /antinuke whitelist add user:@YourBot.

I hit a limit#

Free servers have a few limits (for example 1 join-to-create hub). The message tells you what Premium allows - see Premium. Security is never limited.

Welcome messages don't send#

Run /welcome setup and press Send test. Miwi needs View Channel, Send Messages and Embed Links in the welcome channel.

Tickets won't open#

/ticket setup shows what's missing (usually the category or a support role). Miwi needs Manage Channels and Manage Roles.

I want to start over#

Run /setup and choose Reset & start fresh (owner or Administrator). Antinuke, cases, tickets and Premium are never reset.

"Something went wrong. Reference: abcd1234"#

Sorry about that! Share the reference in the support server and we'll look it up.

I voted but didn't get a DM#

Votes are credited once Top.gg confirms them (usually within a minute). Miwi can only DM you if your DMs are open to members of a server you share with Miwi - otherwise the Miwi Cash is still added, you just don't get the message. Check /vote wallet (?cash). Turn on /vote reminders to get a DM when you can vote again.

24/7 music stopped or left the channel#

Run /music 247 again in the channel you want. Miwi needs Connect and Speak there. If someone kicks it over and over, it pauses rejoining for about ten minutes, then tries again.

What is Miwi built with?#

TypeScript end to end: Seyfert for the Discord gateway and commands, NestJS for the bot and the API (on Hono), PostgreSQL with Drizzle ORM, Redis for caches and jobs (BullMQ), Lavalink for music and Next.js for this website.

Still stuck? Ask in the support server - real people answer.