Permissions
Most Lockie issues come down to missing Discord permissions or role hierarchy. Use this page to check what Lockie needs.
The most important rule
Lockie's role must be above the roles it needs to moderate.
If Lockie is below a user's highest role, Discord will block actions like timeout, kick, ban, and some role changes even if Lockie has the permission enabled.
Recommended permissions by feature
| Feature | Permissions Lockie may need |
|---|---|
| Slash commands | Use Application Commands, View Channel, Send Messages |
| Logs | View Channel, Send Messages, Embed Links, Read Message History |
| Anti-Spam | View Channel, Read Message History, Manage Messages, Moderate Members if using timeouts |
| Anti-Scam | View Channel, Read Message History, Manage Messages, Moderate Members, Kick Members, or Ban Members depending on action |
| Anti-Dox | View Channel, Read Message History, Manage Messages, Moderate Members, Kick Members, or Ban Members depending on action |
| Anti-NSFW or image checks | View Channel, Read Message History, Manage Messages |
| Locking | Manage Channels |
| Maintenance Mode | Manage Channels |
| Mute or timeout | Moderate Members |
| Kick | Kick Members |
| Ban or massban | Ban Members |
| Purge or masspurge | Manage Messages, Read Message History |
| Embed Builder | Send Messages, Embed Links |
| Welcomer | View Channel, Send Messages, Embed Links |
Channel overrides
A channel can block Lockie even when the server role has permissions.
Check the channel permissions if:
- Logs work in one channel but not another.
- Lockie can purge in one channel but not another.
- A welcome message does not send.
- Anti Checks only work in some channels.
Role hierarchy checklist
- Open Server Settings.
- Go to Roles.
- Find Lockie's role.
- Move it above the roles Lockie needs to moderate.
- Save changes.
- Try the action again.
Lockie cannot moderate the server owner.
Safer permission setup
You can start with Administrator during setup, then remove it and grant only the permissions your server needs.
A safer setup should still include:
- Permission to send logs.
- Permission to manage messages in protected channels.
- Permission to moderate members if timeouts are enabled.
- Permission to manage channels if locks or Maintenance Mode are enabled.
- A role position high enough to act on members.
Common errors
403 Missing Access
Lockie cannot see the channel, message, member, or server resource.
50013 Missing Permissions
Lockie is missing a required permission or its role is not high enough.
Commands do not appear
Lockie may have been invited without the slash command scope. Re-invite from https://lockieapp.ca/invite and keep applications.commands enabled.