VortixMarketplace
An intuitive marketplace UI for all types of servers with many features

VortixMarket gives server owners a fully configurable in-game server store and player marketplace wrapped in a clean, dark-futuristic UI. It supports server catalogue sales (items, kits, vehicles), player listings, daily deal rotations, multiple database providers, and flexible economy integrations.
https://github.com/sarshane/UnturnedImagesGenerator
Key Features
- Dual-Mode System:
- Server Shop: Admin-curated items, kits, and vehicles organized across custom categories with permission locks.
- Player Market (Black Market): Community-driven player marketplace allowing survivors to list their loot, weapons, and supplies for sale.
- Dynamic Daily Deals:
- Automatically features discounted items with countdown timers to encourage daily player retention.
- Zero-Dupe Virtual Drop Container:
- When players list an item, the plugin opens a temporary virtual storage container directly in their UI.
- Captures exact item ID, quantity, durability/quality, and complete metadata byte states (sights, grips, barrels, magazines, ammo counts, tacticals).
- Automatically returns items safely to inventory (or ground drops if inventory is full) upon cancellation.
- Collision-Safe Vehicle Deliveries:
- Vehicle purchases perform smart raycast obstacle detection and ground alignment to safely spawn vehicles directly in front of players without clipping through walls or terrain.
- Dual Currency Options:
- Works with standard Uconomy balances or vanilla Unturned Experience (EXP).
- Plug-and-Play Multi-Database:
- LiteDB (Default): Embedded, high-speed NoSQL database requiring zero external setup.
- MySQL: Full relational schema with connection pooling, indexes, and automated table generation for large networks.
- Dynamic Item Icons:
- Streams high-resolution PNG item and vehicle icons directly from GitHub (
MeedicBear/UnturnedImages) or any custom web server/CDN without client downloads.
- Streams high-resolution PNG item and vehicle icons directly from GitHub (
- Modular Configuration:
- Separated clean JSON files for core settings, UI labels, shop items, categories, and daily deals.
Commands & Aliases
| Command | Aliases | Description | Default Permission |
|---|---|---|---|
/market | /shop, /store, /blackmarket | Opens the main shop and marketplace interface | vortix.market |
/market reload | /shop reload | Reloads all JSON configuration files without restarting | vortix.market.admin |
Permissions
| Permission | Description |
|---|---|
vortix.market | Grants access to open the shop and market UI via /market, /shop, /store. |
vortix.market.admin | Grants access to reload plugin configuration files via /market reload. |
vortix.market.vip | Grants extended player listing slots (default: 12 active listings). |
vortix.market.mvp | Grants extended player listing slots (default: 18 active listings). |
vortix.market.sponsor | Grants maximum player listing slots (default: 24 active listings). |
Server owners can define custom permission names and listing limits inside config.json.
Configuration Architecture
All configurations are automatically created and organized under the plugin's folder:
Plugins/VortixMarket/
├── config.json <- Core engine, database, and economy settings
├── ui_config.json <- Branding titles, subheaders, and button labels
├── shop_categories.json <- Shop category tabs and permissions
├── shop_items.json <- Items, kits, and vehicles available in the store
└── daily_deals.json <- Daily deal items, prices, and rotation intervals
config.json (Core Settings)
{
"DatabaseType": "LiteDB",
"CurrencyType": "Uconomy",
"MySqlConnectionString": "Server=127.0.0.1;Port=3306;Database=unturned_market;Uid=root;Pwd=password;",
"MarketFeePercent": 5.0,
"DefaultListingSlots": 6,
"PermissionListingSlots": {
"vortix.market.vip": 12,
"vortix.market.mvp": 18,
"vortix.market.sponsor": 24
},
"AllowedDurationsHours": [
24,
48,
72
],
"EnableVirtualDropContainer": true,
"VirtualContainerBarricadeId": 328,
"VehicleSpawnDistance": 6.0,
"VehicleSafeCheckRadius": 2.5,
"EffectId": 15034,
"EffectUILayer": 1,
"ItemImageUrlTemplate": "https://raw.githubusercontent.com/MeedicBear/UnturnedImages/main/Items/Official/{0}.png",
"VehicleImageUrlTemplate": "https://raw.githubusercontent.com/MeedicBear/UnturnedImages/main/Vehicles/Official/{0}.png"
}
Settings Reference:
DatabaseType:LiteDB(embedded fileMarketData.db) orMySQL.CurrencyType:Uconomy(requires Uconomy plugin) orExperience(vanilla player EXP).MarketFeePercent: Percentage deducted from the seller upon purchase (e.g.,5.0= 5% transaction tax).DefaultListingSlots: Base number of simultaneous market listings allowed for standard players.PermissionListingSlots: Dictionary mapping permission nodes to custom listing caps.AllowedDurationsHours: Allowed listing duration choices before expiration.ItemImageUrlTemplate: Image URL template for items where{0}is dynamically substituted with the Unturned Item ID.VehicleImageUrlTemplate: Image URL template for vehicles where{0}is dynamically substituted with the Vehicle ID.VehicleSpawnDistance: Distance in meters in front of the player to spawn purchased vehicles.VehicleSafeCheckRadius: Physics collision raycast sphere radius to check for obstacles before spawning.EffectUILayer: Sorting layer order for the UI canvas (default1allows native storage drop boxes to render cleanly in front).
ui_config.json (Interface Customization)
Allows total customization of branding icons, color themes, all text, titles, subtitles, headers, currency signs, and notifications shown in the UI:
{
"LogoIconUrl": "https://i.imgur.com/mr3lZQ1.png",
"Theme": "Default",
"ShopBrandTitle": "SURVIVOR OUTPOST",
"ShopBrandSubtitle": "SHOP",
"MarketBrandSubtitle": "MARKET",
"ShopWelcomeTitle": "WELCOME TO THE SURVIVOR OUTPOST",
"ShopWelcomeSubtitle": "Find the best gear and supplies across the server.",
"PlayerMarketTitle": "PLAYER MARKET",
"PlayerMarketSubtitle": "Buy and sell items with other survivors.",
"MyListingsTitle": "MY LISTINGS",
"MyListingsSubtitle": "Manage all of your items that are currently listed on the market.",
"CurrencySymbol": "$",
"ExpSymbol": "XP",
"SearchPlaceholder": "Search items...",
"MarketFeeNote": "Market fee: {0}%\nYou will receive the money once the item is sold.",
"ListingSlotsNote": "VIP players can hold more active listings."
}
Interface Customization Reference:
LogoIconUrl: Web image URL (PNG/JPG) for the top-left branding badge (default custom market emblem).Theme: Selectable background obsidian theme:"Default"(Cyber Cyan),"Red","Green","Purple", or"Yellow".
shop_categories.json (Store Categories)
Define custom category tabs with icons and optional permission restrictions:
[
{
"Id": "FEATURED",
"DisplayName": "FEATURED",
"IconName": "icon_star"
},
{
"Id": "WEAPONS",
"DisplayName": "WEAPONS",
"IconName": "icon_gun"
},
{
"Id": "VEHICLES",
"DisplayName": "VEHICLES",
"IconName": "icon_plane"
},
{
"Id": "VIP",
"DisplayName": "VIP EXCLUSIVES",
"IconName": "icon_duty_shield",
"RequiredPermission": "vortix.market.vip"
}
]
shop_items.json (Server Catalog)
Supports standard Items, Vehicles, and Kit redemptions without messy null clutter:
[
{
"Id": "shop_maplestrike",
"CategoryId": "WEAPONS",
"ItemType": "Item",
"TargetId": 363,
"DisplayName": "Maplestrike",
"Rarity": "Rare",
"Price": 350.0
},
{
"Id": "shop_apc",
"CategoryId": "VEHICLES",
"ItemType": "Vehicle",
"TargetId": 51,
"DisplayName": "Armored APC",
"Rarity": "Epic",
"Price": 12000.0
},
{
"Id": "shop_kit_assault",
"CategoryId": "KITS",
"ItemType": "Kit",
"KitName": "Assault",
"DisplayName": "Assault Loadout",
"Rarity": "Legendary",
"Price": 5000.0
}
]
You can also use
"ItemId": 363or"VehicleId": 51as intuitive aliases for"TargetId".
daily_deals.json (Rotating Deals)
Configures timed daily deal items with original vs. discounted pricing:
{
"Enabled": true,
"RotationIntervalMinutes": 60,
"Deals": [
{
"ItemType": "Item",
"TargetId": 15,
"DisplayName": "Medkit",
"Rarity": "Legendary",
"OriginalPrice": 350.0,
"DiscountedPrice": 245.0
},
{
"ItemType": "Vehicle",
"TargetId": 93,
"DisplayName": "Forest Huey",
"Rarity": "Epic",
"OriginalPrice": 22000.0,
"DiscountedPrice": 15400.0
}
]
}
For full setup instructions, permission nodes, and examples, refer to CONFIG_GUIDE.md
VortixMarketplace
Required Workshop
Latest Changes
v1.0.1