Fake permissions

Discord’s permission system is all-or-nothing. To let a trial moderator use !ban, you normally have to give their role Ban Members — which also lets them ban people through Discord’s own UI, through any other bot in the server, and through the API. Fake permissions decouple those. A role granted ban_members as a fake permission can run !ban through mira and nothing else. Take away their access to the bot and the ability goes with it.

Fake permissions only apply to mira’s own commands. They are not real Discord permissions and are invisible to every other bot.

Granting

!fakepermissions grant @Trial Mod ban_members

!fakepermissions grant @someone manage_messages

!fakepermissions role grant @Trial Mod kick_members
!fakepermissions member grant @someone moderate_members

The bare grant form figures out whether you passed a role or a member. The role and member subcommands exist for when a name is ambiguous. Aliases for grant: allow, add, give.

Revoking

!fakepermissions revoke @Trial Mod ban_members

!fakepermissions reset @Trial Mod

!fakepermissions reset

Aliases for revoke: remove, rm, delete, del. Aliases for reset: clear, purge, wipe.

Viewing

!fakepermissions list
!fakepermissions list @Trial Mod
!fakepermissions role list
!fakepermissions member list

The bare list shows every grant in the server, grouped by target. Pass a role or member to filter.

What you can grant

Any Discord permission name, written in lowercase with underscores. The useful ones:

Permission	Unlocks
`ban_members`	`ban`, `unban`, `softban`, `tempban`, `hardban`, `massban`
`kick_members`	`kick`
`moderate_members`	`timeout`, `untimeout`, `mute`, `unmute`
`manage_messages`	`purge`, `warn`, `impersonate`
`manage_roles`	`role`, `temprole`, `jail`, `lockdown`
`manage_channels`	`slowmode`, `topic`, `hide`, `reveal`, `nuke`, `drag`
`manage_nicknames`	`nickname`, `forcenickname`, `fix`
`manage_guild`	Most configuration commands
`manage_expressions`	`emoji`, `sticker`
`manage_threads`	`thread`, `autothread`
`manage_webhooks`	`webhook`, `reskin`
`administrator`	Everything

The full list is whatever Discord itself accepts. If a name isn’t valid, the command tells you.

Fake permissions don’t bypass Discord’s requirements. A trial mod with fake ban_members can run !ban, but the ban itself is performed by mira using its permissions — so mira still needs real Ban Members, and its role still has to sit above the target’s highest role.Role hierarchy is also still checked against the person running the command: someone can’t ban a member whose top role is above their own, fake permission or not.

A practical setup

A trial moderator who can warn, purge and timeout, but can’t ban, kick, or touch roles:

!fakepermissions grant @Trial Mod manage_messages
!fakepermissions grant @Trial Mod moderate_members

Give the role no real Discord permissions at all. They get exactly those three abilities, only through the bot, and revoking them is one command.

Pair this with command restrictions to be even more precise. manage_messages unlocks purge, warn and impersonate — if you’d rather they couldn’t impersonate people, !command restrict @Trial Mod impersonate closes that off.

Command reference

Command	Aliases	Description
`fakepermissions`	`permissions`, `fakeperms`, `fp`, `perms`, `cmdx`	Overview
`fakepermissions grant <target> <permission>`	`allow`, `add`, `give`	Grant a permission
`fakepermissions revoke <target> <permission>`	`remove`, `rm`, `delete`	Revoke one
`fakepermissions reset [target]`	`clear`, `purge`, `wipe`	Remove all grants
`fakepermissions list [target]`	`ls`, `view`	View grants
`fakepermissions role grant <role> <permission>`	—	Role-scoped grant
`fakepermissions role revoke <role> <permission>`	—	Role-scoped revoke
`fakepermissions role list [role]`	—	Role grants only
`fakepermissions member grant <member> <permission>`	—	Member-scoped grant
`fakepermissions member revoke <member> <permission>`	—	Member-scoped revoke
`fakepermissions member list [user]`	—	Member grants only

Managing fake permissions requires Administrator — otherwise anyone with the ability to grant them could grant themselves everything.

Start here

Security

Moderation

Server setup

Music & audio

Last.fm

Social

Utility

Fake permissions

Granting

Revoking

Viewing

What you can grant

A practical setup

Command reference

​Granting

​Revoking

​Viewing

​What you can grant

​A practical setup

​Command reference

Granting

Revoking

Viewing

What you can grant

A practical setup

Command reference