W-Blackmarket | Premium Black Market

BLACK MARKET
The Ultimate Black Market System for Your Server

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

WHAT IS BLACK MARKET?

Black Market is a premium Minecraft plugin that brings a mysterious, timed marketplace to your server. The market opens and closes automatically, creating urgency and excitement for your players!

✔ Automatic Market Cycles - Opens/closes on schedule
✔ Dynamic Stock System - Limited quantities create demand
✔ Beautiful Modern GUIs - Stunning hex color support
✔ Category System - Organize items by type
✔ Full Customization - Configure everything to your needs
✔ Multi-Language Support - English & Turkish included
✔ Admin Panel - Track sales, manage database
✔ Vault Economy - Works with any economy plugin

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SCREENSHOTS

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FEATURES

Automatic Market Cycles

Market opens and closes automatically on schedule
Configurable open/close times (default: 10min open, 30min closed)
Countdown timer hologram above NPC
Automatic notifications when market opens/closes

Dynamic Stock System

Limited stock per item creates scarcity
Stock resets when market reopens (configurable)
Visual indicators for low/out of stock items
Create urgency and competition among players

Modern GUI System

Beautiful hex color support (#RRGGBB format)
Category-based item organization (Weapons, Armor, Tools, etc.)
Pagination for unlimited items
Premium black market theme with custom colors
Fully customizable through lang files

NPC & Hologram System

Custom NPC vendor with name tag
Dynamic hologram showing market status
Multiple spawn locations support
Auto-cleanup of old NPCs
Right-click to open market

Admin Management

Complete admin panel GUI
View all player purchases
Track sales statistics (top buyers, total revenue, etc.)
Recent sales log
Database management (backup/reset)
SQLite database for performance

Multi-Language Support

English (en_US) included
Turkish (tr_TR) included
Easy to add new languages
Color palette system for consistent theming

Highly Configurable

Dynamic category system (add/remove/edit categories)
Custom item configuration (blackmarket.yml)
Enchantments, lore, prices all customizable
Rarity system (common, rare, epic, legendary)
Price variance (±10% randomization)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

COMMANDS & PERMISSIONS

Commands:

Code:

  /blackmarket              - Opens info GUI (shows market status, NPC location)
  /blackmarket admin        - Opens admin panel (requires permission)
  /blackmarket reload       - Reloads configuration & categories
  /blackmarket spawnnpc     - Spawns/respawns NPC at configured location
  /blackmarket cleannpc     - Removes all old NPCs and holograms
  /blackmarket help         - Shows help menu

Permissions:

Code:

  karaborsa.admin          - Access to all admin commands
     karaborsa.use            - Basic usage (default: true for everyone)

PlaceholderAPI Support

The plugin integrates with PlaceholderAPI, allowing you to use these placeholders in any plugin that supports PlaceholderAPI (scoreboards, chat, holograms, etc.).

Available Placeholders:

Code:

%wblackmarket_prefix% - Shows plugin prefix from config
  %wblackmarket_currency% - Shows currency name (coin, dollars, etc.)
  %wblackmarket_market_status% - Shows if market is open or closed
  %wblackmarket_time_minutes% - Shows minutes until market opens/closes
  %wblackmarket_time_seconds% - Shows seconds until market opens/closes
  %wblackmarket_time_mmss% - Shows countdown in MM:SS format
  %wblackmarket_npc_world% - Shows NPC world name
  %wblackmarket_npc_x% - Shows NPC X coordinate
  %wblackmarket_npc_y% - Shows NPC Y coordinate
  %wblackmarket_npc_z% - Shows NPC Z coordinate
  %wblackmarket_npc_coord_line% - Shows full NPC coordinates (world x, y, z)
  %wblackmarket_total_items% - Shows total items available in market
  %wblackmarket_total_sold% - Shows total items sold (all time)
  %wblackmarket_total_revenue% - Shows total revenue from black market
  %wblackmarket_top_buyer% - Shows player with most purchases
  %wblackmarket_top_buyer_count% - Shows number of purchases by top buyer
  %wblackmarket_player_name% - Shows player's username
  %wblackmarket_player_display% - Shows player's display name
  %wblackmarket_player_uuid% - Shows player's unique ID

Example Usage:

Code:

# Scoreboard example:
    lines:
      - "&6&lBLACK MARKET"
      - "&7Status: %wblackmarket_market_status%"
      - "&7Time: %wblackmarket_time_mmss%"
      - "&7Items: %wblackmarket_total_items%"
      - "&7Revenue: %wblackmarket_total_revenue%"

Note: Statistics placeholders (total_sold, total_revenue, top_buyer) are cached and update every 10 seconds for performance.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

INSTALLATION

Step-by-Step Installation:

1. Download the plugin JAR file
2. Make sure you have Vault installed on your server
3. Make sure you have an economy plugin (EssentialsX, CMI, etc.)
4. Place the JAR in your plugins folder
5. Restart your server
6. Edit config.yml and blackmarket.yml to your liking
7. Run /blackmarket reload to apply changes
8. Run /blackmarket spawnnpc to create the NPC

DEPENDENCIES:

Vault - Required for economy integration
Economy Plugin (EssentialsX, CMI, etc.) - Required

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CONFIGURATION

Code:

    # Market timer settings
    market-open-time: 10      # Minutes market stays open
    market-closed-time: 30    # Minutes market stays closed

    # Stock system
    stock-system:
      enabled: true
      reset-on-market-open: true

    # GUI settings
    gui-size: 54
    gui-title: "&8&lBLACK MARKET"

    # Economy
    prefix: "&6&lBLACKMARKET &8▶ "
    birim: "coin"

    # Dynamic category system
    categories:
      weapons:
        enabled: true
        slot: 1
        name: "&#F35B5B⚔ Weapons"
        icon: "DIAMOND_SWORD"
        priority: 1

      armor:
        enabled: true
        slot: 2
        name: "&#17A2B8 Armor"
        icon: "DIAMOND_CHESTPLATE"
        priority: 2
      # ... more categories

Code:

    items:
      god_sword:
        material: NETHERITE_SWORD
        name: "&#FF6B6B&l⚔ God Sword"
        lore:
          - ""
          - "&#FFD700Legendary weapon!"
          - "&#90EE90One-hit your enemies!"
        enchantments:
          - "DAMAGE_ALL:10"
          - "FIRE_ASPECT:3"
          - "LOOT_BONUS_MOBS:3"
        price: 50000
        rarity: legendary
        stock: 1
        category: weapons
        amount: 1

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

COLOR PALETTE

The plugin uses a modern hex color palette for a premium Black Market theme:

Code:

    DANGER_RED:     &#F35B5B  - Errors/Danger
    BLOOD_RED:      &#8B0000  - Black Market Logo
    SUCCESS_GREEN:  &#2ECC71  - Success messages
    EMERALD:        &#50C878  - Money/Currency
    GOLD:           &#FFD700  - Gold/Highlights
    DARK_PURPLE:    &#6C3483  - Premium/Special
    LIGHT_PURPLE:   &#B19CD9  - Info/Tips
    CYAN:           &#17A2B8  - Links/Clickable
    SILVER:         &#C0C0C0  - Gray info texts

All colors are fully customizable through lang files!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SUPPORT & UPDATES

Need Help?

Discord: woodiez.
Bug Reports: Please report on this thread or Discord
Feature Requests: I'm open to suggestions!

Version Information:

Current Version: 2.1
Tested On: Spigot/Paper 1.16.5 - 1.20.x
Java Version: Java 8+

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CHANGELOG

✔ Complete rewrite with modern architecture
✔ Dynamic category system
✔ Hex color support with modern palette
✔ SQLite database integration
✔ Admin panel with statistics
✔ Multi-language support
✔ Performance optimizations
✔ Better GUI design

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

If you enjoy this plugin, please leave a rating!

Developed with

by Woodiez

W-Blackmarket | Premium Black Market v2.1.0

Overview Dependencies Updates (1) History