KitsuneLab©

K4-LevelRanks

A comprehensive ranking and statistics system for Counter-Strike 2. Features point-based progression, detailed player statistics, weapon tracking, and LVL Ranks database compatibility.

Important notice!

[!IMPORTANT]
K4ryuu is the creator of this plugin. Since he is no longer maintaining his CS2 plugins, I forked some of them and maintain them ONLY FOR BUG FIXES!

Features

Ranking System

• Point-based progression with fully customizable point values
• Dynamic point multipliers based on victim/attacker point ratio
• Customizable ranks with colors, tags, and point thresholds
• LVL Ranks database compatible - works with existing databases
• Fake competitive ranks - Premier, Competitive, Wingman, or custom icon ranks

Statistics Tracking

• Combat stats: Kills, deaths, assists, headshots, K/D ratio, accuracy
• Round stats: Wins, losses, rounds played, MVP awards
• Game stats: Match wins, losses, games played
• Playtime tracking with optional point rewards

Weapon Statistics (Optional Module)

• Per-weapon kills, deaths, headshots
• Shots fired, hits, accuracy per weapon
• Damage dealt per weapon

Hit Statistics (Optional Module)

• Hitbox/body part tracking (ExStats Hits compatible)
• Damage distribution by body region
• Head, chest, stomach, arms, legs tracking

Point Events

Scoreboard Integration

• Clan tag ranks - Show rank in player's clan tag
• Score sync - Sync scoreboard score with points
• Competitive rank display - Premier, Competitive, Wingman, or custom ranks

VIP Support

• Point multiplier for VIP players
• Configurable permission flags

Developer API

• Shared API for other plugins (K4LevelRanks.Api.v1)
• Access player data, points, ranks programmatically

Dependencies

• SwiftlyS2: Server plugin framework for Counter-Strike 2
• Database: One of the following supported databases:
  • MySQL / MariaDB - Recommended for production
  • PostgreSQL - Full support
  • SQLite - Great for single-server setups

(back to top)

Installation

1. Install SwiftlyS2 on your server
2. Configure your database connection in SwiftlyS2's database.jsonc (MySQL, PostgreSQL, or SQLite)
3. Download the latest release
4. Extract to your server's swiftlys2/plugins/ directory
5. Configure the plugin files in swiftlys2/configs/plugins/k4.levelranks/
6. Restart your server - database tables will be created automatically

(back to top)

Configuration Files

config.json - Main Settings

points.json - Point Values

Fully customizable point values for all events. Set to 0 to disable any event.

ranks.json - Rank Configuration

{
  "Ranks": [
    { "Name": "Silver I", "Tag": "[S1]", "Color": "GRAY", "Points": 0 },
    { "Name": "Gold Nova I", "Tag": "[GN1]", "Color": "GOLD", "Points": 1000 },
    { "Name": "Global Elite", "Tag": "[GE]", "Color": "YELLOW", "Points": 5000 }
  ]
}

modules.json - Optional Features

(back to top)

Commands

Player Commands

Admin Commands

(back to top)

Database Structure

The plugin uses LVL Ranks compatible database tables:

• lvl_base - Main player statistics
• lvl_base_settings - Player preferences
• lvl_base_weapons - Weapon statistics (optional)
• lvl_base_hits - Hit statistics (optional)

Supported Databases

Migration from LVL Ranks: Simply point the plugin to your existing MySQL database - no migration needed!

Automatic Schema Management: The plugin uses FluentMigrator to automatically create and update database tables. Optional modules (WeaponStats, HitStats) only create their tables when enabled.

(back to top)

License

Distributed under the GPL-3.0 License. See LICENSE.md for more information.

(back to top)