Piglin Join WTO Mod (PJWTO)

A mod that allows Piglins to trade like villagers. This mod only needs to be installed on the server and will not affect the behavior of vanilla Piglins.

Features

Server-side only: Only needs to be installed on the server; no client installation required
Vanilla compatibility: Does not affect vanilla Piglin behavior of picking up gold ingots for trading or player interactions with held gold ingots
Intelligent trading system: Generates trades based on Piglin loot tables; rarer items require more gold ingots
Custom trades: Supports adding custom trade items via configuration file
Experience rewards: Trades grant experience points, with rarer items giving more experience

Usage

Right-click adult Piglins with an empty hand: Opens the trading interface when right-clicking an adult Piglin with an empty hand
Gold ingot trading: Use gold ingots to purchase items from Piglin loot tables
Vanilla behavior preserved: Right-clicking Piglins while holding gold ingots still triggers vanilla trading logic

Trading Rules

Loot table-based trades

Gold ingot requirements are calculated based on the item's weight in Piglin loot tables
Items with lower weights require more gold ingots
Trades are sorted by the number of gold ingots required, from least to most

Gold ingot requirements by weight

Weight 1 (rarest): Requires 15 gold ingots
- Books, iron boots, fire resistance potions, splash potions of fire resistance
Weight 2 (rare): Requires 13 gold ingots
- Iron nuggets, ender pearls
Weight 4 (uncommon): Requires 9 gold ingots
- String, nether quartz
Weight 8 (common): Requires 1 gold ingot
- Obsidian, crying obsidian, fire charges, leather, soul sand, nether bricks, glowstone dust, gravel, blackstone

Custom Trades

The mod generates a piglin_trades.json file in the configuration directory, which you can edit to add custom trades.

Configuration file example

{
  "_comment": "Piglin trading configuration. Define custom trades here.",
  "custom_trades": [
    {
      "result_item": "minecraft:diamond",
      "result_count": 1,
      "cost_a_item": "minecraft:gold_ingot",
      "cost_a_count": 10,
      "cost_b_item": "",
      "cost_b_count": 0,
      "max_uses": 5,
      "experience": 10
    },
    {
      "result_item": "minecraft:enchanted_golden_apple",
      "result_count": 1,
      "cost_a_item": "minecraft:gold_ingot",
      "cost_a_count": 32,
      "cost_b_item": "minecraft:apple",
      "cost_b_count": 1,
      "max_uses": 1,
      "experience": 50
    }
  ]
}

Configuration parameter explanations

result_item: The ID of the resulting item from the trade
result_count: The quantity of the resulting item
cost_a_item: The ID of required trade item A
cost_a_count: The quantity of required trade item A
cost_b_item: The ID of required trade item B (can be empty)
cost_b_count: The quantity of required trade item B
max_uses: Maximum number of uses
experience: Experience points gained from the trade

Supported Platforms

Minecraft Forge 1.21
Minecraft Fabric 1.21
Minecraft NeoForge 1.21

Installation

Download the mod file for your platform
Place the mod file in the server's mods folder
Start the server
The configuration file will be automatically generated in the config folder

Notes

This mod only needs to be installed on the server; no client installation is required
Piglins must be adult and non-zombified to trade
Players must have an empty hand to trigger the trading interface
Vanilla Piglin behavior remains unchanged