跳转到正文
iPlugin

添加玩家头像

头像模板 → Layout → HUD,不必预先下载玩家皮肤

本页使用字体教程中的 tutorial_font;已有字体时可替换示例 ID。头像颜色由 Xerr 获取玩家皮肤,不需要预先下载每个玩家的 PNG。希望在画布中操作时,见可视化添加头像。

默认主题中的头像效果

文件结构

tutorial.yml
tutorial_profile.yml
tutorial_profile.yml

创建头像模板

plugins/Xerr/core/template/head/tutorial.yml
tutorial_portrait:
  size: 24
  overlay: true
  render: flat
  mask: square
  loading: default
  failure: default
  target:
    type: viewer

viewer 显示观看 HUD 的玩家。flat 是脸与外层叠在一起,square 是方形。

在 Layout 中引用模板

plugins/Xerr/core/layout/tutorial_profile.yml
defaults:
  font: tutorial_font

tutorial_profile:
  face:
    anchor:
      x: 50
      y: 50
    x: -40
    y: 0
    head:
      template: tutorial_portrait
  name:
    anchor:
      x: 50
      y: 50
    x: -8
    y: 0
    value: "&f{{ player name }}"

交给 HUD 显示

plugins/Xerr/core/display/huds/tutorial_profile.yml
tutorial_profile_hud:
  refresh: 20
  layouts:
    tutorial_profile: {}

先关闭之前的中央教程 HUD,避免两个练习重叠。执行 /xerr pack 并加载新包。

指定谁的头像

以下片段用于整体替换模板的 target,不是新模板文件:

替换 target
target:
  type: viewer

Layout 的 head.target 会整体覆盖模板目标。如果模板改成 Steve 仍显示自己,检查 Layout 是否覆盖了目标。

全部字段、自定义遮罩和占位图见头像参考。