BlackMarket

BlackMarket Plugin

Overview

BlackMarket is an exclusive, highly customizable GUI-based black market shop plugin for your Minecraft server. It brings a unique dynamic economy experience by offering randomly opening shops or fixed-duration black markets. With built-in purchase tracking and an integrated Admin GUI Editor, managing rare or illegal item sales has never been easier or more immersive!

Features

- Robust Economy Integration: Choose between an `always-open` shop, or a thrilling `random-open` system that alerts players when the market appears! - Robust Economy Integration: Want a rotating shop? Enable `random-pick` and define how many items to showcase! The plugin will organically select items and display them neatly. - Robust Economy Integration: Items are restricted by a global stock limit. If `stock-market` is enabled, an item's price will dynamically double when it completely sells out! - Robust Economy Integration: Prevent economy abuse by setting a `player-purchase-limit` per opening phase, tracked reliably via SQLite. - Robust Economy Integration: Admins can easily add, edit, or adjust items (prices, GUI slots, and stocks) directly in-game without touching config files. - Robust Economy Integration: Smooth custom animations (like `slide` in the config) and stylized UI menus. - Robust Economy Integration: When the market opens, alert your entire server using Titles, Broadcasts, Fireworks, and Sounds. - Robust Economy Integration: Automatically notify your Discord community precisely when the in-game black market opens, complete with custom Bot names and avatars! - Robust Economy Integration: Soft-depends on Vault to securely handle all transactions. Also supports PlaceholderAPI and Citizens!

Commands

- `/blackmarket` - Opens the BlackMarket GUI (if it is currently open). - `/blackmarket editor` - Opens the Admin Control Panel GUI to build and edit your shop inventory. - `/blackmarket reload` - Reloads all configuration files instantly!

Permissions

- `blackmarket.use` - Allows players to open the shop menu. (Default: true) - `blackmarket.editor` - Allows opening the admin GUI editor. (Default: op) - `blackmarket.reload` - Allows reloading the plugin manually. (Default: op)

Configuration

The plugin generates a pristine `config.yml` on first run:

`config.yml` Options:

- Discord Alerts: - `always-open` / `random-open` switches the style of your black market. - `random-pick`: Set to true to display a rotating shop of random items! Control the quantity with `random-pick-amount`. - `stock-market`: Set to true to automatically double an item's price when its stock reaches zero. - `open-duration`: Timer indicating how long players have to buy items when it opens (e.g. `30m`). - `player-purchase-limit`: Limits the total slots of items a player can buy in one session! - Discord Alerts: - `gui-effects` handle animations like sliding items. - Toggles for `firework`, `sound`, `title`, and `broadcast` precisely control how the server reacts when the shop goes live. - Discord Alerts: - Enter your `webhook-url`, `bot-name`, and `channel-id` to automatically sync notifications to your Discord Server.

Author Information

- Discord Server: KakashiPlayz! - Discord Server: KakashiPlayz! - Discord Server: https://kakashiplayz.vercel.app - Discord Server: https://discord.gg/QdTN4BFkTv

Plugin Version

1.0.2

Compatibility

Works natively with the following Minecraft server versions: - 26.1, 26.1.1 - 26.1, 26.1.1 - 26.1, 26.1.1 - 26.1, 26.1.1 *(new Minecraft versioning scheme)*

Compatible with Spigot, Paper, Purpur, and Bukkit-based servers. Requires Vault & a valid Economy plugin to process purchases!

Installation

1. Ensure you have installed Vault and an Economy Plugin (e.g. EssentialsX) 2. Place the `BlackMarket.jar` file in your server's `plugins` folder 3. Restart your server 4. The plugin will generate configuration files in the `plugins/BlackMarket` folder 5. Configure your settings, MySQL/SQLite database in the files, and you're good to go!

Support

For issues or questions, join our Discord server: https://discord.gg/QdTN4BFkTv