About Black Market - NPC Trader
Black Market
Rotating NPC Black Market Trader
Bring a High Stake, black market trader to your server. A mysterious NPC trader spawns and broadcasts their arrival and vanishes after a configurable amount of time. Players interact with a modern CUI shop to buy limited Stock, and players can get top teir items by completing delivery style contracts to the Black market ai.
Why should you buy this?
- Works on PVP, PVE, Vanilla+, Modded and RP Servers
- Fully Configurable Stock, Missions, Cooldowns, spawn settings, marker, warnings, bodyguards, messages and sounds.
- Clean UI with pagination, cooldown indicators, affordability states and a live balance display
Features
Trader System
- Random Spawns with configurable interval + lifetime of NPC
- Base Safe Spawning (avoids construction + deployed entities so it wont appear inside bases)
- Flat ground checking (extra slops checks to reduce awkward spawns)
- Trader is non-lootable and cannot be damaged
Contracts/Missions
- Players accept jobs and turn in required items to unlock higher-tiered purchases
- Active contracts shown in a dedicated UI section
- Admins can reset players progress
Map Marker + Countdown Warnings
- Optional map marker for trader location
- Optional departure warnings (configurable warning times)
Bodyguards (Optional)
- Enable guards, set count/health/prefab/radius
- Hostile or passive behaviour toggle in config
Permissions
-
blackmarketai.use (optional gate, config controlled)
-
blackmarketai.admin
-
blackmarketai.vip (reduced cooldowns)
-
blackmarketai.nocooldown (bypass all cooldowns)
Commands
player
- /bm info - trader status
- /bm missions - view active missions
Admin (blackmarketai.admin)
- /bm spawn - force spawn trader
- /bm despawn - remove all black market traders
- /bm tp - teleport to trader
- /bm reset [Name] - reset a player (or all players if no name is included)
- /bm stats - Npc trader stats
Developer Hooks (for integration)
- CanBlackMarketTrade(player, position)
- OnBlackMarketPurchase(player, itemShortname, quantity, costAmount)
- OnBlackMarketPurchaseComplete(player, itemShortname, quantity)
- OnBlackMarketMissionAccepted(player, missionId)
- OnBlackMarketMissionCompleted(player, missionId)
- OnBlackMarketTraderSpawned(position, grid)
- OnBlackMarketTraderDespawned(position)
