AshCrack's Wishlist

Bring these intelligent animal companions to your server! They can fight, gather resources, carry supplies, and even be ridden. Choose from various customizable animals: bear, boar, chicken, deer, wolf, crocodile, panther or tiger! (new gen2 animals are supported, but in beta)
 
Features:
✔️ Resource Gathering & Looting
• Collect essential resources like wood, stone, and ore.
• Automatically gather resources within 50 meters using auto-pickup.
• Loot crates and boxes for valuable items.
✔️ A True Companion
• Command your animal to attack enemies, structures, or objects.
• Ride your animal for faster travel.
• Store items in the animal’s inventory (configurable up to 36 slots).
• Keep your companion healthy with a nutrition system that restores health.

Total Customization & Control
🎯 Animal Settings
• Select your preferred animal: Bear, Boar, Chicken, Deer, Wolf, Crocodile, Panther or Tiger.
• Configure max health, respawn time, and combat abilities.
• Adjust damage rates, player interactions, and looting permissions.
🛠️ User-Friendly Controls & UI
• Assign commands with a customizable buttons.
• Display 3D arrows over targets for better visibility.
• Fully customize the GUI layout, colors, and refresh rate.
• Blacklist specific items from your animal’s inventory bag.
🍖 Feeding System
• Enable nutrition settings to maintain your animal’s health.
• Configure health restoration values for different food items.
   
Useful Commands:
✅ /panimal – Spawn or despawn your animal.
✅ /panimal follow – Have your animal follow you.
✅ /panimal health – Check your animal’s current health.
✅ /panimal auto-pickup enable/disable – Turn resource auto-collection on or off.
✅ /panimal where – Locate your animal on the map.
📸 See It in Action! Watch the Video
📃 Configuration:
{   "Controls setup": {     "Which button will assign tasks to the animal, attack / collect, etc. (MIDDLE_MOUSE, SECOND_MOUSE, E, RELOAD, SPRINT)": "MIDDLE_MOUSE",     "Range of action of the assignment button": 25.0,     "Display 3D arrows over a target?": true,     "Arrow display duration": 2   },   "GUI setup": {     "How many seconds to update the GUI?": 6,     "Panel layer (Hud, Overlay, Overall, Hud.Menu, Under)": "Overlay",     "Panel position": {       "type": "RectTransform",       "anchormin": "1 1",       "anchormax": "1 1",       "offsetmin": "-170 -104",       "offsetmax": "-10 -10"     },     "Second position of the panel (used if the player has a personal bot)": {       "type": "RectTransform",       "anchormin": "0.0 0.0",       "anchormax": "1.0 1.0",       "offsetmin": "0.0 0.0",       "offsetmax": "0.0 0.0"     },     "1 panel color": "#7f8c8d",     "2 panel color": "#bdc3c7",     "Health bar color": "#2ecc71",     "Shortcut buttons": []   },   "Setting up personal animals by permission": {     "personalanimal.wolf": {       "The name of the animal to be selected through the command when spawning": "wolf",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "wolf",       "Maximum health": 200,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     },     "personalanimal.bear": {       "The name of the animal to be selected through the command when spawning": "bear",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "bear",       "Maximum health": 200,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     },     "personalanimal.boar": {       "The name of the animal to be selected through the command when spawning": "boar",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "boar",       "Maximum health": 200,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     },     "personalanimal.chicken": {       "The name of the animal to be selected through the command when spawning": "chicken",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "chicken",       "Maximum health": 200,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     },     "personalanimal.stag": {       "The name of the animal to be selected through the command when spawning": "stag",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "stag",       "Maximum health": 200,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     },     "personalanimal.polarbear": {       "The name of the animal to be selected through the command when spawning": "polarbear",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "polar-bear",       "Maximum health": 400,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     }   },   "List of prefabs that the animal can loot (useful if the animal attacks loot instead of looting it)": [     "foodbox",     "vehicle_parts"   ] }  

The aim for this file is to remove the need for some of your Discord plugins and move it externally from your server so you do not have any server impact from those plugins. This offers you a TON of features all ran externally from your server, so no lag! No more dookie Discord extension  

Ultimate RCON+ is a more advanced version of Ultimate RCON

