EcoShard Plugin

EcoShard is a lightweight, feature-rich Minecraft plugin designed to introduce a shard-based economy system with custom AFK zone rewards, top leaderboards, and full PlaceholderAPI support.

---

Key Features

• Shard Economy System: Fully customizable currency system (✦) with balance tracking and player-to-player transfer capabilities.

• Smart AFK Zone System: Set up dedicated AFK reward zones with region timers. Players see a live countdown when entering the zone and receive shards (e.g., 1 shard per minute, fully configurable).

• Multiple Earning Methods:

  • First Join Bonus: Automatically reward new players with shards upon their first join.
  • PvP Rewards: Earn shards by eliminating other players.
  • Playtime & AFK Rewards: Earn shards automatically by staying active or staying in the AFK zone.

• shop shard:

  you can buy spawner for shards to open shop do /shard

• Full File Control & Customization:

  • config.yml: Complete control over reward amounts, timers, and plugin settings.
  • messages_en.yml & messages_ar.yml: Full multi-language support (English & Arabic) with customizable messages.
  • data.yml: Safe and reliable local database storage for player balances and data.

• PlaceholderAPI Integration: Built-in support for scoreboards, holograms, and tablists.

• Integrated Shop GUI: Interactive chest interface allowing players to spend shards seamlessly.

• Top Leaderboards: Display top 8 wealthiest players dynamically via holograms or commands.

---

Commands & Permissions

Player Commands

• /shards — Check your current shard balance (✦).
• /shard — Open the main interactive Shard Shop GUI.
• /shards pay <player> <amount> — Transfer shards directly to another player.
• /shards top — Display the server's top 8 wealthiest players.
• /shards <player> — Check another player's shard balance.
• /afk — Teleport directly to the designated AFK reward zone.
• /shards help — Display the player help menu.

Admin Commands

• /sharda give <player> <amount> — Add shards to a player's balance.
• /sharda take <player> <amount> — Deduct shards from a player's balance.
• /sharda set <player> <amount> — Set a player's exact shard balance.
• /afk pos1 — Set the primary corner for the AFK zone region.
• /afk pos2 — Set the secondary corner for the AFK zone region.
• /afksetzone — Activate and define the selected AFK reward zone.
• /afksetspawn — Set the warp spawn point for /afk.
• /sharda reload — Reload configuration files and language settings.

---

PlaceholderAPI Placeholders

• %shard_balance% — Displays the player's current shard balance.
• %shard_balance_name_1% — Displays the top #1 player's name (Supports 1–8 for holograms).
• %shard_balance_amount_1% — Displays the top #1 player's shard count (Supports 1–8).

---

Compatibility

Minecraft Version:

• Java Edition 1.21.x
• java 21

Supported Platforms:

• Paper, Purpur, Spigot