ByBlackMarket is an advanced black market plugin that offers a mysterious and exclusive shopping experience beyond ordinary shops. Create a special marketplace for your players, accessible only at certain times, in specific locations, or with defined limits. Bring a new dynamic to your server's economy with its fully configurable structure and modern features!



⭐ Features

• Modern & User-Friendly GUI: All transactions take place through a modern and fast interface that players can easily navigate.
• Category System: Organize your shop by separating items into different categories like Weapons, Potions, Blocks, etc.
• Time Restriction: Make the black market active only on weekends, at night, or during any specific time frame you define.
• Location Restriction: Make the black market exclusive to a secret area you define on your map. Only players who find that area can access the market.
• Dynamic Stock & Personal Limits: Set an initial stock for each item and watch it deplete! You can also limit how many times each player can purchase an item (daily, weekly, or permanently).
• Crash-Proof Data Saving: Your stock levels and player data are always safe thanks to a secure .yml-based saving system that prevents data loss even during server crashes.
• Effects & Commands: Add custom sound effects to purchases and execute special commands when an item is bought (e.g., broadcasting a message).
• Multi-Language Support: Easily edit all messages via lang files and use any language you want. (Comes with Turkish and English pre-configured).

Installation

1. Requirements: You must have Vault and an economy plugin (e.g., EssentialsX, CMI) installed on your server.
2. Place the ByBlackMarket.jar file into your server's plugins folder.
3. Start the server. All necessary configuration files (config.yml, shops.yml, etc.) will be generated automatically.

⚙️ Configuration
The plugin's greatest strength is that every detail is configurable.

• config.yml: Manage the plugin's main settings here, such as language, time/location restrictions, GUI settings, limit systems, and effects.
• shops.yml: Add and edit the items to be sold in the black market from this file.

Example Item Definition (shops.yml):

YAML
items:
legendary_sword:
# The item itself
item:
material: DIAMOND_SWORD
amount: 1
# The category it will appear in (defined in config.yml)
category: 'weapons'
# The item's rarity (can be used for effects)
rarity: 'LEGENDARY'
# The display name of the item
name: '&6Legendary Sword'
# The item's description (supports placeholders)
lore:
- '&7A weapon from an age long past.'
- ''
- '&fPrice: &e{price}'
- '&fStock: &e{stock}'
- '&fYour Limit: &e{limit}'
# The item's price
pricing:
base: 50000.0
# Stock settings
stock:
initial-amount: 10 # -1 = Unlimited
# Personal limit settings
limit:
amount: 1 # -1 = Unlimited
reset-period: 'WEEKLY' # NEVER, DAILY, WEEKLY
# Commands to execute upon purchase
commands:
- 'broadcast &6{player} &ehas purchased a legendary sword!'



⌨️ Commands & Permissions

Command Description Permission
/blackmarket Opens the black market menu for players. (None required)
/byb reload Reloads the plugin's configuration files. byblackmarket.admin
/byb setregion <pos1|pos2> Sets the corners for the location-based market. byblackmarket.admin