How to add a villager trade in a Minecraft mod
A villager’s trades come from its profession and level. Each trade is a MerchantOffer (a MerchantRecipe on 1.12.2): what it costs (an ItemCost from 1.20.5, an ItemStack before), what it gives, how many uses before it locks, the XP it grants and a price multiplier. Fabric API adds one with TradeOfferHelper.registerVillagerOffers(profession, level, …). Forge and NeoForge add it in VillagerTradesEvent, to the list for that level. From 26.1 trades are data instead (see the notes). Levels run from 1 (novice) to 5 (master).
Works on Minecraft 1.20.1 to 26.3 on NeoForge; Minecraft 1.16.5 to 26.3 on Fabric; Minecraft 1.16.5 to 1.20.1 on Forge; Minecraft 1.12.2 on Forge. Each example was compiled against its loader and version before it shipped in Linen.
- Choose the profession, level, price and the item sold.
- Register the trade for your loader.
- Spawn a villager of that profession and level it up.
- Open its trade window to see the new offer.
What you can change
Section titled “What you can change”The example uses these values. Change them in the code.
| Setting | In the example | What it does |
|---|---|---|
| profession | LIBRARIAN |
Which villagers sell it. |
| level | 1 |
Villager level, 1 to 5. |
| price | 5 |
Emeralds it costs. |
| sells | DIAMOND |
What it sells. |
For each loader and version
Section titled “For each loader and version”The example mod is examplemod in the package com.example.examplemod. Use your own mod id and package.
Fabric 1.16.5 to 1.20.4
Section titled “Fabric 1.16.5 to 1.20.4”Uses:
TradeOfferHelper.registerVillagerOffersMerchantOfferItemStack
Before 1.20.5 a trade’s price is a plain ItemStack; ItemCost came with 1.20.5.
src/main/java/com/example/examplemod/event/EmeraldDealTrades.java
package com.example.examplemod.event;
import net.fabricmc.fabric.api.object.builder.v1.trade.TradeOfferHelper;import net.minecraft.world.entity.npc.VillagerProfession;import net.minecraft.world.item.Items;import net.minecraft.world.item.ItemStack;import net.minecraft.world.item.trading.MerchantOffer;
// A LIBRARIAN villager of level 1 sells DIAMOND for 5 emeralds (Fabric API: TradeOfferHelper).public final class EmeraldDealTrades { private EmeraldDealTrades() { }
// Called from the mod's onInitialize. public static void register() { TradeOfferHelper.registerVillagerOffers(VillagerProfession.LIBRARIAN, 1, factories -> factories.add((trader, random) -> new MerchantOffer(new ItemStack(Items.EMERALD, 5), new ItemStack(Items.DIAMOND), 12, 5, 0.05F))); }}In your main mod class, inside onInitialize:
EmeraldDealTrades.register();Fabric 1.20.5 to 1.21.1, Fabric 1.21.2 to 1.21.10
Section titled “Fabric 1.20.5 to 1.21.1, Fabric 1.21.2 to 1.21.10”Uses:
TradeOfferHelper.registerVillagerOffersMerchantOfferItemCost
src/main/java/com/example/examplemod/event/EmeraldDealTrades.java
package com.example.examplemod.event;
import net.fabricmc.fabric.api.object.builder.v1.trade.TradeOfferHelper;import net.minecraft.world.entity.npc.VillagerProfession;import net.minecraft.world.item.Items;import net.minecraft.world.item.ItemStack;import net.minecraft.world.item.trading.ItemCost;import net.minecraft.world.item.trading.MerchantOffer;
// A LIBRARIAN villager of level 1 sells DIAMOND for 5 emeralds (Fabric API: TradeOfferHelper).public final class EmeraldDealTrades { private EmeraldDealTrades() { }
// Called from the mod's onInitialize. public static void register() { TradeOfferHelper.registerVillagerOffers(VillagerProfession.LIBRARIAN, 1, factories -> factories.add((trader, random) -> new MerchantOffer(new ItemCost(Items.EMERALD, 5), new ItemStack(Items.DIAMOND), 12, 5, 0.05F))); }}In your main mod class, inside onInitialize:
EmeraldDealTrades.register();NeoForge 1.20.5 to 1.21.1, NeoForge 1.21.2 to 1.21.10
Section titled “NeoForge 1.20.5 to 1.21.1, NeoForge 1.21.2 to 1.21.10”Uses:
VillagerTradesEvent.getTradesMerchantOfferItemCost
src/main/java/com/example/examplemod/event/EmeraldDealTrades.java
package com.example.examplemod.event;
import net.minecraft.world.entity.npc.VillagerProfession;import net.minecraft.world.item.ItemStack;import net.minecraft.world.item.Items;import net.minecraft.world.item.trading.ItemCost;import net.minecraft.world.item.trading.MerchantOffer;import net.neoforged.neoforge.common.NeoForge;import net.neoforged.neoforge.event.village.VillagerTradesEvent;
// A LIBRARIAN villager of level 1 sells DIAMOND for 5 emeralds (NeoForge: VillagerTradesEvent).public final class EmeraldDealTrades { private EmeraldDealTrades() { }
// Called from the mod's constructor. public static void register() { NeoForge.EVENT_BUS.addListener(EmeraldDealTrades::onTrades); }
private static void onTrades(VillagerTradesEvent event) { if (event.getType() == VillagerProfession.LIBRARIAN) { event.getTrades().get(1).add((trader, random) -> new MerchantOffer(new ItemCost(Items.EMERALD, 5), new ItemStack(Items.DIAMOND), 12, 5, 0.05F)); } }}In your main mod class, inside <init>:
EmeraldDealTrades.register();NeoForge 1.20.2 to 1.20.4
Section titled “NeoForge 1.20.2 to 1.20.4”Uses:
VillagerTradesEvent.getTradesMerchantOffer
src/main/java/com/example/examplemod/event/EmeraldDealTrades.java
package com.example.examplemod.event;
import net.minecraft.world.entity.npc.VillagerProfession;import net.minecraft.world.item.ItemStack;import net.minecraft.world.item.Items;import net.minecraft.world.item.trading.MerchantOffer;import net.neoforged.neoforge.common.NeoForge;import net.neoforged.neoforge.event.village.VillagerTradesEvent;
// A LIBRARIAN villager of level 1 sells DIAMOND for 5 emeralds (NeoForge: VillagerTradesEvent).public final class EmeraldDealTrades { private EmeraldDealTrades() { }
// Called from the mod's constructor. public static void register() { NeoForge.EVENT_BUS.addListener(EmeraldDealTrades::onTrades); }
private static void onTrades(VillagerTradesEvent event) { if (event.getType() == VillagerProfession.LIBRARIAN) { event.getTrades().get(1).add((trader, random) -> new MerchantOffer(new ItemStack(Items.EMERALD, 5), new ItemStack(Items.DIAMOND), 12, 5, 0.05F)); } }}In your main mod class, inside <init>:
EmeraldDealTrades.register();NeoForge 1.21.11
Section titled “NeoForge 1.21.11”Uses:
VillagerTradesEvent.getTradesMerchantOfferItemCost
src/main/java/com/example/examplemod/event/EmeraldDealTrades.java
package com.example.examplemod.event;
import net.minecraft.world.entity.npc.villager.VillagerProfession;import net.minecraft.world.item.ItemStack;import net.minecraft.world.item.Items;import net.minecraft.world.item.trading.ItemCost;import net.minecraft.world.item.trading.MerchantOffer;import net.neoforged.neoforge.common.NeoForge;import net.neoforged.neoforge.event.village.VillagerTradesEvent;
// A LIBRARIAN villager of level 1 sells DIAMOND for 5 emeralds (NeoForge: VillagerTradesEvent).public final class EmeraldDealTrades { private EmeraldDealTrades() { }
// Called from the mod's constructor. public static void register() { NeoForge.EVENT_BUS.addListener(EmeraldDealTrades::onTrades); }
private static void onTrades(VillagerTradesEvent event) { if (event.getType() == VillagerProfession.LIBRARIAN) { event.getTrades().get(1).add((level, trader, random) -> new MerchantOffer(new ItemCost(Items.EMERALD, 5), new ItemStack(Items.DIAMOND), 12, 5, 0.05F)); } }}In your main mod class, inside <init>:
EmeraldDealTrades.register();Fabric 1.21.11
Section titled “Fabric 1.21.11”Uses:
TradeOfferHelper.registerVillagerOffersMerchantOfferItemCost
src/main/java/com/example/examplemod/event/EmeraldDealTrades.java
package com.example.examplemod.event;
import net.fabricmc.fabric.api.object.builder.v1.trade.TradeOfferHelper;import net.minecraft.world.entity.npc.villager.VillagerProfession;import net.minecraft.world.item.Items;import net.minecraft.world.item.ItemStack;import net.minecraft.world.item.trading.ItemCost;import net.minecraft.world.item.trading.MerchantOffer;
// A LIBRARIAN villager of level 1 sells DIAMOND for 5 emeralds (Fabric API: TradeOfferHelper).public final class EmeraldDealTrades { private EmeraldDealTrades() { }
// Called from the mod's onInitialize. public static void register() { TradeOfferHelper.registerVillagerOffers(VillagerProfession.LIBRARIAN, 1, factories -> factories.add((level, trader, random) -> new MerchantOffer(new ItemCost(Items.EMERALD, 5), new ItemStack(Items.DIAMOND), 12, 5, 0.05F))); }}In your main mod class, inside onInitialize:
EmeraldDealTrades.register();NeoForge 26.1 to 26.1.2
Section titled “NeoForge 26.1 to 26.1.2”Uses:
VillagerTradeTradeCostVillagerTradeTagsRegistrySetBuilderGatherDataEvent.Server.createDatapackRegistryObjects
Since 26.1 villager trades are data (a villager_trade registry entry added to a tag such as librarian/level_1), and VillagerTradesEvent is gone. Run ./gradlew runData to write the trade and its tag. A villager picks some of the trades in its level’s tag, so the new one is offered by some of them, not every one.
src/main/java/com/example/examplemod/datagen/EmeraldDealTrades.java
package com.example.examplemod.datagen;
import com.example.examplemod.ExampleMod;import java.util.List;import java.util.Optional;import java.util.concurrent.CompletableFuture;import net.minecraft.core.HolderLookup;import net.minecraft.core.RegistrySetBuilder;import net.minecraft.core.registries.Registries;import net.minecraft.data.PackOutput;import net.minecraft.data.tags.KeyTagProvider;import net.minecraft.resources.Identifier;import net.minecraft.resources.ResourceKey;import net.minecraft.tags.VillagerTradeTags;import net.minecraft.world.item.ItemStackTemplate;import net.minecraft.world.item.Items;import net.minecraft.world.item.trading.TradeCost;import net.minecraft.world.item.trading.VillagerTrade;import net.neoforged.neoforge.data.event.GatherDataEvent;
// A LIBRARIAN villager of level 1 can sell DIAMOND for 5 emeralds. Since 26.1 trades are data, so this writes them when ./gradlew runData runs.public final class EmeraldDealTrades { private static final ResourceKey<VillagerTrade> TRADE = ResourceKey.create(Registries.VILLAGER_TRADE, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "emerald_deal"));
private EmeraldDealTrades() { }
// Listens on the mod event bus (the mod's constructor) when datagen runs. public static void gather(GatherDataEvent.Server event) { // The trade itself: price, item, max uses, XP and price multiplier. event.createDatapackRegistryObjects(new RegistrySetBuilder().add(Registries.VILLAGER_TRADE, context -> context.register(TRADE, new VillagerTrade(new TradeCost(Items.EMERALD, 5), new ItemStackTemplate(Items.DIAMOND), 12, 5, 0.05F, Optional.empty(), List.of())))); // The tag that makes it one of the trades villagers of that profession and level can get. event.createProvider(TradeTags::new); }
private static final class TradeTags extends KeyTagProvider<VillagerTrade> { TradeTags(PackOutput output, CompletableFuture<HolderLookup.Provider> registries) { super(output, Registries.VILLAGER_TRADE, registries); }
@Override protected void addTags(HolderLookup.Provider registries) { tag(VillagerTradeTags.LIBRARIAN_LEVEL_1).add(TRADE); } }}In your main mod class, inside <init>:
modEventBus.addListener(EmeraldDealTrades::gather);Fabric 26.1 to 26.2
Section titled “Fabric 26.1 to 26.2”Uses:
VillagerTradeTradeCostVillagerTradeTagsFabricDynamicRegistryProviderFabricTagsProviderDataGeneratorEntrypoint.buildRegistry
Since 26.1 villager trades are data (a villager_trade registry entry added to a tag such as librarian/level_1), and Fabric API’s TradeOfferHelper is gone. Run ./gradlew runDatagen to write the trade and its tag. A villager picks some of the trades in its level’s tag, so the new one is offered by some of them, not every one.
src/main/java/com/example/examplemod/datagen/ExampleModDataGenerator.java
package com.example.examplemod.datagen;
import net.fabricmc.fabric.api.datagen.v1.DataGeneratorEntrypoint;import net.fabricmc.fabric.api.datagen.v1.FabricDataGenerator;import net.minecraft.core.RegistrySetBuilder;import net.minecraft.core.registries.Registries;
// Fabric API's datagen entrypoint ("fabric-datagen" in fabric.mod.json): ./gradlew runDatagen runs the providers added here.public class ExampleModDataGenerator implements DataGeneratorEntrypoint { @Override public void onInitializeDataGenerator(FabricDataGenerator generator) { FabricDataGenerator.Pack pack = generator.createPack(); }
// Data-driven registries (like villager trades) get their entries from a bootstrap here. @Override public void buildRegistry(RegistrySetBuilder registryBuilder) { }}src/main/java/com/example/examplemod/datagen/EmeraldDealTrades.java
package com.example.examplemod.datagen;
import com.example.examplemod.ExampleMod;import java.util.List;import java.util.Optional;import java.util.concurrent.CompletableFuture;import net.fabricmc.fabric.api.datagen.v1.FabricPackOutput;import net.fabricmc.fabric.api.datagen.v1.provider.FabricDynamicRegistryProvider;import net.fabricmc.fabric.api.datagen.v1.provider.FabricTagsProvider;import net.minecraft.core.HolderLookup;import net.minecraft.core.registries.Registries;import net.minecraft.data.worldgen.BootstrapContext;import net.minecraft.resources.ResourceKey;import net.minecraft.tags.VillagerTradeTags;import net.minecraft.world.item.ItemStackTemplate;import net.minecraft.world.item.Items;import net.minecraft.world.item.trading.TradeCost;import net.minecraft.world.item.trading.VillagerTrade;
// A LIBRARIAN villager of level 1 can sell DIAMOND for 5 emeralds. Since 26.1 trades are data, so this writes them when ./gradlew runDatagen runs.public final class EmeraldDealTrades { private static final ResourceKey<VillagerTrade> TRADE = ResourceKey.create(Registries.VILLAGER_TRADE, ExampleMod.id("emerald_deal"));
private EmeraldDealTrades() { }
// The trade itself: price, item, max uses, XP and price multiplier. Called from the datagen entrypoint's buildRegistry. public static void bootstrap(BootstrapContext<VillagerTrade> context) { context.register(TRADE, new VillagerTrade(new TradeCost(Items.EMERALD, 5), new ItemStackTemplate(Items.DIAMOND), 12, 5, 0.05F, Optional.empty(), List.of())); }
// Writes the trade's JSON file. public static final class Registry extends FabricDynamicRegistryProvider { public Registry(FabricPackOutput output, CompletableFuture<HolderLookup.Provider> registries) { super(output, registries); }
@Override protected void configure(HolderLookup.Provider registries, Entries entries) { entries.add(registries.lookupOrThrow(Registries.VILLAGER_TRADE), TRADE); }
@Override public String getName() { return "EmeraldDeal trade"; } }
// The tag that makes it one of the trades villagers of that profession and level can get. public static final class Tags extends FabricTagsProvider<VillagerTrade> { public Tags(FabricPackOutput output, CompletableFuture<HolderLookup.Provider> registries) { super(output, Registries.VILLAGER_TRADE, registries); }
@Override protected void addTags(HolderLookup.Provider registries) { builder(VillagerTradeTags.LIBRARIAN_LEVEL_1).add(TRADE); } }}In src/main/java/com/example/examplemod/datagen/ExampleModDataGenerator.java, inside onInitializeDataGenerator:
pack.addProvider(EmeraldDealTrades.Registry::new);In src/main/java/com/example/examplemod/datagen/ExampleModDataGenerator.java, inside onInitializeDataGenerator:
pack.addProvider(EmeraldDealTrades.Tags::new);In src/main/java/com/example/examplemod/datagen/ExampleModDataGenerator.java, inside buildRegistry:
registryBuilder.add(Registries.VILLAGER_TRADE, EmeraldDealTrades::bootstrap);In src/main/resources/fabric.mod.json, add this to the list at /entrypoints/fabric-datagen:
"com.example.examplemod.datagen.ExampleModDataGenerator"Add this line to build.gradle:
fabricApi { configureDataGeneration() { client = true } }NeoForge 26.2
Section titled “NeoForge 26.2”Uses:
VillagerTradeTradeCostVillagerTradeTagsRegistrySetBuilderGatherDataEvent.Server.createDatapackRegistryObjects
Since 26.1 villager trades are data (a villager_trade registry entry added to a tag such as librarian/level_1), and VillagerTradesEvent is gone. Run ./gradlew runData to write the trade and its tag. A villager picks some of the trades in its level’s tag, so the new one is offered by some of them, not every one.
src/main/java/com/example/examplemod/datagen/EmeraldDealTrades.java
package com.example.examplemod.datagen;
import com.example.examplemod.ExampleMod;import java.util.List;import java.util.Optional;import java.util.concurrent.CompletableFuture;import net.minecraft.core.HolderLookup;import net.minecraft.core.RegistrySetBuilder;import net.minecraft.core.registries.Registries;import net.minecraft.data.PackOutput;import net.minecraft.data.tags.TagsProvider;import net.minecraft.resources.Identifier;import net.minecraft.resources.ResourceKey;import net.minecraft.tags.VillagerTradeTags;import net.minecraft.world.item.ItemStackTemplate;import net.minecraft.world.item.Items;import net.minecraft.world.item.trading.TradeCost;import net.minecraft.world.item.trading.VillagerTrade;import net.neoforged.neoforge.data.event.GatherDataEvent;
// A LIBRARIAN villager of level 1 can sell DIAMOND for 5 emeralds. Since 26.1 trades are data, so this writes them when ./gradlew runData runs.public final class EmeraldDealTrades { private static final ResourceKey<VillagerTrade> TRADE = ResourceKey.create(Registries.VILLAGER_TRADE, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "emerald_deal"));
private EmeraldDealTrades() { }
// Listens on the mod event bus (the mod's constructor) when datagen runs. public static void gather(GatherDataEvent.Server event) { // The trade itself: price, item, max uses, XP and price multiplier. event.createDatapackRegistryObjects(new RegistrySetBuilder().add(Registries.VILLAGER_TRADE, context -> context.register(TRADE, new VillagerTrade(new TradeCost(Items.EMERALD, 5), new ItemStackTemplate(Items.DIAMOND), 12, 5, 0.05F, Optional.empty(), List.of())))); // The tag that makes it one of the trades villagers of that profession and level can get. event.createProvider(TradeTags::new); }
private static final class TradeTags extends TagsProvider<VillagerTrade> { TradeTags(PackOutput output, CompletableFuture<HolderLookup.Provider> registries) { super(output, Registries.VILLAGER_TRADE, registries); }
@Override protected void addTags(HolderLookup.Provider registries) { tag(VillagerTradeTags.LIBRARIAN_LEVEL_1).add(TRADE); } }}In your main mod class, inside <init>:
modEventBus.addListener(EmeraldDealTrades::gather);NeoForge 26.3
Section titled “NeoForge 26.3”Uses:
VillagerTrade.builderTradeCostVillagerTradeTagsRegistrySetBuilderPackGenerator.createWorldRegistryObjects
Since 26.1 villager trades are data (a villager_trade registry entry added to a tag such as librarian/level_1), and VillagerTradesEvent is gone. Run ./gradlew runData to write the trade and its tag. A villager picks some of the trades in its level’s tag, so the new one is offered by some of them, not every one.
src/main/java/com/example/examplemod/datagen/EmeraldDealTrades.java
package com.example.examplemod.datagen;
import com.example.examplemod.ExampleMod;import java.util.concurrent.CompletableFuture;import net.minecraft.core.HolderLookup;import net.minecraft.core.RegistrySetBuilder;import net.minecraft.core.registries.Registries;import net.minecraft.data.PackOutput;import net.minecraft.data.tags.TagsProvider;import net.minecraft.resources.Identifier;import net.minecraft.resources.ResourceKey;import net.minecraft.tags.VillagerTradeTags;import net.minecraft.world.item.ItemStackTemplate;import net.minecraft.world.item.Items;import net.minecraft.world.item.trading.TradeCost;import net.minecraft.world.item.trading.VillagerTrade;import net.neoforged.neoforge.data.event.GatherDataEvent;
// A LIBRARIAN villager of level 1 can sell DIAMOND for 5 emeralds. Since 26.1 trades are data, so this writes them when ./gradlew runData runs.public final class EmeraldDealTrades { private static final ResourceKey<VillagerTrade> TRADE = ResourceKey.create(Registries.VILLAGER_TRADE, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "emerald_deal"));
private EmeraldDealTrades() { }
// Listens on the mod event bus (the mod's constructor) when datagen runs. public static void gather(GatherDataEvent.Server event) { // The trade itself: price, item, max uses, XP and price multiplier. event.getDefaultPackGenerator().createWorldRegistryObjects(new RegistrySetBuilder().add(Registries.VILLAGER_TRADE, context -> context.register(TRADE, VillagerTrade.builder(new TradeCost(Items.EMERALD, 5), new ItemStackTemplate(Items.DIAMOND), 12, 5, 0.05F).build()))); // The tag that makes it one of the trades villagers of that profession and level can get. event.createProvider(TradeTags::new); }
private static final class TradeTags extends TagsProvider<VillagerTrade> { TradeTags(PackOutput output, CompletableFuture<HolderLookup.Provider> registries) { super(output, Registries.VILLAGER_TRADE, registries); }
@Override protected void addTags(HolderLookup.Provider registries) { tag(VillagerTradeTags.LIBRARIAN_LEVEL_1).add(TRADE); } }}In your main mod class, inside <init>:
modEventBus.addListener(EmeraldDealTrades::gather);Fabric 26.3
Section titled “Fabric 26.3”Uses:
VillagerTradeTradeCostVillagerTradeTagsFabricDynamicRegistryProviderFabricTagsProviderDataGeneratorEntrypoint.buildRegistry
Since 26.1 villager trades are data (a villager_trade registry entry added to a tag such as librarian/level_1), and Fabric API’s TradeOfferHelper is gone. Run ./gradlew runDatagen to write the trade and its tag. A villager picks some of the trades in its level’s tag, so the new one is offered by some of them, not every one.
src/main/java/com/example/examplemod/datagen/ExampleModDataGenerator.java
package com.example.examplemod.datagen;
import net.fabricmc.fabric.api.datagen.v1.DataGeneratorEntrypoint;import net.fabricmc.fabric.api.datagen.v1.FabricDataGenerator;import net.minecraft.core.RegistrySetBuilder;import net.minecraft.core.registries.Registries;
// Fabric API's datagen entrypoint ("fabric-datagen" in fabric.mod.json): ./gradlew runDatagen runs the providers added here.public class ExampleModDataGenerator implements DataGeneratorEntrypoint { @Override public void onInitializeDataGenerator(FabricDataGenerator generator) { FabricDataGenerator.Pack pack = generator.createPack(); }
// Data-driven registries (like villager trades) get their entries from a bootstrap here. @Override public void buildRegistry(RegistrySetBuilder registryBuilder) { }}src/main/java/com/example/examplemod/datagen/EmeraldDealTrades.java
package com.example.examplemod.datagen;
import com.example.examplemod.ExampleMod;import java.util.concurrent.CompletableFuture;import net.fabricmc.fabric.api.datagen.v1.FabricPackOutput;import net.fabricmc.fabric.api.datagen.v1.provider.FabricDynamicRegistryProvider;import net.fabricmc.fabric.api.datagen.v1.provider.FabricTagsProvider;import net.minecraft.core.HolderLookup;import net.minecraft.core.registries.Registries;import net.minecraft.data.worldgen.BootstrapContext;import net.minecraft.resources.ResourceKey;import net.minecraft.tags.VillagerTradeTags;import net.minecraft.world.item.ItemStackTemplate;import net.minecraft.world.item.Items;import net.minecraft.world.item.trading.TradeCost;import net.minecraft.world.item.trading.VillagerTrade;
// A LIBRARIAN villager of level 1 can sell DIAMOND for 5 emeralds. Since 26.1 trades are data, so this writes them when ./gradlew runDatagen runs.public final class EmeraldDealTrades { private static final ResourceKey<VillagerTrade> TRADE = ResourceKey.create(Registries.VILLAGER_TRADE, ExampleMod.id("emerald_deal"));
private EmeraldDealTrades() { }
// The trade itself: price, item, max uses, XP and price multiplier. Called from the datagen entrypoint's buildRegistry. public static void bootstrap(BootstrapContext<VillagerTrade> context) { context.register(TRADE, VillagerTrade.builder(new TradeCost(Items.EMERALD, 5), new ItemStackTemplate(Items.DIAMOND), 12, 5, 0.05F).build()); }
// Writes the trade's JSON file. public static final class Registry extends FabricDynamicRegistryProvider { public Registry(FabricPackOutput output, CompletableFuture<HolderLookup.Provider> registries) { super(output, registries); }
@Override protected void configure(HolderLookup.Provider registries, Entries entries) { entries.add(registries.lookupOrThrow(Registries.VILLAGER_TRADE), TRADE); }
@Override public String getName() { return "EmeraldDeal trade"; } }
// The tag that makes it one of the trades villagers of that profession and level can get. public static final class Tags extends FabricTagsProvider<VillagerTrade> { public Tags(FabricPackOutput output, CompletableFuture<HolderLookup.Provider> registries) { super(output, Registries.VILLAGER_TRADE, registries); }
@Override protected void addTags(HolderLookup.Provider registries) { builder(VillagerTradeTags.LIBRARIAN_LEVEL_1).add(TRADE); } }}In src/main/java/com/example/examplemod/datagen/ExampleModDataGenerator.java, inside onInitializeDataGenerator:
pack.addProvider(EmeraldDealTrades.Registry::new);In src/main/java/com/example/examplemod/datagen/ExampleModDataGenerator.java, inside onInitializeDataGenerator:
pack.addProvider(EmeraldDealTrades.Tags::new);In src/main/java/com/example/examplemod/datagen/ExampleModDataGenerator.java, inside buildRegistry:
registryBuilder.add(Registries.VILLAGER_TRADE, EmeraldDealTrades::bootstrap);In src/main/resources/fabric.mod.json, add this to the list at /entrypoints/fabric-datagen:
"com.example.examplemod.datagen.ExampleModDataGenerator"Add this line to build.gradle:
fabricApi { configureDataGeneration() { client = true } }Forge 1.17.1 to 1.20.1
Section titled “Forge 1.17.1 to 1.20.1”Uses:
VillagerTradesEventVillagerTrades.ItemListingMerchantOffer
src/main/java/com/example/examplemod/event/EmeraldDealTrades.java
package com.example.examplemod.event;
import net.minecraft.world.entity.npc.VillagerProfession;import net.minecraft.world.item.ItemStack;import net.minecraft.world.item.Items;import net.minecraft.world.item.trading.MerchantOffer;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.village.VillagerTradesEvent;
// A LIBRARIAN villager of level 1 sells DIAMOND for 5 emeralds (Forge: VillagerTradesEvent).public final class EmeraldDealTrades { private EmeraldDealTrades() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(EmeraldDealTrades::onTrades); }
private static void onTrades(VillagerTradesEvent event) { if (event.getType() == VillagerProfession.LIBRARIAN) { event.getTrades().get(1).add((trader, random) -> new MerchantOffer(new ItemStack(Items.EMERALD, 5), new ItemStack(Items.DIAMOND), 12, 5, 0.05F)); } }}In your main mod class, inside <init>:
EmeraldDealTrades.register();NeoForge 1.20.1
Section titled “NeoForge 1.20.1”Uses:
VillagerTradesEventVillagerTrades.ItemListingMerchantOffer
src/main/java/com/example/examplemod/event/EmeraldDealTrades.java
package com.example.examplemod.event;
import net.minecraft.world.entity.npc.VillagerProfession;import net.minecraft.world.item.ItemStack;import net.minecraft.world.item.Items;import net.minecraft.world.item.trading.MerchantOffer;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.village.VillagerTradesEvent;
// A LIBRARIAN villager of level 1 sells DIAMOND for 5 emeralds (NeoForge: VillagerTradesEvent).public final class EmeraldDealTrades { private EmeraldDealTrades() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(EmeraldDealTrades::onTrades); }
private static void onTrades(VillagerTradesEvent event) { if (event.getType() == VillagerProfession.LIBRARIAN) { event.getTrades().get(1).add((trader, random) -> new MerchantOffer(new ItemStack(Items.EMERALD, 5), new ItemStack(Items.DIAMOND), 12, 5, 0.05F)); } }}In your main mod class, inside <init>:
EmeraldDealTrades.register();Forge 1.16.5
Section titled “Forge 1.16.5”Uses:
VillagerTradesEventVillagerTrades.ITradeMerchantOffer
src/main/java/com/example/examplemod/event/EmeraldDealTrades.java
package com.example.examplemod.event;
import net.minecraft.entity.merchant.villager.VillagerProfession;import net.minecraft.item.ItemStack;import net.minecraft.item.Items;import net.minecraft.item.MerchantOffer;import net.minecraftforge.common.MinecraftForge;import net.minecraftforge.event.village.VillagerTradesEvent;
// A LIBRARIAN villager of level 1 sells DIAMOND for 5 emeralds (Forge: VillagerTradesEvent).public final class EmeraldDealTrades { private EmeraldDealTrades() { }
// Called from the mod's constructor. public static void register() { MinecraftForge.EVENT_BUS.addListener(EmeraldDealTrades::onTrades); }
private static void onTrades(VillagerTradesEvent event) { if (event.getType() == VillagerProfession.LIBRARIAN) { event.getTrades().get(1).add((trader, random) -> new MerchantOffer(new ItemStack(Items.EMERALD, 5), new ItemStack(Items.DIAMOND), 12, 5, 0.05F)); } }}In your main mod class, inside <init>:
EmeraldDealTrades.register();Forge 1.12.2
Section titled “Forge 1.12.2”Uses:
VillagerTradesEventVillagerTrades.ITradeMerchantOffer
In 1.12.2 a profession’s career gets a trade through VillagerRegistry.VillagerCareer#addTrade(level, trade list), and a trade is a MerchantRecipe.
src/main/java/com/example/examplemod/event/EmeraldDealTrades.java
package com.example.examplemod.event;
import net.minecraft.init.Items;import net.minecraft.item.ItemStack;import net.minecraft.util.ResourceLocation;import net.minecraft.village.MerchantRecipe;import net.minecraftforge.fml.common.registry.ForgeRegistries;import net.minecraftforge.fml.common.registry.VillagerRegistry;
// A LIBRARIAN villager of level 1 sells DIAMOND for 5 emeralds (Forge 1.12.2: a career gets a trade list, VillagerRegistry.VillagerCareer#addTrade).public final class EmeraldDealTrades { private EmeraldDealTrades() { }
// Called from init, when the vanilla professions are registered. public static void register() { VillagerRegistry.VillagerProfession profession = ForgeRegistries.VILLAGER_PROFESSIONS.getValue(new ResourceLocation(professionId("LIBRARIAN"))); profession.getCareer(0).addTrade(1, (merchant, recipes, random) -> recipes.add(new MerchantRecipe(new ItemStack(Items.EMERALD, 5), new ItemStack(Items.DIAMOND)))); }
// 1.12.2 has other profession names: a CLERIC is a priest, ARMORER and TOOLSMITH are smiths. private static String professionId(String name) { switch (name) { case "FARMER": return "minecraft:farmer"; case "CLERIC": return "minecraft:priest"; case "ARMORER": case "TOOLSMITH": return "minecraft:smith"; default: return "minecraft:librarian"; } }}In your main mod class, inside preInit:
EmeraldDealTrades.register();Sources
Section titled “Sources”- https://docs.fabricmc.net/1.21.1/develop/events
- https://docs.neoforged.net/docs/1.21.1/entities/villagertrades
- https://maven.fabricmc.net/docs/fabric-api-0.116.17+1.21.1/net/fabricmc/fabric/api/object/builder/v1/trade/TradeOfferHelper.html
Related how-tos
Section titled “Related how-tos”- Give a mob a new AI goal
- Ride a mob
- Give players items when they first join
- A mob that drops an item
- Change a mob’s health and speed
In Linen
Section titled “In Linen”Linen’s How-tos library has this page too, with the example for your own mod’s loader and Minecraft version. Hover a name in your code and Linen points to the how-tos that explain it. Both are free. Download Linen.