UltimateShop

A powerful, flexible, and highly customizable shop plugin for modern Minecraft servers.

UltimateShop is an advanced shop framework for Spigot/Paper, built to combine the strongest ideas from premium shop plugins into one complete system.

It is designed for server owners who want more than a basic buy/sell GUI: from simple item shops to dynamic markets, rotating stores, reward systems, exchange systems, and fully custom trading logic.

Unlike traditional shop plugins, UltimateShop focuses on flexibility, compatibility, and deep configuration, letting you build the exact shop experience your server needs.

Features

Not Just a Shop — A Complete Transaction Engine

• UltimateShop is built around a flexible transaction model, not a fixed “pay money, receive item” workflow
• Each shop product can define its own products, buy prices, sell prices, actions, conditions, limits, display item, and amount-selection behavior
• A single transaction can involve items, currencies, permissions, placeholders, conditions, custom actions, and dynamic results
• Supports both buying and selling logic with separate price groups, reward groups, limits, conditions, and post-transaction actions
• Ideal for servers that need rotating markets, token exchanges, reward shops, limited offers, custom currencies, item-for-item trades, and complex economy systems

Flexible Price & Product System

• Products and prices are handled as independent configurable groups
• Supports ALL / ANY modes for both prices and products
• Use ALL mode when players must pay or receive everything in the group
• Use ANY mode to let the system choose one valid price or product option
• Supports classic static calculation and dynamic per-amount calculation
• Price rules can apply only at specific transaction counts or within specific buy/sell ranges
• Create advanced setups such as first purchase discounts, progressive price increases, stock-based pricing, random rewards, or multi-option payment methods.
• Each single price or product can also have its own apply conditions, require conditions, give actions, and take actions

Dynamic Market Pricing

• Prices and product amounts can be calculated from formulas, PlaceholderAPI values, and built-in transaction data
• Dynamic formulas can read player buy times, player sell times, server buy times, server sell times, total buy/sell counts, last transaction time, and last reset time
• Supports min/max amount protection to prevent extreme prices from breaking your economy
• Supports automatic price status display, such as price up, down, or unchanged
• Perfect for creating supply-and-demand markets, seasonal shops, limited-time offers, rank-based discounts, tax systems, and progressive shop scaling
• Premium: Supports dynamic status display which allows player see the price is down or up

Limits, Cooldowns & Reset System

• Supports separate buy limits and sell limits
• Supports both per-player limits and global server-wide limits.
• Tracks buy count, sell count, total buy count, total sell count, last buy time, last sell time, last reset time, and cooldown time.
• Supports shared use-times groups, allowing multiple products to share the same limit pool
• Reset modes include NEVER, TIMER, TIMED, CUSTOM, RANDOM_PLACEHOLDER, COOLDOWN_TIMER, COOLDOWN_TIMED, and COOLDOWN_CUSTOM
• Use it to create daily shops, weekly shops, hourly offers, cooldown-based products, global stock, personal purchase caps, and reset-driven rotating systems
• Premium: Supports custom reset time formats, and richer dynamic reset values
• Premium: Supports advanced cooldown reset logic such as randomly select 5 reset times from the 24 hourly points in a day

Advanced Item, Currency & Custom Plugin Support

• Supports vanilla items, custom-built items, matched items, hook items, vanilla economy, hook economy, placeholder-based custom values and more
• Direct item hooks include ItemsAdder, Oraxen, MMOItems, EcoItems, EcoArmor, MythicMobs, eco, NeigeItems, ExecutableItems, Nexo, and CraftEngine
• Direct economy hooks include Vault, PlayerPoints, CoinsEngine, ExcellentEconomy, UltraEconomy, EcoBits, PEconomy, RedisEconomy, RoyaleEconomy, and VotingPlugin
• Also supports vanilla EXP and level-based economy transactions.
• Can handle renamed, modified, enchanted, or plugin-generated items more flexibly than simple full-item comparison workflows

ItemFormat & Smart Item Handling

• Built-in item building supports detailed item generation through configuration
• Smart item giving can respect vanilla max stack size, reuse existing stacks, calculate required inventory space, and prevent unsafe overflow
• Supports custom display items, amount placeholders, display names, lore, and dynamic display output
• Sell logic can scan inventories and calculate the maximum sellable amount for Sell All workflows

