GangstaPichu's Wishlist

Adds a "quick loot" panel similar to that found in games such as Starfield and Fallout 4. This allows players to quickly view and loot items from containers without needing to open them first. Includes additional features such as item tracking and sorting.
 

View and loot items without needing to open a container Live updating quick loot panel when looking at a container Item tracking, which allows players to track certain items which will highlight them if they appear in a container Ability to sort items in the quick loot panel Customizable hotkeys Highly configurable UI  

Install the plugin on your server Assign yourself (or your group) your desired permissions. For this tutorial I recommend assigning yourself all the permissions EXCEPT quickloot.ignorelocks. Once permissions are assigned, use the /ql command to open the quick loot settings menu. In the settings menu, follow the instructions for setting up key bindings, for this tutorial I recommend using the example keybindings. Each player WILL need to do this step themselves, but they will only have to do it once. Once key binding are setup, simply look at a container that you can open that has multiple items in it, the quick loot panel should appear. If you setup your keybindings according to the example, use the up and down arrow keys to page through items. You can "track" an item by paging over an item in the quick loot panel and pressing the right arrow key (if using example keybinds). Items you are tracking will appear highlighted at the top of the quick loot panel if they exist in the container. You can untrack these items by repressing the same key. You can "take" an item by paging over an item in the quick loot panel and pressing the left arrow key (if using example keybinds). This will loot the entire stack, if you want to loot a single item from the stack, hold down the sprint key (shift by default) while pressing the loot key.  

/ql - Displays the Quick Loot settings menu. Requires the quickloot.menu permission.
 

These are commands that can be bound to keybindings. To do so press F1 then type "bind <key> <command>". For example if you want to bind the quick loot toggle to the "o" key, you can do "bind o ql.toggle". Rust plugins unfortunately cannot bind keys automatically. Each player will need to setup keybindings themselves, but once they do, they won't have to do it again. There are instructions for this in the /ql settings menu.
ql.close - Closes the quick loot settings menu. ql.down - Selects the next item in the quick loot panel. ql.up - Selects the previous item in the quick loot panel. ql.sort - Cycles to the next item sort mode. ql.loot - Loots the selected item from the quick loot panel. Hold "sprint" to select single items instead of a stack. ql.track - Tracks the selected item. Tracked items appear at the top of the quick loot panel if they exist in the container. ql.toggle - Toggles the visibility of the quick loot panel. You can  click here  for a list of key identifiers to use.
 

To try out the plugin, I recommend assigning players all the permissions EXCEPT "quickloot.ignorelocks".
quickloot.storage.take - View and take items from storage containers, such as chests, furnaces, and other deployables. quickloot.storage.view - Only view items in storage containers, such as chests, furnaces, and other deployables. quickloot.barrels.take - View and take items from roadside barrels. quickloot.barrels.view - Only view items from roadside barrels. quickloot.crates.take - View and take items from naturally spawned crates. quickloot.crates.take - Only view items from naturally spawned crates. quickloot.tracking - Ability to track items, so that they will appear highlighted in the quick loot panel. quickloot.menu - Needed to use the /ql command and open the Quick Loot settings menu. quickloot.ignorelocks - Locked containers will no longer prevent you from viewing or taking items from them. Nice for admins.  

You can customize how the quick loot panel looks with a variety of options. To do so you will need to create a style preset. By default, this plugin auto-generates a few of them that you can use for reference. They are located within the "oxide/data/QuickLoot/styles" folder. To create a new style preset, simply copy one of them existing ones and edit the values. The load this preset, set the "StylePreset" property in the config file to the name of the preset file you created. I HIGHLY recommend creating your own preset instead of editing an existing one, because the existing ones may be overwritten if you have "GenerateDefaultStyles" set to "true" in the config.
Feel free to share your created presets in the discussion forum!
 

Q: I loaded the plugin, but the quick loot menu doesn't appear when I look at a container.
A: You need to assign yourself (or your group) the permissions in order to use the quick loot features.
Q: Hotkeys are not working for me.
A: Rust does not allow plugins to automatically bind keys for players. Each player will need to bind hotkeys themselves. The /ql command will provide instructions for how to do this.
Q: How can I loot a single item at a time instead of the entire stack?
A: You can hold down the "sprint" key (shift by default) to switch to single looting mode.
Q: Can I put items into the container via the quick loot panel?
A: Inserting items into a container is not currently a feature of this plugin.
Q: How do I change the look of the quick loot panel?
A: See the customization section.
Q: Some images are not loading, how do I fix this?
A: The images I provided for this plugin are hosted through Imgur, which means under peak load times, sometimes may not load correctly. I recommend hosting the images yourself and setting the URL in the config to avoid this issue.
Q: The quick loot panel is overlapping with the UI of another plugin.
A: You can change the position of the quick loot panel in style preset. Please see the customization section for more info.
Q: I have another plugin that uses the "/ql" command and it is conflicting with this one.
A: You can change this command in the configuration file. Make sure to update the localization text as well if you change it.

