SF Leaderboard + Kill Streak Rewards/Shop System

SF Leaderboard

SF Leaderboard is a clean, server-friendly player stats leaderboard gives servers an easy way to track performance, display progression, and let players compare themselves against the rest of the population without cluttering the game with nonsense.

The mod focuses on practical information, strong readability, and server-side control. It tracks combat and progression stats, stores them in JSON, supports offline player records, and displays everything in a configurable in-game leaderboard UI. Server owners can decide exactly what gets shown, how it is ordered, how it looks, and how extra custom entities should be classified.

This was built with flexibility in mind. If you want a simple leaderboard that just works, you can leave the defaults alone. If you want to tune the entire thing around your own server style, stat priorities, colours, and custom classname detection, you can do that too.

Main Features

• Tracks player performance stats in a persistent JSON database
• In-game leaderboard UI with sortable columns
• Supports offline player data display.
• Configurable visible columns
• Configurable column order
• Tracks page-based leaderboard browsing
• Tracks online/offline player state in the leaderboard
• Highlights the current (your stats) player in the main table
• Includes a separate current-player summary section
• Style settings for colours, text, and layout appearance
• Supports custom classname token lists for AI, animal, and zombie detection
• Built to let server owners disable stats they do not want shown
• Uses stored player data so long-term progression can be displayed over time
• Discord Webhook

Kill Streak Rewards
A built-in Kill Streak Reward on x Kill milestones has now been added to the mod. This also includes a configurable reward crate that can also spawn. This can be toggled on or off. New features are:

- Configurable currency: Use whatever you want, just set it within the settings file
- Set number of kill streaks including reward milestones for Zombies, AI, Players and Animals
- Configurable crate and cash rewards for kill streaks
- Configurable notification telling players they have been awarded, including notification for in their inventory is full
- Notificaiton telling players of crate spawn and how close they are
- Toggable serwide notificaiton for kill streaks

Simple Cash Rewards
A built-in cash reward system has been added. Set the number of kills for Players, Zombies, Animals, AI for a cash reward. If you set 5 kills, players will recieve the cash reward every 5 kills.

Points/Rewards/Shop System Addition
A built-in points and rewards system with shop has now been added to the mod. This can be toggled on or off. New features are:

• Earn points for all kills
• Fully configurable points settings
• Persistent player points tracking
• Built-in reward shop (GUI Will be improved in later versions). Shop interface is also interactable with mouse
• Configurable reward crates
• Configurable single reward items
• Server owner friendly setup

Admin Menu
A built-in Admin menu has now been added to the mod. It has the following features:

• Wipe Player leaderboard data
• Wipe Player Points
• Award Player Points
• Award players an item from the shop
• Configure all settings files from the leaderboard
• All settings will live reload back to the server when saved to prevent the need for a server restart
• Add an admin via the newly created permissions folder, where you need to add the steamid

Tracked Stats

Depending on what is enabled in the settings, the leaderboard can display:

• Zombie Kills
• Animal Kills
• AI Kills
• Player Kills
• Deaths
• Player Deaths
• Shots Fired
• Shots Hit
• Headshots
• Headshot Percentage
• Distance Travelled
• Longest Shot
• Accuracy
• K/D

Why use this mod

A lot of leaderboard mods either look messy, feel bolted together, or give server owners almost no real control over what is shown. SF Leaderboard is built to avoid that.

It gives you a readable leaderboard for players, while still giving the server owner proper control over behaviour and styling. The result is something that can fit a hardcore server, a PvP server, a PvE server, or a mixed environment without forcing the same layout and priorities on everybody.

If you run a long-term server, this also gives your player base something extra to chase. Kill counts, accuracy, distance travelled, longest shot, and K/D all become part of the server identity instead of vanishing into the void every session.

Customisation Breakdown

Server owners can customise:

• Custom leaderboard title
• Which stats are enabled or disabled
• The order columns appear in
• The default sort behaviour
• The colours used for the UI
• Header, table, footer, and row colours
• Online player name colour
• Offline player name colour
• Local player row highlight colour
• Current-player summary section colour
• The leaderboard title text
• Info text shown in the UI
• Detection tokens for custom AI, animal, and zombie classnames

This means if your server uses custom NPCs, custom infected, or modded wildlife and some of them are not being counted correctly, you can add missing classname tokens in the settings instead of having to rewrite the whole system.


Current Player Summary

The mod includes a separate highlighted section for the player currently viewing the leaderboard. This gives players a quick way to see their own current standing without having to hunt through the table manually.

That summary section follows the same visible columns and updates with the same current sorting logic, so it stays consistent with the main leaderboard instead of showing some random stripped-down version.


Offline Player Support

The leaderboard can read stored player records from the player database folder, which allows stats to remain visible even when players are offline. This is useful for persistent communities where server identity and long-term progression matter more than just who happens to be online at that exact moment.


Style and Visual Control

The leaderboard was built to be readable in actual gameplay, not just in screenshots. Backgrounds, row colours, text colours, and highlight colours can all be adjusted through the style settings so server owners can make it fit their own server branding or preferred level of contrast.

Whether you want a clean dark tactical look, a brighter PvP server presentation, or something themed to match your server identity, the style settings make that possible without code edits.

Donate

If you would like to donate to support development of more mods:
Paypal - Buy Me A Coffee

Repacking

You can repack this mod into your own server packs. All i request is that you credit the mod within your description.

Discord
For any Mod issues, feedback or suggestions head to my discord below and open a ticket.
Discord Link