Skip to main content
Freesona includes a full moderation suite with per-guild warning history, configurable auto-punishment thresholds, and all standard member and channel actions. Warning records are stored persistently in warnings.db — they survive restarts and redeployments. The warning system lives in the warns module and core moderation actions live in the moderation module. Enable both before use:
All moderation commands use the ~ prefix by default. Change your server’s prefix with ~prefix <symbol>. The new prefix is saved to config.json and persists across restarts.

​
Warning System

Issue, view, and manage per-guild warnings for any member:

​
Auto-Threshold Actions

Configure automatic punishments that trigger when a member reaches a set warning count:
  • ~warnthresholds (alias ~wt, also /warnthresholds) — open the threshold editor modal
  • Set one or more threshold rules per guild. Each rule maps a warning count to an action.
Supported actions: Example thresholds:
  • At 3 warnings → timeout 1h
  • At 5 warnings → kick
  • At 7 warnings → ban
Thresholds are per-guild and saved to config.json. Use the slash command form /warnthresholds to open the modal directly.

​
Member Actions

Softban bans and immediately unbans a member, which clears their recent message history without keeping them out of the server permanently. The default message deletion window is 7 days; pass a different value with delete_messages (e.g. 7d). Timeout duration format: 10m, 1h, 1d — plain numbers with a unit suffix. Ban delete_messages: Pass a duration like 7d to delete that many days of message history on ban. ~removetimeout has aliases ~rt and ~rto. ~timeout has alias ~to.

​
Channel Management

~purge accepts a limit between 1 and 1000 messages. ~slowmode takes the same duration format as ~timeout (e.g. 30s, 1m) or off to disable. ~lock and ~unlock control @everyone send permissions on the current channel.

​
Bot Whitelist

By default, Freesona ignores messages from other bots to prevent feedback loops. Use the whitelist to let specific bots through the message filter: Pass the integer snowflake ID of the bot you want to allow. /botwhitelist with no arguments shows the current list of whitelisted bot IDs.