shards api

The main entry point for all Shards API functionality.

---

Package

bg.pikz.shards.api.interfaces.ShardsAPI

---

Accessing ShardsAPI

import bg.pikz.shards.api.ShardsAPIProvider;
import bg.pikz.shards.api.interfaces.ShardsAPI;

ShardsAPI api = ShardsAPIProvider.getAPI();

---

Methods

getUserMap()

Gets a map of all users (by UUID) and their data.

Map<UUID, OfflineUserAPI> getUserMap()

Returns: Unmodifiable map of UUID to OfflineUserAPI

Example:

Map<UUID, OfflineUserAPI> users = api.getUserMap();
OfflineUserAPI user = users.get(player.getUniqueId());

---

getLeaderboardManager()

Gets the leaderboard manager.

LeaderboardAPI getLeaderboardManager()

Returns: LeaderboardAPI instance

---

getAfkManager()

Gets the AFK manager.

AFKManagerAPI getAfkManager()

Returns: AFKManagerAPI instance

---

getGenMultiplayer()

Gets the generation multiplier manager.

GenMultiplayerAPI getGenMultiplayer()

Returns: GenMultiplayerAPI instance

---

getKillMultiplayer()

Gets the kill multiplier manager.

KillMultiplayerAPI getKillMultiplayer()

Returns: KillMultiplayerAPI instance

---

getShopManager()

Gets the shop manager.

ShopAPI getShopManager()

Returns: ShopAPI instance

---

getVersion()

Gets the current plugin version.

String getVersion()

Returns: Version string (e.g., "2.3.9")

---

isFeatureEnabled(String feature)

Checks if a specific feature is enabled.

boolean isFeatureEnabled(String feature)

Parameters:

• feature - The feature name: "leaderboard", "shop", or "afk"

Returns: true if the feature is enabled

Example:

if (api.isFeatureEnabled("shop")) {
    api.getShopManager().openShop(player);
}

---

Complete Example

ShardsAPI api = ShardsAPIProvider.getAPI();

// Get plugin version
getLogger().info("Shards version: " + api.getVersion());

// Check features
if (api.isFeatureEnabled("shop")) {
    api.getShopManager().openShop(player);
}

if (api.isFeatureEnabled("leaderboard")) {
    api.getLeaderboardManager().open(player);
}

// Get player data
OfflineUserAPI user = api.getUserMap().get(player.getUniqueId());
if (user != null) {
    long balance = user.getShards();
}