Docs / Moderation & Administration
Moderation & Administration
A powerful moderation system — punishments, channels, roles, and warnings.
95 commands33 PRO4 guides
How to configure it from the dashboard
The most important moderation dashboard page, and the most overlooked: you can disable any mod command and choose who can use it — far more precise than Discord permissions.
Review command list
Dashboard ← Control & Staff
Each moderation command has its own row: toggle on/off and a dedicated settings page.
Start by turning off what you don't need. A disabled command won't run even if the user has the Discord permission.
ban
nukeDangerous — irreversible
unbanallUnbans everyone with no exceptions
massban
EditReset
A disabled command won't work even if the user has Discord permissions
Choose who can use each command
Control & Staff ← Edit command
Each command has a page where you specify the allowed roles.
Practical example: leave !warn and !mute open to moderators, and keep !ban and !massban for senior admin only.
Allowed roles@Senior-Admin
Log channel#action-log
Require reasonPrevents random punishments
Set the log channel
From Discord: `!modlog #channel`
Without a log, disputes between moderators have no source of truth.
And !modstats ranks moderators by their actions, while !actionsundo reverts the last reversible action.
How the system works
Lona's moderation system is built on three layers working together:
Punishment layer — The command being executed (ban, mute, kick). Every punishment is logged with its moderator, reason, and timestamp, leaving no action unaccounted for.
Logging layer — every action goes to the modlog channel you set. This isn't a luxury: when moderators disagree, the log is the single source of truth.
Undo layer — !actionsundo reverts the last reversible action. So a quick mistake doesn't cost you a member.
The core concept to understand: Discord prevents any bot from managing a role higher than its own. If Lona's role is below the member's role, the command will fail regardless of her permissions. This causes 90% of moderation issues.
Practical recipes
Your server is being mass-spammed right now
Three steps in order — prioritize stopping the bleeding over punishing everyone:
1
!lockdown — locks and hides everything immediately2
!massban @1 @2 @3 — ban the source3
!unlockall then !showall — once things calm downA member is disruptive but doesn't deserve a ban
Escalation is better than harsh punishment, and everything is logged:
1
!warn @member reason — a logged warning2
!mute @member 1h — if they repeat it3
!warns @member — review their record before deciding4
!tempban @member 7d — the final step before a permanent banYou want to clean a channel without losing member messages
Lona distinguishes between bot messages and human messages:
1
!cleanup — deletes bot messages and commands only2
!purgebots — bot messages only3
!nuke — if you want a completely fresh start (deletes and recreates the channel with the same settings)A member joined, caused chaos, and left
The data isn't lost — even after they leave:
1
!history @member — their full punishment history2
!whois @member — account details and any suspicious flags3
!من_دعاني @member — who invited them in the first placeTips and warnings
!note adds a moderation note to a member visible only to moderators — ideal for documenting "this member was warned verbally" without an official warning.!risk scans the entire server and flags roles, webhooks, and bots that pose a risk. Run it once a month.!modstats ranks moderators by their activity — quickly spotting inactive mods.Instead of manually assigning a role to each member,
!tempaddrole grants it for a set duration and removes it automatically.!nuke literally deletes the channel and recreates it. Settings and permissions are restored, but messages are gone forever. There is no undo.!unbanall unbans all banned users without exception — including those banned for good reason. Use with extreme caution.Bulk commands (
massban, roleall, lockall) take time on large servers because Discord rate limits actions. Don't re-run the command thinking it "didn't work".Commands · 95
Punishments
Copied ✓
!kickPrefix
Kick a member from the server — they can rejoin with a new invite.
Copied ✓
!banPrefix
Ban a member permanently with the option to purge their messages.
Copied ✓
!unbanPrefix
Unban a member by ID or username.
Copied ✓
!tempbanPrefix
Temporarily ban a member for a set duration — automatically unbanned afterwards.
Copied ✓
!softbanPrefixPRO
Ban + immediate unban to clear a member's messages without permanently kicking them.
Copied ✓
!massbanPrefixPRO
Ban multiple members at once.
Copied ✓
!masskickPrefixPRO
Kick multiple members at once.
Copied ✓
!massmutePrefixPRO
Mute multiple members at once — default duration is 10 minutes.
Copied ✓
!unbanallPrefixPRO
Unban every banned user in the server.
Copied ✓
!clearbansPrefixPRO
Clean up the ban list based on a filter you specify.
Copied ✓
!mutePrefix
Mute a member for a set duration (Timeout).
Copied ✓
!unmutePrefix
Unmute a member.
Copied ✓
!textmutePrefix
Text mute — prevents typing in all text channels without a timeout: voice channels remain open and open tickets are unaffected. Permanent if no duration is specified.
Copied ✓
!untextmutePrefix
Unmute a member from text channels.
Copied ✓
!timeoutlistPrefix
List all currently muted members and their timeout duration.
Copied ✓
!jailPrefixPRO
Jail a member — removes their roles, hides them from the server, and isolates them in the jail channel. Protected boost and integration roles are automatically exempted without failing the operation. Duration is optional — without it, they remain jailed until released.
Copied ✓
!solojailPrefixPRO
Solo jail — a dedicated channel for the member named after them + "jail". Automatically deleted upon release or if they leave the server.
Copied ✓
!unjailPrefixPRO
Release a member from jail — restores all their original roles and deletes the solo jail channel.
Copied ✓
!actionsundoPrefix
Undo the last reversible action (unban/unmute/...)
Warnings and notes
Copied ✓
!warnPrefix
Warn a member — recorded in their permanent history.
Copied ✓
!warnsPrefix
View all warnings of a specific member.
Copied ✓
!clearwarnsprefix
Clear all warnings of a member.
Copied ✓
!removewarnprefix
Delete a specific warning by its number.
Copied ✓
!noteprefix
Add a private note to a member (visible to moderators only).
Copied ✓
!notesprefix
View all notes on a member.
Copied ✓
!removenoteprefix
Delete a specific note (by its number from %p%notes).
Copied ✓
!historyprefix
Comprehensive moderation history (warnings + notes + Discord audit timeouts).
Copied ✓
!استدعاءPrefix
Summon a member to a specific channel with a notification.
Copied ✓
!modlogprefix
Set the moderation actions log channel.
Copied ✓
!modstatsprefix
Moderator statistics (or leaderboard of all moderators if no member is specified).
Copied ✓
!riskprefix
Comprehensive security risk analysis in the server — dangerous roles/channels/webhooks/bots.
Text channels
Copied ✓
!lockprefix
Lock the channel — prevents sending messages in it.
Copied ✓
!unlockprefix
Unlock a locked channel.
Copied ✓
!lockallprefixPRO
Lock all text channels at once.
Copied ✓
!unlockallprefixPRO
Unlock all locked channels.
Copied ✓
!hideprefix
Hide the channel from @everyone — without specifying a channel, it hides the current channel.
Copied ✓
!showprefix
Show a hidden channel.
Copied ✓
!hideallprefixPRO
Hide all channels.
Copied ✓
!showallprefixPRO
Show all server channels to @everyone — skips protected channels (admin, logs, and bots).
Copied ✓
!lockdownprefixPRO
Emergency mode — comprehensive lock and hide with a single command.
Copied ✓
!slowmodeprefix
Enable slowmode in the channel (delay between messages).
Copied ✓
!threadlockprefix
Lock a thread.
Copied ✓
!threadunlockprefix
Unlock a locked thread and unarchive it — works inside the thread itself only.
Copied ✓
!createchannelprefix
Create a text channel.
Copied ✓
!deletechannelprefixPRO
Delete a text channel with confirmation — without specifying, it deletes the current channel.
Copied ✓
!renamechannelprefix
Rename a channel — stays in its category without changes.
Copied ✓
!movechannelprefix
Move a channel to another category with permission syncing.
Copied ✓
!settopicprefixPRO
Set a channel topic.
Copied ✓
!clonechannelprefixPRO
Clone an entire channel with its permissions — automatically goes into the same category.
Copied ✓
!syncpermsprefix
Sync channel permissions with the parent category.
Copied ✓
!blacklistwriteprefixPRO
Prevent a member from writing in a specific channel.
Copied ✓
!unblacklistwriteprefixPRO
Restore write permissions for a member.
Copied ✓
!blacklistviewprefix
Prevent a member from viewing a specific channel.
Copied ✓
!unblacklistviewprefix
Restore view permissions for a member.
Copied ✓
!addchatPrefixPRO
Grant channel access to a member — gives them view and send permissions in a hidden or admin channel. Applies to the current channel if none is specified.
Copied ✓
!removechatPrefixPRO
Remove a member's access from a channel — resets their custom permissions back to normal.
Copied ✓
!announceprefixPRO
Send an announcement to a specific channel.
Cleaning and purging
Copied ✓
!clearprefix
Smart clear — supports multiple filters:
Copied ✓
!purgeprefix
Delete messages from a specific member in the channel (from 1 to 500).
Copied ✓
!clearchannelprefixPRO
Clear all messages in the channel.
Copied ✓
!nukeprefixPRO
Delete the channel and recreate it with the same settings — complete cleanup.
Copied ✓
!cleanupprefix
Delete bot messages + commands only (to preserve human messages).
Copied ✓
!purgebotsprefix
Delete bot messages only in the channel.
Copied ✓
!purgeafterprefix
Delete all messages after a specific message (by ID).
Copied ✓
!purgebeforeprefix
Delete all messages before a specific message (by ID).
Voice
Copied ✓
!vkickprefix
Disconnect a member from the voice channel.
Copied ✓
!vmuteprefix
Server mute a member.
Copied ✓
!vunmutePrefix
Server unmute a member.
Copied ✓
!deafenPrefix
Server deafen a member (prevents them from hearing).
Copied ✓
!undeafenPrefix
Server undeafen a member.
Copied ✓
!voicebanPrefixPRO
Ban a member from joining voice channels.
Copied ✓
!voiceunbanPrefixPRO
Restore voice channel access for a member.
Copied ✓
!movePrefix
Move a member to another voice channel.
Copied ✓
!createvoicePrefix
Create a voice channel
Copied ✓
!deletevoicePrefixPRO
Delete a voice channel with confirmation — deletes your current channel if unspecified
Copied ✓
!renamevoicePrefix
Rename a voice channel — renames your current channel if unspecified
Copied ✓
!movevoicePrefix
Move a voice channel to another category with synced permissions
Copied ✓
!vmoveallPrefix
Move all members from one voice channel to another
Copied ✓
!disconnectallPrefix
Disconnect everyone in a voice channel (or all channels if unspecified)
Copied ✓
!vlockPrefix
Lock a voice channel (prevents new members from joining)
Copied ✓
!vunlockPrefix
Unlock a locked voice channel
Roles and Nicknames
Copied ✓
!rolePrefix
Add or remove roles for a member — a single role toggles (add/remove), while multiple comma-separated roles are assigned all at once.
Copied ✓
!addrolesPrefixPRO
Assign multiple roles to a member at once.
Copied ✓
!removerolesPrefixPRO
Remove multiple roles from a member at once.
Copied ✓
!stripPrefixPRO
Strip all roles from a member at once.
Copied ✓
!nickPrefix
Change a member's server nickname.
Copied ✓
!setcolorPrefix
Change a role's color.
Copied ✓
!roleallPrefixPRO
Give a role to all members
Copied ✓
!unroleallPrefixPRO
Remove a role from all members
Copied ✓
!massrolePrefix
Give a role to a specific group of mentioned members
Copied ✓
!tempaddrolePrefix
Give a role to a member temporarily (automatically removed afterwards)
Copied ✓
!roleiconPrefix
Change/remove a role icon (requires Boost Level 2)
Copied ✓
!resetnickPrefixPRO
Reset nickname for a member or all members
Points
Copied ✓
!نقطةPrefix
%p%نقطة → Top 10
Copied ✓
!ريست_نقاطPrefix
Resets all server points
No commands match the filter