Method Reference

public static PlumDeliveryAPI getInstance()

public ApiUser getUser(UUID uuid)

ApiUser user = api.getUser(player.getUniqueId());
int dailyMining = user.getPoints(DeliveryType.DAILY, "mining");

public Collection<ApiUser> getAllUsers()

Collection<ApiUser> users = api.getAllUsers();
for (ApiUser user : users) {
    getLogger().info("User: " + user.getUuid());
}

public void addPoints(UUID playerUuid, DeliveryType type, String category, int amount)

// Award 10 daily mining points
api.addPoints(player.getUniqueId(), DeliveryType.DAILY, "mining", 10);

public void removePoints(UUID playerUuid, DeliveryType type, String category, int amount)

// Remove 5 weekly fishing points as a penalty
api.removePoints(player.getUniqueId(), DeliveryType.WEEKLY, "fishing", 5);

public int getPoints(UUID playerUuid, DeliveryType type, String category)

int points = api.getPoints(player.getUniqueId(), DeliveryType.MONTHLY, "combat");
player.sendMessage("Monthly combat points: " + points);

public Collection<String> getAllCategories()

Collection<String> categories = api.getAllCategories();
categories.forEach(cat -> getLogger().info("Category: " + cat));

public boolean isDeliveryRunning(DeliveryType type)

if (api.isDeliveryRunning(DeliveryType.DAILY)) {
    player.sendMessage("The daily delivery is active!");
}

public boolean isDeliveryEnabled(DeliveryType type)

if (api.isDeliveryEnabled(DeliveryType.WEEKLY)) {
    // Weekly deliveries are configured
}

public long getRemainingTime(DeliveryType type)

public String getFormattedRemainingTime(DeliveryType type)

String timeLeft = api.getFormattedRemainingTime(DeliveryType.DAILY);
player.sendMessage("Time remaining: " + timeLeft);

public Set<String> getCategories()

public ApiCategory getCategory(String name)

ApiCategory category = api.getCategory("mining");
if (category != null) {
    player.sendMessage("Category: " + category.getDisplayName());
}

public UUID getUuid()

public int getPoints(DeliveryType type, String category)

public void addPoints(DeliveryType type, String category, int amount)

public void removePoints(DeliveryType type, String category, int amount)

public int getCurrentGoal(DeliveryType type, String category)

public Map<String, Integer> getAllPoints()

public Map<String, Integer> getAllGoals()

public void save()

ApiUser user = api.getUser(player.getUniqueId());
user.addPoints(DeliveryType.DAILY, "mining", 10);
user.save(); // Don't forget this!

public String getKey()

public String getDisplayName()

public Map<String, String> getRequiredObjects()

ApiCategory category = api.getCategory("mining");
if (category != null) {
    Map<String, String> objects = category.getRequiredObjects();
    for (Map.Entry<String, String> entry : objects.entrySet()) {
        getLogger().info("Type: " + entry.getKey() + " → Action: " + entry.getValue());
    }
}

public String getKey()

public String getDisplayName()

public static DeliveryType fromString(String key)

DeliveryType type = DeliveryType.fromString("weekly");
// type == DeliveryType.WEEKLY

import net.plumstudio.plumdelivery.api.PlumDeliveryAPI;
import net.plumstudio.plumdelivery.api.ApiUser;
import net.plumstudio.plumdelivery.api.ApiCategory;
import net.plumstudio.plumdelivery.model.DeliveryType;
import org.bukkit.Bukkit;
import org.bukkit.entity.Player;
import org.bukkit.command.Command;
import org.bukkit.command.CommandSender;
import org.bukkit.plugin.java.JavaPlugin;

public class DeliveryStatsPlugin extends JavaPlugin {

    @Override
    public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
        if (!(sender instanceof Player player)) return false;
        if (!command.getName().equalsIgnoreCase("deliverystats")) return false;

        PlumDeliveryAPI api = PlumDeliveryAPI.getInstance();
        if (api == null) {
            player.sendMessage("§cPlumDelivery is not loaded!");
            return true;
        }

        ApiUser user = api.getUser(player.getUniqueId());

        player.sendMessage("§6§l━━━ Your Delivery Stats ━━━");

        for (String categoryKey : api.getCategories()) {
            ApiCategory category = api.getCategory(categoryKey);
            String name = category != null ? category.getDisplayName() : categoryKey;

            for (DeliveryType type : DeliveryType.values()) {
                int points = user.getPoints(type, categoryKey);
                int goal = user.getCurrentGoal(type, categoryKey);
                String status = points >= goal ? "§a✔" : "§c✘";

                player.sendMessage(String.format(
                    "  §e%s §7[%s§7] §f%d§7/§f%d %s",
                    name, type.getDisplayName(), points, goal, status
                ));
            }
        }

        // Show active delivery timers
        player.sendMessage("§6§l━━━ Active Deliveries ━━━");
        for (DeliveryType type : DeliveryType.values()) {
            if (api.isDeliveryRunning(type)) {
                String time = api.getFormattedRemainingTime(type);
                player.sendMessage(String.format("  §a%s §7- §f%s remaining", type.getDisplayName(), time));
            } else {
                player.sendMessage(String.format("  §c%s §7- Not active", type.getDisplayName()));
            }
        }

        return true;
    }
}