SAC Bot Configuration Guide

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

Configure spam detection settings:

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"]

        /spamfilter enabled:true

        /spamfilter max_repeats:5

        /spamfilter time_window:15

🌊 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: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

        /mentionprotect enabled:true

        /mentionprotect max_mentions:3

        /mentionprotect allow_everyone:false

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

        /antialt enabled:true

        /antialt min_age:72

        /antialt action:kick

� 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]

        /warningexpiry days:30

        /warningexpiry days:0

🔐 2FA Configuration

Configure two-factor authentication:

Setting	Description	Default
`enabled`	Enable 2FA system	true
`require_2fa`	Require 2FA globally	false
`require_for_safe_mode`	Require 2FA for Safe Mode	true
`require_for_staff_login`	Require 2FA for staff login	true

        /2fa action:setup

        /2fa action:verify code:123456

        /require_2fa enabled:true

� 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:

        /spampatterns action:add pattern:"test"

        /spampatterns action:remove pattern:"test"

        /spampatterns action:list

�️ 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