Display Entities

<div align="center"> !(https://i.imgur.com/aziwQIL.png) (https://img.shields.io/github/v/release/Grabsky/DisplayEntities?logo=github&label=%20&labelColor=%2324292F&color=%23454F5A)](https://github.com/Grabsky/DisplayEntities/releases/latest) (https://img.shields.io/modrinth/dt/display-entities?logo=modrinth&logoColor=white&label=downloads&labelColor=%23139549&color=%2318c25f)](https://modrinth.com/plugin/display-entities) (https://img.shields.io/discord/1366851451208601783?cacheSeconds=3600&logo=discord&logoColor=white&label=%20&labelColor=%235865F2&color=%23707BF4)](https://discord.com/invite/PuzqF2Yd5q) (https://img.shields.io/codefactor/grade/github/Grabsky/DisplayEntities?logo=codefactor&logoColor=white&label=%20)](https://www.codefactor.io/repository/github/grabsky/displayentities/issues/main) **DisplayEntities** is an utility plugin adding commands for manipulation of server-side Display Entities, Interaction Entities and Mannequins (NPCs). Comes with (https://github.com/PlaceholderAPI/PlaceholderAPI) and (https://docs.advntr.dev/minimessage/format.html) support. </div> <br/> ### 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 (https://minecraft.wiki/w/Display). ### 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 (https://modrinth.com/mod/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. <br/> ## 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. - (https://docs.advntr.dev/minimessage/format.html) Text display entities are capable of parsing MiniMessage formatting. - (https://github.com/PaperMC/Folia) Designed to run on Paper and Folia servers. Folia Scheduler APIs are used when needed. - (https://github.com/PlaceholderAPI/PlaceholderAPI) Placeholders inside text displays are parsed and displayed per-player. ^{(Requires **(https://github.com/PlaceholderAPI/PlaceholderAPI)** and **(https://github.com/retrooper/packetevents)**)} <br/> ## Requirements Plugin runs only on **Paper** (or **Folia**) **1.21.10** and above, powered by **Java 21** or higher. <br/> ## Getting Started Plugin documentation can be found here: **(https://grabsky.github.io)** <br/> ## Compiling ```python # Cloning the repository. $ git clone https://github.com/Grabsky/DisplayEntities.git # Entering the cloned repository. $ cd ./DisplayEntities # Compiling and building artifacts. $ ./gradlew clean build ``` <br/> ## Contributing This project is open for contributions. Help in regards of improving performance, adding new features or fixing bugs is greatly appreciated.