Shopkeepers Addon [ 1.20.6-1.21.8 ] » Navigation & Economy

Shopkeepers Addon [ 1.20.6-1.21.8 ] » Navigation & Economy -----

Add Economy support and shop navigation!

Download Now
Via external site

Bug Fixes

Config Backup Behavior
- Fixed: Configuration was being backed up on every restart/reload
- Change: Backup now only occurs when there are actual changes to the configuration (e.g., new additions)
Chat Message Formatting
- Fixed: Messages in chat were not following custom price formatting rules
- Change: Chat messages now correctly display custom price formatting as configured

----------, Sep 27, 2025

New Currrency Format & Optimizations

ShopkeepersAddon Update
Optimizations

Reduced code duplication
Optimized error handling
Improved simulate click for Shop Edit Task
Async file operations
Added null safety checks
Better logging
Separated config loading
Added cleanup on plugin disable

Added Features

Added /shopkeepersaddon reload command
Added economy price formatting in config:

Code (YAML):

economy :
# Price formatting options
price-format :
# Format pattern using DecimalFormat syntax:
# 0 = prints digit if provided, 0 otherwise
# # = prints digit if provided, nothing otherwise
# . = decimal separator position
# , = thousands grouping separator position
pattern : ' #,##0.00'

# Swap decimal and grouping separators for European format
# true: 1.000.000,00 (European) | false: 1,000,000.00 (Western)
european-format : false

# Custom separators (optional - overrides european-format if both are set)
# decimal-separator: '.'
# grouping-separator: ','

# Currency symbol and position
currency-symbol : '$'
symbol-before : true # true: $100 | false: 100$

Added purchase feedback messages:

Code (YAML):

messages:
buySuccess : "§aYou have bought %item% for %price%."
sellSuccess : "§aYou have sold %item% for %price%."

Optimized bulk item purchase system
Added automatic config migration on version update

----------, Sep 26, 2025

Bug Fix

Changelog

Fixed! Stack selling bug. Even on selling less than 1 stack, plugin gave full stack money when shift click trading.

----------, Aug 1, 2025

Bug Fixes

Changelog

Fixed! New items not appearing in admin trades.
Fixed! Blacklisting items was not working.

----------, Jul 23, 2025

Bug Fix

Changelog

Fixed! Error on new item in shopkeeper.

----------, Jul 22, 2025

Blacklist Items & Bug Fix

Changelog

NEW! Blacklist items in player shops!
Fixed! Error on empty trade selection.

Add the following to your config.yml:

Code (YAML):

playerShops :
# Blacklist items that cannot be sold in player shops
itemBlacklist :
- BEDROCK

Code (YAML):

messages:
blacklistedItem : "§cThis item is blacklisted and cannot be sold in player shops.

----------, Jul 20, 2025

Bug Fixes

Changelog

Fixed! Bug with Stack selling.
Fixed! Issue with money not deducting/depositing from offline players.
Added! Recipies will show not tradable for economy items if player doesnt have enough items in inventory.

----------, Jul 18, 2025

Bug Fixes

- Fixed trading multiplier money bug!
- Fixed error on skin loading for Steve skinned players.

----------, Jul 17, 2025

Bug Fixes

Fixed spamming errors on trading!
Added a catch for an unidentified error.

----------, Jul 13, 2025

Shopkeepers Addon 2.23.8-250712

FIXED!
- Null pointer exception on creating/trading shops.

NEW!
- Added Custom Model Data. If you are upgrading, add in config:

Code (YAML):

economy :
# Enable economy support
enabled : true
# Set the price limit for trades
selling-price-limit : 100000000.00
# Currency Item:
sell-item :
# Name format. Use %price% for the price.
name : "Price: §f$%price%"
material : GOLD_NUGGET
glow : true
lore :
- "§bClick to edit"
custom-model-data : 0 # Set to 0 to disable custom model data for the sell item
# Currency Item:
buy-item :
# Name format. Use %price% for the price.
name : "You get: §f$%price%"
material : GOLD_NUGGET
glow : true
lore :
- "§bClick to edit"
custom-model-data : 0 # Set to 0 to disable custom model data for the buy item

----------, Jul 12, 2025

Bug Fixes

Fixed Shift click trading
Fixed Double click bug on trade
Added comptabibility with old trades

----------, Jul 6, 2025

Complete Rewrite

Compatible with Shopkeepers 2.23.8
Updated for latest Minecraft version, 1.21.7.
You will need to regenerate config folder.

----------, Jul 1, 2025

Custom Model Data & Shift Click

Custom Model Data in config for buy and sell item.
Added Shift click to sell and buy money items.
Fixed bug for money item.
Now Requires Protocolib

----------, Feb 13, 2025

Update to 1.21.4

Updated to shopkeepers v2.23.3
Now supports 1.21.4

----------, Dec 22, 2024

Quality of Life Changes

Cache files now load correctly.
Support for & for colors and \n for new line.
Fixed duplicate heads in player shops.
Admin shop heads showing as Steve, now shows as entity type.
Some online player heads weren't loading properly, now loads correctly
Separated sell item and buy item in config. This will ensure both sell item and buy item get separate properties.
Automatic config.yml migration on updates.

Config Changes:

Removed:

Code (YAML):

economy:
item :
# Name format. Use %price% for the price.
name : "Price: §f$%price%"
material : GOLD_NUGGET
glow : true
lore :
- "§bClick to edit"

