These are all the commands you can execute, remember that you need the permissions.

• /bm sell [value]

  - Sell a item

• /bm reload

  - Reload config

• /bm setnpc (skin_name)

  - Set a NPC

• /bm removenpc

  - Remove a NPC

• /bm open (player)

  - Open the BlackMarket

Set the permissions correctly, you don't want someone spawn some npcs.

• blackmarket.admin

  - Allow use all commands

• blackmarket.open

  - Open the market with a command

• blackmarket.reload

  - Reload command

• blackmarket.npc.*

  - Allow use setnpc and removenpc commands

• blackmarket.npc.set

  - Spawn a NPC

• blackmarket.npc.remove

  - Remove a NPC

• blackmarket.limit

  - Unlimited posts

• blackmarket.limit[number]

  - Limited post

• blackmarket.remove_item

  - Cancel any post

If you need to publish an article you can do it using the command /bm sell [value] or using the aliases that are configured. But, if you don't like this method you can also do it through the BlackMarket menu, just open the menu, select the item to publish, and choose what you want to sell.

You have not understood my super steps by steps? Well, okay, follow these simple instructions...

Using command:

1. Press T key to open the chat
2. Write /bm sell [value], and replace [value] for the price of your item
3. Press ENTER
4. Done, your item is posted in the market!

Using the market:

1. Goto the BlackMarket NPC
2. Interact with him
3. Find the item that says "Sales menu"
4. Right click him
5. Select the item you want to sell from your inventory
6. Click on "Value"
7. Press T key to open the chat
8. Write into the chat your item value
9. Press ENTER
10. Right click on the item "Post"
11. Done, your item is posted in the market!

They are lists of materials or objects belonging to the same class. It can be useful to separate Blocks, Tools, Armor and Redstone, in different sections.

To set an NPC you need to have blackmarket.npc.set permission, then run the /bm setnpc command to spawn it.

You can also change the skin with which the NPC will appear by adding at the end of the command the name of the player /bm setnpc [player_name] or the skin that you have saved in the file skindata.yml /bm setnpc skin_[name]

If you need to change the language, taxes, database, menu materials, etc. enter this file and change the values you need. Remember that you can use the /bm reload command to reload the configuration.

config.yml

lang: en_US

mysql:
  enable: false
  host: "localhost"
  port: 3306
  user: "root"
  pass: ""
  database: "server"

# BETA (MySQL need be enabled)
multi_server:
  enable: false
  check_new_items: 1 # seconds

economy_type: VAULT # VAULT - PLAYERPOINTS - GEMSECONOMY#Currency

menus:
  market: # You can use custom models like this -> material#custom_model_id - GRAY_STAINED_GLASS_PANE#2200002
    background: GRAY_STAINED_GLASS_PANE
    border: BLACK_STAINED_GLASS_PANE
    sales:
      type: NETHER_STAR
      slot: 47
    next:
      type: PAPER
      slot: 53
    previous:
      type: PAPER
      slot: 46
    close:
      type: ARROW
      slot: 49
    order:
      type: BOOK
      slot: 51
    info:
      type: REDSTONE_TORCH_ON
      slot: 50
    storage:
      type: CHEST
      slot: 52
    categories:
      all:
        type: NETHER_STAR
      ores:
        type: IRON_PICKAXE
      potions:
        type: POTION
      redstone:
        type: REDSTONE
      tools:
        type: FISHING_ROD
      wood:
        type: IRON_AXE
  storage:
    background: GRAY_STAINED_GLASS_PANE
    border: BLACK_STAINED_GLASS_PANE
    back:
      type: ARROW
      slot: 49
    take_items:
      type: NETHER_STAR
      slot: 50
  sales:
    background: GRAY_STAINED_GLASS_PANE
    border: BLACK_STAINED_GLASS_PANE
    back:
      type: ARROW
      slot: 49
    item:
      type: DIAMOND_SWORD
      slot: 20
    value:
      type: SUNFLOWER
      slot: 24
    post:
      type: EMERALD
      slot: 22
  content:
    border: BLACK_STAINED_GLASS_PANE
    back:
      type: ARROW
      slot: 49
  confirm:
    background: GRAY_STAINED_GLASS_PANE
    border: BLACK_STAINED_GLASS_PANE
    back:
      type: ARROW
      slot: 49
    buy:
      type: EMERALD
      slot: 20
    cancel:
      type: BARRIER
      slot: 24
    item:
      slot: 22

