Honest Leaderboards v1.0

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


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 Referral 'Hostinger' (Hostinger, SiteGround etc. all work)
• FTP access to upload files