猹件开发组

Appearance

On this page

猹引擎 ​

HTML槽位映射 ​

文件位置 ​

txt
plugins/ChaEngine/slot.yml

字段 ​

每个槽位节点支持：

  • id
  • max
  • condition

样例 ​

yml
项链槽位:
  # 配置 id 后会按玩家 UUID + id + slot 写入 Redis
  id: necklace
  # 最大堆叠数
  max: 1
  # 允许放置条件
  condition:
    - "papi#%player_level% >= 10"
    - "perm#group.vip1"
    - "lore#装备类型: 项链#放入物品不是项链"

戒指槽位:
  # 未配置 id 时不会写入服务端存储，仅作为当前 HTML UI 会话内的展示/交互槽位
  max: 1
  condition:
    - "papi#%player_level% >= 10"
    - "lore#装备类型: 戒指"

字段含义 ​

字段作用
id启用长期存储标识；未配置时按会话槽处理
max槽位最大可放数量
condition放入条件列表，不满足则拦截

页面绑定写法 ​

js
await ChaEngine.bindSlots([
  { id: 'necklace_0', type: 'custom', config: '项链槽位', slot: 0 },
  { id: 'ring_0', type: 'custom', config: '戒指槽位', slot: 0 }
]);

交互方法 ​

  • ChaEngine.bindSlots(...)
  • ChaEngine.clickSlot(...)
  • ChaEngine.syncSlots()
  • ChaEngine.clearSlotBindings()
  • ChaEngine.onSlotData(...)

说明 ​

  • config 需要和 slot.yml 节点名完全一致。
  • 页面与槽位交互逻辑可直接参考 ui/测试页面.html。