Moderation Server only

/softban

Ban then immediately unban: clears recent messages, the member may rejoin

Usage

Generated
/softban <member> <reason> [delete_days]
OptionTypErforderlichBeschreibung
member member Ja Member to softban
reason text Ja Reason
delete_days whole number Nein Days of message history to delete (0-7, default 1)

Who can run it

Generated
Discord defaultMembers with Ban Members
Command Access presetModerator roles
Always allowedThe server owner and, by default, Administrators
Change itDashboard, Services, Sentinel, Commands

The Moderation preset limits it to the roles you mark as moderators. Server owners and Administrators can always run it. How Command Access works.

What the bot needs

Generated

Sentinel is granted these permissions by the invite link. A command that finds one missing replies privately with what it could not do and changes nothing.

Kick MembersBan MembersManage ServerView ChannelSend MessagesManage MessagesEmbed LinksManage NicknamesManage RolesTimeout Members

Verhalten

Checked against the code 2026-09-21

Bans and immediately unbans a member: they are removed like a kick, their recent messages are deleted, and they may rejoin at once. Discord shows the command only to members with Ban Members by default. The bot checks Command Access rules, that the Moderation service is enabled ("Sentinel is not enabled for this server."), and that the moderator is an Administrator or holds a moderator role from the Settings page ("No permission."). It refuses to act on the server owner, on bots, and on anyone whose highest role is at or above the moderator's own ("Cannot action that member.").

The delete_days option is clamped to 0 to 7 and defaults to 1. With "Confirm before destructive actions" on, the bot first asks "Softban @member, deleting their last 1 day(s) of messages? Reason: ..." with Confirm and Cancel buttons.

The member is messaged first, using the kick DM template and the "DM on kick" switch, since that matches what they experience. Then the ban with message deletion is applied, followed at once by the unban. The result is a softban case, a "Softban" card in the moderation log channel showing how many days of messages were removed, and a reply with the member's name followed by "softbanned: removed and unbanned, the last 1 day(s) of their messages deleted. They may rejoin. Case #12".

If the ban lands but the unban fails, the member is still banned. The bot records that truthfully as a ban case and shows the moderator the error, so /unban can follow.

Good to know

  • A softban case cannot be reversed later: there is nothing left in place to undo.
  • While an anti-nuke panic lockdown is on, only the server owner and the anti-nuke exempt users and roles can run it.
YourBot docs Reference tables are generated from the code that is running. Ask in Discord Suggest a correction