AdvancedDisplays

1.7.1 - 26.1.x support and Java 21

After a long time, the plugin has been updated to support Minecraft versions 1.19.4 up to 26.1.2. Another notable change is that the plugin was updated to use Adventure API 5.1.1. Because of this, the new minimum Java version is Java 21 even for 1.19.4-1.20.4 (althought you will need Java 25 for 26.1). Another consequence is that hover and click events won't work on Spigot servers (they do work on Paper or any of its forks) because, apparently, Adventure Platform Bukkit is also no longer maintained and sending components to Audiences wasn't working. As a workaround, if the plugin is running on a Spigot server, a legacy text message will be sent, which supports gradients but not click or hover components. Paper servers will work just fine. TL;DR: Minimum Java version is now Java 21 and messages won't be hoverable nor clickable on Spigot servers (Paper servers are unaffected). Latly, some errors have been fixed and some performance improvements were made, especially when a player joins the server. *This update doesn't bring config-breaking changes but, if you are migrating from previous versions, you might need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 26.1.2, although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

After a long time, the plugin has been finally updated to support all Minecraft versions from 1.19.4 to 1.21.11. This update also brings entity displays (show any mob, such as a zombie) and reworks how displays work, since now you can modify base entity settings too (such as being on fire, custom display name, etc). Other than that, many fixes and improvements have been implemented, such as: - Folia support - New particle action, fixes and cooldown setting. - Switch Adventure from Bungee to Bukkit platform. - Add more item meta options. - Add per-player pages for Text Displays (see new subcommands [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… - Head caching system (loads them on enable or reload to prevent excessive requests) - Add moveto subcommand. - Update project dependencies. - Support for 1.21.4+ custom model data components (see customModelData [here](https://lucaaa.gitbook.io/advanceddisplays/usage/item-meta) for more info) - Improvements to GUI system and inventory handling. - Many bug fixes. Some plans for future updates are: - In-game editor for actions. - Multiline displays (a display with text and items, for example) - Animated item and block displays - Entity metadata system (modify what entities in Entity Displays look like, such as wolf variant) *If you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21.11 although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

Fixed a bug when running the reload subcommand. *If you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21.5 although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

## Added: - 1.21.5 support. - Toast action (see [wiki](https://lucaaa.gitbook.io/advanceddisplays/usage/actions#… - Added conditions & error message for clicking displays (see [wiki](https://lucaaa.gitbook.io/advanceddisplays/usage/create-a… ## Bug fixes & changes: - Moved the distance and permission conditions to their own section (see [wiki](https://lucaaa.gitbook.io/advanceddisplays/usage/create-a… - Fixed an error that occurred when opening the display editor for displays with materials that don't have items. - Some classes were refactored. ## API changes: - Added [ADAPI#getDisplayFromLoc](https://javadoc.jitpack.io/com/github/Luncaaa/AdvancedDis… method. - Added [BaseDisplay#addViewCondition](https://javadoc.jitpack.io/com/github/Luncaaa/AdvancedDis… - Removed ItemDisplay#setMaterialHead in favour of [ItemDisplay#setBase64Head](https://javadoc.jitpack.io/com/github/Luncaaa/AdvancedDis… and [ItemDisplay#setPlayerHead](https://javadoc.jitpack.io/com/github/Luncaaa/AdvancedDis… - Added [ItemDisplay#setViewerHead](https://javadoc.jitpack.io/com/github/Luncaaa/AdvancedDis… *If you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21.5 although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

Fixed an issue which caused messages sent with the "message" action not to have click actions or hover (only colors were being parsed). *This update doesn't bring config-breaking changes but, if you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21.4, although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

An error will not be thrown when clicking the text alignment setting in the editor GUI. How text displays work has also been changed. Before, the text was being serialized and deserialized multiple times, but now it's only serialized once. Creating or editing a text display in-game will also set the strings in the config file to whatever was written in chat rather than the legacy text. For example, if you wrote "<red>Hello", that will be stored rather than "§cHello". Lastly, the dependencies have been updated, adventure is now shaded inside in a different location and NMS modules are dynamically shaded. *This update doesn't bring config-breaking changes but, if you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21.4, although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

This version only brings support for Minecraft 1.21.4 *This update doesn't bring config-breaking changes but, if you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21.4, although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

This update only brings some bug fixes: - The view distance will now work correctly (the wrong method was used before). - Clicking on entities created by other plugins won't cause an error now. *This update doesn't bring config-breaking changes but, if you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21.3, although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

This version supports Minecraft versions 1.19.4 to 1.21.3 and, apart from some minor fixes & improvements, the player and console command and message actions support lists instead of just one parameter. Check [this section](https://lucaaa.gitbook.io/advanceddisplays/usage/actions) of the wiki for more information. *This update doesn't bring config-breaking changes but, if you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21.3 although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

Some items' meta can now be modified to change how they look in item displays. These items are potions, tipped arrows, armors, banners, shields, compasses and bundles. To see which properties you can modify, see [this section of the wiki](https://lucaaa.gitbook.io/advanceddisplays/usage/create-a… Additionally, dependencies were updated and some unnecessary shadings were removed, reducing the jar size from 2.26MB to under 1MB. *This update doesn't bring config-breaking changes but, If you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21.1 although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

This release features new subcommands for text displays: nextPage, previousPage and setPage, which will allow you to change the page (or animation) the display is showing. Every display now has a new setting: hide-permission. Players with that permission won't be able to see the display even if they have the permission set in permission. In summary, to see the display, players must be closer than view-distance, have the permission permission and not have the hide-permission permission. Additionally, item displays can now show items with custom model data. To do that, change the number in the customModelData setting. Bug fixes include: - Displays spawning in the incorrect world. - Some items in the editor GUI not working. - Placeholders with minimessage text not being parsed. - Texts added via the editor GUI being added before the current texts (they are now added to the last position). *If you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21 although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

Apart from 1.21.1 support, the main new feature is the addition of attached displays. They will be attached to a wall to look like a sign or a billboard. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… for more information. This update also adds support for ItemsAdder items and blocks. You only need to add the "itemsAdder" setting to your item or block displays' config file. Lastly, the /ad finishEditing subcommand has been renamed to /ad finish and it can be used to cancel the creation of an attached display. *This update doesn't bring config-breaking changes but, If you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21.1 although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

Block and item displays can now show Oraxen items. To use Oraxen items and blocks, add `oraxen: "<Oraxen ID>"` to the settings of a display. The in-game editor can now have disabled settings. You can set them in the config.yml file or using the BaseDisplay#openEditor(Player player, List disabledSettings) if you are using the API. The /ad finishEditing subcommand no longer requires a permission. Lastly, the plugin is now compiled using Gradle rather than Maven and NMS is now provided by paperweight-userdev rather than Spigot's BuildTools. However, the plugin should still be compatible with Spigot. The API is now obtained from "com.github.Luncaaa:AdvancedDisplays:{PLUGIN VERSION}" and setting text displays now requires an Adventure component. However, you can use the ComponentSerializer, which supports both legacy and minimessage, to parse text into a component. *If you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21 although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.

Displays have 2 new options: "permission", which can be "none" or a permission that players need to see the display; and "view-distance", which can be 0.0 or any number which is the distance at which the player must be from the display to see it. The API has methods to change these values as well. Additionally, a bug which caused text displays to not appear has been fixed and the way colors are parsed has been improved. *If you are migrating from previous versions, you will need to use the "/ad convert" command. CREATE A BACKUP OF YOUR DISPLAYS FOLDER BEFORE CONVERTING! More information on this command [here](https://lucaaa.gitbook.io/advanceddisplays/usage/commands… I have tested this plugin on Paper 1.21 although I may have missed some bugs. If you encounter any, please report it on [GitHub](https://github.com/Luncaaa/AdvancedDisplays/issues) or Discord, not on the reviews section. Visit the [wiki](https://lucaaa.gitbook.io/advanceddisplays) for more information.