> For the complete documentation index, see [llms.txt](https://ersha.gitbook.io/code-new/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ersha.gitbook.io/code-new/refineplus/refine-plus/xi-lian-jie-mian.md).

# 洗练界面

## 前言

洗练界面可以有多个不同的布局，洗练界面布局完全自定义，洗练界面配置位于 **./view** 文件夹中，一个完整的 [洗练界面](#undefined) 示例

## 界面布局

这个没什么好说的，主要还是得说 [界面物品配置(标识符)](#jie-mian-wu-pin-pei-zhi)

```yaml
#界面标题
title: "普通洗练"
#界面布局，标识符必须再 view-material 上配置
view-slots:
  - BBBBBBBBB
  - B*******B
  - BBBBBBBBB
  - BBBBRBBBB
  - BBBBBBLBB
  - BBBBYBBBB
#界面物品
view-material:
  ...
```

## 界面物品配置

### 基础配置

<table><thead><tr><th>配置项</th><th>说明</th><th>例子</th></tr></thead><tbody><tr><td>type (必填)</td><td><a href="#undefined">处理类型</a></td><td>type: <strong>border</strong></td></tr><tr><td>update</td><td>槽位更新 (开启后将实时更新物品描述等信息)</td><td>update: <strong>false</strong></td></tr><tr><td>items-returned</td><td>物品返回 (关闭界面时自动返回槽位上放置的物品)</td><td>items-returned: <strong>false</strong></td></tr><tr><td>name (必填)</td><td>物品名</td><td>name: <strong>"边框"</strong></td></tr><tr><td>lore (必填)</td><td>物品描述，支持<a href="#zhan-wei-fu">占位符</a></td><td><pre class="language-yaml"><code class="lang-yaml"> lore:
   - "&#x26;7边框 | 无法点击"
</code></pre></td></tr></tbody></table>

### 处理类型

| 类型       | 说明                      |
| -------- | ----------------------- |
| border   | 边框槽 (无法点击)              |
| refine   | 洗练物品槽 (可放入/取出)          |
| material | 洗练材料放置槽 (可放入/取出)        |
| lock     | 条词锁定操作按钮槽 (左键/右键/SHIFT) |
| confirm  | 确定按钮槽 (点击开始洗练)          |

```yaml
view-material:
  #标识符
  "B":
      #类型
    - type: border
      #物品类型
      material: "STAINED_GLASS_PANE:15"
      #物品名
      name: "&8边框"
      #物品描述
      lore:
        - "&7边框 | 无法点击"
  "L":
    - type: lock
      update: true
      material: "STAINED_GLASS_PANE:4"
      name: "&8条词锁定"
      lore:
        - "&7左键: 上一行"
        - "&7右键: 下一行"
        - "&7Shift键+点击: 切换锁定状态"
        - ""
        - "&7当前物品洗练属性: "
        - "&7{attributes}"
  "Y":
    - type: confirm
      update: true
      material: "STAINED_GLASS_PANE:5"
      name: "&6开启洗练"
      lore:
        - "&7确定 | 点击开始洗练"
        - "&7当前洗练次数: &c{refine-number}"
        - " "
        - "&7{required-material}"
  "R":
    - type: refine
      #关闭界面时自动返回槽位上的物品
      items-returned: true
      material: "STAINED_GLASS_PANE:6"
      name: "&6装备槽"
      lore:
        - "&7装备 | 将洗练装备放入"
        - "&7当前洗练次数: &c{refine-number}"
  "*":
    - type: material
      items-returned: true
      material: "STAINED_GLASS_PANE:8"
      name: "&6洗练材料"
      lore:
        - "&7材料 | 将洗练所需材料放入"
```

## 占位符

| 占位符                 | 说明                |
| ------------------- | ----------------- |
| {required-material} | 本次洗练所需消耗的必备材料及数量  |
| {attributes}        | 物品的洗练属性 (配合锁词条显示) |
| {chance}            | 本次洗练成功几率          |
| {aegis}             | 是否已使用保护道具         |
| {refine-number}     | 物品已洗练的次数          |

## Example.yml

```yaml
#界面标题
title: "普通洗练"

#通过该界面洗练的顶部、底部描述 (没有设置则使用 config 默认配置)
refine-info:
  #顶部描述 (不可为空白)
  top: "&f&m&l--------&f[&6&l洗练属性&f]&f&m&l--------"
  #底部描述 (不可为空白)
  bottom: "&f&m&l--------&f[&6&l洗练属性&f]&f&m&l--------"
  
#界面位置布局
view-slots:
  - BBBBBBBBB
  - B*******B
  - BBBBBBBBB
  - BBBBRBBBB
  - BBBBBBLBB
  - BBBBYBBBB
#界面布局材料
view-material:
  "B":
    - type: border
      material: "STAINED_GLASS_PANE:15"
      name: "&8边框"
      lore:
        - "&7边框 | 无法点击"
  "L":
    - type: lock
      update: true
      material: "STAINED_GLASS_PANE:4"
      name: "&8条词锁定"
      lore:
        - "&7左键: 上一行"
        - "&7右键: 下一行"
        - "&7Shift键+点击: 切换锁定状态"
        - ""
        - "&7当前物品洗练属性: "
        - "&7{attributes}"
  "Y":
    - type: confirm
      update: true
      material: "STAINED_GLASS_PANE:5"
      name: "&6开启洗练"
      lore:
        - "&7确定 | 点击开始洗练"
        - "&7当前洗练次数: &c{refine-number}"
        - " "
        - "&7{required-material}"
  "R":
    - type: refine
      #关闭界面时自动返回槽位上的物品
      items-returned: true
      material: "STAINED_GLASS_PANE:6"
      name: "&6装备槽"
      lore:
        - "&7装备 | 将洗练装备放入"
        - "&7当前洗练次数: &c{refine-number}"
  "*":
    - type: material
      items-returned: true
      material: "STAINED_GLASS_PANE:8"
      name: "&6洗练材料"
      lore:
        - "&7材料 | 将洗练所需材料放入"
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ersha.gitbook.io/code-new/refineplus/refine-plus/xi-lian-jie-mian.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.