Skip to content

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.

  1. Choose the profession, level, price and the item sold.
  2. Register the trade for your loader.
  3. Spawn a villager of that profession and level it up.
  4. Open its trade window to see the new offer.

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.

The example mod is examplemod in the package com.example.examplemod. Use your own mod id and package.

Uses:

  • TradeOfferHelper.registerVillagerOffers
  • MerchantOffer
  • ItemStack

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.registerVillagerOffers
  • MerchantOffer
  • ItemCost

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.getTrades
  • MerchantOffer
  • ItemCost

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();

Uses:

  • VillagerTradesEvent.getTrades
  • MerchantOffer

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();

Uses:

  • VillagerTradesEvent.getTrades
  • MerchantOffer
  • ItemCost

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();

Uses:

  • TradeOfferHelper.registerVillagerOffers
  • MerchantOffer
  • ItemCost

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();

Uses:

  • VillagerTrade
  • TradeCost
  • VillagerTradeTags
  • RegistrySetBuilder
  • GatherDataEvent.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);

Uses:

  • VillagerTrade
  • TradeCost
  • VillagerTradeTags
  • FabricDynamicRegistryProvider
  • FabricTagsProvider
  • DataGeneratorEntrypoint.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 } }

Uses:

  • VillagerTrade
  • TradeCost
  • VillagerTradeTags
  • RegistrySetBuilder
  • GatherDataEvent.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);

Uses:

  • VillagerTrade.builder
  • TradeCost
  • VillagerTradeTags
  • RegistrySetBuilder
  • PackGenerator.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);

Uses:

  • VillagerTrade
  • TradeCost
  • VillagerTradeTags
  • FabricDynamicRegistryProvider
  • FabricTagsProvider
  • DataGeneratorEntrypoint.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 } }

Uses:

  • VillagerTradesEvent
  • VillagerTrades.ItemListing
  • MerchantOffer

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();

Uses:

  • VillagerTradesEvent
  • VillagerTrades.ItemListing
  • MerchantOffer

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();

Uses:

  • VillagerTradesEvent
  • VillagerTrades.ITrade
  • MerchantOffer

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();

Uses:

  • VillagerTradesEvent
  • VillagerTrades.ITrade
  • MerchantOffer

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();

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.