Getting started
Add Azuka with the button in the top right. Discord asks which server, and you need Manage Server there to complete it.
Nothing needs configuring afterwards. Every command works immediately, and the settings below only change defaults.
/help | Every command, grouped |
/gamelink | Save a game handle so lookups need no arguments |
/prefix | Change the text prefix from ! |
Permissions
Azuka asks for what it uses and nothing more. It never requests Administrator.
| Permission | Needed for |
|---|---|
| Manage Roles | /role, temporary roles, reaction roles |
| Manage Messages | /purge, /snipe, pinning |
| Manage Webhooks | /announce |
| Manage Nicknames | /nick, /rename |
| Manage Channels | /slowmode, /lock, /seasonal |
| Ban Members | /ban, /unban, temporary bans |
| Moderate Members | /timeout, /silence |
| View Audit Log | Attributing deletions and bans in /logs |
A command whose permission is missing says so rather than failing silently.
Linking accounts
Save a handle once and every lookup for that service runs bare.
/gamelink service:osu handle:S3nto
/osu your profile
/osu member:@someone theirs, if they linked one
/osu user:someoneelse anyone, linked or notSix services are supported: osu!, Brawlhalla, Steam, Roblox, Last.fm and Spotify. Spotify needs no linking at all, since it reads what Discord already shows on your profile.
Handles are stored per person, not per server, so linking once covers everywhere Azuka is.
Moderation
Warnings, cases and staff notes all attach to a member. /whois pulls the lot in one lookup instead of four.
/warn | Records a case and tells them |
/modnote | Staff only, the member never sees it |
/silence | A timeout with no case recorded |
/ban duration:7d | Lifts itself, and survives a restart |
/modlog | Where case entries are posted |
Anything scheduled is written to disk rather than held in memory, so a redeploy mid-ban still lifts it on time.
Reaction shortcuts
Three reactions do something when switched on. All are off by default.
| 📌 | Sends that message to your DMs. Nothing is posted in channel. |
| ⚠️ | Flags it to the mod log with a jump link and the author ID. |
| 🏴 | Translates it into that flag’s language. |
Turn them on with /reactions, or from the Manage tab here.
Using it as a user app
Install Azuka to your own account and a subset of commands follow you into any server, including ones it has never joined. Only you see the replies.
Anything marked app in the command list works this way. Moderation never does, because it acts on a server that has not invited the bot.
Troubleshooting
- A command does not appear in Discord
- Discord caches the command list for up to an hour after a change. Restarting the client usually clears it.
/nowplayingsays nobody is listening- Discord only shares this when the Spotify connection is on and set to display on your profile. Settings, Connections, Spotify.
- Score watch never replies
- It stays silent rather than guessing. If it cannot read the map from the image and cannot confirm it against the catalogue, it says nothing on purpose.
- Settings reset after an update
- That means storage is not on a persistent volume. It is a hosting setting, not a bot one.
- A moderation command says it lacks permission
- Azuka’s highest role has to sit above the member it is acting on, not just hold the permission.