Brasiliannut's Wishlist

XPerience Addon: READ BEFORE PURCHASE!
This is an addon to XPerience! You must have XPerience installed on your server to use this.  
XPerience Website:  https://www.rustlevels.com/XPerience/
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/
        New Admin Options:
            ✯ Full rewrite and conversion of admin panel to text inputs and toggle options
            ✯ Can now add/edit welcome message, command list, and custom pages in admin panel
            ✯ Can now add/edit custom special items in admin panel
            ✯ Can now add/edit maps in admin panel
            ✯ Can now add/edit all image URLs in admin panel including damage bar skins in admin panel
            ✯ Can now add/edit Global Event reward items and commands in admin panel
 
Added Skills/Stats:
These abilities are added to the already existing stats and skill within XPerience..
Added Miner  Abilities:
 Option to increase quarry production by % per Miner level  Option to set production duration  Option to set cooldown duration Added Weaponry Abilities:
Option to fire free ammo  from weapons Option to set free ammo chance per weaponry level Increase max distance per Weaponry level Increase max effective range per Weaponry level Added Scavenger Abilities:
Chance to receive more items from vendors Option to set percentage chance per scavenger level Option to set percentage amount per scavenger level Added Forager Abilities:
Chance to for free recycle for items (gives materials but keeps item) Option to set percentage chance per forager level Added Medic Abilities:
Passive Healing Increase health every (x) seconds for (x) amount MedGun for healing entities from a distance
  Added Demolitionist  Abilities:
Enable rocket locking Select rocket trackable entities Select rocket trackable ammo Adjust rocket lock chance percentage % Adjust rocket lock time Adjust rocket max lock distance Adjust rocket max lock distance increase percentage % Adjust rocket detonation time Adjust rocket speed increase percentage % Adjust rocket damage increase percentage % Includes Rocket Launcher UI that shows target name, lock status, distance, and max distance allowed  
Other Features:
 
