CSB Admin Logger

v1.0.0 15 downloads Daemon666 Last updated: Jul 16, 2026

Logs every admin command (kick/ban/gag/slay/slap/map) with SteamID, target, map and time to MySQL via threaded SQLx, with a flat-file fallback and a csb_log_action native.

CSB Admin Logger keeps an audit trail of what admins do. It watches the common commands — amx_kick, amx_ban, amx_banip, amx_gag, amx_slay, amx_slap, amx_map — and records the admin's name and SteamID, the target/args, the current map and a timestamp into a MySQL table using threaded SQLx, so the game thread never blocks on the database. If the DB is unreachable it falls back to a flat log file, and it exposes a csb_log_action() native other CSB admin plugins can call to record their own actions.

Features

  • Watches the standard admin commands without swallowing them (they still run normally).
  • Threaded inserts through SQL_ThreadQuery — no lag spike on a slow database.
  • Automatic flat-file fallback (addons/amxmodx/logs/csb_admin_actions.log) when SQL fails.
  • native csb_log_action(const admin_auth[], const admin_name[], const target[], const action[]) for other plugins.
  • All string fields are sanitised before they reach the query.

Installation

  1. Enable the sqlx module in addons/amxmodx/configs/modules.ini.
  2. Set csb_log_sql_host/user/pass/db (in amxx.cfg or a server cfg). Leave them empty to use file logging only.
  3. Compile csb_admin_logger.sma, copy it to addons/amxmodx/plugins/, add it to plugins.ini and change the map.

The csb_admin_log table is created automatically on first load if it does not exist.

Installation

1. Enable the sqlx module in addons/amxmodx/configs/modules.ini
2. Set csb_log_sql_host/user/pass/db (or leave empty for file-only)
3. Put csb_admin_logger.amxx in addons/amxmodx/plugins/ and add it to plugins.ini
4. Change map

CVARs

CVARDefaultDescription
csb_log_sql_host 127.0.0.1 MySQL host (empty disables the DB and uses file logging).
csb_log_sql_user root MySQL user.
csb_log_sql_pass MySQL password.
csb_log_sql_db amxx MySQL database name.

Changelog — v1.0.0

1.0.0 - Initial release.
Versions →
Contributors: Daemon666 ✦
License: GPL-3.0

Rating

No ratings yet.

Download v1.0.0

Compiled live from the source below — nothing pre-built.
Download source (.sma)
Files:
csb_admin_logger.sma main 5.8 KB

Requirements

AMX Mod X ≥ 1.9
Engine ReHLDS HLDS
ReGameDLL Not required
ReAPI Not required
Metamod Metamod / Metamod-r
Required modules sqlx
Known conflicts If two copies of this plugin (or two command watchers) load, admin actions will be logged twice.
Back to Plugins