1.0
release
Fancy Tags
Simply put images in chat. No resource pack needed.
1,10k
Fancy Tags
Screenshot from ingame
Fancy Tags
A fully resource pack free solution for textured UI elements, such as rank tags and prefixes but also buttons and displays. Fancy Tags is an all in one tag management plugin that generates and keeps track of image components for you.
With support for PlaceholderAPI, MiniPlaceholders and a developer API, this plugin can be used easily by any server admin.
Features
Commands
The root command is ``/fancytags`` but ``/tags`` exist as a shorter alias.
All commands use the same permission ``fancytags.command``.
Below is a list of all sub-commands. | Syntax | Function | | ----------- | ----------- | | generate <name> [file|url] <path> | Generates and imports a ``n*8 x 8`` image remotely or locally as a tag. | | list | List all registered tags. | | view <name> | View information and actions for a tag. | | delete <name> | Delete a tag. | | rename <oldname> <newname> | Rename a tag. | | reload | Reloads the plugin, and it's configs. |
Usage
The plugin offers support for PlaceholderAPI, and the tags can be accessed via the placeholder ``%tags_<name>%`` (ex. ``%tags_admin%`` or ``%tags_youtube%``). There is also support for MiniPlaceholders and can be accessed via the placeholder ``<fancytags_tag:<name>>`` (ex. ``<fancytags_tag:admin>`` or ``<fancytags_tag:youtube>``)
⚠️ DISCLAIMER
MiniMessage currently does not support these kind of head components, and thus don't work at all right now when using PlaceholderAPI. This is not a bug. This will be fixed when MiniMessage adds support. MiniPlaceholders does work!
Config
Full config
```yml
The tags are only cached on the client for 5 minutes after rendering,
which means to have a seamless experience with no visual "skin loading"
the players have to be sent all the tags regularly.
This is done by sending a title pushed off-screen on join, and continuously on a timer.
cacheSettings:
Whether cache updates should be sent.
enabled: true
Whether players should be sent cache updates on join.
onJoin: true
Whether players should continue being sent cache updates.
onTimer: true
How frequent the timer runs, in seconds.
intervalDuration: 300
The ratio of how much spacing is needed to push the tags off-screen in the title
Each "spacing" consists of 2 spaces, which is as wide as a player head component,
and the ratio is how many spacings per player head.
If the tags are visible on-screen, consider raising this number.
(This is mostly because the title feature has not been tested on larger screen sizes,
this is very likely subject to change)
offScreenRatio: 2.5
Settings for the MineSkin API (mineskin.org).
MineSkin is used for the skin signature generation.
mineSkinSettings:
Your project's MineSkin API key.
If you don't have one already, create an account and get one at https://account.mineskin.org/keys/
apiKey: ""
The visibility of the generated skin.
PUBLIC - Will be publicly shown on the MineSkin website
UNLISTED - Can only be accessed via the link
PRIVATE - Not accessible by anyone besides the account owner. NOTE: This option is locked to paid plans only.
visibility: UNLISTED
If you have a paid plan on MineSkin for faster generation,
you can put your higher limits below.
If you don't have a paid plan, this can be ignored
If you however don't know what to put, leave the mode at AUTO and it will sort itself out
limits:
The mode for what limits to use. Can be AUTO for automatic allowance retrieving, or CUSTOM to use your own values.
mode: AUTO
How many milliseconds between each request.
This value is ignored when mode is set to AUTO
intervalMillis: 200
How many requests to handle concurrently.
This value is ignored when mode is set to AUTO
concurrency: 1 ```
Showcase
There are so many things you can do with tags, and these are only a handful that I've done myself.
Buttons
This is a menu used in this plugin itself, which utilizes tags in the form of buttons.
Colored tags
By coloring grayscale tags, the same texture can be reused for more customization. Here they are used for showing what team a player might be on.
Tall and rounded
It is possible to achieve 9 pixel tall tags that come with 2 rounded corners. In this example, it was done by deliberately making the tag missing the bottom and right side, and then apply a full opacity black shadow. This is shown in the before and after images (image 1 and image 2).