Tired of driving on abandoned roads in Rust? Traffic Drivers adds AI-driven vehicles with armed companions ready to defend their drivers. Customize everything from vehicle setups to AI behavior, making each road feel more dynamic and unpredictable!
Features:
🚗 Dynamic AI Traffic
 • AI-powered vehicles patrol Rust’s roads with armed drivers and companions.
 • Customizable AI reactions – decide how they respond to attacks!
 • Companions will fiercely protect their driver.
  
🔥 High-Speed Combat & Encounters
 • Bots fight back when their vehicle is attacked.
 • Drivers can temporarily accelerate when under fire.
 • Setup damage rates, loot tables, and AI health settings.
  
🔧 Full Vehicle Customization
 • Set fuel limits or enable infinite fuel.
 • Adjust max speed, destroy rules, and car respawn times.
 • Optional locks for security
  
💰 Loot & Rewards System
 • Configure loot inside storage modules – control drop rates and item amounts.
 • Customize driver & companion inventory – weapons, clothes, and other supplies.  
   
⚙ Spawn Control
 • Set limits on active traffic vehicles.
 • Adjust minimum road length
 • Configure auto-destruction for stuck cars.
 • Prevent AI from attacking friendly drivers and companions.  
   
Total Customization & Control:
  
🛠️ Vehicle Presets:
 • Adjust fuel, speed, engine durability, and others.
 • Define loot contents inside storage modules.
  
🎯 Driver & Companion AI:
 • Set driver names, health, appearance, and clothing.
 • Configure damage resistance and response to attacks.
 • Equip companions with custom armor, health, and weapons to protect their driver.  
   
