Перейти к содержимому
Mineforgian

Display Entities

Holograms and NPCs plugin for modern Paper and Folia servers.

Загрузки
1K
Подписчики
15
Обновлён
19 июня 2026 г.
Лицензия
MIT

Опубликован 29 апреля 2025 г.

GitHub Release Modrinth Downloads Discord bStats Servers CodeFactor Grade

DisplayEntities is an utility plugin adding commands for manipulation of server-side Display Entities, Interaction Entities and Mannequins (NPCs). Comes with PlaceholderAPI and MiniMessage support.


But what are Display Entities?

Display entities are lightweight hologram-like entities added in 1.19.4. They are capable of displaying text, items and blocks, and serve as an alternative to armor stands. You can read more here.

How does the plugin work?

Each entity created by the plugin will be physically kept in the world until manually removed. This can be done either by plugin-provided command or built-in, vanilla commands.

Since all entities are server-side, you can move / scale them freely with external tools such us Axiom.

How is that an utility plugin?

Plugin does not store anything on it's own except configuration file and necessary data attached to the PDC (Persistent Data Container) of each entity it interacts with. It leaves minimal footprint on the server.

To make the plugin a bit more useful, it comes with MiniMessage support and packet-level PlaceholderAPI hook. That should possibly make it as useful as any other holograms plugin you're already familiar with.


Features

  • Pure Simplicity
    Based on existing Bukkit and Paper APIs with no NMS access involved.

  • Minimal Footprint
    Basically a user-friendly wrapper around display entities. There's not much logic attached to it.

  • Compatibility
    Entities created by the plugin are real entities that can be modified with commands and other plugins.

  • MiniMessage Support
    Text display entities are capable of parsing MiniMessage formatting.

  • Folia Support
    Designed to run on Paper and Folia servers. Folia Scheduler APIs are used when needed.

  • PlaceholderAPI Support
    Placeholders inside text displays are parsed and displayed per-player.
    (Requires PlaceholderAPI and PacketEvents)


Requirements

Plugin runs only on Paper (or Folia) 1.21.10 and above, powered by Java 21 or higher.


Getting Started

Plugin documentation can be found here: grabsky.github.io


Compiling

# Cloning the repository.
$ git clone https://github.com/Grabsky/DisplayEntities.git
# Entering the cloned repository.
$ cd ./DisplayEntities
# Compiling and building artifacts.
$ ./gradlew clean build

Contributing

This project is open for contributions. Help in regards of improving performance, adding new features or fixing bugs is greatly appreciated.

Ченджлог

1.7.1+23Релиз26.1.1, 26.1.2, 26.2 · 19 июня 2026 г.
  • Added 26.2 as a supported version.
  • FastStats is now shaded.
1.7.0+22Релиз26.1, 26.1.1, 26.1.2 · 10 июня 2026 г.
  • also run commands on left-click
  • add transparent background color
  • add --slim boolean flag skin command
  • allow setting skins from textures.minecraft.net URLs
  • add rotate_x, rotate_y commands for mannequin displays
  • Do not reset yaw/pitch when creating mannequin display
  • fix refresh_text_displays_upon_resource-pack_load
1.6.2+21Релиз1.21.11, 26.1, 26.1.1 · 8 апреля 2026 г.
  • Dependency updates and FastStats analytics to soon replace bStats.
  • Tested plugin on 26.1.X and it seems to work perfectly fine.
    • Marked this version as supported on Modrinth.
1.6.1+20Релиз1.21.10, 1.21.11 · 11 января 2026 г.
  • Added /display edit (mannequin) scale (scale) command for changing scale of mannequin display.
1.6.0+19Релиз1.21.10, 1.21.11 · 7 января 2026 г.
  • Added support for Mannequin entity type. This lets you easily create and modify server-side NPCs. You can modify following properties:
    • Skin
    • Glow
    • Pose
    • Tracking
    • Equipment
    • Description
    • Custom Name
    • Click Commands
    • All commands and permissions are listed in documentation.
  • Added /display edit (display) click_command (commands) for interaction entities and mannequins.
  • Added documentation page: https://grabsky.github.io/
  • Plugin now only supports 1.21.10 and above. This is to keep things simple and maintainable. I do not intend on removing support for older versions unless there's a reason to do so, like this time - a new game feature.
1.5.0+17Релиз1.21.9, 1.21.10, 1.21.11 · 15 августа 2025 г.

Version 1.5.0 brings a few new commands.

  • /display teleport (display) - Teleports you to the specified display.
  • /display edit (display) glow (@none | color) - Modifies glowing color on specified display. This only works for item and block displays.
  • /display edit (display) transform (transform) - Sets the transform of item display.

I still have not figured out a way to automatically update help entries in the configuration file - so as with prior releases - you need to update them manually or reset messages section in the config.yml file. Otherwise new commands won't appear in help menu.

1.4.0+16Релиз1.21.6, 1.21.7, 1.21.8 · 30 июля 2025 г.

Version 1.4.0 brings basic support for interaction entities. While they are technically not display entities and therefore don't share many properties with other display types, they are still useful and ability to manipulate them makes a good addition to the plugin. This implementation will likely be expanded upon in the future.

Commands & Permissions

Command: /display create interaction (name)
Permission: displayentities.command.display.create

Command: /display edit (interaction) width (width)
Permission: displayentities.command.display.edit.width

Command: /display edit (interaction) height (height)
Permission: displayentities.command.display.edit.height

Command: /display edit (interaction) move_to (x) (y) (z)
Permission: displayentities.command.display.edit.move_to

Command: /display edit (interaction) response (true | false)
Permission: displayentities.command.display.edit.response

1.3.3+14Релиз1.21.6, 1.21.7, 1.21.8 · 5 июля 2025 г.
  • Minor code clean-up with no logic changes.
  • Brief testing was done. Plugin works correctly on Paper 1.21.7 and Folia 1.21.6 with no code changes required.

EDIT: Now also marked as 1.21.8 compatible.

Комментарии

Загружаем…