CharsAPI
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.
Configuration:
Plugin is Multi-lingual.
Current translations:
- English
- Polish
Rest of configure informations you can find in file.
Images:
- Normal
- Fonts
- Animations (Actual: 18 input, 6 output)
Installing fonts:
Example web with fonts: DaFont
- Fonts:
- On server:
Open plugins > CharsApi > Fonts > put there your fonts
- On local system (Windows):
Open Control Panel > Fonts > drop there your font
- On server:
- Start Server
Commands:
Aliases:
- chars
- char
- ch
Arguments:
- 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
- 0 - Normal
- name_font - name of font you can get from /ch list. On example "Agency FB"
- type_font:
- animations <in / out> - show you builder <building/clearing> animations
- updater <updater_subcommand> - menager of auto updating chars
Examples of using:
- /ch build &2Welcome &fthere's &4Merbio
- /ch clear 1[/COLOR]
- /ch font 38 1 Agency FB
- /ch list 1
- /ch updater create chars_spawn 9
<Format>
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)
- /ch build &aGreen
- Text "green" from green wool
,or plugin can choose random color
- /ch build &XWelcome
- Text "Welcome" from random color wool
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:
- C - clay
- W - wool
- G - glass
- P - glass pane
Plugin have some alternative blocks. &(g-m)
- /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 @4#g&aGreen Dragon
- Animated Text "green dragon" from green glass
You can clear animation with effect(output animation). You can change this with using character "!".
- /ch build !1#c&8Drop Blocks
- /ch clear <id_of_this_chars>
- Dropping chars clearing animation effect ;]
You can create multiple chars (texts "starting in new line") with use character "\n".
- /ch build @6#g&aFirst Line\n@5#c&5Second Line
- Line: Animated text "First Line" from green glass
- Line: Animated text "Second Line" from purple clay
- Line: Animated text "First Line" from green glass
You can add to yours chars overline with use character "$".
- /ch build $w#c&4Car
- Text "Car" from red clay with black wool overline
Parameters: (similary like in color blocks)
- C - Black Clay
- W - Black Wool
- G - Black Glass
- P - Black Glass Pane
- L - LightBlock - Glowstone
Updater:
Main args:
/ch u <subcommand>
Subcommands:
- 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
Examples of using:
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.
/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
Removing updater from meganger.
/ch u remove n_spawn
Changing location and facing updater to player location, and changing update time to 15.
/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)
Video Tutorials:
- ENGLISH
- by Wukkit
by LtJim007
- POLISH
- by ServerKondzia (MinecraftKondziu)
Api Section:
Blocks builder class
Creating and removing chars
Changing builder settings
Creating auto changing chars
Plugin have many more function and classes, but I describe most usefull ;]
If you want to see its, use shorcuts "Alt + Space" on plugin clasess, or package "pl.merbio."
Have fun with it!
This is recoded version of CharsAPI, and many was changed there - on better :)
Great plugin ! Are there permissions ?
@Wukkit
thx, a lot :D
Reviewed your plugin! https:www.youtube.com/watch?v=DQ6aQ8WRoUM It's really good, keep up the good work.
@delsolsi213
I don't remeber :D I have over 300 fonts on my windows ;x And I remember only that font start on "C" xd
@Merbio1
whats the font you used for the charps api logo?
@THEREDBARON24
Thanks ;) There are no packets ;/ Everything is doing by getBlock().setType... i know that can be faster, but for now i no have lags when is creating single char (with normal or smaller font), or updater is working, but I thought about this to do it on packets D:
I just have to say that this could be a great tool for developing games. I have not read a lot into this, however, are you actually setting blocks, or just sending packets for block changes? At any rate, this is a great tool that can really add something new to a lot of servers that do not have the time to develop their own systems.
Added new full recoded and very extended version ;}
@super522
@xiurobert
Hello! ;]
Chars after reload / stop server are programmed to delete from map if someone on example create chars and after 2 minutes do something else and crash server, and unwanted chars stayed on map. Section "Save-chars" is for programmer so if u don't want to programe this ;] easiest way is trick with world edit. You must to select created chars and move this from location were that you create. I coulded programme this but i drop this old project version of this plugin ;c
Chars disappear after server stops
Hi there! This plugin works like a charm! However, after I run a
stop
or
reload
all of the chars disappear. I couldn't make no sense of you "save-chars" page, it was gibberish!
Hello
Plugin working fine, but 1 have issue.
When im create etc. "my server" that remove/delete when i restart or stop server. Any idea how that happed? Or how i get saved in my job :D
@Merbio1
I love this plugin, I love, I could add every 30 seconds repeat the effects of falling blocks. that is an example, that time can be changed in the config or a command ;)
could you add it?
Yes timer you can easy programe or use code from this tutorial: http://dev.bukkit.org/bukkit-plugins/charsapi/pages/timer/
On my tutorial of this plugin one person commented whether it would be possible to add looping animations of text, similar to the mineplex server or even a countdown timer.
https://www.youtube.com/watch?v=2jOsSDbZChA&feature=gp-n-y&google_comment_id=z12vxfiq4uf3fbdkd234iryhbpb5jxhj204
How do you make a timer for it like you have in the picture in minigames
Added 4 animations in version 1.3
@StephenTheHero
but the plugin working ok ? ,or I must change/repair something ? D:
So I was testing your plugin... http://i.imgur.com/ZKw5Olu.png (Image is too big for on here)
@REDsauce117
I was added "Simple Download", but to "normal" download plugins need to be approved ;/
Nine downloads and no download link?