CakeRegions API

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    compileOnly 'com.github.CakesStudio:CakeRegionsAPI:VERSION'
}

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.github.CakesStudio</groupId>
        <artifactId>CakeRegionsAPI</artifactId>
        <version>VERSION</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

name: MyAwesomeAddon
main: com.example.myaddon.MyAddon
version: 1.0.0
api-version: '2.0.3'       # Минимальная поддерживаемая версия CakeRegions API
folia-supported: true       # Поддержка серверов Folia
description: "Пример описания аддона"
authors: [ "Developer" ]
depend: []                  # Обязательные зависимости
soft-depend: []             # Необязательные зависимости

import dev.cakestudio.cakeregionsapi.addon.AbstractAddon;

public class MyAddon extends AbstractAddon {

    @Override
    protected void onEnable() {
        saveDefaultConfig(); // Конфиг сохранится в /plugins/CakeRegionsPlus/addons/MyAddon/
        registerListener(new MyListener());
        registerCommand(new MyCommand());
    }

    @Override
    protected void onDisable() {
        // Логика при выключении (сохранение данных и т.д.)
    }
}

// Сохранить дефолтный config.yml из ресурсов JAR
saveDefaultConfig();

// Прочитать значение
String value = getConfig().getString("my-key", "default");

// Перезагрузить конфиг с диска
reloadConfig();

// Сохранить текущее состояние конфига
saveConfig();

// Сохранить произвольный ресурс из JAR
saveResource("data/items.yml", false);

// Асинхронная задача
runTaskAsync(() -> {
    // Тяжелая логика в фоне
});

// Задача с задержкой (20 тиков = 1 секунда)
runTaskLaterAsync(() -> {
    // Выполнить через 1 секунду
}, 20L);

// Повторяющаяся задача (каждые 5 минут)
runTaskTimerAsync(() -> {
    // Периодическая логика
}, 0L, 20L * 60 * 5);

import dev.cakestudio.cakeregionsapi.CakeRegionsAPI;
import dev.cakestudio.cakeregionsapi.api.IRegionsAPI;

IRegionsAPI api = CakeRegionsAPI.getApi();

// Получить регион в определённой точке
Optional<IRegion> region = api.getRegionAt(location);

// Получить регион по ID
Optional<IRegion> region = api.getRegionById("abc-123");

// Проверить, защищена ли локация
boolean isProtected = api.isProtected(location);

// Проверить, может ли игрок строить в локации
boolean canBuild = api.canBuild(player, location);

// Получить все регионы игрока (создатель/владелец/участник)
List<IRegion> regions = api.getRegionsForPlayer(player);

// Получить регионы, где игрок — создатель
List<IRegion> created = api.getRegionsByCreator(player);

// Получить все регионы на сервере
Collection<IRegion> all = api.getAllRegions();

// Создать регион
Optional<IRegion> newRegion = api.createRegion(player, location, protectionBlock);

// Удалить регион
api.deleteRegion(region);

// Асинхронно удалить регион и сломать блок
api.deleteRegionAndBlockAsync("region-id", true);

// Телепортировать игрока к региону
api.teleportToRegion(player, region);

region.repair(50);         // Починить на 50 ед.
region.damage(10);         // Нанести урон 10 ед.
region.setDurability(100); // Установить прочность

region.addFuel(3600);      // Добавить топливо (в секундах)
region.setFuel(7200);      // Установить время топлива
region.removeFuel(600);    // Убрать топливо

region.isCreator(uuid);    // Создатель ли
region.isOwner(uuid);      // Совладелец ли
region.isMember(uuid);     // Участник ли
region.isFullMember(uuid); // Любая роль
region.canBuild(uuid);     // Может ли строить
String role = region.getRole(uuid); // Получить роль (например, "owner", "member")

region.setTag("custom_key", "custom_value"); // Установить значение
String value = region.getTag("custom_key");  // Получить значение
boolean hasTag = region.hasTag("custom_key");// Проверить существование
region.removeTag("custom_key");              // Удалить тег
Map<String, String> tags = region.getTags(); // Все теги (только для чтения)

// Добавить участника
api.addMember(region, target, false); // false = проверять лимиты

// Удалить участника
api.removeMember(region, target);

// Повысить до совладельца
api.addOwner(region, target, false);

// Понизить из совладельцев
api.removeOwner(region, target);

