docs: add changelog for v2.x.x of FancyHolograms

2025-12-06 07:43:36 +00:00 · 2025-03-30 16:39:56 +02:00
parent ca77db6a97
commit 2361f4e761
1 changed files with 262 additions and 0 deletions
--- 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!