{"id":53246,"date":"2026-06-03T02:11:53","date_gmt":"2026-06-02T23:11:53","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/"},"modified":"2026-06-03T02:11:53","modified_gmt":"2026-06-02T23:11:53","slug":"customtrades","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/","title":{"rendered":"customtrades"},"content":{"rendered":"

# CustomTrades<\/p>\n

A comprehensive Paper\/Folia 1.21.x plugin for custom trader NPCs with Nexo and PlayerPoints support.<\/p>\n

### Features<\/p>\n

– \u2705 Create custom trader NPCs (Villager, Wandering Trader, Zombie Villager)
\n– \u2705 User-friendly GUI for trade management
\n– \u2705 Support for vanilla items and Nexo custom items
\n– \u2705 PlayerPoints as alternative currency
\n– \u2705 Folia compatible
\n– \u2705 YAML-based configuration per trader
\n– \u2705 Persistent traders (survive server restarts)<\/p>\n

### Commands<\/p>\n

– \/ct create – Creates a new trader at your position
\n– \/ct edit – Opens the trade editor for the targeted trader
\n– \/ct remove – Removes a trader
\n– \/ct list – Lists all traders
\n– \/ct reload – Reloads all traders<\/p>\n

### Permissions<\/p>\n

– customtrades.use – Access to all commands (default: op)
\n– customtrades.create – Create traders (default: op)
\n– customtrades.edit – Edit traders (default: op)
\n– customtrades.remove – Remove traders (default: op)
\n– customtrades.list – List traders (default: op)<\/p>\n

## Setup<\/p>\n

### 1. Dependencies<\/p>\n

The plugin requires the following dependencies:
\n– **Paper\/Folia 1.21.x**
\n– **PlayerPoints 3.2.7+** (optional, for PlayerPoints trades)
\n– **Nexo 0.1.0+** (optional, for custom items)<\/p>\n

### 2. Installation<\/p>\n

1. Place the plugin in the `plugins` folder
\n2. Start the server
\n3. (Optional) Install PlayerPoints and\/or Nexo
\n4. Use \/ct create to create your first trader<\/p>\n

### Usage<\/p>\n

### Creating a trader<\/p>\n

\/ct create MyTrader villager<\/p>\n

Spawns a villager trader at your position.<\/p>\n

### Configuring trades<\/p>\n

1. Look at the trader
\n2. Execute \/ct edit
\n3. Click on “Add Trade”
\n4. Place items from your inventory into the slots or use the options
\n5. Set PlayerPoints cost (optional)
\n6. Save the trade<\/p>\n

### YAML Configuration<\/p>\n

Each trader is saved in `plugins\/customtraders\/traders\/.yml`:<\/p>\n

name: MyTrader
\nmobType: VILLAGER
\ndisplayName: “&6Trader”
\npersistent: true
\nlocation:
\n world: world
\n x: 100.5
\n y: 64.0
\n z: 200.5
\n yaw: 0.0
\n pitch: 0.0<\/p>\n

trades:
\n 0:
\n input1:
\n type: VANILLA
\n material: DIAMOND
\n amount: 10
\n output:
\n type: VANILLA
\n material: EMERALD
\n amount: 1
\n maxUses: -1
\n playerPointsCost: 0<\/p>\n

1:
\n input1:
\n type: NONE # No item – PlayerPoints only
\n output:
\n type: NEXO
\n nexoId: custom_sword
\n amount: 1
\n maxUses: 1
\n playerPointsCost: 1000<\/p>\n

### Item Types<\/p>\n

– VANILLA: Normal Minecraft items
\n type: VANILLA
\n material: DIAMOND_SWORD
\n amount: 1
\n displayName: “&bSpecial Sword”
\n lore:
\n – “&7A special sword”<\/p>\n

– NEXO: Custom items from Nexo
\n type: NEXO
\n nexoId: my_custom_item
\n amount: 1<\/p>\n

– NONE: No item (for PlayerPoints-only trades)
\n type: NONE<\/p>\n

### PlayerPoints Integration<\/p>\n

When PlayerPoints is installed:
\n– Set playerPointsCost to a value > 0
\n– The player needs the specified points for the trade
\n– Points are automatically deducted on successful trade
\n– You can set input1 to type: NONE for pure PlayerPoints trades<\/p>\n

### Folia Compatibility<\/p>\n

The plugin uses:
\n– Entity Scheduler for entity-related tasks
\n– Region Scheduler for region-related tasks
\n– Automatic detection of Folia vs. Paper<\/p>\n

### License<\/p>\n

MIT License<\/p>\n","protected":false},"excerpt":{"rendered":"

plugin for trades with villagers and custom items from nexo also you can use playerpoints as economy.<\/p>\n","protected":false},"featured_media":53247,"template":"","meta":{"_minecraft_slug":"customtrades","_minecraft_project_id":"qSgqUoHC","_minecraft_author":"TheLion102009","_minecraft_license":"MIT","_minecraft_downloads":718,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"customtrades.zip","_minecraft_size_bytes":2413808,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T09:30:59.065228Z","_minecraft_date_created":"2025-11-23T05:19:05.366586Z","_minecraft_date_modified":"2025-11-22T17:14:02.958050Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/customtrades","_minecraft_icon_attachment_id":53247,"_minecraft_imported_at":"2026-06-02T23:11:54+00:00","_minecraft_import_hash":"f1befba912ba97e4440957525d54bdb1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,125,127],"mod_loader":[131,132],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-53246","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-folia","mod_category-paper","mod_loader-folia","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","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","minecraft_version-1-21-9"],"yoast_head":"\ncustomtrades - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"customtrades - Minecraft\" \/>\n<meta property=\"og:description\" content=\"plugin for trades with villagers and custom items from nexo also you can use playerpoints as economy.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/customtrades\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/customtrades\\\/\",\"name\":\"customtrades - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/customtrades\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/customtrades\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/customtrades-icon-65bc028b8f52712850a23715cb52849cfbe9eab3_96.webp\",\"datePublished\":\"2026-06-02T23:11:53+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/customtrades\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/customtrades\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/customtrades\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/customtrades-icon-65bc028b8f52712850a23715cb52849cfbe9eab3_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/customtrades-icon-65bc028b8f52712850a23715cb52849cfbe9eab3_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/customtrades\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"customtrades\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"customtrades - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/","og_locale":"en_US","og_type":"article","og_title":"customtrades - Minecraft","og_description":"plugin for trades with villagers and custom items from nexo also you can use playerpoints as economy.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/","name":"customtrades - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/customtrades-icon-65bc028b8f52712850a23715cb52849cfbe9eab3_96.webp","datePublished":"2026-06-02T23:11:53+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/customtrades-icon-65bc028b8f52712850a23715cb52849cfbe9eab3_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/customtrades-icon-65bc028b8f52712850a23715cb52849cfbe9eab3_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/customtrades\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"customtrades"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/53246","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/53247"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=53246"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=53246"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=53246"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=53246"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}