branch/main/README.md · CSB Rank Stats

Daemon666 / csb-rankstats Public

Daemon666 d3ee9c4cd0 Initial release 1.0.0 last year

1 lines 1.6 KiB Markdown Source Rendered Raw Permalink History

<p><strong>CSB Rank Stats</strong> gives every player a quick read on how they are doing. <code>/rank</code> and <code>/stats</code> print your kills, deaths, K/D ratio, headshot percentage, accuracy, playtime and your position on the ladder in two lines of <strong>coloured chat</strong>. <code>/statsme</code> prints a full per-weapon table to the game console (open with <code>~</code>) so you can see exactly which gun is carrying you.</p><p>All numbers come from the <code>csx</code> module's ranked storage &mdash; the same source as the scoreboard rank &mdash; so nothing here needs a database.</p><p>Inspired by the well-known <em>StatsX</em> plugin. This is an independent GPL re-implementation; no original code is reused.</p><h2>Features</h2><ul><li><code>/rank</code> and <code>/stats</code>: rank / total, kills, deaths, K/D, headshot %, accuracy, playtime.</li><li><code>/statsme</code>: per-weapon kills, deaths, shots, hits, headshots and damage, aligned into a console table.</li><li>Coloured chat via <code>client_print_color</code> (AMX Mod X 1.9+).</li><li>No modules beyond <code>csx</code>; no MySQL required.</li></ul><h2>Installation</h2><ol><li>Make sure the <code>csx</code> module is enabled in <code>addons/amxmodx/configs/modules.ini</code>.</li><li>Compile and copy <code>csb_rankstats.amxx</code> into <code>addons/amxmodx/plugins/</code>.</li><li>Add it to <code>plugins.ini</code> and change the map.</li></ol><h2>Notes</h2><p>Accuracy is hits divided by shots and headshot percentage is headshots divided by kills, both taken from the permanent CSX stats. Pair it with <a href="/plugins/csb-top15">CSB Top 15</a> for the server-wide board.</p>

CSB Rank Stats gives every player a quick read on how they are doing. /rank and /stats print your kills, deaths, K/D ratio, headshot percentage, accuracy, playtime and your position on the ladder in two lines of coloured chat. /statsme prints a full per-weapon table to the game console (open with ~) so you can see exactly which gun is carrying you.

All numbers come from the csx module's ranked storage — the same source as the scoreboard rank — so nothing here needs a database.

Inspired by the well-known StatsX plugin. This is an independent GPL re-implementation; no original code is reused.

Features

/rank and /stats: rank / total, kills, deaths, K/D, headshot %, accuracy, playtime.
/statsme: per-weapon kills, deaths, shots, hits, headshots and damage, aligned into a console table.
Coloured chat via client_print_color (AMX Mod X 1.9+).
No modules beyond csx; no MySQL required.

Installation

Make sure the csx module is enabled in addons/amxmodx/configs/modules.ini.
Compile and copy csb_rankstats.amxx into addons/amxmodx/plugins/.
Add it to plugins.ini and change the map.

Notes

Accuracy is hits divided by shots and headshot percentage is headshots divided by kills, both taken from the permanent CSX stats. Pair it with CSB Top 15 for the server-wide board.