MBShop

 🛒 MBShop — Advanced UI Shop for Rust (Cart, Categories, Multi-Economy)

MBShop is a modern and fully customizable UI-based shop system for Rust, featuring a shopping cart, category system, image-based interface, and multi-economy support.
Designed for smooth gameplay, performance, and professional server presentation.

Perfect for PvP, PvE, modded, and commercial servers.

✅ Key Features

🛍 Full Shopping Cart System

• Add multiple items
• Buy everything at once
• Dynamic total price calculation

🗂 Category System

• Fully configurable categories
• Multilingual category names (EN / UK / RU)
• Horizontal scrolling

🌐 Multi-Language Support

• English 🇬🇧
• Ukrainian 🇺🇦
• Russian 🇷🇺

 

💰 Multi-Economy Support

• MBCoins
• Economics
• ServerRewards
• Easy switching via config

🖼 Image-Based UI

• Custom background images
• Item cell backgrounds
• Buy button background
• NPC image
• Coin icon
• Error & success notification icons

🔔 Styled UI Notifications

• No chat spam
• Visual error & success messages
• Auto-hide after a few seconds

📦 Safe Item Delivery

• Inventory space validation
• No item dropping on the ground
• No dupes
• No lost items

⚙️ Configuration

{
  "NPC Image URL": "https://i.ibb.co/r2Ft9sJQ/MBNPC.png",
  "Virtual currency image URL": "https://i.ibb.co/gbMSk6DV/Virtual.png",
  "Donate currency image URL": "https://i.ibb.co/KzzPd1cX/MBShop-Coin.png",
  "Scrap currency image URL": "https://ru-wiki.rustclash.com/img/items180/scrap.png",
  "Scrollbar Handle Color": "1 0 0 0.6",
  "Configuration of Categories and Items": {
    "Weapons": {
      "Translations": {
        "en": {
          "Enabled": true,
          "Text": "Weapons"
        },
        "uk": {
          "Enabled": false,
          "Text": "Зброя"
        },
        "ru": {
          "Enabled": false,
          "Text": "Оружие"
        }
      },
      "Items": [
        {
          "Name": "Assault Rifle",
          "Shortname": "rifle.ak",
          "Amount": 1,
          "Price": 10000.0,
          "Description": "High damage machine rifle.",
          "Currency (Donate, Virtual, Scrap)": 3
        },
        {
          "Name": "Thompson",
          "Shortname": "smg.thompson",
          "Amount": 1,
          "Price": 2.0,
          "Description": "A medium damage machine gun.",
          "Currency (Donate, Virtual, Scrap)": 2
        },
        {
          "Name": "Custom SMG",
          "Shortname": "smg.2",
          "Amount": 1,
          "Price": 0.1,
          "Description": "A rapid-firing Machine Gun. Sacrifices accuracy and distance for speed.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Pump Shotgun",
          "Shortname": "shotgun.pump",
          "Amount": 1,
          "Price": 0.1,
          "Description": "A Shotgun. Fires 8 rounds.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Revolver",
          "Shortname": "pistol.revolver",
          "Amount": 1,
          "Price": 0.08,
          "Description": "A standard eight shot revolver.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Nailgun",
          "Shortname": "pistol.nailgun",
          "Amount": 1,
          "Price": 0.06,
          "Description": "A construction tool turned deadly.",
          "Currency (Donate, Virtual, Scrap)": 1
        }
      ]
    },
    "Ammo": {
      "Translations": {
        "en": {
          "Enabled": true,
          "Text": "Ammo"
        },
        "uk": {
          "Enabled": false,
          "Text": "Боєприпаси"
        },
        "ru": {
          "Enabled": false,
          "Text": "Патроны"
        }
      },
      "Items": [
        {
          "Name": "5.56 Rifle Ammo",
          "Shortname": "ammo.rifle",
          "Amount": 30,
          "Price": 0.05,
          "Description": "Ammunition for a Rifle. Loses velocity when fired over long distances resulting in slightly decreased damage.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Pistol Ammo",
          "Shortname": "ammo.pistol",
          "Amount": 30,
          "Price": 0.04,
          "Description": "Ammunition for a Pistol. Loses velocity when fired over long distances resulting in slightly decreased damage.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Shotgun Shells",
          "Shortname": "ammo.shotgun",
          "Amount": 12,
          "Price": 0.04,
          "Description": "Ammunition for a Shotgun.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Nails",
          "Shortname": "ammo.nailgun.nails",
          "Amount": 30,
          "Price": 0.03,
          "Description": "Standard nailgun ammunition",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Incendiary 5.56",
          "Shortname": "ammo.rifle.incendiary",
          "Amount": 20,
          "Price": 0.06,
          "Description": "Slower moving ammunition that deals fire damage. There's a small chance it will start a fire.",
          "Currency (Donate, Virtual, Scrap)": 1
        }
      ]
    },
    "Medical": {
      "Translations": {
        "en": {
          "Enabled": true,
          "Text": "Medical"
        },
        "uk": {
          "Enabled": false,
          "Text": "Медицина"
        },
        "ru": {
          "Enabled": false,
          "Text": "Медикаменты"
        }
      },
      "Items": [
        {
          "Name": "Medical Syringe",
          "Shortname": "syringe.medical",
          "Amount": 2,
          "Price": 0.05,
          "Description": "Heal yourself or others with this syringe. Left-click heals you, right-click heals a target.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Bandage",
          "Shortname": "bandage",
          "Amount": 5,
          "Price": 0.03,
          "Description": "Heal yourself or others with this bandage. Left-click heals you, right-click heals a target.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Large Medkit",
          "Shortname": "largemedkit",
          "Amount": 1,
          "Price": 0.1,
          "Description": "A large medkit that heals you to max health over time and stops any bleeding instantly.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Anti-Rad Pills",
          "Shortname": "antiradpills",
          "Amount": 2,
          "Price": 0.03,
          "Description": "Taking these pills will lower your radiation level. WARNING: May cause extreme dehydration.",
          "Currency (Donate, Virtual, Scrap)": 1
        }
      ]
    },
    "Resources": {
      "Translations": {
        "en": {
          "Enabled": true,
          "Text": "Resources"
        },
        "uk": {
          "Enabled": false,
          "Text": "Ресурси"
        },
        "ru": {
          "Enabled": false,
          "Text": "Ресурсы"
        }
      },
      "Items": [
        {
          "Name": "Wood",
          "Shortname": "wood",
          "Amount": 1000,
          "Price": 0.05,
          "Description": "Wood. Collected from trees and used in many crafting recipes. It's also needed to cook in camp-fires.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Stone",
          "Shortname": "stones",
          "Amount": 1000,
          "Price": 0.05,
          "Description": "Harvested from rocks using tools, basic building material.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Metal Fragments",
          "Shortname": "metal.fragments",
          "Amount": 500,
          "Price": 0.08,
          "Description": "Metal Fragments. Smelted from Metal Ore, used in lots of different crafting recipes.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Sulfur",
          "Shortname": "sulfur",
          "Amount": 500,
          "Price": 0.1,
          "Description": "Sulfur is commonly used in gunpowder, medicine, and matches. Matches release sulfur dioxide when they burn, giving them their smell. Sulfur is an essential component to living cells.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "HQ Metal Ore",
          "Shortname": "hq.metal.ore",
          "Amount": 50,
          "Price": 0.15,
          "Description": "A rock containing High Quality Metal. Can be smelted in a furnace.",
          "Currency (Donate, Virtual, Scrap)": 1
        }
      ]
    },
    "Tools": {
      "Translations": {
        "en": {
          "Enabled": true,
          "Text": "Tools"
        },
        "uk": {
          "Enabled": false,
          "Text": "Інструменти"
        },
        "ru": {
          "Enabled": false,
          "Text": "Инструменты"
        }
      },
      "Items": [
        {
          "Name": "Hatchet",
          "Shortname": "hatchet",
          "Amount": 1,
          "Price": 0.05,
          "Description": "A Hatchet, useful for chopping trees and dismembering corpses.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Pickaxe",
          "Shortname": "pickaxe",
          "Amount": 1,
          "Price": 0.06,
          "Description": "A Pickaxe, useful for gathering ore from rocks.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Chainsaw",
          "Shortname": "chainsaw",
          "Amount": 1,
          "Price": 0.15,
          "Description": "A Chainsaw. Very effective at cutting trees in addition to soft fleshy objects. Requires Low Grade Fuel to run.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Jackhammer",
          "Shortname": "jackhammer",
          "Amount": 1,
          "Price": 0.12,
          "Description": "A Pneumatic Jackhammer to blast through ore nodes. The sheer power of this device requires no aiming as all weak spots will be instantly destroyed. Works well on human flesh. Can berefilled at a Workbench.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Hammer",
          "Shortname": "hammer",
          "Amount": 1,
          "Price": 0.03,
          "Description": "A Hammer, used to upgrade building materials. Right-click for the options. You can also pick up deployed objects while the hammer is equipped.",
          "Currency (Donate, Virtual, Scrap)": 1
        }
      ]
    },
    "Building": {
      "Translations": {
        "en": {
          "Enabled": true,
          "Text": "Building"
        },
        "uk": {
          "Enabled": false,
          "Text": "Будівництво"
        },
        "ru": {
          "Enabled": false,
          "Text": "Строительство"
        }
      },
      "Items": [
        {
          "Name": "Tool Cupboard",
          "Shortname": "cupboard.tool",
          "Amount": 1,
          "Price": 0.1,
          "Description": "Placing and authorising with the cupboard will make it so only you can build in a 50 meter radius of it. If you want your friends to build, they'll need to auth too. You should protect this.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Sleeping Bag",
          "Shortname": "sleepingbag",
          "Amount": 1,
          "Price": 0.05,
          "Description": "A sleeping bag. Placing this will give you or an assigned player a place to respawn, with a long cooldown.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Door Key Lock",
          "Shortname": "lock.key",
          "Amount": 1,
          "Price": 0.03,
          "Description": "Place on a door to prevent unwelcome guests. You can create a key to share with your friends, don't let it fall in the wrong hands!",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Code Lock",
          "Shortname": "lock.code",
          "Amount": 1,
          "Price": 0.1,
          "Description": "An electronic lock. Locked and unlocked with four-digit code.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Wooden Door",
          "Shortname": "door.hinged.wood",
          "Amount": 1,
          "Price": 0.05,
          "Description": "A Cheap door to secure your base. Its vulnerability to fire and weak explosive resistance makes the door a temporary solution to securing your base. Due to its flaws you should look at The Wooden Door can take two kinds of locks the basic Key Lock and the Code Lock. To pick up the door, remove any locks and open, hold down the E (USE) key and select 'Pickup'.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Metal Door",
          "Shortname": "door.hinged.metal",
          "Amount": 1,
          "Price": 0.1,
          "Description": "Medium strength door, vulnerable to explosives.",
          "Currency (Donate, Virtual, Scrap)": 1
        }
      ]
    },
    "Clothing": {
      "Translations": {
        "en": {
          "Enabled": true,
          "Text": "Clothing"
        },
        "uk": {
          "Enabled": false,
          "Text": "Одяг"
        },
        "ru": {
          "Enabled": false,
          "Text": "Одежда"
        }
      },
      "Items": [
        {
          "Name": "T-Shirt",
          "Shortname": "tshirt",
          "Amount": 1,
          "Price": 0.03,
          "Description": "A tshirt, simple undergarment. Good protection from damage and the elements.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Pants",
          "Shortname": "pants",
          "Amount": 1,
          "Price": 0.03,
          "Description": "A pair of pants, highly capable undergarment for your legs. Great all round protection from damage and the elements.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Hoodie",
          "Shortname": "hoodie",
          "Amount": 1,
          "Price": 0.05,
          "Description": "A hoodie.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Boots",
          "Shortname": "shoes.boots",
          "Amount": 1,
          "Price": 0.04,
          "Description": "Sturdy work boots to keep your toes safe, you'd feel nothing if you kicked a table leg. Strong protection against the cold and incoming damage.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Roadsign Vest",
          "Shortname": "roadsign.jacket",
          "Amount": 1,
          "Price": 0.1,
          "Description": "A shoddy piece of body armor made from roadsigns.",
          "Currency (Donate, Virtual, Scrap)": 1
        },
        {
          "Name": "Roadsign Kilt",
          "Shortname": "roadsign.kilt",
          "Amount": 1,
          "Price": 0.1,
          "Description": "A shoddy piece of leg armor made from roadsigns. Moderate protection from melee and projectiles.",
          "Currency (Donate, Virtual, Scrap)": 1
        }
      ]
    }
  },
  "Donate economy plugin (Economics, ServerRewards, MBCoins)": "MBCoins",
  "Show Donate balance": true,
  "Virtual economy plugin (Economics, ServerRewards, MBCoins)": "Economics",
  "Show Virtual balance": true,
  "Enable Scrap economy": true,
  "Global discount percent (0-100)": 0.0,
  "Show Discount": true,
  "Permission discounts (permission = percent)": {
    "mbshop.vip": 10.0,
    "mbshop.premium": 20.0
  }
}

