NEW-->https://github.com/Franqowsky/SA-Chat-Mute-Fix-v2
A Counter-Strike 2 plugin that fixes the "!" and "/" prefix bypass in CS2-SimpleAdmin's GAG/MUTE/SILENCE punishments.
CS2-SimpleAdmin allows gagged players to bypass chat restrictions by using "!" or "/" prefixes:
- Player gets gagged with
css_gag player 60 reason - Player can still send messages like
!admin,/help, etc. - Other players see these messages, making the punishment ineffective
This plugin blocks ALL chat messages from penalized players, including:
- Messages with "!" prefix (
!admin,!help) - Messages with "/" prefix (
/admin,/help) - Regular chat messages
- Team chat messages
- Real-time MySQL monitoring - Checks CS2-SimpleAdmin database every 5 seconds
- Complete chat blocking - No bypass possible with any prefix
- Multiple punishment types - Works with GAG, MUTE, and SILENCE
- Automatic cleanup - Expired penalties are removed from cache
- Detailed logging - Shows exactly what messages are blocked
- Zero configuration - Uses SimpleAdmin's existing database settings
- CounterStrikeSharphttps://github.com/roflmuffin/CounterStrikeSharp (latest version)
- CS2-SimpleAdminhttps://github.com/daffyyyy/CS2-SimpleAdmin plugin installed and configured
- MySQL/MariaDB database (same as SimpleAdmin uses)
-
Download the plugin
# Download from releases or compile from source -
Install to server
# Copy to your CS2 server /game/csgo/addons/counterstrikesharp/plugins/SAChatMuteFix/ ├── SAChatMuteFix.dll ├── MySqlConnector.dll # Important: Include MySQL dependency └── [other dependencies]
-
Restart server
# Restart your CS2 server -
Verify installation
css_plugins list # Should show: "SA Chat Mute Fix" (1.0.4) by Franqowsky
The plugin works automatically once installed:
-
Admin issues punishment:
css_gag PlayerName 60 Spamming css_mute PlayerName 30 Toxic behavior css_silence PlayerName 120 Breaking rules -
Plugin detects and blocks:
- Monitors database for active penalties
- Blocks all chat messages from penalized players
- Logs blocked messages for transparency
-
Penalty expires:
- Plugin automatically detects expiration
- Player can chat normally again
- Cache is cleaned up
Plugin loaded successfully:
[INFO] 🚀 SA Chat Mute Fix v1.0.4 loaded with MySQL DATETIME support!
Penalty detected:
[INFO] 📋 Found active GAG for PlayerName (SteamID: 76561198...) until 2025-09-13 18:30:00
[INFO] 🔄 Updated penalties cache: 1 active chat penalties found
Message blocked:
[INFO] 🚫 BLOCKED: PlayerName (SteamID: 76561198...) tried to send: '!admin'
[INFO] 🚫 BLOCKED UserMessage from: PlayerName (SteamID: 76561198...)
No configuration needed! The plugin automatically:
- Reads CS2-SimpleAdmin's database configuration
- Connects to the same MySQL database
- Uses the same
sa_mutestable structure
Plugin not loading:
- Ensure CounterStrikeSharp is properly installed
- Check that MySqlConnector.dll is present
- Verify CS2-SimpleAdmin is working
Database connection issues:
- Ensure CS2-SimpleAdmin database is accessible
- Check MySQL credentials and permissions
- Verify
sa_mutestable exists
Messages still showing in logs:
- This is normal - server logs all attempted messages
- Plugin blocks them from reaching other players
- Check for
🚫 BLOCKEDentries to confirm blocking
Architecture:
- Written in C# using CounterStrikeSharp API
- Uses MySQL async queries for database monitoring
- Implements both EventPlayerChat and UserMessage hooks
- Thread-safe penalty caching system
Database Integration:
- Queries
sa_mutestable every 5 seconds - Supports both DATETIME and Unix timestamp formats
- Handles NULL values for permanent penalties
- Compatible with SimpleAdmin 1.7.7+
Performance:
- Lightweight: <1ms processing per message
- Efficient: Only queries active penalties
- Scalable: Handles hundreds of players
- Fork the repository
- Create feature branch (
git checkout -b feature/improvement) - Commit changes (
git commit -am 'Add improvement') - Push to branch (
git push origin feature/improvement) - Create Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Author: Franqowsky
- Inspiration: CS2-SimpleAdmin team for the excellent admin plugin
- Framework: CounterStrikeSharp for the powerful C# API
- Issues: GitHub Issues
- Discord: Our Discord Server
- Steam: