ChosenLib v1.4.0

A comprehensive utility library for Fabric that streamlines common modding tasks. Build better mods faster with our collection of world, entity, networking, GUI, text, and item utilities.

🌍

WorldUtils

NEW World and block manipulation utilities. Safe block operations, area queries, chunk management, and entity finding.

  • Safe block getting/setting
  • Area operations (cubes, spheres)
  • Block finding and replacement
  • World property queries
👤

EntityUtils

NEW Entity-related helper functions. Health management, teleportation, status effects, and physics operations.

  • Health and damage management
  • Status effect operations
  • Entity teleportation
  • Physics and movement
🌐

NetworkUtils

NEW Networking and packet utilities. Easy packet creation, multi-target sending, and safe data serialization.

  • Packet buffer management
  • Multi-target packet sending
  • Safe data serialization
  • Array and collection support
🎨

GuiUtils

ENHANCED Now server-side compatible! GUI utilities for both client and server with performance optimizations.

  • Server-side color utilities
  • Client-side rendering (ClientGuiUtils)
  • Mathematical operations
  • Performance caching
📝

TextUtils

ENHANCED Advanced text operations with performance improvements. Interactive components, text wrapping, and caching.

  • Interactive text components
  • Text wrapping utilities
  • Duration and number formatting
  • Pattern caching for performance
🎒

ItemUtils

ENHANCED Comprehensive item management with performance optimizations. Inventory operations, enchantments, and NBT handling.

  • Enhanced inventory management
  • Enchantment and NBT utilities
  • Durability management
  • Performance caching

✨ Why Choose ChosenLib?

🚀 Modern & Fast

Built with the latest Fabric toolchain, Java 21, and optimized for performance.

🔧 Well-Documented

Comprehensive JavaDoc coverage with practical examples and usage patterns.

🎯 Cross-Platform

Works seamlessly on both client and server (GuiUtils is client-side only).

📦 MIT Licensed

Open-source and free to use in any project, commercial or personal.

💻 Quick Start

Get up and running with ChosenLib in minutes:

1. Add as Dependency

dependencies {
    modImplementation "com.yourgroup:chosenlib:1.4.0"
}

2. Import Utilities

import com.chosen.lib.util.*;
// New in v1.4.0
import com.chosen.lib.util.WorldUtils;
import com.chosen.lib.util.EntityUtils;
import com.chosen.lib.util.NetworkUtils;

3. Start Using

// World utilities (NEW!)
List<BlockPos> blocks = WorldUtils.getBlocksInSphere(center, 5.0);
WorldUtils.setBlockState(world, pos, newState);

// Entity utilities (NEW!)
EntityUtils.heal(entity, 10.0f);
EntityUtils.teleport(entity, targetPos);

// Network utilities (NEW!)
PacketByteBuf buffer = NetworkUtils.createBuffer();
NetworkUtils.sendToPlayersInRadius(world, center, 50.0, channelId, buffer);

// Enhanced existing utilities
Text interactive = TextUtils.interactiveText("Click me", "Tooltip", "https://example.com");
ItemUtils.insertStack(inventory, stack);

🚀 What's New in v1.4.0 - Major Feature Release!

🌍 WorldUtils

Complete world and block manipulation utilities with safe operations and area queries.

👤 EntityUtils

Comprehensive entity management including health, teleportation, and physics operations.

🌐 NetworkUtils

Advanced networking utilities for packet creation and multi-target communication.

⚡ Performance

Major performance improvements with caching systems and optimized operations.

🔮 Upcoming: We're planning exciting new features for versions 1.5.0-1.9.0! Check out our changelog to see what's coming next.

📋 View Full Changelog

🔗 Community & Resources

📖 Documentation

Comprehensive guides and API reference for all utilities.

View API

💬 Discord

Join our community for support, discussions, and updates.

Join Discord

🐛 Issues

Found a bug or have a feature request? Let us know!

Report Issue

⭐ Star on GitHub

Show your support by starring the repository.

Star Repo