Modern Menu System

• Fully configurable inventory GUI system with shop menus, common menus, product buttons, custom buttons, and amount-selection menus
• Menu layout supports product buttons, normal buttons, copied/sub buttons, and dynamic button selection
• Menus can have open conditions, open actions, close actions, custom commands, and dynamic layout behavior
• Supports automatic menu slot refresh after product interaction
• Supports Buy More, Sell All, quick buy, quick sell, sell hand, and sell all hand commands
• Premium: Support search product in search menu and allow text search or item match search
• Premium: Support player add product to favourite menu, and then quickly find the product in favourite menu without opening the related shop
• Premium: Dynamic layout, custom menu commands, favourite menus, search tools, sub-button systems, and GUI title updating

Java, Bedrock & Dialog UI Support

• Java players can use classic chest-style inventory menus
• Premium: Bedrock players can be routed to Form UI when Floodgate/Geyser support is enabled
• Premium: Modern Paper servers can use Dialog UI menus when supported
• The same shop system can serve different client experiences without rewriting the entire shop logic

Action & Condition Engine

• UltimateShop includes a real action and condition system for shops, products, buttons, prices, and products
• Actions include message, title, action bar, particle, sound, announcement, potion effect, console command, OP command, player command, close, back, teleport, entity spawn, MythicMobs spawn, open menu, shop menu, sell all menu, buy more menu, buy, sell, chance, delay, any, conditional, connect, update title, update GUI, prompt, and favourite actions
• Conditions include biome, menu, menu type, permission, placeholder, world, any, and not
• Actions can run once per transaction or once per item amount, and can be filtered by click type, transaction range, Bedrock/Java client type, and failure status

Built-in Placeholder System

• Supports PlaceholderAPI plus UltimateShop built-in placeholders
• Built-in placeholders include conditional, random, random-times, random-next, compare, math, cron, custom, and lang parsing
• Use placeholders in prices, product amounts, display names, lore, menu titles, messages, reset displays, and dynamic formulas
• Cron placeholders can calculate the next execution time from Quartz-style cron expressions
• Random and custom placeholders can be stored per player and used for rotating shops, random offers, and personalized shop states
• Premium: Random placeholder persistence, custom placeholder storage, advanced comparison display, and reset integration

Language, Display & Feedback System

• Supports legacy color codes, hex colors, gradient text PlaceholderAPI parsing, and built-in language placeholders
• Messages can be sent through multiple output styles, including chat message, title, action bar, boss bar, and sound
• Display items can show dynamic price, amount, limit, cooldown, refresh time, and transaction status
• Supports vanilla item name localization and sprite-based item name display on supported modern servers
• Premium: Per-player language display based on client locale and richer modern display behavior

Server Management Tools

• Includes commands for saving items, giving saved items, generating item formats, opening menus, quick buying, quick selling, sell hand, sell all hand, searching products, updating GUI, and updating GUI titles
• Provides commands to modify buy/sell usage data and manage random/custom placeholders
• Premium: Includes an in-game editor framework with preset fields for shops, menus, products, prices, actions, conditions, limits, click events, and reset settings
• Premium: Transaction logging

Database, Sync & Large Server Support

• Supports SQL storage with HikariCP connection pooling
• Database layer supports multiple dialects including MySQL, H2, PostgreSQL, and SQLite
• Stores use-times, favourites, random placeholders, custom placeholders, and transaction logs depending on enabled features
• Asynchronous database loading and saving helps reduce main-thread pressure
• BungeeCord sync support is built into use-times updates for multi-server setups

Sell Multiplier, Sell Stick, Sell Chest & Shulker-box Selling

• Support create unlimited sell multiplier with condition
• Supports fast selling through Sell All GUI, sell hand, sell all hand, quick sell, and shulker-box selling
• Sell All can calculate the maximum valid sell amount based on player inventory, item conditions, limits, and product mode.
• Premium: Sell Stick for container selling
• Premium: Sell Chest for automatic container selling, hologram display support
• Sell Stick and Sell Chest Protection hooks include WorldGuard, Residence, GriefPrevention, Lands, HuskTowns, HuskClaims, PlotSquared, Towny, BentoBox, Dominion, and SuperiorSkyblock2