PrismaticAPI

<div align="center"> !(https://cdn.modrinth.com/data/cached_images/d51110ad871ae9f4a4e668bf912db2e1cea6c64d.png) !(https://cdn.modrinth.com/data/cached_images/de248dfd12b9fecaa5292498cfd26cdea88ed182.png) !(https://cdn.modrinth.com/data/cached_images/a3d73d3a4be36dc33cca70cb4d6afee54117116e.png) !(https://cdn.modrinth.com/data/cached_images/36d9d1321d48501bde1204ebe3b8bf3862f68e1c.png) !(https://cdn.modrinth.com/data/cached_images/9f395a3dac723f47bf1c397ffec3efb62783333a.png) !(https://cdn.modrinth.com/data/cached_images/5215aeaf12b0ea30866e3b2dbf86aac2967dd30a.png) !(https://cdn.modrinth.com/data/cached_images/f87b543904c4d758f9be714352c906624c1ca110.png) !(https://cdn.modrinth.com/data/cached_images/69c07d236b1fa4dace0bb4307f859da69869b447.png) (https://cdn.modrinth.com/data/cached_images/35a63cd4d2d26e0f7a677e98651a5d8bfa644cd1.png)](https://discord.gg/DC4Gqj3y5V) !(https://cdn.modrinth.com/data/cached_images/3bc0cf592e48a3494d96a4278ec9339459a16f53.png) </div> <details> <summary>Text Description</summary> <div align="center"> # 🌈 PrismaticAPI **The ultimate text-formatting engine for Bukkit/Paper plugins.** RGB colors · Gradients · Rainbows · MiniMessage · Interactive Messages (https://img.shields.io/badge/version-1.5.0-blueviolet?style=flat-square)](https://github.com/CroaBeast/PrismaticAPI) (https://img.shields.io/badge/Minecraft-1.16.5+-green?style=flat-square)](https://spigotmc.org) (https://img.shields.io/badge/Java-8+-orange?style=flat-square)](https://java.com) (https://img.shields.io/badge/Adventure-optional-blue?style=flat-square)](https://docs.advntr.dev) </div> --- ## ✨ What Is PrismaticAPI? PrismaticAPI is a Bukkit/Paper text-formatting library that gives your plugin **beautiful, modern text** without the headache. One shared engine powers both legacy Bukkit strings and Adventure components — gradients, rainbows, per-player hex fallback, MiniMessage compatibility and interactive click/hover events all included. --- ## 🚀 Features - 🎨 **Multiple RGB syntaxes** — `{#ff8800}`, `%#ff8800%`, ``, `<#ff8800>`, `&#ff8800`, `#ff8800`, `&xff8800` - 🌈 **Gradient & Rainbow tags** — color transitions per character, across as many color stops as you want - 💬 **MiniMessage integration** — mix Prismatic tags and MiniMessage tags in the same string (optional at runtime) - 🔮 **Adventure support** — produce `net.kyori.adventure.text.Component` output from the same pipeline, fully optional - 🕹️ **Interactive messages** — `Element`: parsed once, click events, hover text, hover items, placeholders, URL auto-detection - 🧠 **Player-aware formatting** — VNC + ViaVersion integration to serve hex or legacy output depending on the player's Minecraft version - 🛡️ **Safe by design** — Adventure is never required; the library boots cleanly even when it's absent - ⚡ **Backwards compatible** — the classic `PrismaticAPI.colorize(...)` methods still work unchanged --- ## 📦 How to Import ### Gradle (Kotlin DSL) ```kotlin repositories { maven("https://croabeast.github.io/repo/") } dependencies { implementation("me.croabeast:PrismaticAPI:1.5.0") } ``` ### Gradle (Groovy DSL) ```groovy repositories { maven { url 'https://croabeast.github.io/repo/' } } dependencies { implementation 'me.croabeast:PrismaticAPI:1.5.0' } ``` ### Maven ```xml <repository> <id>croabeast-repo</id> <url>https://croabeast.github.io/repo/</url> </repository> <dependency> <groupId>me.croabeast</groupId> <artifactId>PrismaticAPI</artifactId> <version>1.5.0</version> </dependency> ``` > **Tip:** If your plugin uses `PrismaticAPI.adventure()`, keep the Adventure API on your compile classpath and make sure the required Adventure runtime classes are present at startup. --- ## 🧩 Supported Syntax ### 🎨 Single RGB Colors | Syntax | Example | |--------|---------| | Curly braces | `{#ff8800}` | | Percent signs | `%#ff8800%` | | Square brackets | `` | | Angle brackets | `<#ff8800>` | | BungeeCord hex | `&xff8800` | | Plain hex | `#ff8800` | | Ampersand hex | `&#ff8800` | ### 🌈 Gradients ``` <g:ff0000>Hello world</g:0000ff> <gradient:ff0000>Hello world</gradient:0000ff> <#ff0000>Hello world</#0000ff> <#ff0000:#00ff00:#0000ff>Hello world</gradient> ← multi-stop! ``` ### 🌀 Rainbows ``` <rainbow:1>Hello world</rainbow> <r:1>Hello world</r> ``` ### 📜 Legacy Formatting ``` &a green &l bold &c red &n underline &6 gold &o italic &r reset &k obfuscated ``` ### 📝 MiniMessage (when Adventure is present) Standard MiniMessage tags (`<bold>`, `<red>`, `<gradient:...>`, etc.) can be freely mixed with Prismatic tags in the same string. --- ## 📖 Quick Start ### 🟢 Legacy strings (always safe) ```java // Basic colorize String colored = PrismaticAPI.colorize(player, "<g:ff0000>Hello</g:0000ff> &lworld!"); player.sendMessage(colored); // Using t