🌌 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:

<dependencies>
    <dependency>
        <groupId>com.github.animesao</groupId>
        <artifactId>darkcore</artifactId>
        <version>1.1.0</version>
    </dependency>
</dependencies>

💡 Как начать?

В главном классе вашего плагина получите экземпляр API:

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

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

---

📞 Контакты и Поддержка

Если у вас есть вопросы, предложения или вам нужна помощь в разработке плагинов на базе DarkCore, посетите наш официальный сайт: 👉 Alfheim Guide

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

---

DarkCore Engine — Твоя основа для идеального сервера.