Give players a rotating black-market shop with limited stock, rarity-based deals, and configurable rewards.
FoBlackmarket adds a clean black-market system for server owners who want rare deals, timed restocks, and NPC-friendly shop access without building everything in config files. Players can browse active offers, see prices and server-wide or per-player stock, and buy rewards while admins control the reward pools, rarities, layout, costs, and restock behavior.
Features
- Create rotating black-market offers with configurable server-wide or per-player stock, prices, and restock timers.
- Roll offers by rarity so common, rare, epic, and legendary deals can appear at different chances.
- Charge players with Vault money, required items, or both for more flexible server economies.
- Reward players with physical items, console commands, or a mix of both.
- Preserve full reward, cost, and icon item data, including names, lore, custom model data, attributes, enchantments, and skull data.
- Show players useful offer details such as rarity, stock, cost, chance, sold-out state, and time until restock.
- Manage rewards, rarities, restocks, broadcasts, and the market layout from in-game admin GUIs.
Setup Notes
FoBlackmarket is designed for command-driven or NPC-driven server workflows. Use the admin opengui command from your NPC/menu setup to open the purchasable market for a player, then use /blackmarket as the player-facing info or browser command.
The default market includes example reward pools, rarity slots, stock amounts, money costs, and a 60-minute restock interval. You can edit the YAML files directly or use the in-game editor to adjust the shop.
Dependencies
- Vault: Optional, but required for money-based costs
- PlaceholderAPI: Optional, adds
%foblackmarket_time_remaining%
Commands
/blackmarket- Shows market info or opens the player browser GUI, depending on config./bm- Alias for/blackmarket./blackmarketadmin version- Shows the installed plugin version./blackmarketadmin editor- Opens the in-game black market editor./blackmarketadmin reload- Reloads config and market data./blackmarketadmin restock- Rerolls the active market immediately./blackmarketadmin opengui <player>- Opens the purchasable black market GUI for a player./bmadmin- Alias for/blackmarketadmin.
Permissions
foblackmarket.use- Allows players to use/blackmarket. Default: everyone.foblackmarket.admin- Allows access to admin commands and editor tools. Default: operators.
Optional PlaceholderAPI support exposes the live restock timer, and Vault economy support is used automatically when money-based rewards are configured.
Placeholders
%foblackmarket_time_remaining%- Shows the time until the next black market restock formatted.
