header
XunLib avatar

XunLib

Install

Overview

XunLib is a lightweight yet powerful utility library designed to simplify mod development by handling repetitive tasks and offering robust, reusable systems. From inventory management to spatial tools, it provides flexible APIs to minimize boilerplate.

Features

 

🔧 Inventory Utilities

  • Insert/extract items, validate stacks, and check container states.
  • Armor slot validation for materials/types.
  • Convert grid positions to slot indices.

🎯 Fuzzy Item Matching

  • Compare items by count, enchantments, or custom properties.
  • Configurable ignore rules (e.g., ignore durability or Data components).

🧪 Smart Effect Application

  • Intelligently extend/upgrade existing effects or apply new ones.

🌈 Color & Spatial Tools

  • Convert between RGB/HSL/HSV and blend colors dynamically.
  • Generate shapes (discs, spheres, hollow cubes) and check spatial bounds.

📦 Data Automation

  • @PersistentNbt annotation for auto-serializing block entity data.
  • INbtAdapter for custom NBT serialization logic.

Registration System

  • Adding custom items, blocks, and entities in the common module for easing multi-loader development.