🖱 Modern UI Controls

• Quantity selector (+ / -)
• Scrollable item grid
• Scrollable cart
• Animated UI background blur

🧩 Highly Configurable

• Categories
• Item prices
• Item amounts
• UI images via URLs
• Economy type

⚙️ Supported Economies

• Economy PluginSupported
• MBCoins✅
• Economics✅
• ServerRewards✅

🌍 Supported Languages

• English (Default)
• Ukrainian
• Russian
• All UI elements, buttons, cart, prices, and notifications are localized.

🔐 Security & Stability

• Protected ConsoleCommand handlers
• No RCON abuse
• No UI exploits
• Safe balance deduction
• Inventory validation before purchase
• Memory cleaned on player disconnect

🖼 UI Image System

• All UI images are loaded dynamically using an internal Local Image Loader:
• Shop background
• Item cell background
• Category background
• Buy button
• Total price panel
• NPC image
• Coin icon
• Error icon
• Success icon

Images are fully configurable via URLs in the config.

📁 Example Config Snippet

{
  "NPC Image URL": "https://yourimage.com/npc.png",
  "Coin image URL": "https://yourimage.com/coin.png",
  "Economy type (Economics, ServerRewards, MBCoins)": "MBCoins"
}

📌 Commands

• Command                                         Description
• /shop                                                 Open the shop UI

🛠 Requirements

• At least ONE of the following economy plugins:
• MBCoins
• Economics
• ServerRewards
• No other dependencies required.

✅ Perfect For:

• Donat shops
• PvP storefronts
• PvE progression shops
• VIP reward systems
• Premium monetization systems