AdvancedDisplays

# 1.7.2 - 26.2 & 26.3 support and Placeholder condition type This update brings support to the newest Minecraft versions along with a new condition type: `placeholder`, which while only execute actions / show the display if the player has certain placeholder values. You can read more about this [here](https://lucaaa.gitbook.io/advanceddisplays/usage/conditions). The actions' conditions have been moved to now be per-action. Instead of having the `conditions` section inside `actions`, it will now be inside each individual action so that, for example, a player can right-click a display but not left-click it. I have tested this plugin on Paper 26.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.

# 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-and-permissions/convert-subcommand). 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-and-permissions)) - 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-and-permissions/convert-subcommand). 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-and-permissions/convert-subcommand). 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#toast)). - Added conditions & error message for clicking displays (see [wiki](https://lucaaa.gitbook.io/advanceddisplays/usage/create-a-display/base-settings)). ## **Bug fixes & changes:** - Moved the distance and permission conditions to their own section (see [wiki](https://lucaaa.gitbook.io/advanceddisplays/usage/create-a-display/base-settings)). - 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/AdvancedDisplays/main-b5a43f104e-1/javadoc/me/lucaaa/advanceddisplays/api/ADAPI.html#getDisplayFromLoc(org.bukkit.Location,double,boolean)) method. - Added [BaseDisplay#addViewCondition](https://javadoc.jitpack.io/com/github/Luncaaa/AdvancedDisplays/main-b5a43f104e-1/javadoc/me/lucaaa/advanceddisplays/api/displays/BaseDisplay.html#addViewCondition(me.lucaaa.advanceddisplays.api.conditions.Condition)) - Removed ItemDisplay#setMaterialHead in favour of [ItemDisplay#setBase64Head](https://javadoc.jitpack.io/com/github/Luncaaa/AdvancedDisplays/main-b5a43f104e-1/javadoc/me/lucaaa/advanceddisplays/api/displays/ItemDisplay.html#setBase64Head(java.lang.String)) and [ItemDisplay#setPlayerHead](https://javadoc.jitpack.io/com/github/Luncaaa/AdvancedDisplays/main-b5a43f104e-1/javadoc/me/lucaaa/advanceddisplays/api/displays/ItemDisplay.html#setPlayerHead(java.lang.String)). - Added [ItemDisplay#setViewerHead](https://javadoc.jitpack.io/com/github/Luncaaa/AdvancedDisplays/main-b5a43f104e-1/javadoc/me/lucaaa/advanceddisplays/api/displays/ItemDisplay.html#setViewerHead()) *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-and-permissions/convert-subcommand). 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-and-permissions/convert-subcommand). 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-and-permissions/convert-subcommand). 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-and-permissions/convert-subcommand). 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-and-permissions/convert-subcommand). 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-and-permissions/convert-subcommand). 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.