Installation Guide

📋 Prerequisites

Before installing ChosenLib, make sure you have:

• Fabric Loader - Latest version for your Minecraft version
• Fabric API - Required dependency
• Java 21 - For development and building
• Gradle - Build system (included with Fabric template)

🎮 For Players (Mod Users)

If you want to use ChosenLib as a dependency in other mods:

1. Download the Mod

Download ChosenLib from one of these sources:

2. Install the Mod

1. Download the latest chosenlib-1.4.0.jar file
2. Place it in your mods/ folder
3. Make sure you have Fabric API installed
4. Start Minecraft with Fabric Loader

3. Verify Installation

Once in-game, type /chosenlib to see version information and links.

👨‍💻 For Developers (Mod Creators)

Add ChosenLib as a dependency in your mod project:

1. Add Repository

Add the repository to your build.gradle:

repositories {
    mavenCentral()
    maven { url = 'https://maven.fabricmc.net/' }
    // Add your repository here when published
}

2. Add Dependency

Add ChosenLib as a dependency:

dependencies {
    modImplementation "com.yourgroup:chosenlib:1.4.0"
    
    // For development, you might also want:
    modRuntimeOnly "com.yourgroup:chosenlib:1.4.0"
}

3. Update Your Mod

In your main mod class, add ChosenLib as a dependency:

@Mod("yourmodid")
public class YourMod implements ModInitializer {
    
    @Override
    public void onInitialize() {
        // Your mod initialization code
        LOGGER.info("Your mod is loading with ChosenLib v1.4.0 support!");
    }
}

4. Import Utilities

Now you can import and use all ChosenLib utilities:

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

// Enhanced existing utilities
import com.chosen.lib.util.TextUtils;
import com.chosen.lib.util.GuiUtils; // Now server-side compatible!
import com.chosen.lib.util.ItemUtils;

// Use the new utilities
WorldUtils.setBlockState(world, pos, newState);
EntityUtils.heal(entity, 10.0f);
NetworkUtils.sendToWorld(world, channelId, buffer);
TextUtils.success("ChosenLib v1.4.0 is working!");

🔧 Building from Source

If you want to build ChosenLib from source:

1. Clone the Repository

git clone https://github.com/yourusername/chosenlib.git
cd chosenlib

2. Build the Project

./gradlew build

3. Find the Artifacts

The built JAR files will be in build/libs/:

• chosenlib-1.4.0.jar - Use this for distribution
• chosenlib-1.4.0-sources.jar - Source code
• chosenlib-1.4.0-dev.jar - Development version

⚠️ Troubleshooting

Common Issues

Issue	Solution
Mod not loading	Make sure you have Fabric API installed and are using the correct Minecraft version
Compilation errors	Check that you're using Java 21 and have the correct dependency version
GuiUtils not found	GuiUtils is client-side only. Make sure you're importing it in client-side code
Command not working	Ensure the mod is properly installed and you're using the correct command: /chosenlib

Getting Help

If you're still having issues:

• Check the GitHub Issues page
• Join our Discord for support
• Review the API Reference for usage examples

📦 Version Compatibility

ChosenLib Version	Minecraft Version	Fabric Loader	Java Version
1.4.0	1.21.1	0.17.2+	21+
1.3.1	1.21.1	0.17.2+	21+
1.2.x	1.21.1	0.17.2+	21+
1.1.x	1.21.1	0.17.2+	21+