AnimatedScoreboard icon

AnimatedScoreboard -----

An animated and anti-flicker scoreboard plugin with 1500+ placeholders, effects and eventtriggers



About this plugin:
AnimatedScoreboard is a fully customizable and flickerless scoreboard plugin. It supports over 1500 placeholders, thanks to the PlaceholderAPI. It also includes custom tags/effects!
It is also able to handle unlimited scoreboards per world and scoreboards based on permissions.
It is free and will always be free.
Works on every 1.8 - 1.21 Spigot server.


[​IMG]
Outdated image: 1.13 or higher now supports infinite lines length starting from v0.2.0

Features:
  • A lag-free anti-flicker, even when using very advanced scoreboards that exist of many different animations
  • Fully compatible with nametag / tablist plugins such as NameTagEdit
  • Fully compatible with other plugins that (temporarily) use the sidebar such as mcMMO
  • Per line settings: interval, randomness and score
  • Supports placeholders to modify the scores (red numbers on the right side)
  • Over 1500 placeholders with the PlaceholderAPI
  • Custom made tags/effects and event triggers which supports every event!
  • No line length limit on server version 1.13 or newer (Lines are limited to 32 characters including colorcodes when using 1.12 or lower)
  • On server version 1.16 or newer you have full RGB support (format: &#hexcolor)
  • On server version 1.20.3 or newer you have the ability to hide the red numbers on the sidebar.
  • Multiple scoreboards per world
  • Permission-based scoreboards with hooks into LuckPerms, GroupManager and zPermissions to automatically change scoreboards if permission changes
  • Toggle, reload, list and switch command
  • Custom placeholders: %animatedscoreboard_enabled% and %animatedscoreboard_scoreboard%. More information about them can be found here.
  • An API for replacing and editing certain lines
The most used scoreboard plugin on Spigot:
[​IMG]
Config file:
  • Set the scoreboards per world and a global scoreboard.
  • Add permissions to certain scoreboards
  • Enable/disable PlaceholderAPI, event triggers, automated update checker
  • Set the player storage type
  • force-legacy option: If you're running a 1.13+ server but use ProtocolSupport or ViaBackwards to allow <1.12 to join you have to enable this if you want the scoreboard to look correctly on all client versions
Code (YAML):
#Here you can set per world scoreboards <worldname>:<filename>
#If you don't add a world here in will not have a scoreboard in that world!
#World has 2 scoreboards, it will activate them based on how the are
#listed, in this example it will first look if players can have adminboard and if
#not switch to defaultscoreboard
worlds
:
  #The global scoreboard is not required and can be removed without causing any issues. The plugin will just hide the scoreboard in that case.
  global
:
 - adminboard
  - globalscoreboard
  world
:
 - adminboard
  - defaultscoreboard
  world_the_end
: endscoreboard
  world_nether
: netherscoreboard
#Now only players with the permission animatedscoreboard.test will get the scoreboard
permissions
:
  adminboard
: animatedscoreboard.test


#If this is set to true it will try to use PlaceholderAPI placeholders
placeholderapi
: true
#If this is set to true it will check on SpigotMC if there is a new version available for the plugin and notify you!
check_updates
: true
#When this is true it will send info messages to the console, this is more usefull if something is going wrong
debug_mode
: false
#This will enable the event triggers, if this is set to false the event triggers won't work
enable-triggers
: false

# What data storage should we use:
# - YAML    : stores the player data in human readable form in playerdata.yml
# - SQLITE   : stores the player data in a local SQLite database called playerdata-sqlite.db
player-storage
: SQLITE

# Only enable this if you're running a 1.13+ server.jar but still accept clients below 1.13
force-legacy
: false

# Attempt to parse colors inside of placeholders.
hex-in-placeholders
: true
ASB supports 3 different scoreboard syntaxes since version 0.2.6, the file below contains the default scoreboard file but there are easier syntaxes that can be seen here.
Code (YAML):
scores :
  # Whether scores (red numbers) on server versions 1.20.3 or newer should be hidden
  hidden
: true

#This is where you create the scoreboard, the first section will always be the title.
#Every section after that will be a line displayed on the scoreboard. You can have a max
#of 15 lines display due to the limitations of minecraft.
display
:
    #This is the first section, it will always be the title of the scoreboard.
    #You can also use placeholders here if you want.
    title
:
      #This is the text that will be display as the title, it can have as many lines as you want and it will automatically rotate through them or
      #choose a random one, depending on what you set random to.
      text
:
     - "&lA"
      - "&lAn"
      - "&lAni"
      - "&lAnim"
      - "&lAnima"
      - "&lAnimat"
      - "&lAnimate"
      - "&lAnimated"
      - "&lAnimated "
      - "&lAnimated S"
      - "&lAnimated Sc"
      - "&lAnimated Sco"
      - "&lAnimated Scor"
      - "&lAnimated Score"
      - "&lAnimated Scoreb"
      - "&lAnimated Scorebo"
      - "&lAnimated Scoreboa"
      - "&lAnimated Scoreboar"
      - "&lAnimated Scoreboard"
      - "&c&lAnimated Scoreboard"
      - "&lAnimated Scoreboard"
      - "&c&lAnimated Scoreboard"
      - "&lAnimated Scoreboard"
      - "&c&lAnimated Scoreboard"
      - "<stay ticks=100>&lAnimated Scoreboard</stay>"
      #If this is true there will be a random line every time it updates.
      #If it is false than it will rotate through them and you can make some animations with it.
      random
: false
      #The time between updates, 20 ticks is 1 second.
      #Every x ticks it will go to the next line, if random is false, once all lines are displayed it will go to the first line.
      interval
: 2
    #This section is the first line, here you set the data of that line. It doesn't matter what the name of the section is, as long
    # as there is no other section with the exact same name
    line-1
:
      #Same as with the title, no limit on text. If you just put " " here it will display a blank line on the scoreboard.
      text
:
     - " "
      #If it should be random or not.
      random
: false
      #The time between updates, 20 ticks is 1 second.
      #Every x ticks it will go to the next line, if random is false, once all lines are displayed it will go to the first line.
      interval
: 200
      #The score display next to the text, this can only be a number and not removed.
      # If the score of the other lines are higher than this one, they will be displayed above this one.
      score
: 99
    line-2
:
      text
:
     - "&a&lWelcome %player_name%"
      - "&b&lWelcome %player_name%"
      - "&c&lWelcome %player_name%"
      random
: false
      interval
: 5
      score
: 98
    line-3
:
      text
:
     - " "
      random
: false
      interval
: 20
      score
: 97
    #This animation works together with the line below it. The interval is the same so it displays the data at the same time.
    line-4
:
      text
:
     - "&aYour gamemode:"
      - "&aYour location:"
      - "&aYour world:"
      random
: false
      interval
: 60
      score
: 96
    #This animation shows the actual data of the player
    line-5
:
      text
:
     - "  &b%player_gamemode%"
      - "  <update ticks=1>&bX:%player_x% Y:%player_y% Z:%player_z%</update>"
      - "  &b%player_world%"
      random
: false
      interval
: 60
      score
: 95
    #This is another blank line to split up the scoreboard in multiple parts, you can have multiple lines with the same text displayed on the scoreboard.
    line-7
:
      text
:
     - " "
      random
: false
      interval
: 200
      score
: 95
    #In this animation random is set to true so it will go randomly through all the text and display it on the scoreboard.
    #In this case it will just change the color of the text but it could be anything and you are also able to use placeholders here.
    line-8
:
      text
:
     - "&1Random Rotation"
      - "&2Random Rotation"
      - "&3Random Rotation"
      - "&4Random Rotation"
      - "&5Random Rotation"
      - "&6Random Rotation"
      - "&7Random Rotation"
      - "&8Random Rotation"
      - "&9Random Rotation"
      - "&aRandom Rotation"
      - "&bRandom Rotation"
      - "&cRandom Rotation"
      - "&dRandom Rotation"
      - "&eRandom Rotation"
      - "&kRandom Rotation"
      - "&lRandom Rotation"
      - "&mRandom Rotation"
      - "&nRandom Rotation"
      - "&oRandom Rotation"
      - "&rRandom Rotation"
      random
: true
      interval
: 1
      score
: 94
    line-9
:
      text
:
     - " "
      random
: true
      interval
: 1
      score
: 93
    #It will display the player's health here with hearts, you can also use score=%placeholder% if you have PlaceholderAPI installed
    line-10
:
      text
:
     - "<health full=&4 half=&c empty=&f update=5>❤</health>"
      random
: false
      interval
: 10
      score
: "0"
    #Here we will repeat | 10 times, you can also use times=%placeholder% if you have PlaceholderAPI installed
    line-11
:
      text
:
     - "<repeat times=10>|</repeat>"
      random
: false
      interval
: 10
      score
: 0
    line-12
:
      text
:
     - ""
      random
: false
      interval
: 10
      score
: "-1"
    line-13
:
      text
:
     - "<scroll space=5 width=16 update=10>&6Don't forget to leave a 5 star rating</scroll>"
      random
: true
      interval
: 1
      score
: "-2"
    #1.13+ supports up to 128 characters per scoreboard line!
    line-14
:
      text
:
     - "&aIf you're using 1.13 or higher you will see a really long line of text here!"
      random
: true
      interval
: 1
      score
: "-2"
#You are able to add more lines to the scoreboard if you want, this scoreboard is just to explain all the possibilities of this plugin.

Tutorial videos:
Turkish Tutorial video by @EsadTemel (v0.2.3)



Spanish Video by @Ajneb97 (v0.1.5)


English Video by @LtJim007 (v0.0.7)

Text effects / tags:
  • <update ticks=x stay=y>text</update>: The update tag has 2 arguments: ticks, how often the line should update. And stay, how long the line should stay. Update lets the text update multiple times when displayed on the scoreboard.
  • <stay ticks=x>text</stay>: The stay tag has 1 argument, ticks, 20 ticks being 1 second. Stay lets the text stay for longer than the interval of that line.
  • <repeat times=x>text</repeat>: The repeat tag has 1 argument: times, which is the amount of times the text should be repeated.
  • <scroll space=x width=y update=z>text</scroll>: The scroll tag has 3 arguments: space, width and update. Space indicates how many spaces there are between different lines, defaulting to 1. Width is how many characters there are displayed every update, default is 16. And update is for how often the line goes to the next frame, if set to 20 it will update every 1 second.
  • <health full=x half=y empty= z update=w>❤</health>: The health tag comes with 4 arguments: full (default: &4, half (default: &c), empty (default: &f) and update (default: 5). Full indicates the part of the healthbar that is still full. If there is half a hearth than half will be the color of that character. When the health is empty the color of empty will be used. Update indicates how often the health bar will refresh.
  • <gradient start=&#ff0000 end=&#0000ff>text</gradient>: Uses two different arguments; the starting hex color and the ending hex color. It will create a gradient starting from the start color for the first character and slowly transition to the end color for the last character.

Event triggers:
  • What are event triggers? Event triggers are custom listeners for events (e.g.: when a block is broken), when the event is called the corresponding scoreboard will show for a certain amount of time.
  • How can I use them? You are able to add unlimited triggers, for 100% of the events in all plugins. If you want the event triggers to work and look for when events are called you will need to set the 'enable-triggers' option to true in the config.yml file.
  • An example of multiple triggers that work together:
[​IMG]

Optional dependencies:
  • PlaceholderAPI (Highly recommended!): Make sure that you download the correct placeholder packs as well. Example for downloading the Player placeholder pack: /papi ecloud download Player
  • MVdWPlaceholderAPI (Less recommended): Another placeholder plugin that can be used. However, this plugin will only work in combination with at least one of his other plugins!
Frequently asked questions:
Please take a look here before creating a message on the forums or starting a private conversation with me!
Is this plugin compatible with other plugins?
Yes, this plugin is compatible with all other scoreboard plugins such as NametagEdit and Tablist.

My placeholders aren't working!
Make sure that you have PlaceholderAPI installed and that you have also downloaded the correct placeholder pack using /papi ecloud download <pack>.

Can I remove the red numbers on the right-hand side of the scoreboard entirely?
Yes, if both your client & server are running 1.20.3 or newer then the red numbers are hidden by default. You can change that behaviour by setting the hidden setting to false in the configuration of that scoreboard (check the default example scoreboard configuration on this page).

If you're running an older version or if you're accepting older versions then unfortunately, no, Minecraft doesn't allow you to remove those numbers from the serverside. However, you can remove them using a texture pack in newer versions (client version 1.17 or newer).

My scoreboard gets cut off on my 1.13+ server when someone joins with 1.12 or lower!
Enabling the force-legacy option in the config.yml should fix this issue but you'll be limited to 32 characters.

How can I make the text/scoreboard smaller?
I cannot change the font size by only using a plugin. Either add less text to the scoreboard or decrease the GUI scale of your client (options -> video settings -> Gui Scale)

<player> lost connection: Internal Exception: java.lang.NullPointerException: Cannot invoke "java.util.Collection.isEmpty()" because the return value of "net.minecraft.network.protocol.game.PacketPlayOutScoreboardTeam.e()" is null
This error is not caused by ASB but rather by running an outdated version of [Animated Tab] - TabList. Update that plugin and the error will no longer occur.


Commands:
  • /animatedscoreboard: The main command, runs as /asb help.
  • /animatedscoreboard help: Gives a list of all the commands and their arguments and aliases.
  • /animatedscoreboard reload: Will reload all the configs and display the new scoreboards, so when you changes something just hit save and do /asb reload.
  • /animatedscoreboard toggle [on | off] [player]: This will toggle the scoreboard on or off for you or another player. Possible arguments are on, off and player
  • /animatedscoreboard list: This will give a list of all the loaded and active scoreboards.
  • /animatedscoreboard switch <scoreboard> [player]: This allows you to switch your own scoreboard or the scoreboard of another player to the scoreboard specified in this command.
Permissions:
  • animatedscoreboard.admin: Grants permission to use /asb reload
  • animatedscoreboard.help: Grants permission to use /asb help
  • animatedscoreboard.info: Grants permissions to use /asb info
  • animatedscoreboard.toggle: Grants permission to use /asb toggle
  • animatedscoreboard.toggle.other: Grants permission to toggle the scoreboard of someone else
  • animatedscoreboard.list: Grants permission to use /asb list
  • animatedscoreboard.switch: Grants permission to use /asb switch
  • animatedscoreboard.switch.other: Grants permissions to switch the scoreboard of someone else
  • animatedscoreboard.*: Grants all permissions this plugin has


Bugs, Suggestions or questions?
If you have anything of the above, please start a private conversation with me!
(Spigot has disabled the ability to start a private conversation if you do not have enough public forum posts, so post a message on my profile if you cannot start a conversation)
I try to add all suggestions, but it can some time take a while. Please note, not all suggestions can be added.


Please don't use the review section for bugs or suggestions :)

This plugin makes use of bStats for Metrics.
Resource Information
Author:
----------
Total Downloads: 457,570
First Release: Mar 28, 2016
Last Update: Jun 13, 2024
Category: ---------------
All-Time Rating:
188 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings