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:
1
'tradeName': # Trade name, this can be anything you want
2
tradeSettings:
3
chance: 5 # Chance of villager acquiring this trade
4
requiredVillagerLevel: 'none' # Required villager level, read more at https://trades.advancedplugins.net/trades/levels
5
requiredProfession: # Required villager profession, read more at https://trades.advancedplugins.net/trades/professions
6
- 'none' # If set to none, required profession is disabled
7
requiredBiome: # Required villager's biome for this trade, read more at https://trades.advancedplugins.net/trades/biomes
8
- 'none' # If set to none, required profession is disabled
9
maxTradeUses: 'none' # This trade's limit per villager. Read more at https://trades.advancedplugins.net/trades/limits
10
tradeIngredients: # Items required for a trade, read more at https://trades.advancedplugins.net/configuration/items
11
# MAXIMUM OF 2 INGREDIENTS PER TRADE!
12
'1':
13
type: EMERALD
14
amount: 15
15
'2':
16
type: DIAMOND_SWORD
17
amount: 1
18
tradeResult: # Item which villager will offer in exchange of trade ingredients
19
villager:
20
experience: 5 # Experience gained by villager with this trade, read more at https://trades.advancedplugins.net/trades/levels
21
item: # Item given by villager to player at trade, read more at https://trades.advancedplugins.net/configuration/items
22
type: 'DIAMOND_SWORD'
23
amount: 1
24
name: '&cCustom Sword'
25
lore:
26
- '&dExclusive from &dVillagers'
27
enchantments:
28
- 'Sharpness:5'
29
- 'Unbreaking:2'
Copied!

#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:

#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.
Follow this guide on how to configure required items: https://trades.advancedplugins.net/configuration/items

#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.
experience - apply this experience to level up the villager, read more at: https://trades.advancedplugins.net/trades/levels

Configuration for awarding items:

Edit the item part in tradeResult block. You need to follow this guide on how to edit this item: https://trades.advancedplugins.net/configuration/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.
The actual commands can be configured following this guide: https://trades.advancedplugins.net/configuration/commands
Last modified 2mo ago