Featured framework
Carbon for modern Rust servers
Fast, self-updating, and built for performance with seamless in-game plugin and server management.
1,400+
servers powered by Carbon
Welcome to ThemePark Island
An expansive and meticulously crafted custom map for Rust, brought to you by the combined efforts of Silent Creations and Explosive Shart.
This map blends high-octane thrill-seeking with gritty, urban survival. Whether you’re riding a functional coaster or navigating the trap-filled halls of a medical center, ThemePark Island offers a fresh gameplay loop for PVP and PVE servers alike.
🎡 Featured Custom Monuments
The Theme Park
The crown jewel of the island. This isn't just a static monument—it features a fully functional, custom-coded rollercoaster. Scale the heights for a view of the island before diving into the chaos below.
Loot: High-density loot spawns throughout the park.
Puzzles: Includes both Green and Blue keycard puzzle rooms.
The 2 Gorges Dam
A massive, custom-built architectural marvel. The dam dominates the landscape, offering scenic vistas and deep, dark secrets.
Underground Puzzles: Navigate multiple puzzle rooms hidden deep within the structure.
Tactical Depth: Perfect for long-range engagements or sneaky subterranean looting.
Black Rock City
A sprawling urban center that feels like a lived-in wasteland.
Black Rock Medical Center: Enter at your own risk. This landmark is rigged with traps, multiple puzzles, and enough loot to supply an entire clan.
Custom Car Dealership: A unique urban addition for those looking to secure high-tier parts.
Pine Bluff
A smaller, dense city center for quick skirmishes and essential supplies.
Interiors: Explore a replica McDonald’s and a completely custom Supermarket.
Puzzles: Features multiple puzzles and heavy loot concentrations.
Mills Trailer Park
An eerie, abandoned residential area.
Puzzles: Features 2x Green Card puzzles and 1x Blue Card puzzle, making it a high-value stop for progression.
Additional Points of Interest
7-Eleven: That’s right—a faithful replica of the iconic convenience store for all your raiding snack needs.
Fuel Depot: An abandoned facility located in the snow biome, featuring a working Pumpjack and a Green Card puzzle.
Rose Hill Development: An unfinished construction site offering unique verticality and parkour opportunities.
Green Houses: Small botanical structures perfect for picking up plants and quick loot.
Map Size
4500
Prefab Count
#39057
🏛️ Facepunch Monuments
ThemePark Island includes a full suite of classic monuments to ensure a balanced Rust experience:
Tier 3: Launch Site, Arctic Research, Large Oil Rig, Small Oil Rig, Military Tunnel, Giant Excavator.
Tier 2: Airfield, Trainyard, Ferry Terminal, Rad Town, Jungle Ziggurat, Large/Small Harbor.
Tier 1: & Utilities: Bandit Camp, 3x Mining Outpost, 3x Oxums, Lighthouse, Supermarket, Large Barn, Ranch, Abandoned Cabins, Fishing Villages, 3x Water Well.
Resources: Stone, HQM, and Sulfur Quarries.
🙏 Acknowledgements
A massive thank you to those who helped bring this project to life:
Substrata: For the incredible work on the custom rollercoaster plugin.
Milky: For the stellar work on the promotional video.
MrLiquid & the Luffy Map Testing Team: For their dedication to polishing and balancing the map.
For any Assistance or questions Please contact me on Discord @ https://discord.gg/HNhPTPZVmd
$24.99
Allows both PVE and PVP players to exist on a server at the same time. PVE players will have certain configurable protections and restrictions. You can have players use a command to flag themselves as PVP/PVE or you can assign it to them when they first spawn. If you have ZoneManager you can also designate specific zones to force player's to be PVE or PVP. Plugin is also compatible with SimpleStatus.
Note: Video is outdated, see documentation for a full list of new features!
Documentation:
A full readme including permissions, commands, and config options is available in this google doc link.
Disclaimer:
Like all of my plugins - this plugin is sold as is. I will be happy to take feature requests into consideration but make no guarantees about which ones get implemented. Please refer to the feature list before you make your purchase!
Developer API:
API Methods
// Returns the mode of the given entity. Also takes into account if the entity is in a forced mode zone.
string GetEntityMode(BaseEntity entity);
// Returns the group name for the given mode. For example if given 'pve' will return 'warmodepve'
string GetModeGroup(string modeId);
// Returns the target type for a given entity. Target types are the category that an entity falls into.
// For example, if given a BasePlayer entity, it will return 'players'. If given a horse entity is will
// return 'horses'.
string GetEntityTargetType(BaseEntity entity);
Hooks - place these in your plugin and WarMode will call them.
// Called when a player's mode has been updated or config changes have ocurred that may affect the mode.
private void WarMode_PlayerModeUpdated(string userid, string modeId)
// Used to override WarMode logic for taking damage.
// If true/false is returned then WarMode logic will be skipped. Return null to continue WarMode logic.
private object CanEntityTakeDamage(BaseCombatEntity target, HitInfo info)
// Used to override WarMode logic for targeting.
// If true/false is returned then WarMode logic will be skipped. Return null to continue WarMode logic.
private object CanEntityBeTargeted(BasePlayer target, BaseEntity attacker, bool skipVendingCheck)
// Used to override WarMode logic for triggering a trap.
// If true/false is returned then WarMode logic will be skipped. Return null to continue WarMode logic.
private object CanEntityTrapTrigger(BaseTrap trap, BasePlayer basePlayer)
// Used to override WarMode logic for looting an entity.
// If true/false is returned then WarMode logic will be skipped. Return null to continue WarMode logic.
private object CanEntityLoot(BasePlayer looter, BaseEntity target, bool skipVendingCheck)
FREE Extension Plugins:
War Mode Admin Panel
Use the /warmode.config or /wmc command to open a panel that allows admins to update mode rules in game without having to reload the pluign. Requires the warmode.admin permission to use.
I HIGHLY recommend you use this extension!
WarModeAdminPanel.cs
War Mode Spawn UI
Provides a UI that is shown to players when they first spawn that prompts them to choose whether they want to be PVP or PVE. Also supports custom modes. Localization and config options available. This can also be configured to appear when players use the /flag command.
WarModeSpawnUI.cs
War Mode Rules UI
Using the /rules command (which is configurable) players can see a list of what restrictions they have for their current mode. These ruling will update dynamically based on your config settings.
WarModeRulesUI.cs
War Mode Badges
Customizable UI elements that will appear on the player's HUD to indicate what their current mode is.
WarModeBadges.cs
Welcome to "Decay: The Last Haven," a custom map for the game RUST that immerses players in a post-apocalyptic world where survival is a luxury. This expansive map, with a size of 4500, boasts around 70,000 prefabs, creating a rich and detailed environment. It's fully compatible with BetterNPC plugins(Config for bots in the file), and Train Homes, featuring three stations for the plugin. The map showcases a double-track surface railway, offering two metro entrances with separate branches for spawning trains, complemented by an intricate underground railway system.
The layout includes evenly spaced monuments to optimize the FPS load for clients, ensuring smooth gameplay. Players can find custom building spots in the subway, marked as 'XU' on the minimap, amidst a network of bridges that are navigable by tugboats. The map's design incorporates a multitude of rivers, allowing tugboats and other water transport to access any point on the map with ease.
For those seeking a strategic advantage, the map presents custom monuments in ample quantity for a comfortable and engaging gaming experience. Builders will appreciate the custom sites, indicated by 'X' on the minimap, while the heart of the map features fresh water and lush vegetation, ideal for farmers.
Explorers can discover a large number of small settlements and standalone buildings, not marked on the road map, offering hidden gems throughout the landscape. Adventurous players can delve into underwater farm zones, denoted by 'O' on the minimap, and explore the depths of an underwater laboratory. To add to the excitement, the map is equipped with ziplines, providing a thrilling way to traverse this desolate yet captivating world.
"Decay: The Last Haven" is not just a map; it's a testament to the resilience of humanity in the face of desolation, offering a sanctuary for those brave enough to claim it.
Features:
Map size: 4500;
Prefabs count: ~65K;
Compatible with BetterNPC plugins (Config for bots in the file) & Train Homes ( 3 stations for plug-in );
Double-track surface railway with 2 entrances to the metro with separate branches for spawn trains;
Underground railway;
Evenly spaced monuments to spread the FPS load of client;
Custom places for building in the subway (XU on the minimap);
A lot of bridges ( The tugboat passes );
A large number of rivers, tugboats and other water transport can pass to any point on the map;
Designed custom monuments in sufficient quantity for a comfortable game;
Custom building sites (X on the minimap);
Fresh water and vegetation for farmers are in the center of the map;
A large number of small settlements/single buildings not marked on the road map by road;
Underwater farm zones (O on the minimap);
Underwater Laboratory;
Ziplines.
Custom monuments:
Nuclear Cargo;
Settlement;
Bandit Settlement;
Wood Industry;
Industrial Settlement;
Office Area;
Reverpost;
Shorpek;
Warehouse Settlement;
Bandit Ship;
Slave Ship;
Rebel Ship;
RW Station;
A large number of small settlements/single buildings not marked on the road map by road;
A lots custom places to build a base. ( "X"/"XU" on map );
Underwater farm zones ( "O" on map ).
Monuments:
Combined Outpost;
Launch Site;
The Dome;
Ziggurat;
PowerPlant;
JunkYard;
Harbor;
Airfield;
Arctic Research Base;
Desert Military Base;
Ferry Terminal;
Large fishing village;
Oxum`s Gas Station;
Abandoned supermarket;
Fishing villages;
Lighthouses;
Satellite Dish;
Nuclear Missile Silo;
Water Treatment Plant;
Train Yard;
Giant Excavator Pit;
Underwater laboratory;
Ranch;
Underground railway;
Quarries(HQM,Stone, Sulfur);
Large oilrig;
Oilrig.
My Discord: shemov
A password is attached to the map. You can edit it.
Features
Target Designator System:
Players receive a binocular designator. Aim and left-click to mark a target point and call in an airstrike
Strike and Nuke Support:
Supports both standard F15 Strike and F15 Nuke runs, each with independent settings for planes, shots, rocket speed, delay, cooldown, and more
Strike Modes:
Includes multiple strike patterns:
precise, circle, line, and carpet
Custom F15 Flight:
Flight altitude, plane speed, and pre-fire distance are fully configurable
Aircraft spawn, fly their attack run, fire, and clean up automatically when the strike is complete
Rocket Mechanics:
Configurable rocket speed, rate of fire, shots per plane, plane stagger, and impact spread
Direct Designator Delivery:
Admins can deliver Strike or Nuke designators directly to players using the give subcommand
In-Game Store:
Optional in-game store support for purchasing Strike and Nuke designators.
Supports Auto, Economics, and ServerRewards providers
Admin Control Panel:
Includes an in-game admin panel for managing store settings, strike settings, warnings, and zone restrictions without editing the config manually
Combat Alerts:
Includes target-marked warnings, inbound warnings, and countdown alerts with map grid support
Blocked Use Zones:
Can block strike usage while the caller is inside a safe zone, and can also block target points inside safe zones or monument bounds
Commands are configurable from the config
Permissions
f15estrike.strike → allows using Strike designators
f15estrike.nuke → allows using Nuke designators
f15estrike.strike.give → allows giving Strike designators to other players
f15estrike.nuke.give → allows giving Nuke designators to other players
f15estrike.admin → full admin access and admin panel access
Commands
/f15 → opens the in-game F15 store
/strike → gives the player an F15 Strike designator
/nuke → gives the player an F15 Nuke designator
/strike give <name|SteamId64> → gives an F15 Strike designator to another player
/nuke give <name|SteamId64> → gives an F15 Nuke designator to another player
Config
{
"Config Version": 3,
"Flight altitude (m)": 250.0,
"Plane speed (m/s)": 200.0,
"Pre-fire distance (m)": 750.0,
"Chat prefix": "[F15]",
"Commands": {
"Strike": {
"Enabled": true,
"Primary": "strike",
"Aliases": []
},
"Nuke": {
"Enabled": true,
"Primary": "nuke",
"Aliases": []
}
},
"Blocked use zones": {
"Block caller while inside a safe zone": true,
"Block target point inside a safe zone": true,
"Block target point inside monument bounds": false
},
"Global warnings": {
"Enabled": true,
"Broadcast when target is marked": true,
"Broadcast countdown reminders": true,
"Countdown warning seconds": 5,
"Broadcast when aircraft are inbound": true,
"Include map grid": true,
"Include world coordinates": true
},
"Purchases": {
"Enabled": false,
"Provider (Auto/Economics/ServerRewards)": "Auto",
"Strike": {
"Enabled": true,
"Cost": 1500.0
},
"Nuke": {
"Enabled": true,
"Cost": 10000.0
}
},
"Strike": {
"Planes (count)": 1,
"Shots per plane": 10,
"Rocket speed (m/s)": 150.0,
"Rate of fire (shots/sec)": 2.5,
"Stagger between planes (s)": 0.25,
"Impact spread radius (m)": 3.0,
"Confirm delay (s)": 5.0,
"Cooldown (s)": 5.0,
"Default mode": "circle",
"Designator display name": "F15 Strike"
},
"Nuke": {
"Planes (count)": 5,
"Shots per plane": 10,
"Rocket speed (m/s)": 200.0,
"Rate of fire (shots/sec)": 1.5,
"Stagger between planes (s)": 0.35,
"Impact spread radius (m)": 6.0,
"Confirm delay (s)": 6.0,
"Cooldown (s)": 120.0,
"Default mode": "circle",
"Designator display name": "F15 Nuke"
}
}
Need Support?
$29.99
Basements lets players build underground rooms beneath their bases. Place a hatch on your foundation and dig straight down into a hidden basement with walls, ceilings, and full building privileges. Great for stashing loot, setting up secret bunkers, or just adding extra space.
Readme Link - Click Here for Instruction and Documentation
👆Highly recommend reading the FAQ section!
BUILD
Build basements easily from your tool cupboard. Just place an entrance to get started.
EXPAND
Expand your basement by drilling underground. But don't forget to bring a headlamp - its dark down there!
TRAVERSE
Place multiple entryways, building out your labyrinth of tunnels beneath your base.
DECORATE
All deployables, electricity, and storage items can be placed in your basement. Take advantage of your new space!
RAID
Nothing is safe in Rust, including your basement. If all the entrances are destroyed, then the basement is too. Any loot below will float to the surface. Protect the entrance at all costs!
API METHODS (For Plugin Developers)
// Returns true if the given entityId is part of a basement.
bool IsBasementEntity(ulong entityId)
// Returns the building ids of the basements connected to a given surface building id.
uint[] GetBasementBuildingIds(uint surfaceBuildingId)
// Returns the building ids of the surface buildings connected to a given basement building id.
uint[] GetSurfaceBuildingIds(uint basementBuildingId)
Extension Plugins
These are free plugins that add additional functionality to Basements.
BasementsManager
Provides a UI for admins to view and manage the basements on the server. Useful for debugging & fixing issues. Use with the /bm command, requires the basements.admin permission to use.
BasementsManager.cs
xChatStyles
xChatStyles adds smooth gradient colors to player names, prefixes, and chat messages, giving your server a premium, modern look without clutter or spam.
It’s clean, readable, and designed to enhance chat - not overpower it.
It lets you customize how players appear in chat using animated-looking color gradients. Perfect for VIPs, staff, donators, or special roles. No flashy UI. No complicated setup. Just beautiful chat.
⭐ Features
🎨 Gradient Names & Messages
Smooth color gradients instead of flat colors, but you can also use a solid color
Player names
Chat messages
Prefixes (VIP, Admin, etc.)
Looks great without hurting readability
Styled Mentions (@PLAYERNAME)
🏷️ Multiple Prefix Support
Players can have more than one prefix
Each prefix can have its own color style
👑 Great for VIP & Donator Perks
Instantly makes VIP ranks feel premium
Visual reward without gameplay imbalance
Easy to sell as a cosmetic perk
🪙 Trade System for Prefixes (REQUIRES Economics if you want to use trade feature)
⚡Server Friendly
No lag or spam
Optimized to run smoothly on live servers
Works quietly in the background
🔑 Supports permission-based style, not just permanent chat style.
🌍 xChatStyles Web Editor
📌 Plugin Preview
💬 Chat Commands (Player)
/xcs - Opens the Ui
/xcs <PLAYERNAME/STEMAID> - Opens the Ui with the view of the target player and you can remove owned styles from that user.
💬 Chat & Console Commands (Admin)
/* Add chat styles without permission */
/addprefix <STEAMID> <PREFIXNAME> <#HEX> <#HEX> <#HEX>...
/addmessagecolor <STEAMID> <#HEX> <#HEX> <#HEX>...
/addusernamecolor <STEAMID> <#HEX> <#HEX> <#HEX>...
/addall <STEAMID> <PREFIXNAME> <#HEX> <#HEX> <#HEX>... [This will add a prefix with provided color(s), message style with provided color(s) and username style with provided color(s) with just 1 command.]
/* Add chat styles without permission */
/* Add chat styles WITH permission */
/addprefix <xchatstyles.PERMISSIONNAME> <PrefixName> <#HEX> <#HEX> <#HEX> ...
/addall <xchatstyles.PERMISSIONNAME> <PrefixName> <#HEX> <#HEX> <#HEX> ...
/addmessagecolor <xchatstyles.PERMISSIONNAME> <#HEX> <#HEX> <#HEX> ...
/addusernamecolor <xchatstyles.PERMISSIONNAME> <#HEX> <#HEX> <#HEX> ...
/* Add chat styles WITH permission */
---> As long as the player has permission, they can select it with /xcs
---> Automatically removed when permission is revoked
---> Permission-Based ChatStyles has (Permission) indicator in /xcs
---> The permission must start with 'xchatstyles.*'. Example: /addall <xchatstyles.vip> VIP <#HEX> <#HEX> <#HEX> ...
/*********************************************************************************************************/
/* Use 1 #HEX Color (Example: #fcba03) for a single color, use multiple #HEX Colors for a color gradient */
/* */
/* Example: /addprefix 76561198412496844 OMEGA #32a852 #71a67f */
/* */
/*********************************************************************************************************/
/removeprefix <steamid> <index|PrefixName>
/removemessagecolor <steamid> <index>
/removeusernamecolor <steamid> <index>
⏳ Recommended Plugin for >TIMED< PERMISSION:
⚙️ Config
{
"MaxPrefixes": 3,
"DefaultUsernameColor": "#55aaff",
"DefaultMessageColor": "#ffffff",
"DefaultSize": 15,
"AllowSelectingDuplicatePrefixNames": true,
"NotifyOnStyleReceived": true,
"PrefixBrackets": "[]",
"ShowPrefixBracketsWithSizeTag": true,
"Trade": {
"AllowTrading": false,
"PlayerCanSellPermissionBasedPrefix": false,
"UseCurrencySign": true,
"CurrencySign": "$",
"AnnounceNewPrefixSaleGlobally": true,
"AnnouncePrefixPriceUpdateGlobally": true
},
"PermissionStyles": {}
}
Welcome to UltimateCases - the most exciting case opening experience for Rust servers! Give your players the thrill of unboxing rare items with beautiful roulette animations, create unlimited custom cases with unique rewards, and build a thriving economy through our advanced key exchange system. Whether you want to reward active players with free cases or monetize your server with premium loot boxes, UltimateCases has everything you need to keep players engaged and coming back for more!
⭐️ Why Choose UltimateCases?
Beautiful Unboxing Experience - Watch your players' excitement as they spin the roulette and discover their rewards! Customizable animations, rarity backgrounds, and sound effects create an unforgettable opening experience.
Easy Case Creation - No coding required! Use our in-game visual editor to create cases, add items, set prices, and configure everything you need. Edit cases on the fly without touching configuration files.
Monetize Your Server - Turn your server into a profitable venture with our key exchange system. Players can buy keys using any currency (Economics, ServerRewards, scrap, etc.) and you control the economy.
Reward Active Players - Keep players engaged with free cases! Set playtime requirements and cooldowns to reward your most dedicated community members.
Protect Your Economy - Advanced limits and restrictions prevent abuse. Set daily limits, lifetime limits, minimum playtime requirements, and block case opening during combat or raids.
Store Rewards Safely - Built-in inventory system stores all case rewards securely. Players can retrieve items when they're ready, with options to persist items across wipes.
Share the Excitement - Announce rare wins in chat and Discord! Customizable logging and webhook integration lets your community celebrate big wins together.
NPC Traders at Monuments - Spawn NPCs at monuments where players can exchange keys for currency. Perfect for creating trading hubs and encouraging exploration!
VIP Benefits - Reward your supporters with exclusive discounts on case opening and key exchange. Multiple VIP tiers with customizable benefits.
Works Everywhere - Seamlessly integrates with ServerPanel, supports all major economy plugins, and works with ImageLibrary for perfect image management.
💰 Key Exchange System
Turn any currency into case keys! Our flexible exchange system supports:
Multiple Currencies - Use Economics, ServerRewards, BankSystem, IQEconomic, or any item (scrap, sulfur, etc.) as currency for key exchange.
Bulk Discounts - Reward players who exchange more keys! Automatic discounts: 5% off for 10+ keys, 10% off for 25+ keys, 15% off for 50+ keys, 20% off for 100+ keys.
VIP Discounts - Give your supporters extra savings! Configure permission-based discounts (5%, 10%, 15%, 20%) with custom daily limits.
Daily Limits - Prevent abuse by limiting how many keys players can exchange per day. Perfect for controlling your server economy.
Monument NPCs - Spawn traders at monuments! Players can visit NPCs at lighthouse, outpost, or any monument to exchange keys. Fully customizable appearance and rates.
📦 Smart Inventory System
Never lose a reward again! Our inventory system stores all case rewards safely:
Secure Storage - All case rewards are automatically stored in your personal inventory, accessible anytime through the UI.
Wipe Protection - Choose whether items persist across server wipes or are cleared automatically. Perfect for seasonal rewards!
Safe Retrieval - Items can only be retrieved when it's safe - no retrieving during combat, raids, or building blocked situations.
Post-Wipe Cooldown - Optional cooldown after wipe before items can be retrieved, helping maintain server balance.
📬 Video Overview
🖼️ Showcase
Templates
Fullscreen Template
ServerPanel V1 Template
ServerPanel V2 Template
ServerPanel V4 Template
In-Game Editor
Monument Trader
How to get Keys?
🎮 Commands
/opencases or /cases - Opens the cases interface for players
/cases.trader - Chat command for managing Monument Traders (requires ultimatecases.edit permission)
/cases.trader create [currencyID] [defaultKeys] [prefab] - Create a new trader bot
/cases.trader start <botIndex> - Enter edit mode for a trader
/cases.trader move - Update trader position (requires edit mode)
/cases.trader rotate <angle> - Set trader rotation (requires edit mode)
/cases.trader save - Save and reload trader (requires edit mode)
/cases.trader cancel/stop - Cancel edit mode
/cases.trader list - Show all configured trader bots
/cases.trader teleport <botIndex> - Teleport to a trader bot location
/cases.trader help - Show help for trader commands
cases.give - Console/Rcon command for giving keys or cases to players (admin only)
cases.give <player> keys <amount> - Give keys to a player
cases.give <player> case <caseID> [amount] - Give case(s) to a player
Examples: cases.give PlayerName keys 100 or cases.give 76561198000000000 case 0 5
cases.convert - Console command for converting cases from old Cases plugin (requires UltimateCasesConverter plugin, admin only)
cases.convert - Convert all cases and add them to existing UltimateCases data
cases.convert true - Clear existing UltimateCases data before converting (fresh start)
🛡️ Permissions
ultimatecases.edit - Permission to edit cases, items, and modals using the in-game editor. Required to access all editor functions and manage Monument Traders.
ultimatecases.discount1 - 5% discount on case opening
ultimatecases.discount2 - 10% discount on case opening
ultimatecases.discount3 - 15% discount on case opening
ultimatecases.vip1 - 5% discount on key exchange, with optional custom daily limit
ultimatecases.vip2 - 10% discount on key exchange, with optional custom daily limit
ultimatecases.vip3 - 15% discount on key exchange, with optional custom daily limit
ultimatecases.vip4 - 20% discount on key exchange, with optional custom daily limit
Note: Additional permissions can be configured in the config file for demo mode and quick unbox mode. These are optional and can be left empty to disable the features.
📚 FAQ
Q: How do I open the Case Editor?
A: To open the Case Editor:
Make sure you have the ultimatecases.edit permission
Open the cases menu using /opencases or /cases
Look for the "EDIT" button in the header of the interface (usually in the top-right area)
Click the "EDIT" button to open the Case Editor
From here you can create new cases, edit existing cases, add items, configure prices, permissions, and all case settings
Q: How do I open the Item Editor?
A: To open the Item Editor:
First, open the Case Editor (see instructions above)
Select a case from the list or create a new case
In the case editor, you'll see a section for items
Click "ADD ITEM" or click on an existing item to edit it
The Item Editor will open where you can configure item type, chance, image, title, description, permissions, and all item-specific settings (weapons, contents, genes, etc.)
Q: How do I open the Modal Editor?
A: To open the Modal Editor:
Make sure you have the ultimatecases.edit permission
Open the cases menu and navigate to any modal window (like the keys exchange modal)
Look for the "EDIT" button that appears on modal windows when you have edit permission
Click the "EDIT" button to open the Modal Editor
From here you can edit modal content, text elements, images, buttons, and all modal settings
Q: How do I create a case?
A: It's super easy! Open the cases menu in-game, click the "EDIT" button in the header, then click "ADD CASE" in the Case Editor. Configure the case title, image, price, permission, and add items. No file editing needed!
Q: Can players get free cases?
A: Yes! Enable Free Case Settings for any case. Set minimum playtime (e.g., 2 hours) and cooldown (e.g., 24 hours). Players meeting requirements can open the case for free once per cooldown period.
Q: How do I set up key exchange?
A: Go to Exchange Settings in the config. Add currencies (Economics, ServerRewards, scrap, etc.), set exchange rates, configure discounts, and you're done! Players can exchange currency for keys instantly.
Q: What can I put in cases?
A: Almost anything! Add items (weapons with attachments, containers with contents, blueprints, plant seeds with genes), or execute commands when cases are opened. Full customization for every reward type.
Q: How do Monument Traders work?
A: Configure NPCs in Exchange Settings to spawn at monuments. Players can visit these NPCs to exchange keys for currency. Set the monument (lighthouse, outpost, etc.), NPC appearance, position, and exchange rate.
Q: Can I limit how many cases players can open?
A: Absolutely! Set daily limits (e.g., 5 cases per day), total lifetime limits (e.g., 50 cases total), minimum playtime requirements, and block opening for a period after server wipe.
Q: How does the inventory system work?
A: When players open cases, rewards go to their inventory automatically. Players can access inventory through the UI and retrieve items when ready. Configure whether items persist across wipes.
Q: Can I announce rare wins?
A: Yes! Enable chat announcements and Discord webhooks. Set rarity threshold (e.g., only announce items with 5% or lower chance), customize message format, and share the excitement with your community!
Q: How do I add UltimateCases to ServerPanel?
A: In ServerPanel, create a new category with Type: "Plugin", Plugin Name: "UltimateCases", Plugin Hook: "API_OpenPlugin". The plugin integrates seamlessly!
Q: Can I give VIP players discounts?
A: Yes! Configure permission-based discounts in Case Opening Discounts and Exchange Privilege Settings. Set different discount percentages for different VIP tiers.
Q: How do I configure the plugin config file?
A: The config file is located at oxide/config/UltimateCases.json (or carbon/config/UltimateCases.json for Carbon). Here's how to configure key settings:
Template Selection: Set "Template" to "Fullscreen", "V1", "V2", or "V4"
Commands: Modify "Open UI Commands" array to add custom command aliases
Key Exchange: Configure "Exchange Settings" → "Currencies" to add currencies (Economics, ServerRewards, items, etc.)
Roulette Duration: Set "Roulette Settings" → "Default Duration" (seconds) and "Quick Mode Duration"
Sound Effects: Enable/disable sounds in "Sound Effects" section and set effect prefab paths
Logging: Configure console, file, chat, and Discord logging in "Logging Settings"
Restrictions: Enable/disable case opening restrictions in "Restrictions Settings"
Inventory: Configure inventory settings in "Inventory settings" section
After editing, reload the plugin: o.reload UltimateCases (Oxide) or c.reload UltimateCases (Carbon).
Q: How do I set up LangAPI for multi-language support?
A: To enable LangAPI support:
Make sure LangAPI plugin is installed and loaded on your server
In UltimateCases config, set "Work with LangAPI?" to true
Create language files in oxide/lang/UltimateCases/ (or carbon/lang/UltimateCases/ for Carbon)
Create files like en.json, ru.json, etc. with translation keys
Use LangAPI's translation system to translate all plugin messages
Reload the plugin to apply changes
Example translation key structure:
{
"UI_Header_Title": "Ultimate Cases",
"UI_Content_ButtonOpen": "OPEN CASE",
"UI_Content_ButtonOpenFREE": "FREE",
...
}
Q: How do I set up Monument Traders using commands?
A: To create and configure Monument Traders:
Make sure you have ultimatecases.edit permission
Go to the monument where you want to spawn a trader (e.g., lighthouse, outpost)
In server console, use: cases.trader create [currencyID] [defaultKeys] [prefab]
currencyID - ID of the currency from Exchange Settings (0, 1, 2, etc.)
defaultKeys - Default number of keys per exchange (e.g., 1)
prefab - NPC prefab path (e.g., "assets/prefabs/npc/bandit/missionproviders/missionprovider_outpost_b.prefab")
Enter edit mode: cases.trader start <botIndex> (use cases.trader list to see bot indices)
Position yourself where you want the NPC to spawn
Update position: cases.trader move
Set rotation: cases.trader rotate <angle> (0-360 degrees)
Save: cases.trader save
The NPC will spawn automatically at the configured monument
Q: How do I configure custom economy plugins?
A: To use a custom economy plugin:
In config, find "Custom Economy Settings"
Set "Use Custom Economy" to true
Set "Type" to "Plugin"
Enter "Plugin Name" (exact name as it appears in plugins list)
Configure hooks:
"Plugin Hook Add" - Hook name for adding balance (e.g., "AddPoints", "Deposit")
"Plugin Hook Remove" - Hook name for removing balance (e.g., "TakePoints", "Withdraw")
"Plugin Hook Balance" - Hook name for checking balance (e.g., "CheckPoints", "Balance")
Test the hooks work correctly by checking plugin documentation
Reload the plugin
Q: How do I configure rarity backgrounds?
A: To set up rarity backgrounds:
In config, find "Rarity Settings" → "Rarity Backgrounds"
Add entries with chance ranges and images:
"Min" - Minimum chance percentage (e.g., 0)
"Max" - Maximum chance percentage (e.g., 1)
"Image" - Background image URL for case display
"Roulette Item Background Image" - Background image URL for roulette item display
Example: Legendary (0-1%), Epic (1-5%), Rare (5-15%), Uncommon (15-50%), Common (50-100%)
Items with drop chances within each range will display the corresponding background
Q: How do I configure Discord webhook logging?
A: To set up Discord webhook logging:
Create a Discord webhook in your Discord server (Server Settings → Integrations → Webhooks → New Webhook)
Copy the webhook URL
In config, find "Logging Settings" → "Discord"
Set "Enabled" to true
Paste webhook URL in "Webhook URL"
Configure options:
"Rare Threshold" - Only log items with chance ≤ X% (0 = log all items)
"Embed Color" - Decimal color code (e.g., 15844367 for gold)
"Title" - Embed title
"Show Player Avatar" - Display player avatar in embed
"Show Item Icons" - Display item icons in embed
"Group Items" - Group multiple items in single message
"Include Statistics" - Add statistics to embed
Reload the plugin
Q: How do I configure item rewards with weapons and attachments?
A: In the Item Editor:
Set "Type" to "Item"
Enter the weapon "ShortName" (e.g., "rifle.ak")
In "Weapon" section, set "Enabled" to true
Set "Ammo Type" (e.g., "ammo.rifle.explosive")
Set "Ammo Amount" (e.g., 128)
In "Content" section, set "Enabled" to true
Add attachments in "Contents" array:
"ShortName" - Mod shortname (e.g., "weapon.mod.lasersight")
"Condition" - Item condition (0-100)
"Amount" - Usually 1 for mods
"Position" - Slot index (-1 for auto-assignment)
Save the item
Q: How do I configure command rewards in cases?
A: To add command rewards:
In Item Editor, set "Type" to "Command"
In "Command (%steamid%)" field, enter your command
Use placeholders:
%steamid% - Player's Steam ID
%username% - Player's display name
%player.x% - Player's X coordinate
%player.y% - Player's Y coordinate
%player.z% - Player's Z coordinate
Multiple commands can be separated by | or line breaks
Example: "inventory.giveto %steamid% rifle.ak 1|oxide.usergroup add %steamid% vip"
Q: How do I enable Offline Image Mode?
A: To use local images instead of downloading from internet:
In config, set "Enable Offline Image Mode" to true
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: o.reload UltimateCases (Oxide) or c.reload UltimateCases (Carbon)
Note: For custom images, place them in the "TheMevent" folder and reference them with the "TheMevent/" prefix (e.g., "TheMevent/MyImage.png").
Q: How do I configure demo mode and quick unbox mode?
A: Demo mode allows testing cases without spending keys, and quick unbox mode speeds up animations:
In config, find "Roulette Settings"
For demo mode: Set "Demo Mode Permission" to a permission name (e.g., "ultimatecases.demo") or leave empty to disable
For quick unbox: Set "Quick Unbox Permission" to a permission name (e.g., "ultimatecases.quick") or leave empty to disable
Set "Quick Mode Duration" (seconds) - how long the quick animation should last
Grant the permissions to players who should have access
Reload the plugin
Q: How do I configure case opening restrictions?
A: To prevent case opening in certain situations:
In config, find "Restrictions Settings"
Set "Enabled" to true
Enable/disable specific restrictions:
"Block During Combat" - Requires NoEscape plugin
"Block During Raid" - Requires NoEscape plugin
"Block in Building Blocked" - Blocks when player can't build
"Block While Swimming" - Blocks when player is swimming
"Block When Player is Wounded" - Blocks when player is wounded
"Block During Duel" - Requires Duel/Duelist plugin
"Block During Helicopter Flight" - Blocks when in helicopter
"Block When Player is Sleeping" - Blocks when player is sleeping
Reload the plugin
🧪 TEST SERVER
Join our test server to experience UltimateCases yourself!
Copy the IP Address below to start playing!
connect 194.147.90.147:28015
Ready to create the ultimate case opening experience? UltimateCases gives you all the tools you need to build excitement, reward players, and monetize your server. Start creating your first case today!
$24.99
Combined Storage lets players connect multiple storage containers so they function as one large inventory. Includes automatic item sorting, search functionality, and filtering to keep storage clean and efficient.
Readme Link - Click Here for Instruction and Documentation
👆 Highly recommend reading the FAQ section!
All Your Items - In One Place
Link multiple containers so they all share a single organized inventory.
Automatic Sorting
Items are automatically sorted as they are inserted, no manual effort required.
Search Functionality
Quickly find any item across all linked containers using a fast, built-in search bar.
Simple Setup
Simply press Link in a container to hook it up with the rest of them in your base.
Unique View for Each Player
Each player sees their own automatically sorted and filtered view of the shared inventory based on their preferences, without affecting anyone else.
Warning: To use this loot tables pack, you need to purchase the paid Raidable Bases plugin if you do not already own it:
https://codefling.com/plugins/raidable-bases
ENHANCED LOOT TABES FOR RAIDABLE BASES:
This package includes only the Base_Loot folder, offering balanced loot tables designed for Raidable Bases.
What's New?
1) Two Loot Options:
- Vanilla Loot: Classic setup for a traditional experience.
- Enhanced Loot: Optimized for 2x, 3x, 5x, and higher servers, with fewer junk items.
2) Balanced Across 5 Levels:
Loot is tailored across Easy to Nightmare levels, ensuring rewards match the effort (e.g., a 30 C4 raid gives proportional loot).
3) Regular Updates:
Loot tables are kept updated for consistent balance and fairness.
This simple, plug-and-play package ensures a clean and rewarding raiding experience for your server.
This Raidable Bases Loot Tables (Easy to Nightmare) package includes:
- Easy Bases Base_Loot "Vanilla" & "Enhanced" tables
- Medium Bases Base_Loot "Vanilla" & "Enhanced" tables
- Hard Bases Base_Loot "Vanilla" & "Enhanced" tables
- Expert Bases Base_Loot "Vanilla" & "Enhanced" tables
- Nightmare Bases Base_Loot "Vanilla" & "Enhanced" tables
Beware: Our loot table package includes only the 5-tier loot tables within the Base_loot folder, ranging from easy to nightmare.
It does not include the loot tables from the Difficulty_Loot or Weekday_Loot folders.
It includes a separate loot table setup for each of the five tiers, with each one meticulously configured individually.
With future updates, we aim to continue improving our loot table day by day.
We additionally offer a package with 110 bases, including loot tables: https://codefling.com/bases/raidable-bases-pack-loot-tables-110-bases
INSTALLATION INSTRUCTIONS:
Extract the downloaded zip file using WinRAR. Then, move the files to the following location, ensuring a clean setup without any other files:
/serverfiles/oxide/data/RaidableBases/Base_Loot
You need to place the five prepared .json files for Easy through Nightmare bases into the Base_Loot folder.
The number of items that spawn in crates is determined not by the loot table but by five different configs found in the /serverfiles/oxide/data/RaidableBases/Profiles directory, using the code below.
For example, open Easy Bases.json inside the Profiles folder with Notepad, press CTRL+F, and search for "Amount Of Items To Spawn" In the example below, the spawn amount is set to 90.
You can adjust this number to your preference, either increasing or decreasing it. Keep in mind that changing this will affect the drop rates in the loot table.
"Amount Of Items To Spawn": 90,
You may also open the individual base profile files (e.g., Easy Bases.json, Medium Bases.json, Hard Bases.json, Expert Bases.json, Nightmare Bases.json) located in /serverfiles/oxide/data/RaidableBases/Profiles and adjust the "Loot Amount Multiplier" to values such as 2.0 or 5.0. This will alter the existing loot balance. However, we recommend keeping this setting at 1.0, as changing it may disrupt the intended loot balance:
"Loot Amount Multiplier": 1.0
If you're confident that you've successfully uploaded all the files, enter the following command in RCON to restart the plugin and apply the changes. Good luck:
Support: FULLWIPED DISCORD
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)
New Arrivals
What's New
Fresh uploads, new releases, and recently updated files.
-
$14.90
By m1t1ngg
-
$25.00
By NINJA WORKS
-
$10.00
By NINJA WORKS
-
$15.00
-
$15.99$12.99By Brad Copp
-
$5.00$4.30By Ionut Shiro
-
By jawad
-
$12.00
-
$10.00
-
$49.90$45.50 -
$14.99$9.99By crash
-
$30.00$20.00By NooBlet
Community Picks
Highest Rated
Top-rated picks trusted and loved by the community.
-
$16.99
By David
-
$40.00$30.00By nivex
-
$29.99$19.99By LosGranada
-
$29.99
By imthenewguy
-
$24.99
By Whispers88
-
$40.00$31.95By Mevent
-
Free
By Steenamaroo
-
$14.99
By AhigaO
-
$19.99
By Fruster
-
$14.99
By David
-
$45.99$40.47By Monster
-
$19.99$15.99By Fruster
-
$19.99
By ZEODE
Trending
Trending Files
Popular picks members are downloading the most right now.
-
$35.00
By KpucTaJl
-
$30.00
By 0xF
-
$29.90
By walkinrey
-
$29.99
By imthenewguy
-
$8.99$7.99By Brad Copp
-
By Scalbox
-
$40.00$30.00By nivex
-
$45.00$41.95By Mevent
-
$49.99
By Adem
-
Free
By Steenamaroo
-
$40.00
By The_Kiiiing
Deals
Great Deals
Discounted picks, limited-time deals, and sale items worth grabbing now.
-
$55.00$47.30By Ionut Shiro
-
$19.99$9.99By Hakan
-
$1.50$1.29By Ionut Shiro
-
$15.00$13.50By Razor
-
$12.99$9.99By fullwiped
-
$25.00$21.50By Ionut Shiro
-
$9.99$7.49By Wrecks
-
By Shemov
-
$18.99$16.71By Monster
-
$29.99$19.99By LosGranada
-
$29.90$24.00By J4V1
-
$11.50$5.50By WuyZar
-
$15.00$12.90By Ionut Shiro
-
$14.99$7.49
Community Feedback
Latest Reviews
See what customers are saying about their experience with files.
Great monument and more useful replacement of abandoned military base
The most important part of buying maps from Badgyver is the responsive support and rapid, "immediate" fixes for reported issues—such as map bugs or missing components—are highlighted as crucial ensuring that I as server owner can keep my server running smoothly.
Support is absolutely no help ever. Any changes I make to the config reset on server restart, and the support won't even take the time to look into it, and the answers I do get only lead me to believe I've looked through their files more than they probably ever have, in Classic Mevent Fashion.
LuffyRust and its players absolutely love how this monument works. Sewage Treatment Plant is a fantastic custom prefab that brings new life to a familiar Rust monument. It combines Water Treatment and Sewer Branch into one polished, functional, and exciting design that feels fresh without losing that natural Rust feel. A great way to make your map stand out, and another excellent release from Silent Creations. Highly recommended.
Very well done A nice mix instead of the regular supermarket.
love this event and players love it as it still requires you to use the natural red room at lauch to get to it.
Well done sir!!
Fantastic support. Needed a plugin to spawn players with permissions for a pvp arena & after working with the dev, got it working perfectly. Thank you for your work & commitment!
Love how the maker will work with server owners to better the product
I've been running Rust servers for a while now and gone through a LOT of maps... but Mordor is just on another level entirely. Like I genuinely don't even know where to start. It's the most fully custom stunning map I have ever loaded up and I mean that with everything in me.
I threw it on a test server just to mess around with it and people who joined literally did not want to leave. No events running, no real reason to stick around, just players wandering around in complete awe of the map
This Alpha loot table is amazing, it offers wide variety of loot between multiple lootable crates. It still makes your progression feel just right, and your event rewards on point!