AMXX Gag System Reapi

AMXX Gag System

Author: rHuehue

02/06/2024

Added Discord Report Support

Added Discord Reports using GRIP or CURL module

Fixed minor issues with spam detection

Rewritten CVARs using enums

Added new CVARs and admin commands

Overview:

The AMXX Gag System gives server administrators full control over player communication by allowing them to mute (gag) players in text chat, voice chat, or both. It includes advanced anti-spam features, bad-name detection, Discord integration, interactive admin menus, and fully customizable configuration options.

This system is designed to keep your server clean, organized, and free from abusive or disruptive communication.

🛑 Gag Types

Text Chat Gag

Prevents the player from sending messages in the chat.

Voice Chat Gag

Blocks the player's ability to use in-game voice communication.

Combined Gag

Both text and voice are restricted.

⏱ Time-Based Gags

Apply temporary gags with automatic expiration.

Apply permanent gags, which require manual removal.

Remaining gag time can be viewed through the menu.

📝 Gag Reasons & Logging

Admins can specify a reason when gagging a player.

All gags are logged, including:

Player name

Admin name

Duration

Reason

Timestamp

Logs can be customized or disabled entirely.

📢 User-Friendly Admin Commands

Commands:

amx_gag <player> <duration> <reason>

amx_ungag <player>

amx_gagmenu

Supports player name, part of name, or #userid.

Duration is in minutes.

Reason is optional or required based on configuration.

📋 Gag Menu (Interactive)

Accessible via:

amx_gagmenu

Menu Features:

List players and apply gags

Remove existing gags

Set duration & reason

View all gagged players with remaining time

Designed for quick and easy management.

⚙️ Customization & Configuration

The configuration file is stored at:

addons/amxmodx/configs/plugins/RE_Gag_System/

Example Options:

Setting\tDescription

gag_duration_default\tSets default gag duration in minutes.

log_actions\tEnable/disable gag logging.

require_reason\tWhether admins must provide a reason.

admin_level_gag\tMinimum admin flag to use gag commands.

blacklist_words\tForbidden words that trigger punishment.

whitelist_words\tAllowed words/commands that bypass checks.

bad_names\tDetects names matching IP/URL patterns and auto-renames + auto-gags.

🤖 Automatic Protections

Auto Gag for Bad Names

Detects names containing IPs, URLs, or blacklisted patterns.

Automatically renames the player using the Bad Name list.

Applies an automatic gag.

Auto Gag for Chat Spam

Detects excessive message frequency.

Automatically gags spammers.

Admin Immunity

Configurable immunity based on admin flags.

🔗 Discord Report Integration

Supports:

GRIP module

CURL module

Automatically sends gag actions and player reports to your Discord server.

📺 HUD Notifications

Players receive clear HUD messages when:

They are gagged

Their gag expires

Their name is changed

They trigger spam or blacklist filters