lutfenbot Help

/roleban

The /roleban command group allows you to temporarily separate problematic members from others while you privately talk to them.

Sometimes, a member might be causing trouble in the server. You might want to talk to them privately to understand what's going on and to help them out. Rolebanning provides an easy and reversible way to do this. When you roleban a member, they can't see or send messages in any channel except for the one "roleban channel". This allows you to talk to them privately and figure out what's going on.

When you roleban a member, all of their other roles are removed and they are given a "roleban role", which blocks them from accessing any other channel except for a "roleban channel".

When their roleban status is removed, this role is removed and their original roles are restored.

If they leave the server while in a rolebanned state, they are automatically banned from the server. This can be disabled.

/roleban add

This is the command you use to roleban members.

Parameters

ids

IDs of the members to roleban

Up to 24 members can be rolebanned at once. This is because roleban results and errors are sent as embeds in messages and Discord limits the number of embeds in a message to 25. (One is used as a status message.)

Rolebanning a user will fail if:

  • the target member is already rolebanned

  • the target member outranks the command user

  • the target member outranks lutfen

allow-leaving

default: False

whether to allow leaving

If not set to True, users will be banned if they try to leave the server before their roleban is removed.

Valid values are True and False.

silent

default: False

whether to send the result messages ephemerally

Valid values are True and False.

/roleban pardon

This is the command you use to remove roleban status from members.

Parameters

ids

IDs of the members to pardon

Up to 24 members can be pardoned at once. This is because pardon results and errors are sent as embeds in messages and Discord limits the number of embeds in a message to 25. (One is used as a status message.)

Pardoning a user will fail if:

  • the target member is not rolebanned

  • the target member's original roles include one unassignable by lutfen.

Last modified: 06 November 2024