ULTIMATE RCON+ ONLY FEATURES
+ Advanced kill logging + Logging for heli, cargo, cargo plane, ch47, and brad + Multi reason auto mute system + Option plugin integration for more logging features + Permission loggers for group and permission changes + You can now have a player leaderboard for all your servers as-well as a global leaderboard! (Image below) + Server stat display that actively updates with how many players on your server, last wipe, etc* + The bot now saves a database on all players! (Kills, deaths, connections, chat messages, f7 reports, etc) + F7 Reports report counter + Set it to ignore people who are getting F7 reported or sending in F7 reports. + Add players to a watchlist that pings staff when they join. + Player profiler that tracks a lot of information on players (Get data VIA command) + Advanced kill feed. Now logs all sorts of kills and deaths + The bot no longer sometimes misses people joining the server. + Player counts are now tracked for each server, it will save all your peak player counts for all of your servers. (This information can be shown in a stats board) + Those stats for your server can also track the number of messages, connections, kills, and deaths that have been recorded on the server. + Rcon commands no longer need to be sent VIA a slash command + Discord to rust chat no longer needs to be sent through a command + Server offline and online messages + ETC* ULTIMATE RCON+ & ULTIMATE RCON FEATURES
- Bot status = Player count on server (Can change status if the server has recently wipe and include just wiped in the status) - Global status bot = all your servers player counts combined into one - Dynamic server cap changer (Changes the max amount of players allowed on the server depending on the amount of players currently online and or the queue size) - Auto discord wipe announcements - Check players for private profiles - Check players for VAC, EAC, and Temp rust bans - Team and global chat logs - 2 Way chat (Send messages in game through discord) - Leave and join logs - Kill logs - Private message logs - Auto muting players VIA triggered key words - Manual staff muting through discord - RCON Console in Discord with message filtering - Send rcon commands through Discord - F7 report logs - F1 spawn logs - (SERVER) message logs
Plugin info
Permission: ultimaterconplus.admin
Command: /urplus

The bot is very simple to install.
The file includes a setup guide within it. All quite simple.
Need support or want updates about what is coming to the bot? Join the support discord here https://discord.gg/ZsRgCUNv2x

INSTALLATION VIDEO
 

Complete tier 3 package for the Raidable Bases plugin. Core plugin sold separately.
 
PLUGIN SOLD SEPARATELY
This package includes everything you need to avoid the hassle of having to setup the plugin from scratch.
Time is money, and not having to spend hours or days setting everything up is a game changer.
All bases can be viewed in the gallery at the top of this page.
This is the perfect package with a massive 50 base collection surely to wow your players!
Included:
10 bases (copypaste files) for every difficulty which are now unique to tier 1 and tier 2 difficulty loot tables for each difficulty base loot tables for every profile profiles for each difficulty the configuration file all bases are unique to tier 1 and 2 easy to understand instructions Free version note:
The free version can use this tier package, but it only supports one difficulty (Normal) and one Base Loot file. Remove all Base Loot files except the one you want all bases to use. You must also bypass the protection that prevents paid files from loading with the free version, which exists to stop paid users from accidentally erasing paid-only options by installing the free version over them. To bypass it intentionally, edit the config and rename the "Buyable Events" section on line 283 to "blah" or anything else. After that, the package will load with the free version. The paid version does not have these limitations and supports Easy, Medium, Hard, Expert, Nightmare, and custom difficulties. The tier package is still useful with the free version as it includes preconfigured files, copypaste files and works well for servers that manually enable and disable profiles to rotate through harder bases as the wipe progresses.
Paid plugin sold separately.
Instructions (available in zip file)
 

