BuyShards

BuyShards

An addon for UltimateDonutSMP that lets players buy shards with in-game money through a simple menu.

Players type /buyshards, click a package, and the price is taken from their balance. By default, 1,000 money buys 100 shards.

Features

• /buyshards opens a clean chest menu with shard packages
• Fully configurable price (default: 1,000 money per 100 shards)
• Configurable packages: amount, icon and slot for each button
• Shows the player's balance in the menu and refreshes after every purchase
• Automatic refund if shards could not be delivered
• Every message, the menu title and the item names/lore are editable (& colour codes)
• /buyshards reload to apply config changes without a restart

Requirements

• Paper 26.2
• UltimateDonutSMP 1.5.1
• Vault (or VaultUnlocked)

Commands & permissions

Command · Permission · Default
/buyshards · buyshards.use · Everyone
/buyshards reload · buyshards.reload · Operators

Setup

1. Put BuyShards.jar and Vault in your plugins folder.
2. Restart the server.
3. Open plugins/BuyShards/config.yml and set give-command to the console command your server uses to give shards. %player% is the buyer and %amount% is the number of shards.

money-per-100-shards: 1000
give-command: "addshards %player% %amount%"

Cost of a package = amount ÷ 100 × money-per-100-shards, so 500 shards cost 5,000.

Important

Money is taken through Vault. Shards are given by running the console command from give-command. Test that command from the console before opening the shop to players. If it fails, the buyer is refunded automatically and a warning is logged.

Disclaimer

BuyShards is an unofficial community addon and is not made by or affiliated with the UltimateDonutSMP developer.