---
icon: dot
order: 2
---

![](../../static/changelog_v2_x_x.png)

# 

## v2.5.0 [!badge variant="info" text="2025-04-24"]

- Added support for Minecraft 1.21.5
- Refactored config structure
- Added `update_visibility_interval` config option

## 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!