C-erva Core

🧱 C-erva Core

Общая служебная библиотека для модов C-erva на Fabric. C-erva Core предоставляет набор общих строительных блоков — форматирование текста, помощники для регистрации, сеть, утилиты для инвентаря, права и многое другое — чтобы отдельные моды оставались маленькими и не изобретали велосипед. Напрямую этот мод не используется. Устанавливай его как зависимость, когда его требует другой мод (например, PhotoChat).

📦 Что внутри

💬 CervaText

Сообщения в чате с префиксом и единым стилем.

CervaText.success("MyMod", "Item given!");   // [MyMod] Item given!  (green)
CervaText.warning("MyMod", "Low durability"); // [MyMod] Low durability  (yellow)
CervaText.error("MyMod", "Not found");        // [MyMod] Not found  (red)

🏷️ CervaRegistry

Регистрация идентификаторов, предметов, блоков, звуков и типов сущностей в одну строку.

CervaRegistry.id("mymod", "ruby");
CervaRegistry.item("mymod", "ruby", new Item(settings));
CervaRegistry.sound("mymod", "ding");

🌐 CervaNetworking

Рассылка пользовательского пакета всем игрокам, у которых есть мод, с автоматическим текстовым запасным вариантом для остальных.

CervaNetworking.broadcastWithFallback(server, TYPE, payload, fallbackText);

🎒 CervaItems

Помощники для инвентаря — выдать предметы, выбросить стаки, посчитать слоты, проверить наличие места.

CervaItems.give(player, stack);         // give or drop if full
CervaItems.hasSpace(player, stack);     // check before giving
CervaItems.countItem(player, Items.DIAMOND);

🔐 CervaPermissions

Простые проверки прав для команд и игроков.

CervaPermissions.hasPermission(source, permission);

🌍 CervaWorld

Утилиты для мира и звуков.

CervaWorld.playSound(world, pos, soundEvent);
CervaWorld.isServerWorld(world);

⏱️ CervaCooldowns

Карта перезарядок по UUID + ключу с автоматическим истечением.

if (CervaCooldowns.isReady(player.getUuid(), "ability", 60)) {
    // 60-tick cooldown passed
}

🖼️ CervaTooltips (клиент)

Конструктор подсказок для описаний предметов.

CervaTooltips.builder()
    .line("Rare artifact", Formatting.GOLD)
    .line("+5 attack", Formatting.GREEN)
    .build(tooltip);

📁 CervaPaths

Разбор путей с поддержкой кавычек и пробелов — полезно для команд, принимающих пути к файлам.

📂 CervaFilePicker (клиент)

Нативный диалог выбора файлов ОС через TinyFD — диалоги открытия/сохранения с фильтрами по формату.

🛡️ CervaSafe

Быстрые проверки на клиентскую/серверную сторону, null world, null player — защита от частых крашей.

📋 Требования

• Minecraft 1.21.11
• Fabric Loader ≥ 0.19.3
• Fabric API
• Java 21+

⚙️ Для разработчиков модов

Добавь C-erva Core как зависимость в свой build.gradle:

modImplementation "com.andrewimm:cerva_core:1.2.91"

И в свой fabric.mod.json:

"depends": {
    "cerva_core": ">=1.2.91"
}

🔗 Моды, использующие C-erva Core

• PhotoChat — отправляй изображения прямо в чат Minecraft