Shopkeepers Addon » Navigation & Economy
2.28.1.1-261101Add Economy support and shop navigation!
2.28.1.1-261101latestShopkeepersAddon 2.28.1-261101last week For Shopkeepers 2.28.1 - Minecraft 1.21.5+ - Paper, Purpur, Spigot The addon's version now follows Shopkeepers': 2.28.1-(build date) is built for Shopkeepers 2.28.1. This build is 2.28.1-261101; later builds for the same Shopkeepers version only change the date. Read this first · Minecraft 1.20.6 is no longer supported. Shopkeepers 2.28.1 itself needs 1.21.5 or newer. · PacketEvents is now the recommended packet library. It is used first when both are installed. ProtocolLib still works, with limited support. · Your config is safe to upgrade: your own values are no longer overwritten, and the new message keys are added for you. Fixed Duplication and free items · Shift-click on a "money + item" trade now takes the item too. Before, you kept the item and still got the goods. · A refused payment now cancels the trade and is refunded, instead of handing out goods for nothing. · A trade that another plugin cancelled is no longer charged. · Recipes that list the same material twice (for example 64 + 32 diamonds) are no longer counted twice. · A money item in the second ingredient slot is refused instead of trading for free. · Gold nuggets from the trade window can no longer be carried out in a bundle. Money items already inside a bundle are removed. Player shops · Player shops now pay their owner, EssentialsX included. · You can no longer bulk-buy more than the shop has in stock. · Shift-click accepts a renamed or damaged second item, like a single click does. · If the owner changes a price while a trade window is open, the sale uses the new price instead of paying the old one. Display and menus · A blocked sale (daily earning limit reached, or the shop owner cannot pay) now shows the red cross. This needs PacketEvents. · The currency symbol no longer shows twice ("$$5.00"). · The /shops, Admin Shops and Player Shops menus fill their empty slots, so the buttons stand out. · The buy message no longer shows "UNKNOWN" as the item name. · Selecting a trade no longer hands the currency stack to your inventory (the "stuck nuggets" cause on Bedrock). Stability · No more errors in trade handlers when Vault is not installed. · The economy is picked up even if its plugin loads after this one. · The price prompt times out after 30 seconds and no longer locks your chat. Prices that are not positive numbers or are above economy.selling-price-limit are rejected. · The shop editor no longer turns your inventory slots into barriers. · Config upgrades no longer overwrite your values or delete optional keys. · /shopkeepersaddon reload runs on the main thread. · The "PlaceholderAPI is not installed" error is gone; PlaceholderAPI is optional. Tested Real Minecraft 26.3 client on Purpur 26.3 with Shopkeepers 2.28.1, Vault and EssentialsX. Not tested yet: ProtocolLib, Bedrock/Floodgate players (the fixes for them are in, please report back), and upgrading from very old configs. Found a bug? Tell us in the Discord. Thank you to everyone who reported one!2.27.0-260811Packetevents, new shop browser and more!Aug 11, 2026 ShopkeepersAddon Update
New
️ Shop Browser — /shopbrowser Browse every player shop on the server. A grid of player heads, one per shop owner; click a head to see all of that player's shopkeepers with their type, world and coordinates; click a shop to teleport straight to it. Paged, so it handles hundreds of shops fine. Aliases: /shopowners, /browseshops
Teleports actually land somewhere sensible No more arriving inside a slab or halfway through a wall. You now land in front of the shop, facing it, on ground you can actually stand on. Lava, fire, cactus, magma, powder snow, cobwebs and portals are all avoided, and if there is genuinely nowhere safe it tells you
before the countdown instead of after.
New config: playerShops.teleport.distance and adminShops.teleport.distance (default 2, range 1 to 8) set how many blocks away you arrive.
PacketEvents support ProtocolLib still works and is still the default, so nothing changes if you already run it. If you would rather use PacketEvents, the plugin now detects it automatically. It also runs with neither installed now, instead of refusing to load.
️ Fixed
Items could be put into the plugin's menus, and were lost forever Shift-clicking, dragging or clicking outside a menu could drop your items into it, where nothing ever gave them back. All of those routes are closed. Every empty-slot click was also throwing an error into console; that is gone too.
Two settings that did nothing playerShops.teleport.enabled and adminShops.teleport.enabled were never actually read. Turning them off did not disable teleports. They work now.
Notes
· Your config updates itself on first start. Existing settings are kept.
· New messages are configurable as usual.2.27.0-260804A critical duplication exploit is fixed in this buildAug 4, 2026 ️ Update: Shopkeepers Addon v2.27.0-260804 A critical duplication exploit is fixed in this build — please update as soon as you can. Security Fix — Infinite Money Exploit Players could rename any item (emeralds, logs, anything) and sell it to a shop over and over: the money was paid out but the item was never taken. The cause was that trades paid before removing the item, and the removal check compared item names — so a renamed item never matched the trade's item and was silently kept. Trades now take the goods first, match on the item type instead of its name, and only pay out once the items are actually collected. Verified fixed on a live test server. While fixing this, two more ways to lose items were closed: selling into a full shop chest, and selling to a shop whose owner couldn't be found — both used to take your goods and give nothing back. Selling Shops Now Show Their Items A long-standing bug: only trading shops were being scanned, so selling and buying shops — by far the most common types — never had their items listed in the Player Items menu, and couldn't be found by search. Every shop type is now included. Shops List Themselves — No More /setshop
Place a shopkeeper and it appears in the shops menu instantly. No command needed. Deleting your last shop cleans up the entry automatically, and shops that already exist get listed on your next restart. Custom names set with /setshop are always kept. Toggle it under playerShops.autoRegister.
New: Search — /shopsearch <anything>
Find shops, players and items instantly. Aliases: /ssearch, /findshop.
· Search by player name, shop name, or item (/shopsearch diamond)
· Partial and case-insensitive — shopown finds ShopOwner's Shop
· Paged results — browse hundreds of matches with the usual next/back buttons
· Click a result to teleport, or click an item to see every shop selling it
· Built to be light: it searches data already in memory and never touches the disk
Faster, Fresher Menus
· The refresh-rate option now actually works — it was documented but never running, so shops only ever updated when someone happened to edit one.
· Menu updates are no longer thrown away when several happen at once, which is what left the GUI showing stale shops.
· Menus are no longer briefly empty while refreshing in the background.
Note for Server Owners: Your config auto-updates to 1.8 on next boot (a backup is saved first). New options: playerShops.autoRegister, plus messages.search (its title supports %page%).
Requirements: This build needs Shopkeepers 2.27.0 on Minecraft 26.x, and ProtocolLib 5.4.0+ on 1.21.5 (26.x needs the ProtocolLib 5.5.0 dev-build). It still runs fine on Shopkeepers 2.26.0.
Download Now: Spigot:
Click Here Modrinth:
Click Here2.26.0-260719Stability & FairnessJul 20, 2026 Bug Fixes & Improvements: · No More Lost Money on Full Inventories: The big one. Buying an item with a full inventory (or selling into a player shop whose chest is full) used to take your money and give you nothing. Trades now check for space before charging — if there's no room, the trade is cancelled cleanly and your balance is left untouched. Comes with new customizable inventoryFull and shopStorageFull messages. · Bulk Trading Toggle: Tired of players crouch-clicking to snap up entire stacks at once? Set disable-bulk-trading: true in your config.yml to limit shift-clicks to a single trade. Staff and VIPs can be exempted with the new shopkeepersaddon.bulktrade.bypass permission. · Permissions That Actually Work: Fixed a mismatch where /shops and /setshop silently required OP. They now respect the intended shopkeepersaddon.command.shops / shopkeepersaddon.command.setshop nodes (default: on), so normal players can use them without being granted every permission. · Teleport Bypass Fixed: The teleport warmup-bypass permissions were pointing at old, non-existent nodes. They now correctly use shopkeepersaddon.admin.warmup.bypass and shopkeepersaddon.player.warmup.bypass. Note for Server Owners: Your configuration file will automatically update to config-version: 1.7 on the next reboot (a backup is saved first). Be sure to check out the new disable-bulk-trading option and the new inventoryFull / shopStorageFull messages!2.26.0-260330Daily Limit Update:Mar 30, 2026 · Modularized Daily Limit Messages: Updated config.yml (v1.6) and the Java logic to support a more flexible messaging system. · %remaining% Placeholder: Players can now see exactly how much more they can earn today directly in the limit alert message. · Universal Trade Locking: · Replaced "Inventory Close" with a visual red 'X' lock. · This applies to all "impossible trade" scenarios: Not enough money (player), Not enough money (owner), or Daily Limit reached. · The GUI now stays open for a better user experience. · Config Maintenance: Removed hardcoded versions from the Java code; the plugin now automatically reads and updates based on the config.yml in your resources.2.25.0-260212Vault Economy MigrationFeb 12, 2026 Changelog 2.25.0-260212 Vault Economy Migration · Native Vault Integration: Replaced the entire command-based economy system with direct Vault API calls. · Soft Dependency: Vault is now a soft dependency. If missing, economy features are gracefully disabled. · Performance: Removed the overhead of parsing console commands for every balance check. ️ Enhanced Trade Handling · Post-Trade Balance Check: Implemented logic to re-evaluate affordability immediately after a shift-click trade. · Slot Invalidation: If a player (or shop owner) runs out of funds during a bulk trade, the trade slot is automatically cleared or not replenished to prevent invalid transactions. Configuration Cleanup · Simplified Config: Removed economy.commands, economy.balance-placeholder, buy-settings, and sell-settings. · Enforced Defaults: Balance checks and costs/payouts are now always enabled by default in the code. · Config Version 1.3: Bumped config-version to 1.3 to ensure proper migration.2.25.0-260211Universal Economy IntegrationFeb 11, 2026 Changelog 2.25.0-260211 Universal Economy Integration · Command-Based Economy: Implemented a universal economy system that works with any economy plugin (Essentials, CMI, Vault, etc.) by executing console commands and parsing output. · Zero Dependencies: Removed hard dependency on Vault API. · Console Capture: Created a custom ConsoleCapture system to intercept command output for balance checking. · Configuration: Added comprehensive economy section to config.yml for defining commands, regex patterns, and transaction settings. ️ Strict Balance Checks · Trade Selection: Validates player balance (buying) and shop owner balance (selling) immediately when a trade is selected. · Pre-Trade Verification: Re-checks balance right before transaction execution to prevent race conditions. · Post-Trade UI Update: Automatically refreshes the trade UI to remove items if the player/owner can no longer afford the trade. · Owner Insolvency Protection: Prevents selling to player shops if the owner lacks funds (unless configured otherwise). Critical Bug Fixes · Recursion Guard: Fixed Recursive call to appender errors in ConsoleCapture by implementing a ThreadLocal guard. · ANSI Parsing Fix: Fixed incorrect balance parsing (e.g., 336.0) by stripping ANSI color codes from console output before parsing. · Heuristic Parser: Improved auto-detection logic to scan log lines in reverse, prioritizing the most recent output. Maintenance · API Update: Updated Shopkeepers API dependency to v2.25.0. · Version Bump: Project version updated to 2.25.0-260211.2.23.10.2-250927Bug FixesSep 27, 2025 · 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 configured2.23.10.2-250926New Currrency Format & OptimizationsSep 26, 2025 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 update2.23.10.1Bug FixAug 1, 2025 Changelog · Fixed! Stack selling bug. Even on selling less than 1 stack, plugin gave full stack money when shift click trading.2.23.9.5Bug FixesJul 23, 2025 Changelog · Fixed! New items not appearing in admin trades. · Fixed! Blacklisting items was not working.2.23.9.4Bug FixJul 22, 2025 Changelog · Fixed! Error on new item in shopkeeper.2.23.9.2Bug FixesJul 18, 2025 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.2.23.9.1Bug FixesJul 17, 2025 - Fixed trading multiplier money bug! - Fixed error on skin loading for Steve skinned players.2.23.8-250713Bug FixesJul 13, 2025 · Fixed spamming errors on trading! · Added a catch for an unidentified error.2.23.8-250712Shopkeepers Addon 2.23.8-250712Jul 12, 2025 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 item2.23.8-250706Bug FixesJul 6, 2025 · Fixed Shift click trading · Fixed Double click bug on trade · Added comptabibility with old trades2.23.8-250701Complete RewriteJul 1, 2025 · Compatible with Shopkeepers 2.23.8 · Updated for latest Minecraft version, 1.21.7. · You will need to regenerate config folder.2.23.3.2Custom Model Data & Shift ClickFeb 13, 2025 · 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 Protocolib2.23.3.1Update to 1.21.4Dec 22, 2024 · Updated to shopkeepers v2.23.3 · Now supports 1.21.42.23.0.4Oct 15, 2024 2.23.0.3Performance improvements and more.Sep 28, 2024 · 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"2.23.0.2PaperMC's Gameprofile Reflections patchSep 25, 2024 · Updated PaperMC's reflection deprecation for player Game profiles. Spigot still works the same. · Added Offline and Online UUID Caching in separate files.2.23.0.1Complete RecodeSep 21, 2024 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.YMLv2.17No Update. Only version fixingSep 4, 2024 No Update. Only version fixing21.0.2Minor Bug fixAug 9, 2024 Fixed issue with trading21.0.1Update for 1.21 & Bug fixesAug 9, 2024 - Fixed Major bug for duped items on economy - Fixed itemstack issue on economy menu2.12Minor PatchesJun 11, 2022 Minor messages changed and code cleaned.2.11Final Dupe Fix.Jun 11, 2022 No matter how much i try, there always seems to be a new kind of dupe. This should fix it all.2.10Another dupe fixedJun 10, 2022 Dupe fixed for plugin inventory slot 0 and 1.2.9Big Bug Smashed - Fixed Money DupeJun 9, 2022 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.2.8Refractor UpdateMay 3, 2022 - Had an issue with refractor misspelled.v2.8Bug Fix + Refractor + API ChangesMay 3, 2022 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 API2.7Updated for 2.15.1May 2, 2022 Added some small patches for Shopkeepers 2.15.1v2.6.2DupeFix:-Jan 20, 2022 fixed a dupev2.6.1Fixed bug related to custommodel dataJan 14, 2022 Fixed bug related to custommodel datav2.6Added CustomModelData support for currency ItemJan 14, 2022 Added CustomModelData support for currency Item in messages.yml Note(will only apply for new trades)v2.5BugFix:-Jan 8, 2022 -Fixed nullpointer exception if shopkeeper location is nullv2.4Bug Fix:-Jan 7, 2022 Fixed Gui items dupe issuev2.3Added Features:-Jan 5, 2022 - 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.shopv2.2Bug fix:-Jan 4, 2022 fixed nullpointer exception on buying items with currency itemv2.1Bug Fixes:-Jan 1, 2022 - 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.v2.0Dec 31, 2021 v1.3[1.16 - 1.18] Shopkeepers Addon | Navigation | Teleport to shop - Plotsquared IntegrationDec 16, 2021 added permissions: · SNA.command.shops: description: shops default: op · SNA.teleport: description: teleport on click default: op · SNA.command.help: description: show help message. default: op · SNA.admin: description: allows reload command. default: op added commands · /sna shops · /sna reload · /sna helpv1.2[1.16 - 1.18] Shopkeepers Addon | Navigation | Teleport to shop - Plotsquared IntegrationDec 16, 2021 fixed a typo in configv1.1[1.16 - 1.18] Shopkeepers Addon | Navigation | Teleport to shop - Plotsquared IntegrationDec 16, 2021 - changed primary command to /shops. - changed primary permission to /SNA.command.shops.v1.0Dec 15, 2021
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
26.2MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.9MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
4.7MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta