AdvancedTrades
HomepagePurchase AdvancedTradesJoin Discord
  • Home
  • General Information
    • Commands & Permissions
  • Trades
    • How to create Custom Trades
    • Levels
    • Professions
    • Biomes
    • Limits
  • Configuration
    • Items
    • Commands
Powered by GitBook
On this page
  • #1. Use template to start off your own trade
  • #2. Trade Settings Configuration
  • #3. Trade Ingredients Configuration
  • #4. Trade Result Configuration

Was this helpful?

  1. Trades

How to create Custom Trades

Our guide on how to create custom trades on your server.

#1. Use template to start off your own trade

Trades.yml file (located in your server folder -> plugins -> AdvancedTrades folder) has 2 trades by default. You can add your own trade by pasting this example to your file:

  'tradeName': # Trade name, this can be anything you want
    tradeSettings:
      chance: 5 # Chance of villager acquiring this trade
      requiredVillagerLevel: 'none' # Required villager level, read more at https://trades.advancedplugins.net/trades/levels
      requiredProfession: # Required villager profession, read more at https://trades.advancedplugins.net/trades/professions
        - 'none' # If set to none, required profession is disabled
      requiredBiome: # Required villager's biome for this trade, read more at https://trades.advancedplugins.net/trades/biomes
        - 'none' # If set to none, required profession is disabled
      maxTradeUses: 'none' # This trade's limit per villager. Read more at https://trades.advancedplugins.net/trades/limits
    tradeIngredients: # Items required for a trade, read more at https://trades.advancedplugins.net/configuration/items
      # MAXIMUM OF 2 INGREDIENTS PER TRADE!
      '1':
        type: EMERALD
        amount: 15
      '2':
        type: DIAMOND_SWORD
        amount: 1
    tradeResult: # Item which villager will offer in exchange of trade ingredients
      villager:
        experience: 5 # Experience gained by villager with this trade, read more at https://trades.advancedplugins.net/trades/levels
      item: # Item given by villager to player at trade, read more at https://trades.advancedplugins.net/configuration/items
        type: 'DIAMOND_SWORD'
        amount: 1
        name: '&cCustom Sword'
        lore:
          - '&dExclusive from &dVillagers'
        enchantments:
          - 'Sharpness:5'
          - 'Unbreaking:2'

#2. Trade Settings Configuration

Firstly you can change your trade name. In the example above, it's changeable in 'tradeName' part. Change this tradeName to anything else, e.g. villagerTrade6.

Under trade settings, you can configure:

  • chance - change the chance of this trade appearing in villager trades

#3. Trade Ingredients Configuration

Under trade ingredients, you can configure items required for a trade. In vanilla minecraft, it's usually emeralds + another item which turns into traded item. E.g. emeralds and a book, which then can be traded for an enchanted book. You do not need to follow this format.

You are not required to have 2 items either. Maximum is 2, minimum is 1.

#4. Trade Result Configuration

Trade can result either in item being awarded upon a trade or a command. Alongside this, you can also give the villager experience, which may level the villager up.

Configuration for awarding items:

Configuration for commands:

With AdvancedTrades, you can trade custom commands instead of items. Though, the rewarded item will still be displayed just as a display only, won't be traded. You can use this item to explain the reward to user as they won't be able to see what command they are trading for.

PreviousCommands & PermissionsNextLevels

Last updated 3 years ago

Was this helpful?

requiredVillagerLevel - level required for trades to appear, read more at

requiredProfession - required profession, read more at

requiredBiome - required biome for villager to spawn in, for this trade to appear. Read more at

maxTradeUses - max uses for this trade on a villager, read more at

Follow this guide on how to configure required items:

experience - apply this experience to level up the villager, read more at:

Edit the item part in tradeResult block. You need to follow this guide on how to edit this item:

The actual commands can be configured following this guide:

https://trades.advancedplugins.net/trades/levels
https://trades.advancedplugins.net/trades/professions
https://trades.advancedplugins.net/trades/biomes
https://trades.advancedplugins.net/trades/limits
https://trades.advancedplugins.net/configuration/items
https://trades.advancedplugins.net/trades/levels
https://trades.advancedplugins.net/configuration/items
https://trades.advancedplugins.net/configuration/commands