minimum_price: 1.0
maximum_price: 99999.0
taxes: 7 # percent

limit: 5 # items by user
expired_time: 1440 # 1440 minutes = 24 hours

blacklist_enable: false
blacklistlore_enable: false

confirm_menu_enable: false

sell_alias:
- sell
                    

The plugin has many translations that the community send (Thank you very much). If you want to add your own, or modify the messages, you need to go to the BlackMarket/languages folder.

If you need an example of what the language file looks like, see the following:

example.yml

no_permission: "&cYou don't have permission to use this command!"
only_player: "&cThis command only can be used by Players!"
offline_player: "&c(&4%player%&c) is offline!"
command:
  sell:
    message: "&eItem added!"
    error_limit: "&cYou have reached the limit of published objects!"
    error_item_not_found: "&cYour hand is empty, you need an item to sell!"
    error_item_not_allow: "&cThis material is not valid in the market!"
    error_value: "&cValue invalid!"
    error_minimum_price: "&cThe minimum price is %price%!"
    usage: "&cUsage /%cmd% (value)"
  reload:
    message: "&eReloaded configuration!"
  setnpc:
    message: "&eNPC placed in your position!"
  removenpc: 
    message: "&eRight click to a NPC to remove it!"
    removed: "&eNPC removed!"
    invalid: "&cNPC not detected!"

help:
- "&aBlackMarket - Commands:"
- "&8 » &7/bm reload &8- &7(&fReload config&7)"
- "&8 » &7/bm open [player] &8- &7(&fOpen the BlackMarket&7)"
- "&8 » &7/bm setnpc [skin_name] &8- &7(&fSet a NPC&7)"
- "&8 » &7/bm removenpc &8- &7(&fRemove a NPC&7)"
- "&8 » &7/bm sell [value] &8- &7(&fPost an item&7)"

market:
  buy: "&eThanks for buy!"
  inventory_full: "&cInventory full!"
  item_invalid: "&cThis item is not for sale!"
  missing_money: "&cYou haven't a money to buy this!"
  item_owner: "&cYou can't buy your items!"
  take_items: "&eItems taken!"
  cancel_post: "&ePost cancelled!"
  notification: "&eItem &a%name% &esold for &6%value%&e!"

sales:
  item_not_found: "&cChoose an item to sell from your inventory!"
  value: "&eWrite the sale value of the item!"

