ScoreboardLib 1.0.1

A flicker-free scoreboard library with support of text up to 48 characters.

  1. TigerHix
    A flicker-free scoreboard library with support of text up to 48 characters.

    What is ScoreboardLib?

    ScoreboardLib is a flexible library for adding pretty, animated scoreboards to your plugin without requiring you to figure out how to get rid of random flickers or limitations. This library is introduced to dealt with following problems in the original API and similar libraries:
    • Scoreboards cannot display text of more than 16 characters. Solved.
    • Scoreboards cannot display the same text more than once. Solved.
    • The scoreboard is flickering all the time. Solved.
    • Random disappearance of lines. Solved.

    Any screenshots?

    Feel the awesomeness.

    Other reasons to use ScoreboardLib?

    • Simple to use. You just have to decide the user interface, ScoreboardLib already got the backend handled.
    • Displays up to 48 characters instead of 16.
    • Easy to implement animated text with help of ScrollableString and HighlightedString.
    • Designed to be scalable and flexible.
    • Performant. ScoreboardLib doesn't create a scoreboard every time the content is updated.
    • Can be used as a standalone plugin, or be shaded into your project.

    How do I add it to my project?

    Simply add the following to your pom.xml.

    Code (Text):

    Now you are able to create your own pretty scoreboards.

    How do I use it?

    First, you have to decide whether you use ScoreboardLib as a standalone plugin, or you just go shade it into your own plugin. For the latter case, you have to add following code to your onEnable():
    Code (Text):
    To let ScoreboardLib holds a reference to your plugin and hence able to schedule tasks, register events, etc.

    For the scoreboard itself, here is an usage example:
    Code (Text):
    for (Player player: getServer().getOnlinePlayers()) {
        Scoreboard scoreboard = ScoreboardLib.createScoreboard(player)
            .setHandler(new ScoreboardHandler() {

                private final ScrollableString scroll = new ScrollableString(Strings.format("&aThis string is scrollable!"), 40, 0);
                private final HighlightedString highlighted = new HighlightedString("This string is highlighted!", "&6", "&e");

                public String getTitle(Player player) {
                    return null;

                public List<Entry> getEntries(Player player) {
                    return new EntryBuilder()
                        .next("    " +
                        .next("    " +
                        .next("    &b&lCURRENT TIME MILLIS")
                        .next("    " + System.currentTimeMillis())
                        .next("    &c&lCURRENT NANO TIME")
                        .next("    " + System.nanoTime())
                        .next("    &7This line is equivalent to another line")
                        .next("    &7This line is equivalent to another line")

    Which would display a scoreboard as shown in the above gif to all online players.

    To remove the scoreboard, use:
    Code (Text):
    That's really much of it. If you want to extend the functionalities somehow, simply create a new class that extends SimpleScoreboard, and start overriding methods, creating constructors, etc.


    Source code released under GNU LGPL License. Star it if you like it.

    My other resources:
    If you have any questions, ask them in the thread - after all, posting an error log in the review section wouldn't help anyone :(
    If ScoreboardLib helps you, consider leaving a like. A review would be also appreciated!

Recent Reviews

  1. JifPom
    Version: 1.0.1
    Really really good resource. but i cant figure out why the lines align to the left. it makes the board look very very bulky :/
  2. catman2014_
    Version: 1.0.1
    The library is amazing and easy to use. However the maven repository is broken, and it seems to be unmaintained. I would recommend using a fork.
  3. TheViperShow
    Version: 1.0.1
    This library worked great! It's very simple to use and saved me a lot of time during dev.
  4. LoryTheRock
    Version: 1.0.1
    Wow! This library met one of my most important needs! It is also great for creating scoreboards, as it is very simple to use.
  5. Elikill58
    Version: 1.0.1
    Easy to use and to update scoreboard. The problem is that the scoreboard is flickering
  6. 2DevsStudio
    Version: 1.0.1
  7. TheJorgeMC
    Version: 1.0.1
    It works really good, love it, super easy to use <3
  8. cella
    Version: 1.0.1
    Please add update method, the rest is super good, it worked for me, only that is missing, if you put it would be perfect!

    Sorry, bad english xd
  9. Wowserman
    Version: 1.0.1
    What a Lifesaver!

    Implemented this into some of my plugins, I've always had problems with flickering scoreboards but not any more!

    Thanks 10/10 and will recommend.
  10. MisterMel
    Version: 1.0.1
    Very easy to use and it just works!
    Its litteraly SO simple. The EntryBuilder is really handy and not complicated AT ALL. For anyone looking for a good scoreboard lib, this is your way to go!