Display Entities

适用于现代 Paper 和 Folia 服务器的简单全息插件。

资源图片
![](https://i.imgur.com/aziwQIL.png) [![GitHub Release](https://img.shields.io/github/v/release/Grabsky/DisplayEntities?logo=github&labelColor=%2324292F&color=%23454F5A)](https://github.com/Grabsky/DisplayEntities/releases/latest) [![Modrinth Downloads](https://img.shields.io/modrinth/dt/display-entities?logo=modrinth&logoColor=white&label=downloads&labelColor=%23139549&color=%2318c25f)](https://modrinth.com/plugin/display-entities) [![Discord](https://img.shields.io/discord/1366851451208601783?cacheSeconds=3600&logo=discord&logoColor=white&label=%20&labelColor=%235865F2&color=%23707BF4)](https://discord.com/invite/PuzqF2Yd5q) [![CodeFactor Grade](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** 是一个辅助插件,添加了用于操作服务器侧的显示实体、交互实体和(即将推出)试玩人偶的命令。支持 [**PlaceholderAPI**](https://github.com/PlaceholderAPI/PlaceholderAPI) 和 [**MiniMessage**](https://docs.advntr.dev/minimessage/format.html)。

### 但什么是 *显示实体* 呢? 显示实体是在 1.19.4 中添加的轻量级全息图实体。它们能够显示文本、物品和方块,并作为盔甲架的替代方案。您可以在 [**这里**](https://minecraft.wiki/w/Display) 了解更多信息。 ### 插件的工作原理是什么? 插件创建的每个实体都将*物理性*地保留在世界中,直到手动删除。这可以通过插件提供的命令或内置的、原生的命令来完成。 由于所有实体都是服务器端的,因此可以使用外部工具(例如 [**Axiom**](https://modrinth.com/mod/axiom))自由移动/缩放它们。 ### 这为什么是一个 *实用* 插件? 插件除了配置文件的本身和每个实体交互时附加到 PDC(持久数据容器)的必要数据之外,不会在本地存储任何内容。它对服务器的负担很小。 为了让插件更有用,它还支持 **MiniMessage** 和基于数据包的 **PlaceholderAPI** 钩子。这应该让它与您已经熟悉的任何全息图插件一样有用。
## 功能 - **纯粹的简洁性** 基于现有的 Bukkit 和 Paper API,不涉及 NMS 访问。 - **最小化的负担** 基本上是显示实体的用户友好型包装器。它附带的逻辑不多。 - **兼容性** 插件创建的实体是真实的实体,可以使用命令和其他插件进行修改。 - [**MiniMessage 支持**](https://docs.advntr.dev/minimessage/format.html) 文本显示实体能够解析 MiniMessage 格式。 - [**Folia 支持**](https://github.com/PaperMC/Folia) 设计在 Paper 和 Folia 服务器上运行。在需要时使用 Folia 调度程序 API。 - [**PlaceholderAPI 支持**](https://github.com/PlaceholderAPI/PlaceholderAPI) 文本显示中的占位符会按玩家解析并显示。 (需要 **[PlaceholderAPI](https://github.com/PlaceholderAPI/PlaceholderAPI)** 和 **[PacketEvents](https://github.com/retrooper/packetevents)**)
## 要求 此插件仅在 **Paper**(或 **Folia**)**1.21.4** 及更高版本上运行,并使用 **Java 21** 或更高版本驱动。
## 快速开始 小型指南,直到我最终能够创建一个文档页面为止。 ### 命令 键入 **/display help** 以查看可用命令列表。请确保您是服务器操作员或已将正确的权限应用于您的帐户。 ### 权限
点击展开可用权限列表。 ```yml # 管理命令 displayentities.command.display.help displayentities.command.display.clone displayentities.command.display.create displayentities.command.display.delete displayentities.command.display.reload displayentities.command.display.respawn displayentities.command.display.teleport # 编辑命令 (文本、方块、物品、交互) displayentities.command.display.edit.move_to # 编辑命令 (文本、方块、物品) displayentities.command.display.edit.scale displayentities.command.display.edit.view_range displayentities.command.display.edit.billboard displayentities.command.display.edit.brightness displayentities.command.display.edit.rotate_x displayentities.command.display.edit.rotate_y # 编辑命令 (文本) displayentities.command.display.edit.add_line displayentities.command.display.edit.remove_line displayentities.command.display.edit.set_line displayentities.command.display.edit.insert_line displayentities.command.display.edit.refresh_interval displayentities.command.display.edit.alignment displayentities.command.display.edit.background displayentities.command.display.edit.line_width displayentities.command.display.edit.see_through displayentities.command.display.edit.text_Shadow displayentities.command.display.edit.text_opacity # 编辑命令 (方块) displayentities.command.display.edit.block # 编辑命令 (物品) displayentities.command.display.edit.item # 编辑命令 (交互) displayentities.command.display.edit.width displayentities.command.display.edit.height displayentities.command.display.edit.response # 编辑命令 (方块、物品、交互) displayentities.command.display.edit.glow ```

## 编译 ```python # 克隆仓库。 $ git clone https://github.com/Grabsky/DisplayEntities.git # 进入克隆的仓库。 $ cd ./DisplayEntities # 编译和构建工件。 $ ./gradlew clean build ```
## 贡献 本项目对贡献开放。改进性能、添加新功能或修复 bug 的帮助都非常受欢迎。