CustomTrades

A comprehensive Paper/Folia 1.21.x plugin for custom trader NPCs with Nexo and PlayerPoints support.

Features

• ✅ Create custom trader NPCs (Villager, Wandering Trader, Zombie Villager)
• ✅ User-friendly GUI for trade management
• ✅ Support for vanilla items and Nexo custom items
• ✅ PlayerPoints as alternative currency
• ✅ Folia compatible
• ✅ YAML-based configuration per trader
• ✅ Persistent traders (survive server restarts)

Commands

• /ct create - Creates a new trader at your position
• /ct edit - Opens the trade editor for the targeted trader
• /ct remove - Removes a trader
• /ct list - Lists all traders
• /ct reload - Reloads all traders

Permissions

• customtrades.use - Access to all commands (default: op)
• customtrades.create - Create traders (default: op)
• customtrades.edit - Edit traders (default: op)
• customtrades.remove - Remove traders (default: op)
• customtrades.list - List traders (default: op)

Setup

1. Dependencies

The plugin requires the following dependencies:

• Paper/Folia 1.21.x
• PlayerPoints 3.2.7+ (optional, for PlayerPoints trades)
• Nexo 0.1.0+ (optional, for custom items)

2. Installation

1. Place the plugin in the plugins folder
2. Start the server
3. (Optional) Install PlayerPoints and/or Nexo
4. Use /ct create to create your first trader

Usage

Creating a trader

/ct create MyTrader villager

Spawns a villager trader at your position.

Configuring trades

1. Look at the trader
2. Execute /ct edit
3. Click on "Add Trade"
4. Place items from your inventory into the slots or use the options
5. Set PlayerPoints cost (optional)
6. Save the trade

YAML Configuration

Each trader is saved in plugins/customtraders/traders/<name>.yml:

name: MyTrader
mobType: VILLAGER
displayName: "&6Trader"
persistent: true
location:
world: world
x: 100.5
y: 64.0
z: 200.5
yaw: 0.0
pitch: 0.0

trades:
0:
input1:
type: VANILLA
material: DIAMOND
amount: 10
output:
type: VANILLA
material: EMERALD
amount: 1
maxUses: -1
playerPointsCost: 0

1:
input1:
type: NONE # No item - PlayerPoints only
output:
type: NEXO
nexoId: custom_sword
amount: 1
maxUses: 1
playerPointsCost: 1000

Item Types

• VANILLA: Normal Minecraft items
  type: VANILLA
  material: DIAMOND_SWORD
  amount: 1
  displayName: "&bSpecial Sword"
  lore:

  • "&7A special sword"

• NEXO: Custom items from Nexo
  type: NEXO
  nexoId: my_custom_item
  amount: 1

• NONE: No item (for PlayerPoints-only trades)
  type: NONE

PlayerPoints Integration

When PlayerPoints is installed:

• Set playerPointsCost to a value > 0
• The player needs the specified points for the trade
• Points are automatically deducted on successful trade
• You can set input1 to type: NONE for pure PlayerPoints trades

Folia Compatibility

The plugin uses:

• Entity Scheduler for entity-related tasks
• Region Scheduler for region-related tasks
• Automatic detection of Folia vs. Paper

License

MIT License