猹件开发组

Appearance

On this page

猹引擎 ​

UI 配置 ​

UI 配置只负责页面入口和窗口参数。

详细交互能力、槽位映射、通信写法统一放在 GUI 文档。

文件位置 ​

txt
plugins/ChaEngine/ui/*.yml

最小配置示例 ​

yml
活动主界面:
  html: "pages/activity/index.html"
  center: true
  x: 0
  y: 0
  width: 1280
  height: 720
  hud: false
  override: ""

字段说明 ​

字段作用
html页面文件路径或外链地址
center是否以屏幕中心定位
x y页面偏移坐标
width height页面尺寸
hud是否常驻为 HUD 页面
override覆盖原版 HUD 层

HUD 示例 ​

yml
角色状态HUD:
  html: "pages/hud/role-status.html"
  center: false
  x: 20
  y: 16
  width: 360
  height: 110
  hud: true
  override: "hp,exp,exp_level"

hud 与 override 详细说明 ​

hud ​

  • hud: true：页面按 HUD 模式常驻显示，适合状态条、战斗信息、任务追踪。
  • hud: false：页面按普通窗口显示，适合弹窗、面板、商店、列表类页面。

override ​

  • override 用于覆盖原版 HUD 指定层，多个键使用英文逗号分隔。
  • override 为空字符串时，不覆盖任何原版 HUD。
  • 建议仅覆盖你页面已经替代展示的层，避免玩家丢失关键信息。

可覆盖键名 ​

当前文档已验证并正在使用的键名：

键名对应原版 HUD 层常见用途
hp生命值显示层自定义血量条、职业生命面板
exp经验条显示层自定义经验进度条
exp_level经验等级数字层自定义等级数字显示

写法示例 ​

1. 不覆盖原版 HUD ​

yml
任务追踪HUD:
  html: "pages/hud/quest.html"
  center: false
  x: 20
  y: 20
  width: 420
  height: 140
  hud: true
  override: ""

2. 只覆盖生命值 ​

yml
战斗状态HUD:
  html: "pages/hud/combat.html"
  center: false
  x: 16
  y: 14
  width: 420
  height: 120
  hud: true
  override: "hp"

3. 覆盖生命值 + 经验条 + 等级 ​

yml
完整角色HUD:
  html: "pages/hud/role-full.html"
  center: false
  x: 18
  y: 12
  width: 500
  height: 150
  hud: true
  override: "hp,exp,exp_level"

使用建议 ​

  1. 先做“不覆盖”版本确认 HUD 布局和数据正常，再逐步加 override。
  2. 仅覆盖已被你页面替代的原版层，保持战斗信息完整。
  3. 页面内要提供同等信息显示，避免覆盖后出现信息缺口。
  4. 覆盖组合统一写在同一条配置里，避免多页面互相覆盖冲突。

相关文档 ​