CrucialLib v3.0.1

What's New in v3.0.1

Bug fixes for Bukkit 1.21.4+ compatibility and comprehensive documentation.

Fixes

• Custom item identification migrated from AttributeModifier to PersistentDataContainer — the old Attribute.MAX_HEALTH modifier hack broke on Bukkit
  1.21.4+ where the constructor was deprecated and UUIDs were no longer preserved
• World border vignette (blood effect) rewritten with Bukkit API — replaced broken NMS reflection (net.minecraft.server.*) with
  Bukkit.createWorldBorder() + Player.setWorldBorder(), which works on both Spigot and Paper
• Null-safe ItemMeta handling — fixed NPE when applying metadata to AIR-type items in custom GUIs
• NamespacedKey lowercase enforcement — recipe keys are now lowercased to comply with Bukkit 1.21+ validation rules

Deprecations

• Stack.addAttributeModifier() — use CrucialItem for custom item identification or InventoryItem for GUI items instead

Docs & CI

• Javadoc added to all public classes and methods
• Comprehensive documentation site with API guide, setup, and migration guides
• Removed redundant CI workflow

Note: Items created with v3.0.0 that are already in player inventories will not be recognized by v3.0.1 and will need to be re-created.

Breaking: Requires Minecraft 1.21+ servers. The old CrucialAPI v2.2.0 remains available for older versions.

Installation

Maven

<repository>                                                                                                                                                    
    <id>jitpack.io</id>                                                                                                                                         
    <url>https://jitpack.io</url>                                                                                                                               
</repository>                                                                                                                                                   
                                                                                                                                                                
<dependency>                                                                                                                                                    
    <groupId>com.github.ChafficPlugins</groupId>                                                                                                                
    <artifactId>CrucialLib</artifactId>                                                                                                                         
    <version>v3.0.1</version>                                                                                                                                   
</dependency>                                                                                                                                                   

  Gradle                                                                                                                                                          
  repositories {                                                                                                                                                  
      maven { url 'https://jitpack.io' }                                                                                                                          
  }                                                                                                                                                               
  dependencies {                                                                                                                                                  
      compileOnly 'com.github.ChafficPlugins:CrucialLib:v3.0.1'                                                                                                   
  }             

Javadocs

Docs

CrucialLib v3.0.0

What's New

• Rebranded from CrucialAPI to CrucialLib
• Modernized to Spigot/Paper 1.21 API
• Java 21 minimum
• Added unit tests, CI improvements, and project docs

Breaking: Requires Minecraft 1.21+ servers. The old CrucialAPI v2.2.0 remains available for older versions.

Installation

Maven

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>

<dependency>
    <groupId>com.github.ChafficPlugins</groupId>
    <artifactId>CrucialLib</artifactId>
    <version>v3.0.0</version>
</dependency>

Gradle

repositories {
    maven { url 'https://jitpack.io' }
}
dependencies {
    implementation 'com.github.ChafficPlugins:CrucialLib:v3.0.0'
}

Javadocs

Docs