![banner](https://raw.githubusercontent.com/uku3lig/ukulib/1.19.4/banner.png) [![Maven metadata URL](https://img.shields.io/maven-metadata/v?metadataUrl=https%3A%2F%2Fmaven.uku3lig.net%2Freleases%2Fnet%2Fuku3lig%2Fukulib%2Fmaven-metadata.xml&color=brightgreen&style=for-the-badge)](https://maven.uku3lig.net/#/releases/net/uku3lig/ukulib) [![Javadoc badge](https://img.shields.io/badge/javadoc-latest-blue?style=for-the-badge)](https://maven.uku3lig.net/javadoc/releases/net/uku3lig/ukulib/latest) _Mod icon by the amazing [aqo](https://tiktok.com/@ilysiku)!_ The coolest fabric library mod on the internet, which has 0 (zero) dependencies.
Javadoc can be found [here](https://maven.uku3lig.net/javadoc/releases/net/uku3lig/ukulib/latest) for the latest version, or at `https://maven.uku3lig.net/javadoc/releases/net/uku3lig/ukulib/VERSION` for older versions. ## Features * A simple yet powerful config system, which also provides utilities for vanilla-style config screens. * Various sets of utilities for commands, positioning, text manipulation, etc. * Only this for now... but more will come soon™️ ! (ideas and feedback are appreciated :D) ## How to use Add the following to your `gradle.properties` (see above shield or the [maven repo](https://maven.uku3lig.net/#/releases/net/uku3lig/ukulib) for version info): ```properties # https://github.com/uku3lig/ukulib ukulib_version=... ``` `build.gradle`: ```groovy repositories { maven { url "https://maven.uku3lig.net/releases" } } dependencies { modApi "net.uku3lig:ukulib:${project.ukulib_version}" // you can also include it directly if you don't want your users to download it include "net.uku3lig:ukulib:${project.ukulib_version}" } ```

Development versions

Development version numbers end with `-build.`, e.g. `0.2.2+1.19.2-build.65`.
They are not guaranteed to be stable or even work at all, but they are available if you want to test the latest changes.
They are also not published to the releases maven repo, so you have to add the following to your `build.gradle`: ```groovy repositories { maven { url "https://maven.uku3lig.net/snapshots" } } ```

## Integrating your config screen Ukulib provides an api class, `UkulibAPI`, which you can extend to integrate your mod's config screen with ukulib. Example: ```java public class YourUkulibAPIClass implements UkulibAPI { @Override public Function> supplyConfigScreen() { return parent -> new YourConfigScreen(parent, ...); } } ``` You then need to add the `ukulib` entrypoint in your `fabric.mod.json`: ```json "entrypoints": { ... "ukulib": [ "your.awesome.mod.YourUkulibAPIClass" ] } ```

HitRange

1.4.0 - 1.21.5/6/7/8

1.3.0 - 1.21.2/3/4

1.2.1 - 1.21

1.2.0 - 1.21

1.1.0 - 1.20.5/6

1.0.0 - 1.20.1

1.0.0 - 1.20.3/4