Global Event Feature: Gathering and Kill goals for all players collectively
Set total number of required kills for different entities Set total amount of resources for different types (wood, ores, scrap, and more..) Reward Options: XP, Items, Economics, Server Rewards, Special Items, Per player Commands, Global Commands Awards all players in the server active player list Global Event deposit box for event contributions (obtained by chat command or give button on welcome panel) Option to restrict getting a global event box by permission Option to set max number of global event boxes allowed per player Option to show chat notifications when contributions are made and goals are reached Global Event HUD option to show all goals (with or without border) Option to auto reset global event after x amount of hours from completion Option to destroy all global event boxes on event completion Button to manually destroy all global event boxes Button to manually reset Global Event Global Event details page shown on Welcome Panel  
Map Display/Voting:
Shows 3 maps at a time on welcome menu Can list as many maps as wanted with map name, small img, large img, map size, and details Can set max number of votes per player Can auto clear map/vote data on wipe Can manually clear map/vote data in admin panel More feature to come.... Special Items:  (requires XPerience V1.6.9+)
Option to set special items as soulbound (only recieving player can use) Option to show Special Items in Welcome menu Option to enable economics purchase of special items Option to enable server rewards purchase of special items Option to enable permissions for purchase options Special Items can be purchased from Welcome Panel Admin chat/console commands to give special items Option to set percentage (%) chance item drop from actions             Premade Items:
Can change skinID of each default item in config           XP Scroll Small XP Scroll Medium XP Scroll Large XP Scroll Massive Option to set amount of xp gained per scroll Option to set scroll rarity drop Stat Book Small Stat Book Medium Stat Book Large Stat Book Massive Skill Book Small Skill Book Medium Skill Book Large Skill Book Massive Option to set amount of points gained per book Option to set book rarity drop XP Booster Option to set percentage amount Option to set duration in mins             Custom Items:
Admin chat/console commands to create/delete custom items Option to set custom name, type, rarity, award amount, skinID, economics cost, serverrewards cost, and duration Option to include custom items in drop chance  
Playtime XP:
Option to enable XP for time playing Option to set XP amount for every xx mins Option to increase XP amount by percentage %  
Target Damage Display: (Health/Damage Bar)
Shows target health/max health in live UI when target attacked Disappears when target is killed or after 5 seconds if not killed Option to show last damage amount Option to show names on bar Select from 10 premade skins to use for default health on the damage bar UI Add/Create as many damage bar skins as wanted Option to allow players to choose what damage bar skin they want to use  
Death Records:
Option to enable Death Records Track all kills/deaths from players Shows victim, attacker, weapon, damage type, distance, and time Players have their own Death Records profile UI (accessed from XPerience profile) Option to set custom chat command for DeathRecords UI Option to send death record notice to chat Option to adjust chat font size and colors Option to send death record to discord (Discord Messages required) Option to show player turret kills Option to give bonus XP for kill distance Option to set bonus xp amount and distance multiplier Option to list all entities you want to track in config  
Player Notes:
Option to show XP gains   Option to show Level Up Option to show Rank Up   Option to show Stat Level up Option to show Skill Level up  
Notify UI: (Player & Global)
Option to enable Player and Global Notify UI Bar Option to show when player ranks up Option to show when player levels up Option to show when player increases stats or skills Option to set timeout in seconds when UI bar  disappears  
DiscordMessages Support: (requires DiscordMessages plugin)
Discord webhook URL Option to send player rank up to discord Option to send player level up to discord Option to send player stat level up to discord Option to send player skill level up to discord  
Welcome Panel:
Option to use background image Option to use profile background image from XPerience so they match Option to set welcome message on main UI screen Option to set list of chat commands on command page Option to show skill Item Drops (split into 2 parts forager/scavenger) Shows all items listed in the forager and Scavenger skill lists Shows percentage drop chance per skill levels Option to show XPerience profile button Option to show server XP/Level settings Option to show map voting list Option to show special items (books, scrolls, xp boosters) Option to show Mods Installed Option to exclude list of Mods Installed Option to show Admin panel button Option to show custom pages Option to show Custom Item Drops list page (Requires Custom Item Drops V1.0.6+) Shows all items in the Custom Item Drops plugin separated by lists Shows percentage drop chance for default and vip settings per list RaidableBases support: Shows all active and completed raids  
RustLevels Website:  (Optional Feature)
IMPORTANT: If you want your server to appear on RustLevels you must submit your server at https://www.rustlevels.com/submit-server and receive a auto generated ServerIDKey. This is now required for your server to connect to RustLevels.com
Sends Server data to RustLevels (Name / IP) Option to set server banner URL Option to set website URL Option to hide player steam info Sends XPerience player data to RustLevels Sends Kill Records player data to RustLevels RustLevels Details:
This Addon collects all player data from XPerience, Kill Records and other mods if enabled and sends it to RustLevels.com through SQL. All servers with this addon mod can be be publicly shown on RustLevels.com with their own page and player profiles if you choose. Once purchased you must submit your server's IP or DNS to our website here:  https://www.rustlevels.com/submit-server  so that it can be allowed to access RustLevels database and receive your Unique ServerIDKey to place in your config file . Please allow up to 48 hours for your server to be accepted.  
Player steam badges can be hidden on RustLevels.com by config option. This will prevent steam badges for your server players being shown on our website. All player steam information is supplied by Steamworks API with permissions listed in steams privacy policy section 5.5 which RustLevels has no control over:    https://store.steampowered.com/privacy_agreement/  
Chat Commands:
Server Admins Only
/xpglobalremove - removes all data from RustLevels that match your server (will be added back automatically on next data send) /globalupdate - Sends a one time update of all players to RustLevels /xpaddonreload - Reloads the XPerienceAddon mod /newitem   "<name>" <rarity> <stat/skill/xp/booster> <points/xp> <skinID> <economics cost> <serverrewards cost> <duration> /removeitem "<name>" /xpitem <name/id> <playername/id> "<itemname>" <amount>
  Console Commands
