SpigotVIP AnimatedNames 8.0.0a

Tested Minecraft Versions:

• 1.7
• 1.8
• 1.9
• 1.10
• 1.11
• 1.12
• 1.13
• 1.14
• 1.15
• 1.16

Recommended refresh speed is 15 ticks. However I advise animations of 20 ticks. You can go lower depending on your server hardware (IT WILL NEVER LAGG YOUR SERVER, but it can cause slight flicker)

This supports the Tab Plugin (to enable turn off tab-colors in the config and restart)

Price has 21% VAT included according to EU regulations. Companies with a valid Tax ID can contact [email protected] to request an invoice for tax reports

Test it live @
testplugins.com






Everyone knows nametag right? A plugin that adds a prefix and suffix to your name and everyone knows the scoreboard under the name (bit boring if it isn't relevant information). This plugin enhances both the prefix, suffix and the scoreboard under the name.


You have 3 options you can configure.

• An animated prefix that can be whatever placeholder(s) you like that is not larger then 256 characters (1.13 or higher) or 16 characters (lower than 1.13)
  This can be an animation you create yourself line by line or a preset effect (for fast prototyping)
• An animated suffix that can be whatever placeholder(s) you like that is not largerthen 256 characters (1.13 or higher) or 16 characters (lower than 1.13)
  This can be an animation you create yourself line by line or a preset effect (for fast prototyping)
• A scoreboard under the player. Every placeholder that is a number can be shown. You can even loop through multiple stats or placeholders. The text behind the score(number) however is static for every player.
  It is not possible to use textual placeholders under the name. I removed this feature due to lack of performance and being buggy.
• You can not change the name itself (only prefix/suffix/name below)

The prefix and suffix can be configured multiple times in different groups so you can give Administrators different animations then normal members.

I give a great deal about performance. In the past I made a lot of plugins that did cool things,.. but I would never use them myself since I don't have the best hardware out there. TitleAdvanced, Tab, ActionBar and this one are plugins that are focused on performance rather then features (despite having a lot of features).

Keep in mind that there are some limitations:
- Invisibility potions will hide the player but not the name tag (this is a minecraft issue I can't fix)
- The name itself can't be changed
- The prefix/suffix name below applies to all players with that name. This incudes NPC's.
- The name below will appear on all players and npcs
- The number below is always white and has a space behind it
- you can't use multiline effects in name below
- Only Spigot or CraftBukkit are supported
- As mentioned above already (but once more) the score below the name consist of a white number in front and a static text that applies to all players at the back (so don't use placeholders that are player specific)
- As mentioned above already: The score below the name can not be altered meaning you can't use color codes or effects.

Requirements:
- MVdWPlaceholderAPI 2

FEATURES AND IDEAS:

• Have a color rainbow name (by putting a color as prefix)
• Show factions name in front of name (or behind)
• Show towny name in front of name (or behind)
• Show mcMMO levels or XP under the name
• Show Factions power level under the name
• Show GriefPrevention claimblocks count under the name
• Show how many times the player has played under the name
• Show VoteParty votes under the name
• And lots more numeric placeholders...

What makes this plugin worth the price?

• Those who know me from other plugins know that I value performance. This plugin won't cause lagg even with higher refresh intervals due to a 3 level refresh cycle that will prepare packets of animations on demand.
• There are no such plugins out there that animated it like this
• Lots and lots of placeholders to choose from. I know the size is limited but most placeholders are useful for the score or as prefix,suffix.
• Good support. Those who've seen me or requested features/problems on other plugins know that I try my best to reply as fast as possible and in case of a bug to fix it as fast as possible.
• Future updates. I am not going somewhere
  
• Continues testing both with computers as people: I hire people to test plugins in 'strange' ways (black and whitebox testing) on mayor updates. Also all my plugins are continuously checked with the latest spigot versions to notify me of any problems.
• Tab support: A lot of plugins in 1.8 do not show the prefix in the tab. I understand that in time they will update but its worth mentioning.
• Delivering something that looks simple from the outside, but is big when you open it. I try to make to the configs of all my plugins look the same (even if that makes it harder to implement it for me) just because I find it useless to create a different config for a plugin that looks similar from the outside (the thing the user sees)

THE MOST IMPORTANT THING OF THE PERMISSIONS YOU HAVE TO KNOW IS THAT DEFAULT THE GROUP 'default' IN THE CONFIGURATION IS GRANTED TO ALL USERS. TO PREVENT THIS USE NEGATIVE PERMISSIONS (OR RENAME THE GROUP).

Code (Text):

animatednames.reload:
description: Reload the configuration
default: op
animatednames.help:
description: Show plugin help
default: true
animatednames.uploadlog:
description: Upload log
default: op
animatednames.uploadconfig:
description: Upload config
default: op
animatednames.about:
description: About the plugin
default: true
animatednames.permissions:
description: List all permissions
default: true
animatednames.resetconfig:
description: Reset the configuration file
default: false
animatednames.group.default:
description: Default group
default: true

View attachment 11267

/animatednames
Main command: alias for /animatednames about

/animatednames about
Show the version information. ALWAYS give this version when reporting errors.

/animatednames uploadconfig
For the lazy ones this will upload the config (config.yml) to pastebin.
ALWAYS give this config when reporting errors.

/animatednames uploadlog
This is a SIMPLE log about the plugin it will upload that simple log to pastebin. It is recommended to still send the logs from the console rather then this log!

/animatednames resetconfig
Did a missile blow up your config (we all know it was you ) then use this to reset it.

/animatednames permissions
This gives a list of all default permissions in the plugin (commands, etc..)

/animatednames help
Shows a list of all commands. You can configure the help in the language file.

/animatednames reload
Reload the config and animations. You MAY notice a small 'out of sync' in the scoreboard under the name for the first 3 seconds. Always use this rather then reloading using plugman (What is not supported)


The configuration for the animations is divided in two parts. At first you have the different groups for prefix and suffix animations (or static text if you prefer) and under those groups you can configure the score that is applied to ALL users. Group weight is based on the position (top bottom).

There is no way to sort the tablist, meaning changing the priority/weight of the groups in the config won't do anything.

CONFIG.YML
Code (Text):

# ------------------------------ #
#
# AnimatedNames 7
# (c) Maxim Van de Wynckel
#
# ------------------------------ #

# About: Everyone knows plugins that allow you to have your group name
# in front of your name above your head. But this plugin does more then that
# with over 180+ placeholders and more to come every update this plugin not only
# allows placeholders in your name above your head but it also allows the name to
# be animated.

# Permissions: To use the animatednames groups give them the permission
# animatednames.group.<group> (ex. animatednames.group.default)
# Make sure to remove them from the other groupsd
# when giving a new permission.

# Commands: List of all commands
# /animatednames reload - Reload the configuration
# /animatednames help - See all commands

# Variables: These variables can be used in the TEXT section
# of both the header as the footer.
#
# {PLAYER} - Player name
# {PLAYERNICK} - Player nickname
# {PREFIX} - Player prefix
# And lots lots more (see Spigot Page) (5000+)

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
# GENERAL PLUGIN SETTINGS
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#

## Config version (DO NOT EDIT)
config: 4

## Language file
lang: 'en'

## Debug mode
debug: false

## Log to file
log:
enabled: true

## Update checking
update:
check: true # RECOMMENDED YOU LEAVE THIS TRUE

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
# PLUGIN SPECIFIC SETTINGS
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#

# Placeholder settings
placeholder:
# Force install all placeholders (NOT RECOMMENDED)
force-all: false
# logs the memory usage of placeholders on startup
log-memory: false
# Clear unused placeholders that are not enabled.
clear-unused: true
# Config cache only
# This will only use placeholders in the config
# HOWEVER: IT WILL BREAK ALL CUSTOM PLACEHOLDERS!
# IT WILL ALSO PREVENT ANY HOOKS (PlaceholderAPI)
config-cache: false

tweaks:
# If you have issues with non-legacy mode try this option. The option is more CPU intensive,
# but it is meant to detect problems
synchronized: false
# Setting this to true will keep tab names untouched
# Useful for those who do not want to change tab names but
# only the names above.
# NOTE: This shrinks the tab name by 2 chars
# so if you have a long name it becomes shorter
# This may also break nicknames in the tab
white-tabnames: false


# WARNING: The recommended interval for this plugin
# is calculated at 15 ticks (recommended 20 ticks)
# You can experiment with lower ticks but this might
# cause a slight flicker.


# AnimatedNames groups
# THESE ARE NOT PERMISSION GROUPS. THE NAMES DO NOT NEED TO MATCH
# YOUR PERMISSION GROUP.
# An AnimatedNames group is a group you assign to a player (or permission group)
# using animatednames.group.<GROUPNAME>
groups:
default: # This is the default group. Add as many as you wish
priority: 0 # A higher priority means it is sorted higher
# Prefix in front of the player name above their head
name-prefix:
# A list to create animations
frames:
# {PREFIX} will be replaced with the PERMISSION prefix (Vault)
# Meaning if your permission prefix is "[Mod]" it will show this
- '{PREFIX}'
# Animation interval in ticks (20 ticks = 1 sec)
interval: 100
# The display name above the player head (default {PLAYER})
name-suffix:
# A list to create animations
frames:
- '{SUFFIX}'
# Animation interval in ticks (20 ticks = 1 sec)
interval: 100
example-admin:
priority: 1 # A higher priority means it is sorted higher
name-prefix:
# A list to create animations
frames:
- '&4[&cAdmin&4] &c'
# Animation interval in ticks (20 ticks = 1 sec)
interval: 100

# Text below your name above your head
name-below:
# Set to false to disable the name under name (REQUIRES RESTART)
enabled: true
# A list to create animations
# Make sure that the placeholder is numeric!
# You have to put a number or numeric placeholder in the beginning
# or else you will get a "0" in front.
# This also means you can't have colors in front. The number is a set
# color you can't change.
frames:
- '{HEALTH}&cHealth'
- '{STAT_TIMESPLAYED}&6Times played'
# Animation interval in ticks (20 ticks = 1 sec)
interval: 20

When using inheritance you will have to negate previous groups in order to only have on group available.

Language file(s):
The plugin allows multiple language files in the /lang folder. If available the language messages from the client language will be used (when a langauge file in that language is available)



Add placeholders to this plugin or any other MVdW Placeholder plugin.
https://www.spigotmc.org/resources/mvdwplaceholderapi.11182/

WHAT TO DO AFTER BUYING:

1. Test the default config
2. Learn the default config see how it works, play with the values
3. For problems, please leave a message in the discussions
4. Have an idea or feature? Submit it: Most accepted features (that can be done fast) are placeholders
5. Do you like the plugin? Leave a rating it helps
   
6. Want to help improve the plugin? PM me your experience (timings, config, animations you made ,...) I want to know these things so I can base my placeholders, preset animations ,.. on things people actually use. Do not use skype for support as I rarly look at it
7. Are you a developer? Check out the API http://dl.mvdw-software.be/manuals/SpigotAnimationPluginsDevelopersGuide.pdf

The review section is not a place to post errors/questions/problems.