- 资源类型
- 转载
- API版本
- 1.0.0
插件使用说明
使用方法
首先,你需要使用指令/hologram <全息ID>
创建一个新的全息实例(全息ID不能使用"edit"或"update")。如果你想要编辑或移除全息,可以使用命令
/hologram edit,
这将打开一个配置界面,你可以在其中更改全息的位置信息、文本内容等(该命令会自动选择离你最近的全息图。)(要使用颜色代码,可以用'&'替代'§')
创建新的全息图
a) 常规选项卡
在常规选项卡中,你可以更改全息图的位置、设置自动更新或移除全息图。- 你可以设置全息图的确切位置
- 在“移动”部分,你可以调整全息图的偏移量
- 底部可以移除全息实例或更改自动更新间隔(值小于0表示不更新),自动更新非常适合例如显示当前时间的场合。
b) 文本设置
在“文本设置”中,你可以更改或添加新的行和翻译。- 文本域(划分为翻译和行)
- 在此处你可以添加新行或翻译(或用负值删除)
c) 网格
从3.0版本开始,支持全息网格显示。在网格配置中启用此选项以网格形式显示全息图。手动创建
你可以直接在文本窗口键入行来创建网格,像这样:
网格来源
对于排行榜或某些实时统计,我建议使用网格来源,网格来源本质上是为网格提供数据的供应者,默认情况下,全息插件只提供MySQL网格来源,未来会增加更多的来源,同时,可以通过插件添加新的网格来源。
用法:
要使用网格来源,你必须在grids.yml配置文件中配置新的网格。
示例代码:
代码:grids: mysqlgrid: #网格名称 source: mysql #来源类型 offset: 0 #网格来源中的数据行偏移 limit: 10 #最大加载/显示的行数 refresh: 10 #重新加载数据的最小间隔(秒) data: #特定网格来源的数据(这里为mysql) columns: ["column1", "column3"] #可省略或留空以选择所有列 table: gridtable #获取数据的表或视图
- 数据标准化 - 标准化网格来源的结果,例如,结果为 "Tĥïŝ ĩš â fůňķŷ Šťŕĭńġ" 将被转为 "This is a funky String"。
- 列间距 - 定义两列之间的最小间距,4表示一个空格字符。
- 添加网格标题 - 如果使用MySQL,将在每个网格列上方显示MySQL列名。
列模板
当前版本的全息插件包含一些基本的游戏内数据展示自定义功能,其中之一是通过网格设置中的列模板。通过列模板,你可以更改列的格式或在列前后添加文本。另一个自定义是通过创建视图进行MySQL端的定制,推荐用于显示顶级统计或任何其他形式的结果显示。计划在未来的更新中增加更多方法以自定义来源输出及进行一些其他UI的更改。
配置:
代码:
#行之间的距离
lines_gaps: 0.3
#如果应异步压缩全息数据包
async_batch: false
#全息保存到配置文件的频率(分钟)
save_interval: 5
权限
hologram.use
- 使用/hologram
命令的权限翻译
全息插件还提供对多语言全息的基本支持,这意味着每个玩家都可以看到不同的文本。这一功能依赖于另一插件/库来告知全息插件玩家使用的语言。目前没有任何已知的公开语言插件,如果你是开发者,可以使用简单的API使翻译功能正常工作。占位符
你可以在全息插件中使用占位符来显示一些实际信息。为启用此功能,请安装提供相关功能的PlaceholderAPI插件。插件API
完整的API文档可以在此找到基本使用
PHP:
代码:
HologramAPI api = HologramAPI.getInstance(); //获取API实例
//在HologramAPI中有方法可以用于
- 获取全息实例
- 注册新的网格或网格来源