MerchantGuild Plugin

MerchantGuild is a Minecraft plugin that allows players to access a special shop where they can sell items they own. The shop refreshes periodically with random items for trading.

!main menu !menu select number item

Features

• Allows players to sell items from their inventory for in-game currency.
• The shop refreshes automatically every set interval (default: 2 hours).
• Configurable maximum number of items per refresh.
• Option to allow or disallow duplicate items in the shop.
• Supports multiple worlds where the shop is available.
• Multi-language support (currently available: English, Vietnamese).
• Admin commands to reload configuration and manually refresh the shop.

Command

Command	Description	Permission
merchant	open merchant guild	merchant.use
merchant help	help	merchant.use
merchant refresh	refresh the shop	merchant.admin
merchant reload	reload plugin	merchant.admin

Configuration (config.yml)

language: en

shop:
  refresh_interval: 120  # Refresh time (in minutes, 120 minutes = 2 hours)
  max_items: 14  # Maximum number of items per refresh (MAX 14)
  duplicates: False # Allow duplicate items or not
  allowed-worlds:
    - world
    - world_nether
    - world_the_end

items: ALL_SWORD: amount: 1 price: 2 enchants: SHARPNESS: 3 UNBREAKING: 2 BOOK: amount: 1-16 price: 0.2 GOLDEN_APPLE: amount: 1-8 price: 2

## Requirements
- **Vault** (required dependency)
- **An Economy plugin** (required) — Vault is only an API/broker layer and does not provide economy on its own. You must install a plugin that registers an Economy provider through Vault. Recommended options:
  - EssentialsX (free, most popular)
  - CMI (paid, feature-rich)
  - TheNewEconomy, XConomy, etc.
- Proper permissions to use the plugin commands

> Note: Installing Vault alone is **not** enough. Without an economy provider, MerchantGuild will be disabled with the error: `Disabled due to no Vault dependency found!`

## Installation
1. Download the **MerchantGuild.jar** file.
2. Place it in the `plugins/` folder of your Minecraft server.
3. Restart the server.
4. Edit `config.yml` if necessary and use `/merchant reload` to apply changes.

## Feedback & Support
If you encounter any issues or want to contribute, open an issue on GitHub or join the support community.