Shopkeepers Addon 图标

Minecraft 服务端插件

Shopkeepers Addon

Navigation & Economy » No more searching the shopkeepers marketplace to buy your favorite items.

经济类管理类工具类bukkitpaperpurpurspigot
版本范围
1.16–1.21.11
下载量
6.0 万

插件介绍

ShopkeepersAddon - Economy & GUI Navigation Shopkeepers

banner

🚀 Transform Your Server's Economy!

Credits: Major Credits go to blablubbabc for making the amazing Shopkeepers plugin.

Disclaimer: This plugin is NOT a full shopkeepers plugin, this ONLY adds additional features to the parent plugin. If you are using Shopkeepers then this plugin shall add sorting and easier navigation to the shopkeepers.

ShopkeepersAddon supercharges the popular Shopkeepers plugin with advanced economy features, beautiful GUI navigation, and powerful player shop management!


Features Overview

FeatureDescriptionStatus
💰 Advanced EconomyVault integration with custom price formatting
🎯 Smart GUIIntuitive menus for shop browsing
👥 Player ShopsComplete player shop management system
Bulk TradingOptimized performance for mass trades
🌍 Multi-CurrencyCustom symbols and international formats

📚 Documentation & Guides

🔧 Setup & Configuration

🎮 User Guides

👥 Shop Management


🎯 Quick Links

📥 Download

💬 Community & Support

🔧 Developer Resources


🚀 Get Started Now!

Prerequisites

Installation

  1. Download the latest JAR from Releases
  2. Place in your plugins folder
  3. Restart your server
  4. Configure via config.yml
  5. Use /shops to open the menu!

🏆 Why Choose ShopkeepersAddon?

AspectBenefit
PerformanceAsync processing & bulk trade optimization
CustomizationComplete control over economy formatting
User ExperienceBeautiful, intuitive GUI interfaces
ReliabilityRegular updates & active support
CompatibilityWorks with all Vault economy plugins

📊 Plugin Statistics

  • ✅ 100% Shopkeepers Compatible
  • ⚡ Handles 1000+ Shops Efficiently
  • 🌍 Supports International Number Formats
  • 🔧 Highly Configurable & Modular

🤝 Support the Project

Love ShopkeepersAddon? Here's how you can help:

  • Star the GitHub Repository
  • 📝 Leave a Review on SpigotMC/Modrinth
  • 🔄 Share with other server owners
  • 💖 Donate to support development

📞 Contact & Links


版本与下载

推荐下载

ShopkeepersAddon-2.26.0-260330.jar版本 2.26.0-260330 · 101.1 KBSHA-1 d4543c5f4b7fab2247ac45e59c64d4aa7913d216下载 ShopkeepersAddon-2.26.0-260330.jar

2.26.0-260330

正式版
加载器
bukkit · paper · purpur · spigot
MC 版本
1.20.6 · 1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11
ShopkeepersAddon-2.26.0-260330.jar101.1 KBSHA-1 d4543c5f4b7fab2247ac45e59c64d4aa7913d216获取文件 ShopkeepersAddon-2.26.0-260330.jar
展开更新日志

Daily Limit Update:

  1. Modularized Daily Limit Messages: Updated config.yml (v1.6) and the Java logic to support a more flexible messaging system.
  2. %remaining% Placeholder: Players can now see exactly how much more they can earn today directly in the limit alert message.
  3. 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.
  4. 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-260212

正式版
加载器
bukkit · paper · purpur · spigot
MC 版本
1.20.6 · 1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11
ShopkeepersAddon-2.25.0-260212.jar98.3 KBSHA-1 6604cc57b306ce2bbf41f4dbbe9315baafd2e566获取文件 ShopkeepersAddon-2.25.0-260212.jar
展开更新日志

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-260211

正式版
加载器
bukkit · paper · purpur · spigot
MC 版本
1.20.6 · 1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11
ShopkeepersAddon-2.25.0-260211.jar104 KBSHA-1 90a60396c7fc7adc0b1e20d0b141f4f6d47adabb获取文件 ShopkeepersAddon-2.25.0-260211.jar
展开更新日志

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-250927

测试版
加载器
paper · purpur · spigot
MC 版本
1.20.6 · 1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11
ShopkeepersAddon-2.23.10.2-250927.jar95.3 KBSHA-1 5c8733499c2b8479e2cdf9f81675a243c492aa05获取文件 ShopkeepersAddon-2.23.10.2-250927.jar
展开更新日志

Changelog

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

2.23.10.2

测试版
加载器
paper · purpur · spigot
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8
ShopkeepersAddon-2.23.10.2-250926.jar95.6 KBSHA-1 4e1fbdf2c407eb8f8b47a37944fd1ec24ee41a50获取文件 ShopkeepersAddon-2.23.10.2-250926.jar
展开更新日志

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:
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:
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

2.23.10.1

正式版
加载器
spigot
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8
ShopkeepersAddon-v2.23.10.1.jar81.5 KBSHA-1 5fb29d36a94f0aed0d206c99d2508c98e67de081获取文件 ShopkeepersAddon-v2.23.10.1.jar
展开更新日志
  • Fixed! Stack selling bug. Even on selling less than 1 stack, plugin gave full stack money when shift click trading.

