Configuration Guide - SAC Bot Documentation

Configuration Overview

SAC Bot offers extensive configuration options to customize the bot's behavior to fit your server's specific needs. Configuration can be done through the interactive setup wizard or individual slash commands.

Use the /setup command to access the comprehensive setup wizard with all configuration options.

📢 Spam Filter Configuration

Spam and mention settings are configured in /setup → Spam & Flood. The individual thresholds shown here describe available settings; there is no standalone /spamfilter command.

Setting	Description	Default
`enabled`	Enable or disable spam filter	true
`max_repeats`	Maximum repeated messages	3
`time_window`	Time window in seconds	10
`actions`	Actions to take (delete, mute, etc.)	["delete"]

Open /setup, select Spam & Flood, adjust the controls, and save. See the setup guide.

🌊 Flood Protection Configuration

Configure flood protection settings:

Setting	Description	Default
`enabled`	Enable or disable flood protection	true
`threshold`	Message threshold	10
`window_seconds`	Time window in seconds	5
`actions`	Actions to take	["delete"]

        /floodprotect enabled:true

        /floodprotect threshold:15

        /floodprotect window_seconds:10

🏷️ Mention Protection Configuration

Configure mention protection settings:

Setting	Description	Default
`enabled`	Enable or disable mention protection	true
`max_mentions`	Maximum mentions per message	2
`allow_everyone`	Allow @everyone mentions	false
`punishment_type`	Punishment type	timeout
`punishment_duration_minutes`	Punishment duration	10

Adjust mention limits and allowed roles through /setup → Spam & Flood. There is no standalone /mentionprotect command.

Anti-Alt Configuration

Configure anti-alt account age filter:

Setting	Description	Default
`enabled`	Enable or disable anti-alt filter	true
`min_account_age_hours`	Minimum account age in hours	48
`action`	Action to take (timeout, kick, ban)	timeout
`ban_duration_hours`	Ban duration (0 = permanent)	0
`auto_timeout_duration_hours`	Auto-timeout duration	48

Configure account-age protection in /setup → Security Settings. There is no standalone /antialt command.

Lockdown Configuration

Configure emergency lockdown settings:

Setting	Description	Default
`enabled`	Lockdown status	false
`bypass_role_ids`	Roles that bypass lockdown	[]

        /lockdown status:on

        /lockdown status:off

🔐 CAPTCHA Configuration

Configure CAPTCHA verification system:

Setting	Description	Default
`enabled`	Enable CAPTCHA system	false
`type`	CAPTCHA type (text or image)	image
`max_attempts`	Maximum verification attempts	3
`timeout_minutes`	Verification timeout	5
`image_options`	Available image types	["traffic_light", "bus", "car", "tree", "house", "flower"]

        /captchasetup

        /captcha action:send

⚠️ Warning System Configuration

Configure warning and punishment system:

Setting	Description	Default
`auto_add_warning`	Auto-add warning to punishments	false
`warning_expiry_days`	Days until warnings expire (null = disabled)	null
`warning_tiers`	Warning tier thresholds	[3, 5, 7]

/setup → Rules / warning settings

🔐 2FA Configuration

Configure two-factor authentication:

Setting	Description	Default
`enabled`	Enable 2FA system	true
`require_for_safe_mode`	Require 2FA for Safe Mode	true
`require_for_staff_login`	Require 2FA for staff login	true
`require_for_owner_login`	Require 2FA for owner login	true
`require_password_with_2fa`	Also require the Safe Mode password	false

        /2fa action:setup

        /2fa action:confirm code:123456

        /2fa action:status

        /2fa action:disable code:123456

Read the 2FA setup guide. The server requirement toggles are changed in /setup → 2FA Settings; toggling a requirement does not enroll users automatically.

Team Management Configuration

Configure team members and roles through the setup wizard:

Role	Description
`admin`	Full server administration
`moderator`	Moderation permissions
`staff`	Basic staff permissions

        /setup

        Then select "Team Management" from the setup wizard

Report System Configuration

Configure report system settings:

Setting	Description	Default
`enabled`	Enable report system	true
`minimum_reports_to_ban`	Reports needed for auto-ban	3
`report_cooldown_minutes`	Cooldown between reports	5
`auto_delete_days`	Auto-delete old reports (0 = disabled)	7

        /setup

        Then select "Report System" from the setup wizard

Custom Spam Patterns

Add custom spam detection patterns:

Custom spam patterns, when available for the selected bot build, are managed in the setup wizard. The current slash-command list is in the generated command reference; there is no standalone /spampatterns command.

Image Ban Configuration

Manage banned images:

        /imageban image:[upload image]

        /imageunban image_hash:[hash]

        /imagelist

Security Score Configuration

Configure automatic actions based on security scores:

Setting	Description	Default
`enabled`	Enable security thresholds	false
`kick_threshold`	Auto-kick users with score <= this	0
`ban_threshold`	Auto-ban users with score <= this	0
`check_on_join`	Check score on user join	true

        /security_thresholds

        /security_score user:[user]

💡 Configuration Best Practices

✓ Use the /setup wizard for initial configuration
✓ Start with default settings and adjust gradually
✓ Test configuration changes in a controlled environment
✓ Monitor logs after configuration changes to assess impact
✓ Enable 2FA for enhanced security
✓ Regularly review and update security settings

SAC Bot Configuration