💎 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 reloadto apply configuration updates toconfig.ymlandshop.ymlinstantly 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
afk-reward-message: "&aYou have Received 1 shards For being Afk!"
afk-interval-seconds: 60
