Mercenary Ranks
$20.00
Sold by: WrecksMercenary Ranks – Reward your players based on an “XP” or Per Kill System, Now Featuring a Prestige System
- Description
- Reviews (0)
- Version History
- Discussions (0)
- Setup
- Product Enquiry
Description
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***
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.
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
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" } } }
Reviews (0)
Only logged in customers who have purchased this product may leave a review.
Version History
- Updated Adds support for ServerPanel by MEVENT. HOOK TO SHOW ACCOLADES - OPENMERCRANKSPANEL HOOK TO SHOW PRESTIGE - OPENMERCRANKSPRESTIGE
- Updated - Added Separate Webhook option for Prestige Gains. Will show that prestige Image in Discord. - Added /mrmax Command to set players with admin permission to tap rank for that prestige, useful for testing prestige rewards and icons.
- Updated Changed Command Conflicting with Skinbox
- Updated Discord Webhook Art
- Added an optional Prestige System, Gives Payout bonus % based on Prestige Rank, Items to give on Prestige and Commands to run on Prestige.
- Added UI to handle Prestige Progression, along with config options to pass lang key descriptions per Prestige Tier.
- Added a "Shadow Box" That unlocks for the player once Prestiged at least once. Shows Base Icon upon Prestige Acceptance, and Max Rank Icon if they max out the rank for the that Prestige.
- Added Small Easter Egg On Prestige Menu.
- Added Support for Scarecrow Kills
- Added * Added Rank Stepping when Xp req for Ranks in succession is the same.
- Updated * Simplified Methods
- Updated Cleanup
- Updated Cleanup, Added Config option to Auto Announce Top Mercs On Interval, Set to 0 To Disable.
- Added Added a "Hardcore Mode" Will Reset players Merc Rank on Death.
- Updated Updated Image URLS In Default CFG.
- Added /topmercs Command to list the Top 5 Merc Ranks on the server to the executor
- Updated Discord Embed Tweak, Economics Plugin Warning Message Fix.
- Added Discord Tracking of Rank Ups.
- Fixed Rank UI Toggling on, at Rank up, Even if it was disabled.
- Fixed Corrected SR Distribution.
- Fixed Hook Calling ImageLibrary for NRE on Boot.
- Updated Added option to enable or disable pvp kills towards count, also fixed global wipe to set data for all online players to 0 for both data sections instead of wiping file completely to keep ui from having a "blank" rank. Thank you @BLAZ15 for the test session.
- Added Config options to enable or disable rank up popup and global message on rank achieved.
- Updated Added the ability to configure Base Icon, Max rank icon, Rank up banner background, splash image and text. Added configuration options to setup rank counter ui position. Added configuration options to change out rank up, and payout sfx for Economics or Server Rewards.
- Fixed Fixed a "Rank Commands" Issue, Changed Level up sfx.
- Updated Adds UI Elements, Toggleable /RankUI that will track rank as the player progresses, Normal Skull Indicates there is more levels to unlock, Glowing Red Skull Shows they are at the Max. And a Pop up Rank Achieved Message that will fade in and out. Added ImageLibrary Dependency to file page.
- Fixed Incomplete Sentence on plugin missing message
- Updated Added Perms for specific groups to receive rank up items or commands.
- Updated Made payout bonus applicable to VIP perm.
- Added Initial Release.
Discussions (0)
Discussions
There are no discussions yet.
Leave a reply
Setup
Plugin FAQ – How do I use this .zip/.7z file I just purchased on my server?
• First, you want to unzip the file. You can do so by just double-clicking it to open, then drag the contents to the desired location (you may need to install an external unzipping software if you don’t already have one such as 7zip or winrar)
• Next you will find either a structure of folders or just the .cs file itself (it’s the actual plugin file itself).
• After that just install the .cs (plugin file) into your …/oxide/plugins/ folder where you will install plugins you ever need to.
Additionally, here’s a great video that easily covers adding a plugin to your server if you need! https://youtu.be/yWC_p97FhQA
• Installation is not included with any products on the site, however, if needed we may assist if you reach out to our support.
Currently all products on Lone.Design will be contained within a zipped file which is the .7z or .zip that you see. I believe windows 10 and up can unzip on its own without 3rd party tools, but in that case, if you’re unfamiliar with zipped files here are 2 programs I recommend to easily unzip zipped files.
Video On How to Zip and Unzip: https://youtu.be/Ep-L3PjBPCk (TechInsider Youtube Channel)
Zipping/Unzipping Tools
Winrar https://www.rarlab.com (I used to use for years, but works great!)
7zip https://www.7-zip.org/a/7z2107-x64.exe (the one I use currently)
Reviews
There are no reviews yet.