LogoArcartX Doc

全息图/文字/血条

ArcartX全息图片、文字与血条系统配置指南

心有它的理性,为理性所不知。

全息

ArcartX提供了全面的全息渲染，支持由脚本驱动的客户端全息图片、文字渲染，让你实现丰富的视觉效果。

全息模板

配置位置

全息模板配置位于ArcartX根目录的 hologram/data 目录下，你可以创建多个全息模板配置文件。

基础结构

# 全息宽高设置
width: 500  # 用于确定旋转轴和中心位置
height: 500
 
# 触发器配置
action:
  open:   # 开始触发器
  close:  # 结束触发器
 
# 元素配置
element:
  # 可配置图片和文字两种元素

元素类型

1. 贴图元素

texture:
  type: "texture"
  attribute:
    x: "0"          # X坐标 [支持脚本]
    y: "0"          # Y坐标 [支持脚本]
    width: "500"    # 宽度 [支持脚本]
    height: "500"   # 高度 [支持脚本]
    alpha: "1.0"    # 透明度 [支持脚本]
    path: "[location]emoji/test.png"  # 贴图路径 [静态]

2. 文字元素

example:
  type: "text"
  attribute:
    x: "0"          # X坐标 [支持脚本]
    y: "0"          # Y坐标 [支持脚本]
    alpha: "1"      # 透明度 [支持脚本]
    font: "test.ttf" # 字体 [静态]
    fontSize: 50    # 字号 [静态]
    lineSpace: 16   # 行距 [静态]
    texts:          # 文本内容 [支持脚本]
      - "~&1示例文字"  # 使用~开头表示纯文字内容

全息系统的运算在渲染线程进行，请避免创建过于复杂的运算逻辑。

世界全息显示

配置位置

世界全息配置位于 hologram/location 目录下。

配置示例

example:
  world: "world"    # 显示世界
  x: -966          # X坐标
  y: 110           # Y坐标
  z: 186           # Z坐标
  yaw: 45          # 水平旋转角度
  pitch: 45        # 垂直倾斜角度
  follow: false    # 是否跟随玩家视角
  hologram: "全息示例"  # 全息模板名

生物血条系统

配置位置

生物血条配置位于 hologram/entity_heal_bar 目录下。

血条配置

example:
  match:           # 匹配的生物名称
    - "boss"
  keepTime: 5000   # 显示持续时间(-1为永久)
  fadeTime: 500    # 淡入淡出时间
  hologram: "测试血条"  # 血条模板名

血条模板示例

width: 324
height: 29
action:
  open: |-
    var.alpha = Lerp(0,1,1000)  # 淡入效果
element:
  # 背景贴图
  texture:
    type: "texture"
    attribute:
      x: "0"
      y: "0"
      width: "324"
      height: "29"
      alpha: "var.alpha"
      path: "[location]entity_heal_bar/background.png"
      
  # 血条贴图
  bar:
    type: "texture" 
    attribute:
      x: "6"
      y: "21"
      width: "318 * val.health / val.maxHealth"  # 根据血量计算宽度
      height: "8"
      alpha: "var.alpha"
      path: "[location]entity_heal_bar/bar.png"

血条系统提供以下特殊变量:

  • val.health: 生物当前血量
  • val.maxHealth: 生物最大血量
  • val.name: 生物名称

拓展功能

通过API接口，全息系统还可以实现:

  • 伤害显示特效
  • 悬浮称号
  • 脚下光环特效
  • 更多自定义效果

Previous

自定义相机

Next

模型

On this page