Piglin Join WTO

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

1. Right-click adult Piglins with an empty hand: Opens the trading interface when right-clicking an adult Piglin with an empty hand
2. Gold ingot trading: Use gold ingots to purchase items from Piglin loot tables
3. 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

1. Download the mod file for your platform
2. Place the mod file in the server’s mods folder
3. Start the server
4. 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