https://youtu.be/DTzNlv9yHBw
 
ByBlackMarket - Advanced & Dynamic Black Market System
 
 
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
- Requirements: You must have Vault and an economy plugin (e.g., EssentialsX, CMI) installed on your server.
 
- Place the ByBlackMarket.jar file into your server's plugins folder.
 
- 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