CobbleLib

CobbleLib

Основная утилитарная библиотека для модов Cobblemon на NeoForge, предоставляющая виртуальную экономику (Cobbletokens), права, UI-фреймворк и хелперы для покемонов.

Требования

• Minecraft 1.21.1
• NeoForge 21.1.90+
• Cobblemon 1.7.2+
• Java 21+

Возможности

Экономика (Cobbletokens)

Простая система виртуальной валюты с балансами, хранящимися в economy.json:

• Виртуальные балансы отслеживаются для каждого игрока
• Удобная команда /cobbletokens для управления своими токенами
• Админ-команды для операторов сервера
• Перевод токенов между игроками

Система прав

Интегрируется с FTB Ranks для проверки прав с автоматическим откатом на ванильные op-уровни.

PermissionApi.hasPermission(player, "permission.node", opLevel);

UI-компоненты

Утилиты для GUI на основе GooeyLibs:

• ConfirmMenu — диалоги подтверждения
• PartyPcMenu — интерфейс выбора покемонов из партии/ПК

Утилиты

• AdventureTranslator — конвертация старых цветовых кодов (&a, &l) и hex (&#RRGGBB) в Components
• PlayerUtils — сообщения в чат, actionbar и broadcast
• PokemonUtils — замена плейсхолдеров и хелперы для статов
• ItemModel — билдер ItemStack с отображаемым именем, лором и поддержкой NBT

Команды

Команды токенов (/cobbletokens)

Админ-команды (/cobblelib)

Конфигурация

Файлы конфигов находятся в config/cobblelib/

config.json

{
  "debug": false,
  "useDefault": true,
  "economySymbol": "Cobbletokens"
}

Языковые файлы

Находятся в config/cobblelib/lang/en.json

Использование API

API экономики

import com.whoslucid.cobblelib.api.EconomyApi;

// Проверить баланс
BigDecimal balance = EconomyApi.getBalance(playerUUID, null);

// Добавить деньги
EconomyApi.addMoney(playerUUID, BigDecimal.valueOf(100), null);

// Убрать деньги
EconomyApi.removeMoney(playerUUID, BigDecimal.valueOf(50), null);

// Перевод между игроками
EconomyApi.transfer(fromUUID, toUUID, 100);

// Проверить и списать
boolean success = EconomyApi.hasEnoughMoney(playerUUID, BigDecimal.valueOf(100), null, true);

// Получить символ валюты
String symbol = EconomyApi.getSymbol(null);

API прав

import com.whoslucid.cobblelib.api.PermissionApi;

// Проверить право с откатом на op
boolean allowed = PermissionApi.hasPermission(player, "your.permission", 2);

Цветовые коды

import com.whoslucid.cobblelib.util.AdventureTranslator;

Component text = AdventureTranslator.toComponent("&aGreen &lBold &#FF5555Custom Hex");

Сборка

./gradlew build

Результат: build/libs/cobblelib-1.0.0.jar

Лицензия

Все права защищены.