🚀Setting up Miwi

Miwi is set up from Discord with menus — no long commands to remember, and every change is saved the moment you make it.

1. Invite Miwi#

Add Miwi from the invite page. Keep the permissions it asks for: they are exactly what its features use, and never Administrator by default.

Then open Server Settings → Roles and drag Miwi's role near the top. Miwi can only manage members and roles that are below its own role — this is the most common reason something "doesn't work".

2. Run /setup#

First, Miwi checks its own role. If any role is above Miwi, or it's missing a permission its modules need, setup shows exactly which roles and permissions to fix, with a Check again button that continues where you were.

Run /setup (or m!setup) in any channel. The first time, Miwi offers a guided setup that walks through every module, one menu at a time:

1. Server settings — prefix, manager roles, dashboard access, ignored channels
2. Anti-raid — join-flood detection and what happens to raiders
3. AutoMod — spam, links, invites, mass mentions and more
4. Moderation — DMs, required reasons, warning expiry, mod logs
5. Logging — a channel for every kind of log
6. Tickets — private support channels
7. Welcome — welcome, leave, boost and DM messages
8. Role automation — autoroles, sticky roles and voice roles

Each menu lists every setting with its current value. Pick a setting from the dropdown:

Channels and categories often have Create one for me, which makes a private channel for you. Role pickers have Create role: name it, and Miwi creates a role with no permissions right under its own role (or under yours, if that's lower) and picks it. Press Next to move on, Back to go back, or Stop guided setup to finish later — /setup picks up where you left off.

3. Protect the server#

Antinuke has its own setup because it's the most important one: run /antinuke enable as the server owner. It starts in test mode, so Miwi only reports what it would do until you are ready. See Antinuke.

Running /setup again#

Once Miwi is set up, /setup asks what you want to do:

Reset can only be used by the server owner or an Administrator, and shows exactly what will change first. It never touches antinuke and the whitelist, cases and warnings, tickets and transcripts, AutoMod rules, giveaways, join-to-create hubs or Premium.

Jump straight to one module#

Every module has its own menu too:

Or use /setup module: — for example m!setup tickets.

Who can use the setup menus#

Setup menus need Manage Server (or a Miwi manager role). Only the person who opened a menu can click it. Changing manager roles and dashboard access needs the server owner or an Administrator.