Skip to content

Allow anonymous analytics?

Our cookieless analytics show us which features get used and store nothing on your device. We never sell your data or use it for advertising.

Privacy choices

Choose what ModDex may collect. You can change this anytime from Privacy choices in the footer.

Read the full privacy policy

Strictly necessary Required for the site to work: login sessions, security tokens, and abuse prevention. Always on and cannot be disabled. Always on
Analytics Cookieless analytics through PostHog's EU servers, used only to see which features get used. Nothing is stored on your device, and the anonymous visitor ID resets every day. Needs your consent because usage data goes to a third party. Never used for advertising or profiling. Off by default in the EU and UK.

ColorAPI

Quick rating

Community listing page, reviews may not be monitored by the author.

How listings work Are you the author?

ColorAPI

By MisterBartra

No reviews yet

Lightweight chromatic algebra, color spaces, and animation library for Minecraft Fabric. Features RGB/HSV conversions, easing curves, color transitions, and texture extraction.

Mod Loaders
Minecraft
Shockbyte server hosting: 35% off your first server with code MODDEX35 (opens in a new tab)

About

Description

🎨 ColorAPI

Fabric Minecraft Java License

ColorAPI is an ultra-lightweight, high-performance mathematical and chromatic animation library designed for modern Minecraft Fabric (1.21.11+). It decouples pure color algebra and timing curves from complex rendering engines, providing a clean, reusable foundation for colored lighting, GUI widgets, particle systems, and cosmetic tinting.

⚡ Core Features

  • 🌈 Comprehensive Color Spaces: * Immutable ColorRGB record supporting sRGB, Linear spaces, gamma correction, alpha channels, and packed ARGB/RGB conversions. * ColorHSV record with robust bidirectional RGB \(\leftrightarrow\) HSV mapping.
  • 🧮 Pure Chromatic Algebra (ColorMath): * Weighted multi-source color blending (blendColors). * Clamped linear interpolation (lerp). * Photometric attenuation modulation (modulate). * Additive light accumulation (additiveAccumulate).
  • 📈 Rich Easing & Animation Engine (EasingMath): * Easing curves: Linear, Ease In/Out, Ease In-Out, Quadratic, Cubic, Sine, Exponential, Bounce, Elastic, and Step. * Temporal transition controller (ColorTransition) for smooth tick-to-tick or frame-to-frame color fading.
  • 📦 Decoupled Data Structures: * Standardized Keyframe, Sequence, and Profile records for sequencing complex multi-stage color animations.
  • 🖼️ Texture & Asset Color Extraction: * Native utilities for calculating dominant/average colors from block sprites and textures.

💻 Developer Quick Start

Add ColorAPI to your build.gradle:

repositories {
    mavenCentral()
    // or mavenLocal() if building from source
}

dependencies {
    modImplementation "mb.bartra:colorapi:1.0"
}

Basic Color Interpolation & Blending:

import mb.bartra.colorapi.ColorAPI;
import mb.bartra.colorapi.core.ColorRGB;
import mb.bartra.colorapi.core.ColorMath;

// 1. Simple Lerp between two hex colors
int startColor = 0xFF0000; // Red
int endColor   = 0x0000FF; // Blue
int blended    = ColorAPI.lerp(startColor, endColor, 0.5f); // Purple

// 2. Linear Color Modulation
ColorRGB light = ColorRGB.fromRgb(0xFFAA00);
ColorRGB shaded = light.toLinear().multiply(0.75f).toSrgb();

📄 License

ColorAPI is distributed under the open-source MIT License. Free for personal use, modpacks, and third-party mod integrations.