1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.

Player Ranks

Player ranks and stats database

Total Downloads: 4,120 - First Release: Mar 4, 2017 - Last Update: May 29, 2018

5/5, 19 likes
  1. Steenamaroo
    GUI with personal stats, leaderboard, and per-category stats.
    (Server-wide Top-List per category can be advertised on a timer.)

    *If you have just moved from single-page GUI version, to multipage GUI version, CLICK HERE*

    'Admin' commands are by permission

    oxide.grant user Steenamaroo playerranks.allowed

    By default, stats for admins are NOT publicised.

    Public Commands
    /pr – Displays GUI for the various stat pages.

    Admin Commands

    /pr save
    - Saves the database.
    /pr wipe – Wipes the database.
    /pr del <steamID> - Removes all stats for that player.
    /pr wipecategory <category> - Removes all of a user's stats for that category.*

    Main save and wipe are available by button in Admin GUI (/pr)

    Console Commands
    playerranks.save
    playerranks.wipe


    Config
    Options
    blockEvents
    – Enable/disable EventManager activity from contributing to ranks.
    useClans – Enable/disable clan-member kills from contributing to ranks.
    useFriendsAPI – Enable/disable friend kills from contributing to ranks.
    useRustIO - Enable/disable friend kills from contributing to ranks.
    allowadmin - True/False. Applies only to private and timed top lists.
    chatCommandAlias - choose your own alternative chat command.


    useTimedTopList – Enable/disable public top broadcast rotation.*
    TimedTopListAmount- Number of results. Default is 3.
    TimedTopListTimer – Frequency of Public-Top broadcasts, in minutes.
    TimedTopListSize - Font size for chat output.
    saveTimer - default is 15 minutes.
    statCollection - pauses collection of data.
    lastLoginLimit - in days. Deletes data for users who haven't logged in since X days ago. Value of 0 means disabled.
    useIntenseOptions – Enable/disable gathering of information, and displays, relating to:

    • StructuresBuilt,
    • ItemsDeployed,
    • ItemsCrafted,
    • EntitiesRepaired
    • StructuresDemolished
    • Resources Gathered

    GUI
    fontColor1/2/3 – Three options available, for title, message, and category.(Will rename soon)
    buttonColour
    guitransparency - 0.0 - 1.0
    Chat Command Alias
    - Default is "ranks". Change it to whatever you want.

    Categories
    There is a true/false for every category.
    These can be set via GUI, and prevents data for that category being displayed in-game.

    SQL
    Database Name
    Host
    Password
    Port
    Username
    tablename -
    Main data table name that PR will create.
    LBtableName - Leaderboards table name that PR will create.
    Use MySQL - true/false
    autoWipe - true/false (wipes SQL with main database)

    SQL database will be created on the first save, whether automatic or manual (/pr save)


    KeyBind
    Personal stats and leader board can be bound to toggle as follows,
    using H+J as examples.
    Code (Text):

    bind h callPersonalStatsUI
    bind j callLeaderBoardUI
     
    if you need to remove the bind, type
    Code (Text):
    bind j ""
    bind h ""



    Notes
    Data for banned players is automatically removed.

    Heli Kills are attributed to the player who hit the heli the most - not the last hitter.
    If a player dies from his wounds, the person who wounded him gets the PVP kill.
    PVP distance is recorded based on the wounding shot.
    Lang file is created for custom messages.
    Category list
    Code (Text):

    [*]PVPKills
    [*]PVPDistance
    [*]PVEKills
    [*]PVEDistance
    [*]NPCKills
    [*]NPCDistance
    [*]Sleepers Killed
    [*]HeadShots
    [*]Deaths
    [*]Suicides
    [*]KDR
    [*]SDR
    [*]SkullsCrushed
    [*]TimesWounded
    [*]TimesHealed
    [*]HeliHits
    [*]HeliKills
    [*]APC Hits
    [*]APCKills
    [*]BarrelsDestroyed
    [*]Explosives Thrown
    [*]Arrows Fired
    [*]Bullets Fired
    [*]Rockets Launched
    [*]WeaponTrapsDestroyed
    [*]Drops looted
    [*]Structures Built
    [*]Structures Demolished
    [*]Items Deployed
    [*]Items crafted
    [*]Entities Repaired
    [*]Resources Gathered
    [*]Structures Upgraded

    <MySQL only>
    Economics**
    PlayTime**
    Online/Offline Status**
    ActiveDate - Player's last login date.
     
    ** - These options are reported by PlayerRanks, but not incremented or maintained by PlayerRanks.
    Resetting PlayerRanks database will not set these entires to zero, as they are read from elsewhere.
    Wipe PlaytimeTracker data and/or Economics data to set these to zero.

    DONATIONS.

    Upcoming Changes.
    UI enabled for players - True/False (for web use only)
    Full Clans support - All player lists to be duplicated for clans.

    oxideimagePR.PNG