# Dispenser Villager Trading<\/p>\n
Dispenser Villager Trading is a Paper plugin that allows dispensers to perform villager trades automatically.
\nWhen a dispenser faces a villager and contains the required ingredients for one of the villager\u2019s trades, it will automatically:<\/p>\n
– Select a valid trade (at random, preserving vanilla dispenser behavior),
\n– Pay the cost using items from its inventory,
\n– Drop the result behind the dispenser (or insert it into a chest located directly behind it),
\n– Update villager experience and trade usage as if a player traded manually.<\/p>\n
This plugin also adds a **villager-only pressure plate** that only villagers can activate.<\/p>\n
—<\/p>\n
## Features
\n– **Dispenser trading**: Dispensers can fulfill any available villager trade \u2014 including two-ingredient trades \u2014 using their own inventory. Villagers gain experience and trades lock\/unlock as normal.
\n– **Player Experience**: Players gain experience as if they traded manually when dispensers perform trades. Same as Furnace Experience.
\n– **Villager-only pressure plate**: A custom craftable pressure plate (stone pressure plate + emerald) that only villagers can activate.<\/p>\n
—
\n### Public API (Event System)
\nA dedicated **API module** exposes events for other plugins.<\/p>\n
The first event is:<\/p>\n
#### `DispenserVillagerTradeDepositEvent`<\/p>\n
This event fires whenever the plugin attempts to deposit a villager trade result into a chest.<\/p>\n
Available methods:<\/p>\n
“`java
\npublic Inventory getSource();
\npublic Inventory getDestination();<\/p>\n
public ItemStack getItem();
\npublic void setItem(ItemStack item);<\/p>\n
public boolean isCancelled();
\npublic void setCancelled(boolean cancel);<\/p>\n
public HandlerList getHandlers();
\npublic static HandlerList getHandlerList();
\n“`<\/p>\n
—<\/p>\n
## Requirements
\n– **Paper 1.21.10** (or any Paper build targeting the `1.21.10` API)
\n– **Java 21** runtime on the server<\/p>\n
—<\/p>\n
## Installation
\n1. Build the plugin JAR (see below) or download one from the releases page.
\n2. Place the JAR into your server\u2019s `plugins\/` directory.
\n3. Start or reload your Paper server.<\/p>\n
—<\/p>\n
## Building
\nThis project uses Gradle. Common tasks:
\nYou can build only the plugin JAR, copy it to a server, or run a local test server.
\n– `.\/gradlew build` \u2014 Builds the plugin JAR under `plugin\/build\/libs\/`.
\n– `.\/gradlew copyToServer` \u2014 Builds the JAR and copies it to the server directory specified by `SERVER_LOCATION` in `secrets.properties`.
\n—<\/p>\n
## Configuration
\nThe generated `config.yml` provides the following option:<\/p>\n
– **`allowVillagerDispenserInteractions`** (boolean):
\n If `false`, dispensers will *not* fire when a villager stands in front of them *unless* a matching trade exists.
\n Defaults to `false`.<\/p>\n
—<\/p>\n
## Usage Tips
\n– Place a dispenser facing a villager, load it with the required trade ingredients, and power it. The plugin selects a valid trade, consumes the payment, and outputs the result behind the dispenser.
\n– Craft the villager-only pressure plate (stone pressure plate + emerald) to allow villagers \u2014 and optionally players \u2014 to activate contraptions while preventing other mobs from triggering them.
\n– Place a chest directly behind the dispenser to automatically collect traded items.<\/p>\n
—<\/p>\n
## Notes
\nThe plugin is designed specifically for **Paper** and may not function correctly on other server types.<\/p>\n
It aims to preserve core vanilla behavior while adding helpful mechanics:<\/p>\n
– Trades are selected randomly, matching vanilla dispenser behavior.
\n– Villager experience and trade usage update normally.
\n– Result items are dispensed naturally, as if fired by a dispenser.
\n– Additional quality-of-life features:
\n – Traded items are dispensed *behind* the dispenser so villagers don\u2019t pick them up.
\n – Chests placed behind the dispenser collect trade outputs automatically.
\n – A villager-only pressure plate allows villager-driven redstone without mob interference.<\/p>\n
—<\/p>\n
## Future Plans
\n– Selecting a specific trade via redstone signal strength.
\n– Moving the villager-only pressure plate to a dedicated plugin. Or adding more pressure plate types.
\n– Add more events to the public API for deeper integration.
\n– Add barrels support for trade result collection.
\n– Add more configuration options to better mimic vanilla behavior.<\/p>\n
—<\/p>\n
## Feedback and Contributions
\nFeedback, issues, and pull requests are welcome!
\nVisit the GitHub repository: DispenserVillagerTrading<\/p>\n","protected":false},"excerpt":{"rendered":"
A Minecraft paper plugin to add the ability of Dispensers to trade with Villagers.<\/p>\n","protected":false},"featured_media":57552,"template":"","meta":{"_minecraft_slug":"dispenser-vilager-trading","_minecraft_project_id":"MdOeJEL0","_minecraft_author":"afekaoh","_minecraft_license":"MIT","_minecraft_downloads":54,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"dispenser-vilager-trading.zip","_minecraft_size_bytes":66606,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T20:57:53.592794Z","_minecraft_date_created":"2025-11-22T10:37:07.573223Z","_minecraft_date_modified":"2025-11-27T13:33:06.791732Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/dispenser-vilager-trading","_minecraft_icon_attachment_id":57552,"_minecraft_imported_at":"2026-06-03T04:04:52+00:00","_minecraft_import_hash":"c67830a2b51b6bf1bca0ebd13239803a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,88,89,126,127,91,123,92],"mod_loader":[132],"minecraft_version":[40],"class_list":["post-57551","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-equipment","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-21-10"],"yoast_head":"\n