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

Leaderboard Placeholders

Placeholder Description
%shards_value_1% 1st place player and their shards
%shards_value_2% 2nd place player and their shards
%shards_value_3% 3rd place player and their shards
%shards_value_4% 4th place player and their shards
%shards_value_5% 5th place player and their shards
%shards_value_6% 6th place player and their shards
%shards_value_7% 7th place player and their shards
%shards_value_8% 8th place player and their shards
%shards_value_9% 9th place player and their shards
%shards_value_10% 10th place player and their shards

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

Configuration
Example config.yml
# Default starting balance for new players
starting-balance: 0

# Maximum shards a player can hold (set to 0 for unlimited)
max-balance: 100000

# Shards earn rate - base shards per minute in AFK areas
shard-earn-rate: 10

# How often to save data (in seconds)
data-save-interval: 300

# Number formatting options
number-formatting:
hide-decimals-for-whole-numbers: true
use-comma-separators: true

# Leaderboard settings
leaderboard:
max-entries: 10
update-interval: 300

# Booster configurations
boosters:
"double-shards":
multiplier: 2.0
duration: 600
"triple-shards":
multiplier: 3.0
duration: 300
"quad-shards":
multiplier: 4.0
duration: 120

# Data storage settings
storage:
type: YAML

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)
  • Vault (for economy integration)

Support and Contact

• Author: GodXPro
• Discord: godxpro.exe