HolographicDisplaysAPI汉化（呸，新手指引）

本帖最后由 zyx2 于 2017-8-15 20:10 编辑

零、引言

这编辑器真心想哭，和我预览完全不同

全息图API是相对其他插件API来说比较简单的一款，也是比较实用的一款，很多服务器都装了这个插件，所以我斗胆翻译一下

~~才不会说为了绿宝石不择手段之类的话呢~~

一、打开你的全息图[1]世界

1、下载全息图API插件（here）

2、把他像引入你的craftbukkit(spigot)一样引入

3、在你的“plugin.yml”内加入以下内容：

softdepend: [HolographicDisplays]

复制代码

如果你的插件必须使用全息图API你可以加上以下代码：

@Override
public void onEnable() {
if (!Bukkit.getPluginManager().isPluginEnabled("HolographicDisplays")) {
getLogger().severe("*** HolographicDisplays is not installed or not enabled. ***");
getLogger().severe("*** This plugin will be disabled. ***");
this.setEnabled(false);
return;
}
// Rest of the code
}

复制代码

二、创建你的全息图/添加文本

Plugin plugin = ... //你的插件
Location where = ... //创建位置
Hologram hologram = HologramsAPI.createHologram(plugin, where);//创建
textLine = hologram.appendTextLine("A hologram line");//添加文字

复制代码

如何获得一个Plugin实例？

Bukkit.getPluginManager().getPlugin("插件名称");

复制代码

如何获得一个Location实例？

1、player.getLocation();

复制代码

2、Location l = new Location(World world,double x,double y,double z)

复制代码

world可以用Bukkit.getWorld();取得

三、修改你的全息图/显示物品

在第一行前面加入一个基岩，并修改成草方块

ItemLine itemLine = hologram.insertItemLine(0, new ItemStack(Material.BEDROCK));
itemLine.setItemStack(new ItemStack(Material.GRASS));

复制代码

注意：全息图和数组一样，下标从0开始

如果你的下标错误，将会报“ArrayOutOfBoundsException”错误

提示：你可以像List一样使用“hologram.size()”

四、移动/删除你的全息图

你完全可以像操作一个实体一样操作你的全息图，使用

hologram.teleport(Location location);//移动

删除全息图：

hologram.delete();

作者的一个例子（让全息图跟随玩家移动）：

final Hologram hologram = HologramsAPI.createHologram(plugin, player.getLocation().add(0.0, 2.0, 0.0));
hologram.appendTextLine("Chat > Message");
new BukkitRunnable() {
// We don't want the task to run indefinitely
int ticksRun;
@Override
public void run() {
ticksRun++;
hologram.teleport(player.getLocation().add(0.0, 2.0, 0.0));
if (ticksRun > 100) { // 100 ticks = 5 seconds
hologram.delete();
cancel();
}
}
}.runTaskTimer(plugin, 1L, 1L);

复制代码

五、实例：如何设置一个显示名字的物品

效果图

Location where = ... // Suppose you have a random location in your minigame
String text = ChatColor.GOLD + "" + ChatColor.BOLD + "Fire Resistance";
ItemStack icon = new ItemStack(Material.BLAZE_POWDER);
final Hologram hologram = HologramsAPI.createHologram(this, where.add(0.0, 0.6, 0.0));
hologram.appendTextLine(text);
ItemLine itemLine = hologram.appendItemLine(icon);
itemLine.setPickupHandler(new PickupHandler() {
@Override
public void onPickup(Player player) {
// Play a sound
player.playSound(player.getLocation(), Sound.LEVEL_UP, 1F, 2F);
// Play an effect
player.playEffect(floatingItem.getLocation(), Effect.MOBSPAWNER_FLAMES, null);
// 1 minute of fire resistance
player.addPotionEffect(new PotionEffect(PotionEffectType.FIRE_RESISTANCE, 60 * 20, 0));
// Delete the hologram
hologram.delete();
}
});

复制代码

六、实例：为每位玩家显示不同的全息图

需要Protocol Lib

1、创建一个全息图

Hologram hologram = HologramsAPI.createHologram(player.getLocation());

2、获取可见性控制器（VisibilityManager 我不知道如何翻合适）

VisibilityManager visiblityManager = hologram.getVisibilityManager();

3-1、设置全息图的隐藏、显示
visibilityManager.setVisibleByDefault(false);
所有玩家都将看不见这个全息图

visibilityManager.setVisibleByDefault(true);
它又重新回来了

3-2、设置只有指定玩家看得见全息图
visibilityManager.showTo(player);
visibilityManager.setVisibleByDefault(false);
这样做将只有指定玩家能看见全息图

visibilityManager.setVisibleByDefault(true);
visibilityManager.resetVisibilityAll();
这是重置方法

4、注意事项[在1.8中]
请在setVisibleByDeafult之前使用showTo否则将没有人能看见这个全息图
hideTo(player) 和 showTo(player) 不应该在同一个tick中调用
请在添加行之前使用显示控制器【重要呀！】

七、后记

注释1 全息图：https://github.com/filoghost/HolographicDisplays

站内搬运帖：http://www.mcbbs.net/thread-647590-1-1.html

全息图API（英文）：https://filoghost.me/HolographicDisplays/

如果后续作者还有什么特性更新我会陆续更新

如果对你有帮助留下你的人气哟

我讨厌这个编辑器，一个代码部分我要搞好几次-.-难过

HolographicDisplaysAPI汉化（呸，新手指引）

回复: