FoBlackmarket

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.