From 2361f4e7611bf5326e149cbe4262ac41be5780d5 Mon Sep 17 00:00:00 2001 From: Oliver Date: Sun, 30 Mar 2025 16:39:56 +0200 Subject: [PATCH] docs: add changelog for v2.x.x of FancyHolograms --- docs/src/fancyholograms/changelog/v2.md | 262 ++++++++++++++++++++++++ 1 file changed, 262 insertions(+) diff --git a/docs/src/fancyholograms/changelog/v2.md b/docs/src/fancyholograms/changelog/v2.md index c4f44c38..b5776a1b 100644 --- a/docs/src/fancyholograms/changelog/v2.md +++ b/docs/src/fancyholograms/changelog/v2.md @@ -5,3 +5,265 @@ order: 2 ![](../../static/changelog_v2_x_x.png) # + +## v2.4.2 [!badge variant="info" text="2025-01-16"] + +- Added the first converter to convert holograms from DecentHolograms to FancyHolograms (/fancyholograms convert DecentHolograms *) +- Added translate command +- Improved scheduler stability and fixed a memory leak +- Fixed exception thrown when sending resource-packs in the config stage + +**API changes:** + +- You can now send the hologram events sync and async -> you can spawn and hide holograms synchronically now +- Added HologramsConverted event + +## v2.4.1 [!badge variant="info" text="2024-12-08"] + +- Added support for 1.21.4 +- Added brightness command +- Added per command permissions +- Scale hologram, when linked npc is scaled + +**API changes:** + +- Hologram#getDisplayEntity is now deprecated and will be removed next version +- Added experimental getter & setter for interpolation duration + +## v2.4.0 [!badge variant="info" text="2024-11-02"] + +- Added support for 1.21.2 and 1.21.3 +- Fixed holograms.yml file resets sometimes +- Improved logging + +## v2.3.3 [!badge variant="info" text="2024-08-19"] + +- fix exceptions thrown from PlayerResourcePackStatusEvent listener on < 1.20.2 by @Grabsky in #138 + +## v2.3.2 [!badge variant="info" text="2024-08-14"] + +- Added support for 1.21.1 + +## v2.3.1 [!badge variant="info" text="2024-08-03"] + +- Added center command +- Added nearby command +- Load holograms dynamically based on world loading +- Added missing dependencies to paper-plugin.yml +- Add world name to hologram list +- Added manual visbility (api) +- Refresh holograms once resource-pacls are loaded +- Many more fixes & performance upgrades + +## v2.3.0 [!badge variant="info" text="2024-06-19"] + +- Added support for 1.21 +- Maintain rotation when using moveHere subcommand + +## v2.2.0 [!badge variant="info" text="2024-06-07"] + +- Major performance improvements +- Added persistent flag +- Fixed holograms not disappearing when removing +- API changes + +**Pull requests:** + +- Major Code Rewrite by @OakLoaf in #94 +- Persistent, Inpersistent(temporary) holograms by @UsainSrht in #96 +- Bukkit Color by @UsainSrht in #95 +- Added new property Viewer for hologram. #99 by @BigTows in #100 +- readme changes by @Grabsky in #103 + +## v2.1.0 [!badge variant="info" text="2024-05-21"] + +- Added support for 1.20.5 and 1.20.6 +- Certain commands can now be run via console +- Included sources and javadoc to API module +- Added support for "see through" (text holograms only) +- Added 3-axis support for scale command +- The copy subcommand now maintains yaw and pitch + +**Pull requests:** + +- Add support for see through Text Holograms by @OakLoaf in #85 +- Add support for 1.20.5 by @OliverSchlueter in #83 +- 3-axis support for scale sub-command by @Grabsky in #86 +- Updated paperweight to 1.7.1 by @OakLoaf in #91 +- Made onEnable respect muted version notifications by @OakLoaf in #89 +- Fixed duplicate files in jar by @OakLoaf in #92 +- Made copy command maintain rotation by @OakLoaf in #90 + +## v2.0.6 [!badge variant="info" text="2024-03-03"] + +- Fixed remove subcommand +- Run version checks async +- Fixed a bug with visibility range +- Add permission to hide holograms +- Don't allow dots in name + +## v2.0.5 [!badge variant="info" text="2024-01-27"] + +- Added 'save_on_changed' config option: holograms will be saved after modifying it +- Improved shown state for players +- Showing and hiding is now done completely async +- Other performance improvements +- Fixed default visibility distance +- Fixed yaw in moveTo command + +## v2.0.4 [!badge variant="info" text="2023-12-12"] + +- Added support for 1.20.4 🎉 +- Added info command +- Added support for legacy colors (&c &4 &n etc.) + +## v2.0.3 [!badge variant="info" text="2023-11-17"] + +**Item & Block Holograms** + +I'm happy to introduce item and block holograms in FancyHolograms 2.0.3 - one most requested feature since the first version. + +Until now you could only create text holograms with FancyHolograms, but starting with v2.0.3 you are also able to create holograms with a different type. + +How to create item & block holograms? +The create commands has changed a little bit: /hologram create (text|block|item) (hologram name) +Each hologram and only be of one type: text, block or item. You can not have items inside a text hologram (but you can create two holograms and move the item hologram over the text hologram). + +How to modify item and block holograms? +There are two new commands: + +/hologram edit (hologram) item +(execute this command while holding an item of your choice in your main hand.) + +/hologram edit (hologram) block (block type) + +Billboard, scale, rotation etc. + +You are able to change the billboard, scale, position, shadow and rotaion of all hologram types (text, item and block) + +How to migrate from a older version of FancyHolograms? + +1. stop the server +2. take a backup of your server and FancyHolograms folder +3. replace the old FancyHolograms jar with the new one +4. start the server +5. done! + +I hope you will enjoy the new big feature! I can't wait to see what you are going to do with the new hologram types. + +## v2.0.2 [!badge variant="info" text="2023-10-19"] + +- Added rotatepitch subcommand +- Added moveHere subcommand +- Added pagination for /hologram list +- Added per-hologram visibility distance +- Fixed issues with 1.19.4 +- Fixed linking with npc +- Fixed some scale issues +- Fixed a tab completion bug +- ADDED SUPPORT FOR 1.20.2 + +## v2.0.1 [!badge variant="info" text="2023-08-21"] + +- Fixed deleted holograms not being removed from config +- Added "/fholo" as alias for "/hologram" +- Sort holograms by name in config +- Many bug fixes ... + +## v2.0.0 [!badge variant="info" text="2023-06-30"] + +**Version Implementations** + +FancyHolograms is now compatible with multiple versions in one jar! + +Currently the following versions are supported: +- `1.19.4` +- `1.20` +- `1.20.1` + +**Enhancements** + +- Text alignment command + - You can now change how the text should be aligned (left, center, right) +- Full Documentation + - All exposed classes are now fully documented. +- Data Decoupling + - All data for the hologram is now decoupled from the hologram and its implementations + - Data can be updated without directly modifying the hologram entity +- Simplified Modification Process + - Data modifications on the hologram now happen in steps + - update hologram data + - update hologram + - push changes to players +- Enhanced Eventing + - The hologram update event now exposes both old and new data + - Hologram events + - `HologramCreateEvent` -> `HologramCreateEvent` + - `HologramRemoveEvent` -> `HologramDeleteEvent` + - `HologramModifyEvent` -> `HologramUpdateEvent` + - `HologramSpawnEvent` -> `HologramShowEvent` + - +`HologramHideEvent` +- Hologram Data + - Background Color + - Now accepts hex color codes + - Now accepts `reset` or `default` to return to the original background color + - Text Update Interval + - Now accepts `never` or `off` or `none` to disable updating + - Now accepts second and minute units, ex. `10s` instead of `200` + - Hologram Position + - Now accepts relative coordinates + - Can be relative to the hologram's current location using `~` + - Can be relative to the player's current location using `~~` +- Command Completions + - Intelligently suggests only relevant options + +There might accure errors while updating from a previous version and you might have to remake all holograms. + +If you found any bug, please report them (create an issue or go to the discord server). + +Thank you Sxtanna for putting so much effort into this! + +## v2.0.0-pre1 [!badge variant="info" text="2023-06-01"] [!badge variant="warning" text="Pre release"] + +**Version Implementations** + +- `1.19.4` +- `1.20` & `1.20.1` + +**Enhancements** + +- Full Documentation + - All exposed classes are now fully documented. +- Data Decoupling + - All data for the hologram is now decoupled from the hologram and its implementations + - Data can be updated without directly modifying the hologram entity +- Simplified Modification Process + - Data modifications on the hologram now happen in steps + - update hologram data + - update hologram + - push changes to players +- Enhanced Eventing + - The hologram update event now exposes both old and new data + - Hologram events + - `HologramCreateEvent` -> `HologramCreateEvent` + - `HologramRemoveEvent` -> `HologramDeleteEvent` + - `HologramModifyEvent` -> `HologramUpdateEvent` + - `HologramSpawnEvent` -> `HologramShowEvent` + - +`HologramHideEvent` +- Hologram Data + - Background Color + - Now accepts hex color codes + - Now accepts `reset` or `default` to return to the original background color + - Text Update Interval + - Now accepts `never` or `off` or `none` to disable updating + - Now accepts second and minute units, ex. `10s` instead of `200` + - Hologram Position + - Now accepts relative coordinates + - Can be relative to the hologram's current location using `~` + - Can be relative to the player's current location using `~~` +- Command Completions + - Intelligently suggests only relevant options + +If you found any bug, please report them (create an issue or go to the discord server). + +Thank you Sxtanna for putting so much effort into this! \ No newline at end of file