// Получить списки
List<OfflinePlayer> members = api.getRegionMembers(region);
List<OfflinePlayer> owners = api.getRegionOwners(region);
UUID creator = api.getRegionCreator(region);

IPlayerPermissions perms = api.getPlayerPermissions(region, player);

// Проверить право
boolean canAddMember = perms.hasPermission(RegionPermValue.ADD_MEMBER);

// Изменить права
perms.addPermission(RegionPermValue.ADD_FUEL);
perms.removePermission(RegionPermValue.MODIFY_PERMISSIONS);
perms.togglePermission(RegionPermValue.REMOVE_MEMBER);

// Сохранить изменения
region.setPermissions(player.getUniqueId(), perms);

// Получить тип блока по ID
Optional<IProtectionBlock> block = api.getProtectionBlock("diamond");

// Получить все зарегистрированные типы
Collection<IProtectionBlock> types = api.getProtectionBlockTypes();

// Проверить, включены ли голограммы
boolean enabled = api.isHologramEnabled();

// Создать/удалить/обновить голограмму для региона
api.createHologram(region);
api.deleteHologram(region);
api.updateHologram(region);

// Массовые операции
api.recreateAllHolograms();
api.updateAllHolograms();

// Проверить наличие
boolean has = api.hasHologram(region);

IEconomyManager economy = api.getEconomyManager();

// Получить баланс (дефолтная экономика)
double balance = economy.getBalance(player);

// Получить баланс в конкретной экономике
double xpBalance = economy.getBalance(player, "XP");

// Списать средства
if (economy.has(player, 500.0)) {
    economy.withdraw(player, 500.0);
}

// Пополнить
economy.deposit(player, 100.0);

// Форматировать
String formatted = economy.format(1500.0); // "1,500$"

import dev.cakestudio.cakeregionsapi.api.manager.economy.IEconomyProvider;

public class GemsEconomy implements IEconomyProvider {

    @Override
    public String getName() { return "Gems"; }

    @Override
    public double getBalance(OfflinePlayer player) { /* ... */ }

    @Override
    public boolean has(OfflinePlayer player, double amount) { /* ... */ }

    @Override
    public boolean withdraw(OfflinePlayer player, double amount) { /* ... */ }

    @Override
    public boolean deposit(OfflinePlayer player, double amount) { /* ... */ }

    @Override
    public String format(double amount) { return amount + " 💎"; }
}

// Регистрация
api.getEconomyManager().registerProvider(new GemsEconomy());

IItemHookManager itemHook = api.getItemHookManager();

// Получить ItemStack по строковому ID
ItemStack customItem = itemHook.getItem("oraxen:my_sword");

// Получить ID кастомного предмета из ItemStack
String itemId = itemHook.getItemId(customItem); // "oraxen:my_sword"

import dev.cakestudio.cakeregionsapi.api.manager.item.IItemHookProvider;

IItemHookProvider provider = new IItemHookProvider() {
    @Override
    public @Nullable ItemStack getItem(@NonNull String id) {
        if (id.equalsIgnoreCase("heavy_core")) {
            ItemStack core = new ItemStack(Material.NETHERITE_BLOCK);
            ItemMeta meta = core.getItemMeta();
            meta.setDisplayName("Heavy Protection Core");
            core.setItemMeta(meta);
            return core;
        }
        return null;
    }

    @Override
    public @Nullable String getItemId(@NonNull ItemStack item) {
        // Идентифицировать предмет
        return null;
    }

    @Override
    public @NonNull String getPrefix() {
        return "mycustomitems"; // Обрабатывает "mycustomitems:heavy_core"
    }
};

// Регистрация и удаление
itemHook.registerProvider(provider);
itemHook.unregisterProvider(provider);

IFuelManager fuelManager = api.getFuelManager();

// Найти тип топлива по предмету
Optional<IFuelType> fuelType = fuelManager.getFuelType(itemStack);

IRepairManager repairManager = api.getRepairManager();

// Найти ремонтный предмет
Optional<IRepairItem> repairItem = repairManager.getRepairItem(itemStack);

IActionManager actionManager = api.getActionManager();

// Выполнить действие для игрока
actionManager.executeActions(player, actionsList);

INotificationManager notificationManager = api.getNotificationManager();

// Отправить уведомление о рейде
notificationManager.sendRaidNotification(region, attackerEntity, RaidTrigger.BLOCK_BREAK);

IEffectsManager effectsManager = api.getEffectsManager();

