Jcustoms

HONEST LEADERBOARDS
Real-time Rust stat tracking — self-hosted, no subscriptions, no monthly fees

What is it?
Honest Leaderboards is a complete stat tracking framework for your Rust server. An Oxide/Carbon plugin pushes player stats to your own web host every 30 seconds — giving you a live, searchable, sortable leaderboard page that's 100% yours.
No SaaS. No monthly fees. No shared servers. You own everything.

Stats Tracked

⚔ Combat
PvP Kills
Deaths & PvP Deaths (tracked separately)
K/D Ratio
Headshots
NPC Kills
Rockets Fired

⛏ Resources
Wood
Stone
Sulfur
Metal
High Quality Metal
Scrap

🏃 Movement
Distance Walked
Playtime

Web Leaderboard
Live search — filter players by name instantly
Click-to-sort — any of 15 columns, ascending or descending
Top 3 podium — Steam avatars, full stat breakdown per player
Column groups — Combat / Resources / Movement clearly separated
One-line branding — change a single hex code, the entire page updates
60-second cache — zero database hammering under load
CSP-safe — works on Hostinger, SiteGround and other hosts with strict security headers

In-Game /leaderboard Command

Players type /leaderboard in chat to see the top players ranked in-game. Fully optional — one config line disables it entirely.

/leaderboard — top PvP kills
/leaderboard sulfur — top sulfur gatherers
/leaderboard rockets — most rockets fired
/leaderboard distance — most distance walked
/leaderboard playtime — most time played

15 sort options: kills · deaths · pvp_deaths · headshots · npc_kills · rockets · wood · stone · sulfur · metal · hqm · scrap · resources · distance · playtime

Setup — 6 Steps, ~10 Minutes

1. Run schema.sql in phpMyAdmin — creates 3 tables
2. Upload api/, admin/, template/ and cache/ to your web host
3. Fill in config.php with your database credentials
4. Visit admin/generate-key.php to generate your server API key
5. Drop HonestLeaderboard.cs into oxide/plugins/
6. Edit 3 lines in template/leaderboard.php — your URL, server ID, brand colour

Full step-by-step instructions with troubleshooting included in README.txt.

Security
SHA-256 hashed API keys — plain key is never stored
Steam64 ID validation on every push
PDO prepared statements — SQL injection proof
Plugin never touches your database directly — HTTP push only

Requirements
Rust server running Oxide/uMod or Carbon
Web host with PHP 8.0+ and MySQL (Hostinger, SiteGround etc. all work)
FTP access to upload files

Powered by Honest Leaderboards — by JCustoms
jcustoms.co.uk