Permissions and troubleshooting

Both you and Taffy need the relevant permissions. A staff role name, access to this channel or a visible button does not grant every moderation power.

Permission reference

• Warn, Warnings, Case history, /case, timeout, remove timeout and warning reset: Timeout Members (Moderate Members).
• Kick: Kick Members.
• Ban and Unban: Ban Members.
• Clear messages: Manage Messages, plus channel access and Read Message History.
• Slowmode: Manage Channels in the target channel.
• Lock/Unlock: Manage Channels and Manage Roles / permission-overwrite access in the target channel.

For member actions, your highest role and Taffy's highest role must be above the target's highest role. The actual server owner is exempt from the actor hierarchy comparison, but Taffy still needs its own higher role. Taffy blocks actions on yourself, bots and the owner. Discord also prevents timeouts on Administrators.

Common problems

• "Selected member and pasted ID differ": clear one field or make both identify the same person.
• "Not a member": verify the ID and whether they left. Hall Ban/Unban and reset support the relevant nonmember workflows; other member actions generally need a current member.
• "Missing permission" / hierarchy error: ask an admin to check your permissions, Taffy's permissions and role positions. Do not move roles or grant yourself access to force an action.
• Expired/replaced review: open a fresh /modhall. If the old action may have run, check state and history first.
• DM not delivered, case saved: the action is recorded; do not repeat it.
• Discord action completed, case not saved: the action may already be in effect. Do not repeat it. Preserve the error, user/channel ID, time and known receipt, then ask the bot owner to repair the record.
• Slow response, timeout or unknown result: inspect current state, recent cases and relevant logs before any retry. Escalate if you cannot establish the result.
• No matching case: check the server, number and retention limits. Do not conclude the member invented it.

When asking for help, send the exact error, action, target ID, channel, time and any case number. Never send bot tokens or credentials.