Added:

Code (YAML):

economy :
# Currency Item:
sell-item :
# Name format. Use %price% for the price.
name : "Price: §f$%price%"
material : GOLD_NUGGET
glow : true
lore :
- "§bClick to edit"
# Currency Item:
buy-item :
# Name format. Use %price% for the price.
name : "You get: §f$%price%"
material : GOLD_INGOT
glow : true
lore :
- "§bClick to edit"

messages :

no-shop-lore :
- "&cThis player has not setup a shop."
- "&cUse &f/setshop &c to setup."

----------, Oct 10, 2024

Performance improvements and more.

Massive performance improvements.
New config options:
Code (YAML):

# How often should the shops refresh? (in seconds) keep it above 30 seconds to avoid lag.
refresh-rate : 60

messages:
shops :
admin-sellers-ui : "§8§lAdmin Sellers"
player-sellers-ui : "§8§lPlayer Sellers"

----------, Sep 28, 2024

PaperMC's Gameprofile Reflections patch

Updated PaperMC's reflection deprecation for player Game profiles. Spigot still works the same.
Added Offline and Online UUID Caching in separate files.

----------, Sep 25, 2024

Complete Recode

This is a complete recode of the plugin with changed logics and optimized code.

You will need to regenerate the config.

Changelog:

New configuration and messages.
Item glow added.
Option to teleport to shopkeepers.
Players can set their own shop location.
Optimized and cleaned up code.
NO MESSAGES.YML

----------, Sep 21, 2024

No Update. Only version fixing

----------, Sep 4, 2024

Bug Fix & Minor Re-code Latest

Patches!

Fixed Trading issue, dupe glitch
Fixed Item stacking issue in trade inventory
Version naming now follows parent Shopkeeper Plugin versions.
Fixed the debug message.

NEW!

Players now teleport to shopkeepers 2 blocks away and get closer if any obstruction.
Players teleport to shopkeepers facing the shopkeeper.
Re-coded safe teleport logic.

----------, Aug 21, 2024

Minor Bug fix

Fixed issue with trading

----------, Aug 9, 2024

Update for 1.21 & Bug fixes

- Fixed Major bug for duped items on economy
- Fixed itemstack issue on economy menu

----------, Aug 9, 2024

Support for 1.19

Shopkeepers addon v2.16.0

----------, Jun 30, 2022

Minor Patches

Minor messages changed and code cleaned.

----------, Jun 11, 2022

Final Dupe Fix.

No matter how much i try, there always seems to be a new kind of dupe. This should fix it all.

----------, Jun 11, 2022

Minor Cleanup

Minor cleanup

----------, Jun 10, 2022

Another dupe fixed

Dupe fixed for plugin inventory slot 0 and 1.

----------, Jun 10, 2022

Big Bug Smashed - Fixed Money Dupe

Big thanks to @CloudeLecaw for reporting and tirelessly helping me fix this bug.

For certain servers, there was a glitch where the player could trade with the Admin shopkeeper and get money however the item would not decrease from his inventory. This was being temporarily patched by a third party plugin EnforceVillagerTradeSelection and should no longer be needed.

----------, Jun 9, 2022

Refractor Update

- Had an issue with refractor misspelled.

----------, May 3, 2022

Bug Fix + Refractor + API Changes

Bug Fixed:

- When an item is put in trading slot during trading, the purchase goes through but the item does not, this has been fixed.

- This version is meant to work with latest Shopkeepers plugin (v2.15.1)

Refractor:

- Refractor performed for dev.MrFlyn to me._w41k3r

- This was done to prevent confusion in future for reporting issues.

API Changes:

- API for shopkeepers was updated from using dependency to now using Artifacts and Classes using the API

----------, May 3, 2022

Update title

Forgot to post update version to 2.7 in the last update.

no major changes.

----------, May 2, 2022

Updated for 2.15.1

Added some small patches for Shopkeepers 2.15.1

----------, Apr 30, 2022

DupeFix:-

fixed a dupe

----------, Jan 20, 2022

Fixed bug related to custommodel data

----------, Jan 14, 2022

Added CustomModelData support for currency Item

Added CustomModelData support for currency Item in messages.yml
Note(will only apply for new trades)

----------, Jan 14, 2022

BugFix:-

-Fixed nullpointer exception if shopkeeper location is null

----------, Jan 8, 2022

Bug Fix:-

Fixed Gui items dupe issue

----------, Jan 7, 2022

Added Features:-

- added /playershops command which will open the navigation gui without the adminshop icon.
- added /shop which will open the adminshop gui with remote shop acess(on clicking the shop icon instead of teleporting to the admin shop this will open the trade window for the player.
- added permission nodes for the above commands:-
- SNA.command.playershops
- SNA.command.shop

----------, Jan 5, 2022

Bug fix:-

fixed nullpointer exception on buying items with currency item

----------, Jan 4, 2022

Bug Fixes:-

- Fixed NullPointerException while trading with currency-Item.
- Fixed an issue where bedrock players(geyser) weren't able to trade with currency item.
- Added warning on full inventory.

----------, Jan 1, 2022

[1.16 - 1.18] Shopkeepers Addon | Navigation | Teleport to shop - Plotsquared Integration

fixed a typo in config

----------, Dec 16, 2021

[1.16 - 1.18] Shopkeepers Addon | Navigation | Teleport to shop - Plotsquared Integration

added permissions: