Description

Mercenary Ranks – Reward Your Players Based On XP Or Kills!

***DEPENDS ON IMAGE LIBRARY FOR UI TO WORK!!! THERE IS OPTIONS TO DISABLE UI AND COMMANDS TO DISABLE TO RANK COUNTER***

Server Panel

Adds support for ServerPanel by MEVENT.

HOOK TO SHOW ACCOLADES – OPENMERCRANKSPANEL

HOOK TO SHOW PRESTIGE – OPENMERCRANKSPRESTIGE

You can configure how many levels, and how many kills per level to grant your players a “Rank Up”

Messages show to chat that players Rank level upon Completion.

Pay your players via Economics, Server Rewards, Items or Customized Items, And even Commands.

Using the system needs the use permission.

Rank up can be logged to Discord.

Payout

The payout is as follows.

Rank 1, receives a payout of 1k if you set 1k as base pay grade.

Rank 2 receives a payout of 2k, and so on and so forth.

You can also set a bonus amount for VIPS based on percentage to reward your VIP with extra balance if wanted.

Rank Setup

When setting up Ranks, Be sure to have unique keys in incrementing values on the way up the ladder, Do not , for example set,  Rank 1-20 1 kill each, as the player will shoot straight to the last rank.

Increment like i have it in the config example. Plugin now handles stepping correctly. Unique keys are needed but kills can be the same amount.

Prestige Setup

This is optional, You can setup as many prestige ranks as you want.

Setup Item rewards and command rewards as a one off on prestige acceptance.

You can setup Lang Keys in the Lang File, To show Custom Descriptions per Prestige.

You can setup a Base Emblem and Max Rank Emblem, There is a “ShadowBox Feature, Which unlocks for the player once they prestige.”

This will Display Current Emblem Holdings and Max Rank Emblems if they maxed that Prestige.

https://youtu.be/7Rsv09NYTvE

Customization

There are fields in config where you can personalize your Base Icon, Max Rank Icon, Rank Up BG, Rank Up Image, And Rank Up Text Banner.

Doing this would take a bit of image editing software skills. In the config below I paste in The Alternate Theme I used in the screenshots.

You can Download the file links in config, and use the dimensions to make your own, It may take a bit of work but it is possible

If anyone needs help and needs a custom theme setup, feel free to message me on Discord – WrecksOnTheBeat

Command Setup

Target your player that ranks up with the {id} for the tag when running a command, ill also show you in config how to do this.

Commands

/topmercs – will print to the executor the top 5 merc ranks on the server

/wiperank “playername” – wipes data for that specific player

/mrwipe – will wipe data for everyone

/myrank – will display current rank if ranked, and how many kills to hit the next rank

/rankui – will display a UI with current rank in left hand corner (Custom Pos settings coming soon) Needs Use Perm

/MRPRESTIGE – OPTIONAL, THE RANK UI EMBLEM CAN BE USED AS A BUTTON TO OPEN THIS MENU. THIS OPENS THE PRESTIGE MENU

data clear commands need the admin perm.

Video Demos

https://youtu.be/MhqfkysN3hQ

LANG