Unique kit system with the highest possible functionality and beautiful design. This will please you (no need to sit in the config every time and try to fill in some incomprehensible values, etc.), and your players (convenient, clear and informative interface). You just start editing items directly in the game) and your players (comfortable, clear, informative interface)!
 

 
🌟  Features of Kits
Beautiful User Interface: Experience a visually appealing and user-friendly design. High Performance: Optimized for fast, reliable performance. Automatic Kit Conversion (uMod): Easily convert your existing kits. In-Game Kit and Item Setup: Configure kits directly in the game. Auto Kits & Wipes (Optional): Automate kit distribution and server wipes. Custom Items & Commands: Assign unique items and commands to kits. Advanced Item Settings: Fine-tune every aspect of your items. CopyPaste Integration: Seamlessly work with CopyPaste. Optional Features: Delays after wipes, set blocking in Building Block, logging, and item chances. Skills & ServerPanel Support: Enhance player experience with integrated support.
🎮  Commands
kit  – open the kit interface kit help  – get help with kits kit autokit  – enable or disable automatic kit.
Requires the "kits.changeautokit" permission. You can set this permission up in the plugin configuration under "Permission to enable/disable autokit". kit list – display all  available kits kit [name] – redeem a specific kit kits.resetkits – delete all kits kits.give [name/steamid] [kitname]  – grant a kit to  player kits.convert – convert from uMod  Kits kits.wipe –  clear players data kits.reset – resets the player data or kits in the kits system. kits.reset data [<targetID>/all] – resets the data of a player or all players.
Parameters:
<targetID>: The ID of the player whose data is to be reset. If you specify all, the data of all players will be reset. kits.reset kits – resets all kits in the data kits.template <interface_type> <interface_style> <template> [template_version] – allows the administrator to customize the appearance of the bundles interface by choosing between fullscreen and inmenu mode. Different styles and templates are available for each interface type. The old style (old) is only available for fullscreen mode, while the new Rust style (rust) is available for both interface types. When using the Rust style, you must specify a specific template such as normal, content, categories or content_categories. For inmenu rust templates, you can also specify the ServerPanel template version (1 or 2).
Parameters: <interface_type>: The type of interface template. Valid values: fullscreen: Fullscreen interface template. inmenu: Menu interface template. <interface_style>: The style of the interface. Valid values: old: The old interface style (fullscreen only). rust: New Rust interface style (for fullscreen and inmenu). <template>: The name of the target template. Valid values depend on the interface style: normal, content, categories, content_categories. [template_version]: (Optional, only for inmenu rust) ServerPanel template version. Valid values: 1 or 2. Specifies the template version to be used with the selected inmenu rust template. Examples: kits.template fullscreen old - Sets the fullscreen interface to the old style. kits.template fullscreen rust normal - Sets the fullscreen interface to the Rust style with the normal template. kits.template fullscreen rust content - Sets the fullscreen interface to the Rust style with the content template. kits.template fullscreen rust categories - Sets the fullscreen interface to the Rust style with the categories template. kits.template fullscreen rust content_categories - Sets the fullscreen interface to the Rust style with the content_categories template. kits.template inmenu rust normal 1 - Sets the menu interface to the Rust style with the normal template for ServerPanel version 1. kits.template inmenu rust content 2 - Sets the menu interface to the Rust style with the content template for ServerPanel version 2. kits.template inmenu rust categories 1 - Sets the menu interface to Rust style with the categories template for ServerPanel version 1. kits.template inmenu rust content_categories 1 - Sets the menu interface to the Rust style with the content_categories template for ServerPanel version 1.  
🎥  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
Default:  

Content:

Categories:

Content & Categories:

 
In-Menu Templates
Template V1 (V1.1)
Default:

Content:

Categories:

Content & Categories:

 
Template V2
 
Default:

Content:

Categories:

Content & Categories:

Template V4 Default:

Content:

Categories:

Content & Categories:

 
Editor

 
⚙️ Web Config Editor
Easily manage your Kits 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. Join our Discord at https://discord.gg/mevent and request the "Kits" group for access to the web configuration 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: Where can I see an example of a config?
A:    Config
Q: Where can I see an example of a data?
A:    Data
Q: How do I add Kits to ServerPanel?
A: To add Kits to your ServerPanel, create a new category in your ServerPanel configuration with these settings:
"Type": "Plugin", "Plugin Name": "Kits", "Plugin Hook": "API_OpenPlugin". Q: Does the Kits plugin support other plugins?
A:  Yes, this Kits plugin has an API similar to other popular kits plugins. If the plugin works with Kits - it works with this plugin too.
Q:  How do I enable the sale of kits?
A:  You need to configure the plugin economy (which plugin, its hooks, etc.), enable "Enable sale" in the Kits data (oxide/data/Kits/Kits.json or carbon/data/Kits/Kits.json) and set the price to "Selling price"
"Enable sale": true, "Selling price": 100, Q:  How do I use Economics to pay for kits?
A:  Example configuration settings:
"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 }, Q:  How do I use ServerRewards  to pay for kits?
A:  Example configuration settings:
"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 }, Q:  How do I use scrap  to pay for kits?
A:  Example configuration settings:
"Economy": { "Type (Plugin/Item)": "Item", "Plugin name": "", "Balance add hook": "", "Balance remove hook": "", "Balance show hook": "", "ShortName": "scrap", "Display Name (empty - default)": "", "Skin": 0 }, Q:  How do I resize the kit image?
A:  You can do this in the config, here's an example of the image setup (-32 and 32 are width, and -75 and -11 are height😞
"Kit Image": { "AnchorMin": "0.5 1", "AnchorMax": "0.5 1", "OffsetMin": "-32 -75", "OffsetMax": "32 -11" }, Q:  How can I remove the numbers on the kits ("#1", "#2", etc.)?
A:  You need to turn off "Show Number?" in the config:
"Show Number?": false, Q:  How do I make it so that others can see kits with different permissions without being able to claim them?  
A:  You need to turn off "Show All Kits?" in the config:
"Show All Kits?": true, Q:  Where can I edit the names in the plugin or add my own language?
A:  You can edit lang files that are located (for example) at "oxide/lang/en/Kits.json" or "carbon/lang/en/Kits.json".
Q:  Players get "The plugin does not work correctly, contact the administrator!" message. How to fix?
A:  This error occurs when the ImageLibrary plugin is not working properly. Solutions:
Install the ImageLibrary plugin if it's not installed. Make sure ImageLibrary is loaded and running properly (check with o.plugins command). Restart the server after installing ImageLibrary. Check server console for ImageLibrary errors and fix them. 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 Kits 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/Kits.json" (or "carbon/config/Kits.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 Kits (Oxide) or c.reload Kits (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 placeholders are available for commands and what do they do?
A:  You can use these placeholders in kit commands and they will be automatically replaced:
%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 kit commands:
"Commands on receiving (via '|')": "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 kit is redeemed.
 
