Prisma

Purpose

Prisma is a new plugin that allows for developers to easily hook in and use custom color codes provided from the colors.yml.

The idea behind Prisma is to allow for server owners to easily define new color codes using RGB and Hex codes that they can then use on things such as plugin's language files, provided they hook into Prisma

Server Owner Usage

To use Prisma, simply put the jar in your plugins folder, run the server once to generate the colors.yml , and then you are free to add your custom color codes.

This will only work with plugins that hook into Prisma.

At the moment, Prisma only works with chat messages, but we are looking to move that into action bars and other formats in the future.

You will not be able to assign custom color codes that are currently used by vanilla, such as b, a, 4, l, etc.

Examples:

ChatColors: 
  Random: 
    ColorCode: 'x' 
    RGB: '155:23:55' 
  Random2: 
    ColorCode: '?' 
    Hex: '#ff98ff'

An example string to translate:

"&cHello &l&?World. &xHow &fAre &rYou?"

Developer Implementation

Adding support for Prisma is amazingly easy. All you need to do is place this method in a util class such as a Methods class, and change your player.sendMessage()s to run through this method.

This method would provide vanilla and custom color code implementation, and if Prisma is absent, would not break and just use vanilla coloring.

public static void sendMessage(Player player, String message){ 
     if(Bukkit.getPluginManager().isPluginEnabled("Prisma")){ 
        message = ColorProvider.translatePrisma(message, false); 
     } 
     player.sendMessage(ChatColor.translateAlternateColorCodes('&', message)); 
     }

Prisma also provides over 100 colors in an enum called PrismaColor you can use as easily as so.

player.sendMessage(PrismaColor.BISQUE + "BISQUE");

Support

If you have any questions, feel free to join my discord for support!