// Показать эффект границы региона игроку
effectsManager.showBorder(player, region);

IMenuManager menuManager = api.getMenuManager();

// Открыть меню информации о регионе
menuManager.openRegionInfoMenu(player, region);

IStatsManager statsManager = api.getStatsManager();

// Получить количество рейдов игрока
int raidCount = statsManager.getPlayerRaidCount(playerId);

// Получить топ регионов по прочности
List<IRegion> topRegions = statsManager.getTopRegionsByDurability(10);

IRegionVisualizer visualizer = api.getRegionVisualizer();

// Показать границы региона игроку
visualizer.showBoundary(player, region);

// Скрыть границы
visualizer.hideBoundary(player);

// Проверить, включен ли боссбар топлива у игрока
boolean enabled = api.isPlayerFuelBarEnabled(player);

// Переключить боссбар топлива для игрока
api.setPlayerFuelBar(player, false);

// Получить уровень улучшения радиуса
int level = region.getRadiusUpgradeLevel();

// Установить уровень улучшения радиуса
region.setRadiusUpgradeLevel(3);

// Проверить, активен и включен ли бустер в регионе
boolean hasBooster = region.hasActiveBooster("crop_growth");

// Активировать временный бустер на 1 час (3600 секунд)
region.activateBooster("spawner_speed", 3600);

// Активировать перманентный бустер навсегда
region.activatePermanentBooster("no_fuel_decay");

// Проверить, включен ли бустер игроком
boolean enabled = region.isBoosterEnabled("crop_growth");

// Включить/выключить бустер игроком
region.setBoosterEnabled("crop_growth", false);

import dev.cakestudio.cakeregionsapi.api.event.RegionCreateEvent;
import dev.cakestudio.cakeregionsapi.api.event.RegionDestroyEvent;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;

public class MyListener implements Listener {

    @EventHandler
    public void onRegionCreate(RegionCreateEvent event) {
        String regionId = event.getRegion().getId();
        event.getPlayer().sendMessage("Регион " + regionId + " создан!");
    }

    @EventHandler
    public void onRegionDestroy(RegionDestroyEvent event) {
        if (event.getCause() == RegionDestroyEvent.DestroyCause.EXPLOSION) {
            event.setDropItem(false); // Не дропать предмет при взрыве
        }
    }
}

MyAddon/
├── build.gradle
├── src/main/
│   ├── java/com/example/myaddon/
│   │   ├── MyAddon.java
│   │   └── MyListener.java
│   └── resources/
│       ├── addon.yml
│       └── config.yml

plugins {
    id 'java'
    id "io.github.goooler.shadow" version "8.1.8"
}

repositories {
    mavenCentral()
    maven { url = 'https://repo.papermc.io/repository/maven-public/' }
    maven { url = 'https://jitpack.io/' }
    maven { url = 'https://repo.tcoded.com/releases' }
}

dependencies {
    compileOnly 'com.github.CakesStudio:CakeRegionsAPI:v2.0.3'
    compileOnly 'com.destroystokyo.paper:paper-api:1.16.5-R0.1-SNAPSHOT'
    compileOnly "com.tcoded:FoliaLib:0.5.1"
    compileOnly 'net.kyori:adventure-platform-bukkit:4.4.1'
    compileOnly 'net.kyori:adventure-text-minimessage:4.26.1'
}

java {
    toolchain.languageVersion = JavaLanguageVersion.of(17)
}

tasks.shadowJar {
    archiveFileName.set("MyAddon-${version}.jar")

    // Обязательная релокация!
    relocate 'net.kyori', 'dev.cakestudio.cakeregions.libs.kyori'
    relocate 'com.tcoded.folialib', 'dev.cakestudio.cakeregions.libs.folialib'
}

build.dependsOn shadowJar

import dev.cakestudio.cakeregionsapi.addon.AbstractAddon;

public class MyAddon extends AbstractAddon {

    @Override
    protected void onEnable() {
        saveDefaultConfig();
        getLogger().info("MyAddon v" + getDescription().version() + " enabled!");
        registerListener(new MyListener(this));
    }

    @Override
    protected void onDisable() {
        getLogger().info("MyAddon disabled.");
    }
}

name: MyAddon
main: com.example.myaddon.MyAddon
version: 1.0.0
api-version: '2.0.3'
folia-supported: true
description: "Аддон для CakeRegionsPlus"
authors: [ "Developer" ]