{
  "RankUp": "[<color=#939393>Mercenary Ranks</color>] <color=#20f0a0>{0}</color> has reached Mercenary Rank <color=#20f0a0>{1}</color>",
  "RankCheck": "[<color=#939393>Mercenary Ranks</color>] Your current Rank: <color=#20f0a0>{0}</color> nTo rank up, Confirm <color=#20f0a0>{1}</color> Kill(s).",
  "NoRank": "[<color=#939393>Mercenary Ranks</color>] You are currently <color=#5ccdcd>Unranked</color>, in order to Rank Up, Confirm <color=#cd5c5c>{0}</color> Kill(s).",
  "RankMax": "[<color=#939393>Mercenary Ranks</color>] Your <color=#20f0a0>Rank</color> is at the highest Tier, Outstanding!",
  "PayoutEco": "[<color=#939393>Mercenary Payout</color>] Payment in the form of <color=#bb9b65>$</color><color=#85bb65>{0}</color> has been credited to your account.",
  "PayoutSR": "[<color=#939393>Mercenary Payout</color>] Payment in the form of <color=#5ccdcd>{0}</color> <color=#cd5c5c>RP</color> has been credited to your account.",
  "WipeData": "[<color=#939393>Mercenary Ranks</color>] <color=#5ccdcd>All</color> Player Data has been <color=#cd5c5c>Wiped</color>.",
  "WipePlayer": "[<color=#939393>Mercenary Ranks</color>] Player Data has been wiped for <color=#cd5c5c>{0}</color>.",
  "WipeFail": "[<color=#939393>Mercenary Ranks</color>] Player Data not found.",
  "NoPerms": "[<color=#939393>Mercenary Ranks</color>] You do not have the <color=#5ccdcd>Clearance</color> to run this <color=#cd5c5c>Command</color>.",
  "Hardcore": "[<color=#939393>Mercenary Ranks</color>] <color=#5ccdcd>Hardcore Mode</color> is Enabled, Your <color=#5ccdcd>Rank</color> Has been <color=#cd5c5c>Reset</color>.",
  "NotifyPrestige": "[<color=#939393>Mercenary Ranks</color>] You are currently able to Prestige, To enter Prestige, Click the Rank UI or Type <color=#cd5c5c>/MRPRESTIGE</color>.",
  "MaxPrestige": "Your <color=#5ccdcd>Prestige Rank</color> is at the Top Rank, Outstanding!",
  "LastPrestigeNotMaxRank": "You are at the final <color=#5ccdcd>Prestige</color> but still have Ranks to Complete!",
  "Prestige": "[<color=#939393>Mercenary Ranks</color>] You have reached Prestige Rank <color=#cd5c5c>{0}</color>.",
  "CannotPrestige": "You do not meet the requirements to Prestige, In order to Prestige, You need to reach the Max Rank of <color=#cd5c5c>{0}</color>",
  "Prestige1": "Welcome To Prestige 1n Upon Accepting, Your Rank will reset, but you will gain these Instant Rewards nADD IN LANG. nYou will also gain a payout percentage increase of ADD IN LANG",
  "Prestige2": "Welcome To Prestige 2n Upon Accepting, Your Rank will reset, but you will gain these Instant Rewards nADD IN LANG. nYou will also gain a payout percentage increase of ADD IN LANGnAdd More keys like this for more Prestige Levels"
}

CONFIG

