Skip to content

SourceMod Profile Plugin

gokz-top-profile replaces the legacy gokz-profile runtime plugin while keeping the gokz-profile library and GOKZ_PF_GetRank native available for existing SourceMod consumers.

Requirements

  • gokz-top-core must be installed and configured.
  • gokz_top_api_base_url must point at the GOKZ.TOP API.
  • Optional: gokz-chat enables chat rank tags.

Commands

  • !profile / !p opens a player's profile menu.
  • !profileoptions / !pfo opens profile tag options.
  • !ranks prints the legacy rank thresholds for the current mode.
  • !rating prints the player's current rating, rank, and level.

Data Source

The plugin reads leaderboard data from GET /v1/leaderboards/players/{steamid64}?scope=... through gokz-top-core.

Mode scopes:

  • VNL uses scope=VNL
  • SKZ uses scope=SKZ
  • KZT uses scope=KZT
  • NKZ display modes should use KZT leaderboard data when present in the server's GOKZ mode set

The profile menu shows scope, legacy rank, rating, global and regional leaderboard ranks, region, and total points. Legacy detailed points and completion submenus are intentionally not reproduced because those fields are not part of the v2 leaderboard-rank response.

Legacy Coexistence

On startup, gokz-top-profile attempts to unload gokz-profile.smx and move it from addons/sourcemod/plugins/ to addons/sourcemod/plugins/disabled/. It does not modify legacy source or config files.