# 🌌 DarkCore Engine v1.1.0

## 📘 Обзор
DarkCore — это ультимативный фреймворк для разработки плагинов Minecraft (1.16.5+). Он предоставляет мощное и гибкое API, которое заменяет десятки разрозненных библиотек, объединяя их в одну стабильную экосистему.

---

## 🛠 Полный список API и примеры использования

### 1. 👥 Игроки и Данные (Player & Data)
* PlayerDataManager: Хранение статистики, уровней и рангов.
Пример:* api.getPlayerManager().setLevel(player, 50);
* SkinManager: Смена скинов без перезахода.
Пример:* api.getSkinManager().setSkin(player, "Notch");
* PermissionManager: Управление правами доступа.
Пример:* api.getPermissionManager().addPermission(player, "darkcore.admin");

### 2. 💰 Экономика (Economy)
* EconomyManager: Управление балансом.
Пример:* api.getEconomyManager().deposit(uuid, 500.0);

### 3. 💬 Чат и Сообщения (Chat & Messaging)
* CustomChatManager: Каналы (Global/Staff) и JSON-сообщения.
Пример:* api.getCustomChatManager().createChannel("staff", "[Staff] %m", "rank.staff");
* MessagingManager: Передача данных между серверами (Bungee/Velocity).
Пример:* api.getMessagingManager().broadcastToServers("Внимание: Техработы!");

### 4. 🌍 Мир и Сущности (World & Entities)
* NPCManager: Создание NPC со скинами и логикой.
Пример:* api.getNPCManager().spawnNPC("Торговец", location, "MerchantSkin");
* BossManager: Сложные боссы с фазами и кастомным HP.
Пример:* api.getBossManager().spawnBoss("WitherLord", loc, 1000.0, 20.0);
* HologramManager: Текстовые голограммы.
Пример:* api.getHologramManager().createHologram(loc, Arrays.asList("§6Добро пожаловать!", "§eНажмите для входа"));

### 5. ⚔ Боевая система (Combat)
* CombatManager: Combat Tag (защита от выхода из боя).
Пример:* if(api.getCombatManager().isInCombat(player)) { ... }

### 6. 🎒 Предметы и Инвентарь (Items & Inventory)
* CustomItemManager: Предметы с уникальными ID и NBT.
Пример:* ItemStack sword = api.getCustomItemManager().createCustomItem("VOID_SWORD");
* InventoryManager: Массовое управление предметами.
Пример:* api.getInventoryManager().fillInventory(player, item);

### 7. 🎨 Интерфейс (UI)
* GUIManager: Создание интерактивных меню.
Пример:* Inventory inv = api.getGUIManager().createGUI("Магазин", 3);
* ScoreboardManager & TabListManager: Управление боковыми панелями и табом.

### 8. 🧪 Системные и RPG API
* AttributeManager: Кастомные статы (Криты, Мана, Вампиризм).
* PlaceholderManager: Свои переменные (например, %darkcore_balance%).
* PetManager: Система питомцев-спутников.
* ModuleManager: Регистрация ваших плагинов как модулей ядра.

### 9. 🛠 Утилиты для разработчиков (Utilities)
* VisualEffectManager: Создание линий из частиц, кругов и цветных эффектов.
* MathUtility: Расчеты векторов, дистанций и проверка нахождения в области.
* JsonStorage: Быстрое сохранение и загрузка любых Java-объектов в формате JSON.

### 10. 🗄 Базы данных (Database API)
* DatabaseManager: Мощное асинхронное API для работы с MySQL и SQL.
* Поддержка пула соединений.
* Асинхронные запросы (CompletableFuture).
* Удобный маппинг строк (DatabaseRowMapper).
Пример: api.getDatabaseManager().executeQueryAsync("SELECT FROM users", rs -> rs.getString("name"));

---

## 🚀 Установка через JitPack
Добавьте в pom.xml:
xml

<dependencies>

    <dependency>

        <groupId>com.github.animesao</groupId>

        <artifactId>darkcore</artifactId>

        <version>1.1.0</version>

    </dependency>

</dependencies>


## 💡 Как начать?
В главном классе вашего плагина получите экземпляр API:
java

ICoreAPI api = DarkCoreMain.getInstance().getApi();

И используйте любой менеджер! Все методы возвращают IResult<T>, что гарантирует безопасность вашего кода.

---

## 📞 Контакты и Поддержка
Если у вас есть вопросы, предложения или вам нужна помощь в разработке плагинов на базе DarkCore, посетите наш официальный сайт:
👉 Alfheim Guide: alfheimguide.spcfy.eu
👉 GitHub: github.com/animesao/darkcore

Там вы сможете пообщаться с автором и получить актуальную информацию по развитию движка.