FoBlackmarket - Timed Black Market Shop

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 stock, and buy rewards while admins control the reward pools, rarities, layout, costs, and restock behavior.

Features

• Create rotating black-market offers with configurable 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.
• 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

• Server: Spigot/Paper 1.21+ with Java 21
• 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.