🛠️  HOOKS
private string[] canRedeemKit(BasePlayer player) private void OnKitRedeemed(BasePlayer player, string kitName) private double  OnKitCooldown(BasePlayer player, double cooldown)  
🧩  API
private bool TryClaimKit(BasePlayer player, string name, bool usingUI) private string[] GetAllKits() private object GetKitInfo(string kitname) private string[] GetKitContents(string kitname) private double GetKitCooldown(string kitname) private double PlayerKitCooldown(ulong ID, string kitname) private int KitMax(string kitname) private double PlayerKitMax(ulong ID, string kitname) private string KitImage(string kitname) private bool IsKit(string kitname) private bool isKit(string kitname) private void GetKitNames(List<string> list) private double GetPlayerKitCooldown(ulong userId, string name) private double GetPlayerKitCooldown(string userId, string name) private void SetPlayerCooldown(ulong userId, string name, int amount) private int GetPlayerKitUses(ulong userId, string name) private int GetPlayerKitUses(string userId, string name) private void SetPlayerKitUses(ulong userId, string name, int amount) private JObject GetKitObject(string name) private int GetKitMaxUses(string name) private string GetKitDescription(string name) private string GetKitImage(string name) private bool GiveKit(BasePlayer player, string name, bool usingUI) private bool HasKitAccess(string userId, string name) private int GetPlayerKitAmount(string userId, string name)

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 with multiple templates (Fullscreen, In-Menu V1/V2/V4) Shopping Basket - add multiple items to cart and purchase them all at once Search functionality - search for items by name across all categories Pagination - efficient item browsing with page-by-page navigation Discount system (by permissions) with per-item custom discounts 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) Sell containers configuration - choose which containers (main, belt) players can sell from Blocked skins - prevent selling of specific item skins High performance with optimized item loading Adding/editing/removing items IN GAME with visual editor Supports NPC shops (HumanNPC integration) Supports Custom Vending Machines Supports NoEscape plugin integration Supports Duel/Duelist - blocks shop access during duels Convert from ServerRewards Favorite items system - players can mark items as favorites Buy Again feature - quick repurchase of previously bought items By default, the plugin has English, Russian and Chinese translations LangAPI integration for custom translations Transfer money between players directly in the plugin (including offline players option) 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 Cooldown system - per-item buy/sell cooldowns with per-permission overrides Wipe cooldown - block items for purchase/sale after server wipe Respawn cooldown - prevent shop access immediately after respawn Buy/Sell limits - lifetime and daily limits per permission Max buy/sell amount - limit items per transaction Force buy - fast purchase without confirmation dialogs Plant genes configuration for plant items Weapon configuration - spawn weapons with ammo and attachments Content system - configure container contents (liquid, weapon mods, etc.) Customizable UI - full color customization and formatting options Offline Image Mode - use local images instead of downloading from internet Image loading on login - preload images when players connect Console and file logging - comprehensive logging system ServerPanel integration - add Shop to ServerPanel menu Notify/UINotify integration for notifications Auto-wipe settings - automatically reset cooldowns, limits, and player data on wipe Discord Logging - Track all purchases, sales, and transfers directly in your Discord server via webhooks with customizable embeds API methods for other plugins to interact with Shop  
🎮 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 converting 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>  – sets 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". shop.wipe – manually trigger wipe (resets cooldowns, limits, and player data) shop.change – change item category (used in editor) shop.item – console command for item actions  
🛡️ Permissions
shop.setvm  - for  command "shop.setvm" shop.setnpc  - for  command "shop.setnpc" shop.free  - for free item purchases shop.admin  -  admin permission shop.bypass.dlc - allows bypassing Facepunch ToS item restrictions (WARNING: your server may be banned for this)  
📈 API Methods
The Shop plugin provides API methods for other plugins to interact with it:
API_OpenPlugin(BasePlayer player) – opens the shop UI for a player. Returns empty string if failed, or UI data if successful. API_GetShopPlayerSelectedEconomy(ulong playerID) – returns the economy ID (0 = main, 1+ = additional) that the player has selected for shopping. Note: Other plugins can call these methods using Shop.Call("API_MethodName", ...) syntax.
 