rustlevelsclear - clears all server and player data from RustLevels rustlevelsupdate - updates all server and player data on RustLevels newitem "<name>" <rarity> <stat/skill/xp/booster> <points/xp> <skinID> <economics cost> <serverrewards cost> <duration> removeitem "<name>" xpitem <name/id> <playername/id> "<itemname>" <amount>  
Damage Bar Skins:
Add/Edit Damage Bar Skins In ->   /oxide/config/XPerienceAddon.json
"dmgbarimgs": { "0": { "name": "DmgBar0", "url": "https://i.imgur.com/jQFs4Y1.png" }, "1": { "name": "DmgBar1", "url": "https://i.imgur.com/VGfALAA.png" }, "2": { "name": "DmgBar2", "url": "https://i.imgur.com/5RHS1wS.png" }, "3": { "name": "DmgBar3", "url": "https://i.imgur.com/t6WAKp0.png" }, "4": { "name": "DmgBar4", "url": "https://i.imgur.com/x7j4X1N.png" }, "5": { "name": "DmgBar5", "url": "https://i.imgur.com/0hCAV9y.png" }, "6": { "name": "DmgBar6", "url": "https://i.imgur.com/ZlLWc7V.png" }, "7": { "name": "DmgBar7", "url": "https://i.imgur.com/vQ8STCW.png" }, "8": { "name": "DmgBar8", "url": "https://i.imgur.com/V89IdKh.png" }, "9": { "name": "DmgBar9", "url": "https://i.imgur.com/VnZrpna.png" }, "10": { "name": "DmgBar10", "url": "https://i.imgur.com/D8iLInT.png" }, "11": { "name": "DmgBar11", "url": "https://i.imgur.com/0Vnpoml.png" } } Map Data:
Add maps in the ->   /oxide/data/XPerienceAddon/MapData.json
{ "Maps": { "0": { "name": "Map 1", "details": "Monuments: 116 \n Safezones: 5 \n Land Percentage: 45% \n Islands: 4 \n Large Monuments: 13 \n Small Monuments: 14 \n Tiny Monuments: 78 \n Caves: 5 \n Rivers: 4 \n Mountains: 0 \n Icebergs: 14 \n Ice Lakes: 3", "smallimageurl": "https://i.imgur.com/iGNrsZl.jpg", "largeimageurl": "https://i.imgur.com/YDNmH1s.jpg", "mapsize": 3000, "votes": 0 }, "1": { "name": "Map 2", "details": "Monuments: 101 \n Safezones: 8 \n Land Percentage: 67% \n Islands: 1 \n Large Monuments: 11 \n Small Monuments: 8 \n Tiny Monuments: 99 \n Caves: 5 \n Rivers: 9 \n Mountains: 2 \n Icebergs: 7 \n Ice Lakes: 2", "smallimageurl": "https://i.imgur.com/iGNrsZl.jpg", "largeimageurl": "https://i.imgur.com/YDNmH1s.jpg", "mapsize": 3000, "votes": 1 }, "2": { "name": "Map 3", "details": "Monuments: 106 \n Safezones: 6 \n Land Percentage: 54% \n Islands: 2 \n Large Monuments: 16 \n Small Monuments: 23 \n Tiny Monuments: 58 \n Caves: 1 \n Rivers: 5 \n Mountains: 1 \n Icebergs: 13 \n Ice Lakes: 1", "smallimageurl": "https://i.imgur.com/iGNrsZl.jpg", "largeimageurl": "https://i.imgur.com/YDNmH1s.jpg", "mapsize": 3000, "votes": 0 }, "3": { "name": "Map 4", "details": "Details about this map", "smallimageurl": "", "largeimageurl": "", "mapsize": 0, "votes": 0 }, "4": { "name": "Map 5", "details": "Details about this map", "smallimageurl": "", "largeimageurl": "", "mapsize": 0, "votes": 0 } } } Addon Config:
{ "Welcome Panel": { "showonconnect": true, "autoclosetimer": false, "timeout": 10, "AnchorMin": ".5 .5", "AnchorMax": ".5 .5", "OffsetMin": "-300 -200", "OffsetMax": "300 200", "InsideAnchorMin": ".03 .01", "InsideAnchorMax": ".99 .97", "usebgimage": true, "usexpbgimage": true, "usemenubgimage": false, "bgfadein": 0.2, "menuwidth": 0.2, "menuheight": 0.75, "menubuttonheight": 0.07, "menubuttonfont": 11, "openwelcomepanel": "welcome", "welcomemessage": "Welcome {playername} to our server. This server has the XPerience mod installed which allows you to gain XP, Levels, and Points to spend in different Stats and Skills. Each Stat and Skill will give your character increased abilities. Check out the XP/Level Info page for more details and the Commands page for list of chat commands you can use. Click the My Profile button to view your XPerience profile and all the abilities you can earn. You can also view all the mods installed on our server by clicking the Mods Installed button.\n\nYour Level: {xp.level} \nYour XP: {xp.experience}", "showcommandsbutton": false, "showskillitemdropsbutton": true, "showcustomitemdropsbutton": true, "showprofilebutton": true, "showsettingsbutton": true, "showmodsbutton": true, "excludemods": "RustCore,UnityCore", "showadminbutton": true, "showcustombuttons": true, "showraidsbutton": true, "showspecialitemsbutton": true, "showscustompecialitems": true, "showmapbutton": true, "commands": { "0": { "command": "/xpstats", "details": "Opens your XPerience profile" }, "1": { "command": "/deaths", "details": "Opens All Death Records" }, "2": { "command": "/xphelp", "details": "Opens Help page in XPerience UI" }, "3": { "command": "/xptop", "details": "Opens Top players page in XPerience UI" }, "4": { "command": "/welcome", "details": "Opens the Welcome Panel UI" } }, "custompages": { "0": { "button": "Server Rules", "CustomSubPages": { "0": { "title": "Server Rules", "content": "Server Rules:\n\n* No Harassment, Racism, Sexism, Trolling, Disrespect, or Hate Speech!\n\n" } } } } }, "Maps": { "maxmapvotes": 2, "autoreset": false }, "Connection Info": { "serveridkey": "", "sendtorustlevels": false, "hideplayerssteam": false, "hidemodlist": false, "websitebannerurl": "", "websiteurl": "" }, "Other Features": { "usepermissions": false, "dmgbar": true, "dmgbarname": true, "dmgindicator": true, "dmgbartimeout": 10.0, "dmgbarupdate": 0.5, "dmgbarskindefault": 3, "dmgbarlocation": 35 }, "Note Messages": { "xpgain": true, "xpgainnote": 1, "levelup": true, "levelupnote": 1, "statup": true, "statupnote": 1, "skillup": true, "skillupnote": 1, "rankup": true, "rankupnote": 1, "combine": true }, "Skills": { "minerquarry": 0.1, "minerquarryduration": 120, "minerquarrycooldown": 600, "weaponryammochance": 0.01, "weaponryreload": 0.05, "weaponrydistance": 0.08, "weaponryrange": 0.04, "scavengervendingchance": 0.05, "scavengervendingamount": 0.05, "foragerrecyclerchance": 0.05, "foragerrecyclerspeed": 0.1, "medicpassivehealing": true, "medicpassivehealingcooldown": 10, "medicpassivehealingtimer": 10.0, "medicpassivehealingamount": 0.02 }, "Notify UI": { "playernotify": true, "rankup": true, "levelup": true, "statup": true, "skillup": true, "globalnotify": true, "rankupglobal": true, "levelupglobal": true, "statupglobal": true, "skillupglobal": true, "notifyuitimeout": 5.0 }, "Death Records": { "enabledeathrecords": true, "usepermissions": false, "senddeathtochat": true, "sendplayerdeathtochat": true, "senddeathtodiscord": false, "usepopupnotifications": true, "logturretkills": true, "chatfontsize": 10, "attackercolor": "#FF0000", "victimcolor": "#00FF00", "weaponcolor": "#0000FF", "distancecolor": "#00FF00", "enabledistancebonus": true, "xpbonusamount": 50, "bonusrangedistance": 25, "deathrecordschatcommand": "deaths", "discordwebhookurldeaths": "https://support.discordapp.com/hc/en-us/articles/228383668-Intro-to-Webhooks", "entityList": { "0": { "entity": "chicken", "name": "Chicken" }, "1": { "entity": "boar", "name": "Boar" }, "2": { "entity": "stag", "name": "Stag" }, "3": { "entity": "wolf", "name": "Wolf" }, "4": { "entity": "bear", "name": "Bear" }, "5": { "entity": "polarbear", "name": "Polar Bear" }, "6": { "entity": "simpleshark", "name": "Shark" }, "7": { "entity": "ridablehorse", "name": "Horse" }, "8": { "entity": "scientistnpc", "name": "Scientist" }, "9": { "entity": "tunneldweller", "name": "Tunnel Dweller" }, "10": { "entity": "underwaterdweller", "name": "Underwater Dweller" }, "11": { "entity": "scarecrownpc", "name": "Scarecrow" }, "12": { "entity": "zombienpc", "name": "Zombie" }, "13": { "entity": "customscientistnpc", "name": "Custom Scientist" }, "14": { "entity": "bradleyapc", "name": "Bradley APC" }, "15": { "entity": "patrolhelicopter", "name": "Patrol Helicopter" }, "16": { "entity": "basehelicopter", "name": "Patrol Helicopter" } } }, "Images": { "xperienceaddonlogo": "https://i.imgur.com/QSXW2vV.png", "rustlevelslogo": "https://i.imgur.com/lb2l1s5.jpg", "dmgbarimg": "https://i.imgur.com/XzoMdbI.png", "dmgbarimgname": "https://i.imgur.com/RhboH5w.png", "notifybar": "https://i.imgur.com/Cuea6lw.png", "welcomepanel": "https://i.imgur.com/JUwd2a8.png", "raideasy": "https://i.imgur.com/cAUlHlA.png", "raidmedium": "https://i.imgur.com/Tzhbic3.png", "raidhard": "https://i.imgur.com/MGNUPg0.png", "raidexpert": "https://i.imgur.com/bPql6Tz.png", "raidnightmare": "https://i.imgur.com/RpiC5dy.png", "welcomebg": "https://i.imgur.com/DdVLKsE.png", "menubg": "https://i.imgur.com/DrWCba0.jpg", "xp": "https://i.imgur.com/yAmIsSX.png", "dmgbarimgs": { "0": { "name": "DmgBar0", "url": "https://i.imgur.com/jQFs4Y1.png" }, "1": { "name": "DmgBar1", "url": "https://i.imgur.com/VGfALAA.png" }, "2": { "name": "DmgBar2", "url": "https://i.imgur.com/5RHS1wS.png" }, "3": { "name": "DmgBar3", "url": "https://i.imgur.com/t6WAKp0.png" }, "4": { "name": "DmgBar4", "url": "https://i.imgur.com/x7j4X1N.png" }, "5": { "name": "DmgBar5", "url": "https://i.imgur.com/0hCAV9y.png" }, "6": { "name": "DmgBar6", "url": "https://i.imgur.com/ZlLWc7V.png" }, "7": { "name": "DmgBar7", "url": "https://i.imgur.com/vQ8STCW.png" }, "8": { "name": "DmgBar8", "url": "https://i.imgur.com/V89IdKh.png" }, "9": { "name": "DmgBar9", "url": "https://i.imgur.com/VnZrpna.png" }, "10": { "name": "DmgBar10", "url": "https://i.imgur.com/D8iLInT.png" }, "11": { "name": "DmgBar11", "url": "https://i.imgur.com/0Vnpoml.png" } } }, "Discord": { "enablediscord": false, "discordwebhookurl": "https://support.discordapp.com/hc/en-us/articles/228383668-Intro-to-Webhooks", "discordrankup": false, "discordlevelup": false, "discordstatup": false, "discordskillup": false, "useecludedlist": false }, "Raidable Bases": { "easyxp": 500.0, "mediumxp": 1000.0, "hardxp": 1500.0, "expertxp": 2000.0, "nightmarexp": 2500.0, "awardall": true, "awardpercentage": true, "percentagereduction": 0.1 }, "Special Items": { "createitemcommand": "newitem", "deleteitemcommand": "removeitem", "xpboosterduration": 3, "xpboosterrarity": 3, "xpboosteramount": 0.1, "xpscrollsmall": 50.0, "xpscrollmedium": 100.0, "xpscrolllarge": 250.0, "xpscrollmassive": 500.0, "scrollsmallrarity": 1, "scrollmediumrarity": 4, "scrolllargerarity": 7, "scrollmassiverarity": 10, "recievechance": 50, "soulbind": true, "deletesoulbind": true, "includecustomitems": true, "kills": true, "bkills": true, "ckills": true, "boosterkills": true, "looting": true, "blooting": true, "clooting": true, "boosterlooting": true, "missions": true, "bmissions": true, "cmissions": true, "boostermissions": true, "raidablebases": true, "braidablebases": true, "craidablebases": true, "boosterraidablebases": true, "bookofstatknowledgesmall": 1, "bookofstatknowledgemedium": 2, "bookofstatknowledgelarge": 3, "bookofstatknowledgemassive": 5, "bookofskillknowledgesmall": 1, "bookofskillknowledgemedium": 2, "bookofskillknowledgelarge": 3, "bookofskillknowledgemassive": 5, "smallstatbookrarity": 1, "mediumstatbookrarity": 4, "largestatbookrarity": 7, "massivestatbookrarity": 10, "smallskillbookrarity": 1, "mediumskillbookrarity": 4, "largeskillbookrarity": 7, "massiveskillbookrarity": 10, "smallxpscrollskinID": 2875023577, "mediumxpscrollskinID": 2875023708, "largexpscrollskinID": 2875023800, "massivexpscrollskinID": 2875023861, "smallstatbookskinID": 2876483610, "mediumstatbookskinID": 2876483501, "largestatbookskinID": 2876483375, "massivestatbookskinID": 2876478826, "smallskillbookskinID": 2876486178, "mediumskillbookskinID": 2876486286, "largeskillbookskinID": 2876486372, "massiveskillbookskinID": 2876486500, "xpboosterskinID": 2874722752, "useeconomics": true, "useeconomicsbooks": true, "useeconomicscustom": true, "useeconomicsboosters": true, "specialitemeconperm": false, "useserverrewards": true, "useserverrewardsbooks": true, "useserverrewardscustom": true, "useserverrewardsboosters": true, "specialitemsrperm": false, "xpscrollsmallcost": 100.0, "xpscrollmediumcost": 250.0, "xpscrolllargecost": 500.0, "xpscrollmassivecost": 1000.0, "statbooksmallcost": 100.0, "statbookmediumcost": 250.0, "statbooklargecost": 500.0, "statbookmassivecost": 1000.0, "skillbooksmallcost": 100.0, "skillbookmediumcost": 250.0, "skillbooklargecost": 500.0, "skillbookmassivecost": 1000.0, "xpboostercost": 1000.0, "xpscrollsmallsrcost": 10, "xpscrollmediumsrcost": 25, "xpscrolllargesrcost": 50, "xpscrollmassivesrcost": 100, "statbooksmallsrcost": 10, "statbookmediumsrcost": 25, "statbooklargesrcost": 50, "statbookmassivesrcost": 100, "skillbooksmallsrcost": 10, "skillbookmediumsrcost": 25, "skillbooklargesrcost": 50, "skillbookmassivesrcost": 100, "xpboostersrcost": 500 } } About RustLevels:  https://www.rustlevels.com/
RustLevels collects data from Rust servers that use the XPerience, XPerience Addon, Kill Records, and other plugins. Each server gets added and updated automatically each time the server saves and displays all their player's data related to these plugins. Every server is setup differently based on the owners of each server so no two servers will be alike. RustLevels website will show all players that play on each server with their progression based on that server's setup. RustLevels is NOT responsible for any server progression or setup nor do they have any control over the player data displayed on their website.
(Player data is controlled by each server individually not by RustLevels)
You can subscribe to our discord mod update channel where we post updates when released at: [ https://discord.rustlevels.com  ] The version numbers at the bottom left of the RustLevels website should match the Addon version your using at all times.

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. 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). 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. 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.  
⚙️ 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 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 8 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 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 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 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 🎣 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