Перейти к содержимому
Mineforgian

Shopkeepers Addon

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

Загрузки
58K
Подписчики
44
Обновлён
30 марта 2026 г.
Лицензия
MIT

Опубликован 22 декабря 2024 г.

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

Feature Description Status
💰 Advanced Economy Vault integration with custom price formatting
🎯 Smart GUI Intuitive menus for shop browsing
👥 Player Shops Complete player shop management system
Bulk Trading Optimized performance for mass trades
🌍 Multi-Currency Custom 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?

Aspect Benefit
Performance Async processing & bulk trade optimization
Customization Complete control over economy formatting
User Experience Beautiful, intuitive GUI interfaces
Reliability Regular updates & active support
Compatibility Works 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


Ченджлог

2.26.0-260330Релиз1.21.9, 1.21.10, 1.21.11 · 30 марта 2026 г.

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Релиз1.21.9, 1.21.10, 1.21.11 · 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-260211Релиз1.21.9, 1.21.10, 1.21.11 · 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-250927Бета1.21.9, 1.21.10, 1.21.11 · 27 сентября 2025 г.

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Бета1.21.6, 1.21.7, 1.21.8 · 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:
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Релиз1.21.6, 1.21.7, 1.21.8 · 1 августа 2025 г.
  • Fixed! Stack selling bug. Even on selling less than 1 stack, plugin gave full stack money when shift click trading.
2.23.9.5Релиз1.21.6, 1.21.7, 1.21.8 · 23 июля 2025 г.
  • Fixed! New items not appearing in admin trades.
  • Fixed! Blacklisting items was not working.
2.23.9.4Релиз1.21.6, 1.21.7, 1.21.8 · 22 июля 2025 г.
  • Fixed! Error on new item in shopkeeper.

Комментарии

Загружаем…