⚖️ Sort Types
None Name Amount PriceDecrease PriceIncrease  
🧬 Category Types
None – normal category for items Favorite – category for favorite items Hidden  – 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
Template V4
Template V4 with BASKET
Installer

Editor

 
📢 Discord Logging
Track all shop activity via Discord webhooks: purchases, sales, and money transfers.



 
🧪  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. The Shop 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/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 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 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.
Q: How does the Shopping Basket feature work?
A: The Shopping Basket allows players to add multiple items to a cart before purchasing. Players can add items to the basket, review their selection, and purchase everything at once. The basket shows the total cost and allows players to remove items before checkout. This feature must be enabled in the template settings.
Q: How does the Search functionality work?
A: The Search feature allows players to search for items by name across all categories. Simply type in the search box and the shop will filter items matching your query. Search works across all enabled categories and respects permission settings. The search feature can be enabled/disabled in the template configuration.
Q: What are Wipe Cooldown and Respawn Cooldown?
A: These are time-based restrictions:
Wipe Cooldown: Blocks items from being bought/sold for a specified time after a server wipe. This is useful for preventing powerful items from being purchased immediately after wipe. Configure in config: "Wipe Cooldown": true and "Wipe Cooldown Timer": 3600 (seconds). Respawn Cooldown: Prevents players from opening the shop immediately after respawning. Helps prevent abuse. Configure in config: "Respawn Cooldown": true and "Respawn Cooldown Timer": 60 (seconds). Q: How do Daily and Lifetime Limits work?
A: Limits control how many times players can buy/sell items:
Lifetime Limits: Total number of times a player can buy/sell an item across their entire account. Set to 0 for unlimited. Daily Limits: Maximum number of times per day a player can buy/sell an item. Resets daily. Set to 0 for unlimited. Limits are per-permission, so you can set different limits for VIP players, regular players, etc. The plugin uses the highest limit among all permissions the player has. Q: What is the "Buy Again" feature?
A: Buy Again allows players to quickly repurchase items they have bought before. This feature shows a history button in the shop UI (if enabled) and requires a permission. To enable, set "Buy Again Settings": {"Enabled": true, "Permission": "shop.buyagain"} in the config.
Q: How do I configure blocked skins for selling?
A: You can prevent players from selling specific item skins. In the config, add entries to "Blocked skins for sell":
"Blocked skins for sell": { "rifle.ak": [52, 25], "pistol.m92": [100, 200] } Q: How do I configure which containers players can sell from?
A: In the config, set "Settings available containers for selling item":
"Settings available containers for selling item": { "Enabled": true, "Containers": ["main", "belt"] } Available container names: "main" (inventory), "belt" (hotbar), "wear" (clothing), etc.
Q: What are Auto-Wipe Settings?
A: Auto-Wipe Settings automatically reset certain data when you run the shop.wipe command. Configure in config:
"Auto-Wipe Settings": { "Cooldown": true, "Players": true, "Limits": true } Cooldown: Resets all item cooldowns Players: Resets all player data (favorites, economy selection, etc.) Limits: Resets all buy/sell limits Q: How do I customize price formatting?
A: In the config, set "Formatting Settings" to control how prices are displayed:
"Formatting Settings": { "Buy Price Format": "G", "Sell Price Format": "G", "Shopping Bag Cost Format": "G", "Balance Format": "G" } Format options: "G" (general), "N" (number with separators), "C" (currency), "F" (fixed-point), etc. See .NET number formatting for all options.
Q: How do I enable transfers to offline players?
A: In the config, set "Allow money transfers to offline players?": true. By default, this is disabled for security reasons.
Q: How do I configure Duel/Duelist integration?
A: To block shop access during duels, set "Blocking the opening in duels?": true in the config. Make sure you have the Duel or Duelist plugin loaded.
Q: What do all shop item settings mean and how should I configure them?
A: Below is a short explanation of the most important item fields and how they affect the plugin.
Type – what this entry does: Item (gives an in-game item), Command (runs server commands), Plugin (calls another plugin hook), Kit (gives a kit). ID – unique numeric ID of the item inside Shop. Used internally (for logs, favorites, editor); normally you don’t change it manually. Image – custom UI icon key. If empty, Shop will try to use the item icon found by ShortName. Permission – Oxide/Carbon permission required to see and use this item. Leave empty to make the item available to everyone, or set e.g. shop.vip for VIP‑only items. Title – custom title shown in the UI. If empty, the plugin will try to use DisplayName, then the in‑game display name of the item, or fall back to an empty string. Description – additional text shown in the item window. Optional, purely visual. Command (%steamid%) – used when Type = Command. The plugin will execute this command on the server. You can use placeholders like %steamid%, %username%, %player.x%, %player.y%, %player.z%. Each purchase can run multiple commands (split internally by |). Kit – kit name for Type = Kit. The plugin will give a kit with this name when the player buys the item. Plugin – used for Type = Plugin. Contains plugin name, hook name and amount. When the item is purchased, the specified hook will be called in the target plugin. DisplayName (empty – default) – overrides the in‑game item name shown to the player (for Type = Item). If empty, the plugin uses the original item display name (optionally via Lang API). ShortName – shortname of the item (e.g. rifle.ak). This is required for Type = Item; it is used to find ItemDefinition, icon, stack size, etc. Skin – workshop skin ID for the item. Only used when Type = Item. Is Blueprint – if enabled, Shop will give the item as a blueprint instead of the regular item. Amount – how many items are given/sold per one purchase. For blueprints this is how many separate blueprint items are created. Enable item buying? (CanBuy) – if disabled, the item cannot be bought (only sold, if selling is enabled). Price – default purchase price. Can be overridden per‑economy in Currencies – if a currency is configured for buying, its price will be used instead of this value. Enable item selling? (CanSell) – if disabled, players cannot sell this item back to the shop. Sell Price – default sell price. Can also be overridden in Currencies for selling. Buy Cooldown / Sell Cooldown – base cooldown in seconds between purchases/sales of this item. Can be overridden by per‑permission cooldowns below. Buy Cooldowns / Sell Cooldowns – per‑permission cooldowns. Keys are permission names (e.g. shop.vip), values are cooldown seconds. The plugin uses the lowest cooldown among permissions that the player has. Use custom discount? – if enabled, the item will use its own Discount map instead of the global discount configuration. Discount (%) – per‑permission discount percentages for this item (only if custom discount is enabled). The highest discount from permissions that the player has will be applied. Sell Limits / Buy Limits – global lifetime limits per permission. A value of 0 means “no limit”. The plugin selects the highest limit among permissions the player has. Daily Buy Limits / Daily Sell Limits – per‑day limits (reset by the plugin’s daily logic). 0 means “no daily limit”. Max Buy Amount / Max Sell Amount – maximum number of items that can be bought/sold in a single transaction (0 disables this limit). Force Buy – if enabled, the item will use fast purchase flow (without extra confirmation windows, depending on UI settings). Prohibit splitting item into stacks? – if enabled, the plugin will try to give the item in a single stack instead of splitting it into multiple stacks, when possible. Purchase/Sale block duration after wipe – time (in seconds) after a wipe during which this item cannot be bought/sold. Useful for limiting powerful items early in the wipe. Localization – per‑language messages for the item title. If enabled and a translation exists for the player’s language, it will override the normal title. Content – configuration of contents for containers (e.g. boxes, weapons with attachments, etc.). You can add inner items (shortname, amount, condition, position). Weapon – additional settings for weapons (ammo type, ammo amount, etc.). Applied when the item is created. Genes – plant gene configuration. If enabled, the plugin will set specified genes on the created item. Currencies – per‑economy price configuration. You can set different prices for each enabled economy plugin (by economy ID) for both buying and selling. If a currency is configured and enabled for the player’s selected economy, its price takes priority over the default Price/Sell Price. Q: What do shop category settings mean and how should I configure them?
A: Categories group your shop items and control how they are shown, sorted and filtered for players.
Enabled – turns this category on or off. If disabled, the category and all its items will not appear in the shop UI at all. Category Type – controls special behavior of the category: None – a normal category that shows the items you added to Items. Favorite – a virtual category that shows each player’s favorite items (based on their own favorites list). Items here are taken from other categories the player marked as favorite. Hidden – a hidden category. It is stored in data and can be used for management, but is not shown in the normal category list in UI. Title – the name of the category displayed in the UI. If Localization is enabled and contains a translation for the player’s language, that localized text will be shown instead of this value. Permission – permission required to see and use this category. If you leave it empty, all players can see the category (subject to item‑level rules). If you set e.g. shop.category.vip, only players with that permission will see this category in the shop. Sort Type – how items inside the category are sorted: None – items are shown in the order they are stored/edited. Name – items are sorted alphabetically by their PublicTitle (what the player sees). Amount – items are sorted by Amount (stack size) in ascending order. PriceIncrease – items are sorted by price from cheaper to more expensive. PriceDecrease – items are sorted by price from more expensive to cheaper. Sorting is applied every time the category items are requested. Items – the list of ShopItem entries that belong to this category. For normal categories (Type = None/Hidden) this is what will be displayed in the item grid. For Favorite categories this list is not used for display – the plugin uses the player’s favorites instead. Localization – optional localized title for the category. When enabled, the plugin will try to show a translated title based on the player’s language. If no translation is found, it falls back to the Title field. How visibility and filtering work – when the shop builds a category: For normal categories, only items that are available for the player (permission, currencies, buy/sell rules, etc.) are included. Skip/take pagination is applied on top of that filtered list to show items page by page. For favorite categories, the plugin takes the player’s favorite items, applies sorting, and displays them in this special category. Reordering categories and items – categories and items can be moved up/down (or left/right) in the in‑game editor. This changes the order in which categories are shown in the UI and the default order of items when Sort Type = None. Q: How do I enable and use ADMIN MODE?
A: ADMIN MODE is a visual in-game editor that allows you to manage your shop without editing files manually.
Step 1: Enable ADMIN MODE
Ensure you have the shop.admin permission Open shop with /shop command Click the "ADMIN MODE" button in the header (shows "■" when active) Step 2: Create/Edit Categories
To create a new category:
With ADMIN MODE enabled, click the "+" button in categories list Fill in category details (Title, Enabled, Type, Permission, Sort Type) Click "SAVE" To edit an existing category:
Click the "Edit" button (pencil icon) next to the category Modify settings Click "SAVE" or "CANCEL" Step 3: Create/Edit Items
To create a new item:
Open the target category Click "+ADD ITEM" button Select item from the selection panel Configure all item properties (price, amount, permissions, etc.) Click "SAVE" To edit an existing item:
Click the "Edit" button on the item Modify properties Click "SAVE" or "CANCEL" Additional ADMIN MODE Features:
Use ↑↓ arrows to reorder categories Use ←→ arrows to reorder items within categories Use "DELETE" button in editor to remove categories/items All changes save automatically - no manual file editing needed Q: Where are shop files stored and what do they contain?
A: Shop plugin data is organized in the following structure:
📁 Configuration (oxide/config/Shop.json or carbon/config/Shop.json)
Plugin settings (permissions, commands, economy configuration) Notification settings Discord logging configuration Global plugin options 📁 Shop Data (oxide/data/Shop/Shops/Default.json or carbon/data/Shop/Shops/Default.json)
This is the main shop inventory file All categories and their settings All items with prices, permissions, cooldowns, limits Item configurations (weapons, content, currencies, etc.) Edited through ADMIN MODE or manually 📁 UI Template (oxide/data/Shop/UI.json or carbon/data/Shop/UI.json)
Interface template configuration Colors, sizes, positions Display settings Reset with: shop.reset template then shop.install 📁 Player Data (oxide/data/Shop/Players/ or carbon/data/Shop/Players/)
Individual player files (one per player)