MBShop

About 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"
}