STraders

STraders

STraders is a Minecraft trader system that allows players and administrators to create customizable villager shops.

It supports player-owned shops, admin shops, custom offers, stock management, sales collection, villager variants, persistent trader IDs, permissions and modded items.

Main Features

• Player-owned traders
• Admin traders
• Custom trader names
• Persistent trader IDs such as trader_01
• Custom buy and sell offers
• Paginated offer editor
• Paginated stock inventory
• Paginated sales collection inventory
• Villager type customization
• Support for modded items
• Support for custom item IDs, NBT and item components
• Persistent storage
• Owner protection
• Permission support
• Admin inspection and removal tools
• Multi-language support

Player Commands

Create a Player Trader

/traders create player <name>

Creates a normal player-owned trader.

Example:

/traders create player Diamond Shop

Create an Admin Trader

/traders create admin <name>

Creates an admin trader.

Requires admin trader permission or OP access.

List Your Traders

/traders list

Shows all traders owned by you.

Example:

Diamond Shop - trader_01

Food Shop - trader_02

Remove Your Trader

/traders remove <id>

Removes one of your own traders.

Example:

/traders remove trader_01

Players cannot remove traders owned by another player.

Rename Your Trader

/traders rename <id> <new name>

Changes the display name of one of your traders.

Example:

/traders rename trader_01 Premium Diamond Shop

The trader ID does not change.

Admin Commands

Admin management commands require OP access.

Remove Any Trader

/admintraders remove <id>

Removes any trader by its ID.

Example:

/admintraders remove trader_15

List All Traders

/admintraders list

or:

/admintraders list <page>

Shows all registered traders with pagination.

Example:

PlayerName | Diamond Shop - trader_01

AnotherPlayer | Food Shop - trader_02

Selection Removal Tool

/admintraders selremove

Gives the administrator a special removal stick.

Use the stick on a trader to remove it.

The tool:

• Can only be used by OPs
• Cannot be stored in containers
• Disappears when dropped
• Can be moved inside the player's inventory
• Is consumed after successfully removing a trader

Trader Information Tool

/admintraders info

Gives the administrator a special information item.

Use it on a trader to display information such as:

• Trader name
• Trader ID
• Owner
• Owner UUID
• Trader type
• Creation date
• Dimension
• Position
• Number of offers
• Basic stock information

The tool has the same inventory protections as the removal tool.

Permissions

Player Trader Permission

straders.permission.create.normal

Allows a player to create and manage normal player traders.

This permission also gives access to the management systems of traders owned by that player, including:

• Offer editing
• Villager customization
• Stock deposit
• Stock withdrawal
• Sales collection
• Trader management

Players cannot manage traders owned by another player.

Admin Trader Permission

straders.permission.create.admin

Allows a non-OP staff member to create and manage admin traders.

OP players do not require these permissions.

A compatible Fabric permission manager such as LuckPerms can be used to assign permission nodes.

Trader Management

Sneak-interacting with your own trader opens the trader management system.

Normal players cannot use management interactions on traders owned by another player.

Offers

Create, edit and delete trade offers.

Each offer can contain:

• Cost 1
• Optional Cost 2
• Result

Offer lists are automatically paginated.

Entity

Changes the villager appearance used by the trader.

Available vanilla villager variants include:

• Plains
• Desert
• Jungle
• Savanna
• Snow
• Swamp
• Taiga

Stock

Player traders can store the items that will be sold.

The stock inventory supports pagination.

Players can:

• Deposit items
• Withdraw accidentally deposited items
• Use shift-click for faster inventory management

Sales Collection

Payments received from customers are stored separately.

The owner can open the collection inventory and choose which items to collect.

The sales inventory is also paginated.

Modded Item Compatibility

STraders is designed to work with modded items.

Stored items preserve their Minecraft ItemStack data whenever supported by the Minecraft version, including:

• Custom item IDs
• Mod namespaces
• Stack size
• NBT data
• Custom names
• Enchantments
• Durability
• Item components

This allows traders to work with items from other mods without requiring hardcoded item lists.

Security

Important inventory operations are handled server-side.

The system includes protection against common duplication and ownership issues.

Examples include:

• Server-side stock validation
• Persistent trader inventories
• Immediate save operations during important transactions
• Owner validation
• Protected admin tools
• Safe stock withdrawal
• Inventory-full checks
• Protection against managing another player's trader

Languages

STraders currently includes translations for:

• English — en_us
• Portuguese, Brazil — pt_br
• Spanish — es_es
• Japanese — ja_jp
• Simplified Chinese — zh_cn
• Hindi — hi_in
• Arabic — ar_sa
• Russian — ru_ru