CobbleLib

CobbleLib

CobbleSuite 库 作者 WhosLucid

基础库

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 组件

基于 GooeyLibs 的 GUI 工具:

  • ConfirmMenu - 确认对话框
  • PartyPcMenu - 队伍/PC 宝可梦选择界面

工具类

  • AdventureTranslator - 将旧版颜色代码(&a、&l)和十六进制颜色(&#RRGGBB)转换为 Component
  • PlayerUtils - 聊天、动作栏和广播消息
  • PokemonUtils - 占位符替换和属性辅助工具
  • ItemModel - 带显示名称、描述和 NBT 支持的 ItemStack 构建器

命令

代币命令(/cobbletokens)

命令 权限 描述
/cobbletokens cobblelib.tokens 查看你的余额
/cobbletokens balance [player] cobblelib.tokens / cobblelib.tokens.admin 查看余额(查看他人需管理员权限)
/cobbletokens send <player> <amount> cobblelib.tokens 向其他玩家发送代币
/cobbletokens pay <player> <amount> cobblelib.tokens send 的别名
/cobbletokens give <player> <amount> cobblelib.tokens.admin 给予玩家代币
/cobbletokens take <player> <amount> cobblelib.tokens.admin 从玩家处扣除代币
/cobbletokens set <player> <amount> cobblelib.tokens.admin 设置玩家余额

管理命令(/cobblelib)

命令 权限 描述
/cobblelib reload cobblelib.reload 重新加载所有配置
/cobblelib info cobblelib.base 显示模组信息

配置

配置文件位于 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

许可证

保留所有权利。