CobbleLib
A core utility library for Cobblemon NeoForge mods providing virtual economy (Cobbletokens), permissions, UI framework, and Pokemon helpers.
Requirements
- Minecraft 1.21.1
- NeoForge 21.1.90+
- Cobblemon 1.7.2+
- Java 21+
Features
Economy(Cobbletokens)
A simple virtual currency system with balances stored in economy.json:
- Virtual balances tracked per player
- Easy
/cobbletokenscommand for players to manage their tokens - Admin commands for server operators
- Transfer tokens between players
Permission System
Integrates with FTB Ranks for permission checks with automatic fallback to vanilla op levels.
PermissionApi.hasPermission(player, "permission.node", opLevel);
UI Components
GooeyLibs-based GUI utilities:
ConfirmMenu- Confirmation dialogsPartyPcMenu- Party/PC Pokemon selection interface
Utilities
AdventureTranslator- Convert legacy color codes (&a,&l) and hex (&#RRGGBB) to ComponentsPlayerUtils- Chat, actionbar, and broadcast messagingPokemonUtils- Placeholder replacement and stat helpersItemModel- ItemStack builder with display name, lore, NBT support
Commands
Token Commands (/cobbletokens)
| Command | Permission | Description |
|---|---|---|
/cobbletokens |
cobblelib.tokens |
Check your balance |
/cobbletokens balance [player] |
cobblelib.tokens / cobblelib.tokens.admin |
Check balance (admin for others) |
/cobbletokens send <player> <amount> |
cobblelib.tokens |
Send tokens to another player |
/cobbletokens pay <player> <amount> |
cobblelib.tokens |
Alias for send |
/cobbletokens give <player> <amount> |
cobblelib.tokens.admin |
Give tokens to a player |
/cobbletokens take <player> <amount> |
cobblelib.tokens.admin |
Take tokens from a player |
/cobbletokens set <player> <amount> |
cobblelib.tokens.admin |
Set a player's balance |
Admin Commands (/cobblelib)
| Command | Permission | Description |
|---|---|---|
/cobblelib reload |
cobblelib.reload |
Reload all configs |
/cobblelib info |
cobblelib.base |
Display mod info |
Configuration
Config files are located at config/cobblelib/
config.json
{
"debug": false,
"useDefault": true,
"economySymbol": "Cobbletokens"
}
Language Files
Located at config/cobblelib/lang/en.json
API Usage
Economy API
import com.whoslucid.cobblelib.api.EconomyApi;
// Check balance
BigDecimal balance = EconomyApi.getBalance(playerUUID, null);
// Add money
EconomyApi.addMoney(playerUUID, BigDecimal.valueOf(100), null);
// Remove money
EconomyApi.removeMoney(playerUUID, BigDecimal.valueOf(50), null);
// Transfer between players
EconomyApi.transfer(fromUUID, toUUID, 100);
// Check and deduct
boolean success = EconomyApi.hasEnoughMoney(playerUUID, BigDecimal.valueOf(100), null, true);
// Get currency symbol
String symbol = EconomyApi.getSymbol(null);
Permission API
import com.whoslucid.cobblelib.api.PermissionApi;
// Check permission with op fallback
boolean allowed = PermissionApi.hasPermission(player, "your.permission", 2);
Color Codes
import com.whoslucid.cobblelib.util.AdventureTranslator;
Component text = AdventureTranslator.toComponent("&aGreen &lBold &#FF5555Custom Hex");
Building
./gradlew build
Output: build/libs/cobblelib-1.0.0.jar
License
All rights reserved.
