NickezShards Plugin

# NickezShards

**NickezShards** is a lightweight, feature-rich custom currency plugin built for modern Paper/Purpur servers (supporting Java 21). Reward your players, set up immersive AFK zones with Multiverse-Core support, and let them spend their hard-earned shards on custom vanilla entity spawners through a fully customizable GUI shop!

---

## ✨ Features

* **Custom Shard Currency:** Tracks player balances securely with auto-saving data.
* **Formatted Balances:** Automatically converts numbers into clean formats (e.g., `1.23k`, `1.45M`, `2.1B`).
* **Advanced AFK Zone System:** Region-bound reward zones using coordinate positions (`pos1` & `pos2`) with title notifications and Multiverse-Core compatibility.
* **Custom Shard Shop GUI:** Fully configurable GUI shop supporting all vanilla entity mob spawners (Pig, Zombie, Iron Golem, etc.).
* **PlaceholderAPI Support:** Fully integrated placeholders for scoreboard, chat, and tablist plugins.
* **Live Reloading:** Use `/adminshard reload` to apply configuration updates to `config.yml` and `shop.yml` instantly without restarting your server.

---

## Commands & Permissions

| Command | Description | Permission |
| :--- | :--- | :--- |
| `/shard` | Check your current shard balance (and formatted view). | *None (Everyone)* |
| `/shardshop` | Open the custom shard shop GUI. | *None (Everyone)* |
| `/afkzone` | Teleport to the AFK zone spawn and begin earning shards. | *None (Everyone)* |
| `/afkzone leave` | Leave the AFK zone session and teleport to the leave spawn. | *None (Everyone)* |
| `/adminshard reload` | Reloads `config.yml`, `shop.yml`, and AFK settings. | `nickezshards.admin` |
| `/adminshard shardbalancesee <player>` | Check another player's shard balance. | `nickezshards.admin` |
| `/adminshard giveshards <player> <amount>` | Give shards to a specific player. | `nickezshards.admin` |
| `/adminshard setshards <player> <amount>` | Set a player's exact shard balance. | `nickezshards.admin` |
| `/adminshard resetshards <player>` | Reset a player's shard balance to zero. | `nickezshards.admin` |
| `/afkzone set spawn` | Set the entry spawn point for the AFK zone. | `nickezshards.admin` |
| `/afkzone setleavespawn` | Set the exit/leave teleport location for the AFK zone. | `nickezshards.admin` |
| `/afkzone setarea pos1` | Set the first boundary corner of the AFK zone area. | `nickezshards.admin` |
| `/afkzone setarea pos2` | Set the second boundary corner of the AFK zone area. | `nickezshards.admin` |

---

## Placeholders (PlaceholderAPI)

To use these, make sure **PlaceholderAPI** is installed on your server:

* `%shards_balance%` — Returns the raw numeric shard balance (e.g., `1500.5`).
* `%shards_balance_formatted%` — Returns the formatted shorthand balance (e.g., `1.5k`).

---

## ⚙️ Default Configurations

### `config.yml`
```yaml
afk-reward-message: "&aYou have Received 1 shards For being Afk!"
afk-interval-seconds: 60