All resources
Minecraft plugins

mcShardShop

Rotating ShardShop Plugin

A shop that lives in your world.










Changelog

v2.0.1

  • New: update checker. The console and admins are told when a new version is on BuiltByBit.
  • New: optional auto-download. Turn on updates.auto-download and new versions install on the next restart, with the old jar kept in plugins/mcShardShop/backup.
  • New updates section in config.yml for the check interval, notifications and auto-download. Missing keys use the defaults, so existing configs keep working.

v2.0.0

mcShardShop changelog

2.0.0


The whole plugin was rebuilt. No other plugins are needed anymore. Old balances, shop displays, items and settings import by themselves on the first start, and your old files are kept in plugins/mcShardShop/v1-backup.

New: stands
  • No DecentHolograms needed. Stands are built from Minecraft's own display entities, so the plugin now has zero required dependencies.
  • Smooth spin and bob. The client animates the item, so the server sends one small update a second instead of teleporting an entity every tick.
  • Rarity glow, particles and base block on every stand, all set per rarity.
  • Reveal animation: when the shop rotates, items shrink away and pop back as the new ones, one stand after another, with sound and sparks.
  • Sold-out look: the glow turns off and the text changes to SOLD OUT with a countdown.
  • Live details: look at a stand to see your own balance, and how much more you need, above the hotbar.
  • Left or right click both work, using a proper hitbox.
  • Crash safe: stand entities are never saved in the world, so a crash can't leave copies behind. They come back on their own when a chunk loads.
  • Info board with a live countdown, schedule and items left. Replaces the big hologram.

New: rotation
  • Rarities: Legendary, Epic, Rare and Common by default. Add your own, with weights, colors and guaranteed amounts.
  • Schedules: every X time, daily at a set time, or weekly on a set day, with time zone support.
  • Deals: random discounts on items each rotation.
  • No repeats: items stay away for a set number of rotations.
  • Always-on items that stay in every rotation.
  • Seasonal items that only appear between two dates.
  • Warnings at any times you list. In 1.x this option did nothing.
  • The shop fills itself as soon as items or stands are added. No more empty displays.
  • One item per stand: the stands you place decide how many items are on sale. Adding or deleting a stand updates the shop and the info board right away.

New: for players
  • Physical shop: items are only sold at the stands, and /shardshop warps players there. Set the warp with /shardshop admin setwarp or from the admin menu.
  • Quantity screen: click a stand, pick an amount, and see the total and your balance after the purchase, before paying.
  • Catalog and wishlist (/shardshop catalog): browse everything the shop can sell, filter by rarity, and get told when a wished item shows up, even if you were offline.
  • Claim box (/shardshop claim): items that don't fit wait here. Nothing is lost when an inventory is full.
  • Purchase history (/shardshop history).
  • Leaderboard menu with player heads, including offline players.

New: earning
Players had no way to earn shards in 1.x. Now they do:
  • Playtime with an AFK check.
  • Mob kills per mob type, with an hourly cap and no pay for spawner mobs.
  • Mining per block type, with an hourly cap. Ores placed by players pay nothing.
  • Daily reward with a streak (/shards daily).
  • Multipliers by permission. They must be given on purpose, so OPs don't get them automatically.
  • Vouchers: turn shards into a tradeable item with /shards withdraw. Each voucher works once, so copies are worthless.

New: for admins
  • Admin menu (/shardshop admin) for items, stands, the rotation and settings. No file editing needed.
  • Add items in one click: click any item in your inventory, or use /shardshop admin additem <price> [rarity]. Items from other plugins keep all their data.
  • Item editor: name, description, price, rarity, chance, stock, player limit, lifetime limit, commands, permission and more.
  • Rotation editor: swap any item on sale, or rotate on the spot.
  • Settings menu: schedule, deals, currency and stand effects, with no reload.
  • 18 starter items, so the shop works the moment it is installed.
  • Sell ranks and commands: items can run console commands, with or without giving an item.
  • Use any currency: the built-in shards, Vault or PlayerPoints.
  • Sales report (/shardshop admin stats [days]) and purchase lookup (/shardshop admin history <player>).
  • /shardshop admin warp <player> sends a player to the shop, for NPCs and other plugins.
  • Webhook alerts for rotations, purchases and sold-out items.
  • Storage: SQLite by default, or MySQL. All database work runs off the main thread.
  • More placeholders: offers, leaderboard, streak, totals, claims and more.
  • Developer API: ShardPurchaseEvent (can cancel or change the price) and ShardRotationEvent.
  • New look: menus size themselves to fit, center their items and share one style. Every player menu and message can be changed in menus.yml and messages.yml.
  • Colors: & codes, hex and MiniMessage gradients in every text field.
Fixed
  • Installing the plugin stopped every hopper on the server. 1.x cancelled all hopper transfers, not only its own.
  • Balances were only saved at shutdown, so a crash lost everything since the last restart. The auto-save option did nothing.
  • These options did nothing in 1.x, and all work now or were removed: auto-save, warning-times, max-balance, cooldown, allow-full-inventory, require-confirmation, enable-titles, enable-sounds, enable-actionbar, display-format, use-mysql, metrics, hologram animations.
  • Setting a rotation interval of 0 rotated the shop every minute. It is now a real off switch.
  • Items were lost when bought with a full inventory.
  • Changing the item on an existing shop item made a new copy and lost its name and price.
  • The item placed in the editor was destroyed instead of being returned to the admin.
  • The big hologram showed the nearest player's balance to everyone.
  • Balances near the number limit could overflow and drop to 0.
  • Item lists stopped at 54 items. They now have pages.
  • /shardshop admin give <player> with no amount caused an error.
  • /shards bal <player> from the console caused an error.
  • /shards give <name> could give shards to a name that never joined.
  • The no-permission and item-deleted messages showed "Message not found".
  • mcshardshop.use was never checked.
  • Every click on a stand wrote lines to the console.
  • /shards top left out players with the starting balance.
  • A purchase could go through on an item that had just rotated out.
  • Every purchase rebuilt every hologram and floating item.
  • Hoppers could pull in floating items.

Requirements
  • Paper 1.21.4 or newer, including 26.1 (or a Paper fork)
  • Java 21 or newer
  • Optional: Vault, PlayerPoints, PlaceholderAPI

mcShardShop










Full history on BuiltByBit

More from TechnoTech