2.23.9.5

正式版
加载器
spigot
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8
ShopkeepersAddon-v2.23.9.5.jar81.1 KBSHA-1 2be2abf0105bff5c5861e243210c368ab399bb56获取文件 ShopkeepersAddon-v2.23.9.5.jar
展开更新日志
  • Fixed! New items not appearing in admin trades.
  • Fixed! Blacklisting items was not working.

2.23.9.4

正式版
加载器
spigot
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8
ShopkeepersAddon-v2.23.9.4.jar81 KBSHA-1 0ec224947fe5c791915ec8d9fa4290f69abbf501获取文件 ShopkeepersAddon-v2.23.9.4.jar
展开更新日志
  • Fixed! Error on new item in shopkeeper.

2.23.9.3

正式版
加载器
spigot
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8
ShopkeepersAddon-v2.23.9.3.jar81 KBSHA-1 f2e7dd13ee2c34b1bc19203c4da043a62c6c639a获取文件 ShopkeepersAddon-v2.23.9.3.jar
展开更新日志
  • NEW! Blacklist items in player shops!
  • Fixed! Error on empty trade selection.

Add the following to your config.yml:

playerShops:
  # Blacklist items that cannot be sold in player shops
  itemBlacklist:
    - BEDROCK
messages:
  blacklistedItem: "§cThis item is blacklisted and cannot be sold in player shops."

2.23.9.2

测试版
加载器
spigot
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8
ShopkeepersAddon-v2.23.9.2.jar82.3 KBSHA-1 3002d1289017897efec0b1237f2a16d42750e6bd获取文件 ShopkeepersAddon-v2.23.9.2.jar
展开更新日志
  • 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.1

测试版
加载器
spigot
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8
ShopkeepersAddon-v2.23.9.1.jar82 KBSHA-1 6ef4651c6dce5d1a8ea187a5190247525437d3fa获取文件 ShopkeepersAddon-v2.23.9.1.jar
展开更新日志
  • Fixed trading multiplier money bug!
  • Fixed error on skin loading for Steve skinned players.

2.23.8

测试版
加载器
spigot
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7
ShopkeepersAddon-2.23.8-250713.jar81.5 KBSHA-1 5a52e9d2e9c970a4526bdb80d3b0049a3a7ea38c获取文件 ShopkeepersAddon-2.23.8-250713.jar
展开更新日志
  • Fixed spamming errors on trading!
  • Added a catch for an unidentified error.

2.23.8-250712

测试版
加载器
spigot
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7
ShopkeepersAddon-2.23.8-250712.jar81.4 KBSHA-1 1e5c048827d2a5c3455bdaf90b54e92b120e1a4f获取文件 ShopkeepersAddon-2.23.8-250712.jar
展开更新日志

FIXED!

  • Null pointer exception on creating/trading shops.

NEW!

  • Added Custom Model Data. If you are upgrading, add in config:
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

2.23.8-250706

正式版
加载器
spigot
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7
ShopkeepersAddon-2.23.8-250706.jar81.2 KBSHA-1 769fe8c4a20d0fad0ac9310a724bb1562cb681de获取文件 ShopkeepersAddon-2.23.8-250706.jar
展开更新日志
  • Fixed Shift click trading
  • Fixed Double click bug on trade
  • Added comptabibility with old trades

2.23.8

正式版
加载器
spigot
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6 · 1.21.7
ShopkeepersAddon-2.23.8-250701.jar80.9 KBSHA-1 c00e8e9a1cff85b7592fc1ff00ef724076425347获取文件 ShopkeepersAddon-2.23.8-250701.jar
展开更新日志

Complete Rewrite:

  • Compatible with Shopkeepers 2.23.8

2.23.3.2

正式版
加载器
spigot
MC 版本
1.16 · 1.16.1 · 1.16.2 · 1.16.3 · 1.16.4 · 1.16.5 · 1.17 · 1.17.1 · 1.18 · 1.18.1 · 1.18.2 · 1.19 · 1.19.1 · 1.19.2 · 1.19.3 · 1.19.4 · 1.20 · 1.20.1 · 1.20.2 · 1.20.3 · 1.20.4 · 1.20.5 · 1.20.6 · 1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4
ShopkeepersAddon-v2.23.3.2.jar53.8 KBSHA-1 3c14742d0ec10e55a5f486016a1d13b3afabdc23获取文件 ShopkeepersAddon-v2.23.3.2.jar
展开更新日志
  • 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

2.23.3.1

正式版
加载器
spigot
MC 版本
1.16.5 · 1.17 · 1.17.1 · 1.18 · 1.18.1 · 1.18.2 · 1.19 · 1.19.1 · 1.19.2 · 1.19.3 · 1.19.4 · 1.20 · 1.20.1 · 1.20.2 · 1.20.3 · 1.20.4 · 1.20.5 · 1.20.6 · 1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4
ShopkeepersAddon-v2.23.3.1.jar51.4 KBSHA-1 41e5aae89aa0cfdb34480e3183006832106289ef获取文件 ShopkeepersAddon-v2.23.3.1.jar
展开更新日志

Updated API for:

  • Shopkeepers PLugin v2.23.3
  • Spigot 1.21.4