Shards v1.0

✦ AirCore-Shards
A fully configurable server currency plugin with GUI shop, leaderboard, PlaceholderAPI & public API

Paper • Purpur • Folia • Spigot • Java 8+ • MC 1.8–1.21+ • SQLite • PlaceholderAPI

---

✦ Features

• Fully configurable — Custom currency name, symbol, command alias, messages, and hex colors from config.yml
• GUI Leaderboard — Real player heads, gold/silver/bronze medals for top 3, async cached refresh, glass border layout
• GUI Shop — Edit shop.yml freely, supports GIVE_ITEM and COMMAND actions, rapid-click bulk buying system
• SQLite Database — WAL-mode SQLite with in-memory cache. Persistent balances, zero setup required
• PlaceholderAPI — 5 ready-to-use placeholders for scoreboards, holograms, and chat plugins
• Auto Config Migration — Update the plugin and new config keys are added automatically, your settings are never lost
• Folia Compatible — Detects Folia at runtime and routes tasks to the correct regional scheduler automatically
• Hex Color Support — Full &#RRGGBB support on 1.16+ via reflection. Graceful fallback on older versions
• Public Developer API — ShardsAPI registered on Bukkit ServicesManager so any plugin can hook in cleanly

---

✦ Commands

---

✦ PlaceholderAPI Placeholders

• %aircore_shards_balance% — Balance with comma formatting (e.g. 1,000)
• %aircore_shards_balance_raw% — Raw numeric balance (e.g. 1000)
• %aircore_shards_currency% — Currency name singular (e.g. Shard)
• %aircore_shards_currency_plural% — Currency name plural (e.g. Shards)
• %aircore_shards_rank% — Player's leaderboard rank position

---

✦ Developer API


// Hook into AirCore-Shards from any plugin
ShardsAPI api = ShardsAPIProvider.getAPI();
if (api != null) {
long balance = api.getBalance(player.getUniqueId());
api.addBalance(player.getUniqueId(), 500L);
api.removeBalance(player.getUniqueId(), 100L);
boolean ok = api.transfer(fromUUID, toUUID, 250L);
api.setBalance(uuid, 1000L);
}


Add to your plugin.yml: softdepend: [AirCore-Shards]

---

✦ Get a Free License Key