Files
netease-modsdk-wiki/docs/mcguide/20-玩法开发/11-组装简单玩法/10-预设/6-文字面板预设.md
2025-03-17 13:24:39 +08:00

92 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
front: https://nie.res.netease.com/r/pic/20210727/1e450bb1-ee50-4e6c-b614-7fbd6a00b4e7.png
hard: 入门
time: 5分钟
---
# 文字面板预设
> 目前仅在开发测试中生效正式服预计在2.2版本上线,请开发者合理安排开发节奏。
## 基础介绍
TextBoardPreset文字面板预设是一类绑定**文字面板**的特殊预设,目的是能够快速创建、编辑和使用文字面板。
> 对于文字面板的概念,开发者可以参阅为[文字面板的定义](../../../20-玩法开发/10-基本概念/1-我的世界基础概念.md#文字面板)以及<a href="../../../../mcdocs/3-PresetAPI/预设对象/预设/文字面板对象TextboardObject.html" rel="noopenner"> 文字面板预设相关接口 </a>
## 创建与添加
我们分别提供了内置文字面板预设和可供创建的普通文字面板预设。
### 添加内置文字面板预设
内置文字面板预设无需创建,即可使用,通过菜单栏=>添加预设=>文字面板预设(来自内置预设)进行添加,如下图所示。
![添加内置文字面板预设](./images/addtextboard.png)
### 创建普通文字面板预设
普通文字面板预设不同于内置的预设,开发者需要通过新建文件向导=→预设分页=→找到文字面板预设=→创建,如下图所示
![创建](./images/createtextboard.png)
## 文字面板属性
文字面板预设除了预设所具有的基本属性外,额外提供了文字面板特有的属性,如下图所示
![面板属性](./images/textboardattr.png)
| 属性 | 说明 |
| :--- | :--- |
| 文本内容| 文字面板上所显示的文字内容,支持[样式代码](https://minecraft-zh.gamepedia.com/%E6%A0%B7%E5%BC%8F%E4%BB%A3%E7%A0%81)|
|始终面向相机| 默认开启,勾选后文字面板会随着相机移动而改变朝向,始终保持正面朝向相机 |
| 深度测试 | 默认开启,勾选后文字面板会按照正常的前后顺序进行遮挡或显示 |
| 文本颜色 | 文字面板上文本内容的颜色 |
| 文本透明度 | 文字面板上文本内容的透明度,范围[0,1],值越小越透明。 |
| 背景颜色 | 文字面板自身的颜色。 |
| 背景透明度 | 文字面板自身的透明度,范围[0,1],值越小越透明。 |
## 挂接实体与玩家
文字面板预设既可以直接放置到世界的任意坐标位置,也可以绑定到实体或者玩家的相对位置,我们只需要将文字面板预设挂接到实体或玩家预设下,相比未挂接的情况,我可以看到实体和玩家预设下的文字面板预设多出了一栏坐标变换属性,此时调整这里的属性就是调整相对于父级预设的相对位置,如下图所示。
![挂接关系](./images/textboardattached.png)
## 操作示例
这里我们做一个基础的案例演示:
功能需求:
1. 在世界坐标0650放置一个文字面板内容为“你好我的世界”
2. 为一个牛的实体预设挂接一个文字面板,显示内容“我是一头牛”。
实现步骤:
1. 首先对于第一个功能我们直接在关卡编辑器将预设库中内置的文字面板预设拖动到场景舞台中并修改其坐标为0650如下图所示
![拖动内置预设](./images/textboard_1.gif)
2. 对于第二个功能,我们先分别创建一个使用了牛的模板的实体预设
![创建实体预设](./images/textboard_2.gif)
3. 再创建一个文字面板预设,并将其挂接到实体预设下
![挂接](./images/textboard_3.gif)
4. 调整位置和属性(位置、旋转、缩放可直接使用拖柄调整)
![调整属性](./images/textboard_4.gif)
5. 在关卡编辑器内将该实体预设拖动到场景舞台上
![拖动到场景](./images/textboard_5.gif)
6. 运行测试,看到最终效果如下图
![最终效果](./images/textboard-6.png)
7. 如果我们进一步调整预设的面板属性,并充分利用[样式代码](https://minecraft-zh.gamepedia.com/%E6%A0%B7%E5%BC%8F%E4%BB%A3%E7%A0%81),就能创造出更丰富的效果。
![高级效果](./images/textboard-7.png)