\n
<\/p>\n
# PrismaticAPI<\/p>\n
PrismaticAPI is a powerful utility library for advanced color manipulation and text formatting in Bukkit\/Spigot\/Paper plugins. Originally forked from IridiumColorAPI, PrismaticAPI has since diverged significantly, expanding its functionality and refining its design to offer enhanced features such as dynamic gradients, rainbow effects, and improved support for both legacy and modern RGB color schemes.<\/p>\n
—<\/p>\n
## Overview<\/p>\n
**PrismaticAPI** provides a robust, unified interface to:
\n– **Apply Color Effects:** Create smooth gradient and rainbow effects by generating arrays of `ChatColor` values.
\n– **Process Strings:** Colorize text by applying a series of registered color patterns and translate alternate color codes.
\n– **Strip Formatting:** Remove legacy and modern color formatting to retrieve plain text.<\/p>\n
—<\/p>\n
## Key Features<\/p>\n
– **Gradient Effects:**
\n Create smooth color gradients between two colors by generating an array of intermediary colors that can be applied to text.<\/p>\n
– **Rainbow Effects:**
\n Dynamically generate a rainbow effect across a string based on a defined number of steps and a saturation parameter.<\/p>\n
– **Legacy and Modern Support:**
\n Automatically adapts to legacy (16-color mode) and modern RGB color support based on the server version and player client.<\/p>\n
– **Text Processing:**
\n Provides methods to apply all registered color patterns to text, as well as strip any color or formatting codes, ensuring clean plain text output when needed.<\/p>\n
### Key Enhancements Over IridiumColorAPI<\/p>\n
– **Enhanced Gradient and Rainbow Effects:**
\n PrismaticAPI introduces more flexible gradient and rainbow functionalities, enabling smoother and more dynamic color transitions.<\/p>\n
– **Improved Text Processing:**
\n Better handling of color codes and stripping methods, making it easier to manipulate and clean text.<\/p>\n
– **Optimized API Design:**
\n Streamlined methods for applying and stripping colors, and an overall more modular and maintainable codebase.<\/p>\n
—<\/p>\n
## Usage Examples<\/p>\n
### Example 1: Colorizing a Chat Message<\/p>\n
“`java
\npackage com.example.myplugin;<\/p>\n
import me.croabeast.prismatic.PrismaticAPI;
\nimport org.bukkit.Bukkit;
\nimport org.bukkit.entity.Player;
\nimport org.bukkit.plugin.java.JavaPlugin;<\/p>\n
public class MyPlugin extends JavaPlugin {<\/p>\n
@Override
\n public void onEnable() {
\n \/\/ Example player (could be obtained from an event)
\n Player player = Bukkit.getPlayer(“a player reference”);<\/p>\n
\/\/ Colorize a message using PrismaticAPI
\n String message = “&aHello, &bworld!”;
\n String coloredMessage = PrismaticAPI.colorize(player, message);<\/p>\n
\/\/ Send the colorized message
\n player.sendMessage(coloredMessage);
\n }
\n}
\n“`<\/p>\n
### Example 2: Applying a Gradient Effect<\/p>\n
“`java
\npackage com.example.myplugin;<\/p>\n
import me.croabeast.prismatic.PrismaticAPI;
\nimport org.bukkit.ChatColor;
\nimport org.bukkit.Color;
\nimport org.bukkit.plugin.java.JavaPlugin;<\/p>\n
public class MyPlugin extends JavaPlugin {<\/p>\n
@Override
\n public void onEnable() {
\n \/\/ Define the start and end colors for the gradient
\n Color startColor = new Color(255, 0, 0); \/\/ Red
\n Color endColor = new Color(0, 0, 255); \/\/ Blue<\/p>\n
\/\/ Apply a gradient effect to the text “Gradient Text”
\n String gradientText = PrismaticAPI.applyGradient(“Gradient Text”, startColor, endColor, false);<\/p>\n
\/\/ Log the gradient text (or send it to a player)
\n getLogger().info(gradientText);
\n }
\n}
\n“`<\/p>\n
### Example 3: Stripping All Formatting<\/p>\n
“`java
\npackage com.example.myplugin;<\/p>\n
import me.croabeast.prismatic.PrismaticAPI;
\nimport org.bukkit.plugin.java.JavaPlugin;<\/p>\n
public class MyPlugin extends JavaPlugin {<\/p>\n
@Override
\n public void onEnable() {
\n String formattedText = “&aThis &btext &chas &dcolored &ewith &6codes”;<\/p>\n
\/\/ Remove all color and formatting codes
\n String plainText = PrismaticAPI.stripAll(formattedText);<\/p>\n
getLogger().info(“Plain text: ” + plainText);
\n }
\n}
\n“`<\/p>\n
—<\/p>\n
## Maven \/ Gradle Installation<\/p>\n
To include PrismaticAPI to the project, add the following repository and dependency to your build configuration. Replace `${version}` with the desired version tag.<\/p>\n
### Maven<\/p>\n
Add the repository and dependency to your `pom.xml`:<\/p>\n
“`xml ### Gradle<\/p>\n Add the repository and dependency to your `build.gradle`:<\/p>\n “`groovy dependencies { Replace `${version}` with the appropriate module version.<\/p>\n —<\/p>\n ## Conclusion<\/p>\n **PrismaticAPI** consolidates advanced color manipulation and text formatting functions into a single, easy-to-use API. Whether you need to create eye-catching gradients, implement dynamic rainbow effects, or simply clean up formatted text, PrismaticAPI provides the tools to do so effectively. Its support for both legacy and modern RGB formats ensures broad compatibility across different server versions and player clients.<\/p>\n Enhance your plugin\u2019s visual presentation and user experience with PrismaticAPI!<\/p>\n Happy coding!<\/p>\n \u2014 *CroaBeast*<\/p>\n","protected":false},"excerpt":{"rendered":" PrismaticAPI is a versatile library for advanced color manipulation and text formatting in Bukkit\/Spigot\/Paper plugins.<\/p>\n","protected":false},"featured_media":125125,"template":"","meta":{"_minecraft_slug":"prismaticapi","_minecraft_project_id":"q0sNS9SL","_minecraft_author":"CroaBeast","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":125,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"prismaticapi.zip","_minecraft_size_bytes":160969,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T19:07:01.301416Z","_minecraft_date_created":"2025-04-16T06:19:01.118515Z","_minecraft_date_modified":"2025-11-17T18:00:36.096579Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/prismaticapi","_minecraft_icon_attachment_id":125125,"_minecraft_imported_at":"2026-06-07T08:26:43+00:00","_minecraft_import_hash":"71fb059412c65b183952959725d44dc5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,873,126,90,127,128,867,129,91,123,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-125124","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-library","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n
\n
\n
\n
\n <\/repository>
\n<\/repositories><\/p>\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n<\/dependencies>
\n“`<\/p>\n
\nrepositories {
\n maven {
\n url “https:\/\/croabeast.github.io\/repo\/”
\n }
\n}<\/p>\n
\n implementation “me.croabeast:PrismaticAPI:${version}”
\n}
\n“`<\/p>\n