Configuration

Here are the configuration values for GlobalMarket 1.3.0. The config is located at plugins/GlobalMarket/config.yml

Permissions Changes

• globalmarket.util is now two separate permission nodes, globalmarket.util.mailbox and globalmarket.util.stall
• globalmarket.nocut (to bypass cut) and globalmarket.nofee (bypass creation fees) permissions.
• globalmarket.seeannounce to see listing creation announcements

Storage Settings

storage:
  type: sqlite
  mysql_user: root
  mysql_pass: password
  mysql_database: market
  mysql_address: localhost
  mysql_port: 3306

• type is the type of storage to use, currently there is only mysql and sqlite.
• mysql_user, mysql_pass, mysql_database, mysql_address, and mysql_port are all MySQL configuration options.

---

Multi-world Settings

multiworld:
  enable: false
  links:
    world:
    - world_nether
    - world_the_end  

• enable if set to true will enable multi-world support. If enabled, listings and mail will only be shown within the world they are created.
• links defines 'world links', you can group worlds together so they share their listings and mail. Here, listings and mail from world, world_nether, and world_the_end are all grouped together and listings/mail will be shown from all three of those worlds.

---

Limits Settings

limits:
  default:
    cut: 0.05
    max_price: 10000
    max_item_prices:
      stone:
        dmg: 0
        price: 50.0
    creation_fee: 5
    max_listings: 15
    expire_time: 168
    queue_trade_time: 5
    queue_mail_time: 5
    allow_creative: false
  admin:
    cut: 0.0
    max_price: 0.0
    creation_fee: 0
    max_listings: 0
    expire_time: 0
    queue_trade_time: 0
    queue_mail_time: 0
    allow_creative: true

• limits defines per-user limits. Each set has a permission node you can assign to players: globalmarket.limits.<set name>
  Players without an assigned limit set will get the values under the default set. In the above example, players with the globalmarket.limits.admin permission will receive no limits.
• cut can either be a flat fee (like 100) or a percentage (like 0.05, which is 5%) of money to withhold from each transaction. Set to 0 to disable.
• max_price is the max price limit. 0 is infinite.
• max_item_prices allows you to define a max price per item:

Define items as follows:

<item_name>: : 0 (set to -1 to ignore) price:

> Item names can be found [here](http://jd.bukkit.org/rb/apidocs/org/bukkit/Material.html), and must be lower case.

* `max_listings` is how many listings a player can have at one time (or per world if multi-world support is enabled.) `0` disables this limit.
* `creation_fee` can either be a flat fee (like `100`) or a percentage (like `0.05`, which is 5%) that is charged when a player creates a listing. Set to `0` to disable.
* `expire_time` is how many hours to wait before automatically cancelling a listing. `0` is never.
* `queue_trade_time` is how many minutes to wait before new listings will be made public. `0` is none.
* `queue_mail_time` is how many minutes to wait before mail is delivered. `0` is none.
* `allow_creative` if set to false, will block creating listings, sending mail, viewing mail, and viewing listings while in creative mode.

***

### Queue Settings

    queue:
      queue_mail_on_buy: true
      queue_on_cancel: true

* `queue_mail_on_buy` whether or not to use the queue when a player buys an item.
* `queue_on_cancel` whether or not to use the queue when a player cancels a listing.

***

### Blacklist Settings

    blacklist:
      custom_names: false
      item_name:
      - Transaction Log
      - Market History
      item_id:
        '0': 0
      enchant_id: 
      - 5
      lore:
      - 'Billy Bob's Sword'
      use_with_mail: false

* `custom_names` allows or disallows items with custom names from anvils.
* `item_name` custom item names to blacklist from being sold. This setting only applies to custom item names, like an item named with an anvil.
* `item_id` item IDs and damage values to blacklist. A damage value of `-1` will blacklist all damage values for that item. Wood's item ID is 5: `5: 0` will blacklist normal wood planks, `5: 1` will blacklist spruce planks, and `5: -1` will blacklist all wood types. [Find item IDs here.](http://www.minecraftinfo.com/IDList.htm)
* `enchant_id` Enchantment IDs to blacklist. [Find enchantment IDs here.](http://minecraft.gamepedia.com/Enchanting#Enchantments)
* `lore` blacklists items with those values in their lore.
* `use_with_mail` if set to true will check the blacklist when a player uses `/market send`

***

### Infinite Listings Settings

    infinite:
      seller: Server
      account: ''

* `seller` is the seller shown on infinite listings. *Warning:* if you change this value without using `/market reload` afterwards (like when your server is off) you will have to recreate your infinite listings.
* `account` is the economy user to send earnings from infinite listings to. Leave blank to disable.

***

### Misc Settings

    automatic_payments: false
    enable_history: true
    stall_radius: 0
    mailbox_radius: 0
    announce_new_listings: false
    enable_metrics: true
    notify_on_update: true

* `automatic_payments` if set to false will send a Transaction Log (a signed book) containing the money from a purchase to the seller's mailbox, and when collected, the earnings will be put into their economy account. If true, sellers' earnings will be put directly in their economy account.
* `enable_history` if set to true, enables transaction logging and the use of _/market history_ and _/market pricecheck_.
* `stall_radius` if set above 0, defines a radius in which the player can use _/market create_
* `mailbox_radius` if set above 0, defines a radius in which the player can use _/market send_
* `announce_new_listings` is whether or not to announce newly created listings in chat.
* `enable_metrics` enables Metrics logging. Learn more about Metrics [here.](https://forums.bukkit.org/threads/mcstats-plugin-metrics-r7-easy-advanced-plugin-statistics.77352/)
* `notify_on_update` toggles GlobalMarket update notifications.