FluBundle

Installation

Java 25 is required.

1. Add gradle repository

repositories {
    maven { url "https://maven.x-core.org/releases" }
}

2. Add dependency

dependencies {
    implementation "com.ospx:flubundle:1.3"
}

Publishing

• Snapshots are published to https://maven.x-core.org/snapshots on every non-PR push.
• Releases are published to https://maven.x-core.org/releases when a GitHub Release is published.
• Gradle repository names are xcoreRepositorySnapshots and xcoreRepositoryReleases.

Usage

Bundle bundle = new Bundle();// or Bundle.INSTANCE for global usage
bundle.addSource(ExampleMod.class);// gets the bundles from mod classpath bundles folder

bundle.format(new Locale("en"), "hello-user", 
        Map.of("userName", "Billy")) // Hello, Billy!

Features

• Locale normalization for codes like en-US, en_US, and EN_us
• Configurable locale aliases via addLocaleAlias(...)
• Built-in fallback chain: exact locale -> language locale -> default locale -> default value factory
• Immutable Localizer and BundleContext helpers for locale-bound formatting and player delivery