#

# v2.4.2 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 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 2024-11-02

Added support for 1.21.2 and 1.21.3
Fixed holograms.yml file resets sometimes
Improved logging

# v2.3.3 2024-08-19

fix exceptions thrown from PlayerResourcePackStatusEvent listener on < 1.20.2 by @Grabsky in #138

# v2.3.2 2024-08-14

Added support for 1.21.1

# v2.3.1 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 2024-06-19

Added support for 1.21
Maintain rotation when using moveHere subcommand

# v2.2.0 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 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 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 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 2023-12-12

Added support for 1.20.4 🎉
Added info command
Added support for legacy colors (&c &4 &n etc.)

# v2.0.3 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?

stop the server
take a backup of your server and FancyHolograms folder
replace the old FancyHolograms jar with the new one
start the server
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 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 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 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 2023-06-01 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!