Description

BannerText is a utility plugin that revolves around the conversion of text into banners. Using the plugin's writer tool, you can rapidly draw banners into your world to represent any string of text with any color you choose. You may also add more characters & fonts to use through the config.



Commands & Permissions

/bt
Alias for /bannertext

/bannertext get <text...>
Creates a chest of banners for the given text.
See the formatters below on how to set the color and style.

Uses the permission node: bannertext.get
Permission defaults to operators.

/bannertext write <text...>
Creates a banner writer tool for the given text.
See the formatters below on how to set the color and style.
See more below on how to use this tool.

Uses the permission node: bannertext.write
Permission defaults to operators.

/bannertext reload
Reloads or creates the plugin's configuration file.
The plugin will not work without a valid config!

Uses the permission node: bannertext.reload
Permission defaults to operators.

Formatting Codes

The plugin uses formatting codes similar to Minecraft's Formatting Codes.

&[0-9a-f][0-9a-f]
Sets the text and background color.
You need to set both at the same time.
Ex. &49 specifies red text on a blue background.
The default is white on black.

&[klmnor]
Sets the text style.
The plugin currently only applies one style at a time.

&&
Forms a literal ampersand.



Using The Writer Tool

The BannerText writer is a collection of all the banners generated from your text stored inside a single item. You can move its cursor forward or backward in the list by shift clicking.

[Shift + Right Click] - place & move forward by one
[Shift + Left Click] - break & move backwards by one

Watch a demonstration of it here:



(You must be in creative mode to use the tool)

Adding More Patterns

This is the latest version of the plugin's configuration file. It also explains how you can add additional BannerText designs.

config.yml

If your designs have any errors, they will be printed to the console and ignored. Careful not to break anything else in the config though or the plugin will stop working.

You can always grab a fresh config by deleting or renaming yours and using /bannertext reload.



Additional Info

There are no dependencies (woo!) Simply plop the JAR into your server's plugins folder and hit start.

The /bannertext write command takes 1ms on average. However, the /bannertext get command can take anywhere between 5ms and 400ms depending on how much text was given. It is highly recommended not to let everybody use that command due to potential for abuse.

Be sure to leave a comment if you appreciate this plugin ^^