![]()
If you like this plugin and you want to thanks for my sacrificed long time of hard work, you can doante me.
Happy, with every single donation
About:
This plugin allows player/developer to fast building colored messages by blocks. You can build chars with using default font (like Mineplex), or with system fonts intalled on your operating system or located in fonts folder in folder plugin. You can too build your chars with animation, what give you good effect and less lag by no instant setting blocks with bigger chars.
CharsApi can be used to select place where we must go on example in lobby above portal tell about type of server ("Survival Server"), can be used in minigames to notify player how much is to start game, type of gameplay, players in game and etc. Generally you can inform player about everything you want, by using blocks.
Video Tutorials:
>>> ENGLISH
>>> POLISH
- by Wukkit
- by LtJim007
>>> GERMAN
- by ServerKondzia (MinecraftKondziu)
- by InselCraft
Configuration:
Plugin is Multi-lingual.
Current translations:
Rest of configure informations you can find in file.
- English
- Polish
Images:
1.NormalInstalling fonts:
2.Fonts
3.Animations (Actual: 18 input, 6 output)
Example web with fonts: http://www.dafont.com/Commands:
1.Fonts
a) On server:2. Start Server
Open plugins > CharsApi > Fonts > put there your fontsb) On local system (Windows):
Open Control Panel > Fonts > drop there your font
Permission:<Format>
Aliases:
- just a: "chars" ;]
Arguments:
- chars
- char
- ch
Examples of using:
- build <string format> - building chars
- clear <ID> - clear chars with that ID
- clear all - clear all chars from map
- list <page_number> - show you detected fonts
- font default - set default builder font
- font <size> <type_font> <name_font> - set builder font
- type_font:
- 0 - Normal
- 1 - Bolded
- 2 - Italic
- name_font - name of font you can get from /ch list. On example "Agency FB"
- animations <in / out> - show you builder <building/clearing> animations
- vars - show list of variables
- updater <updater_subcommand> - menager of auto updating chars
- /ch build &2Welcome &fthere's &4Merbio
- /ch clear 1
- /ch font 38 1 Agency FB
- /ch list 1
- /ch updater create chars_spawn 9
Default builder block is White Wool like subtitles on a chat. To change this in <format> you write text in that same way. &(0-9 and a-f)
,or plugin can choose random color
- /ch build &aGreen
- Text "green" from green wool
If u wanna an updater &X choose everytime diffrent color u can hack it by: writing anywhere %riuet% which will be replaced by nothing("") and will be reloading random colors.
- /ch build &XWelcome
- Text "Welcome" from random color wool
Example: /ch u add &Xrandomed%riuet%
You can too change builded block, who you can colored with using character "#".
- /ch build #c&1I am #p&5player
- Text "I am(from blue clay) player(from purple glass pane)"
Parameters:Plugin have some alternative blocks. &(g-m)
- C - clay
- W - wool
- G - glass
- P - glass pane
In plugin is implemented variables system, you can use varibales by "%var_name%". % - var char you can configure in config.
- /ch build #cclay &gBlock
- Text "clay (from white clay) Block(from bedrock)"
You can too build chars with effect(input animation). You can change this with using character "@".
- /ch build Online: %online% / %maxplayers%
- Example generated text: "Online: 4 / 20"
You can clear animation with effect(output animation). You can change this with using character "!".
- /ch build @4#g&aGreen Dragon
- Animated Text "green dragon" from green glass
You can create multiple chars (texts "starting in new line") with use character "\n".
- /ch build !1#c&8Drop Blocks
- /ch clear <id_of_this_chars>
- Dropping chars clearing animation effect ;]
You can add to yours chars overline with use character "$".
- /ch build @6#g&aFirst Line\n@5#c&5Second Line
- Line 1: Animated text "First Line" from green glass
- Line 2: Animated text "Second Line" from purple clay
- /ch build $w#c&4Car
- Text "Car" from red clay with black wool overline
Parameters: (similary like in color blocks)Updater:
- C - Black Clay
- W - Black Wool
- G - Black Glass
- P - Black Glass Pane
- L - LightBlock - Glowstone
Main args:Api Section:
/ch u <subcommand>Subcommands:
Examples of using:
- create <updater_name> <updated_time> - create updater
- remove <updater_name> - remove updater
- tpto <updater_name> - teleports player to updater
- setloc - set updater location and facing
- settime <updated_time> - set updater update time
- add <text> - add text to update
- del <id_text> - remove text from updater
- info - information about actual updater (with texts id's)
- list - updaters list
- select <updater_name> - select updater to edit
- flush - clear all updaters texts on air
- start - starting updater
- stop - stoping updater
- save - saving updater
Updater allows you to create auto-changing chars on your server.
So, we want to create 3 chars changing in one place by 12 seconds.
First you must to set settings of your builder like /ch font, becaouse updater will remeber this settings. You can combine fonts in updater.
Removing updater from meganger.Code (Text):/ch u create n_spawn 12
#When you create updater that he is auto-targeting /ch u select
#so in next commands you musn't use updater_name in commands like /ch u add
/ch u add @3#c&1Welcome
/ch u add @3#c&2on
/ch font 30 1 Agency FB
/ch u add @3#c&3SPAWN&4!
/ch u save
Changing location and facing updater to player location, and changing update time to 15.Code (Text):/ch u remove n_spawn
Code (Text):/ch u select n_spawn
/ch u select n_spawn
#second time to agree updater selection
/ch u stop
#Stop to plugin allows change updater settings
/ch u setloc
/ch u settime 15
/ch u save
#When we saving updater will be save + automatic starting ;] (/ch u start)
Blocks builder class.Plugin have many more function and classes, but I describe most usefull ;]
Creating and removing chars.Class used to building your chars, that have settings like font, default font space, space over building location and etc.
Code (Text):CharsBuilder builder = new CharsBuilder();
Changing builder settings.CharsString - this class is used to operating on your blocks message. That contains scheme of your text, informations like actual location, and functions, to on example delete this text.
First you must to create scheme of your text:
Next you can to build this text by using builder:Code (Text):CharsString textCS = builder.replace("#cYour Text");
"build" function return new CharsString with remembered before blocks who was set to build message.Code (Text):textCS = builder.build(buildLocation, spawnLocation, textCS);
First location is location were plugin will build text, second is location to were will be rotated text.
You can to build text from players location and players facing:
Builder have too other "build" functions.Code (Text):textCS = builder.build(player, textCS);
Now we can to remove our text.
Code (Text):textCS.clearChars();
Creating auto changing chars.BlockSettings - class who contains builder settings.
We can create new object of class with default options by:
,or we can get actual builder settings (If settings of builder was not changed before, so have default settings of builder.Code (Text):BlockSettings settings = new BlockSettings();
If we have object of class, we can to modify him properties now:Code (Text):BlockSettings settings = builder.getBlockSettings();
1. Default font blocks word spacing:
2.Default font blocks letter spacing:Code (Text):settings.setWordSpacing(int);
3.How many blocks over player will be builded chars:Code (Text):settings.setLetterSpacing(int);
4.Character of decoding color of blocks:Code (Text):settings.setPlayerSpacing(int);
5.Character of decoding color blocks material:Code (Text):settings.setColorChar(char);
6.Character of decoding input animation:Code (Text):settings.setColoredBlockChar(char);
7.Character of decoding output animation:Code (Text):settings.setInputAnimationChar(char);
8.Add replacer character of material like "&g - bedrock":Code (Text):settings.setOutputAnimationChar(char);
Character from '0-9,a-f' will be not working, becaouse colors haves, highter priority.Code (Text):settings.addMaterialReplacement(char, Material);
9.Setting all list of replacer materials:
10.Clearing list of replacer materials:Code (Text):settings.setMaterialReplacementList(HashMap<Character, Material>;
11.Changing blocade of building chars for only air blocks:Code (Text):settings.clearMaterialReplacementList();
Default: true - blocking.Code (Text):settings.setOnlyAirBlocade(boolean);
12.Set building font:
and now we can set builder settings by our settings:Code (Text):settings.setFont(java.awt.Font);
in good way you can too do something like that:Code (Text):builder.setBlockSettings(settings);
Code (Text):builder.setBlockSettings(new BlockSettings().setColorChar('$').setFont(new Font("Arial", 0, 20)).setPlayerSpacing(8).addMaterialReplacement('N', Material.SPONGE));
Adding variable to CharsAPI builders.CharsUpdater - that is class who manage your chars, and changing it.
Code (Text):CharsUpdater updater = new CharsUpdater(int, org.bukkit.Location, org.bukkit.block.BlockFace);Adding chars to updater:
- Seconds with updater change chars
- Location where he change chars
- Face - rotation with where he will building chars
Chars will be builded with settings (font, spacing and etc.), like have your builder when you add chars.Code (Text):int ID = updater.addCharsString(builder, String format);
This function return Integer - ID of added chars.
Removing chars:
Changing seconds of updating:Code (Text):updater.removeCharsString(ID);
Changing location of updating:Code (Text):updater.setSeconds(int);
Changing face chars:Code (Text):updater.setLocation(Location);
Checking about updater is working:Code (Text):updater.setFacing(BlockFace);
And finaly:Code (Text):updater.isRunning();
Staring updater:
Stoping updater:Code (Text):updater.start();
I prefere everytime when you adding / changing something in updater stopping him, and after changes starting.Code (Text):updater.cancel();
First String - String which will be returnedCode (Text):public CharsVariable(String result, String... varNames)
Next Strings - names (aliases) of the variable
Code (Text):CharsBuilder.addCharsVariables(
new CharsVariable("Hello World!", "hi world", "h w", "hw")
);First Object - Object executed on replacing variable nameCode (Text):public CharsVariable(onVarCheck varCheck, String... varNames)
Next Strings - names (aliases) of the variable
Code (Text):CharsBuilder.addCharsVariables(
new CharsVariable(new CharsVariable.onVarCheck() {
@Override
public String on() {
return getServer().getOnlinePlayers().length + " / " + getServer().getMaxPlayers();
}
}, "fullOnline", "fon")
);
If you want to see its, use shorcuts "Alt + Space" on plugin clasess, or package "pl.merbio."
Have fun with it!

CharsApi 0.4.2
The ultimate blocks messages plugin
-
ChillerKraft, Yutz, xXTheCreepyBoyXx and 8 others like this.
Recent Updates
- Tps variables Mar 20, 2016
- Support for 1.9 Mar 20, 2016
- Variables System Mar 19, 2016
Recent Reviews
-
hectormoreno522
- 5/5,
Good morning, does this plugin have permission for players?
---------------------------------------------------------------------------------------- -
Daniel_Sebesta
- 5/5,
Please, add 1.13.2 support! It can be a very good plugin, but no support for newest versions... Thank you!
-
ChillerKraft
- 5/5,
a little buggy but i think its works perfectly fine actually
very useful! just gonna use it on my testing server and copy/schem/paste it to my other servers
thankyou dev! -
nandoguissa
- 3/5,
After use I realized that the TPS dropped and CPU increased considerably, this measuring with plugin "toplite" and "clearlag" also noticed a good increase in memory usage. is this right ? Does charsapi consume so much?
-
Ivencivel
- 5/5,
-------------------------------------------------------------------
I searching a long time!!!! =D, Good Plugin!
------------------------------------------------------------------- -
Bunny_
- 4/5,
What a shame, it does not work in 1.11.2, I really would like to continue using it...........................
-
Onenrico
- 5/5,
thank you so much for making this plugin
i don't have money to donate to you sorry :(
but i hope there is so much donate for this plugin
because i know it takes hard work to make it -
Supremo1816
- 5/5,
English (Google Translator):
The plugin is great, easy to use, and very fast. I have not seen bugs , which is well programmed and hope you continue creating good plugins Merbio , what if you now send a private message with a small problem I have , but it has to do with failures plugin, Greetings !
Español:
El plugin es genial, fácil de usar, y muy rápido. No he visto bugs, con lo cual está bien programado y espero que sigas creando buenos plugins Merbio, lo que si ahora te enviare un mensaje privado con un pequeño problema que tengo, pero no tiene que ver con fallos del plugin, Saludos! -
xXTheCreepyBoyXx
- 5/5,
EPIC!!! Es fantastico ya que sirve para la gente que No sabe hacer letras con los bloques, gracias a CharsApi podemos!!! siuuuusiuu!!!! Jjajajajajaja ;:D
-
GamerzKing
- 5/5,
Great resource!
Love the way you added so many elements to this plugin! It's extremely unique with the custom fonts, as well as the API feature for this plugin!
This is great for developers, that want to code various different plugins, or for server owners who want to have a nice looking server!
Thanks so much for creating this plugin,
- GamerzKing