📸 See It in Action! Watch the Video
⚠️ After downloading you’ll also get plugin called DriverController. It’s a single plugin to setup presets of bots and loot between all of my plugins.
📃 Configuration:
{   "Event settings": {     "Allowed events (vehicle) count": {       "Min": 3.0,       "Max": 6.0     },     "Event restart delay": {       "Min": 60.0,       "Max": 120.0     },     "Prevent NPC from attacking drivers and companions?": true,     "Block damage to transport from not players?": true,     "Block damage to driver and companion from not players?": true,     "Destroy events of this plugin when pause is enabled?": true,     "Behavior when Convoy spawns": {       "Pause events when Convoy starts?": true     },     "Marker text color": {       "Color (for HEX, put # at the beginning)": "0.2 0.21 0.62 1"     },     "Event name for the marker": "EVENT CAR",     "Route recording settings": {       "Enable recorded routes usage?": true,       "Clear saved routes after wipe?": true,       "Minimum distance between points to record in route (used when recording route)": 20.0,       "Minimum number of points to save (used when recording route)": 50.0     },     "Route generation": {       "Enable route generation": true     },     "Controller settings": {       "Controller update timer (0 - 0.2)": 0.0     }   },   "Car settings": [     {       "Activate this event?": true,       "Transport type for event (Random2Module, Random3Module, Random4Module, Module2, Module3, Module4)": "Module2",       "Driver name (key) from driver settings in DriverController plugin": "DriverCar",       "Companion name (key) from companion settings in DriverController plugin (list to occupy free seats in the vehicle)": [         "Companion1",         "Companion2"       ],       "Engine settings": {         "Engine parts level (1 - 3)": 1,         "Drop the parts when destroying vehicle?": false       },       "Loot container settings": {         "Enable loot in vehicle container?": true,         "Drop the loot when destroying the transport?": false,         "Amount of slots": 1,         "Name of loot set from loot settings in DriverController plugin (list loot sets for random selection)": [           "ResourcesCar"         ]       },       "Use Road Routes (has priority over off-road)": true,       "Use Off-Road Routes (used if no road routes are available)": true,       "Controller settings": {         "Max speed (km/h)": 60.0,         "Maximum speed when obstacles detected (km/h)": 5.0,         "Chase mode settings": {           "Chase attacking players?": true,           "Max chase distance": 150.0,           "Chase timer": 120.0         }       },       "Turret Settings (will add the specified amount to each suitable module)": {         "Enable Turrets on Vehicle": false,         "Disable Turrets on Event End": true,         "Maximum Attack Range": 50.0,         "Player Damage Multiplier": 0.5,         "Max turrets amount": 1,         "At what percentage of the module's remaining health remove the turret installed on it": {           "Min": 2.0,           "Max": 5.0         }       },       "Damage receive rate": 1.0,       "Fuel settings": {         "Enable automatic fuel refueling?": true,         "Remove fuel when unlocking vehicle?": true,         "Maximum fuel in vehicle": 500       },       "Vehicle headlight settings": {         "Enable vehicle headlights?": true,         "Use headlights only at night?": true       },       "Detonator settings": {         "Add C4 to the vehicle after the death of the driver (used to despawn vehicles)": true,         "After how many seconds explosives will be blown up": 60.0,         "Explosives position offset": {           "x": 0.0,           "y": 0.8,           "z": 0.0         }       }     },     {       "Activate this event?": true,       "Transport type for event (Random2Module, Random3Module, Random4Module, Module2, Module3, Module4)": "Random3Module",       "Driver name (key) from driver settings in DriverController plugin": "DriverCar",       "Companion name (key) from companion settings in DriverController plugin (list to occupy free seats in the vehicle)": [         "Companion1",         "Companion2"       ],       "Engine settings": {         "Engine parts level (1 - 3)": 1,         "Drop the parts when destroying vehicle?": false       },       "Loot container settings": {         "Enable loot in vehicle container?": true,         "Drop the loot when destroying the transport?": false,         "Amount of slots": 1,         "Name of loot set from loot settings in DriverController plugin (list loot sets for random selection)": [           "ResourcesCar"         ]       },       "Use Road Routes (has priority over off-road)": true,       "Use Off-Road Routes (used if no road routes are available)": true,       "Controller settings": {         "Max speed (km/h)": 60.0,         "Maximum speed when obstacles detected (km/h)": 5.0,         "Chase mode settings": {           "Chase attacking players?": true,           "Max chase distance": 150.0,           "Chase timer": 120.0         }       },       "Turret Settings (will add the specified amount to each suitable module)": {         "Enable Turrets on Vehicle": false,         "Disable Turrets on Event End": true,         "Maximum Attack Range": 50.0,         "Player Damage Multiplier": 0.5,         "Max turrets amount": 1,         "At what percentage of the module's remaining health remove the turret installed on it": {           "Min": 2.0,           "Max": 5.0         }       },       "Damage receive rate": 1.0,       "Fuel settings": {         "Enable automatic fuel refueling?": true,         "Remove fuel when unlocking vehicle?": true,         "Maximum fuel in vehicle": 500       },       "Vehicle headlight settings": {         "Enable vehicle headlights?": true,         "Use headlights only at night?": true       },       "Detonator settings": {         "Add C4 to the vehicle after the death of the driver (used to despawn vehicles)": true,         "After how many seconds explosives will be blown up": 60.0,         "Explosives position offset": {           "x": 0.0,           "y": 0.8,           "z": 0.0         }       }     }   ] } 📑 DriverController Configuration:
{   "Drivers settings": {     "DriverBike": {       "Bot health": {         "Min": 100.0,         "Max": 150.0       },       "Prevent attacking players first?": true,       "Damage receive rate": 2.0,       "Damage rate": 2.0,       "Spawn bag with items instead of corpse on death?": true,       "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,       "Clothes": [         {           "Item": {             "Item shortname or ID": "shoes.boots",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         },         {           "Item": {             "Item shortname or ID": "wood.armor.pants",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         },         {           "Item": {             "Item shortname or ID": "pants",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         },         {           "Item": {             "Item shortname or ID": "wood.armor.jacket",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         },         {           "Item": {             "Item shortname or ID": "hoodie",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         },         {           "Item": {             "Item shortname or ID": "riot.helmet",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Weapons": [         {           "Item": {             "Item shortname or ID": "pistol.revolver",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Bot loot": {         "Enable loot after bot's death?": true,         "Amount of slots": 5,         "Loot set name (key) from loot settings (you can enter many sets for random selection)": [           "ResourcesDriver"         ]       }     },     "DriverCar": {       "Bot health": {         "Min": 100.0,         "Max": 150.0       },       "Prevent attacking players first?": true,       "Damage receive rate": 2.0,       "Damage rate": 2.0,       "Spawn bag with items instead of corpse on death?": true,       "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,       "Clothes": [         {           "Item": {             "Item shortname or ID": "hazmatsuit",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Weapons": [         {           "Item": {             "Item shortname or ID": "rifle.ak",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Bot loot": {         "Enable loot after bot's death?": true,         "Amount of slots": 5,         "Loot set name (key) from loot settings (you can enter many sets for random selection)": [           "ResourcesDriver"         ]       }     },     "DriverBoat": {       "Bot health": {         "Min": 100.0,         "Max": 150.0       },       "Prevent attacking players first?": true,       "Damage receive rate": 2.0,       "Damage rate": 2.0,       "Spawn bag with items instead of corpse on death?": true,       "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,       "Clothes": [         {           "Item": {             "Item shortname or ID": "hazmatsuit",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Weapons": [         {           "Item": {             "Item shortname or ID": "t1_smg",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Bot loot": {         "Enable loot after bot's death?": true,         "Amount of slots": 5,         "Loot set name (key) from loot settings (you can enter many sets for random selection)": [           "ResourcesDriver"         ]       }     },     "PilotHeli": {       "Bot health": {         "Min": 100.0,         "Max": 150.0       },       "Prevent attacking players first?": true,       "Damage receive rate": 2.0,       "Damage rate": 2.0,       "Spawn bag with items instead of corpse on death?": true,       "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,       "Clothes": [         {           "Item": {             "Item shortname or ID": "jumpsuit.suit.blue",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Weapons": [         {           "Item": {             "Item shortname or ID": "rifle.ak",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Bot loot": {         "Enable loot after bot's death?": true,         "Amount of slots": 5,         "Loot set name (key) from loot settings (you can enter many sets for random selection)": [           "ResourcesDriver"         ]       }     }   },   "Companion settings": {     "Companion1": {       "Bot health": {         "Min": 100.0,         "Max": 150.0       },       "Prevent attacking players first?": true,       "Damage receive rate": 2.0,       "Damage rate": 2.0,       "Spawn bag with items instead of corpse on death?": true,       "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,       "Clothes": [         {           "Item": {             "Item shortname or ID": "hazmatsuit_scientist_nvgm",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Weapons": [         {           "Item": {             "Item shortname or ID": "rifle.ak",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Bot loot": {         "Enable loot after bot's death?": true,         "Amount of slots": 5,         "Loot set name (key) from loot settings (you can enter many sets for random selection)": [           "ResourcesCompanion",           "WeaponsCompanion"         ]       }     },     "Companion2": {       "Bot health": {         "Min": 100.0,         "Max": 150.0       },       "Prevent attacking players first?": true,       "Damage receive rate": 2.0,       "Damage rate": 2.0,       "Spawn bag with items instead of corpse on death?": true,       "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,       "Clothes": [         {           "Item": {             "Item shortname or ID": "hazmatsuit.arcticsuit",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Weapons": [         {           "Item": {             "Item shortname or ID": "rifle.ak",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Bot loot": {         "Enable loot after bot's death?": true,         "Amount of slots": 5,         "Loot set name (key) from loot settings (you can enter many sets for random selection)": [           "ResourcesCompanion",           "WeaponsCompanion"         ]       }     },     "Companion3": {       "Bot health": {         "Min": 100.0,         "Max": 150.0       },       "Prevent attacking players first?": true,       "Damage receive rate": 2.0,       "Damage rate": 2.0,       "Spawn bag with items instead of corpse on death?": true,       "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,       "Clothes": [         {           "Item": {             "Item shortname or ID": "hazmatsuit.lumberjack",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Weapons": [         {           "Item": {             "Item shortname or ID": "rifle.ak",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Bot loot": {         "Enable loot after bot's death?": true,         "Amount of slots": 5,         "Loot set name (key) from loot settings (you can enter many sets for random selection)": [           "ResourcesCompanion",           "WeaponsCompanion"         ]       }     },     "Companion4": {       "Bot health": {         "Min": 100.0,         "Max": 150.0       },       "Prevent attacking players first?": true,       "Damage receive rate": 2.0,       "Damage rate": 2.0,       "Spawn bag with items instead of corpse on death?": true,       "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,       "Clothes": [         {           "Item": {             "Item shortname or ID": "hazmatsuit.spacesuit",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Weapons": [         {           "Item": {             "Item shortname or ID": "rifle.ak",             "Item skin": 0           },           "Item custom name (if not needed leave empty)": null,           "Amount": 1         }       ],       "Bot loot": {         "Enable loot after bot's death?": true,         "Amount of slots": 5,         "Loot set name (key) from loot settings (you can enter many sets for random selection)": [           "ResourcesCompanion",           "WeaponsCompanion"         ]       }     }   },   "Loot settings": {     "ResourcesBike": [       {         "Item": {           "Item shortname or ID": "wood",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 5000.0,           "Max": 50000.0         }       },       {         "Item": {           "Item shortname or ID": "stones",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 1000.0,           "Max": 10000.0         }       }     ],     "ResourcesCar": [       {         "Item": {           "Item shortname or ID": "wood",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 5000.0,           "Max": 50000.0         }       },       {         "Item": {           "Item shortname or ID": "stones",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 1000.0,           "Max": 10000.0         }       }     ],     "ResourcesBoat": [       {         "Item": {           "Item shortname or ID": "wood",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 5000.0,           "Max": 50000.0         }       },       {         "Item": {           "Item shortname or ID": "stones",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 1000.0,           "Max": 10000.0         }       }     ],     "ResourcesHeli": [       {         "Item": {           "Item shortname or ID": "wood",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 5000.0,           "Max": 50000.0         }       },       {         "Item": {           "Item shortname or ID": "stones",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 1000.0,           "Max": 10000.0         }       }     ],     "ResourcesDriver": [       {         "Item": {           "Item shortname or ID": "wood",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 1000.0,           "Max": 10000.0         }       },       {         "Item": {           "Item shortname or ID": "stones",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 100.0,           "Max": 1000.0         }       }     ],     "ResourcesCompanion": [       {         "Item": {           "Item shortname or ID": "wood",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 100.0,           "Max": 1000.0         }       },       {         "Item": {           "Item shortname or ID": "stones",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 100.0,           "Max": 100.0         },         "Amount": {           "Min": 10.0,           "Max": 100.0         }       }     ],     "WeaponsCompanion": [       {         "Item": {           "Item shortname or ID": "rifle.ak",           "Item skin": 0         },         "Item custom name (if not needed leave empty)": null,         "Spawn chance (0-100%)": {           "Min": 40.0,           "Max": 80.0         },         "Amount": {           "Min": 1.0,           "Max": 1.0         }       }     ]   } }  

Set your server apart with a roaming mobile event that has nearly endless configuration options! Configure the loot truck as well as the Convoy of protection vehicles ranging from sedans, module cars, Bradley tanks, motorbikes, vendor trucks, to a patrol helicopter! The plugin runs on custom and procedural generated maps, can use custom routes or let the plugin find a random route based on your configuration.
You can make yours an aggressive or a peaceful Convoy, who shoots first? You can set all kinds of parameters regarding the many pieces of the event, how to beat it, whether destroying the loot truck destroys the loot or not for example. There are many compatible plugins like TruePVE, GUIAnnouncements, Notify, DiscordMessages, and RustCord to name a few. The plugin has a built in UI that will give you important information about the event as you are inside it's zone. Check the map to see the location of the event as a marker and even see the timer on the event! All of the ground vehicles are driven and filled with NPCs. Every vehicle, the NPCs, and the loot as well as all timers can be configured to suit your server. A PvP zone can be created within the event area for those of you who use TruePVE to control damage on your servers. The limits are nearly endless!
If you have some players on your server that you want to really send everything you have at, this is the plugin for you. Watch players crap their pants when they first encounter a full Convoy with multiple tanks and a Patrol Heli all attacking at once. Sit back and delight in their fear as all of the vehicles empty their occupants and NPCs swarm them mercilessly!

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)
/convoystart - launches the event using a random preset based on your configuration /convoystart PresetName - add the name of a preset from the configuration to launch a specific preset /convoystop - stops the event /convoyroadblock - the event will not be held on the road where you are standing (clear the Blocked roads section of config when you change maps) /convoypathstart - stand at starting point and enter command to start recording a custom route /convoypathsave RoutePresetName - to save a custom route (enter anything you'd like in place of RoutePresetName) multiple routes can be added to one route preset, one will be selected at random in this case /convoypathcancel - to reset the route  
Console commands (RCON only)
convoystart - launches the event using a random preset based on your configuration convoystart PresetName - add the name of a preset from the configuration to launch a specific preset convoystop - stops the event  
Plugin Config
en  –  example of plugin configuration in English ru  –  example of plugin configuration in Russian  
API
bool IsConvoyVehicle(BaseEntity entity) bool IsConvoyCrate(BaseEntity crate) bool IsConvoyHeli(BaseHelicopter baseHelicopter) bool IsConvoyNpc(ScientistNPC scientistNPC) Hooks
void OnConvoyStart() - яalled when a convoy appears void OnConvoyStop() - яalled when a convoy disappears void  OnPlayerEnterConvoy(BasePlayer player) -  яalled when a player enters the event area void  OnPlayerExitConvoy(BasePlayer player) -  яalled when the player leaves the event area void  OnConvoyEventWin(ulong userId) -  called at the end of the event and informs about its winner void OnConvoyStartMoving(Vector3 convoyPosition) void OnConvoyStopMoving(Vector3 convoyPosition) void OnConvoyAttacked(BasePlayer player, Vector3 convoyPosition)  
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!

Adds UAV Function to in game Drones
 
All that needs to be done is set Drone Identifier to   " UAV" and then something unique     ex. "UAVnoob" (Can be Changed via config)
remember you don't want others to control your drone
 
NOTE: all other RemoteConnections with the identifier starting with your prefix will be removed when leaving computerstation  
so when you open ComputerStation , all your teammates(and your own) drones with the UAV in identifier will be displayed,
and when you have the perms the drone will ping all players near it(other players red and teammates green,NPC purple)  😄
UI to see Direction and buttons to toggle pings
 
Remote UAV . you need a RFtransmitter and a Computer station in inventory
then setting RF to FREQ 9992 (to be config soon) will remote deploy computerstation.
 
Permissions
 
 UAVDrone.silent      -   Players with this permission can use function to not alert pinged players
UAVDrone.admin      -    Players with this permission dont show up on pings
UAVDrone.use          -   Players with this permission can use UAV ability
UAVDrone.npc          -   allows players to ping Scientists
 
 
CONFIG
{ "CustomSoundPrefab": "assets/bundled/prefabs/fx/invite_notice.prefab", "DroneRange": 5000.0, "IdentifierPrefix": "UAV", "Pingfrequency": 9.0, "PingPlayersinsidebases": true, "PingRange": 150.0, "PlayPingSound": true, "UseCustomSound": false, "UsePluginDroneLightSystem": true }  
LANGUAGE FILE
{ "Pinged": "You are being <color=red>Pinged</color> by a UAV Drone!!!!" }  
 
Videos
Preview
 
 

Enjoy a highly customizable Shop that can be configured in game! Use NPCs as shopkeepers, and set up a shop with ease using the game interface to add, edit, or remove items on the fly!
 

 
⭐ Features of Shop
Beautiful user interface Discount system (by permissions) Automatic shop filling (+ the plugin has support for the ItemCostCalculator plugin) Selling items (players can sell items to the store and receive money for it) Performance Adding/editing/removing items IN GAME Supports NPC Supports Custom Vending Machines Supports NoEscape Convert from ServerRewards Favorite  items By default, the plugin has English, Russian and Chinese translations Transfer money between players directly in the plugin! Shop allows you to use multiple economy plugins at once (players can choose what they want to pay with) For each item, you can choose which payment methods are available and how much they will cost, based on the selected method  
🎮 Commands
shop  - open shop interface   shop.install – starts the shop installation process shop.refill <recovery_rate> -  refill shop again
recoveryRate: A value between 0 and 1 that determines the multiplier for the cost of selling items. For example, shop.refill 0.5 means that items will have a sale cost of 50% of their purchase cost. shop.convert.sr [clear]  - convert items from ServerRewards to Shop. The option clear means clearing Shop items before convert shop.setvm [categories: cat1 cat2 ...]  - add custom VM in config shop.setnpc  [categories: cat1 cat2 ...]  - add  NPC in config shop.remove all - a console command to remove all items and categories from the plugin shop.remove item [category name/all] - a console command to remove an item (or all items) shop.remove category [category name/all] - a console command to remove a  category (or all categories) shop.fill.icc  [all/buy/sell] - a console command for updating prices of items in the store using ItemCostCalculator. all - updates both Price and SellPrice, buy - updates Price, sell - updates SellPrice shop.convert.from.1.2.26 –  command to convert Shop plugin version 1.2.26 to version 1.3.0+ shop.reset – resets store data, including templates, configurations, and items. shop.reset template – resets the store interface template data. shop.reset config – resets store configuration data. shop.reset items – resets store items data. shop.reset full – completely resets all store data (templates, configurations and items). shop.manage  – used to manage the Shop plugin. shop.manage economy list – displays a list of all available economic systems in the plugin. shop.manage economy set <economy_ID> <name>  – ыets the selected economic system by plugin ID and name. The command updates the corresponding economic system on the server and saves the changes in the configuration. FOR EXAMPLE:
shop.manage economy set 0 Economics – sets the main economy plugin to "Economics”.
shop.manage economy set 1 ServerRewards – sets the additional economy system with ID 1 to "ServerRewards”.  
🛡️ Permissions
shop.setvm  - for  command "shop.setvm" shop.setnpc  - for  command "shop.setnpc" shop.free  - for free item purchases shop.admin  -  admin permission  
⚖️ Sort Types
None Name Amount PriceDecrease PriceIncrease  
🧬 Category Types
None – normal category for items Favorite – category for favorite items Hided  – hidden category, available only in NPC stores or Vending Machines  
🎥 Video
P.S. Video of the old version, video for the V2+ version is now in development

🖼️  Showcase
Full screen Templates
Template OLD STYLE
Template NEW RUST
In-Menu Templates
Template V1 (V1.1)
Template V1 (V1.1) with BASKET
Template V2
Template V2 with BASKET
Installer

Editor

 
🧪  TEST SERVER
Join our test server to view and experience all our unique features yourself!
Copy the IP Address below to start playing!
connect 194.147.90.239:28015  
📚 FAQ
Q: I get the message "The plugin does not work correctly, contact the administrator!”. What should I do?  
A: This means that your plugin is not installed. To install the plugin, use the command "/shop.install”. You need to have "shop.admin” permission to access this command.  

Q: Where can I see an example of a config?
A:    Config
Q: How to use BankSystem to store the economy
A:  
"Economy": { "Type (Plugin/Item)": "Plugin", "Plugin name": "BankSystem", "Balance add hook": "Deposit", "Balance remove hook": "Withdraw", "Balance show hook": "Balance", "ShortName": "", "Display Name (empty - default)": "", "Skin": 0, "Lang Key (for Title)": "LangTitle", "Lang Key (for Balance)": "BalanceTitle" }, Q: How to use ServerRewards to store the economy
A:  
"Economy": { "Type (Plugin/Item)": "Plugin", "Plugin name": "ServerRewards", "Balance add hook": "AddPoints", "Balance remove hook": "TakePoints", "Balance show hook": "CheckPoints", "ShortName": "", "Display Name (empty - default)": "", "Skin": 0, "Lang Key (for Title)": "LangTitle", "Lang Key (for Balance)": "BalanceTitle" }, Q: How to use Economics to store the economy
A:  
"Economy": { "Type (Plugin/Item)": "Plugin", "Plugin name": "Economics", "Balance add hook": "Deposit", "Balance remove hook": "Withdraw", "Balance show hook": "Balance", "ShortName": "", "Display Name (empty - default)": "", "Skin": 0, "Lang Key (for Title)": "LangTitle", "Lang Key (for Balance)": "BalanceTitle" },  Q: How to use IQEconomic  to store the economy
A:  
"Economy": { "Type (Plugin/Item)": "Plugin", "Plugin name": "IQEconomic", "Balance add hook": "API_SET_BALANCE", "Balance remove hook": "API_GET_BALANCE", "Balance show hook": "API_REMOVE_BALANCE", "ShortName": "", "Display Name (empty - default)": "", "Skin": 0, "Lang Key (for Title)": "LangTitle", "Lang Key (for Balance)": "BalanceTitle" }, Q: How to use scrap to pay for items
A:  
"Economy": { "Type (Plugin/Item)": "Item", "Plugin name": "", "Balance add hook": "", "Balance remove hook": "", "Balance show hook": "", "ShortName": "scrap", "Display Name (empty - default)": "", "Skin": 0, "Lang Key (for Title)": "LangTitle", "Lang Key (for Balance)": "BalanceTitle" }, Q: How to add KIT as shop item
A:  https://pastebin.com/4szBQCgz
Q: How to add Command as shop item
A:  https://pastebin.com/bcCkzBEL
Q:  How do I make a weapon spawn with ammo in it?
A:  You need to configure the "Weapon" section in the item config:
"Weapon": { "Enabled": true, "Ammo Type": "ammo.rifle.explosive", "Ammo Amount": 128 } Q:  How do I make items spawn some content (liquid, weapon modifications)?
A:  You need to configure the "Content" section in the item config:
"Content": { "Enabled": true, "Contents": [ { "ShortName": "weapon.mod.lasersight", "Condition": 100.0, "Amount": 1, "Position": -1 } ] }, Q: How to turn off the sell feature?  
A: You need to turn off "Enable item selling” in the config, or do it in the item setting in the game.  
"Enable item selling?": false,
Q: How to use the ItemCostCalculator with Shop?  
A: You need to use command "shop.refill" (command to refill the Shop)
Q: What should be the size of images for item icons?
A:  Typically, the image dimensions for item icons are 512x512 pixels, but any square image can suffice.
Q: I get the error "UI is unavailable for player. Reason: Menu UI is not initialized". How to fix it?
A: This error occurs when the interface template is not installed or configured. Follow these steps:
1. Reset the template using the command: shop.reset template (use only template to avoid data loss).
2. Install the interface via shop.install in the game (to visually select a template) or through the console.
Note: Ensure you have the shop.admin permission to execute these commands.
Q: How do I add Shop 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: Shop Plugin Hook: API_OpenPlugin 3. Click "SAVE" button to create the category
4. Reset Shop template and install it:
Type in console: shop.reset template (IMPORTANT: use only "template"!) Then type: shop.install Note: If Shop doesn't appear in ServerPanel menu, make sure both plugins are loaded and you typed the parameters exactly as shown above.
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. To fix this, enable Offline Image Mode which will use local images instead:
Enable the mode in config: Open "oxide/config/Shop.json" (or "carbon/config/Shop.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 Shop (Oxide) or c.reload Shop (Carbon) Note: If using a hosting service, you may need to use their file manager or FTP to upload the files.
Q: What placeholders are available for commands and what do they do?
A: You can use these placeholders in shop commands and they will be automatically replaced when a player purchases a command item:
%steamid% - Replaced with the player's Steam ID (e.g., "76561198000000000") %username% - Replaced with the player's display name (e.g., "PlayerName") %player.x% - Replaced with the player's X coordinate position %player.y% - Replaced with the player's Y coordinate position %player.z% - Replaced with the player's Z coordinate position Example usage in shop commands:
"Command (%steamid%)": "say Welcome %username%!|teleport %steamid% %player.x% %player.y% %player.z%" Note: Multiple commands can be separated by the "|" character, and they will be executed in sequence when the item is purchased.
Q: How to set different prices for different currencies (RP and balance)?
A: You can configure separate currency prices for each item. Edit the file oxide/data/Shop/Shops/Default.json and find the item you want to modify. In the "Currencies" section, set different prices for each economy:
"Currencies": { "Enabled": true, "Currencies": { "0": {"Price": 1000}, "1": {"Price": 500} } } This means players pay 1000 from their main balance (Economics) or 500 RP from their ServerRewards balance. Economy ID 0 = main economy, ID 1 = ServerRewards.
Q: How to create a shop using HumanNPC plugin and set specific categories?
A: To create a shop with HumanNPC, follow these steps:
Create an NPC using HumanNPC plugin Get the NPC ID (you can find it in the HumanNPC config or use the command humannpc.list) Use the Shop command to add the NPC: shop.setnpc [categories: cat1 cat2 ...] Example:
shop.setnpc categories: Weapon Ammunition Tools - adds the NPC with Weapon, Ammunition, and Tools categories
shop.setnpc categories: * - adds the NPC with all available categories
Note: You need the shop.setnpc permission to use this command. Make sure both HumanNPC and Shop plugins are loaded on your server.
Q: How to add Custom Vending Machines to Shop plugin?
A: To add Custom Vending Machines to Shop, follow these steps:
Place a Custom Vending Machine in your world Look at the vending machine and use the command: shop.setvm [categories: cat1 cat2 ...] Example:
shop.setvm categories: Weapon Ammunition - adds the vending machine with Weapon and Ammunition categories
shop.setvm categories: * - adds the vending machine with all available categories
Note: You need the shop.setvm permission to use this command. The vending machine will be automatically added to the Shop configuration.