Brasiliannut's Wishlist

This plugin will add Caravans to your server that will attempt to transport valuable loot along the roads. Carriages are used to transport goods along the roads as configured, pulled by Horses. These convoys are accompanied by NPCs, Riders, and Balloons! By default, the plugin comes with 3 different caravan presets.
The easiest caravan will be fun for early wipe and allows some basic loot for low effort Caravan raids. In order to rob the most difficult caravan, players will need to be tactical about their ambush and it will be much more challenging! The road selection system can make the Caravan less predictable as the NPCs try to find a safe route.
The Caravan can traverse any road type, including good old country dirty roads. You can set up timers for each preset in the config file, to keep the more difficult Caravan from showing up until later in a wipe!
 

Riders
These can be very dangerous opponents! Unlike regular NPCs, they will quickly close the gap continually shooting at the players as they ride! Riders can be especially effective using short ranged weapons, they are deadly with a shotgun!

 
Balloons
These are mobile sniper towers on which several NPCs can be placed. In the config, armor can be added to the balloon, greatly increasing the protection for the Caravan snipers.When the caravan stops, Balloons will start moving around randomly, making it more difficult for players to hide! After defeating all of the snipers, Balloons will fall to the ground and explode.  

 
Required Dependency (must install this free plugin)
NpcSpawn  – link is included and can be found in the ReadMe file included with download  
Chat commands (admin only)
/caravanstart - launches the event using a random preset based on your configuration /caravanstart PresetName - add the name of a preset from the configuration to launch a specific preset /caravanstop - stops the event /caravanroadblock - the event will not be held on the road where you are standing (clear the Blocked roads section of config when you change maps) /caravanpathstart - stand at starting point and enter command to start recording a custom route /caravanpathsave RoutePresetName - to save a custom route (enter anything you'd like in place of RoutePresetName) /caravanpathcancel - to reset the route  
Console commands (RCON only)
caravanstart - launches the event using a random preset based on your configuration caravanstart PresetName - add the name of a preset from the configuration to launch a specific preset caravanstop - stops the event  
Plugin Config
en  –  example of plugin configuration in English ru  –  example of plugin configuration in Russian  
Hooks
void OnCaravanStart() - Сalled when a caravan appears void OnCaravanStop() - Сalled when a caravan disappears void OnCaravanStartMoving(Vector3 position) - Called when the caravan starts moving void OnCaravanStopMoving(Vector3 position) - Called when the caravan stops moving void OnCaravanEventWin(ulong userId)  
Check out the rest of my work: Adem's Codefling Library
You can reach out to me in Discord: Adem's Discord Profile
Thanks to Jbird for writing, translation, & support: Jbird's Discord Profile
Join the Mad Mappers Discord!
 

Revolutionary cases, the juiciest interface, scroll animations and much more!
 

 
 
Features
Beautiful user interface Opening animation Performance Each case is configured separately  
Commands
cases (open cases interface) givecase <steamid> <caseid> <amount>   (give a case to the player) givecase * <caseid> <amount>   (give a case to all online players)  
FAQ
Q: Where can I see an example of a config?
A:    Config
Q:  How do I use Economics to pay for cases?
A:  
"Economy": { "Show Balance": true, "Type (Plugin/Item)": "Plugin", "Plugin name": "Economics", "Balance add hook": "Deposit", "Balance remove hook": "Withdraw", "Balance show hook": "Balance", "ShortName": "scrap", "Display Name (empty - default)": "", "Skin": 0 }, Q:  How do I use ServerRewards to pay for cases?
A:  
"Economy": { "Show Balance": true, "Type (Plugin/Item)": "Plugin", "Plugin name": "ServerRewards", "Balance add hook": "AddPoints", "Balance remove hook": "TakePoints", "Balance show hook": "CheckPoints", "ShortName": "scrap", "Display Name (empty - default)": "", "Skin": 0 }, Q: I have a question/problem. What should I do?
A: You can write to me in a PM on the site, create a ticket. Or write me in Discord: mevent
Q:  How does a player give out Skill Tree XP?
A:  
{ "Type": "Command", "ID": 7, "Image": "", "Title": "Give 1K XP from SkillTree", "Command (%steamid%)": "givexp %username% 1000", "Plugin": { "Hook": null, "Plugin name": null, "Amount": 0 }, "Display Name (empty - default)": "", "ShortName": "", "Skin": 0, "Amount": 1, "Chance": 65.0 }, Q: How can I add cases not for purchase, but just to have them?
A: For example, if you give cases with the "givecase" command:  
givecase <steamid> <caseid> <amount>  give a case to the player givecase * <caseid> <amount>  give a case to all online players

I present to your attention the Case plugin.
Add variety to your server and additional emotions for your players.
Pleasant design, installation of visual design for the rarity of items, support for the economy, the ability to open and buy several cases at once (up to 5), the ability to sell an item, support for custom items and bill of lading teams, the ability to set a daily limit for the issuance of items from the inventory of cases.
The plugin includes an already configured configuration with 52 items and 4 cases, with a customized drop chance and a customized rarity color.
 
 
 
 
ISSUING A BALANCE
If you use the default economy of the case plugin, then with this command you can give a certain player the specified balance
UI_CASES GIVEBALANCE STEAMID AMOUNT   STEAMID - specify the steamid of the player if you enter the command manually in the server console
AMOUNT - specify the balance that the player should receive on his balance
 
CONFIGURING THE PLUGIN AND ITS FEATURES.
To configure the plug-in language and configuration, select the desired option in the plug-in file on line 22:
private const bool isEn = true; - for configuration with English
private const bool isEn = false; - for configuration with Russian language
 
THE LIMIT ON THE ISSUE OF ITEMS.
If you do not want players to abuse this plugin, then you can limit the number of items they can take per day, then use the following options:
"Should I use the item issue limit?": - set true to enable the feature, or false to disable
"Setting up privileges for the item issue limit":
"casesystem.default": 5, - if you have enabled the limit, then do not forget to grant this privilege to the default group
"casesystem.vip": 7 - Extend the limit for certain players or groups with this privilege
if you want to expand the list of privileges, then just add them separated by commas, specifying the unique privilege and the required amount of item that they can receive, for example
"cases.example": 10
 
ECONOMICS.
You can use both the default balance of the plug-in, for which players can buy cases, and the economy plug-in to choose from
"Economics Plugin(1 - Economics, 2 - Server Rewards, 3 - IQEconomic, 4 - Bank System, 5-Cases)":  
just specify the number that corresponds to the economy plugin
 
THE RARITY OF THE ITEMS.
Set the parameters you need for the rarity of the items and the color that will display this or that item in the list.
"Color adjustment(chance-color)": {
"15": "0.8352942 0.3607843 0.4039216 1", - items with a chance of falling from 0 to 15 will be tinted with RGB color "0.8352942 0.3607843 0.4039216 1"
"40": "0.7450981 0.3921569 0.8156863 1", - items with a chance of falling from 16 to 40 will be tinted with RGB color "0.7450981 0.3921569 0.8156863 1"
"60": "0.5058824 0.3137255 0.8235295 1", - items with a chance of falling from 41 to 60 will be tinted with RGB color "0.8352942 0.3607843 0.4039216 1"
"80": "0.2588235 0.4588236 0.8470589 1", - items with a chance of falling from 61 to 80 will be tinted with RGB color "0.5058824 0.3137255 0.8235295 1"
"100": "0.3215686 0.5058824 0.7215686 1" - items with a chance of falling from 81 to 100 will be colored with RGB color "0.3215686 0.5058824 0.7215686 1"
},
 
A LIST OF ITEMS AND THEIR SETTINGS.
Set up a list of items that will be indicated in the cases you need in the future.
"Item ID (Indicated in the list of items in the case)": "1",   - is the ID of the item, which will later need to be specified in the case that you will configure. THE ID MUST NOT BE REPEATED  
"Shortname": "minigun", - shortname of the item from the game
"Amount": 1, - number of items to be given after opening
"Drop chance": 2, - chance of dropping the item (from 0% to 100%)
"Name the item": "", - custom name item (if you use SkinID)
"Price the item": 100, - the value of the item, if the player decides to sell it, after it falls to him
"URL image the item": "", - link to the product image. leave the field empty if you want to use the standard image of the item, or you want to use the item + skinid
"SkinID ": 0, - the ID of the item skin from Steam workshop, if you want to use a custom item. if you are using skinid, make sure that the URL image the item field is empty
"Console command": "" - the console command that will be executed when the item is activated after the player takes it from the inventory of cases
 
A LIST OF CASES AND THEIR CONFIGURATION.
Set up a list of cases available to players.
"Case ID": - unique case ID (must not be repeated)
"Case name": - the name of the case, which will be displayed in the button with the list of cases and on the page of the open case
"Image of the case": - a picture of the case, which will be displayed on the page with the list of cases and on the page of the open case
"Description of the case": - a description of the case, which will be displayed on the page of the open case
"Price of the case": - the cost of the case, which will be deducted from the player's balance when his purchase
"List the case items": - here are the IDs of the items that were configured in the list of awards. Specify only the unique ID of the item you want to use
 
If you are having difficulty configuring the plugin or you have suggestions for improving it, then you can safely write to me in private messages in Discord
xacku.mapping
DEFAULT CONFIG
 
{ "Should I use the item issue limit?": false, "Setting up privileges for the item issue limit": { "casesystem.default": 5, "casesystem.vip": 7 }, "Economics Plugin(1 - Economics, 2 - Server Rewards, 3 - IQEconomic, 4 - Bank System, 5-Cases)": 5, "Color adjustment(chance-color)": { "15": "0.8352942 0.3607843 0.4039216 1", "40": "0.7450981 0.3921569 0.8156863 1", "60": "0.5058824 0.3137255 0.8235295 1", "80": "0.2588235 0.4588236 0.8470589 1", "100": "0.3215686 0.5058824 0.7215686 1" }, "List of awards": [ { "Item ID (Indicated in the list of items in the case)": "1", "Shortname": "minigun", "Amount": 1, "Drop chance": 2, "Name the item": "", "Price the item": 100, "URL image the item": "https://rustlabs.com/img/items180/minigun.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "2", "Shortname": "lmg.m249", "Amount": 1, "Drop chance": 5, "Name the item": "", "Price the item": 75, "URL image the item": "https://rustlabs.com/img/items180/lmg.m249.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "3", "Shortname": "hmlmg", "Amount": 1, "Drop chance": 10, "Name the item": "", "Price the item": 60, "URL image the item": "https://rustlabs.com/img/items180/hmlmg.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "4", "Shortname": "rifle.l96", "Amount": 1, "Drop chance": 15, "Name the item": "", "Price the item": 50, "URL image the item": "https://rustlabs.com/img/items180/rifle.l96.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "5", "Shortname": "rifle.lr300", "Amount": 1, "Drop chance": 35, "Name the item": "", "Price the item": 40, "URL image the item": "https://rustlabs.com/img/items180/rifle.lr300.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "6", "Shortname": "rifle.ak", "Amount": 1, "Drop chance": 35, "Name the item": "", "Price the item": 40, "URL image the item": "https://rustlabs.com/img/items180/rifle.ak.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "7", "Shortname": "rifle.sks", "Amount": 1, "Drop chance": 30, "Name the item": "", "Price the item": 50, "URL image the item": "https://rustlabs.com/img/items180/rifle.sks.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "8", "Shortname": "rifle.bolt", "Amount": 1, "Drop chance": 30, "Name the item": "", "Price the item": 40, "URL image the item": "https://rustlabs.com/img/items180/rifle.bolt.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "9", "Shortname": "smg.mp5", "Amount": 1, "Drop chance": 50, "Name the item": "", "Price the item": 30, "URL image the item": "https://rustlabs.com/img/items180/smg.mp5.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "10", "Shortname": "rifle.semiauto", "Amount": 1, "Drop chance": 55, "Name the item": "", "Price the item": 20, "URL image the item": "https://rustlabs.com/img/items180/rifle.semiauto.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "11", "Shortname": "smg.thompson", "Amount": 1, "Drop chance": 60, "Name the item": "", "Price the item": 25, "URL image the item": "https://rustlabs.com/img/items180/smg.thompson.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "12", "Shortname": "pistol.m92", "Amount": 1, "Drop chance": 70, "Name the item": "", "Price the item": 20, "URL image the item": "https://rustlabs.com/img/items180/pistol.m92.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "13", "Shortname": "pistol.prototype17", "Amount": 1, "Drop chance": 70, "Name the item": "", "Price the item": 30, "URL image the item": "https://rustlabs.com/img/items180/pistol.prototype17.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "14", "Shortname": "pistol.semiauto", "Amount": 1, "Drop chance": 75, "Name the item": "", "Price the item": 15, "URL image the item": "https://rustlabs.com/img/items180/pistol.semiauto.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "15", "Shortname": "pistol.python", "Amount": 1, "Drop chance": 80, "Name the item": "", "Price the item": 20, "URL image the item": "https://rustlabs.com/img/items180/pistol.python.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "16", "Shortname": "pistol.revolver", "Amount": 1, "Drop chance": 95, "Name the item": "", "Price the item": 5, "URL image the item": "https://rustlabs.com/img/items180/pistol.revolver.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "17", "Shortname": "electric.generator.small", "Amount": 1, "Drop chance": 5, "Name the item": "", "Price the item": 150, "URL image the item": "https://rustlabs.com/img/items180/electric.generator.small.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "18", "Shortname": "workbench3", "Amount": 1, "Drop chance": 10, "Name the item": "", "Price the item": 35, "URL image the item": "https://rustlabs.com/img/items180/workbench3.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "19", "Shortname": "workbench2", "Amount": 1, "Drop chance": 10, "Name the item": "", "Price the item": 30, "URL image the item": "https://rustlabs.com/img/items180/workbench2.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "20", "Shortname": "autoturret", "Amount": 1, "Drop chance": 15, "Name the item": "", "Price the item": 30, "URL image the item": "https://rustlabs.com/img/items180/autoturret.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "21", "Shortname": "door.double.hinged.toptier", "Amount": 1, "Drop chance": 25, "Name the item": "", "Price the item": 20, "URL image the item": "https://rustlabs.com/img/items180/door.double.hinged.toptier.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "22", "Shortname": "door.hinged.toptier", "Amount": 1, "Drop chance": 25, "Name the item": "", "Price the item": 15, "URL image the item": "https://rustlabs.com/img/items180/door.hinged.toptier.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "23", "Shortname": "furnace.large", "Amount": 1, "Drop chance": 35, "Name the item": "", "Price the item": 10, "URL image the item": "https://rustlabs.com/img/items180/furnace.large.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "24", "Shortname": "small.oil.refinery", "Amount": 1, "Drop chance": 35, "Name the item": "", "Price the item": 10, "URL image the item": "https://rustlabs.com/img/items180/small.oil.refinery.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "25", "Shortname": "water.catcher.small", "Amount": 1, "Drop chance": 45, "Name the item": "", "Price the item": 8, "URL image the item": "https://rustlabs.com/img/items180/water.catcher.small.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "26", "Shortname": "storage_barrel_b", "Amount": 1, "Drop chance": 45, "Name the item": "", "Price the item": 10, "URL image the item": "https://rustlabs.com/img/items180/storage_barrel_b.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "27", "Shortname": "storage_barrel_c", "Amount": 1, "Drop chance": 45, "Name the item": "", "Price the item": 10, "URL image the item": "https://rustlabs.com/img/items180/storage_barrel_c.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "28", "Shortname": "gunrack_stand", "Amount": 1, "Drop chance": 45, "Name the item": "", "Price the item": 5, "URL image the item": "https://rustlabs.com/img/items180/gunrack_stand.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "29", "Shortname": "gunrack_wide.horizontal", "Amount": 1, "Drop chance": 55, "Name the item": "", "Price the item": 5, "URL image the item": "https://rustlabs.com/img/items180/gunrack_wide.horizontal.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "30", "Shortname": "flameturret", "Amount": 1, "Drop chance": 65, "Name the item": "", "Price the item": 10, "URL image the item": "https://rustlabs.com/img/items180/flameturret.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "31", "Shortname": "furnace", "Amount": 1, "Drop chance": 75, "Name the item": "", "Price the item": 5, "URL image the item": "https://rustlabs.com/img/items180/furnace.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "32", "Shortname": "cupboard.tool.retro", "Amount": 1, "Drop chance": 75, "Name the item": "", "Price the item": 5, "URL image the item": "https://rustlabs.com/img/items180/cupboard.tool.retro.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "33", "Shortname": "rocket.launcher", "Amount": 1, "Drop chance": 10, "Name the item": "", "Price the item": 50, "URL image the item": "https://rustlabs.com/img/items180/rocket.launcher.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "34", "Shortname": "ammo.rocket.basic", "Amount": 1, "Drop chance": 15, "Name the item": "", "Price the item": 35, "URL image the item": "https://rustlabs.com/img/items180/ammo.rocket.basic.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "35", "Shortname": "ammo.rocket.mlrs", "Amount": 1, "Drop chance": 15, "Name the item": "", "Price the item": 30, "URL image the item": "https://rustlabs.com/img/items180/ammo.rocket.mlrs.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "36", "Shortname": "ammo.rocket.hv", "Amount": 1, "Drop chance": 25, "Name the item": "", "Price the item": 20, "URL image the item": "https://rustlabs.com/img/items180/ammo.rocket.hv.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "37", "Shortname": "ammo.grenadelauncher.he", "Amount": 1, "Drop chance": 30, "Name the item": "", "Price the item": 25, "URL image the item": "https://rustlabs.com/img/items180/ammo.grenadelauncher.he.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "38", "Shortname": "multiplegrenadelauncher", "Amount": 1, "Drop chance": 35, "Name the item": "", "Price the item": 25, "URL image the item": "https://rustlabs.com/img/items180/multiplegrenadelauncher.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "39", "Shortname": "ammo.rifle.explosive", "Amount": 1, "Drop chance": 50, "Name the item": "", "Price the item": 10, "URL image the item": "https://rustlabs.com/img/items180/ammo.rifle.explosive.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "40", "Shortname": "explosive.satchel", "Amount": 1, "Drop chance": 60, "Name the item": "", "Price the item": 10, "URL image the item": "https://rustlabs.com/img/items180/explosive.satchel.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "41", "Shortname": "grenade.beancan", "Amount": 1, "Drop chance": 70, "Name the item": "", "Price the item": 5, "URL image the item": "https://rustlabs.com/img/items180/grenade.beancan.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "42", "Shortname": "rocket.launcher.dragon", "Amount": 1, "Drop chance": 5, "Name the item": "", "Price the item": 50, "URL image the item": "https://rustlabs.com/img/items180/rocket.launcher.dragon.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "43", "Shortname": "coffin.storage", "Amount": 1, "Drop chance": 10, "Name the item": "", "Price the item": 40, "URL image the item": "https://rustlabs.com/img/items180/coffin.storage.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "44", "Shortname": "legacyfurnace", "Amount": 1, "Drop chance": 15, "Name the item": "", "Price the item": 30, "URL image the item": "https://rustlabs.com/img/items180/legacyfurnace.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "45", "Shortname": "hobobarrel", "Amount": 1, "Drop chance": 25, "Name the item": "", "Price the item": 30, "URL image the item": "https://rustlabs.com/img/items180/hobobarrel.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "46", "Shortname": "heavyscientistyoutooz", "Amount": 1, "Drop chance": 35, "Name the item": "", "Price the item": 20, "URL image the item": "https://rustlabs.com/img/items180/heavyscientistyoutooz.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "47", "Shortname": "hazmatyoutooz", "Amount": 1, "Drop chance": 35, "Name the item": "", "Price the item": 20, "URL image the item": "https://rustlabs.com/img/items180/hazmatyoutooz.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "48", "Shortname": "cursedcauldron", "Amount": 1, "Drop chance": 60, "Name the item": "", "Price the item": 15, "URL image the item": "https://rustlabs.com/img/items180/cursedcauldron.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "49", "Shortname": "abovegroundpool", "Amount": 1, "Drop chance": 75, "Name the item": "", "Price the item": 10, "URL image the item": "https://rustlabs.com/img/items180/abovegroundpool.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "50", "Shortname": "rail.road.planter", "Amount": 1, "Drop chance": 80, "Name the item": "", "Price the item": 5, "URL image the item": "https://rustlabs.com/img/items180/rail.road.planter.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "51", "Shortname": "wall.graveyard.fence", "Amount": 1, "Drop chance": 85, "Name the item": "", "Price the item": 5, "URL image the item": "https://rustlabs.com/img/items180/wall.graveyard.fence.png", "SkinID ": 0, "Console command": "" }, { "Item ID (Indicated in the list of items in the case)": "52", "Shortname": "newyeargong", "Amount": 1, "Drop chance": 95, "Name the item": "", "Price the item": 10, "URL image the item": "https://rustlabs.com/img/items180/newyeargong.png", "SkinID ": 0, "Console command": "" } ], "Cases": [ { "Case ID": "1", "Case name": "Armory", "Image of the case": "https://unityplugincore.ru/imgs/images/2024/09/23/ORUZEINYI.png", "Discription of the case": "There will be a description of your case here", "Price of the case": 100, "List the case items": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16" ] }, { "Case ID": "2", "Case name": "Home", "Image of the case": "https://unityplugincore.ru/imgs/images/2024/09/23/DOMASNII.png", "Discription of the case": "There will be a description of your case here", "Price of the case": 125, "List the case items": [ "17", "18", "19", "20", "21", "22", "23", "27", "28", "26", "27", "28", "29", "30", "31", "32" ] }, { "Case ID": "3", "Case name": "Raider", "Image of the case": "https://unityplugincore.ru/imgs/images/2024/09/23/REIDERSKII.png", "Discription of the case": "There will be a description of your case here", "Price of the case": 150, "List the case items": [ "33", "34", "35", "36", "37", "38", "39", "40", "41" ] }, { "Case ID": "4", "Case name": "DLC", "Image of the case": "https://unityplugincore.ru/imgs/images/2024/09/23/DLS.png", "Discription of the case": "There will be a description of your case here", "Price of the case": 150, "List the case items": [ "42", "43", "44", "45", "46", "47", "48", "49", "50", "51", "52" ] } ] }  

Introducing UltimateLeaderboard, the most advanced and comprehensive leaderboard system designed for Rust servers! Elevate your server competitive spirit by tracking an extensive range of player statistics—everything from kills and deaths to resources gathered, items crafted, structures built, and more. Featuring a sleek, customizable user interface and seamless integration with popular plugins, UltimateLeaderboard is the perfect addition to engage your players and showcase their achievements.
 

 
⭐ Features of Ultimate Leaderboard
Track a wide variety of player statistics, including kills, deaths, resources gathered, items crafted, structures built, and more. Fully customizable leaderboard—choose which stats to display and tailor it to your server unique style. Intuitive and visually appealing user interface for players to view their stats and compare rankings. Seamless integration with plugins like ServerPanel for enhanced displays, and Notify/UINotify for in-game alerts. Flexible data storage options: choose between JSON, SQLite, or MySQL to suit your server needs. Two reward systems: post-wipe awards that give actual items, kits, and money to top players when they connect, plus an optional companion plugin UltimateLeaderboardTop for real-time privilege management based on current rankings. Players can pick up their awards on demand with a claim command instead of receiving them on connect. Scheduled top announcements, posted to chat and to a Discord webhook. Custom Titles system that automatically displays achievement-based chat titles for top performers (requires BetterChat plugin). Optimized for high performance, ensuring smooth operation even with large player bases and extensive data. Configurable templates. Optional real-time database updates for integrations (e.g., Discord Bot).  
🖼️ Showcase
Fullscreen Template

ServerPanel V1 (V1.1)

ServerPanel V2

 
📨  Video Overview
 
🎮 Commands
/leaderboard or /stats - Opens the leaderboard interface for players to view stats and rankings. /leaderboard <steamid>  - Opens another player's profile (requires ultimateleaderboard.profile permission). /leaderboard.hide - Allows players to hide themselves from the leaderboard (requires ultimateleaderboard.hide.self permission). /claimreward or /claim - Lets players collect awards that are waiting for them. Disabled by default; turn it on under Awards → Claim Reward in the config, where you can also rename the commands. leaderboard.manage hide <steamid>  - Console command to hide a player from the leaderboard (server console only). leaderboard.wipe  - Console command to reset all leaderboard data (server console only). leaderboard.migrate <migration_id>  - Console command to perform database migrations (server console only). Available:
— leaderboard.migrate 1  adds HiddenFromLeaderboard column to PlayerStats table (upgrade from v1.1.7 to v1.1.8)
— leaderboard.migrate 2  migrates BodyHits data to the new format (upgrade to v1.5.10) leaderboard.find.short.prefab <search_term>  - Console command to search for prefabs containing the specified search term (server console only). Useful for finding correct prefab names for configuration. leaderboard.manage  - Console command to manage player statistics (server console only). Use leaderboard.manage help for detailed usage information.  
🛡️ Permissions
ultimateleaderboard.use - grants players access to leaderboard commands and interface. This one is optional: it is whatever name you put in Permission to use plugin in the config, and an empty value leaves the leaderboard open to everyone. ultimateleaderboard.profile  - allows players to view other players' profiles using the leaderboard command. ultimateleaderboard.hide.self  - allows players to hide themselves from the leaderboard using the /leaderboard.hide command. ultimateleaderboard.ignore.titles  - stops the plugin from giving this player a custom chat title. Tabs, categories, and award categories each take their own permission field in the config, so you can lock individual parts of the interface to a group without touching the permissions above.
 
⚙️ Web Config Editor
Easily manage your UltimateLeaderboard settings with our web-based configuration editor. This tool allows you to adjust plugin configurations through a user-friendly interface, eliminating the need to manually edit files on your server.

P.S. To access the web config editor, you must be part of the "UltimateLeaderboard" group in our Discord server. Join us at https://discord.gg/mevent and request the group to get started.
 
📚 FAQ
Q: How do I install UltimateLeaderboard?
A: Download the UltimateLeaderboard.cs file, place it in your oxide/plugins directory, and restart your server or reload the plugin using the Oxide command oxide.reload UltimateLeaderboard.
Q: Can I choose which statistics to track and display?
A: Yes! The plugin allows you to customize tracked statistics and leaderboard displays via the configuration file. You can enable or disable specific stats like kills, resources, or events to suit your server.
Q: What data storage options are available?
A: UltimateLeaderboard supports JSON, SQLite, and MySQL. You can select your preferred storage method in the config file, offering flexibility for small or large servers.
Q: How do I set up the awards system?
A: In the configuration file, define award categories (e.g., most kills, top gatherer) and their criteria. The plugin will automatically track and assign awards to top players based on your settings.
Q: Where can I configure the UI?
A: UI is now template-driven. Use configurable templates stored at oxide/data/UltimateLeaderboard/Templates.
Q: What languages does the plugin come in?
A: The archive ships English and Russian files in the lang folder. Copy them to oxide/lang (or carbon/lang for Carbon) and the plugin picks up each player's client language. Any text you edit in those files is kept on reload, and new keys from an update are added around it.
Q: What happens to the data on a server wipe?
A: By default, data wipes with a new save file, but you can disable this in the config (Wipe data on new save) to persist stats across wipes if desired.
Q: How do I add UltimateLeaderboard to the ServerPanel menu?
A: Follow these simple steps:
1. Open ServerPanel menu in-game and click "+ADD CATEGORY" button
2. Set these exact parameters:
Type: Plugin Plugin Name: UltimateLeaderboard Plugin Hook: API_OpenPlugin 3. Click "SAVE" button to create the category
Q: I see black images with Rust logo or get error 429 when loading images. What should I do?
A: These issues occur when there are problems downloading images from the internet. The UltimateLeaderboard plugin sends images to ImageLibrary but is not responsible for the downloading process itself. Error 429 typically occurs due to rate limits imposed by image hosting services like Imgur (see HTTP 429 documentation for more details). To fix this, enable Offline Image Mode which will use local images instead:
Enable the mode in config: Open "oxide/config/UltimateLeaderboard.json" (or "carbon/config/UltimateLeaderboard.json" for Carbon) Set "Enable Offline Image Mode": true Set up the images: Create folder "TheMevent" in "oxide/data" (or "carbon/data" for Carbon) Download PluginsStorage (click "CODE" → "Download ZIP") Extract the ZIP and copy all contents to the "TheMevent" folder Reload the plugin: Type o.reload UltimateLeaderboard (Oxide) or c.reload UltimateLeaderboard (Carbon) Note: If you want to add your own custom images, place them in the "TheMevent" folder and reference them with the "TheMevent/" prefix. For example: "TheMevent/Icon1.png", "TheMevent/MyCustomIcon.jpg", etc.
Q: What's the difference between UltimateLeaderboard awards and UltimateLeaderboardTop?
A: UltimateLeaderboardTop is a companion plugin that automatically manages player privileges based on leaderboard positions.
Main Plugin Awards: Gives actual rewards (kits, money, commands) to top players after wipe - rewards are given once when player connects. UltimateLeaderboardTop: Continuously manages privileges (VIP groups, permissions) as players enter/exit top positions in real-time. To display awards in UI while using UltimateLeaderboardTop:
Configure awards in UltimateLeaderboard config Configure awards in UltimateLeaderboardTop config Set "Automatically give rewards after the wipe": false Q: Can UltimateLeaderboardTop give items/kits to players?
A: No, UltimateLeaderboardTop is designed only for reversible actions (permissions, groups, etc.). Since items can't be taken back from players when they leave top positions, item rewards are not supported. Use the main plugin's awards system for item rewards instead.
Q: How do I configure rewards for top players?
A: There are two reward systems available:
UltimateLeaderboard Awards (Post-Wipe Rewards):
Configure in the main plugin's config file under "Awards Settings":
Set award categories (e.g., "Most Kills", "Top Gatherer") Define criteria: loot type, prefab, and minimum amount required Set rewards: commands to execute (give items, kits, money, etc.) Awards are given once when top players connect after a wipe UltimateLeaderboardTop (Real-time Privileges):
Configure in UltimateLeaderboardTop.json:
Set leaderboard types to monitor (kills, points, playtime, etc.) Define top positions (1st, 2nd, 3rd, etc.) Configure "Enter place commands" (given when player reaches position) Configure "Exit place commands" (executed when player loses position) Use for permissions, groups, temporary privileges Example UltimateLeaderboardTop configuration:
{   "Loot type": "Kill",   "Prefab": "kills",   "Places settings": {     "1": {       "Enter place commands": ["o.usergroup add %steamid% vip"],       "Exit place commands": ["o.usergroup remove %steamid% vip"]     }   } } Q: What are Custom Titles and how do they work?
A: Custom Titles automatically display achievement-based titles in chat for top players. For example, top killers get "[Killer]" title, top builders get "[Builder]" title, etc. Requires BetterChat plugin to work. Titles are updated automatically based on leaderboard positions and can be configured with priority system and limits.
Q: Why don't I see my statistics updated immediately on the leaderboard?
A: The leaderboard is cached and refreshes periodically (configurable interval) to minimize server load and ensure optimal performance. This means statistics may take a few minutes to appear on the leaderboard after the action is performed. The caching system helps maintain smooth server operation even with large player bases and extensive statistics tracking.
Q: How can I track multiple similar items or entities with one statistic?
A: You can combine multiple prefabs using the pipe symbol | in the prefab field. For example, to track all types of scientists as one "NPC Kills" statistic, use: npc_tunneldweller|npc_underwaterdweller|scientistnpc_arena|scientistnpc_bradley. This is useful for grouping similar items, resources, or entities into a single tracked category.
Q: How do I find the correct prefab names for items, entities, or events?
A: There are several ways to find prefab names:
In-game console command: Use leaderboard.find.short.prefab <search_term> in the server console to search for prefabs containing your search term. For example: leaderboard.find.short.prefab scientist will show all prefabs containing "scientist". F1 console spawn command: In-game, open F1 console and use the spawn command to see available entity prefabs. Type spawn followed by part of the name to see matching options. Item shortnames: For items, use their shortname (e.g., "stones", "metal.ore", "wood"). You can find these by examining items in your inventory or using item-related commands. Plugin documentation: Check the "Custom Prefabs" and "Available Loot Types" sections in this plugin's description for comprehensive lists of supported prefabs and loot types. Q: How can I output the sum of all values by type of statistics (for example, all kills, all loot collected)?
A: Use the prefab total_sum for the desired LootType. For example, to show the total number of all player kills, specify the LootType Kill and the prefab total_sum in the column or block settings. It works for any type: Kill, Gather, Craft, Event, and others.
Q: How does the leaderboard scoring system work?
A: The leaderboard uses a points-based scoring system. Points are earned from in-game actions, and each action has:
Loot Type - The category of action (e.g., Kill, Gather, Construction, Craft, Event) Prefab/Short Name - The specific item or entity (e.g., "kills", "stones", "helicopter", "supply_drop") Score Value - The points awarded for this action (configured in Loot Settings) When a player performs an action:
The plugin looks up the score for that action type + prefab combination Multiplies the score by the action value (usually 1 per action) Adds it to the player's total Points Example scores (from config):
Player kills: +1.0 point per kill Deaths: -1.0 point per death Gathering stone: +0.1 point per stone Supply drop looted: +3.0 points Bradley crate: +5.0 points Helicopter kill: +15.0 points Bradley kill: +10.0 points How to become top player:
Perform actions that have scores configured in Loot Settings Accumulate the most total Points The leaderboard ranks players by their Points value (or other tracked stats) Q: What award types are available and how do I configure them?
A: UltimateLeaderboard supports 7 award types:
Command - Execute console commands. Supports %steamid% placeholder. Use | to separate multiple commands.
Example: "Command (%steamid%)": "inventory.giveto %steamid% rifle.ak 1|oxide.usergroup add %steamid% vip" Kit - Give kits from Kits plugin. Requires Kits plugin to be loaded.
Example: "Type": "Kit", "Kit Name": "vip_starter" ServerRewards - Add reward points. Requires ServerRewards plugin.
Example: "Type": "ServerRewards", "Amount": 1000 Economics - Deposit money via Economics plugin.
Example: "Type": "Economics", "Amount": 5000 BankSystem - Deposit money to player's bank account.
Example: "Type": "BankSystem", "Amount": 2500 GameStores - Add balance via GameStoresRUST plugin.
Example: "Type": "GameStores", "Amount": 100 MoscowOVH - Add balance via RustStore plugin (Moscow OVH integration).
Example: "Type": "MoscowOVH", "Amount": 50  
💻 Custom Prefabs
UltimateLeaderboard supports advanced custom prefabs for granular statistics tracking and display:
total_play_time - Total playtime (in seconds) current_playtime - Current session duration kdr - Kill/Death ratio points - Internal points system longest_kill_distance - Longest kill distance record total_hits - Total player hits total_resources - Total resources gathered total_items_crafted - Items crafted events_won - Event victories structures_built - Structures built upgrades_performed - Building upgrades name/nickname - Player display name clan_tag - Player clan tag formatted_total_playtime - Human-readable playtime (Xd Xh Xm) kd - K/D formatted as "Kills/Deaths" favorite_resource - Most gathered resource favorite_crafted_item - Most crafted item favorite_event - Most won event favorite_building_material - Preferred building material favorite_weapon - Most used weapon total_quests_completed - Total completed quests total_sum - Sum of all values for the selected LootType. For example, using total_sum with LootType Kill will show the total number of all kills for the player (across all kill categories). Works for any LootType: Kill, Gather, Craft, Event, etc.  
📊 Available Loot Types
None Construction Medical Event
Available prefabs: Convoy Sputnik Caravan GasStationEvent AirEvent SatDishEvent Triangulation WaterEvent HarborEvent FerryTerminalEvent ArcticBaseEvent JunkyardEvent SupermarketEvent PowerPlantEvent ArmoredTrainEvent SurvivalArena KillBoss PaintballTeam PaintballFFA GunGame ZombieInfection TugboatPirates SpaceEvent AbandonedBase DungeonEvent FlyingCargoEvent AirfieldEvent FishingContest CargoPlaneCrash GuardedCrate OperationFortress F15CrashEvent Shipwreck LighthouseEvent ZigguratEvent Gather Kill
Available custom prefabs: helisignals_{skin} - Tracks helicopter kills from HeliSignals (e.g., "helisignals_2920175997") bradleydrops_{skin} - Tracks bradley kills from BradleyDrops (e.g., "bradleydrops_2905355269") roadbradley_{profile} - Tracks bradley kills from RoadBradley (e.g., "roadbradley_easy") helicopter - Tracks helicopter kills Custom NPC support: horde_npc - For NPCs from ZombieHorde plugin raidbase_npc - For NPCs from Raidable Bases plugin For NPCs from NpcSpawn use NPC name as key (BossMonster, BetterNpc, NPCs from events, etc.) Other entity prefabs can be found in-game by using the "spawn" command in the F1 console Consume Raid Death
Available custom prefabs: Custom NPC support: horde_npc - For NPCs from ZombieHorde plugin raidbase_npc - For NPCs from Raidable Bases plugin For NPCs from NpcSpawn use NPC name as key (BossMonster, BetterNpc, NPCs from events, etc.) Craft Crate LootItems Fishing Puzzle
Available prefabs: keycard_1 keycard_2 keycard_3 Custom Upgrade ShotFired ExplosiveUsed RecycleItem BodyHits WeaponUsed RaidableBases
Available prefabs: easy medium hard expert nightmare RaidableBoats
Available prefabs: easy medium hard nightmare Economy
Available prefabs: ShoppyStock Economics IQEconomic Quest EconomyBalance
Available prefabs: Economics ServerRewards BankSystem IQEconomic Gambling
Available prefabs: BlackjackDeposit BlackjackWon SlotDeposit SlotWon PockerDeposit PockerWon WheelDeposit WheelWon SkillTree
Available prefabs: xp - Experience points earned level - Skill tree level reached Trivia MixingTable  
📡 API for Developers
UltimateLeaderboard provides a comprehensive API for developers to integrate with other plugins and extend functionality:
📊 Methods
JArray API_GetUltimateLeaderboardUsers(int offset, int limit, int? columnIndex = null) - Get leaderboard users with pagination float API_GetPlayerStat(ulong playerId, string lootType, string shortname) - Get specific player statistic bool API_IsHiddenFromLeaderboard(ulong playerId) - Check if player is hidden from leaderboard void API_OnItemGather(ulong player, string shortname, int amount) - Add gather statistics for a player void API_OnEventWin(ulong userID, string eventName, int amount = 1) - Record event wins for a player void API_GetTopPlayers(int lootType, string prefab, int limit, Action<JObject> callback) - Get the top players for a loot type and prefab; the result arrives in the callback bool API_HasPendingRewards(ulong playerId) - Check whether a player has awards waiting to be collected bool API_ClaimRewards(BasePlayer player) - Give a player the awards waiting for them 🎣 Hooks
void OnUltimateLeaderboardContent(BasePlayer player, string categoryType, CuiElementContainer container) - Called when displaying custom category content void OnUltimateLeaderboardCached() - Called when leaderboard data is cached and ready object CanUltimateLeaderboardAddPoints(ulong userId, string lootType, string prefab, float points) - Called before points are added to a player. Return a non-null value to block the points; the statistic itself is still recorded. lootType is the LootType name, for example "Kill", "Gather" or "Crate".

Show all Active and past Patrol Helicopter records that track all attacks by players with detailed statistics for each helicopter and player.  
Features:
✯ Detailed Statistics for Helicopters, Players, Weapons
✯ Easy to use UI to show all statistics
✯ 5 Theme colors that each player can choose from
✯ Top players for helicopter attacks, total damage, total hits
✯ Search attacker history for players
✯ Quick Helicopter spawn button for admins in the UI
✯ Helicopter Tiers - Create custom tiers to make patrol helicopters easier/harder
 
        Recorded Data:
        [Patrol Helicopters]
        ✯ Status (active/inactive)
           ✯ Health (current/max)
           ✯ Start Time
           ✯ End Time
           ✯ List of Attackers
         
        [Attackers]
           ✯ Total Helicopters Attacked
           ✯ Total Damage (all helicopters / per helicopter)
           ✯ Total Hits (all helicopters / per helicopter)
           ✯ List of every Attack
        [Attacks]
        ✯ Weapon
           ✯ Damage
           ✯ Type
           ✯ Distance
           ✯ Time
        [Weapons]
           ✯ Total Damage (all helicopters / per helicopter)
           ✯ Total Hits (all helicopters / per helicopter)
           ✯ List of every Attack with weapon
     
        [Top Players]
           ✯ Helicopters Attacked
           ✯ Total Damage
           ✯ Total Hits
           
Default Chat Command:
/hr   - Opens UI panels (can be changed in admin settings)  
 
NOTES:
                 * Report all issues or bugs in our discord
 
Language:
{ "menu_lable": "Menu", "menu_001": "Main", "menu_002": "Active Patrols", "menu_003": "Patrol Records", "menu_004": "Top Players", "menu_005": "Search", "menu_006": "My Stats", "menu_007": "Close", "menu_008": "Admin", "hr_001": "Helicopter Records", "hr_002": "Global Statistics", "hr_003": "Total Helicopters", "hr_004": "Total Hits", "hr_005": "Total Attackers", "hr_006": "Active Patrol Helicopters", "hr_007": "Last Patrol Helicopters", "hr_008": "Helicopter ID", "hr_009": "Patrol Helicopter [#{0}]", "hr_010": "Health", "hr_011": "Started", "hr_012": "Ended", "hr_013": "Status", "hr_014": "Active", "hr_015": "InActive", "hr_016": "Escaped", "hr_017": "Attackers", "hr_018": "︽ Pevious", "hr_019": "Next ︾", "hr_020": "Player", "hr_021": "Damage", "hr_022": "No Attackers", "hr_023": "No Active Patrol Helicopters", "hr_024": "No Inactive Patrol Helicopters", "hr_025": "Helicopters Attacked", "hr_026": "Total Damage", "hr_027": "Attack Record", "hr_028": "Total Attacks", "hr_029": "Timestamp", "hr_030": "Distance", "hr_031": "Type", "hr_032": "Weapon", "hr_033": "Page: {0}", "hr_034": "Total Damage Amount", "hr_035": "Total Damage Percentage", "hr_036": "Top Attackers", "hr_037": "Search Attackers", "hr_038": "..enter player name..", "hr_039": "Search Results", "hr_040": "Total Weapons", "hr_041": "Most Used", "hr_042": "All Weapons", "hr_043": "Total Hits", "hr_044": "Helicopters Hit", "hradmin_001": "Settings", "hradmin_002": "Open UI Panel", "hradmin_003": "Save Settings", "hradmin_004": "Use Local Path", "hradmin_005": "Oxide Folder Path", "hradmin_006": "Reload Images & ImageLibrary", "hradmin_007": "Delete Records", "hradmin_008": "Delete", "hradmin_009": "This will delete all records for this helicopter including attackers and hits. \nAre you sure you want to remove all records for Patrol Helicopter [#{0}]", "hradmin_010": "Spawn New Helicopter" }  
Discord
Join our community discord for fast support and future updates. We have several channels where you can get help, offer suggestions, see what's coming in future updates, and more. Our discord is the fastest way to get the help and info you need! http://discord.rustlevels.com/