{
  "Announce Top Mercs To Chat Every x Seconds": 3600,
  "Discord Webhook URL": "INSERTURLHERE",
  "UI Location (top right, top center, top left | left center, right center | bottom left)": "bottom left",
  "UI Base Icon": "https://www.dropbox.com/scl/fi/vz60n3lvqekn9abj5vywg/mriconbase2.png?rlkey=aqq27j36kyz6vi9qtmdth5bdm&dl=1",
  "UI Max Rank Icon": "https://www.dropbox.com/scl/fi/99jg9ztca9qpcui8mf4kn/mriconmax2.png?rlkey=qlp7bxy28gg1c7h56x5sbz2fr&dl=1",
  "Rank Up Background": "https://www.dropbox.com/scl/fi/7z4icxe54kigytu4fmbgv/Untitled.png?rlkey=yguxnrqxmgri5gyrkrdszg7il&dl=1",
  "Rank Up Main Image": "https://www.dropbox.com/scl/fi/ugd5b9x02d0bzg7spfh4q/mriconmax256.png?rlkey=k7o841nyzu66hrcwrmpd920c9&dl=1",
  "Rank Up Text Banner": "https://www.dropbox.com/scl/fi/i9jie4ueo69krotb4pnak/Rank-Up-Blue.png?rlkey=ikpj0vbfd1ibpz1ehjg9s5i45&dl=1",
  "Prestige Banner": "https://www.dropbox.com/scl/fi/m73enxmlaoba6zixl6v8g/PRESTIGEMENUBANNER.png?rlkey=ahtj2qm7y14gua43mwyvltwr5&st=cp73kax8&dl=1",
  "Accolades Banner": "https://www.dropbox.com/scl/fi/buoo5mzkcip98y0hu9vy4/ACC.png?rlkey=nwufwsl5svbyprhfm7r22ylbl&st=jhodfh4e&dl=1",
  "Prestige Main Text Color": "0.4745098 0.09803922 0.8627452 1",
  "Prestige Accept Text Color": "0.09803923 0.854902 0.7552722 1",
  "Prestige Close Text Color": "0.854902 0.5248789 0.09803923 1",
  "Current Prestige Text Color": "#20f0a0",
  "Next Prestige Text Color": "#20f0a0",
  "Prestige Text Font": "permanentmarker.ttf",
  "Rank Up SFX": "assets/prefabs/misc/halloween/lootbag/effects/gold_open.prefab",
  "Economics Payout SFX": "assets/prefabs/deployable/vendingmachine/effects/vending-machine-purchase-human.prefab",
  "Server Rewards Payout SFX": "assets/prefabs/deployable/dropbox/effects/submit_items.prefab",
  "Economics Enabled?": true,
  "Economics Payout Amount": 500,
  "Server Rewards Enabled?": false,
  "Server Rewards Payout Amount": 2000,
  "Payout Bonus Per Level For VIPS (%) (On top of PayGrade Increase)": 5,
  "Register Animal Kills Towards Rank?": true,
  "Register Player Kills?": false,
  "Hardcore Mode Enabled? (Resets Rank)": false,
  "Clear Ranks on Wipe?": true,
  "Kills Required Per Level": {
    "1": 1,
    "2": 2,
    "3": 3
  },
  "Enable Global Rank Up Messages?": true,
  "Enable Rank Up UI?": true,
  "Enable Rank Rewards?": false,
  "Rank Rewards": [
    {
      "Rank": 1,
      "Name": "Rank 1 Bonus",
      "Amount": 200,
      "SkinId": 3027539724,
      "ShortName": "scrap"
    },
    {
      "Rank": 2,
      "Name": "Semtex",
      "Amount": 3,
      "SkinId": 3031605679,
      "ShortName": "grenade.f1"
    }
  ],
  "Enable Rank Commands?": false,
  "Rank Commands": [
    {
      "Rank": 1,
      "Commands": [
        "givespitemto {id} 1 2863539914 Tome of Skill Points"
      ]
    },
    {
      "Rank": 2,
      "Commands": [
        "givespitemto {id} 2 2863539914 Tome of Skill Points"
      ]
    },
    {
      "Rank": 3,
      "Commands": [
        "givespitemto {id} 3 2863539914 Tome of Skill Points"
      ]
    },
    {
      "Rank": 13,
      "Commands": [
        "givespitemto {id} 4 2863539914 Tome of Skill Points"
      ]
    },
    {
      "Rank": 14,
      "Commands": [
        "givespitemto {id} 5 2863539914 Tome of Skill Points"
      ]
    },
    {
      "Rank": 15,
      "Commands": [
        "givespitemto {id} 6 2863539914 Tome of Skill Points"
      ]
    },
    {
      "Rank": 16,
      "Commands": [
        "givespitemto {id} 7 2863539914 Tome of Skill Points"
      ]
    },
    {
      "Rank": 17,
      "Commands": [
        "givespitemto {id} 8 2863539914 Tome of Skill Points"
      ]
    },
    {
      "Rank": 18,
      "Commands": [
        "givespitemto {id} 9 2863539914 Tome of Skill Points"
      ]
    },
    {
      "Rank": 19,
      "Commands": [
        "givespitemto {id} 10 2863539914 Tome of Skill Points"
      ]
    },
    {
      "Rank": 20,
      "Commands": [
        "givespitemto {id} 11 2863539914 Tome of Skill Points"
      ]
    }
  ],
  "Enable Prestige?": true,
  "Enable Prestige Rewards?": true,
  "Prestige Rewards": [
    {
      "PrestigeLevel": 1,
      "Name": "Prestige 1 Bonus",
      "Amount": 1000,
      "SkinId": 3027539724,
      "ShortName": "scrap"
    },
    {
      "PrestigeLevel": 2,
      "Name": "Prestige 2 Semtex",
      "Amount": 3,
      "SkinId": 3031605679,
      "ShortName": "grenade.f1"
    }
  ],
  "Enable Prestige Commands?": true,
  "Prestige Commands": [
    {
      "PrestigeLevel": 1,
      "Commands": [
        "inventory.giveto {id} rifle.ak 1"
      ]
    },
    {
      "PrestigeLevel": 2,
      "Commands": [
        "inventory.giveto {id} explosive.timed 20"
      ]
    }
  ],
  "Enable Prestige Payout Bonus?": true,
  "Payout Bonus Per Prestige Rank For (%)": {
    "1": {
      "BonusPercentage": 10,
      "PrestigeLangKey": "Prestige1",
      "PrestigeBaseIcon": "https://www.dropbox.com/scl/fi/wyro948zufsyv774n0psy/SkullPrestige1.png?rlkey=zjeu45p3vash0vv6yrdd7adun&st=d91uihf6&dl=1",
      "PrestigeMaxIcon": "https://www.dropbox.com/scl/fi/0fwewnp4nsgut3mro4bba/SkullPrestige1Max.png?rlkey=ncvukia59ixjx3ee2nuly72zt&st=89a26n6h&dl=1"
    },
    "2": {
      "BonusPercentage": 20,
      "PrestigeLangKey": "Prestige2",
      "PrestigeBaseIcon": "https://www.dropbox.com/scl/fi/fydbtc44bnwplgugmhn5w/BadgePrestige2.png?rlkey=q8rytweurnczvnk199gr6wbbi&st=d0gvsqzd&dl=1",
      "PrestigeMaxIcon": "https://www.dropbox.com/scl/fi/0wjijumgbur472p1b2q2u/BadgePrestige2Max.png?rlkey=27w8xxlyqiccpesg2cg5sq8fq&st=rrymoy9e&dl=1"
    }
  }
}