xShards - Ultimate Economy Shards Plugin (Deluxe Menus Support!)

A dynamic shard-based economy system for Minecraft servers with comprehensive booster mechanics and competitive leaderboards.

Features
Shard Economy System

• Virtual Currency: Fully functional economy system integrated with Vault.
• Persistent Storage: Player shard balances saved to disk.
• Configurable Starting Balance: Set default shards for new players.
• Maximum Balance Limit: Optional cap on maximum shards a player can hold.
• Automatic Shard Gain: Configurable base rate for passive shard earning.

Boosters

• Personal Boosters: Player-specific shard multipliers.
• Global Boosters: Server-wide shard multipliers for events.
• Stacking Multipliers: Personal and global boosters stack for maximum rewards.
• Configurable Duration: Set custom times for each booster type.
• Multiple Booster Types: Configure different multiplier strengths (2x, 3x, 4x, etc.).

Number Formatting

• Beautiful Display: Comma separators for large numbers (e.g., 1,000,000).
• Smart Decimals: Option to hide decimals for whole numbers.
• Hex Color Support: Full RGB color support for all messages.

Leaderboard System

• Top Players: Track the players with the highest shard balances.
• Configurable Size: Set how many players appear on the leaderboard.
• Automatic Updates: Refreshes at configurable intervals.
• PlaceholderAPI Support: Display leaderboard anywhere using placeholders.

Placeholders
Basic Placeholders

Placeholder Description
%xshards_balance% Displays player's formatted shard balance
%xshards_raw_balance% Shows unformatted shard balance
%xshards_formatted_balance% Shows shard balance with all formatting options

Booster Placeholders

Placeholder Description
%xshards_booster_multiplier% Player's active booster multiplier
%xshards_booster_count% Number of active boosters for the player
%xshards_global_booster_multiplier% Active global booster multiplier
%xshards_global_booster_count% Number of active global boosters
%xshards_total_multiplier% Total multiplier (player + global)
%xshards_has_booster% Returns "true" if player has active boosters

Commands
Player Commands

Command Permission Description
/shards Shows your shard balance shards.use
/shards help Displays help menu with available commands shards.use
/shards pay <player> <amount> Transfers shards to another player shards.pay
/shards booster Shows active shard boosters shards.booster

Admin Commands

Command Permission Description
/shards <player> Check another player's balance shards.admin
/shards set <player> <amount> Sets a player's shard balance shards.admin
/shards give <player> <amount> Gives shards to a player shards.admin
/shards give all <amount> Gives shards to all online players shards.admin
/shards take <player> <amount> Removes shards from a player shards.admin
/shards reset <player> Resets a player's balance to default shards.admin
/shards reset all confirm Resets ALL players' balances (requires confirmation) shards.admin
/shards reload Reloads plugin configuration shards.admin

Permissions

Permission Description
shards.use Allows players to check and use shards
shards.pay Allows players to transfer shards
shards.booster Grants access to activate shard boosters
shards.admin Grants access to all admin commands

DeluxeMenus Shop

Spoiler: DeluxeMenus Shop Example

shards_shop:
title: '&#AB00FF&lShards Shop'
open_command: shardsshop
size: 27
items:
zombie-spawner:
material: SPAWNER
slot: 10
display_name: '&#AB00FFZombie Spawner'
lore:
- ''
- '&#AB00FFᴅᴇѕᴄʀɪᴘᴛɪᴏɴ:'
- '&7Collect some shards and redeem'
- '&7awesome items and rewards!'
- ''
- '&fᴄᴏʟʟᴇᴄᴛ ᴘᴏɪɴᴛѕ ꜰʀᴏᴍ:'
- '&#AB00FF&n/ᴡᴀʀᴘ ᴀꜰᴋ'
- ''
- '&#AB00FF⛃ &fPrice: &#AB00FF50 Shards'
- '&#AB00FF➜ &fYour Shards: &#AB00FF%xshards_balance%'
- ''
- '&#AB00FF» Click to purchase'
click_requirement:
requirements:
check_balance:
type: '>='
input: '%xshards_balance%'
output: '50'
deny_commands:
- '[close]'
- '[message]'
- "[message] &#FF0000[✘] &#FF0000Insufficent Shards!"
- "[message] &#8C00FF[❤] Obtain AFK Shards @ /ᴡᴀʀᴘ ᴀꜰᴋ"
- '[message]'
click_commands:
- '[console] spawner give %player_name% zombie 1'
- '[console] shards take %player_name% 50'
- '[message]'
- '[message] &#8C00FF[✓] ʏᴏᴜ ѕᴜᴄᴄᴇѕѕꜰᴜʟʟʏ ʙᴏᴜɢʜᴛ &#AB00FFZombie Spawner'
- '[message]'
- '[close]'

Installation

1. Download the xShards.jar file.
2. Upload it to your server's plugins folder.
3. Restart your server.
4. Edit the config.yml file to customize the plugin.
5. Use /shards reload to apply changes.

Requirements

• Minecraft Version: 1.20.1 - 1.21.4
• Java: Java 17 or higher
• Soft Dependencies:
  • PlaceholderAPI (for placeholders)
  • DeluxeMenus (For Custom Shop)

Support and Contact

• Author: GodXPro
• Discord: godxpro.exe