FOLIA ✅ PAPER ✅ PURPUR ✅ 1.19.4 - 1.21.5 ✅
一款易于使用的、基于数据包的文本/物品/方块显示全息 API,支持 MiniMessage 和表情符号。
功能特性
- 文本、方块与物品全息图
- 文本动画
- 支持 MiniMessage
- 基于数据包
- 玩家专属全息图
- 排行榜生成器
- 高级全息图自定义
- 支持附加(Attachment)和父级关联(Parenting)
- 灵活的渲染模式
免责声明
此 API 仅适用于 1.19.4+ 版本Bedrock(基岩版)玩家无法看到这些全息图
在旧版本上使用 Spigot 时可能会出现一些问题(建议使用 Paper 或其分支)
这只是一个 Java API。此插件不能独立运行。
设置
- 下载插件 .jar 文件
- 下载 Packet Events
- 将 .jar 文件上传到服务器(yourserver/plugins 文件夹)
- 在你的插件中将此插件添加为依赖项并使用它
项目设置
Gradle 安装
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
compileOnly 'com.github.HologramLib:HologramLib:1.7.6'
}
Maven 安装
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
<dependency>
<groupId>com.github.HologramLib</groupId>
<artifactId>HologramLib</artifactId>
<version>1.7.6</version>
<scope>provided</scope>
</dependency>
将此添加到你的 plugin.yml 中:
depend:
- HologramLib
代码示例
获取实例
private HologramManager hologramManager;
@Override
public void onLoad() {
HologramLib.onLoad(this); /* 仅当你阴影化(shade)了 HologramLib 时才需要 */
}
@Override
public void onEnable() {
hologramManager = HologramLib.getManager().orElse(null);
if (hologramManager == null) {
getLogger().severe("Failed to initialize HologramLib manager.");
return;
}
}
创建全息图
TextHologram hologram = new TextHologram("unique_id")
.setMiniMessageText("<aqua>Hello world!")
.setSeeThroughBlocks(false)
.setBillboard(Display.Billboard.VERTICAL)
.setShadow(true)
.setScale(1.5F, 1.5F, 1.5F)
.setTextOpacity((byte) 200)
.setBackgroundColor(Color.fromARGB(60, 255, 236, 222).asARGB())
.setAlignment(TextDisplay.TextAlignment.CENTER)
.setViewRange(1.0)
.setMaxLineWidth(200);
生成与移除
hologramManager.spawn(hologram, <location>);
hologramManager.remove(hologram);
动画
TextAnimation animation = new TextAnimation()
.addFrame( "<red>First frame")
.addFrame("<green>Second frame")
.addFrame("Third frame\n" +
"Second line in third frame")
.addFrame("Last frame");
animation.setDelay(20L); // 1 秒
animation.setDelay(20L * 2);
hologramManager.applyAnimation(this.hologram, animation);
排行榜
Map<Integer, String> leaderboardData = new LinkedHashMap<>() {{
put(1, "MaximDe:1000");
put(2, "dream:950");
put(3, "BastiGHG:500");
put(4, "Wichtiger:400");
// ... 更多条目
}};
LeaderboardHologram leaderboard = hologramManager.generateLeaderboard(
location,
leaderboardData,
LeaderboardHologram.LeaderboardOptions.builder()
.title("Top Players - Kills")
.showEmptyPlaces(true)
.scale(1.2f)
.maxDisplayEntries(10)
.suffix("kills")
.topPlayerHead(true)
.build()
);
Wiki
代码示例及更多内容
示例/展示插件
更多信息
FOLIA ✅ PAPER ✅ PURPUR ✅ 1.19.4 - 1.21.5 ✅
An easy-to-use, packet-based text/item/block display hologram API with MiniMessage and emoji support.
FEATURES
- Text, Block & Item Holograms
- Text animations
- Minimessage support
- Packet based
- Per player holograms
- Leaderboard generators
- Advanced hologram customization
- Attachment and parenting support
- Flexible rendering modes
DISCLAIMER
This API only works on 1.19.4+The holograms do not work for Bedrock players
There can be some issues when using spigot on older versions (Preferably use Paper or a fork of it)
It's just a Java API. This plugin does not work standalone.
SETUP
- Download the plugin .jar
- Download Packet Events
- Upload the .jar files onto your server (yourserver/plugins folder)
- Add the plugin as a dependency to your plugin and use it
PROJECT SETUP
Gradle installation
repositories {
maven { url 'https://jitpack.io' }
}
dependencies {
compileOnly 'com.github.HologramLib:HologramLib:1.7.6'
}
Maven installation
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
<dependency>
<groupId>com.github.HologramLib</groupId>
<artifactId>HologramLib</artifactId>
<version>1.7.6</version>
<scope>provided</scope>
</dependency>
Add this to your plugin
plugin.yml
depend:
- HologramLib
Code examples
Getting the instance
private HologramManager hologramManager;
@Override
public void onLoad() {
HologramLib.onLoad(this); /*Only needed if you shade HologramLib*/
}
@Override
public void onEnable() {
hologramManager = HologramLib.getManager().orElse(null);
if (hologramManager == null) {
getLogger().severe("Failed to initialize HologramLib manager.");
return;
}
}
Creating a hologram
TextHologram hologram = new TextHologram("unique_id")
.setMiniMessageText("<aqua>Hello world!")
.setSeeThroughBlocks(false)
.setBillboard(Display.Billboard.VERTICAL)
.setShadow(true)
.setScale(1.5F, 1.5F, 1.5F)
.setTextOpacity((byte) 200)
.setBackgroundColor(Color.fromARGB(60, 255, 236, 222).asARGB())
.setAlignment(TextDisplay.TextAlignment.CENTER)
.setViewRange(1.0)
.setMaxLineWidth(200);
Spawning and despawning
hologramManager.spawn(hologram, <location>);
hologramManager.remove(hologram);
Animations
TextAnimation animation = new TextAnimation()
.addFrame( "<red>First frame")
.addFrame("<green>Second frame")
.addFrame("Third frame\n" +
"Second line in third frame")
.addFrame("Last frame");
animation.setDelay(20L); // 1 second
animation.setDelay(20L * 2);
hologramManager.applyAnimation(this.hologram, animation);
Leaderboard
Map<Integer, String> leaderboardData = new LinkedHashMap<>() {{
put(1, "MaximDe:1000");
put(2, "dream:950");
put(3, "BastiGHG:500");
put(4, "Wichtiger:400");
// ... more entries
}};
LeaderboardHologram leaderboard = hologramManager.generateLeaderboard(
location,
leaderboardData,
LeaderboardHologram.LeaderboardOptions.builder()
.title("Top Players - Kills")
.showEmptyPlaces(true)
.scale(1.2f)
.maxDisplayEntries(10)
.suffix("kills")
.topPlayerHead(true)
.build()
);
Wiki
Code examples & more
Example/Showcase Plugin
More info
下载 HologramLib | 排行榜与自定义全息
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HologramLib | 排行榜与自定义全息
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HologramLib | 排行榜与自定义全息
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HologramLib | 排行榜与自定义全息
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HologramLib | 排行榜与自定义全息
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HologramLib | 排行榜与自定义全息
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HologramLib | 排行榜与自定义全息
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HologramLib | 排行榜与自定义全息
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HologramLib | 排行榜与自定义全息
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HologramLib | 排行榜与自定义全息
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
更新内容
- 提升依赖版本
- Bug 修复
Modrinth 上跳过的版本:
- 1.8.2 @RootException 在 #41 中改进了排行榜中的数字格式
- 1.8.1 依赖更新 更新了 FoliaLib 的版本 更新了 packetevents 的版本 更新了 EntityLib 的版本
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