CharsAPI

CharsAPI

17.8k Downloads

https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif
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 :)

http://i57.tinypic.com/rclbsw.png

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:

  1. Normal
  2. Fonts
  3. Animations (Actual: 18 input, 6 output)

Installing fonts:

Example web with fonts: DaFont

  1. Fonts:
    1. On server:
      Open plugins > CharsApi > Fonts > put there your fonts
    2. On local system (Windows):
      Open Control Panel > Fonts > drop there your font
  2. 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
    • name_font - name of font you can get from /ch list. On example "Agency FB"
  • 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
    1. Line: Animated text "First Line" from green glass
    2. Line: Animated text "Second Line" from purple clay

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 :)

Old CharsApi Page

Click!