Плагин GreatKitsReloaded [1.12-1.21.x] - Плагин на наборы - Сохрани и загрузи инвентарь командой 3.1.1

KitsAPI api = GKReloaded.getAPI();

KitsAPI api = GKReloaded.getAPI();
if (api.canClaim(player, "starter")) {
    api.giveKit(player, "starter", true, true);
    player.sendMessage("§aВы успешно получили старт кит!");
} else {
    player.sendMessage("§cВы не можете получить кит!");
}

long remain = GKReloaded.getAPI().getRemainingCooldown(player.getUniqueId(), "starter");
if (remain > 0) {
    player.sendMessage("§eДо получения осталось " + (remain / 1000) + " секунд.");
}

for (Kit kit : GKReloaded.getAPI().getKits()) {
    Bukkit.getLogger().info("Загружен кит: " + kit.getName());
}

/**
* <h2>KitsAPI</h2>
* <p>
*     Основной интерфейс для взаимодействия с плагином GreatKitsReloaded.
*     Проверка доступа к китам, задержки и т.д
* </p>
*
* <h3>Пример использования:</h3>
* <pre>{@code
* KitsAPI api = Kits.getAPI();
* Kit kit = api.getKit("start");
*
* if (api.canClaim(player, "starter")) {
*     api.giveKit(player, "starter", true, true);
* }
* }</pre>
*
* @author 6ex9one
* @version 1.2
*/
public interface KitsAPI {

    /**
     * Получение идентификатора кита
     *
     * @param id идентификатор кита
     * @return обьект {@link Kit} или {@code null} если не найден
     */
    Kit getKit(String id);

    /**
     * Список доступных китов.
     *
     * @return возвращает список доступных китов
     */
    Collection<Kit> getKits();

    /**
     * Выдача комплекта указанному игроку.
     * <p>
     * Если для параметров {@code checkCooldown} и {@code checkOneTimeUse} установлен true,
     * то указанные наборы будут проверены перед выдачей.
     * </p>
     *
     * @param player игрок
     * @param id идентификатор кита
     * @param checkCooldown проверять ли задержку?
     * @param checkOneTimeUse проверить ли единоразовую выдачу?
     * @return {@code true} если кит успешно выдан, если нет то вернет {@code false}
     */
    boolean giveKit(Player player, String id, boolean checkCooldown, boolean checkOneTimeUse);

    /**
     * Проверка может ли игрок получить набор.
     * <p>
     * Этот метод учитывает единоразовую выдачу, задержку
     * </p>
     *
     * @param player игрок
     * @param id идентификатор
     * @return {@code true} если игрок может получить, если нет то {@code false}
     */
    boolean canClaim(Player player, String id);

    /**
     * Получение времени которое осталось до получения
     *
     * @param uuid идентификатор игрока
     * @param id идентификатор кита
     * @return возвращает кулдаун в миллисекундах, или {@code 0} если доступен
     */
    long getRemainingCooldown(UUID uuid, String id);

    /**
     * Сохранить изменения набора в YAML файл.
     *
     * @param id идентификатор набора
     */
    void saveKit(String id);

    /**
     * Удаление полностью данных о наборе.
     *
     * @param id идентификатор кита
     */
    void deleteKit(String id);
}

public interface Kit {

    /**
     * Возвращает название набора с цветами
     *
     * @return возвращает название набора
     */
    String getName();

    /**
     * Возвращает задержку в секундах
     *
     * @return время задержки
     */
    int getCooldown();

    /**
     * Проверка на единоразовую выдачу
     *
     * @return {@code true} если используется единоразовая выдача
     */
    boolean isOneTimeUse();

    /**
     * Проверка на выдачу набора при первом входе игрока.
     *
     * @return {@code true} если набор поддерживает выдачу
     */
    boolean isFirstTimeJoinKit();

    /**
     * Возвращает список предметов по слотам
     *
     * @return список предметов по слотам
     */
    Map<Integer, ItemStack> getItems();

    /**
     * Выдает предметы из набора игроку
     *
     * @param player игрок
     * @param dropFullInventory если {@code true}, предметы упадут на пол если в инвентаре нет места.
     */
    void give(Player player, boolean dropFullInventory);
}

public class ExamplePlugin extends JavaPlugin {

    private KitsAPI kits;

    @Override
    public void onEnable() {
        if (Bukkit.getPluginManager().getPlugin("GreatKitsReloaded") != null) {
            kits = GKReloaded.getAPI();
            getLogger().info("GreatKitsReloaded API успешно обнаружен!");
        } else {
            getLogger().warning("GreatKitsReloaded не найден. API выключен.");
        }
    }

    public void giveStartKit(Player player) {
        if (kits != null && kits.canClaim(player, "start")) {
            kits.giveKit(player, "start", true, true);
        }
    }
}