
Smiley Player Trader allows you to trade with other players using the Minecraft Villager trading GUI.
Commands | Permissions | Configuration
Basic Usage Instructions

Step 1: Run the "/spt" command to open the menu.

Step 2: Press the "Create New Product" button (the emerald).

Step 3: Place the item you wish to sell into the inventory slot.

Step 4: Click the "Set Primary Cost" button (the single Gold Ingot).

Step 5: Insert the price item, select an item from the quick items row or press the beacon for more items to choose from.

Step 6: Other players can now trade with you by Right Clicking you or using "/spt trade
Tip: You can use the "/spt help" command for a list of available commands.
Optional Dependencies
- Vault - used for offline permission checking, only needed if you want offline trading and restrict "smileyplayertrader.merchant" permission.
- PlaceholderAPI - provides some PlaceholderAPI expansions you can use. See this wiki page for a list of the supported expansions.
- WorldGuard - provides a flag to disable trading in a region. See this wiki page for more information.
Supported Versions
- Bukkit/Spigot/Paper 26.3
- Bukkit/Spigot/Paper 26.2
- Bukkit/Spigot/Paper 26.1.2
- Bukkit/Spigot/Paper 26.1.1
- Bukkit/Spigot/Paper 26.1 (since version 1.7.33)
- Bukkit/Spigot/Paper 1.21.11 (since version 1.7.32)
- Bukkit/Spigot/Paper 1.21.10
- Bukkit/Spigot/Paper 1.21.9 (since version 1.7.27)
- Bukkit/Spigot/Paper 1.21.8
- Bukkit/Spigot/Paper 1.21.7
- Bukkit/Spigot/Paper 1.21.6 (since version 1.7.24)
- Bukkit/Spigot/Paper 1.21.5 (since version 1.7.18)
- Bukkit/Spigot/Paper 1.21.4 (since version 1.7.17)
- Bukkit/Spigot/Paper 1.21.3
- Bukkit/Spigot/Paper 1.21.2 (since version 1.7.16)
- Bukkit/Spigot/Paper 1.21.1
- Bukkit/Spigot/Paper 1.21 (since version 1.7.7)
- Bukkit/Spigot/Paper 1.20.6
- Bukkit/Spigot/Paper 1.20.5 (since version 1.7.6)
- Bukkit/Spigot/Paper 1.20.4
- Bukkit/Spigot/Paper 1.20.3 (since version 1.7.4)
- Bukkit/Spigot/Paper 1.20.2 (since version 1.7.1)
- Bukkit/Spigot/Paper 1.20.1
- Bukkit/Spigot/Paper 1.20 (since version 1.6.4)
- Bukkit/Spigot/Paper 1.19.4 (since version 1.6.3)
- Bukkit/Spgiot/Paper 1.19.3 (since version 1.6.0)
- Bukkit/Spigot/Paper 1.19.2
- Bukkit/Spigot/Paper 1.19.1 (since version 1.5.0)
- Bukkit/Spigot/Paper 1.19 (since version 1.4.5)
- Bukkit/Spigot/Paper 1.18.2 (since version 1.4.4)
- Bukkit/Spigot/Paper 1.18.1
- Bukkit/Spigot/Paper 1.18 (since version 1.4.1)
- Bukkit/Spigot/Paper 1.17.1
- Bukkit/Spigot/Paper 1.17 (since version 1.3.0)
- Bukkit/Spigot/Paper 1.16.5 (since version 1.3.0)
- Bukkit/Spigot/Paper 1.16.4 (since version 1.2.2)
- Bukkit/Spigot/Paper 1.16.3
- Bukkit/Spigot/Paper 1.16.2 (since version 1.2.1)
- Bukkit/Spigot/Paper 1.16.1 (since version 1.2.0)
- Bukkit/Spigot/Paper 1.15.2
- Bukkit/Spigot/Paper 1.15.1
- Bukkit/Spigot/Paper 1.15
Metrics
This plugin uses bStats. You can view the metrics here.
If you do not wish to allow bStats to collect metrics, you can opt-out in the bStats configuration file in the plugins directory.
The font used in the header image and the tutorial images is Ubuntu font.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 |
- Russian translation update (thanks [@TheRealFosya](https://github.com/TheRealFosya) on GitHib)
_Note: If you do not use the Russian translation, you can ignore this update._
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Added an option to block trades where the product and cost items are the same.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
# Updating Config
_Don't forget to make a backup of your config!_
- Option 1:** Look at the reference [config.yml](https://github.com/Mrcomputer1/SmileyPlayerTrader/blob/v1.7.36/src/main/resources/config.yml) and set the settings you want in your config.yml.
- Option 2:** Rename your config.yml and restart/reload your server and then re-apply your settings to the new config.yml and restart/reload the server again to apply them.
- Added support for Paper 26.3.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Fix bug that prevented the plugin working on Paper servers.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Add support for Minecraft 26.1 and, assuming no incompatibilities, future 26.* releases.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
The previous release (version 1.7.31) was accidentally built using the code from the release before it (version 1.7.30). This release (version 1.7.32) contains the updates intended for version 1.7.31.
# Change Log
__**Important note about permission change: If the plugin's default permissions aren't applied, grant
smileyplayertrader.trade.rightclick to everyone to ensure players can continue to trade by right-clicking each other.**__- Support for Minecraft 1.21.11.
- Option to enable a cooldown between trades (disabled by default). ([#92](https://github.com/Mrcomputer1/SmileyPlayerTrader/issues/92))
- Option to add commands that are executed after a successful trade. ([#91](https://github.com/Mrcomputer1/SmileyPlayerTrader/issues/91))
- Added an option to control right-click trading (
smileyplayertrader.trade.rightclick). - Added WorldGuard flags for right-click trading (
spt-right-click-trade) and using the/spt traderemote trade command (spt-remote-trade).
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
# Updating Config
_Don't forget to make a backup of your config!_
- Option 1:** Look at [config.yml](https://github.com/Mrcomputer1/SmileyPlayerTrader/blob/v1.7.32/src/main/resources/config.yml) and set the settings you want in your config.yml.
- Option 2:** Rename your config.yml and restart/reload your server and then re-apply your settings to the new config.yml and restart/reload the server again to apply them.
This release (version 1.7.31) was accidentally built using the code from the release before it (version 1.7.30). Please use version 1.7.32, which contains the updates intended for version 1.7.31.
# ~~Change Log~~
~~__**Important note about permission change: If the plugin's default permissions aren't applied, grant
smileyplayertrader.trade.rightclick to everyone to ensure players can continue to trade by right-clicking each other.**__~~- ~~Support for Minecraft 1.21.11.~~
- ~~Option to enable a cooldown between trades (disabled by default). ([#92](https://github.com/Mrcomputer1/SmileyPlayerTrader/issues/92))~~
- ~~Option to add commands that are executed after a successful trade. ([#91](https://github.com/Mrcomputer1/SmileyPlayerTrader/issues/91))~~
- ~~Added an option to control right-click trading (
smileyplayertrader.trade.rightclick).~~ - ~~Added WorldGuard flags for right-click trading (
spt-right-click-trade) and using the/spt traderemote trade command (spt-remote-trade).~~
# Updating Config
_Don't forget to make a backup of your config!_
- Option 1:** Look at [config.yml](https://github.com/Mrcomputer1/SmileyPlayerTrader/blob/v1.7.31/src/main/resources/config.yml) and set the settings you want in your config.yml.
- Option 2:** Rename your config.yml and restart/reload your server and then re-apply your settings to the new config.yml and restart/reload the server again to apply them.
- Fix minor bug with
/spt create(product would still be created when invalid option is specified). - Russian translation update (thanks @Fosyaaa on GitHub).
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Add "/spt reload" command to reload configuration. (#87)
- /spt command's subcommand tab-complete now only shows commands you can run.
- Add "/spt create" command to create a product and set options in one command. (#86)
- Add "requireItemInHandWhileUsingCreateCommand" config option (defaults to false). (#86)
- Add optional shulker box stock location (disabled by default, uncomment the line in "stockLocations" in the config file).
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
# Updating Config
_Don't forget to make a backup of your config!_
- Option 1:** Look at [config.yml](https://github.com/Mrcomputer1/SmileyPlayerTrader/blob/v1.7.29/src/main/resources/config.yml) and set the settings you want in your config.yml.
- Option 2:** Rename your config.yml and restart/reload your server and then re-apply your settings to the new config.yml and restart/reload the server again to apply them.
- Fix a duplication glitch.
- Add a config option to only use one stock location, instead of spreading across multiple stock locations.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
# Updating Config
_Don't forget to make a backup of your config!_
- Option 1:** Look at [config.yml](https://github.com/Mrcomputer1/SmileyPlayerTrader/blob/v1.7.28/src/main/resources/config.yml) and set the settings you want in your config.yml.
- Option 2:** Rename your config.yml and restart/reload your server and then re-apply your settings to the new config.yml and restart/reload the server again to apply them.
- Added support for Minecraft 1.21.9.
- Increasing/decreasing the quantity of a item inserted into the Set Cost menu is now possible.
- Added Simplified Chinese translation (thanks wyjwyj).
- Custom items configuration for Set Cost price selector menu now support Nexo and ValhallaMMO items ([more information](https://github.com/Mrcomputer1/SmileyPlayerTrader/wiki/Item-Integration)).
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Russian translation update (thanks @Fosyaaa on GitHub).
- Update default
priceSelectorMenuhiddenItemslist inconfig.yml. - Document
%ITEM_NAME%replacement inconfig.ymlfor theshowNotificationOnNewTradeoption.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
# Updating Config
_Don't forget to make a backup of your config!_
- Option 1:** Look at [config.yml](https://github.com/Mrcomputer1/SmileyPlayerTrader/blob/v1.7.26/src/main/resources/config.yml) and set the settings you want in your config.yml.
- Option 2:** Rename your config.yml and restart/reload your server and then re-apply your settings to the new config.yml and restart/reload the server again to apply them.
- Item names will now be displayed in some messages (such as out of stock notifications) instead of Bukkit Material name.
- Bug Fix: Require items being used as payment to match the cost item exactly.
- Bug Fix: Payment should be able to be placed in either input slot when product has only one cost item.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
# Updating Config
_Don't forget to make a backup of your config!_
- Option 1:** Look at [config.yml](https://github.com/Mrcomputer1/SmileyPlayerTrader/blob/v1.7.25/src/main/resources/config.yml) and set the settings you want in your config.yml.
- Option 2:** Rename your config.yml and restart/reload your server and then re-apply your settings to the new config.yml and restart/reload the server again to apply them.
- Add support for Minecraft 1.21.6.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Russian translation update (thanks @Fosyaaa on GitHub)
_Note: If you do not use the Russian translation, you can ignore this update._
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Trading can now be allowed/disallowed in a world using a whitelist or blacklist (
allowedWorldsconfig option -allowedWorlds.modeset toblacklistbehaves the same as the olddisabledWorldsoption). - Trading can now be allowed/disallowed in an area using a WorldGuard region flag (
smiley-player-trader).
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
# Updating Config
_Don't forget to make a backup of your config!_
- Option 1:** Look at [config.yml](https://github.com/Mrcomputer1/SmileyPlayerTrader/blob/v1.7.22/src/main/resources/config.yml) and set the settings you want in your config.yml.
- Option 2:** Rename your config.yml and restart/reload your server and then re-apply your settings to the new config.yml and restart/reload the server again to apply them.
- Russian translation update (thanks @Fosyaaa on GitHub)
_Note: If you do not use the Russian translation, you can ignore this update._
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Add an option (default off) to send a notification to online players that a player has a new trade.
- Add an option to disable using Vault for offline player permission checking (useful if you do not have a permission plugin or your permission plugin doesn't support offline players).
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
# Updating Config
_Don't forget to make a backup of your config!_
- Option 1:** Look at [config.yml](https://github.com/Mrcomputer1/SmileyPlayerTrader/blob/v[version number]/src/main/resources/config.yml) and set the settings you want in your config.yml.
- Option 2:** Rename your config.yml and restart/reload your server and then re-apply your settings to the new config.yml and restart/reload the server again to apply them.
- Added some PlaceholderAPI expansions, see [this](https://github.com/Mrcomputer1/SmileyPlayerTrader/wiki/Placeholders) wiki page for details.
- Fixed a
NullPointerExceptionthat occurs when right clicking a NPC player entity for a player that not online.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Add support for Minecraft 1.21.5.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Add support for Minecraft 1.21.4
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Support for Minecraft 1.21.2.
- Fixed a bug with item stacking on some GUIs (thanks @miladm78 on GitHub, [#68](https://github.com/Mrcomputer1/SmileyPlayerTrader/pull/68))
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Fixed a bug when creating a new database.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Add Vietnamese translation (by CoPeBanSIMP).
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Add Polish translation (thanks gvvda21).
- Update Russian translation.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Russian translation update (thanks @[Fosyaaa](https://github.com/Fosyaaa) on GitHub)
_Note: If you do not use the Russian translation, you can ignore this update._
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Fix: Adds way to see if the admin unlimited supply option is enabled or disabled for an item.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Added admin-only option to make an item have an unlimited supply (
/spt unlimitedsupply).
- Note: We recommend backing up your SPT database and configuration file, just in case. This version makes changes to the structure of the SPT database, if something unexpected, such as a power outage or server crash occurs, the database could be left in an inconsistent or corrupted state.**
# Updating Config
_Don't forget to make a backup of your config!_
- Option 1:** Look at [config.yml](https://github.com/Mrcomputer1/SmileyPlayerTrader/blob/v[version number]/src/main/resources/config.yml) and set the settings you want in your config.yml.
- Option 2:** Rename your config.yml and restart/reload your server and then re-apply your settings to the new config.yml and restart/reload the server again to apply them.
- Added ability to specify default amount of an item for price quick selection and the "More Items..." menu's extra items and featured items.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**
- Fixed a bug that prevented trading on Paper-based servers.
- Note: We recommend backing up your SPT database and configuration file, just in case. While it is unlikely something will go wrong, it is always a good idea to have backup.**