# PiglinTrades<\/p>\n
A lightweight Spigot\/Paper 1.21+ plugin that lets both **special Piglins** and (optionally) **regular Piglins** trade via fully configurable, weighted reward pools. Players \u201coffer\u201d an item, the Piglin admires it for a short cooldown (shows it in **off-hand** so weapons aren\u2019t lost), then drops a reward based on your config. Supports item rewards (incl. potions & enchanted books) and console **command** rewards \u2014 with optional PlaceholderAPI placeholders.<\/p>\n
—<\/p>\n
## Highlights
\n– **Special Piglins**: Invulnerable, don\u2019t despawn, show the offered item while \u201cthinking,\u201d then pay out.
\n– **Regular Piglins (toggle)**: Keep **vanilla bartering** or switch them to **PiglinTrades** via config.
\n– **Off-hand admire**: Offered item appears in off-hand so Piglins keep their main-hand weapon.
\n– **Item-keyed pools**: Each pool is keyed by the **MATERIAL** the player offers (e.g., `GOLD_INGOT`).
\n– **Weighted rewards**: Per-entry `weight` controls odds; amounts can be fixed or ranges.
\n– **Reward types**:
\n – **Item** (supports enchants; potions via base `PotionType`; tipped arrows)
\n – **Enchanted books** (stored enchants)
\n – **Command** (runs from console; supports `{player}` and PlaceholderAPI)
\n– **Admin GUI & tools**: Add\/edit pools and rewards in-game; simulator to test odds.<\/p>\n
—<\/p>\n
## Requirements
\n– **Server**: Spigot\/Paper **1.21+**
\n– **Java**: 21+
\n– **Optional**: PlaceholderAPI (for placeholders in command rewards)<\/p>\n
—<\/p>\n
## Installation
\n1. Drop `PiglinTrades.jar` into `\/plugins`.
\n2. (Optional) Install **PlaceholderAPI** if you want placeholders in command rewards.
\n3. Restart to generate `config.yml` and `rewards.yml`.
\n4. Customize settings, then run `\/pt reload`.<\/p>\n
—<\/p>\n
## Quick Start
\n1. `\/pt spawn` to place a **Special Piglin**.
\n2. In `rewards.yml`, create a pool keyed by the item players will offer (e.g., `GOLD_INGOT`).
\n3. Offer the item by **right-clicking** the Piglin or **dropping** it near them (consumes 1).
\n4. After the **cooldown**, a reward from the matching pool appears.<\/p>\n
> Want **regular Piglins** to use the plugin too? See the config toggle below.<\/p>\n
—<\/p>\n
## Configuration<\/p>\n
### `config.yml`
\n– **`cooldown-seconds`** \u2014 Seconds a Piglin \u201cadmires\u201d the item before payout (default: `3`).
\n– **`allow-vanilla-piglin-barter`** \u2014 If `true`, **regular** Piglins keep vanilla bartering. Special Piglins always use PiglinTrades.
\n– **`regular-piglins-use-plugin-trades`** \u2014 If `true`, **regular** Piglins also trade via PiglinTrades.<\/p>\n
These two booleans are **mutually exclusive**. If both are `true`, the plugin logs a **warning** and **disables vanilla bartering**, making regular Piglins use PiglinTrades.<\/p>\n
Example:
\n~~~yaml
\ncooldown-seconds: 3
\nallow-vanilla-piglin-barter: false
\nregular-piglins-use-plugin-trades: false
\n~~~<\/p>\n
### `rewards.yml` (concept)
\n– **Pools** are keyed by **MATERIAL names** (e.g., `GOLD_INGOT`).
\n– Each pool has entries with:
\n – `type`: `item` | `enchanted_book` | `command`
\n – `weight`: higher = more likely
\n – For **items**: `material`, `amount` (number or `min-max`), optional `enchants`, optional `potion`
\n – For **enchanted books**: `stored_enchants`, `amount`
\n – For **commands**: `command` (console), supports `{player}` and PlaceholderAPI<\/p>\n
> Tip: `\/pt simulate —<\/p>\n ## Commands & Permissions Subcommands: —<\/p>\n ## How players use it —<\/p>\n ## Notes —<\/p>\n ## Troubleshooting Spawn special Piglins or optionally regular ones that trade on your rules. Offer items to trigger configurable, weighted reward pools that drop loot or run console commands; Piglins admire items in their off-hand, and you get an in-game admin GUI plus a si<\/p>\n","protected":false},"featured_media":121332,"template":"","meta":{"_minecraft_slug":"piglintrades","_minecraft_project_id":"Ouottd0o","_minecraft_author":"CrownForge","_minecraft_license":"Apache-2.0","_minecraft_downloads":98,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"piglintrades.zip","_minecraft_size_bytes":186232,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:44:10.544840Z","_minecraft_date_created":"2025-09-05T23:31:02.169836Z","_minecraft_date_modified":"2025-09-07T11:09:44.132035Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/piglintrades","_minecraft_icon_attachment_id":121332,"_minecraft_imported_at":"2026-06-07T03:14:43+00:00","_minecraft_import_hash":"e15172e61b6da6151a9c11b207b7e2ea","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,137,127,129,92],"mod_loader":[132,134],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-121331","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-mobs","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n– **Base**: `\/piglintrades` (alias `\/pt`)
\n– **Perm**: `piglintrades.admin` (default: OP)<\/p>\n
\n– `\/pt spawn` \u2014 Spawn a Special Piglin.
\n– `\/pt reload` \u2014 Reload configs.
\n– `\/pt simulate
\n– `\/pt kill
\n– `\/pt gui` \u2014 Open the admin GUI.<\/p>\n
\n– **Special Piglins**: Right-click or drop a configured item; wait the cooldown; collect reward.
\n– **Regular Piglins**:
\n – If `allow-vanilla-piglin-barter: true` \u2192 they behave **vanilla**.
\n – If `regular-piglins-use-plugin-trades: true` \u2192 they use the **same** PiglinTrades flow as specials.<\/p>\n
\n– Offered items show in the Piglin\u2019s **off-hand** while admiring (main-hand gear stays intact).
\n– If a pool has no valid entries or only non-positive weights, it won\u2019t select a reward.
\n– Validate MATERIAL names and enchant keys against Spigot enums.<\/p>\n
\n– **Regular Piglin still barters vanilla** \u2192 Set `allow-vanilla-piglin-barter: false` and `regular-piglins-use-plugin-trades: true`, then `\/pt reload`. Check console for the mutual-exclusivity warning if both were `true`.
\n– **\u201cUnknown pool\u201d** in `\/pt simulate` \u2192 Verify the exact MATERIAL key.
\n– **No rewards dropping** \u2192 Check entry `type`, weights, and fields.
\n– **Placeholders not applied** \u2192 Install PlaceholderAPI and required expansions.<\/p>\n","protected":false},"excerpt":{"rendered":"