menus:
  market:
    title: "BlackMarket"
    items:
      sales:
        name: "&bSales menu"
        lore:
        - "&7Menu to publish articles"
        - "&7in the market."
        - ""
        - "&eClick to open!"
      item_onsale:
      - "&8Owner: &b%owner%"
      - "&8Value: &6%value%$"
      - "&8To expire: &b%expired%"
      - ""
      - "&eClick to buy!"
      item_onsale_remove:
      - "&cRight click to remove!"
      item_onsale_content:
      - "&3Middle click to inspect!"
      next:
        name: "&eNext page (%actual_page%-%pages%)"
      previous:
        name: "&ePrevious page (%actual_page%-%pages%)"
      close:
        name: "&cExit"
      order:
        name: "&bOrder type"
        lore:
        - "&8- &7%order_id%"
        - "&8- &7%order_type%"
        - "&8- &7%order_amount%"
        - "&8- &7%order_value%"
        - ""
        - "&eLeft click to change!"
        - "&eRight click to reverse!"
        format: "%active% %value%"
        active: "&c»&4"
        values:
          id: "IDs"
          type: "Material"
          amount: "Amount"
          value: "Value"
      info:
        name: "&bInformation"
        lore:
        - "&7Cmd to sold /bm sell [amount]"
        - "&4(Time to expired 24 hours)"
      storage:
        name: "&bStorage"
        lore:
        - "&7Your unsold items"
        - ""
        - "&eClick to open!"
      categories:
        all:    # categories/all.yml
          name: "&bAll"
          lore:
          - "&7All items"
        ores:
          name: "&bOres"
          lore:
          - "&7List:"
          - "&8 - &7Iron"
          - "&8 - &7Gold"
          - "&8 - &7Diamond"
          - "&8 - &7Emerald"
          - "&8 - &7..."
        potions:
          name: "&bPotions"
          lore:
          - "&7List:"
          - "&8 - &7Potions"
          - "&8 - &7Nether wart"
          - "&8 - &7Blaze rod"
          - "&8 - &7Ghast tear"
          - "&8 - &7..."
        redstone:
          name: "&bRedstone"
          lore:
          - "&7List:"
          - "&8 - &7Redstone"
          - "&8 - &7TNT"
          - "&8 - &7Dispenser"
          - "&8 - &7Observer"
          - "&8 - &7..."
        tools:
          name: "&bTools"
          lore:
          - "&7List:"
          - "&8 - &7Shears"
          - "&8 - &7Axe"
          - "&8 - &7Pickaxe"
          - "&8 - &7Shovel"
          - "&8 - &7..."
        wood:
          name: "&bWood"
          lore:
          - "&7List:"
          - "&8 - &7Oak log/planks"
          - "&8 - &7Spruce log/planks"
          - "&8 - &7Jungle log/planks"
          - "&8 - &7Acacia log/planks"
          - "&8 - &7..."
  storage:
    title: "BlackMarket - Storage"
    items:
      back:
        name: "&cReturn"
      take_items:
        name: "&bTake items"
        lore:
        - "&7Take all items"
        - ""
        - "&eClick to take!"
  sales:
    title: "BlackMarket - Sales"
    items:
      back:
        name: "&cCancel"
        lore:
        - "&eClick to cancel sell!"
      post:
        name: "&bPost"
        lore:
        - "&7Are you sure?"
        - ""
        - "&eClick to post!"
      value:
        name: "&bValue"
        lore:
        - "&7Actual: &6$%sale_value%"
        - ""
        - "&eClick to change price!"
      item:
        name: "&bItem"
        lore:
        - "&7Change this item so"
        - "&7you can post."
        - ""
        - "&eClick to item in your"
        - "&einventory to change!"
      item_changed:
      - ""
      - "&eClick to item in your"
      - "&einventory to change!"
  content:
    title: "BlackMarket - Content"
    items:
      back:
        name: "&cReturn"
  confirm:
    title: "BlackMarket - Confirm"
    items:
      back:
        name: "&cReturn"
      buy:
        name: "&aBuy"
        lore:
        - "&8Owner: &b%owner%"
        - "&8Value: &6%value%$"
        - ""
        - "&eClick to buy!"
      cancel:
        name: "&cCancel"
        lore:
        - "§8Cancel the purchase"
        - "&8of this item"
        - ""
        - "&eClick to cancel!"
      
npc:
  name: "BlackMarket"
  click: "&eClick here!"

time_data: # Example 16h 23m
    day: "d"
    hour: "h"
    minute: "m"
    second: "s"
                    

You can prohibit the publication of some articles in the store, for this you need to activate blacklist and blacklist_lore in the config.yml file.

BlackList serves to prevent some materials from being sold.
BlackListLore will be in charge of analyzing the descriptions of the articles and preventing items that contain them from being published. (Very useful for items given by Kits)