+
+2. 作品导出配置优化，移除无用文件：导出附加包时，移除world_behavior_packs.json，world_icon.jpeg，world_resource_packs.json等文件。导出地图时，移除level.dat_old，world_icon.jpeg等文件。
+
+
+
+
+
+## 工具箱
+
+1. 工具箱新增安装sdk补全库功能。
+
+
+
+
+
+## 其他
+
+1. 修复账号注销后Mod标签消失的问题。
diff --git a/mcguide/10-新内容/1-开发工作台/945-1.1.24.md b/mcguide/10-新内容/1-开发工作台/945-1.1.24.md
new file mode 100644
index 0000000..19b28ed
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/945-1.1.24.md
@@ -0,0 +1,40 @@
+---
+front: https://nie.res.netease.com/r/pic/20241120/c1626194-9cfd-4cde-99ca-d95a83b20ac6.jpg
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+
+
+# 2024.11.21 版本1.1.24
+
+## 作品管理
+
+1. 云端列表新增试玩模组角标展示。
+
+
+
+2. 新增默认作品标签“未分类”。
+
+
+
+
+
+## 界面编辑
+
+1. StackPanel支持为其子控件的size设置fill属性。详情可参考[UI说明文档](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/18-界面与交互/30-UI说明文档.html)。
+
+
+
+
+
+## 属性编辑
+
+1. 物品icon贴图支持选择textures目录下的任意贴图。
+
+
+
+2. 新建物品、方块，默认勾选“游戏内名字”、“创造栏显示”特性。
+
+
diff --git a/mcguide/10-新内容/1-开发工作台/946-1.1.22.md b/mcguide/10-新内容/1-开发工作台/946-1.1.22.md
new file mode 100644
index 0000000..941ac5e
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/946-1.1.22.md
@@ -0,0 +1,22 @@
+---
+front: https://nie.res.netease.com/r/pic/20241106/43011801-73e9-46d4-b9e0-b75e233e2faa.jpg
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+
+
+# 2024.11.06 版本1.1.22
+
+## 界面编辑器
+
+1. 新增颜色渐变控件gradient_renderer，支持渐变效果UI。详情参考[UI说明文档](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/18-界面与交互/30-UI说明文档.html)。
+
+
+
+## 资源管理器
+
+1. 删除逻辑优化，改为移动到回收站。
+
+
diff --git a/mcguide/10-新内容/1-开发工作台/947-1.1.21.md b/mcguide/10-新内容/1-开发工作台/947-1.1.21.md
new file mode 100644
index 0000000..c1d7108
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/947-1.1.21.md
@@ -0,0 +1,27 @@
+---
+front: https://nie.res.netease.com/r/pic/20241022/133cc440-90eb-4c50-8ffa-bfb37d751855.jpg
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+
+
+# 2024.10.24 版本1.1.21
+
+## 界面编辑器
+
+1. 新增显示原生UI勾选框，支持显示原生UI效果。
+
+
+
+## 逻辑编辑器
+
+1. 蓝图节点选中状态特殊边框表现效果优化。
+2. 蓝图节点引脚图标优化，引脚展示效果随连接状态变化。
+
+
+
+## 其他
+
+1. 修复了3.0ModPC包中，动态加载实体交易表失效问题。
diff --git a/mcguide/10-新内容/1-开发工作台/948-1.1.20.md b/mcguide/10-新内容/1-开发工作台/948-1.1.20.md
new file mode 100644
index 0000000..8aa0c26
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/948-1.1.20.md
@@ -0,0 +1,195 @@
+---
+front: https://nie.res.netease.com/r/pic/20241008/4c4536cb-61fc-4de6-9fd0-8752d98e9ebe.jpg
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+
+
+# 2024.10.10 版本1.1.20
+
+## 配置编辑
+
+1. 补充了升级版本后，编辑器中缺失的一些实体配置条目，添加了以下81个新组件。
+
+ - minecraft:admire_item
+
+ - minecraft:anger_level
+
+ - minecraft:area_attack
+
+ - minecraft:attack_cooldown
+
+ - minecraft:barter
+
+ - minecraft:behavior.admire_item
+
+ - minecraft:behavior.avoid_block
+
+ - minecraft:behavior.barter
+
+ - minecraft:behavior.celebrate
+
+ - minecraft:behavior.celebrate_survive
+
+ - minecraft:behavior.croak
+
+ - minecraft:behavior.defend_trusted_target
+
+ - minecraft:behavior.dig
+
+ - minecraft:behavior.drink_milk
+
+ - minecraft:behavior.eat_carried_item
+
+ - minecraft:behavior.eat_mob
+
+ - minecraft:behavior.emerge
+
+ - minecraft:behavior.equip_item
+
+ - minecraft:behavior.fertilize_farm_block
+
+ - minecraft:behavior.find_cover
+
+ - minecraft:behavior.go_and_give_items_to_noteblock
+
+ - minecraft:behavior.go_and_give_items_to_owner
+
+ - minecraft:behavior.hold_ground
+
+ - minecraft:behavior.investigate_suspicious_location
+
+ - minecraft:behavior.jump_to_block
+
+ - minecraft:behavior.move_outdoors
+
+ - minecraft:behavior.move_to_block
+
+ - minecraft:behavior.move_to_lava
+
+ - minecraft:behavior.move_to_liquid
+
+ - minecraft:behavior.move_towards_dwelling_restriction
+
+ - minecraft:behavior.move_towards_home_restriction
+
+ - minecraft:behavior.nap
+
+ - minecraft:behavior.nearest_prioritized_attackable_target
+
+ - minecraft:behavior.play_dead
+
+ - minecraft:behavior.ram_attack
+
+ - minecraft:behavior.random_hover
+
+ - minecraft:behavior.random_look_around_and_sit
+
+ - minecraft:behavior.rise_to_liquid_level
+
+ - minecraft:behavior.roar
+
+ - minecraft:behavior.sniff
+
+ - minecraft:behavior.sonic_boom
+
+ - minecraft:behavior.stalk_and_pounce_on_target
+
+ - minecraft:behavior.stay_near_noteblock
+
+ - minecraft:behavior.stroll_towards_village
+
+ - minecraft:behavior.swim_idle
+
+ - minecraft:behavior.swim_with_entity
+
+ - minecraft:behavior.work_composter
+
+ - minecraft:block_climber
+
+ - minecraft:block_sensor
+
+ - minecraft:boss
+
+ - minecraft:buoyant
+
+ - minecraft:celebrate_hunt
+
+ - minecraft:combat_regeneration
+
+ - minecraft:conditional_bandwidth_optimization
+
+ - minecraft:custom_hit_test
+
+ - minecraft:drying_out_timer
+
+ - minecraft:entity_sensor
+
+ - minecraft:equip_item
+
+ - minecraft:exhaustion_values
+
+ - minecraft:experience_reward
+
+ - minecraft:flocking
+
+ - minecraft:game_event_movement_tracking
+
+ - minecraft:group_size
+
+ - minecraft:grows_crop
+
+ - minecraft:heartbeat
+
+ - minecraft:home
+
+ - minecraft:hurt_on_condition
+
+ - minecraft:inside_block_notifier
+
+ - minecraft:instant_despawn
+
+ - minecraft:is_pregnant
+
+ - minecraft:mob_effect
+
+ - minecraft:movement.hover
+
+ - minecraft:movement_sound_distance_offset
+
+ - minecraft:navigation.hover
+
+ - minecraft:out_of_control
+
+ - minecraft:physics
+
+ - minecraft:pushable
+
+ - minecraft:suspect_tracking
+
+ - minecraft:trail
+
+ - minecraft:variable_max_auto_step
+
+ - minecraft:vibration_damper
+
+ 
+
+2. 现在在关卡编辑器中对方块配置进行修改之后，重载地图之后就可以实时生效（在地图编辑器中的材质选择界面中出现），无需再重启编辑器了。
+
+
+
+
+
+## 启动器工程组件记录
+
+1. 开发者启动器的编辑地图界面中，会记录当前地图使用的附加包和材质光影信息，每次打开此界面时，启用的内容将会自动被勾选。
+
+
+
+## 其他
+
+1. 逻辑编辑器中，补充了3.0SDK的相关节点内容。
+2. 修复了3.0PC包中，使用联机地图创建多人房间后关闭游戏时的崩溃问题。
diff --git a/mcguide/10-新内容/1-开发工作台/949-1.1.19.md b/mcguide/10-新内容/1-开发工作台/949-1.1.19.md
new file mode 100644
index 0000000..da5d77a
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/949-1.1.19.md
@@ -0,0 +1,35 @@
+---
+front: https://nie.res.netease.com/r/pic/20240904/128beae6-ecef-43e6-88b0-d0b009739499.jpg
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2024.9.5 版本1.1.19
+
+## 地图编辑器
+
+1. 地图编辑器基础操作优化，新增智能识别物体功能，快速框选建筑结构，生成指定包围盒。
+
+ 
+
+2. 保存结构时，现在可以记住上次的配置。例如：勾选 **去除空气** 并记住该配置后，下次保存结构时无需重复选择同类选项。减少重复操作，提升开发效率。
+
+ 
+
+
+
+## 配方配置功能更新
+
+1. 配方保存逻辑优化，去除了应用按钮，调整配方时，点击清空/确定后自动保存配方内容。
+
+ 
+
+
+
+## 其他
+
+1. 修复设备名称出现中文或特殊字符时，新版调试工具无法连接的问题。
+1. 编辑器内嵌游戏、ModPC升级到64位包体。
+1. 修复自定义方块配置中，方块实体组件的tips描述错误的问题。
+1. 修复游戏模式下部分快捷键会触发编辑器对应功能的问题。
diff --git a/mcguide/10-新内容/1-开发工作台/950-1.1.17.md b/mcguide/10-新内容/1-开发工作台/950-1.1.17.md
new file mode 100644
index 0000000..b137ed4
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/950-1.1.17.md
@@ -0,0 +1,36 @@
+---
+front: https://nie.res.netease.com/r/pic/20240821/4b503721-081d-4c43-a32a-4d06fe350422.jpg
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2024.8.22 版本1.1.17
+
+## 关卡编辑器
+
+1. 自定义方块碰撞盒支持以数组为形式的实体碰撞盒与射线碰撞盒
+
+
+
+
+
+## 调试工具
+
+1. 在调试输出界面中增加报错信息跳转机制，点击报错信息直接打开对应的代码文件。
+
+ ::: danger 注意
+
+ 需要开发测试或编辑器内启动ModPC开发包，直接启动ModPC开发包或在开发测试过程切换存档会导致跳转失败。
+
+ :::
+
+
+
+
+
+## 其他
+
+1. 修复关卡编辑器编辑硬度属性导致游戏报错的问题。
+1. 修复修复自定义方块贴图写入错误的问题。
+1. 修复测试存档数据丢失的问题。
diff --git a/mcguide/10-新内容/1-开发工作台/951-1.1.16.md b/mcguide/10-新内容/1-开发工作台/951-1.1.16.md
new file mode 100644
index 0000000..6763ab0
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/951-1.1.16.md
@@ -0,0 +1,35 @@
+---
+front: https://nie.res.netease.com/r/pic/20240807/b84424e1-7ff1-49ec-9fe2-f549693d2170.jpg
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2024.8.8 版本1.1.16
+
+## 自定义编辑器快捷键
+
+
+
+1. 作品设置新增快捷键分页，包含7组快捷键：全局、关卡、预设、地图、界面、特效、逻辑。
+2. 支持修改、清除、重置快捷键，并及时反馈到编辑器内对应的功能入口。
+3. 保存与加载：快捷键设置在同一台电脑上共享。
+4. 冲突检测：全局快捷键会检测所有快捷键，其余各编辑器内仅检测全局和当前编辑器的快捷键。
+5. 启动检测：编辑器启动时检测所有快捷键是否存在冲突，有冲突时将弹窗提示，关闭弹窗后将自动打开 **作品设置** 并跳转至 **快捷键** 分页。
+
+
+
+
+
+## 地图编辑器
+
+1. 地形植被工具添加新版本的植树特征，含樱花树、红树及其变种等。
+
+
+
+## 其他
+
+1. 修复MC Studio无法自测认证的问题
+2. 补充逻辑编辑器新版接口翻译。
+3. 修复地图编辑器无法撤回已放置的杜鹃花叶、盛开的杜鹃花叶、樱花树叶与红树树叶等问题。
+4. 修复地图编辑器复制方块可能随机丢失选取方块的问题。
diff --git a/mcguide/10-新内容/1-开发工作台/952-1.1.13.md b/mcguide/10-新内容/1-开发工作台/952-1.1.13.md
new file mode 100644
index 0000000..481027c
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/952-1.1.13.md
@@ -0,0 +1,69 @@
+---
+front: https://nie.res.netease.com/r/pic/20240723/795e8036-1921-436c-b474-e58a9d260812.png
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2024.7.25 版本1.1.13
+
+
+
+## 关卡编辑器
+
+1. **布局优化** ： **作品** 入口与下拉选单功能现已合并至 **关卡编辑器** 二级工具栏的 **作品设置** 中。也可以在 **关卡编辑器** 、 **预设编辑器** 与 **地图编辑器** 的预览窗右上方点击 **设置** 进入。
+
+- **旧** ：
+
+- **新** ：
+
+ 
+
+2. **作品设置** ：
+
+ 1. 现在可以一键修改并同步 **内嵌游戏** 、 **编辑器内运行游戏** 与 **实际作品** 的作弊模式选项与游戏设置选项。不包括开发测试。
+
+ 部分设置与模式在编辑器内嵌游戏中不会生效，但会在游戏自测、作品导出或上传至开发者平台生效。
+
+ ::: danger 注意
+
+ 作弊模式选项与游戏设置选项页签目前仅在地图的作品设置面板中显示。
+
+ :::
+
+ 
+
+ 2. **命名空间** 修改后，无需再次进行确认。如果新导入的作品已经有了命名空间，系统会自动读取已存在的命名空间。如果作品有多个附加包，系统会随机选取其中一个附加包的命名空间作为作品的命名空间。
+
+ 
+
+ 3. **内嵌游戏** 、**其他** 功能保留不变。
+
+
+
+
+## 地图编辑器
+
+1. **基础操作优化** ：
+
+ 1. **选取模式** 支持框选单个区域后直接框选下个区域。另外，点击空气区域现在即可取消上次选区的包围盒。减少步骤操作，提升操作体验。
+
+ 
+
+ 2. **选取模式** 下右键包围盒即可快速保存结构或素材。取消原先保存结构和素材的冗余操作。
+
+ 
+
+ 3. **编辑模式** 下，现在放置的素材与结构可以直接应用旋转、缩放与镜像操作。
+
+ 
+
+ 4. **编辑模式** 的包围盒显示为黄色，提升视觉反馈。
+ 5. 生成后保留编辑过的选取包围盒，方便进行二次编辑。
+ 6. **编辑模式** 快捷键由`Crtl+K`更换至`Q`。
+
+
+
+## 其他
+
+1. 修复了在地图编辑器中保存结构时，勾选【去除空气选项】无效的问题。
diff --git a/mcguide/10-新内容/1-开发工作台/953-1.1.12.md b/mcguide/10-新内容/1-开发工作台/953-1.1.12.md
new file mode 100644
index 0000000..bd44388
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/953-1.1.12.md
@@ -0,0 +1,40 @@
+---
+front: https://nie.res.netease.com/r/pic/20240710/00b1bbb0-3feb-4b3e-807a-42efe2edb40b.jpg
+hard: 入门
+time: 5分钟
+selection: 23
+---
+
+# 2024.7.10 版本1.1.12
+
+
+
+## 关卡编辑器
+
+1. **预设配置文件** ：优化关卡编辑器`preset.json`的数据结构，由一行格式转换为多行格式，提高可读性的同时，避免了多人协作过程中提交冲突的情况，提升多人协作效率。
+
+
+
+
+
+
+
+## 特效编辑器
+
+1. **时间轴：** timeline最大时长扩展至50秒，同时切换动作时将根据动作的播放时长自适应调整时间轴，提高动作制作上限，优化用户体验。
+
+
+
+
+
+## ModPC开发包
+
+1. **BUG修复：** 修复UI界面update函数每秒执行次数不足30次的问题。
+
+
+
+
+
+## 其他
+
+1. **1.20.1Java版客户端外放** ：现在可以自测并提审47.3.0（Forge版本）及以上的Java作品。
diff --git a/mcguide/10-新内容/1-开发工作台/954-1.1.11.md b/mcguide/10-新内容/1-开发工作台/954-1.1.11.md
new file mode 100644
index 0000000..21e0b48
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/954-1.1.11.md
@@ -0,0 +1,40 @@
+---
+front: https://nie.res.netease.com/r/pic/20240619/2baa0e0c-8a8f-4ae4-81c8-2d6a288a0dce.jpg
+hard: 入门
+time: 5分钟
+selection: 23
+---
+
+# 2024.6.20 版本1.1.11
+
+
+
+## 实体预设新增
+
+1. 添加悦灵、监守者实体预设。现在您可以复用悦灵、监守者的内容创建自定义实体，亦或是覆写原有的实体资源和行为。
+
+ > 由于原生游戏的限制，自定义实体无法复用骆驼、嗅探兽的部分原版组件。我们在本次更新中暂时屏蔽了这两种实体的预设模板。将在未来整包更新时放出。
+
+
+
+
+
+## 地图编辑器
+
+1. 方块材质库补充了1.19到1.20.10的新方块。
+
+
+
+
+
+## 界面编辑器
+
+1. 现在按下Del键删除控件名称不会再一并删除UI控件。
+
+
+
+
+
+## 其他
+
+1. 其他体验优化和问题修复
diff --git a/mcguide/10-新内容/1-开发工作台/955-1.1.8.md b/mcguide/10-新内容/1-开发工作台/955-1.1.8.md
new file mode 100644
index 0000000..c5e713b
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/955-1.1.8.md
@@ -0,0 +1,79 @@
+---
+front: https://nie.res.netease.com/r/pic/20240114/12069454-01dc-4b70-8614-f1398bd9f0f8.png
+hard: 入门
+time: 5分钟
+selection: 23
+---
+# 2024.4.11 版本1.1.8
+
+## AI知识助理迭代
+1. 支持指定搜索范围。
+2. 支持流式返回，提高返回速度。
+3. 支持保留最近三次对话连续问答。
+4. 支持渲染代码块和一键复制。
+5. 返回参考链接带上锚点，更精准的指向目标文章的目标段落。
+
+详情参考[AI知识助理](../../12-入门教程/25-AI知识助理.md#进阶用法)。
+
+
+
+## 内容库全新升级
+1. 合并资源包、作品模板、其他三个分页，提高搜索效率。
+2. 搜索功能支持搜索详情页文字。
+3. 增加收藏功能，标记你最需要的资源。
+4. 新增评分功能，为你喜欢的资源打个满分吧！
+5. 增加下载量的显示，了解最受开发者欢迎的资源。
+6. 增加排序功能，支持按照下载量，评分和更新时间排序。
+
+详情参考[内容库](../../15-资源管理/11-内容库.md)。
+
+
+
+
+
+
+
+## 启动器组件管理优化
+1. 支持标签管理
+你是否在为组件库中上百个作品烦恼，现在组件库支持为作品打上标签，支持按照标签筛选功能，快来为你的组件分类管理吧！
+
+
+
+
+2. 支持批量删除组件
+现在在组件库的右上角新增批量删除功能，点击后，你可以快速查看和删除所有本地作品！
+> 注意：删除操作不可撤销，请谨慎操作！
+
+
+
+
+
+## 新增天空盒零件
+1. 编辑器新建文件向导中，新增了天空盒零件，支持在编辑器中快速设置和调试天空盒相关参数，如雾气颜色，范围，天空颜色，贴图等等，详情参考[天空盒零件](../../20-玩法开发/14-预设玩法编程/0-理解预设系统/11-内置零件/07-天空盒零件.md)。
+
+
+
+## 支持新建材质及模板
+新建文件向导新增材质，可选择指定模板快速创建对应材质。
+
+
+
+
+## 其他
+
+1. 地图编辑器右下角的玩家位置从头部位置修改为脚底坐标
+
+
+
+
+2. 地图编辑器小地图支持显示选中位置的生物群系
+
+
+
+
+
+3. 方块配置支持配置最大堆叠数和燃烧时长，详见[自定义方块](../../20-玩法开发/15-自定义游戏内容/2-自定义方块/1-JSON组件.md)。
+
+
+
+
diff --git a/mcguide/10-新内容/1-开发工作台/956-1.1.7.md b/mcguide/10-新内容/1-开发工作台/956-1.1.7.md
new file mode 100644
index 0000000..36c4529
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/956-1.1.7.md
@@ -0,0 +1,66 @@
+---
+front: https://nie.res.netease.com/r/pic/20240114/12069454-01dc-4b70-8614-f1398bd9f0f8.png
+hard: 入门
+time: 5分钟
+selection: 23
+---
+# 2024.1.18 版本1.1.7
+## AI知识助理开启beta测试！
+我的世界开发工作台全新推出AI知识助理，它是一个基于大模型训练的生成式AI问答助手，熟知开发者官网内的所有文档，你可以向它询问任意模组开发的问题，它会竭尽所能为你一一解答，详情请参考[AI知识助理使用文档](../../12-入门教程/25-AI知识助理.md)。
+
+
+
+
+
+## 特效编辑器
+
+1. 支持显示和修改steve（史蒂夫）的皮肤贴图，可参考[这篇文档](../../16-美术/9-特效/50-预览功能.md#修改和预览steve皮肤贴图)，如图所示
+
+
+
+2. 骨骼模型和bb模型支持右键删除指定动作，可参考[这篇文档](../../16-美术/9-特效/10-模型导入.md#5删除单个模型动作)，如图所示：
+
+
+
+3. 支持显示某个骨骼动画的关键帧信息，可参考[这篇文档](../../16-美术/9-特效/50-预览功能.md#预览模型动画关键帧信息)，如图所示：
+
+
+
+4. 支持调整和预览窗口分辨率，可参考[这篇文档](../../16-美术/9-特效/50-预览功能.md#调整预览窗口的分辨率)，如图所示：
+
+
+
+
+## 关卡编辑器
+1. 方块配置新增方块实体的客户端tick字段，字段含义可参考[自定义方块实体](../../20-玩法开发/15-自定义游戏内容/2-自定义方块/4-自定义方块实体.md#添加自定义方块实体)，如图所示：
+
+
+
+
+
+## 界面编辑器
+1. 原版纸娃娃和网易纸娃娃控件支持【超出父控件区域后是否裁剪】属性，属性含义可参考[UI控件说明文档](../../18-界面与交互/30-UI说明文档.md#paperdoll)，如下图所示：
+
+> 注意，该属性需要父控件开启裁剪内容（clip_children）选项方可生效。
+
+
+
+## 逻辑编辑器
+1. 延迟节点支持修改参数类型，如下图：
+
+
+
+## 其他
+
+1. 支持编辑器设置fov并保持各子编辑器fov一致。
+
+> 关卡、预设、地图编辑器修改位置
+>
+> 
+>
+> 特效编辑器修改位置：
+> 
+
+2. 物品配置的贴图属性支持递归搜索子文件夹的贴图。
+3. 资源管理器筛选功能仅针对左侧选中目录生效。
+4. Apollo引擎版本选择按照版本号排序。
\ No newline at end of file
diff --git a/mcguide/10-新内容/1-开发工作台/957-1.1.4.md b/mcguide/10-新内容/1-开发工作台/957-1.1.4.md
new file mode 100644
index 0000000..81d7ade
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/957-1.1.4.md
@@ -0,0 +1,56 @@
+---
+front: https://nie.res.netease.com/r/pic/20231115/cdd80319-3ec4-422f-abbb-0f4e8a597fbd.png
+hard: 入门
+time: 5分钟
+selection: 23
+---
+
+# 2023.11.16 版本1.1.4
+
+
+## 关卡编辑器
+方块配置-自定义箱子组件增加是否被实心方块阻挡字段，详见[方块配置](../../20-玩法开发/15-自定义游戏内容/2-自定义方块/1-JSON组件.md#netease-block-chest)。
+
+
+
+## 特效编辑器
+
+1. 编辑器新增重载材质按钮，修改shader或材质文件后，可以点击该按钮进行重载刷新，详见[重载材质](../../16-美术/9-特效/10-模型导入.md#3-重载材质)，如下图：
+
+
+
+
+2. 支持骨骼模型主副手手持物品的绑定到指定骨骼，详见[预览手持物品绑定](../../16-美术/9-特效/50-预览功能.md#预览手持物品绑定位置)。
+
+
+
+
+3. 支持一次性导入多个骨骼模型动作，可以直接多选fbx动作文件，如下图：
+
+
+
+4. 支持配置骨骼模型多pass材质，详见[配置多pass材质](../../16-美术/9-特效/10-模型导入.md#配置多pass材质)。
+
+
+
+
+## 资源管理器
+
+资源管理器现在支持在完整模式下切换当前编辑的行为包和资源包了。
+
+
+> 注意：切换编辑包体会影响文件创建、导入、保存的初始路径。
+
+
+
+
+## 逻辑编辑器
+
+新增延迟节点和字符串转义节点
+
+
+
+
+## 其他
+1. 优化了网络服分页的加载速度。
+2. 修复了编辑器更新时文件占用的异常问题。
diff --git a/mcguide/10-新内容/1-开发工作台/958-1.1.2.md b/mcguide/10-新内容/1-开发工作台/958-1.1.2.md
new file mode 100644
index 0000000..78d5d9e
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/958-1.1.2.md
@@ -0,0 +1,61 @@
+---
+front: https://nie.res.netease.com/r/pic/20230904/612c4203-ab6f-4f23-807e-ebf2f4086bf1.png
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2023.09.07 版本1.1.2
+
+# 界面编辑器
+1. 图片控件支持配置旋转角度和旋转锚点，详情参考[图片控件属性](../../18-界面与交互/30-UI说明文档.md#image)。
+
+
+
+
+# 关卡编辑器
+1. 方块配置支持颜色渐变图（colormap）,可让一个方块在不同维度的不同群系叠加不同的颜色，详情参考[自定义方块群系颜色](../../20-玩法开发/15-自定义游戏内容/2-自定义方块/2-功能.md#自定义方块及自定义方块模型的群系颜色)
+
+> 配置示例：
+
+
+> 效果：
+
+
+
+2. 物品配置支持盔甲韧性和击退抗性，属性请参考[自定义盔甲](../../20-玩法开发/15-自定义游戏内容/1-自定义物品/3-自定义盔甲.md#json组件)
+
+
+
+
+# 特效编辑器
+
+1. 支持导入材质
+
+
+
+
+2. 中国版粒子特效支持自定义材质
+
+> 注意，不同类型的着色器（shader）可能不支持用于中国版粒子特效，请参考[内置材质清单](../../16-美术/7-材质与着色器/2-内置材质清单.md#particles-material-材质文件)使用着色器。
+
+
+
+
+
+
+3. 支持骨骼模型的挂点快捷偏移到包围盒的各面中心点，详情参考[骨骼模型挂点偏移](../../16-美术/9-特效/10-模型导入.md#3骨骼模型挂点偏移)，如图所示：
+
+
+
+
+
+4. 支持骨骼模型更换材质，包括模型整体的材质和按照骨骼分别配置材质，详情参考[骨骼模型的使用](../../16-美术/6-模型和动作/04-骨骼模型的使用.md)
+
+
+
+
+# 启动器
+内容库资源展示列表改为按照分页展示，如图所示：
+
+
diff --git a/mcguide/10-新内容/1-开发工作台/959-1.1.0.md b/mcguide/10-新内容/1-开发工作台/959-1.1.0.md
new file mode 100644
index 0000000..6a070af
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/959-1.1.0.md
@@ -0,0 +1,74 @@
+---
+front: https://nie.res.netease.com/r/pic/20230626/b2a4745a-0348-4e1c-8d36-dc3eec5abc44.png
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2023.06.27 版本1.1.0
+
+## 性能监测工具
+启动器→工具箱新增一个性能监测工具，用于帮助开发者监测开发包运行时的实时帧率、内存、CPU占用等性能指标，帮助开发者评估模组的性能情况，详情使用请参考文档[性能监测工具](../../30-测试/5-性能监测与调试工具.md)。
+> 该工具仅支持在2.7稳定版及以上的ModPC开发包使用，不支持低版本或者上线测试的正式客户端。
+
+
+
+## 特效编辑器
+1. 中国版粒子新增拖尾属性，支持配置粒子拖尾效果,具体属性详情参考[中国版粒子拖尾属性](../../16-美术/9-特效/70-中国版特效属性详细说明.md#粒子拖尾效果属性说明)。
+
+
+
+2. 中国版粒子特效新增实例属性，用于在场景中实时地编辑粒子的发射路径，详情参考[中国版粒子发射路径](../../16-美术/9-特效/70-中国版特效属性详细说明.md#tips如何可视化编辑发射路径)。
+
+
+
+3. 中国版粒子支持随机发射间隔和摄像机偏移量
+
+
+
+4. 序列帧和粒子特效的动态属性栏默认展开，不再自动收起。
+
+
+## 关卡编辑器
+1. 添加属性窗口支持鼠标悬浮提示。
+
+
+
+2. 部分配置ICON更新。
+
+
+
+3. 自定义书本支持展示全部配套的目录和章节文件。
+
+
+
+4. 方块配置支持五个自定义特殊方块的字段，如自定义工作台、自定义箱子等等，详情参考[方块配置](../../20-玩法开发/15-自定义游戏内容/2-自定义方块/1-JSON组件.md#neteaseblockrandomoffset)。
+
+
+
+
+
+## 地图编辑器
+1. 新增拼图方块笔刷与大型结构地形工具，用于帮助开发者快速配置自定义大型特征的结构，详情参考[自定义大型特征](../../20-玩法开发/15-自定义游戏内容/4-自定义维度/6-自定义大型特征.md)。
+
+
+
+
+
+2. 小地图功能支持自定义绘制高度。
+
+
+
+> 注意：范围[-60,320],默认为0代表当前区块最高高度。
+
+3. 编辑工具的旋转和伸缩新增应用按钮，需点击按钮才能生效。
+
+
+
+## 界面编辑器
+
+1. 新增轮盘控件，支持开发者自定义轮盘内径、外径、切片数量等属性，详情使用请参考[轮盘控件](../../18-界面与交互/10-控件和控件属性.md#控件简介)。
+
+
+
+2. 界面编辑器的点击面板控件新增【是否吞噬点击事件】属性。
diff --git a/mcguide/10-新内容/1-开发工作台/960-1.0.32.md b/mcguide/10-新内容/1-开发工作台/960-1.0.32.md
new file mode 100644
index 0000000..4815fcb
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/960-1.0.32.md
@@ -0,0 +1,83 @@
+---
+front: https://nie.res.netease.com/r/pic/20230526/4620bdd0-d50d-43b2-bb07-72672a7f1fa6.png
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2023.05.30 版本1.0.32
+
+## 内容库支持开发者平台投稿
+1. 内容库现已支持在开发者平台进行提审和上架发布，目前正在限量测试中，我们将会尽快优化体验，开放给所有开发者使用，感谢您的耐心等待！
+2. 内容库新增【我的资源】分页，用于存放开发者账号投递的内容库资源，可以类比为基岩版组件的云端测试分页。
+
+对于内容库投递相关问题可以参考文档[内容库投递指南](../../35-上架与入驻/课程15-内容库资源投递指南.md)。
+
+
+
+## 作品默认使用新版编辑器启动
+从本版本开始，我们将不包含旧版特有组件的所有作品都默认识别为新版作品，默认使用新版编辑器打开，旧版编辑器已不再进行功能更新和维护，请开发者使用新版编辑器进行模组开发。
+> 如需使用旧版编辑器打开特定作品，可在作品的配置界面修改该作品的编辑器版本，如下图：
+
+
+
+
+## 启动器优化
+1. 开发测试界面支持完整的作弊选项
+将原有的作弊复选框修改为【作弊选项】按钮，开发者可以在此定义游戏内的所有作弊选项，方便设置测试环境，如下图：
+
+
+
+2. 地图类的测试存档支持转为新作品，开发者可以将在测试时的微调保存到一个新作品副本中，如下图：
+
+
+
+
+## 关卡编辑器
+1. 交易表补充了最大交易次数、是否奖励经验、交易员经验三个属性，如下图：
+
+
+
+2. 自定义维度配置中的群系源属性支持列表的移动和插入操作，如下图：
+
+
+
+3. 新增自定义书本配置，关于自定义书本，可以参考[自定义书本](../../20-玩法开发/15-自定义游戏内容/5-自定义书本/01-自定义基础书本.md)。
+
+
+
+
+> 受限于书本配置结构，无法自动识别此前已存在的书本配置，开发者需要在书本的每个json内新增一个`editor_identifier`字段,并将值统一写为改书本的最外层文件夹名称，即可被编辑器正常识别,如下图：
+
+
+
+1. 新增大型特征生成和结构池配置，用于支持自定义大型特征的生成，详情参考[自定义大型结构特征](../../20-玩法开发/15-自定义游戏内容/4-自定义维度/6-自定义大型特征.md)
+
+
+
+
+> 目前对于拼图方块的编辑仅支持通过give指令获取，并在地图编辑器的游戏模式下进行填写，我们将在后续更新2.7稳定包时，在地图编辑器支持通过笔刷的方式放置结构池和拼图方块，敬请关注！
+```
+指令:
+/give @s jigsaw 64
+```
+## 地图编辑器
+1. 小地图界面支持导出为图片、支持隐藏区块线框，如下图：
+
+
+
+2. 镜头设置增加视野（fov）和鼠标灵敏度属性
+
+
+
+3. 保存切分结构覆盖问题优化，现在不会出现覆盖未生效的问题。
+
+
+
+
+
+## 其他优化
+1. 取色器按钮取色时将其按钮选中。
+2. 方块配置新增侧面贴图属性，支持只配置上、下、侧面三张贴图。
+3. 优化了导入作品时的选项记忆功能。
+4. 优化了界面编辑器的控件截图体验。
\ No newline at end of file
diff --git a/mcguide/10-新内容/1-开发工作台/961-1.0.30.md b/mcguide/10-新内容/1-开发工作台/961-1.0.30.md
new file mode 100644
index 0000000..3c897e5
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/961-1.0.30.md
@@ -0,0 +1,62 @@
+---
+front: https://nie.res.netease.com/r/pic/20230425/bdce5df6-b35b-465c-abf1-ff531c36e97b.png
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2023.05.04 版本1.0.30
+## 地图编辑器替换窗口支持同类方块合并替换
+选取地图结构并替换时，自动合并同类不同状态方块，点击左侧展开按钮即可展开。
+1. 选中总类别方块进行替换时，则替换全部状态的同类方块。
+2. 选中子类别方块进行替换时，则只替换该状态值的方块。
+
+
+
+
+## 界面编辑器
+
+1. 颜色属性支持通过屏幕进行取色。
+2. 控件的位移，尺寸属性支持小数。
+
+## 云端列表优化
+1. 云端列表作品的最近修改时间固定为云端资源更新时间。
+2. 本地的云端作品更多菜单支持重新下载选项。
+3. 本地的云端作品有更新时通过角标提示更新。
+
+
+## 方块配置更新
+1. 新增了自定义含雪、含水方块的字段。
+2. 新增了配套文件【方块列表属性】，即资源包下的block.json，并将原有的自定义模型、剩余、贴图、贴图随机旋转等选项，一般迁移至方块列表属性下。
+3. 新增实体模型、粒子特效、序列帧特效、颜色渐变图、交叉物品模型和贴图等字段。
+
+
+
+## 配置增加数据模板
+1. **生物群系设置**：新增群系高度实现空岛示例模板。
+2. **特征生成配置**：新增主世界平原生成特征模板。
+3. **附魔配置**：新增稀有稿附魔模板。
+4. **音效配置**：新增自定义创造模式音乐模板。
+5. **自定义维度配置**：新增群系源节点示例模板。
+6. **成就配置**：新增根节点与非根节点示例模板。
+7. **方块配置**：新增红石源、红石元器件示例模板。
+
+
+
+## 其他
+1. Apollo网络服支持设置game服的人数。
+2. 实体配置勾选【自然生成属性】时，自动设置生物蛋的中文名称为游戏内名称。
+3. 附魔配置的右键菜单新增【预览设置】，支持设置预览时生成的附魔等级。
+
+
+
+4. 地图编辑器退出游戏模式时，不再重置编辑器的窗口布局。
+5. 附加包更多菜单→转换为地图时，支持选择已有地图存档。
+
+
+
+6. 逻辑编辑器的连接字符串节点增加默认输入参数。
+7. 新建插件支持开服工具2.0的客户端Mod。
+8. Mod PC包支持聊天优化，如下图，在开发者启动器的设置 - Mod PC开发包中可以找到“是否开启聊天优化”的选项，勾选表示启用聊天优化。我们建议您开启聊天优化进行模组测试。
+
+
\ No newline at end of file
diff --git a/mcguide/10-新内容/1-开发工作台/962-1.0.29.md b/mcguide/10-新内容/1-开发工作台/962-1.0.29.md
new file mode 100644
index 0000000..f87126d
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/962-1.0.29.md
@@ -0,0 +1,27 @@
+---
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2023.04.18 版本1.0.29
+## 地图编辑器结构分页优化
+素材库的结构分页支持直接放置切分信息的json文件从而放置整个结构，并通过**显示切分子结构**复选框隐藏掉切分后的子结构。
+
+
+
+
+## 支持配置微软粒子发射骨骼模型
+在特效编辑器的原版粒子特效中，新增支持了发射骨骼模型的配置属性，并且支持右键快速预览，如下图：
+
+
+
+
+## 云端列表支持作品ID搜索
+在云端列表支持了按照完整作品ID搜索的功能，如下图：
+
+
+
+
+## 其他
+1. 作品创建界面，选择**超平坦**时禁用**世界种子**选项。
diff --git a/mcguide/10-新内容/1-开发工作台/963-1.0.28.md b/mcguide/10-新内容/1-开发工作台/963-1.0.28.md
new file mode 100644
index 0000000..1135e07
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/963-1.0.28.md
@@ -0,0 +1,57 @@
+---
+front: https://nie.res.netease.com/r/pic/20230404/b2c56f26-072e-4287-a79a-a78d6470ee2b.png
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2023.04.06 版本1.0.28
+## 配置编辑优化
+1. 部分配置支持快捷预览
+点击配置条目右侧的快捷按钮，可快速在ModPC包进行预览和测试，详见[这篇文档](../../20-玩法开发/11-组装简单玩法/0-关卡编辑器.md)。
+
+
+
+
+2. 配置数据模板支持导入导出
+部分配置的数据模板支持导出为dt文件，并在其他作品中导入复用，详见[这篇文档](../../15-资源管理/13-配置数据模板.md)。
+
+
+
+3. 配置属性面板新增筛选器
+
+配置属性面板新增筛选器，可以筛选当前配置的一级属性，如下图：
+
+
+
+4. 配置面板支持多种排序规则
+
+
+
+5. 配置属性面板支持记忆当前进度条所在位置。
+
+## 地图编辑器支持替换全部状态值
+当开发者需要替换不同状态的同类方块（如藤曼，楼梯），勾选此选项，即可将不同状态的同类方块聚合成同一个选项，开发者可以批量替换此类方块。
+
+
+
+当开放需要单独替换某个状态的某一类方块（红色羊毛），则只需取消勾选此选项，即可单独指定每个状态的方块的替换目标。
+
+
+
+
+
+## 导入组件功能优化
+1. 统一导入各类型本地组件的交互界面，并自动扫描并判断组件类型。
+
+2. 当选择类型和导入组件不匹配时，弹窗提示。
+
+
+
+## 其他
+
+1. 启动编辑器加载引擎时禁用地形编辑器的游戏模式。
+2. 优化了原版模型转换工具无法正常转换某些动画和贴图的问题。
+3. 内容库其他类型资源下载交互优化。
+4. 开服工具2.0服务器支持提升Mod版本。
+5. 蓝图增加新的模组SDK接口节点，包含2.6的新接口。
\ No newline at end of file
diff --git a/mcguide/10-新内容/1-开发工作台/964-1.0.27.md b/mcguide/10-新内容/1-开发工作台/964-1.0.27.md
new file mode 100644
index 0000000..2ac801f
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/964-1.0.27.md
@@ -0,0 +1,47 @@
+---
+front: https://nie.res.netease.com/r/pic/20230322/9523e693-505f-44e8-adcd-3fefdda3a179.png
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2023.03.23 版本1.0.27
+
+## 原版模型转换工具
+启动器工具箱新增原版模型转换工具，可帮助开发者将作品中的原版模型转换为骨骼模型，详见[这篇文档](../../16-美术/6-模型和动作/11-原版模型转换工具.md)。
+
+
+
+## 内容库新增【其他】分页
+1. 在原有的资源包和作品模板两个分页基础上，新增【其他】分页。
+2. 此分页用于存放无法被编辑器导入或创建为作品的其他资源，如spigot插件、bbmodel格式模型、SDK示例模型等等，下载后可直接在对应目录进行查看和使用。
+
+
+
+## 内容库资源上新
+
+1. 内容库征集活动二期共计35款获奖资源上线内容库！获奖信息可前往[活动网站](https://mc.163.com/dev/nrkzj2/)查询。
+
+
+
+2. 内容库**其他**分页上线3个spigot插件和一个SDK的示例模型包，详情参考[这篇文档](../../27-网络游戏/课程10：使用Spigot开服/99-下载内容.md)。
+
+
+
+## 作品编辑与开发测试界面优化
+1. 优化编辑和开发测试界面的选项布局，调整选项之间的依赖关系，移除无效选项。
+- 编辑界面
+
+
+
+
+- 开发测试界面
+
+
+
+
+2. 导入记录功能移至作品→更多→配置界面，内部文件管理功能调整为配置界面资源包的右键菜单，调整了配置界面的功能布局与交互。
+
+
+
+
diff --git a/mcguide/10-新内容/1-开发工作台/965-1.0.26.md b/mcguide/10-新内容/1-开发工作台/965-1.0.26.md
new file mode 100644
index 0000000..5eb774f
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/965-1.0.26.md
@@ -0,0 +1,45 @@
+---
+front: https://nie.res.netease.com/r/pic/20230309/d3812038-e5b2-42c7-a499-e773d4bed148.png
+hard: 入门
+time: 10分钟
+selection: 23
+---
+
+# 2023.03.09 版本1.0.26
+
+
+## 启动器优化
+
+1. 云端列表、线上网络服分页支持按审核阶段筛选。
+
+
+
+2. 优化了发布作品界面，现在支持通过**作品名称**进行搜索。
+
+
+
+3. 优化了启动时自动清理本地不合规存档的逻辑，现在开发者手动保存的存档不会被强制清除了。
+
+
+## 关卡编辑器
+
+1. 新增**成就配置**，开发者可以在编辑器内配置成就节点，关于成就系统可以参考[这篇文档](../../20-玩法开发/15-自定义游戏内容/16-自定义成就系统.md)。
+
+
+
+2. 优化了**生物群系配置**，补充了自定义高度相关的属性字段，关于自定义地形高度，你可以参考[这篇文档](../../20-玩法开发/15-自定义游戏内容/4-自定义维度/2-群系地貌.md)。
+
+
+
+
+## 特效编辑器
+
+1. 中国版序列帧特效现已支持点滤波。
+
+## 调试工具
+
+1. 日志界面现在会展示正在测试的PE存档、联机大厅存档名称了。
+2. 在调试工具内置的指令代码输入框内，对某一行文本按下快捷键ctrl+/就能注视掉这一行代码，再按一次，就取消注释。
+3. 指令代码输入框内支持tab增加缩进、回车自动缩进。
+4. 指令代码输入框内支持ctrl+滚轮缩放字体大小。
+5. 支持在快捷指令窗口内直接新建指令，并优化了部分功能的交互体验。
diff --git a/mcguide/10-新内容/1-开发工作台/966-1.0.25.md b/mcguide/10-新内容/1-开发工作台/966-1.0.25.md
new file mode 100644
index 0000000..3c9f171
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/966-1.0.25.md
@@ -0,0 +1,105 @@
+---
+front: https://nie.res.netease.com/r/pic/20230220/7b88a6f4-3e1b-4234-bb48-52ece8c03815.png
+hard: 入门
+time: 10分钟
+selection: 22
+---
+
+# 2023.02.21 版本1.0.25
+
+## 开发者文档新增原版Json参考资料
+在开发模组时，开发者不仅需要网易版独有的Json字段，也经常需要使用《我的世界》基岩版原版的合法字段，但原版文档多为英语所著，对许多开发者的理解和使用造成了一定阻碍；
+
+为此，我的世界中国版将基岩版原版的Json参考文档整理并翻译，提供给所有需要的开发者进行查阅，详情请查看[原版参考文档](../../20-玩法开发/100-参考资料/0-索引.md)。
+
+
+
+## 关卡编辑器
+### 1. 多结构特征配置
+
+参照旧版编辑器的交互方式，在新版关卡编辑器中支持了多结构特征的配置。
+
+> **提示：**
+> 旧版作品升级为新版作品时，也会同步进行多结构特征的配置升级，如果开发者自行修改过特征或特征生成配置的Json文件名或标识符等内容，可能会导致升级失败。
+
+
+
+## 地图编辑器
+
+### 1. 【植被】工具支持范围放置
+
+现在植被工具可以在【单点放置】和【范围放置】两种模式直接切换了。【范围放置】模式下支持调整植被的生成区域大小和密度。请阅读[植被工具相关文档内容](../../14-地图制作/7-地形工具.md#7-植被)来了解具体的使用方式和注意事项。
+
+
+
+### 2. 【植被】工具支持的植物类型大幅拓展
+
+植被工具现在支持放置绝大部分原生植物了，从树木到花草、洞穴植物、水生植物，都可以直接生成。
+
+
+
+### 3. 笔刷工具直线生成规则调整
+
+过去笔刷工具的`直线生成`选项，在所选终点位置必然生成一个笔刷形状，这导致实际间距与开发者指定的间距不符。我们这次更新中修改了这一特性，直线生成的终点位置将不在强制生成笔刷形状。
+
+## 逻辑编辑器
+
+### 1. 蓝图零件变量、自定义接口支持分组
+
+开发者在编辑大型蓝图的时候可能会遇到蓝图零件变量、自定义接口的数量过多，现有的排序功能无法满足开发者整理需求的情况。因此，在这个版本，我们推出了蓝图零件变量、自定义接口的分组功能，开发者们可以在[这里](../../20-玩法开发/12-可视化编程/10-新版逻辑编辑器使用说明/40-事件、接口、变量.md)找到详细说明。
+
+默认情况下，蓝图零件变量会被存放在【蓝图零件】分组下，自定义接口会被存放在【接口】分组下。开发者如果需要添加新的分组，只需要在对应的变量/接口属性菜单中找到`变量分组`或者`接口分组`字段，修改它的名字，即可按照这个名字添加新的分类。
+
+> 在分组内仍然支持对变量、接口进行上下拖拽调整顺序。
+
+
+
+### 2. 其他优化
+
+- 对部分包含tuple类型引脚的节点进行了容错处理。
+
+## 特效编辑器
+
+### 1. 原版特效配置模板
+
+使用原版特效进行特效制作的开发者现在可以直接在编辑器中应用一些预设的粒子配置模板了。我们只需要在原版特效的属性面板中找到蓝色的【使用模板】按钮，并在弹窗中通过下拉框选择需要应用的模板，即可用该模板的数据覆盖当前原版特效的数据。
+
+
+
+### 2. 原版特效属性配置字段补充
+
+补充了`粒子更新Tick（Paticle Update）`和`粒子渲染Tick（Paticle Render）`两个字段。开发者可以在[原版特效属性详细说明文档](../../16-美术/9-特效/21-原版特效属性详细说明.md)中查看原版粒子配置的详细说明。
+
+## 调试工具
+
+### 1. 右上角新增【更多】菜单，集成常用工具
+
+我们在调试工具右上角新增了【更多】下拉菜单，存放了一些常用的版本号查看、文档跳转、清除缓存等功能，方便开发者使用。
+
+
+
+
+## 模板和内容库
+
+### 1. 模板新增
+
+- 新建作品界面新增起床战争（纯零件版）模板，并调整了各个分类的作品模板顺序。
+
+ 
+
+- 内容库新增《海滨小岛地图》和《零件界面示例》两个官网教程配套的模板。
+
+ 
+
+
+## 其他
+### 1. 编辑器内支持启用或屏蔽脚本代码逻辑
+使用MODSDK格式编写的脚本代码之前在编辑器内会强制运行生效，导致开发者在编辑器内的操作受到脚本的影响（尤其是涉及游戏模式和传送位置等逻辑时），现在将作品的脚本代码逻辑默认设为关闭，开发者可在下列两个位置进行修改：
+- 游戏预览窗→设置→其他→启用脚本代码选项，如图：
+
+ 
+
+- 编辑作品→启用脚本代码选项，如图：
+
+ 
+
diff --git a/mcguide/10-新内容/1-开发工作台/967-1.0.23.md b/mcguide/10-新内容/1-开发工作台/967-1.0.23.md
new file mode 100644
index 0000000..00a718f
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/967-1.0.23.md
@@ -0,0 +1,135 @@
+---
+front: https://nie.res.netease.com/r/pic/20230206/b02871fa-875d-487e-80f6-61404684c552.png
+hard: 入门
+time: 15分钟
+selection: 21
+---
+
+# 2023.02.07 版本1.0.23
+
+## 教程面板
+编辑器新增教程面板，可通过工具栏的教程按钮打开，如图所示：
+
+
+
+教程面板主要包含以下内容：
+1. 当前编辑器：当前打开的子编辑器简要教程，可通过切换子编辑器进行教程的切换和阅读。
+
+
+
+2. 组件开发：归纳整理了关于组件开发的全流程教程大纲，帮助新手快速定位需要了解的知识点。
+
+
+
+3. 知识库：收纳了来自开发者频道-知识库中由开发者分享的精华文章，包括【必看文章】和【优秀文章】两个系列。
+
+
+
+4. 反馈与交流：简要介绍了开发者最常用的交流和反馈渠道，包括开发者频道，官网，内容管理平台，B站，公众号等等。
+
+
+
+## 编辑器常用功能支持悬浮提示
+对各个子编辑器内常用的功能面板和按钮的悬浮提示进行了优化，你可以将鼠标悬浮在功能按钮上触发提示，如图所示：
+
+
+
+> 温馨提示：如果你已经熟练掌握编辑器的所有功能使用，希望关闭提示，可通过预览窗右上角【设置按钮】→【其他】关闭新版的悬浮提示，如图所示：
+
+
+
+## 预览窗工具栏更新
+
+本次更新，我们推出了**预览窗工具栏**功能。它位于编辑器预览窗的正上方，用于对编辑器内嵌游戏进行设置。不同编辑器下视口工具栏中可以使用的功能是不同的，具体请见[这篇文档](../../20-玩法开发/11-组装简单玩法/4-预览窗工具栏.md)
+
+
+
+## 调试工具
+
+### 1. 连接地址保存优化
+
+为了解决开发者们反馈的同一设备连续多次连接会出现多条相同的连接地址记录问题，本次更新调整了保存连接信息的数据结构。
+
+**本次更新后烦请开发者们重新输入IP地址，将移动端设备连接至调试工具。**
+
+### 2. 日志界面展示PC端正在测试的存档名称
+
+开发者在PC开发包测试组件时，日志界面调试窗口的左上角会展示当前正在测试的存档名称，方便开发者在多开状态下判断日志信息属于哪个进程。
+> 未来我们也计划添加PE测试端存档名称显示的功能，敬请期待。
+
+
+
+### 3. UI调试工具显示控件轮廓
+
+在UI调试工具的面板中，开启显示控件轮廓后，可以对UI控件轮廓进行显示，辅助进行UI控件的点选。
+详情参考[UI调试工具](../../30-测试/4-UI调试工具.md#游戏中定位控件)
+> 目前仅支持PC端的调试，未来我们也计划添加PE端支持，敬请期待。
+
+
+
+### 4. 其他调整
+
+- 屏蔽了部分引擎侧日志信息，减少无效日志打印。
+
+
+## 逻辑编辑器
+
+### 1. 支持使用逻辑编辑器开发联机大厅作品
+
+现在开发者们可以使用逻辑编辑器制作联机大厅作品了。
+
+### 2. 可缺省参数标注
+
+我们在节点的可缺省参数后添加了“（可选）”文字标注，方便开发者们按需填写。
+
+
+
+### 3. 基础运算（加减乘除）节点支持添加引脚
+
+基础运算节点现在可以点击属性面板中的“+”按钮添加更多参数了，这样可以更快捷地进行连加、连乘等操作。
+
+
+
+## 地图编辑器
+
+### 1. 蒙版工具状态值选择支持选择全部状态值
+
+- 勾选：代表选中当前方块的全部状态值。
+- 取消勾选：代表只选中当前方块的一种状态值。取消勾选后左侧状态值下拉框可编辑。
+
+
+
+### 2. 其他调整
+
+- 蒙版“更多设置”按钮位置调整到蒙版成分的左侧，以防蒙版成分方块较多时被遮挡。
+- 调整了蒙版设置中，方块删除操作的交互体验。
+
+## 特效编辑器
+
+### 1. 原版粒子特效属性配置说明
+
+为了方便开发者们直接在编辑器中创建和编辑原版粒子特效的属性信息，并实时预览，我们编写了[《原版特效属性详细说明》](../../16-美术/9-特效/21-原版特效属性详细说明.md)供大家参考。如有需要，可链接阅读。
+
+### 2. 特效编辑器开发指南文档更新
+
+我们整体翻新了开发指南中特效编辑器的说明文档，使文档内容与新版特效编辑器功能和交互保持一致。有需要的开发者可以[前往查看](../../16-美术/9-特效/00-特效编辑器简介.md)。
+
+
+
+### 3. 其他调整
+
+- 原版粒子配置涉及方向的参数标明XYZ轴向。
+
+## 内容库与模板
+
+1. 新建作品窗口新增了入门SDK脚本模板，用传统SDK的方式配置了最简单的脚本示例（行为包下的BlankScripts文件夹），注意与入门预设脚本模板区分，如图所示：
+
+
+
+2. 内容库新增商人NPC零件，资源点零件以及部分官网教程的配套模板。
+
+
+
+## 其他
+1. 支持了新版空白地图和空白附加包模板的仅创建功能
+2. 修改了新建文件向导中创建的代码文件内容，修改了导入（import）部分代码的格式，使其能够正常使用代码补全库。
diff --git a/mcguide/10-新内容/1-开发工作台/968-1.0.22.md b/mcguide/10-新内容/1-开发工作台/968-1.0.22.md
new file mode 100644
index 0000000..37c00ee
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/968-1.0.22.md
@@ -0,0 +1,88 @@
+---
+front: https://nie.res.netease.com/r/pic/20230111/d0c66e62-4974-412c-ba69-231d59513bc9.png
+hard: 入门
+time: 10分钟
+selection: 20
+---
+
+# 2023.01.11 版本1.0.22
+
+
+
+## 启动器
+启动器的作品更多菜单新增【复制】功能。
+
+
+
+## 地图编辑器
+
+### 1. 笔刷工具大更新
+
+地图编辑器笔刷工具在这个版本进行了较大改动。主要更新内容如下：
+
+- 新增**圆锥、多棱柱**笔刷形状。
+
+ 
+
+- 部分笔刷形状支持了去除底面、仅框架的结构选项，并且可以调节厚度。
+
+ 
+
+- 新增**素材笔刷**，支持直接应用素材库素材为笔刷形状。
+
+ 
+
+### 2. 开发指南文档更新
+
+[地图编辑器相关开发指南文档](../../14-地图制作/2-地图编辑器使用说明.md)更新，删除了过时的文档内容。
+
+
+
+## 逻辑编辑器
+
+### 1. 节点菜单鼠标悬停提示
+
+逻辑编辑器右键节点菜单和节点搜索结果菜单都添加了鼠标悬停提示。当开发者将鼠标悬停在某个节点上时，将通过tips提示框展示更多节点信息，省去了开发者反复查看文档确认节点用途的时间。
+
+显示的提示内容与API文档的节点描述相同。
+
+
+
+### 2. 其他功能修改
+
+- 枚举值节点名称格式修改为【英文名（中文翻译）】，方便开发者按英文名搜索相关文档。
+- 对部分旧版节点名称做出了修改。
+
+### 3. 开发指南文档更新
+
+[新版逻辑编辑器使用说明](../../20-玩法开发/12-可视化编程/10-新版逻辑编辑器使用说明/01-什么是逻辑编辑器.md)更新，删除了过时的文档内容。
+
+## 特效编辑器
+
+### 1. 微软粒子配置支持曲线可视化编辑
+
+现在可以在属性菜单的最下方找到【曲线】，点击【+】新增曲线，然后进行可视化编辑。
+
+
+
+## 调试工具
+
+### 1. 日志窗口行数限制修改
+
+现在调试工具日志窗口的默认消息行数从1000改为5000，并且新增最大行数选项10000。
+
+### 2. 游戏启动器侧日志屏蔽
+
+默认屏蔽了游戏启动器侧发送的日志，这些日志通常在开发者的组件调试过程中是不需要查看的。
+
+### 3. 客户端代码traceback打印
+
+现在调试工具可以正常打印出客户端代码的traceback了。
+
+### 4. UI调试工具的属性名称支持中英文切换
+
+## 其他
+1. MCResource自定义属性控件兼容非作品目录下的原生游戏路径，例如原版游戏的掉落表路径，贴图路径等，不再报错。
+2. PDict 自定义属性控件新增fixlist属性，用于单独控制每个子属性的添加和移除权限，[自定义属性面板](../../20-玩法开发/14-预设玩法编程/12-深入理解零件/1-自定义属性面板.md)。
+3. 调整了部分内容库资源的标签分类。
+
diff --git a/mcguide/10-新内容/1-开发工作台/969-1.0.19.md b/mcguide/10-新内容/1-开发工作台/969-1.0.19.md
new file mode 100644
index 0000000..f923963
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/969-1.0.19.md
@@ -0,0 +1,44 @@
+---
+front: https://nie.res.netease.com/r/pic/20230106/8b71d88c-16f1-437c-8863-df6f4d787c3a.png
+hard: 入门
+time: 10分钟
+selection: 19
+---
+
+# 2022.12.29 版本1.0.19
+
+## 逻辑编辑器
+
+### 1. 调用对象参数引脚说明增加
+
+为了让开发者们更清楚地了解各个节点的【调用对象】引脚应该传入什么，我们为该引脚添加了括号注释，开发者们按照注释内容进行连接即可。
+
+
+
+
+## 配置
+
+扩展[配方配置](../../20-玩法开发/15-自定义游戏内容/5-自定义配方.md)，补充支持了物品耐久度，多产物配方，酿造台配方等新字段。
+
+
+
+
+## 内容库资源上新
+新增内容征集活动第一期的获奖作品资源,可通过内容库中的“征集活动作品”标签快速筛选出所有的征集活动获奖作品。
+
+
+
+
+
+## 其他
+
+1. 新建作品支持**仅创建**选项，通过此选项创建作品不会强制启动编辑器编辑，而是跳转到创作页查看该作品。
+> 创建**空白地图**时不支持该选项，必须启动一次编辑器生成地图存档。
+
+
+
+2. 创建自定义维度配置时，自动随机生成带有随机数字的合法json命名，避免因错误命名导致维度无法正常访问，如下图。
+
+
+
+3. UI调试工具的属性增加搜索功能
\ No newline at end of file
diff --git a/mcguide/10-新内容/1-开发工作台/970-1.0.18.md b/mcguide/10-新内容/1-开发工作台/970-1.0.18.md
new file mode 100644
index 0000000..c3ba61d
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/970-1.0.18.md
@@ -0,0 +1,152 @@
+---
+front: https://nie.res.netease.com/r/pic/20221214/df0e7ce6-5cb8-4d48-a3a9-500577f7cc61.png
+hard: 入门
+time: 15分钟
+selection: 18
+---
+
+# 2022.12.15 版本1.0.18
+
+## 编辑器新增反馈按钮
+
+在使用编辑器时遇到了bug、闪退、功能缺失等问题？请毫不犹豫地反馈给我们！新版本编辑器顶部工具栏新增了反馈按钮，点击后会跳转至[开发者平台反馈网页](https://mcdev.webapp.163.com/#/feedbackModal?target=browser)。
+
+
+
+在填写反馈信息时，请开发者们尽可能提供：
+- **开发者账号（邮箱）**
+- **电脑系统信息、硬件配置**
+- **问题的详细描述**
+- **问题发生的时间和频率**
+
+## 编辑器维度切换
+
+### 1. 编辑器正式支持维度切换功能
+
+长期以来编辑器都只支持对主世界场景进行编辑（或者通过复杂的指令跳转到其他维度进行操作）。从现在开始，编辑器将支持对内嵌游戏维度的快速切换，从而让开发者们能够快速便捷地前往下界、末地，或其他自定义维度。有了这个功能，你可以：
+
+- [在关卡编辑器中搭建不同维度的游戏场景](../../20-玩法开发/11-组装简单玩法/0-关卡编辑器.md#关卡编辑器维度切换)
+- [在地图编辑器中编辑不同维度的地图](../../14-地图制作/2-地图编辑器使用说明.md#维度切换)
+
+
+
+## 逻辑编辑器
+
+### 1. 节点目录重新整理
+
+逻辑编辑器上线后，我们经常收到反馈说节点分类看不懂、各种名词难以理解的情况。
+
+经过这个版本的调整，我们现在将逻辑编辑器的内置节点分类，调整为**与开发者官网API文档分类一致**。这样的分类更通俗易懂，也更符合MC开发者的命名习惯。
+
+大家可以依据自己在API文档中的浏览顺序，在逻辑编辑器的节点菜单中查找节点。
+
+
+
+### 2. 广播、监听、取消监听事件节点
+
+我们对事件广播、监听、取消监听的系列节点进行了整合。在之前的版本，开发者需要记住不同情况下使用的节点名称，并在海量的节点中搜索这些节点，导致很多新手用户反馈看不懂如何在蓝图中进行事件广播和监听。
+
+现在，大家只需要在节点菜单中找到【事件广播与监听】目录，然后从中选择自己是需要【广播/通知事件】、【监听事件】，还是【取消监听事件】，即可创建对应类型的节点。
+
+
+
+具体的广播、监听、取消监听范围，开发者可以通过范围选择下拉框进行指定。我们提供了hover文本提示，以帮助各位了解自己需要使用哪一种范围。
+
+
+
+想查阅关于广播、监听、取消监听节点的更多使用指南，请看[这篇文档](../../20-玩法开发/12-可视化编程/10-新版逻辑编辑器使用说明/47-事件监听与广播.md#监听和广播自定义事件)。
+
+### 3. 富文本分组框
+
+我们在普通分组框的基础上新增了富文本分组框，以便让有需要的开发者能够直接进行富文本编辑，在分组框的展示文本中使用加粗、字体颜色、超链接等。
+
+
+
+富文本分组框通过在蓝图右键菜单选择【创建分组】-【创建富文本分组】进行创建，编辑富文本时需要右键点击富文本分组框，选择【设置富文本内容】，然后在弹出的输入框内使用 **HTML语法** 编写。
+
+
+
+### 4. 巨量节点蓝图性能优化
+
+我们优化了巨量节点蓝图的性能表现，解决了当一个蓝图存在数千个节点时可能出现的卡顿、崩溃问题。
+
+我们为开发者丰富的创造力和持之以恒的创作而赞叹，感谢各位使用逻辑编辑器做出了丰富多彩的玩法组件。与此同时，我们也希望大家可以合理地将玩法逻辑分配到多个蓝图零件中，并使用事件通信将他们串联起来，避免在同一个蓝图中使用过多节点而造成不必要的性能损耗。
+
+## 地图编辑器
+
+### 1. 地形操作新增强度参数
+
+对地形操作生效。即每秒进行的操作次数，取值范围为1~10之间的整数。
+
+
+
+### 2. 地形操作新增凹陷工具
+
+开发者们现在可以更方便地在平整的表面上挖洞了。
+
+
+
+
+## 特效编辑器
+
+### 1. 微软粒子编辑器内配置
+
+从这个版本开始，特效编辑器将支持对微软原版粒子的配置编辑。在资源管理器选中微软粒子配置文件，或在挂接面板选中一个已挂接的微软粒子实例，即可在右侧属性窗口对其配置进行修改。
+
+这个版本的配置编辑**暂不支持曲线的可视化编辑**，我们将在后续的版本补充这个功能。
+
+
+
+需要注意的是，如果你需要修改微软粒子贴图，请先在资源管理器的【导入】按钮处使用【其他贴图】类别导入，然后拖动到属性窗口的顶部的【纹理】处。
+
+
+
+## 调试工具
+
+### 1. 调试工具正式代替脚本测试日志
+
+从这个版本开始，调试工具将正式取代脚本测试日志，作为开发测试日志查看的优先拉起工具。调试工具继承了脚本测试日志的全部功能，并新增了python指令调试、客户端组件管理、免机审组件同步、UI调试工具等高级功能。如果你还不了解调试工具，请阅读[这篇文档](../../30-测试/1-使用调试工具进行手机和电脑端调试.md)。
+
+
+
+> 如果你仍希望继续使用旧版脚本测试日志，可以点击左下角的【切换到脚本测试日志】按钮。同样，在脚本测试日志窗口也可以切换使用调试工具。
+
+### 2. 调试工具支持iOS测试服日志浏览和指令调试
+
+是的，调试工具现在支持了iOS手机测试服了。开发者们可以像连接安卓测试服一样连接iOS测试服，并进行日志浏览、指令调试、组件同步等操作。
+
+### 3. 组件同步自动扫盘获取对应组件
+
+现在在进行组件同步时，有2种方式选择需要上传的组件文件：
+**1）通过下拉框直接选择Studio作品库中的作品；**
+2）像以前一样通过在资源管理器中浏览、定位文件夹的方式上传。
+
+
+
+### 4. 新增UI调试工具
+
+新增UI调试工具，用于在开发测试时对界面进行调试，包括原生界面。调试功能包括查看界面的控件结构，以及各控件的部分属性值。详情参考[UI调试工具](../../30-测试/4-UI调试工具.md)。
+
+
+
+## 配置
+
+1. 修改[方块配置](../../20-玩法开发/15-自定义游戏内容/2-自定义方块/0-自定义方块概述.md)，补充大量缺失的网易版字段，如红石，流体方块、重力方块等字段。
+2. 修改[实体配置](../../20-玩法开发/15-自定义游戏内容/3-自定义生物/01-自定义基础生物.md)，补充支持了实体组件组、实体事件、实体资源包配置等字段。
+3. 配置面板对任意配置右键可**复制配置**，帮助开发者快速创建大量配置副本。
+
+
+## 内容库资源上新
+1. 新增幸运方块模板。
+2. 新增3D盔甲模型、自定义箱子和箱子锁等官网文档中的示例资源。
+3. 新增内容征集活动的部分获奖作品资源。
+
+
+> 内容库资源征集活动的剩余获奖作品将在后续版本陆续放出，敬请期待。
+
+
+## 其他优化和修复
+1. 修复了启动器首页中的banner轮播方向错误的问题。
+2. 修复了实体配置无法读取entities文件夹的子文件夹下的行为包Json的问题。
+3. 修复了方块配置中无法读取texture/block的子文件夹下的图片的问题。
+4. Apollo服务器配置的更多分页，增加允许PC用户进入的选项，如果你的服务器包含PC版本，需要勾选此项。
\ No newline at end of file
diff --git a/mcguide/10-新内容/1-开发工作台/971-1.0.17.md b/mcguide/10-新内容/1-开发工作台/971-1.0.17.md
new file mode 100644
index 0000000..f227ba1
--- /dev/null
+++ b/mcguide/10-新内容/1-开发工作台/971-1.0.17.md
@@ -0,0 +1,47 @@
+---
+front: https://nie.res.netease.com/r/pic/20221116/8885f8bd-1978-4102-8d7e-ee8768e056c2.png
+hard: 入门
+time: 10分钟
+selection: 15
+---
+
+# 2022.11.15 版本1.0.17
+
+## 逻辑编辑器
+
+1. 蓝图分组框现在可以支持文本换行，方便开发者们对节点组合添加更多的备注信息。
+
+2. 逻辑编辑器左侧【当前蓝图】窗口交互流畅度优化。
+
+## 特效编辑器
+
+1. 特效编辑器现在支持在不改变模型的情况下仅导入模型动作。
+
+
+## 内容库
+
+1. 内容库的资源卡片优化，新增新品标签及更新提示。
+2. 新增生物警卫零件，挂载实体预设下，可驱动该实体守卫指定区域，并主动攻击入侵的敌对生物
+
+3. 新增一键建筑零件，挂载空预设下，仅需简单配置建筑的名称描述和对应的结构文件，制作一键建筑类模组。
+
+
+## 配置
+
+1. 新增[自定义维度](../../20-玩法开发/15-自定义游戏内容/4-自定义维度/1-自定义维度.md)配置，用于配置每个自定义维度的属性，如世界类型，生成器，屏蔽原版特征等属性。
+2. 为部分配置替换了独一无二的图标。
+
+
+## 预设API更新
+1. 新增获取预设零件所在维度的接口，部分已有接口增加维度参数（包括逻辑编辑器节点）。更多文档请参考
+
+当前地图编辑器支持的模型类型有：`.obj`、`.fbx`、`.3ds`、`.ply`、`.stl`。
+
+如果模型本身自带贴图，编辑器会读取其颜色，并做简单的颜色匹配，生成彩色素材。
+
+MC中可以与贴图颜色对应的方块有限，开发者可以在模型生成后按需要使用 **替换** 工具进行进一步的方块调整。
+
+
+
+
+
+#### 应用素材到预设
+
+您可以将素材导入为预设素材，这样在预设编辑器就可以将素材挂接到预设上。
+
+
+
+在预设编辑器打开一个空预设后，可以点击工具栏的 **添加素材** 按钮，将刚刚在地图编辑器中保存的素材导入到预设中。
+
+
+
+
+
+## 结构
+
+### 结构的保存
+
+使用选取工具创建选区后，右键选区点击 **保存为结构**，即可将包围盒选择范围内的方块保存为结构`.mcstructure`文件。
+
+
+
+保存时有如下选项可以选择：
+
+- **包含实体：** 保存的结构数据文件中将包含实体(动态,可移动)对象信息。
+
+- **去除空气方块：** 生成的结构数据文件中将不包含空气方块信息。
+
+- **保存为网易版优化结构：** 在文件尺寸和性能上做出一定优化。
+
+- **切分结构：** 会按照选择的结构边长，将结构切分成多个结构数据文件，适用于大范围的方块信息保存。
+
+::: info 切分结构
+
+切分结构生成的结构文件在当前作品的 行为包的`structures/命名空间` 文件夹下 。
+
+:::
+
+
+
+
+### 结构的使用
+
+保存的结构可在素材库窗口的 **结构** 分页找到。可以直接像摆放素材一样，通过鼠标点击将结构摆放至场景中。
+
+::: danger 注意
+
+需注意的是，【结构】分页仅会显示当前作品中的结构文件，并不会像素材一样可以跨作品使用。
+
+结构同样也可以连续摆放，并且支持[在放置前进行二次编辑](#放置前的二次编辑)。
+
+:::
+
+
+
+另外，我们也可以使用结构方块，输入对应结构文件所在文件夹和文件名称来使用此结构。
+
+
+
+如果选择了切分结构，将选择范围内的方块生成多个结构文件保存，则会同时生成对应的各个结构文件基础坐标的配置信息。
+
+
+
+
+
+解析此配置文件，通过`ModSDK`的
+
+ 
+
+### 2.2 建模附材质
+
+#### 2.2.1 制作模型
+
+根据绘制草图制作模型，建模部分可以在原本的格子上直接挤出来造型。**注意挤出的高度单位也是1**。
+
+建模方法如下：
+
+1. 根据游戏中的规范，用头部放大，然后删去不要的部分来建模（比如大天狗）。
+
+ **注意方法1与方法2不能使用在同一个部件上**。
+
+2. 如果头发造型过于复杂或者有动作上的可能性，则需要另外建模（比如酒吞童子）。
+
+ **注意检查挤出后不要有一些废面藏在模型里。**
+
+
+
+#### 2.2.2 开始上色
+
+因为我们使用的是一像素单位的像素格，使用为单个面赋予材质球的方式来上色。
+
+**给同一个色相类型的材质球命名好，编好号，方便管理。（比如黄色以Y开头，Y-1 、Y-2类似）**
+
+区分好固有色后，开始细分色阶，同样一个固有色细分2~4个色阶，不要太多，细分太过细腻会削弱像素元素本身的美感。
+
+
+
+
+
+### 2.3 材质球（贴图）处理
+
+本步骤是为了方便整理材质，也可以不做
+
+
+
+在上一步模型以及材质赋予步骤完成之后，参考上图步骤清空材质球选框，依次从左至右吸取头发、头部、身体等材质。（将会得到如上的多维子材质球）
+
+制作中需要注意单个颜色的ID的排序参考上图由浅至深依次排列，方便制作以及修改。
+
+1. 按照下图中三个步骤，新建一个材质库
+
+ 
+
+2. 保存材质库的命名（以角色名称为命名），之后材质目录中会出现该材质库（下图示例：yunv)
+
+ 
+
+3. 选择单一材质球，依下图标识将该材质球加入材质库（所有材质球依次制作一遍）
+
+ 
+
+ 注意材质球需要以部件名称为命名
+
+ 
+
+4. 再次打开材质库，可见所有材质球已经被导入材质库，在材质库中右键，保存入第一步中创建的mat文件中即可。**这么做的原因是为了方便整理材质球，便于调整颜色。**
+
+ 
+
+### 2.4 后处理
+
+#### 2.4.1 分UV
+
+
+
+- 所有的UV线都必须横平竖直，不能有倾斜，否则会出现锯齿。
+
+- UV边界需要像素填充，通过烘焙可以扩边4个像素
+
+- UV摆放原则，身体结构按部位从上到下摆放，不能颠倒朝向
+
+- UV格子大小需要基本一致，不能有太大的差别
+
+#### 2.4.2 烘焙
+
+**注意烘焙之前上传一版NXN做备份**
+
+
+
+启用填充，烘焙贴图有扩边效果
+
+
+
+贴图大小可以烘焙得大一点提高精度，然后在PS里面缩小到**512X512**，注意缩小的时候使用邻近（硬边缘），因为都是像素格，这样缩小不会损失任何精度。
+
+#### 2.4.3 减面
+
+只留下必须的点面，多余的点面全部减掉，注意贴上烘焙好的贴图进行减面，**减的时候注意不要出现贴图拉伸变形的情况。**
+
+
+
+
+
+### 2.5 完成
+
+制作完的MAX文件，贴上烘焙好的贴图的效果截图
+
+
\ No newline at end of file
diff --git a/mcguide/16-美术/6-模型和动作/03-骨骼模型制作指南（Blender）.md b/mcguide/16-美术/6-模型和动作/03-骨骼模型制作指南（Blender）.md
new file mode 100644
index 0000000..3d25d3b
--- /dev/null
+++ b/mcguide/16-美术/6-模型和动作/03-骨骼模型制作指南（Blender）.md
@@ -0,0 +1,182 @@
+---
+front:
+hard: 入门
+time: 分钟
+---
+
+# 骨骼模型制作指南（Blender）
+
+## 1.模型制作技术规范
+
+使用软件：blender 2.82
+
+### 1.1 模型单位设置
+
+模型单位设置为：英寸
+
+
+
+
+
+### 1.2 朝向
+
+背对y轴，x轴朝右，z轴朝上
+
+
+
+
+
+### 1.3 贴图
+
+只支持一张贴图，贴图名称必须为英文
+
+**模型制作当中，避免使用镜像或者对称！**
+
+
+
+### 1.4 顶点
+
+每个长方体通常是8个，整个模型控制在300个顶点，特殊模型可以在1000以内
+
+每个顶点只绑定一根骨骼
+
+注意事项：法线检查
+
+模型制作完成提交前必须完成2个步骤：
+
+- 检查法线朝向
+
+
+
+- 游标归于模型中心，模型位于场景中心
+
+
+
+
+
+### 1.5 关于蒙皮
+
+对于蒙皮，主要注意以下几点：
+
+ 1）骨骼需要有总控root骨骼，且每部分只能用一根骨骼，骨骼示意以及层级关系如下图：
+
+
+
+2）骨骼命名也需要按照肢体去规范名字
+
+- 总控=root
+- 身体=body
+- 头=head
+- 左胳膊=arm_l
+- 右胳膊= arm_r
+- 左腿=leg_l
+- 右腿=leg_r
+
+3）骨骼数要控制在20根以内，最多不能超50（某种特殊boss可能会用到50根以内的骨骼，常规要控制在20根以内）
+
+4）蒙皮需要注意的，每个模块只能受一根骨骼影响，如下图所示，头部只能受“head”骨骼影响。
+
+
+
+5）FBX输出设置
+
+
+
+
+
+## 2.制作流程
+
+下面以大天狗制作流程为例说明骨骼模型的制作过程。
+
+### 2.1 原画概念设计
+
+1）打开人形式神基础模型（基础模型的每个格子单位为1，就是像素单位，不要改变这个大小）
+
+
+
+2）利用材质球上色截图或者PS上色均可，正面的效果可以比较快的确定颜色分布
+
+
+
+3）增加外轮廓的辨识度，突出的部分尽量归纳，减少细节，这一步使用PS绘制概念图
+
+
+
+4）进一步增加轮廓的辨识度，注意角色身上最具有特点的部位，一个角色身上只有一到两个特征需要这样强调，比如大天狗的翅膀。这一步同样使用PS绘制示意图，背面也需要有设计，因为风格限制，不强制侧面的效果，但是需要考虑到4分之一侧面的效果
+
+
+
+
+
+参考：《阴阳师》大天狗设计图，在转换为我的世界模型风格时，需要减少没有代表性的琐碎细节。
+
+鞋子的造型需要直接归纳到腿部
+
+翅膀的3层羽毛层次减少到2层，边缘细节概括处理
+
+**注意：设计归纳的时候注意估算一下顶点数量，小怪300以下，复杂模型700以下，BOSS1000以下，尽量低于最高值，以免制作完成后超过难以修改。**
+
+
+
+### 2.2 建模和着色
+
+#### 2.2.1 制作模型
+
+根据原画，制作模型，建模部分可以在提供的标模的格子上直接挤出来造型。注意挤出的高度单位也是1。
+
+1：根据游戏中的规范，用头部放大，然后删去不要的部分来建模。（比如大天狗）
+
+2：如果头发造型过于复杂或者有动作，则需要另外建模。（比如酒吞童子）
+
+**注意：关节处的模型体块必须分开制作（胳膊，腿，身体的体块都是要分开的，动物类模型尾巴有转折的话，尾巴的转折处也要分开制作）**
+
+#### 2.2.2 开始上色
+
+
+
+ 材质属性面板，选中需要着色的面，赋予不同颜色的材质球，因为颜色会比较多，材质球命名上可以用类似：green_01,green_02这种方便查找对应的颜色。
+
+
+
+### 2.3 后处理
+
+#### 2.3.1 UV拆分
+
+所有的uv必须横平竖直，不能有倾斜，否则会出现锯齿
+
+每块uv边界之间要留至少两个像素的距离，贴图要制作扩边
+
+uv摆放时可以导入一张对应贴图像素大小的棋盘格，每一条uv边缘线都必须要和棋盘格的格子对齐
+
+
+
+#### 2.3.2 减面
+
+
+
+
+
+复制一个模型减面，（或拓扑，用拓扑的话，就可以拓扑后再拆分uv，uv摆放的规则一定要重视）只留下轮廓线，多余的线全部删掉。
+
+填色的高模备份一个，后面烘焙颜色用。
+
+
+
+#### 2.3.3 烘焙颜色
+
+烘焙类型选择漫射，烘焙颜色的时候可以提高贴图精度，之后再用PS缩小到128像素大小
+
+
+
+注意缩小图像大小的时候使用邻近（硬边缘），因为都是像素格，不会损失精度。
+
+
+
+### 2.4 完成
+
+贴上烘焙好的贴图效果截图如下：
+
+
+
+
+
diff --git a/mcguide/16-美术/6-模型和动作/04-骨骼模型的使用.md b/mcguide/16-美术/6-模型和动作/04-骨骼模型的使用.md
new file mode 100644
index 0000000..b0c17a4
--- /dev/null
+++ b/mcguide/16-美术/6-模型和动作/04-骨骼模型的使用.md
@@ -0,0 +1,343 @@
+---
+front:
+hard: 入门
+time: 分钟
+---
+
+# 骨骼模型的使用
+
+骨骼模型、骨骼动画的制作请参考[骨骼模型制作指南(3DMAX)](02-骨骼模型制作指南（3DMAX）.html)等相关文档。
+
+通过专业的模型制作软件完成模型后，导出为FBX格式，然后再转换为《我的世界》中的模型格式（JSON格式），相应的方法请查阅[教学中心-编辑器基础-特效编辑器-入门教程01-模型导入与使用](../9-特效/10-模型导入.md#1-导入fbx模型)。
+
+> 如需将已转换为我的世界中国版格式的骨骼模型导入至其他作品中，可以参考[骨骼模型（json）的导入](../9-特效/10-模型导入.md#2-导入骨骼模型json)
+
+在将骨骼模型转换为JSON格式后，我们就可以准备在游戏内使用骨骼模型了。以离线文档中 **示例/6-4 资源制作/工具和示例/fbxRes/xuenv** 资源为例，先在编辑器中导入这个模型，然后按下面的步骤进行。实际上下面的1~3步目前编辑器已经自动完成了，需要手动操作文件时可以参考。
+
+
+
+## 1. 填入模型路径信息
+
+在`mod_resource/models/netease_models.json`里面填入模型的骨骼，网格及动作的文件路径（目前编辑器已经自动做好这一步了），如下图所示：
+
+
+
+**骨骼模型动画的命名最好使用英文单词/拼音/数字/下划线组成。**
+
+## 2. 将资源放入对应目录
+
+将skeleton、mesh、animation资源放入`mod_resource/models`下对应的文件夹：
+
+
+
+## 3. 指定贴图
+
+mesh文件中会有指定material，如下图所示：
+
+名称对应到`mod_resource/textures/models/xuenv.png`，所以需要在此位置放置贴图资源。
+
+
+
+## 4. 代码调用
+
+采用component的结构来创建模型与控制动画播放
+
+创建模型替换原有模型
+
+```python
+modelComp = self.CreateComponent(playerId, 'Minecraft', 'model')
+# 'xuenv'即为netease_models.json里配置的骨骼模型名称
+modelComp.SetModel('xuenv')
+```
+
+播放动画
+
+```python
+modelComp = self.GetComponent(playerId, 'Minecraft', 'model')
+# 播放动画'prepare'，第二个参数设置为True表示循环播放该动画，接口详细信息可以查看modAPI接口文档
+modelComp.PlayAnim('prepare', True)
+```
+
+## 5. 第一人称模型
+
+上面部分完成了第三人称视角的骨骼模型显示及动画播放，当我们想在游戏中切换到第一人称也有骨骼模型与动作时，需要另外做一套骨骼模型和动作（如下图的steve_fp），并且使动作的名称与第三人称模型的动作一致。然后把他配置为第三人称模型的“arm_model”，例如：
+
+
+
+在上图中，我们可以看到steve有骨骼模型动画，这些属于第三人称视角的骨骼模型动画，steve中的”arm_model”属性可关联第一人称视角的骨骼模型。配置第一人称视角骨骼模型之后，当玩家切换到第一人称视角时，如果手上无物品或者手上物品不显示，则会显示第一人称骨骼模型（即这里的“steve_fp”）。
+
+当播放动作时，第一人称视角模型的动作会跟随第三人称模型。例如给本地玩家替换steve模型后，播放walk动作，那么切换到第一人称视角时，显示的steve_fp模型也会播放walk动作。
+
+如果替换的第三人称骨骼模型没配置”arm_model”字段（例如上述的”xuenv”模型），则在第一人称视角下手上无物品或者手上物品不显示时，不会显示任何模型。
+
+## 6. 模型贴图序列帧动画
+
+骨骼模型动画除了支持上述在animation文件夹下放置相应的json文件这一方式外，也支持另一种只是单纯贴图变化的序列帧动画：
+
+
+
+制作这种贴图序列帧动画需要两个步骤，我们以上述的雪女为例：
+
+1) 用图片处理工具修改`mod_resource/textures/models/xuenv.png` 路径下的这张贴图：
+根据动画需要的帧数横竖方向重复铺开，此例中我们以6行5列总共30帧进行制作，处理每一帧中贴图需要变化的部分，序列帧播放的顺序由贴图的左上角先横再竖播放到贴图的右下角。
+
+原图：
+
+
+处理后：
+
+
+2) 修改`mod_resource/models/netease_models.json`中雪女的json配置，新增frame_anim字段：
+
+
+
+字段中各参数意义如下：
+row: 贴图动画中分了多少行，此例中6行5列即6行，所以此处填6
+col: 贴图动画中分了多少列，此例中6行5列即5列，所以此处填5
+frames: 帧数，此例中为30帧（此数字不一定为row乘col的值，允许贴图留有空白，假如贴图右下角留了一帧的空白区域，此处可填29）
+time: 动画总时长，此例中为5秒，代表5秒内播放完30帧，然后开始循环
+
+注意：
+为了节省运行时的内存，建议资源制作时尽量秉持宽高最邻近二次幂数相乘最小原则。
+所谓最邻近二次幂数，即数字往上寻找最靠近自己的二次幂，二次幂就是1，2，4，8，16，32，64，128，256，512，1024，2048等等。
+比如一张贴图为200 * 200的分辨率，200的最邻近二次幂数为256，则加载入内存后即占用256 * 256的大小，此处为了讲解方便，简化了一些计算细节，读者可简单理解为内存占用与宽高成正比。
+在此例中，我们雪女单帧的图片大小256 * 256，6行5列排放后为1280 * 1536, 宽高最邻近二次幂数分别为2048和2048，所以占用内存为2048 * 2048。
+但假如我们调整一下，用横4，竖8的方式排放，宽高即为1024 * 2048，此方式最高可支持 4 * 8 = 32帧，宽高最邻近二次幂数分别也为1024和2048，占用内存即为1024 * 2048，内存占用可降低到原来的一半！
+
+最后，在代码调用时无须添加额外代码即可生效：
+```python
+modelComp = self.CreateComponent(playerId, 'Minecraft', 'model')
+# 'xuenv'即为netease_models.json里配置的骨骼模型名称
+modelComp.SetModel('xuenv')
+```
+
+
+
+## 7. 模型使用自定义材质及更多贴图
+
+若我们想要实现更为复杂的渲染效果，则可能会需要使用特殊的shader及shader所需要采样的贴图，这时候我们需要修改材质，并配置为使用我们的shader。我们可以在netease_models.json中为模型指定material_cpu和material字段，则骨骼模型将使用指定材质进行渲染。自定义材质都需要先在资源包resource_pack/materials/entity.material中进行定义。
+
+以雪女模型为例：
+
+```json
+"xuenv_1": {
+ "skeleton": "skeleton/xuenv_skeleton.json",
+ "mesh": "mesh/xuenv_mesh_frame.json",
+ "animation": {
+ "idle": "animation/xuenv_animation_idle.json",
+ "walk": "animation/xuenv_animation_idle.json",
+ "skill1": "animation/xuenv_animation_skill1.json",
+ "behited": "animation/gun_animation_idle.json",
+ "prepare": "animation/xuenv_animation_prepare.json",
+ "win": "animation/xuenv_animation_win.json"
+ },
+ // 定义自己的自定义材质
+ "material": "xuenv_custom",
+ // 自定义CPU蒙皮材质，可不进行配置，根据开发者的需要也可配置
+ "material_cpu": "xuenv_custom_cpu",
+ // 这个自定义材质所需要的自定义贴图，最多可配置4张
+ "texture": {
+ //"tex0": "my_custom_texture0",
+ "tex1": "my_custom_texture1",
+ "tex2": "my_custom_texture2",
+ "tex3": "my_custom_texture3",
+ },
+ "frame_anim": {
+ "row": 6,
+ "col": 5,
+ "frames": 30,
+ "time": 5
+ }
+}
+```
+
+`material`：为GPU骨骼渲染的形式下所使用的材质，会全局存储所有骨骼的变换矩阵列表，顶点着色器中每个顶点只存储对应的骨骼下标，在执行过程中用通过该下标从列表中查询得出变换矩阵，因为会有不同的顶点共用相同的骨骼，相比于后文的CPU骨骼蒙皮渲染形式，使用此方式能更为节省GPU带宽。材质的配置可参考官方骨骼模型材质(data/vanilla_netease/materials/entity.material/entity_for_skeleton)。**几乎所有情况下引擎都会使用该形式的材质**。
+
+`material_cpu`：为传统的CPU骨骼蒙皮渲染形式，顶点着色器中每个顶点存储自己的变换矩阵。**目前引擎只会在部分安卓设备且该设备不支持使用大顶点Uniform变量（large vertex shader uniforms）时才会使用的CPU骨骼蒙皮渲染，其它情况下则使用GPU骨骼渲染的渲染形式**。**因此，开发者如无特别需要，可以不定义该材质，也可以直接指定为GPU骨骼渲染材质。**如开发者有需要，则材质的配置可参考官方骨骼模型材质(data/vanilla_netease/materials/entity.material/entity_for_skeleton_cpu），与GPU所使用的的材质不同的是，该材质没有定义`USE_SKINNING`以及`BoneId0`.
+
+两种材质的差别基本如图所示：
+
+
+
+在上面我们为模型配置了自己的材质及shader，接着如果我们的材质及shader需要有更多的自定义贴图，我们就可以增加如下`texture`字段：
+
+```json
+ // 这个自定义材质所需要的自定义贴图，最多可配置4张
+ "texture": {
+ //"tex0": "my_custom_texture0",
+ "tex1": "my_custom_texture1",
+ "tex2": "my_custom_texture2",
+ "tex3": "my_custom_texture3",
+ },
+```
+
+关于自定义贴图，我们一共可以配置且最多配置4张，字段名称分别为`tex0`,`tex1`,`tex2`,`tex3`。 字段的值为贴图的路径，即`textures/models/`路径下的贴图名称，不需要后缀名。
+
+其中`tex0`所配置的贴图会覆盖`mesh`文件中`material`字段所指定的贴图，即上文第3节-指定贴图中所配置的贴图。所以一般不需要额外配置`tex0`。如果`mesh`文件中`material`字段没有配置模型贴图，则可以使用`tex0`来配置。
+
+而`tex1`,`tex2`,`tex3`，则可供开发者按需求进行配置。
+
+在配置了以上贴图后，我们则可以在我们的自定义材质中指定了的fragment shader当中通过声明`LAYOUT_BINDING`使用这些贴图：
+
+```glsl
+LAYOUT_BINDING(0) uniform sampler2D TEXTURE_0; // TEXTURE_0对应tex0, 也对应mesh文件中material字段指定的贴图
+LAYOUT_BINDING(1) uniform sampler2D TEXTURE_1; // TEXTURE_1对应tex1,
+LAYOUT_BINDING(2) uniform sampler2D TEXTURE_2; // TEXTURE_2对应tex2,
+LAYOUT_BINDING(3) uniform sampler2D TEXTURE_3; // TEXTURE_3对应tex3,
+
+void main(){
+ vec4 base_color = texture( TEXTURE_0, uv );
+ vec4 base_color1 = texture( TEXTURE_1, uv );
+ vec4 base_color2 = texture( TEXTURE_2, uv );
+ vec4 base_color3 = texture( TEXTURE_3, uv );
+
+ // do what you want
+ //...
+}
+```
+
+
+
+## 8. 模型使用多个材质及贴图
+
+2.8版本后，可以对同一个骨骼模型的不同骨骼定义不同的材质及所使用的贴图，也可以使用骨骼模型渲染屏蔽接口
+
+Blending代表使用混合模式进行渲染，blendSrc代表使用SourceAlpha作为混合源因子, blendDst代表使用OneMinusSrcAlpha作为目标混合因子。
+
+关于混合因子说明可看[材质配置说明](../7-材质与着色器/3-材质配置说明.md#材质属性)中关于Blend 半透明对象颜色混合的说明。
+
+接下来，我们尝试修改gl_FragColor.a进行测试，修改为透明度0.5：
+
+
+
+修改完成后游戏中该骨骼模型即会出现半透明效果：
+
+
+
+注意：因为半透明材质无法通过深度检测优化性能，所以尽量不要过多使用，不然会造成一定渲染压力。
\ No newline at end of file
diff --git a/mcguide/16-美术/6-模型和动作/05-原版模型的使用.md b/mcguide/16-美术/6-模型和动作/05-原版模型的使用.md
new file mode 100644
index 0000000..26f7e15
--- /dev/null
+++ b/mcguide/16-美术/6-模型和动作/05-原版模型的使用.md
@@ -0,0 +1,66 @@
+---
+front:
+hard: 入门
+time: 10分钟
+---
+
+# 原版模型的使用
+
+## 导入前的准备
+
+原版模型使用Blockbench制作，制作完成后需要导出三个文件：
+
+1. 以.geo.json结尾的模型配置文件
+2. 以.animation.json结尾的动画配置文件（可选）
+3. 以.png结尾的模型贴图文件（可选）
+
+将这三个文件保存在同一个文件夹中，并且尽量以相同的文件名命名这些文件。例如我们需要导入蜘蛛精的原版模型文件，就需要将它们命名为：
+
+
+
+## 将模型导入编辑器
+
+我们点击资源管理器目录上方的资源导入按钮，在下拉菜单中选中【原版生物模型】。
+
+
+
+选择刚才保存原版模型的文件夹，即会弹出下面这个窗口：
+
+
+
+1. 模型ID：为导入的模型取名，仅限 **小写** 英文字母和数字；
+2. 模型贴图：默认会选择当前文件夹下的.png文件作为贴图，可点击【选择图片】按钮更换为其他文件。如果当前模型不需要贴图，则可不填写；
+3. 模型动作（可选）：默认会选择当前文件夹下的.animation.json文件。如果当前模型不需要动作文件，则可不填写。
+> 注意：动作文件里的动作id请注意不能是中文和大写字符，否则无效。
+
+确认填写无误后，即可点击蓝色【确定】按钮导入模型。导入后，
+1. 我们可以在资源包路径下的models/entity路径下找到刚刚导入的zhizhujing.geo.json文件。
+2. 其动作文件被放置在资源包路径下的animations文件夹，
+3. 贴图文件被放置在资源包路径下的textures/entity文件夹,
+4. 同时会在animation_controllers下生成一个动画控制器供在编辑器播放使用。**如果不熟悉mod制作请勿随意修改**，如果不小心修改了导致动画播放不了，**请重新导入**。
+
+> 【注意】
+> 1. 导入的动作名称不能包含大写字母，否则编辑器会将其自动改为小写字母再导入。
+> 2. 引擎有时会因为缓存资源的问题，导致模型无法正常显示，可点击挂接面板下的刷新按钮，手动刷新下。
+
+
+
+## 在特效编辑器中预览模型
+
+我们切换到特效编辑器，将左侧模型挂接面板的主角模型通过下拉菜单替换成我们刚刚导入的蜘蛛精模型，即可看到模型已导入成功。
+
+
+
+在特效编辑器中，我们可以看到模型的动作、特效挂点，并通过时间轴控制模型动作的播放。想要原版模型上挂接微软粒子，可参见对应的指南文档。
+
+
+
+> 【注意】 当前并不支持在特效编辑器中修改模型的挂点数量、位置等，需要在模型制作的时候在blockbench中为其添加好挂点，调整好挂点位置，再导入到编辑器中使用。
+
+## 将原版模型应用到实体预设
+
+现在，编辑器支持了将原版模型直接应用到实体预设上。
+
+我们在预设编辑器中打开需要修改的实体模型，然后在右侧的属性面板中找到【资源包组件】，把其中的【模型】和【纹理】都替换成先前导入的原版模型，然后点击上方的【刷新所有属性】按钮，即可看到当前实体预设的模型和纹理都被替换成了之前导入的蜘蛛精模型。
+
+
\ No newline at end of file
diff --git a/mcguide/16-美术/6-模型和动作/10-模型输出规范.md b/mcguide/16-美术/6-模型和动作/10-模型输出规范.md
new file mode 100644
index 0000000..b6c3058
--- /dev/null
+++ b/mcguide/16-美术/6-模型和动作/10-模型输出规范.md
@@ -0,0 +1,87 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/model_face_config.25817915.png
+hard: 入门
+time: 15分钟
+---
+
+# 我的世界模型导出规范
+
+推荐软件： 3dMax 2014
+
+
+## 系统单位设置
+
+
+
+
+## 模型朝向
+
+
+
+
+## 贴图
+
+只支持一张贴图，且贴图的名称必须为英文
+
+
+## 顶点
+
+每个长方体通常是 8 个，整个模型控制在 300 个顶点，特殊复杂模型可以在 1000 以内
+
+
+## 输出检查
+
+1. 属性中将模型设置为背面消隐，查看模型是否有反面，如果有的话需要反相（flip）。
+
+ 
+ 
+
+2. Reset Xform（多点击几次，然后塌陷）
+
+ 
+
+3. Mesh Select（与 4 一起，点击完后，不用操作，直接塌陷）
+
+4. STL Check，最终转化为 Poly 模型输出，此步骤可避免模型在游戏中显示出错
+ 
+
+
+## 蒙皮
+
+1. 骨骼架设使用纯bone
+2. 骨骼控制在20根以内，最多不能超过50
+3. 需要添加 root，up，down 3根骨骼
+ - root，是质心的父级，位移旋转都要归于坐标原点（0.0）
+ - up，控制上半身，质心的子级，身体的父级
+ - down，控制下半身，质心的子级，双脚的父级
+4. 所有的骨骼都要有链接，（武器挂件坐骑等都要链接给相应的手，质心等位子，可使用link）
+5. 蒙皮选项当中的高级参数中，有个骨骼影响限制,需要调为 1，如图所示
+
+ 
+
+
+## 动作输出
+
+1. 输出文件版本为 MAX2014
+2. 输出文件命名为英文，文件需要输出FBX。
+3. 输出文件需要塌陷骨骼动画
+4. root，up，down骨骼不可以有动画
+5. 缩放动画必须用等比缩放，且不能有单轴向缩放
+
+
+## FBX输出设置
+
+输出设置如下图所示：
+
+
+
+
+
+
+
+
+## 注意事项
+
+1. 模型制作中，避免使用镜像或者对称！
+2. 如果模型出现法线问题，将法线出错的位置选择并反相（flip）即可。
+3. 模型当中不能有任何的中文!
diff --git a/mcguide/16-美术/6-模型和动作/11-原版模型转换工具.md b/mcguide/16-美术/6-模型和动作/11-原版模型转换工具.md
new file mode 100644
index 0000000..311d60c
--- /dev/null
+++ b/mcguide/16-美术/6-模型和动作/11-原版模型转换工具.md
@@ -0,0 +1,54 @@
+---
+front:
+time: 15分钟
+---
+
+# 原版模型转换工具使用说明
+## 工具介绍
+经过前面几篇文档的学习，开发者们都了解了原版模型和骨骼模型的区别和制作、使用技巧，原版模型容易上手，制作的模型风格更符合MC的风格，骨骼模型较为复杂，但能通过SDK接口实现更精美的动作表现。
+
+为了降低开发者使用两种模型格式的门槛，提高开发者的开发效率，我的世界开发工作台提供了原版模型转换工具，开发者可通过此工具**将原版模型转换为骨骼模型**，接下来就详细介绍下该工具的使用方法：
+1. 登录我的世界开发工作台，依次点击创作→工具箱→原版模型转换工具：
+
+
+
+1. 点击**导入原版模型**按钮，在弹出的对话框选择原版模型所在的文件夹。
+
+
+
+2. 点击确定后，工具便会自动开始转换，并将转换结果展示到下方的列表中，对于转换成功后的模型，可点击右侧的**输出目录**按钮打开存放转换后的骨骼模型的文件夹。
+
+
+
+3. 对于转换失败的模型，你可以点击**查看日志**按钮，查看具体报错日志，调整完模型后，点击**重新导入**按钮重试。
+
+
+
+5. 同样，你也可以点击**删除**按钮删除本条转换记录，注意，此操作不会删除源文件和输出文件夹。
+
+
+
+## 骨骼模型使用
+1. 转换后的骨骼模型会按照下列结构存放：
+
+
+
+2. 可以在编辑器中进行导入，如下图点击骨骼模型（json）：
+
+
+
+3. 选择输出目录中的`netease_models.json`文件，即可导入转换后的骨骼模型，并在特效编辑器中查看模型。
+
+
+
+> 有关骨骼模型使用的更多说明可以参考[这篇文档](./04-骨骼模型的使用.md)
+
+## 注意事项
+1. 同一个原版模型的所有json文件需要放在同一个文件夹下，导入时选择该文件夹。
+2. 模型文件（.geo.json）、动作文件（.animation.json）以及贴图（.png）必须保证同时满足下列条件：
+ 1. 名称保持一致
+ 2. 名称不含中文
+ 3. 名称不含特殊符号
+3. 暂不支持一个模型（.geo.json）对应多个动作文件（.animation.json）和多个贴图的情况。
+
+5. 导出后的模型也需要满足从[模型输出规范](./10-模型输出规范.md)，否则可能会产生异常，例如骨骼数不能超过50。
diff --git a/mcguide/16-美术/6-模型和动作/images/bb1.png b/mcguide/16-美术/6-模型和动作/images/bb1.png
new file mode 100644
index 0000000..85b3771
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb2.png b/mcguide/16-美术/6-模型和动作/images/bb2.png
new file mode 100644
index 0000000..8d8adb9
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb2fbx1.png b/mcguide/16-美术/6-模型和动作/images/bb2fbx1.png
new file mode 100644
index 0000000..1fe7381
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb2fbx1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb2fbx2.png b/mcguide/16-美术/6-模型和动作/images/bb2fbx2.png
new file mode 100644
index 0000000..edbcdd3
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb2fbx2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb2fbx3.png b/mcguide/16-美术/6-模型和动作/images/bb2fbx3.png
new file mode 100644
index 0000000..adb9909
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb2fbx3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb2fbx4.png b/mcguide/16-美术/6-模型和动作/images/bb2fbx4.png
new file mode 100644
index 0000000..73c5777
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb2fbx4.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb2fbx5.png b/mcguide/16-美术/6-模型和动作/images/bb2fbx5.png
new file mode 100644
index 0000000..c0988b8
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb2fbx5.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb2fbx6.png b/mcguide/16-美术/6-模型和动作/images/bb2fbx6.png
new file mode 100644
index 0000000..fbdb51d
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb2fbx6.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb2fbx7.png b/mcguide/16-美术/6-模型和动作/images/bb2fbx7.png
new file mode 100644
index 0000000..88158b0
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb2fbx7.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb2fbx8.png b/mcguide/16-美术/6-模型和动作/images/bb2fbx8.png
new file mode 100644
index 0000000..deb193f
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb2fbx8.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb3.png b/mcguide/16-美术/6-模型和动作/images/bb3.png
new file mode 100644
index 0000000..984876e
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb5.png b/mcguide/16-美术/6-模型和动作/images/bb5.png
new file mode 100644
index 0000000..335a484
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb5.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb6.png b/mcguide/16-美术/6-模型和动作/images/bb6.png
new file mode 100644
index 0000000..69d4949
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb6.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/bb7.png b/mcguide/16-美术/6-模型和动作/images/bb7.png
new file mode 100644
index 0000000..1d20aad
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/bb7.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/check_notice_1.png b/mcguide/16-美术/6-模型和动作/images/check_notice_1.png
new file mode 100644
index 0000000..ceed196
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/check_notice_1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/check_notice_2.png b/mcguide/16-美术/6-模型和动作/images/check_notice_2.png
new file mode 100644
index 0000000..4264c7d
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/check_notice_2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/check_notice_3.png b/mcguide/16-美术/6-模型和动作/images/check_notice_3.png
new file mode 100644
index 0000000..fbb98c8
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/check_notice_3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/check_notice_4.png b/mcguide/16-美术/6-模型和动作/images/check_notice_4.png
new file mode 100644
index 0000000..23f3f91
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/check_notice_4.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/fbx_output_1.png b/mcguide/16-美术/6-模型和动作/images/fbx_output_1.png
new file mode 100644
index 0000000..f7e749e
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/fbx_output_1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/fbx_output_2.png b/mcguide/16-美术/6-模型和动作/images/fbx_output_2.png
new file mode 100644
index 0000000..637cbb5
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/fbx_output_2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/fbx_output_3.png b/mcguide/16-美术/6-模型和动作/images/fbx_output_3.png
new file mode 100644
index 0000000..90cd052
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/fbx_output_3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/model_face_config.png b/mcguide/16-美术/6-模型和动作/images/model_face_config.png
new file mode 100644
index 0000000..77a1eb5
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/model_face_config.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/model_unit_config.png b/mcguide/16-美术/6-模型和动作/images/model_unit_config.png
new file mode 100644
index 0000000..84da068
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/model_unit_config.png differ
diff --git a/mcguide/16-美术/6-模型和动作/images/notice_cover.png b/mcguide/16-美术/6-模型和动作/images/notice_cover.png
new file mode 100644
index 0000000..4d52cb5
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/images/notice_cover.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/anim/reg4-1.png b/mcguide/16-美术/6-模型和动作/picture/anim/reg4-1.png
new file mode 100644
index 0000000..e4fe2fb
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/anim/reg4-1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/anim/reg4-2.png b/mcguide/16-美术/6-模型和动作/picture/anim/reg4-2.png
new file mode 100644
index 0000000..60b2b2a
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/anim/reg4-2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/anim/reg4-3.png b/mcguide/16-美术/6-模型和动作/picture/anim/reg4-3.png
new file mode 100644
index 0000000..11e9ff3
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/anim/reg4-3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/anim/reg4-4.png b/mcguide/16-美术/6-模型和动作/picture/anim/reg4-4.png
new file mode 100644
index 0000000..eceefc1
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/anim/reg4-4.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/add_group.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/add_group.png
new file mode 100644
index 0000000..bc30f21
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/add_group.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/blockbench.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/blockbench.png
new file mode 100644
index 0000000..5eb65c8
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/blockbench.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/create_animate.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/create_animate.png
new file mode 100644
index 0000000..5b6f445
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/create_animate.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/edit.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/edit.png
new file mode 100644
index 0000000..a216733
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/edit.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/edit_animate.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/edit_animate.png
new file mode 100644
index 0000000..a1c98ce
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/edit_animate.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/edit_animate1.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/edit_animate1.png
new file mode 100644
index 0000000..71145d7
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/edit_animate1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/export_animate.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/export_animate.png
new file mode 100644
index 0000000..53fb423
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/export_animate.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/export_model.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/export_model.png
new file mode 100644
index 0000000..c487b06
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/export_model.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/import_texture.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/import_texture.png
new file mode 100644
index 0000000..a25516a
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/import_texture.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/new_model.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/new_model.png
new file mode 100644
index 0000000..34c6c13
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/new_model.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/setting.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/setting.png
new file mode 100644
index 0000000..9b6702b
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/setting.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/bbmodel/uv_texture.png b/mcguide/16-美术/6-模型和动作/picture/bbmodel/uv_texture.png
new file mode 100644
index 0000000..afac9b0
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/bbmodel/uv_texture.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_chaoxiang.png b/mcguide/16-美术/6-模型和动作/picture/blender_chaoxiang.png
new file mode 100644
index 0000000..2c1e271
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_chaoxiang.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_faxiang.png b/mcguide/16-美术/6-模型和动作/picture/blender_faxiang.png
new file mode 100644
index 0000000..ab4b9ff
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_faxiang.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step1.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step1.png
new file mode 100644
index 0000000..1a8599c
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step10.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step10.png
new file mode 100644
index 0000000..02cd513
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step10.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step11.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step11.png
new file mode 100644
index 0000000..301cb92
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step11.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step12.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step12.png
new file mode 100644
index 0000000..c3afcb5
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step12.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step13.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step13.png
new file mode 100644
index 0000000..34ee60b
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step13.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step2.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step2.png
new file mode 100644
index 0000000..030aef3
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step3.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step3.png
new file mode 100644
index 0000000..b2f0082
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step4.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step4.png
new file mode 100644
index 0000000..3b3c2d6
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step4.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step5.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step5.png
new file mode 100644
index 0000000..ab3c880
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step5.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step6.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step6.png
new file mode 100644
index 0000000..f88c18e
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step6.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step7.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step7.png
new file mode 100644
index 0000000..2f69692
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step7.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step8.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step8.png
new file mode 100644
index 0000000..e857f0b
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step8.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_make_step9.png b/mcguide/16-美术/6-模型和动作/picture/blender_make_step9.png
new file mode 100644
index 0000000..8be748d
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_make_step9.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_mengpi1.png b/mcguide/16-美术/6-模型和动作/picture/blender_mengpi1.png
new file mode 100644
index 0000000..e6b2187
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_mengpi1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_mengpi2.png b/mcguide/16-美术/6-模型和动作/picture/blender_mengpi2.png
new file mode 100644
index 0000000..a52c2bf
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_mengpi2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_mengpi3.png b/mcguide/16-美术/6-模型和动作/picture/blender_mengpi3.png
new file mode 100644
index 0000000..6c78ce5
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_mengpi3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/blender_notice2.png b/mcguide/16-美术/6-模型和动作/picture/blender_notice2.png
new file mode 100644
index 0000000..75229c8
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/blender_notice2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv.png b/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv.png
new file mode 100644
index 0000000..71fc8c3
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv_frames.gif b/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv_frames.gif
new file mode 100644
index 0000000..a38e1d5
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv_frames.gif differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv_frames.png b/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv_frames.png
new file mode 100644
index 0000000..8838745
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv_frames.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv_json.png b/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv_json.png
new file mode 100644
index 0000000..36da572
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/frame_anim/xuenv_json.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg1-1-1.png b/mcguide/16-美术/6-模型和动作/picture/model/reg1-1-1.png
new file mode 100644
index 0000000..ecb9b77
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg1-1-1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg1-2-1.png b/mcguide/16-美术/6-模型和动作/picture/model/reg1-2-1.png
new file mode 100644
index 0000000..2b9f279
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg1-2-1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-1.png b/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-1.png
new file mode 100644
index 0000000..893ceca
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-2.png b/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-2.png
new file mode 100644
index 0000000..9b4ed52
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-3.png b/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-3.png
new file mode 100644
index 0000000..5a08458
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-4.png b/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-4.png
new file mode 100644
index 0000000..77cd909
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg1-4-4.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-1.png b/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-1.png
new file mode 100644
index 0000000..ab62c11
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-3-1.png b/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-3-1.png
new file mode 100644
index 0000000..8482455
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-3-1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-3-2.png b/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-3-2.png
new file mode 100644
index 0000000..f948cfb
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-3-2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-3-3.png b/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-3-3.png
new file mode 100644
index 0000000..cb9437b
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg1-5-3-3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-1.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-1.png
new file mode 100644
index 0000000..c123443
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-2.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-2.png
new file mode 100644
index 0000000..27fb2d5
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-3.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-3.png
new file mode 100644
index 0000000..3caa623
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-4.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-4.png
new file mode 100644
index 0000000..1b7f3b7
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-4.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-5.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-5.png
new file mode 100644
index 0000000..964ee4a
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-5.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-6.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-6.png
new file mode 100644
index 0000000..4420e39
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-6.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-7.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-7.png
new file mode 100644
index 0000000..1b49af6
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-1-7.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-2-1.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-2-1.png
new file mode 100644
index 0000000..46a4df1
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-2-1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-2-2.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-2-2.png
new file mode 100644
index 0000000..099ea8b
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-2-2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-2-3.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-2-3.png
new file mode 100644
index 0000000..a370abc
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-2-3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-1.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-1.png
new file mode 100644
index 0000000..c5b8e8b
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-2.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-2.png
new file mode 100644
index 0000000..06ff785
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-3.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-3.png
new file mode 100644
index 0000000..aee4766
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-4.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-4.png
new file mode 100644
index 0000000..d101aa8
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-4.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-5.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-5.png
new file mode 100644
index 0000000..f04e32f
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-5.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-6.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-6.png
new file mode 100644
index 0000000..8dfc57f
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-3-6.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-1.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-1.png
new file mode 100644
index 0000000..5d0f588
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-2.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-2.png
new file mode 100644
index 0000000..745632c
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-2.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-3.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-3.png
new file mode 100644
index 0000000..5715b27
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-3.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-4.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-4.png
new file mode 100644
index 0000000..6a934a3
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-4.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-5.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-5.png
new file mode 100644
index 0000000..de5538c
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-4-5.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/reg2-5-1.png b/mcguide/16-美术/6-模型和动作/picture/model/reg2-5-1.png
new file mode 100644
index 0000000..631e7f2
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/reg2-5-1.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend.png b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend.png
new file mode 100644
index 0000000..ad0bfcb
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend_def.png b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend_def.png
new file mode 100644
index 0000000..b7b883a
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend_def.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend_factor.png b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend_factor.png
new file mode 100644
index 0000000..d5cee23
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend_factor.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend_frag.png b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend_frag.png
new file mode 100644
index 0000000..06bba55
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_blend_frag.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/xuenv_material.png b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_material.png
new file mode 100644
index 0000000..95094d6
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_material.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/model/xuenv_model.png b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_model.png
new file mode 100644
index 0000000..872e033
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/model/xuenv_model.png differ
diff --git a/mcguide/16-美术/6-模型和动作/picture/unit_set.png b/mcguide/16-美术/6-模型和动作/picture/unit_set.png
new file mode 100644
index 0000000..49d40ac
Binary files /dev/null and b/mcguide/16-美术/6-模型和动作/picture/unit_set.png differ
diff --git a/mcguide/16-美术/7-材质与着色器/1-材质介绍与着色器入门.md b/mcguide/16-美术/7-材质与着色器/1-材质介绍与着色器入门.md
new file mode 100644
index 0000000..ce6e88e
--- /dev/null
+++ b/mcguide/16-美术/7-材质与着色器/1-材质介绍与着色器入门.md
@@ -0,0 +1,146 @@
+---
+front: https://nie.res.netease.com/r/pic/20220408/3541655a-7205-4609-b118-be8d6dbb84bd.png
+hard: 入门
+time: 15分钟
+selection: 38
+---
+
+# 材质与着色器介绍
+
+## 前言
+
+本文将介绍游戏材质和着色器的基本概念，以及MC游戏中使用的着色器的基本编写与使用方式
+
+
+## 材质和着色器
+
+``材质``(material)定义了游戏物体的画面表现，用来描述一个游戏内的物体应该如何被渲染，其中的信息包括物体使用的纹理、**着色器**、采样方式、是否进行透明混合以及面片的剔除模式等。
+``着色器``(shader)是一种依附于材质的渲染程序，用于具体实现材质在渲染时的某些逻辑，一般包括动画、着色、发光以及半透明等效果。
+例如，一个砖块的材质一般需要定义一个不透明材质，规定这个材质仅使用一张纹理(一般是砖块贴图)，并指定一个着色器用来渲染这个砖块。砖块着色器会根据砖块的模型数据，结合砖块贴图、砖块位置以及场景光照等信息，计算出砖块在屏幕上对应像素的颜色。
+
+
+
+
+
+
+
+
+## 在MC中定义材质
+
+MC使用json来定义材质信息，这些信息包括使用哪些shader、启用哪些宏定义、启用哪些片元测试等。不同类型的材质会分开存放在不同的材质文件中，例如地形相关的材质会放在terrain.material文件中，实体、骨骼模型相关的材质会放在entity.material文件中，具体的对应关系可以参考[内置材质清单](./2-内置材质清单.md)，具体的材质配置格式可以参考[材质配置说明](./3-材质配置说明.md)或者参照具体的.material文件。
+
+## OpenGL与GLSL
+
+目前MC的渲染(非渲染龙)是基于OpenGL实现的，不同平台的不同设备支持的OpenGL版本各有不同，越高级的OpenGL版本能使用的特性就越多，但因此兼容的设备就越少，开发者应考虑shader所使用的特性是否能够兼容目标设备。
+
+MC中的shader使用glsl进行编写，这是一种较为简单的类C语言，对于C或者C族系语言有所熟悉的开发者可以很快掌握。具体的glsl语法可以在参考[图形管线与GLSL简单入门](./6-图形管线与GLSL简单入门.md)。
+
+## MC材质SDK接口
+
+我的世界中国版允许使用python接口对材质产生运行时影响，涉及模块包括`后处理`、`网易骨骼模型`以及`原版模型`等，具体的使用方式我们将在后面的文档中进行举例介绍，更详细的说明可以在API文档页面中进行查询。后续我们会开发并开放更多有关材质的SDK接口给开发者使用。
+
+## 材质中的宏
+
+开发者可以自定义shader宏，可以通过在材质定义的`defines`字段中进行添加：
+```json
+"terrain_blend_far:terrain_blend": {
+ "+defines": [ "FOG" ]
+}
+```
+这里为`terrain_blend_far`材质增加了宏定义`FOG`，类似于C语言，我们可以在shader中使用`ifdef`或者`ifndef`针对`FOG`进行宏判断并做一些特殊逻辑处理：
+```opengl
+#ifndef FOG
+ color.rgb += FOG_COLOR.rgb * 0.000001;
+#endif
+```
+
+## 头文件
+
+MC中的shader允许使用头文件，只要将头文件拓展名改为`.h`并放在`shaders/glsl`目录下，shader代码就可以引用这个头文件:
+```opengl
+#include "uniformWorldConstants.h"
+```
+
+
+
+## Uniform
+
+在shader中除了使用顶点属性以外，引擎还会通过uniform变量向shader中传递很多有用的数据，大部份shader都依赖一些uniform变量进行计算。同时，开发者可以利用
+
+
+
+
+
+//rep
+
+加载mod时，对应mod资源会被拷贝到如下目录中
+
+```%AppData%\MinecraftPE_Netease\games\com.netease\resource_packs```
+
+要动态修改粒子效果，需要修改该目录下的同名mod中的对应粒子特效配置文件，再使用`//rep`指令。
+
+下图为fire.json所在的文件夹
+
+
+
+fire.json原先的配置及表现效果如下所示：
+
+
+
+
+
+修改fire.json中参数如下图后，在游戏中输入`//rep`指令，可以看到该粒子效果发生了改变：
+
+
+
+
+
+
+
+## 4. 致开发者
+
+粒子效果非常灵活，熟练各个参数，可以做出非常出彩的效果
+
+同时，各位开发者也一定不要忘记遵守粒子效果规范，毕竟游戏的性能是有限的
+
+
+
diff --git a/mcguide/16-美术/9-特效/90-中国版序列帧配置文件解析.md b/mcguide/16-美术/9-特效/90-中国版序列帧配置文件解析.md
new file mode 100644
index 0000000..75499be
--- /dev/null
+++ b/mcguide/16-美术/9-特效/90-中国版序列帧配置文件解析.md
@@ -0,0 +1,100 @@
+---
+front: https://nie.res.netease.com/r/pic/20230130/768c242f-92fb-4898-91ea-619fdc31ddfc.png
+hard: 入门
+time: 10分钟
+---
+
+# 中国版序列帧配置文件解析
+
+## 1. 序列帧简介
+
+《我的世界》中提供了序列帧类型的特效，序列帧本质上即为一个单面片的贴图，如果未设置始终面向摄像头，当观察角度位于序列帧的侧面时可以看出为一片面片
+
+
+
+
+
+## 2. 序列帧json参数说明
+
+序列帧动画主要包含一个json文件与一个贴图，这两者由Texture Packer生成
+
+其中json文件内容如下：
+
+
+
+其中包含frames和meta两个字段：
+
+- **"frames"** 表示每帧动画的贴图信息
+- **"meta"** 字段包含合图软件相关的信息
+
+开发者对此文件基本可以不用关注，其中在frames字段中可以自己手动加入字段 **”scale”** ，表示对该帧进行缩放，没写默认为1倍缩放，即为：
+
+
+
+另外该缩放功能支持插值，即在不同帧之间大小倍数不同时会进行平滑过渡，如果需要关掉插值则需要关掉插值开关（下文提到的[**"lerp_scale"**](#lerpScale)字段）
+
+如果使用编辑器生成序列帧动画，则会在此基础上多一个编辑器对应的json，如下图所示：
+
+
+
+其中cylinder开头的配置为环状序列帧的功能：
+
+- **"cylinder_enable"** 表示是否为环状序列帧
+
+- **"cylinder_frac_num"** 表示近似多边形的个数，即环状体由几个多边形组成
+
+- **"cylinder_height"** 表示环状序列帧高度
+
+- **"cylinder_radius_down"** 和 **"cylinder_radius_up"** 表示底部和顶部的环状半径
+- **"face_camera"** 表示帧动画是否始终面向摄像机
+- **"fps"** 表示帧动画的播放帧率，即一秒播放多少帧动画
+- **"shuffle"** 表示是否开启随机播放帧动画
+- **"layer"** 表示设置渲染层级，默认设置为1，设置范围为0-15,，层级为1表示不开启渲染层级的功能，开启后，渲染层级高的会遮挡层级低的，并且同一层级的特效会根据位置存在遮挡关系
+- **"lerp_scale"** 表示是否开启帧之间的插值
+- **"loop"** 表示帧动画是否循环
+- **"rot_speed"** 表示帧动画的旋转速度
+- **"scale"** 表示帧动画的整体缩放
+- **"tex_repeat_num"** 表示在x轴和y轴两个方向上重复的特效个数
+- **"texture"** 为上述由texture packer生成的具体json特效路径
+
+
+
+## 3. 序列帧贴图生成指南
+
+序列帧贴图资源需要使用Texture Packer生成，打包格式见下文[Texture Packer使用配置](#TexturePacker)
+
+Texture Packer导出大图和json文件，放置在`textures/picture/sfxs`下
+
+如下图所示，序列帧贴图与普通贴图唯一的不同就是多了一个同文件名的json文件，该贴图和json文件都是由Texture Packer导出
+
+
+
+
+
+## 4. Texture Packer使用配置
+
+
+
+Texture Packer主要用来打包序列帧文件，需要注意的配置如下：
+
+
+
+- Allow rotation不要勾选
+
+- Trim mode选择为None
+
+这样导出的大图中每一幅小图都一样大，**当前我们的序列帧绘制只支持大小相同的子图**
+
+
+
+## 5. 序列帧贴图规范
+
+- 贴图格式为 png
+
+- 单张贴图大小不超过512 * 512
+
+- 总像素数不要超过512 * 512 * 5
\ No newline at end of file
diff --git a/mcguide/16-美术/9-特效/images/FrameDynamicColorEffect.gif b/mcguide/16-美术/9-特效/images/FrameDynamicColorEffect.gif
new file mode 100644
index 0000000..3eb38dd
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/FrameDynamicColorEffect.gif differ
diff --git a/mcguide/16-美术/9-特效/images/ParticleDepthCheckEnableEffect.gif b/mcguide/16-美术/9-特效/images/ParticleDepthCheckEnableEffect.gif
new file mode 100644
index 0000000..5836dc8
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/ParticleDepthCheckEnableEffect.gif differ
diff --git a/mcguide/16-美术/9-特效/images/ParticleDepthCheckUnEnableEffect.gif b/mcguide/16-美术/9-特效/images/ParticleDepthCheckUnEnableEffect.gif
new file mode 100644
index 0000000..3b6645d
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/ParticleDepthCheckUnEnableEffect.gif differ
diff --git a/mcguide/16-美术/9-特效/images/V29boneitem.gif b/mcguide/16-美术/9-特效/images/V29boneitem.gif
new file mode 100644
index 0000000..691ef28
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/V29boneitem.gif differ
diff --git a/mcguide/16-美术/9-特效/images/V29editmodel.png b/mcguide/16-美术/9-特效/images/V29editmodel.png
new file mode 100644
index 0000000..a90ffc3
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/V29editmodel.png differ
diff --git a/mcguide/16-美术/9-特效/images/V29finemodel.png b/mcguide/16-美术/9-特效/images/V29finemodel.png
new file mode 100644
index 0000000..685a24d
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/V29finemodel.png differ
diff --git a/mcguide/16-美术/9-特效/images/bb2fbx6.png b/mcguide/16-美术/9-特效/images/bb2fbx6.png
new file mode 100644
index 0000000..fbdb51d
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/bb2fbx6.png differ
diff --git a/mcguide/16-美术/9-特效/images/bb2fbx7.png b/mcguide/16-美术/9-特效/images/bb2fbx7.png
new file mode 100644
index 0000000..88158b0
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/bb2fbx7.png differ
diff --git a/mcguide/16-美术/9-特效/images/bb2fbx8.png b/mcguide/16-美术/9-特效/images/bb2fbx8.png
new file mode 100644
index 0000000..deb193f
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/bb2fbx8.png differ
diff --git a/mcguide/16-美术/9-特效/images/create_binding07.gif b/mcguide/16-美术/9-特效/images/create_binding07.gif
new file mode 100644
index 0000000..74e3fd7
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/create_binding07.gif differ
diff --git a/mcguide/16-美术/9-特效/images/deleteani.gif b/mcguide/16-美术/9-特效/images/deleteani.gif
new file mode 100644
index 0000000..7190d68
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/deleteani.gif differ
diff --git a/mcguide/16-美术/9-特效/images/demo_preview_effect.png b/mcguide/16-美术/9-特效/images/demo_preview_effect.png
new file mode 100644
index 0000000..e155fb5
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/demo_preview_effect.png differ
diff --git a/mcguide/16-美术/9-特效/images/demo_preview_model.gif b/mcguide/16-美术/9-特效/images/demo_preview_model.gif
new file mode 100644
index 0000000..302a449
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/demo_preview_model.gif differ
diff --git a/mcguide/16-美术/9-特效/images/editscreensize.png b/mcguide/16-美术/9-特效/images/editscreensize.png
new file mode 100644
index 0000000..da6f587
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/editscreensize.png differ
diff --git a/mcguide/16-美术/9-特效/images/edittrailpoint.gif b/mcguide/16-美术/9-特效/images/edittrailpoint.gif
new file mode 100644
index 0000000..559828b
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/edittrailpoint.gif differ
diff --git a/mcguide/16-美术/9-特效/images/emitterpath.png b/mcguide/16-美术/9-特效/images/emitterpath.png
new file mode 100644
index 0000000..225b2aa
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/emitterpath.png differ
diff --git a/mcguide/16-美术/9-特效/images/kjpy.gif b/mcguide/16-美术/9-特效/images/kjpy.gif
new file mode 100644
index 0000000..21c97f2
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/kjpy.gif differ
diff --git a/mcguide/16-美术/9-特效/images/material.png b/mcguide/16-美术/9-特效/images/material.png
new file mode 100644
index 0000000..891351c
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/material.png differ
diff --git a/mcguide/16-美术/9-特效/images/ms2.png b/mcguide/16-美术/9-特效/images/ms2.png
new file mode 100644
index 0000000..c34d501
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/ms2.png differ
diff --git a/mcguide/16-美术/9-特效/images/ms3.png b/mcguide/16-美术/9-特效/images/ms3.png
new file mode 100644
index 0000000..7336eb0
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/ms3.png differ
diff --git a/mcguide/16-美术/9-特效/images/multipass1.png b/mcguide/16-美术/9-特效/images/multipass1.png
new file mode 100644
index 0000000..8b3e8cc
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/multipass1.png differ
diff --git a/mcguide/16-美术/9-特效/images/particle_DynamicColorEffectPanel.png b/mcguide/16-美术/9-特效/images/particle_DynamicColorEffectPanel.png
new file mode 100644
index 0000000..52dd7ba
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/particle_DynamicColorEffectPanel.png differ
diff --git a/mcguide/16-美术/9-特效/images/preview_fp_model.gif b/mcguide/16-美术/9-特效/images/preview_fp_model.gif
new file mode 100644
index 0000000..319a49c
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/preview_fp_model.gif differ
diff --git a/mcguide/16-美术/9-特效/images/preview_other_effect.png b/mcguide/16-美术/9-特效/images/preview_other_effect.png
new file mode 100644
index 0000000..99539a2
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/preview_other_effect.png differ
diff --git a/mcguide/16-美术/9-特效/images/preview_other_model.png b/mcguide/16-美术/9-特效/images/preview_other_model.png
new file mode 100644
index 0000000..d4790fc
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/preview_other_model.png differ
diff --git a/mcguide/16-美术/9-特效/images/preview_panel.png b/mcguide/16-美术/9-特效/images/preview_panel.png
new file mode 100644
index 0000000..f180be7
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/preview_panel.png differ
diff --git a/mcguide/16-美术/9-特效/images/refreshmaterial.gif b/mcguide/16-美术/9-特效/images/refreshmaterial.gif
new file mode 100644
index 0000000..2ce1a56
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/refreshmaterial.gif differ
diff --git a/mcguide/16-美术/9-特效/images/showkeyframe.png b/mcguide/16-美术/9-特效/images/showkeyframe.png
new file mode 100644
index 0000000..b4ceafb
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/showkeyframe.png differ
diff --git a/mcguide/16-美术/9-特效/images/spark_DynamicColorEffect.gif b/mcguide/16-美术/9-特效/images/spark_DynamicColorEffect.gif
new file mode 100644
index 0000000..0455c8b
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_DynamicColorEffect.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_DynamicColorEffectPanel.png b/mcguide/16-美术/9-特效/images/spark_DynamicColorEffectPanel.png
new file mode 100644
index 0000000..6054334
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_DynamicColorEffectPanel.png differ
diff --git a/mcguide/16-美术/9-特效/images/spark_DynamicSizeEffect.gif b/mcguide/16-美术/9-特效/images/spark_DynamicSizeEffect.gif
new file mode 100644
index 0000000..2f611ee
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_DynamicSizeEffect.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_DynamicSizeEffectPanel.png b/mcguide/16-美术/9-特效/images/spark_DynamicSizeEffectPanel.png
new file mode 100644
index 0000000..9e25871
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_DynamicSizeEffectPanel.png differ
diff --git a/mcguide/16-美术/9-特效/images/spark_EmitterSizeScaleEffect.gif b/mcguide/16-美术/9-特效/images/spark_EmitterSizeScaleEffect.gif
new file mode 100644
index 0000000..c9bc40b
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_EmitterSizeScaleEffect.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_FrameDepthCheckEffect.gif b/mcguide/16-美术/9-特效/images/spark_FrameDepthCheckEffect.gif
new file mode 100644
index 0000000..4400e4e
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_FrameDepthCheckEffect.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_FrameDepthCheckEnableEffect.gif b/mcguide/16-美术/9-特效/images/spark_FrameDepthCheckEnableEffect.gif
new file mode 100644
index 0000000..b73a2aa
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_FrameDepthCheckEnableEffect.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_FrameEffectNormal.gif b/mcguide/16-美术/9-特效/images/spark_FrameEffectNormal.gif
new file mode 100644
index 0000000..dcc2fb1
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_FrameEffectNormal.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_FrameEffectRing.gif b/mcguide/16-美术/9-特效/images/spark_FrameEffectRing.gif
new file mode 100644
index 0000000..8727317
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_FrameEffectRing.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_FramePerFrameEffect.gif b/mcguide/16-美术/9-特效/images/spark_FramePerFrameEffect.gif
new file mode 100644
index 0000000..1597c5f
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_FramePerFrameEffect.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_FramePerFramePanel.png b/mcguide/16-美术/9-特效/images/spark_FramePerFramePanel.png
new file mode 100644
index 0000000..8044229
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_FramePerFramePanel.png differ
diff --git a/mcguide/16-美术/9-特效/images/spark_ParticleDirection.gif b/mcguide/16-美术/9-特效/images/spark_ParticleDirection.gif
new file mode 100644
index 0000000..0ea0bd9
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_ParticleDirection.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_ParticleDisorder.gif b/mcguide/16-美术/9-特效/images/spark_ParticleDisorder.gif
new file mode 100644
index 0000000..969acbb
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_ParticleDisorder.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_ParticleInwards.gif b/mcguide/16-美术/9-特效/images/spark_ParticleInwards.gif
new file mode 100644
index 0000000..c9b083a
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_ParticleInwards.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_ParticleNumber.gif b/mcguide/16-美术/9-特效/images/spark_ParticleNumber.gif
new file mode 100644
index 0000000..1ef4cf5
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_ParticleNumber.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_ParticleOutwards.gif b/mcguide/16-美术/9-特效/images/spark_ParticleOutwards.gif
new file mode 100644
index 0000000..99dca6e
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_ParticleOutwards.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_ParticlePath.gif b/mcguide/16-美术/9-特效/images/spark_ParticlePath.gif
new file mode 100644
index 0000000..1315af1
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_ParticlePath.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_SizeScalePanel.png b/mcguide/16-美术/9-特效/images/spark_SizeScalePanel.png
new file mode 100644
index 0000000..fb71dc0
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_SizeScalePanel.png differ
diff --git a/mcguide/16-美术/9-特效/images/spark_TexRepeatNum1_1.gif b/mcguide/16-美术/9-特效/images/spark_TexRepeatNum1_1.gif
new file mode 100644
index 0000000..44dc906
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_TexRepeatNum1_1.gif differ
diff --git a/mcguide/16-美术/9-特效/images/spark_TexRepeatNum5_2.gif b/mcguide/16-美术/9-特效/images/spark_TexRepeatNum5_2.gif
new file mode 100644
index 0000000..bc54c6e
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/spark_TexRepeatNum5_2.gif differ
diff --git a/mcguide/16-美术/9-特效/images/stevepng.png b/mcguide/16-美术/9-特效/images/stevepng.png
new file mode 100644
index 0000000..81f29c3
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/stevepng.png differ
diff --git a/mcguide/16-美术/9-特效/images/trailedit.png b/mcguide/16-美术/9-特效/images/trailedit.png
new file mode 100644
index 0000000..7da6a5c
Binary files /dev/null and b/mcguide/16-美术/9-特效/images/trailedit.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A1.png b/mcguide/16-美术/9-特效/picture/A1.png
new file mode 100644
index 0000000..1aad5c6
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A1.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A10.png b/mcguide/16-美术/9-特效/picture/A10.png
new file mode 100644
index 0000000..6ea4711
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A10.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A11.png b/mcguide/16-美术/9-特效/picture/A11.png
new file mode 100644
index 0000000..a0dd2dc
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A11.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A12.png b/mcguide/16-美术/9-特效/picture/A12.png
new file mode 100644
index 0000000..10df911
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A12.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A13.png b/mcguide/16-美术/9-特效/picture/A13.png
new file mode 100644
index 0000000..1c02a4a
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A13.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A14.png b/mcguide/16-美术/9-特效/picture/A14.png
new file mode 100644
index 0000000..ede1330
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A14.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A15.png b/mcguide/16-美术/9-特效/picture/A15.png
new file mode 100644
index 0000000..1de2798
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A15.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A17.png b/mcguide/16-美术/9-特效/picture/A17.png
new file mode 100644
index 0000000..1b8ff2e
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A17.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A19.png b/mcguide/16-美术/9-特效/picture/A19.png
new file mode 100644
index 0000000..0462341
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A19.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A2.png b/mcguide/16-美术/9-特效/picture/A2.png
new file mode 100644
index 0000000..ed0d777
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A2.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A20.png b/mcguide/16-美术/9-特效/picture/A20.png
new file mode 100644
index 0000000..8696d85
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A20.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A21.png b/mcguide/16-美术/9-特效/picture/A21.png
new file mode 100644
index 0000000..84339e3
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A21.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A22.png b/mcguide/16-美术/9-特效/picture/A22.png
new file mode 100644
index 0000000..69e6b2e
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A22.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A23.png b/mcguide/16-美术/9-特效/picture/A23.png
new file mode 100644
index 0000000..1aa2db8
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A23.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A24.png b/mcguide/16-美术/9-特效/picture/A24.png
new file mode 100644
index 0000000..ba4c37d
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A24.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A25.png b/mcguide/16-美术/9-特效/picture/A25.png
new file mode 100644
index 0000000..6991caa
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A25.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A26.png b/mcguide/16-美术/9-特效/picture/A26.png
new file mode 100644
index 0000000..0223437
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A26.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A27.png b/mcguide/16-美术/9-特效/picture/A27.png
new file mode 100644
index 0000000..c001299
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A27.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A28.png b/mcguide/16-美术/9-特效/picture/A28.png
new file mode 100644
index 0000000..cf38eb4
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A28.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A29.png b/mcguide/16-美术/9-特效/picture/A29.png
new file mode 100644
index 0000000..8c0e3a4
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A29.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A3.png b/mcguide/16-美术/9-特效/picture/A3.png
new file mode 100644
index 0000000..2d22b00
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A3.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A32.png b/mcguide/16-美术/9-特效/picture/A32.png
new file mode 100644
index 0000000..ca088c3
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A32.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A33.png b/mcguide/16-美术/9-特效/picture/A33.png
new file mode 100644
index 0000000..cf918cc
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A33.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A35.png b/mcguide/16-美术/9-特效/picture/A35.png
new file mode 100644
index 0000000..96e7aa2
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A35.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A4.png b/mcguide/16-美术/9-特效/picture/A4.png
new file mode 100644
index 0000000..3919433
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A4.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A5.png b/mcguide/16-美术/9-特效/picture/A5.png
new file mode 100644
index 0000000..82190bc
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A5.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A6.png b/mcguide/16-美术/9-特效/picture/A6.png
new file mode 100644
index 0000000..180c02e
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A6.png differ
diff --git a/mcguide/16-美术/9-特效/picture/A7.png b/mcguide/16-美术/9-特效/picture/A7.png
new file mode 100644
index 0000000..8691f55
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/A7.png differ
diff --git a/mcguide/16-美术/9-特效/picture/B1.gif b/mcguide/16-美术/9-特效/picture/B1.gif
new file mode 100644
index 0000000..a644c1d
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B1.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B10.gif b/mcguide/16-美术/9-特效/picture/B10.gif
new file mode 100644
index 0000000..13351bc
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B10.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B11.gif b/mcguide/16-美术/9-特效/picture/B11.gif
new file mode 100644
index 0000000..ad0669f
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B11.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B12.gif b/mcguide/16-美术/9-特效/picture/B12.gif
new file mode 100644
index 0000000..a292518
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B12.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B13.gif b/mcguide/16-美术/9-特效/picture/B13.gif
new file mode 100644
index 0000000..462a29f
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B13.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B14.gif b/mcguide/16-美术/9-特效/picture/B14.gif
new file mode 100644
index 0000000..7824207
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B14.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B15.gif b/mcguide/16-美术/9-特效/picture/B15.gif
new file mode 100644
index 0000000..4454b90
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B15.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B2.gif b/mcguide/16-美术/9-特效/picture/B2.gif
new file mode 100644
index 0000000..a5d89f2
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B2.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B3.gif b/mcguide/16-美术/9-特效/picture/B3.gif
new file mode 100644
index 0000000..a2ae496
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B3.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B4.gif b/mcguide/16-美术/9-特效/picture/B4.gif
new file mode 100644
index 0000000..ff725f6
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B4.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B5.gif b/mcguide/16-美术/9-特效/picture/B5.gif
new file mode 100644
index 0000000..b022da3
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B5.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B6.gif b/mcguide/16-美术/9-特效/picture/B6.gif
new file mode 100644
index 0000000..cf23d5b
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B6.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B7.gif b/mcguide/16-美术/9-特效/picture/B7.gif
new file mode 100644
index 0000000..172802b
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B7.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B8.gif b/mcguide/16-美术/9-特效/picture/B8.gif
new file mode 100644
index 0000000..d4c8e8f
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B8.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/B9.gif b/mcguide/16-美术/9-特效/picture/B9.gif
new file mode 100644
index 0000000..7c8d701
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/B9.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/fbx_particle/fbx_particle_1.gif b/mcguide/16-美术/9-特效/picture/fbx_particle/fbx_particle_1.gif
new file mode 100644
index 0000000..e770bba
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/fbx_particle/fbx_particle_1.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/fbx_particle/fbx_particle_2.gif b/mcguide/16-美术/9-特效/picture/fbx_particle/fbx_particle_2.gif
new file mode 100644
index 0000000..e3f7b19
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/fbx_particle/fbx_particle_2.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/create_1.png b/mcguide/16-美术/9-特效/picture/mics_particle/create_1.png
new file mode 100644
index 0000000..0d928d6
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/create_1.png differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/create_2.png b/mcguide/16-美术/9-特效/picture/mics_particle/create_2.png
new file mode 100644
index 0000000..b902166
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/create_2.png differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/curve_1.gif b/mcguide/16-美术/9-特效/picture/mics_particle/curve_1.gif
new file mode 100644
index 0000000..ac952ae
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/curve_1.gif differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/curve_2.png b/mcguide/16-美术/9-特效/picture/mics_particle/curve_2.png
new file mode 100644
index 0000000..4d615c9
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/curve_2.png differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/curve_3.png b/mcguide/16-美术/9-特效/picture/mics_particle/curve_3.png
new file mode 100644
index 0000000..bb33ca8
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/curve_3.png differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/emitter_overview.png b/mcguide/16-美术/9-特效/picture/mics_particle/emitter_overview.png
new file mode 100644
index 0000000..eb4aa1e
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/emitter_overview.png differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/molang_input.png b/mcguide/16-美术/9-特效/picture/mics_particle/molang_input.png
new file mode 100644
index 0000000..d7d1449
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/molang_input.png differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/molang_variable.png b/mcguide/16-美术/9-特效/picture/mics_particle/molang_variable.png
new file mode 100644
index 0000000..f58014d
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/molang_variable.png differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/molang_variable_1.png b/mcguide/16-美术/9-特效/picture/mics_particle/molang_variable_1.png
new file mode 100644
index 0000000..91aa66a
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/molang_variable_1.png differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/molang_variable_2.png b/mcguide/16-美术/9-特效/picture/mics_particle/molang_variable_2.png
new file mode 100644
index 0000000..8dce231
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/molang_variable_2.png differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/particle_billboard.png b/mcguide/16-美术/9-特效/picture/mics_particle/particle_billboard.png
new file mode 100644
index 0000000..5306ef8
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/particle_billboard.png differ
diff --git a/mcguide/16-美术/9-特效/picture/mics_particle/property_overview.png b/mcguide/16-美术/9-特效/picture/mics_particle/property_overview.png
new file mode 100644
index 0000000..bda66fa
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/mics_particle/property_overview.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-1.png b/mcguide/16-美术/9-特效/picture/particle/reg1-1.png
new file mode 100644
index 0000000..e8ebf40
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-1.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-10.png b/mcguide/16-美术/9-特效/picture/particle/reg1-10.png
new file mode 100644
index 0000000..8dd3de8
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-10.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-11.png b/mcguide/16-美术/9-特效/picture/particle/reg1-11.png
new file mode 100644
index 0000000..052e175
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-11.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-12.png b/mcguide/16-美术/9-特效/picture/particle/reg1-12.png
new file mode 100644
index 0000000..d641d1c
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-12.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-13.png b/mcguide/16-美术/9-特效/picture/particle/reg1-13.png
new file mode 100644
index 0000000..7f3e04e
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-13.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-14.png b/mcguide/16-美术/9-特效/picture/particle/reg1-14.png
new file mode 100644
index 0000000..39809bd
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-14.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-15.png b/mcguide/16-美术/9-特效/picture/particle/reg1-15.png
new file mode 100644
index 0000000..687fddc
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-15.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-16.png b/mcguide/16-美术/9-特效/picture/particle/reg1-16.png
new file mode 100644
index 0000000..1d76e30
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-16.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-17.png b/mcguide/16-美术/9-特效/picture/particle/reg1-17.png
new file mode 100644
index 0000000..f00ef7c
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-17.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-18.png b/mcguide/16-美术/9-特效/picture/particle/reg1-18.png
new file mode 100644
index 0000000..2fa3286
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-18.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-19.png b/mcguide/16-美术/9-特效/picture/particle/reg1-19.png
new file mode 100644
index 0000000..3e6e84d
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-19.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-2.png b/mcguide/16-美术/9-特效/picture/particle/reg1-2.png
new file mode 100644
index 0000000..eec670e
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-2.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-20.png b/mcguide/16-美术/9-特效/picture/particle/reg1-20.png
new file mode 100644
index 0000000..bb44056
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-20.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-21.png b/mcguide/16-美术/9-特效/picture/particle/reg1-21.png
new file mode 100644
index 0000000..f47515c
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-21.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-22.png b/mcguide/16-美术/9-特效/picture/particle/reg1-22.png
new file mode 100644
index 0000000..55e4c93
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-22.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-23.png b/mcguide/16-美术/9-特效/picture/particle/reg1-23.png
new file mode 100644
index 0000000..fc63d97
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-23.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-24.png b/mcguide/16-美术/9-特效/picture/particle/reg1-24.png
new file mode 100644
index 0000000..579af3b
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-24.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-25.png b/mcguide/16-美术/9-特效/picture/particle/reg1-25.png
new file mode 100644
index 0000000..51a9ca6
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-25.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-26.png b/mcguide/16-美术/9-特效/picture/particle/reg1-26.png
new file mode 100644
index 0000000..46b7533
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-26.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-27-1.png b/mcguide/16-美术/9-特效/picture/particle/reg1-27-1.png
new file mode 100644
index 0000000..cf68466
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-27-1.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-27.png b/mcguide/16-美术/9-特效/picture/particle/reg1-27.png
new file mode 100644
index 0000000..6d26912
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-27.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-28.png b/mcguide/16-美术/9-特效/picture/particle/reg1-28.png
new file mode 100644
index 0000000..add938f
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-28.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-29.png b/mcguide/16-美术/9-特效/picture/particle/reg1-29.png
new file mode 100644
index 0000000..0f9a46f
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-29.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-3.png b/mcguide/16-美术/9-特效/picture/particle/reg1-3.png
new file mode 100644
index 0000000..8838f93
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-3.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-4.png b/mcguide/16-美术/9-特效/picture/particle/reg1-4.png
new file mode 100644
index 0000000..f1c4bd4
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-4.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-5.png b/mcguide/16-美术/9-特效/picture/particle/reg1-5.png
new file mode 100644
index 0000000..676dd69
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-5.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-6.png b/mcguide/16-美术/9-特效/picture/particle/reg1-6.png
new file mode 100644
index 0000000..edf7346
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-6.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-7.png b/mcguide/16-美术/9-特效/picture/particle/reg1-7.png
new file mode 100644
index 0000000..fbfae93
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-7.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-8.png b/mcguide/16-美术/9-特效/picture/particle/reg1-8.png
new file mode 100644
index 0000000..021f049
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-8.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg1-9.png b/mcguide/16-美术/9-特效/picture/particle/reg1-9.png
new file mode 100644
index 0000000..5b43632
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg1-9.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg3-1.png b/mcguide/16-美术/9-特效/picture/particle/reg3-1.png
new file mode 100644
index 0000000..926b123
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg3-1.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg3-2.png b/mcguide/16-美术/9-特效/picture/particle/reg3-2.png
new file mode 100644
index 0000000..4a62ce6
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg3-2.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg3-3.png b/mcguide/16-美术/9-特效/picture/particle/reg3-3.png
new file mode 100644
index 0000000..aa115ab
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg3-3.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg3-4.png b/mcguide/16-美术/9-特效/picture/particle/reg3-4.png
new file mode 100644
index 0000000..ba8522d
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg3-4.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg3-5.png b/mcguide/16-美术/9-特效/picture/particle/reg3-5.png
new file mode 100644
index 0000000..4c43d28
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg3-5.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg3-6.png b/mcguide/16-美术/9-特效/picture/particle/reg3-6.png
new file mode 100644
index 0000000..f30c77c
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg3-6.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg3-7.png b/mcguide/16-美术/9-特效/picture/particle/reg3-7.png
new file mode 100644
index 0000000..c158966
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg3-7.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg3-8.png b/mcguide/16-美术/9-特效/picture/particle/reg3-8.png
new file mode 100644
index 0000000..86419ed
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg3-8.png differ
diff --git a/mcguide/16-美术/9-特效/picture/particle/reg3-9.png b/mcguide/16-美术/9-特效/picture/particle/reg3-9.png
new file mode 100644
index 0000000..2331922
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/particle/reg3-9.png differ
diff --git a/mcguide/16-美术/9-特效/picture/sfx/reg1-1.png b/mcguide/16-美术/9-特效/picture/sfx/reg1-1.png
new file mode 100644
index 0000000..ba96461
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/sfx/reg1-1.png differ
diff --git a/mcguide/16-美术/9-特效/picture/sfx/reg1-2.png b/mcguide/16-美术/9-特效/picture/sfx/reg1-2.png
new file mode 100644
index 0000000..5bf7fcc
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/sfx/reg1-2.png differ
diff --git a/mcguide/16-美术/9-特效/picture/sfx/reg1-3.png b/mcguide/16-美术/9-特效/picture/sfx/reg1-3.png
new file mode 100644
index 0000000..978f259
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/sfx/reg1-3.png differ
diff --git a/mcguide/16-美术/9-特效/picture/sfx/reg2-1.png b/mcguide/16-美术/9-特效/picture/sfx/reg2-1.png
new file mode 100644
index 0000000..a53f200
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/sfx/reg2-1.png differ
diff --git a/mcguide/16-美术/9-特效/picture/sfx/reg2-2.png b/mcguide/16-美术/9-特效/picture/sfx/reg2-2.png
new file mode 100644
index 0000000..dee8959
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/sfx/reg2-2.png differ
diff --git a/mcguide/16-美术/9-特效/picture/sfx/reg2-3.png b/mcguide/16-美术/9-特效/picture/sfx/reg2-3.png
new file mode 100644
index 0000000..f46465a
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/sfx/reg2-3.png differ
diff --git a/mcguide/16-美术/9-特效/picture/sfx/reg3-1.png b/mcguide/16-美术/9-特效/picture/sfx/reg3-1.png
new file mode 100644
index 0000000..2faa696
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/sfx/reg3-1.png differ
diff --git a/mcguide/16-美术/9-特效/picture/sfx/reg4-1.png b/mcguide/16-美术/9-特效/picture/sfx/reg4-1.png
new file mode 100644
index 0000000..a2f770c
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/sfx/reg4-1.png differ
diff --git a/mcguide/16-美术/9-特效/picture/sfx/reg4-2.png b/mcguide/16-美术/9-特效/picture/sfx/reg4-2.png
new file mode 100644
index 0000000..9a98243
Binary files /dev/null and b/mcguide/16-美术/9-特效/picture/sfx/reg4-2.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/37.png b/mcguide/16-美术/picture/brief_intro/37.png
new file mode 100644
index 0000000..bd74819
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/37.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/38.png b/mcguide/16-美术/picture/brief_intro/38.png
new file mode 100644
index 0000000..c88f78e
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/38.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/39.png b/mcguide/16-美术/picture/brief_intro/39.png
new file mode 100644
index 0000000..9825334
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/39.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/40.png b/mcguide/16-美术/picture/brief_intro/40.png
new file mode 100644
index 0000000..5238c50
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/40.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/41.png b/mcguide/16-美术/picture/brief_intro/41.png
new file mode 100644
index 0000000..c9763ec
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/41.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/42.png b/mcguide/16-美术/picture/brief_intro/42.png
new file mode 100644
index 0000000..0a771e3
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/42.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/43.png b/mcguide/16-美术/picture/brief_intro/43.png
new file mode 100644
index 0000000..0d00cbb
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/43.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/44.png b/mcguide/16-美术/picture/brief_intro/44.png
new file mode 100644
index 0000000..70a2487
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/44.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/45.png b/mcguide/16-美术/picture/brief_intro/45.png
new file mode 100644
index 0000000..820f991
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/45.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/46.png b/mcguide/16-美术/picture/brief_intro/46.png
new file mode 100644
index 0000000..fe411f8
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/46.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/47.png b/mcguide/16-美术/picture/brief_intro/47.png
new file mode 100644
index 0000000..06beb06
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/47.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/48.png b/mcguide/16-美术/picture/brief_intro/48.png
new file mode 100644
index 0000000..5fea99f
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/48.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/49.png b/mcguide/16-美术/picture/brief_intro/49.png
new file mode 100644
index 0000000..ecbd17e
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/49.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/50.png b/mcguide/16-美术/picture/brief_intro/50.png
new file mode 100644
index 0000000..6fa9466
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/50.png differ
diff --git a/mcguide/16-美术/picture/brief_intro/54.png b/mcguide/16-美术/picture/brief_intro/54.png
new file mode 100644
index 0000000..0870e89
Binary files /dev/null and b/mcguide/16-美术/picture/brief_intro/54.png differ
diff --git a/mcguide/18-界面与交互/0-界面编辑器改版说明.md b/mcguide/18-界面与交互/0-界面编辑器改版说明.md
new file mode 100644
index 0000000..8149128
--- /dev/null
+++ b/mcguide/18-界面与交互/0-界面编辑器改版说明.md
@@ -0,0 +1,110 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/ui_image004.29b265a4.png
+hard: 入门
+time: 10分钟
+---
+# 界面编辑器改版说明
+
+改版时间：2022.5.10
+
+如果你之前没有重度使用过界面编辑器，可以跳过这篇文档，直接从[界面编辑器使用说明](./1-界面编辑器使用说明.md)开始阅读。
+
+本次界面编辑器改动的主要内容为：
+
+
+
+1. 界面文件的解析能力和兼容性提高
+
+可以解析几乎所有合法的界面Json，不会再出现因为不符合编辑器默认的写法而被覆盖的情况，可以放心大胆的导入手写的界面Json文件使用。
+
+即使界面文件不合法，或者有一些比较罕见但是正确的写法，编辑器也会以控件破损的形式表现，而不是尝试对你的界面文件进行自动修改。
+
+并且界面Json中的继承，变量，属性引用，控件引用等特殊写法在改版后的界面编辑器中都得到了准确的体现。
+
+
+
+
+
+2. 所有继承控件在编辑器内都可以展开显示完整的控件结构
+
+例如下图是编辑器内置的“开关”控件，你现在可以展开这个控件，学习它的构造。
+
+> 如果你对我的世界原版的界面Json不够了解，你暂时不需要使用这个功能。建议按顺序阅读文档进行进一步的学习。
+
+
+
+
+
+3. 移除界面文件和图片的两个资源管理窗口，替换为通用的资源管理器。
+
+资源管理器也较之前的版本有较大优化，详见[新版资源管理器](../15-资源管理/2.5-资源管理器.md)。现在资源管理器的精简模式功能已覆盖旧版的两个资源管理窗口。
+
+- 通过“新建”来新建界面文件
+- 在精简模式的界面标签下查看和打开界面文件
+- 在精简模式的贴图里查看所有的贴图
+
+资源管理器中的界面文件现在支持截图了。
+
+详见[界面编辑器使用说明](./1-界面编辑器使用说明.md#新建界面文件)
+
+
+
+
+
+4. 移除旧版的继承控件功能，修改为“继承原版控件”
+
+旧版的继承控件功能的使用场景广泛，但在每个使用场景下都不是很好用。新增的“继承原版控件”功能聚焦于在当前编辑的界面文件的控件结构中添加继承自原版控件的控件，详见[添加原生控件](./18-添加原生控件.md)。通过这种方式添加的控件也是可以展开的，如下图就是原生的物品容器。
+
+“继承原版控件”仍然包含旧版的继承控件的全部功能，但是我们建议除了“继承原版控件”之外的需求使用下面我们推出的新功能。
+
+
+
+
+
+5. 新增自定义控件功能
+
+如果你希望用继承的方式复用自己的控件，可以使用新的自定义控件的功能。你可以将某个控件（和子控件）添加至控件库。自定义控件库里会显示所有的自定义控件。
+
+你可以通过简单的拖拽从控件库里复用你的自定义控件。自定义控件在控件结构中显示为青色。详见[继承和自定义控件](./13-继承和自定义控件.md)。
+
+
+
+
+
+6. 新增变量和属性引用功能
+
+随着控件层级增加，自定义控件的数量增加，界面会变得越来越复杂，并且自定义控件（继承的控件）在使用时不能修改子控件的属性。
+
+我们经常需要在某个控件中修改其他控件的属性值，我的世界的界面Json里支持的这种写法现在在编辑器中也支持了，即属性引用功能。
+
+例如下面这两个控件其实来源是同一个自定义控件，通过属性引用的方式修改成了不同的样子。
+
+
+
+控件属性面板新增了变量区，里面的所有变量都可以通过界面编辑器添加/管理。如果你的界面Json里包含这样的写法，现在也可以正确的解析到属性面板中了。详见[属性变量引用](./15-变量引用和万用控件.md#属性变量引用)。
+
+旧版的很多编辑器自带的控件的属性实际上都是通过属性引用实现的，现在也统一解析到变量区中，下图是按钮的变量区。
+
+
+
+
+
+7. 新增控件引用
+
+控件引用其实是大家的老朋友，编辑器自带的“滚动列表”控件的滚动内容属性就是控件引用。此外“网格”控件的内容也是控件引用。
+
+现在控件引用会提供一个下拉框，可选择的范围变更为所有的自定义控件（都展示在自定义控件库中），不再是“其他画布下的控件”。
+
+
+
+现在你可以在编辑器中创建自己的万用控件引用来实现类似下图的效果。下图的两个弹窗控件实际上都继承自同一个自定义控件，弹窗的内容以万用控件引用的形式开放为变量，和上面的“滚动内容”属性非常类似，只需要在这个属性里指定不同的自定义控件，弹窗里就可以显示不同的内容，详见[控件引用和万用控件](./15-变量引用和万用控件.md#控件引用和万用控件)。
+
+
+
+
+
+8. 基类画布功能修改
+
+原有的基类画布功能无法正常生效，我们优化了这一功能。现在在创建画布的时候可以直接选择基类画布，详见[异形屏适配和基类画布](./20-界面适配预览和方法.md#异形屏适配和基类画布)。
+
+
diff --git a/mcguide/18-界面与交互/1-界面编辑器使用说明.md b/mcguide/18-界面与交互/1-界面编辑器使用说明.md
new file mode 100644
index 0000000..5dec58c
--- /dev/null
+++ b/mcguide/18-界面与交互/1-界面编辑器使用说明.md
@@ -0,0 +1,122 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/ui_image004.29b265a4.png
+hard: 入门
+time: 10分钟
+selection: true
+---
+# 界面编辑器入门
+
+## 基本介绍
+
+界面编辑器用于可视化的编辑《我的世界》游戏内的界面。
+
+进入编辑器后，如果当前显示的不是界面编辑器，那么需要在顶部页签中，点击“界面”进行切换。如下图：
+
+
+
+界面编辑器的界面构成如下：
+
+
+
+
+
+下面简单介绍各个界面的作用：
+
+1. **控件库-原生控件**：将①“控件类型”区域的控件拖拽到③“控件结构”中某个控件，可以为其添加一个子控件。或者直接拖拽到中间的预览窗中，可以直接在屏幕的指定位置创建控件。其中画布比较特殊，画布用于挂载各种非画布控件，不能作为其他控件的子控件。注意，不是所有的控件都可以挂接子控件，自定义控件/继承控件的实例是不能添加子控件的，详见[继承和自定义控件](./13-继承和自定义控件.md)（建议按顺序阅读文档，不需要提前关注）。
+2. **新建变量**：新功能，用于添加变量引用和控件引用，详见后。
+3. **控件结构**：当前选中工程的界面控件树状结构，在这里可以对控件进行选中、隐藏/显示等操作，右键控件，可进行添加子控件、删除、复制等操作。
+4. **快捷选项**：可以在这里调整分辨率，是否显示游戏画面，是否自动设定层级等选项。
+5. **对齐操作**：在界面结构中，按住Ctrl键后多选控件，然后点击对齐按钮，可对齐选中的控件。
+6. **控件库-自定义控件**：①里的控件是《我的世界》基岩版原生的，或者网易提供的，而这里的控件是开发者自定义的，详见[继承和自定义控件](./13-继承和自定义控件.md)。
+7. **资源管理**：展示所有的文件资源。在界面编辑中，我们主要关注界面文件（Json）和贴图，详见[界面资源管理](#界面资源管理)。
+8. **控件属性**：选中控件时，这里会显示该控件可编辑的属性。
+9. **编辑区域**：编辑区域会实时显示界面编辑效果，也可选中、移动、缩放控件。
+
+## 新建界面文件
+
+如果你新建了一个空白作品（地图，附加包均可），或者打开了一个没有界面的作品，你的界面编辑器将与下图类似。
+
+
+
+你有两种方式来新建一个界面文件。
+
+1. 点击控件结构里的新建（只在没有界面文件时可以）
+
+
+
+2. 点击资源管理器的新建，通过新建文件向导创建
+
+在新建文件向导的常用，或者界面页签里选择界面文件，点击下一步
+
+
+
+输入界面文件的文件命名，并点击下一步以完成创建。
+
+
+
+## 界面资源管理
+
+界面编辑器现在使用通用的资源管理器进行文件管理，以精简模式为例，我们在编辑界面时主要关注界面和贴图，界面和贴图在资源管理器左侧的精简模式中点击按钮进行切换。
+
+- 界面
+
+在界面文件夹里可以看到3种文件。
+
+1. 界面配置：即界面文件（Json），双击可以在编辑器中打开这个界面。
+
+
+
+右键界面配置，在弹出的菜单中点击打开文件所在位置，然后可以在windows的文件夹中打开这个json文件。
+
+
+
+
+
+2. 界面模板文件：固定命名为 netease_editor_template_namespace.json，里面保存有一些网易提供的控件模板，无需关心。
+3. 界面定义文件：固定命名为 _ui_defs.json，里面保存这个作品中使用到的界面的文件名称，无需关心。
+
+> 请勿修改或者删除界面模板文件和界面定义文件。
+
+- 贴图
+
+下拉资源管理器左侧的精简模式的滚动条，或者在这里滚动滚轮，点击贴图，可以将目录切换到贴图目录，这里会显示有所有的贴图。
+
+> 这里所有的贴图都是可以直接使用的，并非只有“界面贴图”可以用于界面。
+
+
+
+## 组装控件
+
+《我的世界》的界面和大部分其他游戏的一样，都可以简单的理解为控件的组合。
+
+下图的这些就是界面编辑器中可以直接添加的控件，关于这些控件的介绍，请参考[控件和控件属性](./10-控件和控件属性.md#控件简介)。
+
+《我的世界》中还有大量可以直接继承的控件，我们将在后续逐步添加。
+
+
+
+有两种方式在界面中添加控件：
+
+- 拖拽控件库中的控件到控件结构，或者拖拽到预览窗；
+- 在控件结构中的控件上右键，依次选择添加对象->控件。添加控件后，编辑区域会实时显示添加的控件。
+
+
+
+除了编辑器提供的控件之外，你现在还可以在控件结构中添加自定义的控件。详见[自定义控件](./13-继承和自定义控件.md)。
+
+## 编辑控件属性
+
+在控件列表或者编辑区域中选择控件后，被选中的控件会显示一个红框，其父控件会显示一个蓝框。
+
+
+
+在右侧属性面板中会显示被选中控件的属性，不同的控件有不同的属性，你可以通过修改属性来调整控件的显示效果，详见[控件和控件属性](./10-控件和控件属性.md#控件简介)。
+
+> 如果控件是自定义控件的实例，将显示青色的框，详见[继承和自定义控件](./13-继承和自定义控件.md)。
+>
+> 
+
+下图是文本控件的属性，可以看到我们提供了诸多属性供你修改。
+
+
+
diff --git a/mcguide/18-界面与交互/10-控件和控件属性.md b/mcguide/18-界面与交互/10-控件和控件属性.md
new file mode 100644
index 0000000..2480801
--- /dev/null
+++ b/mcguide/18-界面与交互/10-控件和控件属性.md
@@ -0,0 +1,157 @@
+
+
+# 控件和控件属性
+
+## 控件简介
+
+- **画布**：画布是一个完整的界面，画布下可以挂除了画布以外的子控件。一个界面工程文件中可以有多个画布。新建的界面工程文件会自带一个名字为main的画布。例如下图，这些都是画布。
+
+
+
+- **面板**：面板本身并没有可视元素，把归属一个模块的控件挂在一个面板下，能够让界面结构更加清晰，调整起来也更加方便。
+
+- **图片**：图片控件用于显示图片。图片会在不变形的情况下尽量撑满控件的尺寸。
+
+- **按钮**：按钮是重要的交互控件。可设置按钮上的文本、文本颜色、文本字号、文本偏移。按钮的贴图分为普通、按下、悬浮三种情况。“普通”即为正常状态下的贴图，“按下”为按钮被按下时的贴图，“悬浮”为在PC中，鼠标移动到按钮上时的按钮贴图。设置贴图的方式：在资源管理窗口中，左键按住贴图拖动到贴图框中，待鼠标变为带“+”号的样式时，松开鼠标，即可完成贴图设置。
+
+ 
+
+- **文本**：文本控件用于显示文本，可设置字号和颜色。
+
+- **滚动列表**：滚动的内容可在属性面板的变量区的“滚动内容”配置项中选择。“滚动内容”的下拉列表中，会出现你的自定义控件可供选择。下图中，mailUI是界面文件名称，buttonMail、panelMailBody、gridMailList等是自定义控件名称。如果你想了解更多，可以查看[自定义控件](./13-继承和自定义控件.md)。如果你想深入了解“滚动内容”的原理，可以查看[万用控件](./15-变量引用和万用控件.md)，当然我们建议您按顺序查看文档。
+
+ 
+
+ 并不是所有控件都能够作为滚动列表的内容，目前仅限于面板、按钮、网格三种类型可作为滚动列表的内容。如果想在滚动面板里显示文本控件，可将文本控件放在面板下，然后将面板作为滚动列表内容。不过并不支持将滚动列表挂在面板下，再将面板作为另外一个滚动列表的内容。
+
+- **网格**：网格用于需要规律排布的界面，如背包界面。其中内容的配置方式类似滚动列表中的内容。网格规模用于配置网格的行列数。网格会自动将内容均匀的显示在各个格子内。
+
+ 
+
+ 需要注意的是，我的世界游戏引擎中，对网格的尺寸和内容的尺寸有一定要求，否则显示会不符合预期。具体的要求为：
+
+ - 内容的尺寸为固定像素时:
+ - 网格的宽度应大于等于内容的宽度乘以列数，小于内容的宽度乘以（列数+1）；
+ - 网格的高度应大于等于内容的高度乘以行数；
+ - 内容的尺寸为百分比时：
+ - 内容的宽度乘以列数需小于等于100%，内容的宽度乘以（列数+1）需大于100%；
+ - 内容的高度乘以行数需大于等于100%。
+
+ 集合名在代码中绑定UI控件时会用到，具体可参考[UI说明文档](./30-UI说明文档.md)。
+
+
+- **轮盘**：轮盘主要用于内容列表中进行选择的场景，比如选择某个表情展示或者抽奖等。在编辑器中创建轮盘控件后，需要填好想设定的切片数量、内直径、外直径系数，然后通过生成模板按钮，生成出对应预览的模板控件样式。 轮盘的本质是引用自定义控件，其中的内容配置主要通过选择各索引对应的控件，这里选择的控件其实就是引用的自定义控件的各个子控件（生成了模板后，开发者可以自行在对应引用的自定义控件中修改样式和属性等）。另外，轮盘也可以通过content变量来切换引用的自定义控件。更多内容可参考[UI说明文档](./30-UI说明文档.md)。
+
+ 
+
+ 
+
+
+
+## 控件属性的结构/分组
+
+这里主要介绍控件的属性在编辑器里的分组。
+
+由于控件的属性较多，并且可以自己增加减少，我们将控件的属性进行了默认分组。
+
+以文本（Label）为例：
+
+
+
+可以看到总共有4个分组，分别为
+
+- 通用：所有控件都有的属性
+- 文本：文本控件特有的属性，如果是其他控件，可能也会有自己特有的属性。
+- 变量区：作为变量使用的属性，详见[变量引用和万用控件](./15-变量引用和万用控件.md)。
+- 变量默认值：指已为某个属性分配了变量名，但是该属性/变量没有被引用，详见[变量引用和万用控件](./15-变量引用和万用控件.md)。
+
+我们以另一个控件滚动列表（Scroll View）为例：
+
+
+
+可以看到还有一个不常用变量区，这个分组与变量区的含义是一样的，区别在于这个分组里的属性很少被用到，所以我们将其划分到这个分组中。
+
+## 通用控件属性
+
+下面这些是每种控件都有的属性。
+
+- **锚点**：每个控件有9个定位点，包括四个角、四边的中点、中心点，锚点可以设定子控件的哪个定位点和父控件的哪个定位点重合，下图中左侧对应父控件、右侧对应子控件。
+
+ 
+
+ 下图为子控件中心和父控件上边中点重合的情况。
+
+ 
+
+ 下图为子控件右下角和父控件左上角重合的情况。
+
+ 
+
+- **名称**：控件的名字，只能是字母和数字的组合。
+
+- **隐藏控件**：勾选后会隐藏控件。在控件列表中，点击控件右侧的眼睛也能够实现类似效果。
+
+ 
+
+- **层级**：层级用于控制控件的上下关系。层级高的显示在上面。
+
+- **位移XY**：控制控件相对于锚点位置的偏移，在下面的红框中，可以直接填写数值，单位是像素。除了直接填像素外，还有更高级的用法，详见[位移尺寸高级用法](#位移尺寸属性的高级用法)。
+
+
+
+- **尺寸XY**：尺寸XY，最大尺寸XY，最小尺寸XY，3组数据的含义类似，都是对控件尺寸（宽高）的描述。与位移XY相似，也支持直接填写像素和[更高级的用法](#位移尺寸属性的高级用法)。如果最大尺寸XY，最小尺寸XY，填写0，那么默认不启用这几个属性。如果勾选了适应，比如尺寸X，那么尺寸X的实际数值会保持为父控件的尺寸X的100%。
+
+
+
+> 界面编辑器提供了众多属性，学习这些属性的最好方式就是调整他，并观察效果。
+
+## 位移尺寸属性的高级用法
+
+以位移X为例。
+
+位移用于控制该控件相对于锚点位置的偏移。形式为Px+%。Px表示像素，%表示跟随某个尺寸的百分比。
+
+如位移X配置（如下图）为：跟随父控件尺寸X的10Px+10%，如果父控件的宽度（尺寸X）为100像素，那么子控件的偏移X就为10Px + 10% * 100Px = 20Px。
+
+
+
+除了跟随父控件尺寸X之外，我们还提供了其他的跟随方式。如果想知道其他跟随项的效果，除了通过字面含义理解之外，我们非常建议你实地尝试一下这些跟随项的用法，这会大幅加深你对这个选项的用法。
+
+
+
+如果你直接在vscode等文本编辑器中打开这个界面文件时，可以发现，offset字段的第一个值就与编辑器中的配置非常类似。
+
+
+
+%和Px是按钮，可点击，点击后会按照目前的设置，将位移X的设置由Px+%的形式转为Px，或者%形式。
+
+
+
+- 点击Px，如下图所示，转为20Px
+
+
+
+- 点击%，如下图所示，转为20%，因为父控件的尺寸X是100Px，20% × 100Px = 20Px
+
+
+
+## 位移尺寸高级用法的实际应用
+
+下图是一个弹窗，有一个content用作万用控件（如果你感兴趣，可以参考[万用控件](./15-变量引用和万用控件.md)，但是我们建议你按顺序阅读文档）。
+
+
+
+messageBoxPanel是一个panel，然后下面挂接了一个background图片，图片的尺寸XY均勾选了适应，这样可以保证图片始终填满父控件panel。
+
+
+
+我们希望实现的效果是，无论外层控件（messageBoxPanel）怎么放大缩小，content都能占满红框内的区域。
+
+按照下图调整content的位移和尺寸即可：
+
+- 位移X，因为content始终是在X方向（水平方向）的中心，所以填0即可
+- 位移Y，因为content会偏下一点（标题栏有一定的高度），所以我们在这里填7
+- 尺寸X，因为content的宽度是跟随父控件的宽度发生变化的，父控件宽，他也宽，所以这里我们选择跟随100%的父控件尺寸X。又因为这个弹窗左右边框也有宽度，所以我们需要减去这个宽度（-10）
+- 尺寸Y，因为content的高度是跟随父控件的高度发生变化的，父控件高，他也高，所以这里我们选择跟随100%的父控件尺寸Y。又因为这个弹窗的底部边框和标题栏也有高度，所以我们需要减去这个高度（-25）
+
+
diff --git a/mcguide/18-界面与交互/11-图片缩放适配与九宫切图.md b/mcguide/18-界面与交互/11-图片缩放适配与九宫切图.md
new file mode 100644
index 0000000..8205701
--- /dev/null
+++ b/mcguide/18-界面与交互/11-图片缩放适配与九宫切图.md
@@ -0,0 +1,89 @@
+
+
+# 图片缩放适配与九宫切图
+
+## 图片缩放和宽高比
+
+下图是我们需要的示例图片，你可以在浏览器中下载，或者点击这个[地址](https://g79.gdl.netease.com/goods_print02.png)下载，并导入编辑器中备用。
+
+这是一张很小的图片，我的世界中使用的图片通常来说也比较小。
+
+
+
+这张图片的尺寸为16*16，将鼠标悬停在资源管理器的图片文件上，你可以在弹出的悬浮提示中看到这一数据。
+
+
+
+我们放大这张图片，可以看到这张图片具体每个色块的像素信息，这张图片被分成3个部分，外环的直径为4个像素，中环的直径为2个像素，内部正方形的边长为4。
+
+
+
+我们在编辑器中放置一张图片，并将其使用贴图指定为这张图片，然后在预览窗中对这张图片进行拉伸，可以看到，默认状态下，这张图片只是有一个方向（水平或竖直）抵住了红色外框，显示的图片并没有变形。
+
+
+
+在图片适配中关闭“保持宽高比”后，这张图片就可以填满整个红色外框了。
+
+
+
+如果我们希望这张图片尽可能的放大，不惜裁剪掉一部分，可以选择填充，填充的示例效果如下，可以看到，图片的在水平方向填满了红框，竖直方向则被红框裁剪了。
+
+> “填充”的优先级高于“保持宽高比”，一旦勾选填充之后，就不会再保持宽高比。
+
+
+
+## 九宫切图
+
+可以看到，在不确定图片的长宽比的情况下，无论上面的哪一种适配方法，都不够美观。能不能有一种适配方法实现下面这种既填满红框，又能在视觉上保持宽高比的效果呢？这就需要用到九宫切图了。
+
+
+
+### 原理
+
+游戏制作中经常会有上述这样的需求，我们拿到下面这张图片时，会发现我们可以将下面这张图按照下图青色线的方法切成9份（即九宫切图），其中
+
+- 1是不可以进行缩放的，会导致长宽比发生变化
+- 2可以进行任意的水平缩放
+- 3可以进行任意的竖直缩放
+- 4可以进行任意的缩放（反正是纯色了，怎么缩放都可以）
+
+九宫切图后
+
+- 如果我们想要水平拉伸这张图片，那么1,3两种图块是不会动的，只有2,4会水平拉伸
+- 如果我们想要竖直拉伸这张图片，那么1,2两种图块是不会动的，只有3,4会竖直拉伸
+
+
+
+九宫切图的数据就是这4条青色的线与图片4边的距离，可以看到
+
+- 左侧竖直的青色线距离左边的距离为7
+- 右侧竖直的青色线距离右边的距离为7
+- 上方竖直的青色线距离上边的距离为7
+- 下方竖直的青色线距离下边的距离为7
+
+
+
+### 原版九宫
+
+我们调整“原版九宫”的数值，即可在这个图片控件上完成九宫适配。
+
+
+
+### 新版九宫
+
+除了原版九宫外，还有另外一种九宫规则（新版九宫）。
+
+我们按照下图的方式，开启旧版九宫，并同样按照四边都是7的方式进行九宫切割，可以看到不同的结果。
+
+
+
+这是因为两种九宫对屏幕分辨率的适配方法不同。
+
+- 原版九宫适配的是缩放后的实际游戏分辨率，参考[界面适配预览和方法](./20-界面适配预览和方法.md)。
+- 新版九宫适配的是屏幕中的游戏分辨率
+
+你可以根据自己的使用场景使用不同的九宫方法。
+
+
+
+更多信息可以参考[MC九宫格使用与贴图规范](../16-美术/50-贴图规范及九宫格使用.md)。
diff --git a/mcguide/18-界面与交互/13-继承和自定义控件.md b/mcguide/18-界面与交互/13-继承和自定义控件.md
new file mode 100644
index 0000000..fa9283b
--- /dev/null
+++ b/mcguide/18-界面与交互/13-继承和自定义控件.md
@@ -0,0 +1,118 @@
+
+
+# 继承和自定义控件
+
+## 创建自定义控件
+
+例如我们想实现如下这样的玩家属性界面。
+
+可以看到，这个界面中包含4个属性，每个属性长的都很类似。
+
+
+
+都是由一个图片，一个物品渲染，和一个文本组成的
+
+- 图片：作为背景
+- 物品渲染：作为图标使用（我们这里只是借用我的世界原版的一些素材，更好的做法当然是使用自己绘制的图片）
+- 文本：用于属性的说明和数值
+
+
+
+他的控件结构如下。这里我们使用了一个面板（panel）来组织这些控件。
+
+
+
+那么有没有复用的方法呢？
+
+有，我们提供了一种方法，可以让你将这个结构作为一个自定义的控件保存起来。
+
+右键这个面板（panel），在菜单里选择添加至控件库。
+
+
+
+在弹出的窗口中，输入名称，然后点击确定，即可在自定义控件库中添加这个控件。
+
+> 注意不要填写与选择的节点相同的名称。以上图的情况为例，请不要使用“panel”作为控件名称。
+
+
+
+可以看到，在控件库中多了一个你自己的自定义控件。
+
+右键这个自定义控件，选择编辑控件本体，可以在控件结构中打开这个自定义控件进行编辑。你也可以简单的通过在自定义控件库中双击一个控件来编辑它。
+
+
+
+界面编辑器中使用青色表示自定义控件。
+
+
+
+## 使用自定义控件
+
+创建了自定义控件后，接下来是如何使用自定义控件。
+
+1. 在控件结构面板，选中希望挂接自定义控件的节点
+2. 在自定义控件库中，右键想要挂接的自定义控件
+3. 在菜单中选择创建实例
+
+
+
+可以看到，我们成功的在PlayerAttrContent下添加了一个PlayerAttr控件。
+
+
+
+还有一种更为简单直接的方式可以添加自定义控件，你可以像下图这样，直接将自定义控件拖拽至想要挂接的节点。
+
+
+
+简单调整一下位置，我们将得到如下的效果。
+
+
+
+## 继承（自定义控件的原理）
+
+### 本体和实例
+
+自定义控件实际上就是《我的世界》基岩版的UI继承。
+
+我们在这里不关注Json层面的继承写法，只关注继承本身的特性。
+
+编辑器中
+
+- 我们将自定义控件库中的控件称为“**本体**”，即下图的①
+- 我们将自定义控件在控件结构中的实际使用称为“**实例**”，即下图中的②
+
+
+
+注意，在没有使用变量引用时，实例控件的子控件是无法修改的。
+
+因此，如果我们尝试展开一个自定义控件的实例时，我们会提醒你。
+
+
+
+当你展开自定义控件的实例后，你会发现，除了自定义控件的根节点之外，其他节点（子节点）是灰色的，他们的属性的修改也都被禁用了。
+
+
+
+即，**对于自定义控件的实例来说，你能修改的只有这个控件的根节点的属性**。
+
+### 修改本体
+
+如果你修改了本体，比如下图中，我们将item_renderer的道具材质修改为绿宝石块。
+
+
+
+
+
+你会发现，所有他的实例都“**继承**”了这一改变。
+
+这是一个非常好用的特性，能够帮助你快速修改大量的界面。所以如果你的界面中有复用的话，我们强烈建议你使用自定义控件库（即继承）的方式来组装界面。
+
+
+
+到这里，你可能有疑惑，如果不能修改子控件的属性的话，那我如何实现最开始这种效果，因为文本是Lable子控件的属性。
+
+这就需要用到变量了，变量和自定义控件组合使用将发挥**继承**真正的实力，详见[变量引用和万用控件](./15-变量引用和万用控件.md)。
+
+
+
+关于继承的更多底层知识，请参阅[继承控件](./30-UI说明文档.md#继承控件)。
diff --git a/mcguide/18-界面与交互/15-变量引用和万用控件.md b/mcguide/18-界面与交互/15-变量引用和万用控件.md
new file mode 100644
index 0000000..fefe92b
--- /dev/null
+++ b/mcguide/18-界面与交互/15-变量引用和万用控件.md
@@ -0,0 +1,201 @@
+---
+front:
+hard: 入门
+time: 10分钟
+---
+
+# 变量引用和万用控件
+
+## 属性变量引用
+
+下图的4个控件是同一个自定义控件的实例。如果要实现类似下面这种各不相同的效果，需要用到属性引用功能。
+
+
+
+自定义控件的实例，只能修改根节点的属性。所以我们要想办法，在PlayerAttr这个节点直接控制Label节点的内容属性。
+
+即，在PlayerAttr节点增加一个变量，绑定Label节点的内容。
+
+
+
+需要执行如下的操作：
+
+1. 选中自定义控件的根节点（如图，这里是PlayerAttr）
+2. 点击功能区的新建变量
+3. 在菜单中选择：新增属性变量
+
+
+
+这将打开一个新的面板——新建属性变量面板。
+
+我们是选中PlayerAttr节点打开的
+
+- 你在这个面板中可以选择**PlayerAttr**节点和**其子控件**的所有属性
+- 并将这些属性作为**变量**开放到**PlayerAttr**的变量区
+
+
+
+我们选择**label**，并选中**内容**属性。
+
+可以看到，当你选中内容时，变量类型也自动选择了文本内容。
+
+这是因为你可以一次性绑定多个类型相同的属性，我们在这里自动帮你做了筛选。
+
+填写好变量命名后（比如AttrText），点击确定。
+
+
+
+现在，我们就在PlayerAttr的变量区成功创建了AttrText属性，并且这个属性绑定的label控件的内容属性。
+
+我们在这里把值修改为200，可以看到，预览窗里显示的值也变成了200。
+
+
+
+### 属性引用示例
+
+现在让我们使用这一自定义控件快速实现一个货币展示HUD。
+
+由于物品渲染的属性暂时不支持属性变量引用，我们使用一个图片控件来代替，并将这个图片控件命名为icon。
+
+
+
+接下来为PlayerAttr添加一个新的变量（icon_texture），并绑定icon控件的贴图属性。
+
+
+
+可以看到这个图片“消失”了。
+
+
+
+这是因为在PlayerAttr的变量区中，这个新创建的变量（icon_texture）还没有赋值。
+
+
+
+接下来，我们通过windows的文件夹在工作台的下载路径中，找到编辑器的下载路径，在这里可以找到物品的贴图文件夹。
+
+然后找到绿宝石和钻石，两张贴图，并将其导入编辑器的贴图中。
+
+
+
+准备工作到此为止，接下来我们创建一个新的界面文件。并在main画布下创建2个PlayerAttr的实例。
+
+然后分别设置两个实例的变量区的icon_texture变量为钻石贴图和绿宝石贴图。
+
+
+
+效果如下。
+
+
+
+感觉icon有点小。我们打开这个自定义控件，调整一下icon控件的尺寸，然后返回界面文件，可以看到这两个自定义控件实例的样式都被正常修改了。
+
+
+
+## 控件引用和万用控件
+
+### 简介
+
+下图是两个弹窗，他们的外框非常相似，但是内容不同。
+
+
+
+事实上他们使用的是同一个外框，你可以使用控件引用来实现这样的效果。
+
+
+
+### 制作内容物
+
+我们先制作两个内容物。
+
+- 内容1
+
+综合[界面编辑器入门](./1-界面编辑器使用说明.md)，[控件和控件属性](10-控件和控件属性.md)两篇文档，我们可以很轻松的实现这个控件。制作完毕之后，我们需要将其添加到控件库，详见[继承和自定义控件](13-继承和自定义控件.md)，这里我们命名为QuestionContent。
+
+
+
+- 内容2
+
+内容2是一个滚动列表，想要实现上述形式的滚动列表，我们需要先创建一个文本控件，并将其添加到控件库，比如命名为myLbl。
+
+
+
+然后，我们创建一个滚动列表，在属性“滚动内容”里选择刚才的自定义控件myLbl。并取消勾选下面的“显示背景”。然后，将这个滚动列表添加到控件库，这里我们将其命名为MessageScrollView。
+
+> 其实“滚动内容”就是一个万用控件变量。
+
+
+
+### 制作外框
+
+接下来我们实现一个外框。
+
+外框非常简单，由下面3个控件组成
+
+- 一个图片作为背景图（background节点）
+- 一个文本作为标题（title节点）
+- 一个按钮作为关闭按钮（closeBtn节点）
+
+
+
+值得一提的是，background图片控件的贴图使用的是原生贴图。
+
+
+
+贴图的路径如下，这张贴图在我的世界中自动支持九宫，无需在界面编辑器的属性中填写，是制作弹窗类控件的好资源。
+
+
+
+### 添加万用控件变量
+
+接下来，我们要在background节点下添加一个万用控件，并将其作为变量开放到messageBoxPanel节点。这个功能很难理解，我们推荐你跟着做完，然后我们再做解释。
+
+与属性变量的操作步骤类似：
+
+1. 选中messageBoxPanel节点
+2. 点击新增万用控件变量
+
+
+
+在弹出的菜单中
+
+1. 选中background节点，我们要把万用控件挂接为这个节点的子节点
+2. 填写万用控件命名
+3. 填写变量命名
+4. 可以看到按照上述填写信息之后，编辑器将帮我们实现的操作，点击确定
+
+
+
+观察一下结果，可以发现
+
+1. 在messageBoxPanel节点增加了一个v_content变量
+2. 在background节点下增加了一个content控件
+
+
+
+3. 你可以在v_content中选择一个自定义控件库里的控件
+
+
+
+在修改v_content的属性值之前，我们先调整一下content控件的尺寸，使其可以始终填满外框视觉上的内容部分，具体方法请参考[控件和控件属性](./10-控件和控件属性.md#位移尺寸高级用法的实际应用)。
+
+我们在之前已经做好了两个内容物控件，QuestionContent 和 MessageScrollView。
+
+这里我们选择QuestionContent ，可以看到，我们的万用控件看起来和QuestionContent完全相同。
+
+
+
+### 控件引用总结
+
+即，控件引用变量和万用控件可以实现的效果就是：**可以在属性面板中通过修改变量的值，将子控件的万用控件转变为某个自定义控件**。
+
+理解了这些之后，我们再看一下滚动列表这个控件。
+
+
+
+我们在编辑器中强行把他展开，你会发现，滚动列表就是使用了一个万用控件（scrolling_content）。
+
+
+
+并且这个万用控件的值被开放到了根节点（scroll_view）的属性面板的变量区的“滚动内容”属性。使你可以直接在最外层（scroll_view）修改滚动列表的内容物控件。
+
+
diff --git a/mcguide/18-界面与交互/16-示例：开关与标签切换.md b/mcguide/18-界面与交互/16-示例：开关与标签切换.md
new file mode 100644
index 0000000..c8ddcc0
--- /dev/null
+++ b/mcguide/18-界面与交互/16-示例：开关与标签切换.md
@@ -0,0 +1,198 @@
+---
+front:
+hard: 入门
+time: 10分钟
+---
+
+# 示例：开关与标签切换
+
+## 开关
+
+这个是编辑器里内置的开关（继承自我的世界原版的开关），开关可以理解为包含两种状态的按钮，每次点击会在两种状态中切换。
+
+
+
+开关可以定义的主要就是这6种状态的贴图：
+
+- 对应开关开启的状态：选中锁定贴图，悬浮贴图，按下悬浮贴图
+- 对应开关关闭的状态（开关默认是关闭的）：普通贴图（即默认的样子），按下贴图，未选中锁定贴图
+
+锁定就是开关不可用的状态，无法点击。
+
+
+
+## 复杂的开关效果
+
+下图也是一种开关的开启/关闭状态，常用于制作页签。两种状态除了贴图不一样之外，还有文字的区别。
+
+这就导致我们需要对编辑器自带的开关做一些改动，以适应我们的需求。
+
+
+
+上图的UI只用到了下面这两张图片，图一为按钮本体图片，图二为按钮右侧的尖角图片。
+
+
+
+
+
+## 复杂开关的制作步骤
+
+### 控件结构
+
+首先，我们创建一个界面文件，然后创建下图的控件结构。其中，main - panel(0)下的两个panel（面板）分别是
+
+- panel：对应右侧上方的选中（checked）状态的开关，下面的两张贴图分别对应按钮底板和尖角
+- panel(0)：对应右侧下方的未选中（unchecked）状态的开关
+
+
+
+### 贴图设置
+
+上述两个panel（面板）控件的底板图片的图片均使用下图。
+
+
+
+两个控件的颜色看起来有些许差别，是因为我们在panel下的底板图片里调整了颜色属性。属性值见下图。
+
+这个颜色是对原有图片颜色的叠加，能实现的效果受图片原有的色彩影响很大，原有图片的色彩越浅，效果越明显。
+
+
+
+适配设置见下图，这里我们使用旧版九宫，可以实现较为精细的效果。
+
+关于九宫的更多用法参考[图片缩放适配与九宫切图](./11-图片缩放适配与九宫切图.md)。
+
+
+
+尖角图片的设置较为简单，不再赘述。
+
+### 尺寸设置
+
+尖角图片的锚点和尺寸XY的数据如下。
+
+
+
+按钮底板的锚点和尺寸XY的数据如下图。
+
+
+
+这样设置可以保证当父节点的尺寸在一定范围内变化时，控件的视觉效果始终保持一个底板+一个尖角的形状，且相对位置不发生太多变化。
+
+
+
+### 开放属性引用并删除变量
+
+我们对panel新增两个属性引用变量，关于属性引用请参考[属性变量引用](./15-变量引用和万用控件.md#属性变量引用)：
+
+- 开放panel的尺寸属性到panel，命名为my_toggle_size
+- 开放label的内容属性到panel，命名为my_toggle_text
+
+
+
+找到panel的尺寸XY，可以看到这个属性现在处于不可编辑的状态，你只能通过编辑my_toggle_size的值来影响这个值。
+
+在尺寸X的右侧有一个引用按钮，将鼠标放在上面会显示悬浮提示，内容为这个引用这个属性的变量。
+
+
+
+我们在变量区里找到my_toggle_size，然后通过“···”按钮，点击删除，将这个变量删除。
+
+
+
+我们会发现这个变量被删除了，但是在变量默认值的分组中可以找到这个变量（这里我们填写一个80,50的默认值）。
+
+这是因为panel的尺寸仍然绑定了my_toggle_size变量，只是这个变量没有被正式启用。
+
+
+
+接下来我们删除变量区的my_toggle_text变量，可以发现label控件的变量默认值分组内同样出现了my_toggle_text属性（这里我们填写“当前选中”作为默认值）。
+
+
+
+接下来我们对panel(0)如法炮制，请务必保证这里开放的2个属性引用的变量名称和之前的一样，必须还是my_toggle_size和my_toggle_text。
+
+
+
+### 添加到控件库
+
+我们将panel和panel(0)都添加到控件库，并分别命名为：
+
+- panel：MyToggleChecked
+- panel(0)：MyToggleUnchecked
+
+
+
+记得双击打开这两个自定义控件，将这两个控件的根节点的位移XY归零。
+
+完事就绪，我们可以在控件窗口中删除panel和panel(0)了。
+
+### 在开关中应用自定义控件
+
+在控件窗口里新建一个开关。
+
+
+
+如果我们在控件窗口里强行展开开关，可以看到开关就是由8个万用控件组成的，在开关的不同状态，显示不同的控件。
+
+
+
+这里我们不关注变量区，而是打开“不常用变量区”，在这里可以看到大量的控件引用，关于控件引用详情可以参考[这里](./15-变量引用和万用控件.md#控件引用和万用控件)。
+
+我们不制作太精细的效果，暂时将其分为两组：
+
+- 所有的选中……属性：使用MyToggleChecked控件
+- 所有的未选中……属性：使用MyToggleUnchecked控件
+
+
+
+即当开关开启（选中）时，我们的开关将显示MyToggleChecked的样子。
+
+当开关关闭（未选中）时，我们的开关将显示MyToggleUnchecked的样子。
+
+### 在开关中引用自定义控件的属性
+
+我们在“[开放属性引用并删除变量](#开放属性引用并删除变量)”这一步中曾经创建过my_toggle_size和my_toggle_text两个属性，我们将在开关中使用。
+
+我们选择switch_toggle变量区的“+”，选择添加已设变量。
+
+这里可以看到熟悉的my_toggle_size和my_toggle_text两个变量，把他们都添加一下。
+
+
+
+效果如下图，可以看到在开关的变量区增加了这两个变量，并且他们可以控制开关下面所有的万用控件的同名属性。属性引用就是以变量名作为匹配的，即：
+
+- switch_toggle的my_toggle_size变量，控制所有红框的子节点的my_toggle_size属性（面板的尺寸属性）
+- switch_toggle的my_toggle_text变量，控制所有黄框的子节点的my_toggle_text属性（文本的内容属性）
+
+
+
+可以在这里调整数值查看效果。
+
+
+
+如果你想直接在预览窗中通过拖拽switch_toggle的红色外框调整各万用控件的尺寸，你可以勾上my_toggle_size的两个“适应”属性。
+
+
+
+## 测试复杂开关
+
+使用资源管理器的“新建”创建一个界面预设，参考下图。
+
+
+
+在新建文件向导的第二页，我们无需修改，直接点击创建即可。
+
+
+
+编辑器会自动打开我们刚创建好的界面预设，并跳转到预设编辑器，选中界面预设。
+我们在界面预设的属性面板中，勾选预加载，并且保证绑定的界面画布为刚才包含switch_togggle的画布。
+
+
+
+然后点击编辑器右上角的运行按钮，选择当前最新的稳定版开发包，等待开发包打开。
+
+然后按下F11切换为模拟触屏模式，就可以点击这个开关进行切换了。
+
+
+
+以上是一个简单的自定义开关的例子，更复杂使用这种开关来实现一套页签切换的例子可以参考[UI数据绑定](./70-UI数据绑定.md)。
diff --git a/mcguide/18-界面与交互/18-添加原生控件.md b/mcguide/18-界面与交互/18-添加原生控件.md
new file mode 100644
index 0000000..d019ded
--- /dev/null
+++ b/mcguide/18-界面与交互/18-添加原生控件.md
@@ -0,0 +1,46 @@
+
+
+# 添加原生控件
+
+《我的世界》中大量使用了继承控件，我们找到工作台的下载路径，并找到资源包里面的ui目录，里面可以看到我的世界原生的大量的界面文件。
+
+我们最熟悉的按钮其实就是ui_common.json中定义的一个自定义控件。
+
+
+
+我们打开ui_common，映入眼帘的即是button——我的世界中使用的按钮。
+
+这里我们主要关注两个信息：
+
+- ui_common.json的namespace（命名空间）：common
+- 按钮控件的名称：button
+
+接下来会用到。
+
+
+
+那么，如何在你的界面中直接使用原生的控件呢？
+
+1. 我们先创建一个界面文件，并在main画布下挂接一个面板（panel）
+2. 选中面板，点击功能区的“添加原生控件”按钮
+
+
+
+3. 在弹出的弹窗里按照下图填写。（命名空间填写json文件里的common，控件名称填写json文件里的button）
+
+
+
+4. 点击确定，这样你就在你的界面中添加了一个原生的button
+
+
+
+当然，原生的按钮显得不那么好用，我们还是推荐你使用编辑器提供的按钮。
+
+我们尝试下另一个常用的控件：container_item，这个就是广泛用在各种原生界面中的物品容器。
+
+我们在编辑器中尝试对其进行展开，可以看到这个控件的内部结构。
+
+善用添加原生控件可以帮助你快速搭建与原生界面类似的界面，以及学习原生界面的写法。
+
+
+
diff --git a/mcguide/18-界面与交互/19-控件属性动画.md b/mcguide/18-界面与交互/19-控件属性动画.md
new file mode 100644
index 0000000..256ad7d
--- /dev/null
+++ b/mcguide/18-界面与交互/19-控件属性动画.md
@@ -0,0 +1,563 @@
+---
+front:
+hard: 入门
+time: 分钟
+---
+
+# 控件属性动画
+
+MC为部分UI控件属性提供了一套属性动画逻辑，活用他们，可以让你的界面更加精美绚丽。
+
+一言以蔽之，界面属性动画，就是使界面的某一控件的某个属性值跟随时间发生变化，并以此产生动画效果，例如下图中的效果就是一个uv属性的动画。
+
+
+
+以下所有属性动画的示例均可参考 UIDemoModUI 动画演示，demo的下载位置见[这里](../20-玩法开发/13-模组SDK编程/60-Demo示例.md)。
+
+另外，这里还会介绍如何通过接口去控制你的动画。
+
+## Demo介绍
+
+将上述的 UIDemoModUI 导入Studio，并使用编辑器打开。
+
+> 默认会使用旧版编辑器打开，第一打开时需要点击升级按钮。旧版编辑器不包含属性动画相关功能。
+
+双击打开UIAnimationScreen界面文件。
+
+本质上来说，属性动画与自定义控件非常类似，由于属性动画主要用于某一具体的控件的动画，没有单独展示的意义，目前并不会出现在自定义控件库中。
+
+### 支持的属性动画类型
+
+并非所有的控件属性都支持动画，当前支持的属性有：
+
+- 位移和尺寸
+- 透明度
+- 裁剪
+- 颜色
+- 序列帧
+- UV动画
+
+同一个控件，可以有多个属性同时设置属性动画，所有的属性动画都会在界面创建后自动播放。
+
+可以看到当前支持的所有属性都存在于图片控件中，我们接下来的所有示例都会以图片为准。
+
+### 创建属性动画
+
+新建一个界面文件，并创建一个面板和一个图片，如下图。
+
+
+
+选中需要添加动画的控件，这里是image，然后在功能区点击“添加动画”按钮。
+
+
+
+弹出一个添加动画的弹窗，如下图。
+
+- 复用动画：在这里可以选择自定义控件库里的动画，也可以留空，表示创建一个新动画。
+- 首段动画名称：创建的动画在自定义控件库里的名称。
+- 属性动画的属性类型选框
+
+> 如果复用动画，那么首段动画名称将不可修改，显示的就是复用的动画的名称。
+> 首段动画名称可以留空，表示动画不加入自定义控件库。需要注意的是，如果留空，首段动画就不能被其他属性动画复用，也不能循环播放。
+
+
+
+填写好必要信息后，点击确定即可，这里我们选择透明度。
+
+### 编辑属性动画
+
+如下图，可以发现image控件的属性面板中，透明度属性从一个数值变为了一个列表。
+
+这个列表展示的就是透明度属性动画的细节信息。
+属性动画在编辑器中的形式是列表，列表的每一个元素表示一个动画片段，当动画播放时，会从列表的第一个元素顺次播放到最后一个元素。
+
+
+
+
+
+上图黄框内的6个按钮，其作用分别为：
+
+- 添加元素：为动画添加一个新的动画片段
+- 取消动画：取消这个属性的动画，并将其恢复为固定值的形式
+- 删除元素：删除一个动画片段
+- 向上移动：与上方的动画片段调换位置
+- 向下移动：与下方的动画片段调换位置
+- 上方新建元素：在上方插入一个动画片段
+
+> 对于取消动画/删除动画，如果你的动画保存在自定义控件库中，那么这并不会导致动画片段的信息丢失，你仍然可以从自定义控件库中复用。
+
+除了增删动画片段之外，修改属性是最常见的编辑属性动画的方法，每个动画片段的属性基本相同，他们的含义分别为：
+
+- 命名空间：该动画所在的界面文件的命名空间，你可以在下拉框中选择其他的界面文件以切换动画信息保存的文件，一般情况下无需在意这个属性
+- 动画名称：动画片段在自定义控件库中的名称
+- 动画类型：一般与属性的类型相同
+- 持续时间：此动画片段持续的时间，经过这段时间后，动画片段播放完毕，开始播放下一段动画
+- from：动画的起始帧，即刚开始播放此动画时的属性值
+- to：动画的最终帧，即此动画将要播放完毕时的属性值
+- 循环片段：控制动画的最后几个片段循环播放
+
+> 除了首段动画外，动画名称不能为空，即除了首段动画外，后续的动画片段必须保存在自定义动画库中。
+> 同一个属性动画中，不能出现2个相同的动画名称的动画片段。
+
+如下图我们额外添加2个动画片段，并调整数值如下。
+
+
+
+### 保存和另存动画
+
+由于有复用逻辑，对于属性动画的保存，我们提供了2种方式
+
+- 创建副本，相当于另存为新的动画，会在自定义控件库里创建一系列新的动画
+- 应用修改，修改当前使用的动画，会影响所有复用这个动画的自定义控件
+
+
+
+> 你必须先保存才能播放动画，或者切换到其他控件，其他编辑器
+
+### 播放动画
+
+保存完毕后，可以播放动画，对编辑的效果进行预览。我们提供了2种预览方式。
+
+1. 点击属性动画的播放按钮，可以对这个属性动画进行单独预览
+
+
+
+2. 点击功能区的“播放选中控件动画”按钮，可以对这个控件的所有属性动画同时进行预览
+
+
+
+例如我们为这个控件再添加一个尺寸动画，那么使用方式2预览的表现如下图：
+
+
+
+### 动画循环
+
+属性动画支持循环，且可以自己定义参与循环的片段，你可以通过下图中的循环片段属性调整，循环的规则如下：
+
+- 一个属性动画，只有最后的动画片段有“循环片段”这个属性
+- 只能让最后几段动画循环
+- “循环片段” = 0表示没有循环
+- 例如你填写了5个动画片段，按顺序分别是A→B→C→D→E，且“循环片段” = 3，那么实际的播放顺序是A→B→C→D→E→C→D……（CDE循环）
+- “循环片段”不能超过属性动画的动画片段数
+- 如果首段动画没有名称，那么它不能参与循环
+- 序列帧动画不能循环
+
+
+
+### 取消属性动画
+
+点击属性动画的取消按钮，可以取消该属性动画，并且将其恢复到固定数值的状态。
+
+
+
+> 如果动画已经保存到自定义控件库中，那么取消动画并不会删除这个动画
+
+### uv动画和序列帧动画
+
+uv动画和序列帧动画都是uv起点属性的动画，不同于其他属性动画只能使用固定的动画片段类型，比较特殊。
+
+我们新建一张图片，并使用my_eating_apple.png作为图片资源。然后添加一个属性动画，动画的类型选择“uv起点”，如下图，可以看到2种动画（通过动画类型的下拉框切换）。
+
+1. 序列帧
+
+序列帧属性动画与序列帧特效类似，都是通过切换图片的显示区域达到动画的效果，序列帧动画主要关注下列属性：
+
+- 播放帧数：代表序列帧贴图资源总共包含的总帧数，例如我们使用的图片中总共包含了苹果的36个状态，所以这个值填写36
+- 起始帧：表示第一帧播放第几张图
+- 帧率：每秒播放的帧数，10表示每秒切换10张图，总共是36张图，播放一次需要的时间为3.6秒
+- 是否可逆：勾选时序列帧播放完毕后倒放回第一帧
+
+
+
+使用序列帧动画时，图片的uv尺寸不能填写[0,0]，这里填写的是序列帧的每一帧的尺寸大小。
+
+> 序列帧动画使用的图片，想要实现正常的效果，每个子图的大小必须一致
+> 序列帧动画会自我循环，所以没有循环的属性。因为会自我循环，所以序列帧动画后面的动画片段是不会被读取到的
+
+2. uv动画
+
+动画类型从“序列帧”切换到“uv”，可以制作uv动画。uv动画与其他动画类似，按照下图的信息填写，保存并播放，可以查看uv动画的效果。
+
+
+
+## 属性动画Json写法简介
+
+属性动画依然是以Json数据的形式写在UI文件中，格式和控件类似。
+
+要表现一个属性动画，需要先写一个Json数据块，透明度动画举例如下（相关参数会在下文详细描述）：
+
+```json
+ {
+ "anim_type" : "alpha",
+ "duration" : 1.0,
+ "from" : 0.0,
+ "to" : 1.0
+ }
+```
+
+这段代码块代表一个控件在1秒钟内alpha值从0线性变化到1的属性动画，为了将这个动画绑定到控件上，一共有两种写法。
+
+一种是将Json数据块直接赋给alpha属性：
+
+```json
+ {
+ "alphaImg" : {
+ "alpha" : {
+ "anim_type" : "alpha",
+ "duration" : 0.30,
+ "from" : 0.0,
+ "to" : 1.0
+ },
+ "texture" : "textures/netease/common/image/default",
+ "type" : "image",
+ "visible" : true
+ }
+ }
+```
+
+另一种则是将属性动画写成自定义控件的形式写在UIjson文件的最外层，在alpha属性值以 “@”+动画名 的形式进行赋值：
+
+```json
+ {
+ "alphaImg" : {
+ "alpha" : "@show_alpha_ani",
+ "texture" : "textures/netease/common/image/default",
+ "type" : "image",
+ "visible" : true
+ },
+ "show_alpha_ani": {
+ "anim_type" : "alpha",
+ "duration" : 0.30,
+ "from" : 0.0,
+ "to" : 1.0
+ },
+ }
+```
+
+两种写法都能达成相同的效果，不同的是第二种写法能够被复用。
+
+目前UI编辑器还不支持属性动画的创建和编辑，但通过修改UIJson定义的属性动画可在UI编辑器播放，此时挂载了属性动画的属性在编辑器内修改对应属性无法生效。
+
+## 属性动画类型与Json配置
+
+### 通用属性
+
+通用属性是每种属性动画都支持的属性
+
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| anim_type | 动画类型，取值["alpha", "clip", "color", "flip_book", "offset", "size", "uv"]，不同的动画类型只能赋给对应的属性。 |
+| duration | 动画持续时间，单位为秒。|
+| from | 动画起始数据，根据动画类型的不同，支持写入的数据类型也不同，控件初始化时会用该值初始化对应属性 |
+| to | 动画结束数据，根据动画类型的不同，支持写入的数据类型也不同 |
+| next | 当前动画播放完毕后接着播放的动画，**注2**举了一个使图片控件的alpha值从0到1再到0的渐变动画的例子。 |
+
+* 注1
+
+填写属性动画属性值时请注意不同的动画所需要的属性值类型或取值范围均可能不同，填写错误会导致动画无法生效或表现异常。
+
+* 注2
+
+```json
+ "alphaImg" : {
+ "alpha" : "@show_alpha_ani",
+ "texture" : "textures/netease/common/image/default",
+ "type" : "image",
+ "visible" : true
+ },
+ "show_alpha_ani": {
+ "anim_type" : "alpha",
+ "duration" : 0.30,
+ "from" : 0.0,
+ "next" : "@hold_alpha_ani",
+ "to" : 1.0
+ },
+ "hold_alpha_ani" : {
+ "anim_type" : "alpha",
+ "duration" : 1,
+ "from" : 1.0,
+ "next" : "@hide_alpha_ani",
+ "to" : 1.0
+ },
+ "hide_alpha_ani" : {
+ "anim_type" : "alpha",
+ "duration" : 0.30,
+ "from" : 1.0,
+ "to" : 0.0
+ },
+
+```
+
+### 透明度动画
+
+控件透明度动画，需要挂载在"alpha"属性值上
+
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| anim_type | "alpha" |
+| from | 透明度起始值，取值0-1.0。 |
+| to | 透明度结束值，取值0-1.0。 |
+
+
+
+```json
+ "alphaImg" : {
+ "alpha" : "@show_alpha_ani",
+ "texture" : "textures/netease/common/image/default",
+ "type" : "image",
+ "visible" : true
+ },
+ "show_alpha_ani": {
+ "anim_type" : "alpha",
+ "duration" : 0.30,
+ "from" : 0.0,
+ "next" : "@hold_alpha_ani",
+ "to" : 1.0
+ },
+ "hold_alpha_ani" : {
+ "anim_type" : "alpha",
+ "duration" : 1,
+ "from" : 1.0,
+ "next" : "@hide_alpha_ani",
+ "to" : 1.0
+ },
+ "hide_alpha_ani" : {
+ "anim_type" : "alpha",
+ "duration" : 0.30,
+ "from" : 1.0,
+ "to" : 0.0
+ },
+
+```
+
+### 裁剪动画
+
+控件裁剪动画，需要挂载在图片控件的"clip_ratio"属性值上
+
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| anim_type | "clip" |
+| from | 裁剪程度起始值，取值0-1.0。0表示不裁剪，1表示完全裁剪，即该控件不渲染 |
+| to | 裁剪程度结束值，取值0-1.0。 |
+
+
+
+```json
+ "clipImg" : {
+ "clip_ratio" : {
+ "anim_type" : "clip",
+ "duration" : 1.0,
+ "from" : 0.0,
+ "to" : 1.0
+ },
+ "texture" : "textures/netease/common/image/default",
+ "type" : "image",
+ "visible" : true
+ },
+
+```
+
+### 颜色动画
+
+控件颜色动画，需要挂载在图片控件的"color"属性值上
+
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| anim_type | "color" |
+| from | 颜色起始值，颜色（r , g, b）取值范围[0 , 1]，不支持alpha值属性设置或参与动画 |
+| to | 颜色结束值 |
+
+
+
+```json
+ "colorImg" : {
+ "color": "@color_ani",
+ "texture" : "textures/netease/common/image/default",
+ "type" : "image",
+ "visible" : true
+ },
+ "color_ani": {
+ "anim_type" : "color",
+ "duration" : 1.0,
+ "from" : [1,0,0],
+ "to" : [0,0,1]
+ },
+
+```
+
+### 序列帧动画
+
+控件序列帧动画，需要挂载在图片控件的"uv"属性值上.
+
+序列帧动画，又称逐帧动画，其原理是在“连续的关键帧”中分解动画动作，也就是在时间轴的每帧上逐帧绘制不同的内容，使其连续播放而成动画。通过一张序列帧动画资源图，以及一些自定义的设置，可以在图片控件上展示序列帧动画。
+
+| 变量
| 解释 |
+| :-----------------: | -------------------------------------------- |
+| anim_type | "flip_book" |
+| initial_frame | uv动画起始帧 |
+| frame_count | 帧数，代表序列帧贴图资源总共包含的总帧数 |
+| fps | 帧率，每秒播放的帧数 |
+| reversible | 是否可逆，默认值为false，为true时序列帧播放完毕后倒放回第一帧 |
+
+
+
+```json
+ "flipbookImg" : {
+ "texture" : "textures/ui/my_eating_apple",
+ "type" : "image",
+ "uv" : "@flipbook_ani",
+ "uv_size" : [ 64.0, 64.0 ],
+ "visible" : true
+ },
+ "flipbook_ani": {
+ "anim_type": "flip_book",
+ "initial_frame": 10,
+ "frame_count": 36,
+ "fps": 10,
+ "reversible": false
+ },
+```
+
+当一个图片控件被用作序列帧的载体时，该控件的属性配置有以下规则需要遵守：
+
+| 变量
| 解释 |
+| :-----------------: | -------------------------------------------- |
+| texture | 贴图的路径，贴图需要符合序列帧样式，如下图 |
+| uv | 序列帧本质上就是一种特殊的uv动画。 |
+| uv_size | uv尺寸表示需要显示的尺寸，要和序列帧贴图中的一帧大小相同 |
+
+
+
+### 位移动画
+
+控件位移动画，需要挂载在控件的"offset"属性值上
+
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| anim_type | "offset" |
+| from | 位移起始值，自身相对父节点的偏移，详见[通用属性](./30-UI说明文档.md#通用属性) |
+| to | 位移结束值 |
+
+
+
+```json
+ "offsetImg" : {
+ "offset" : "@offset_ani",
+ "texture" : "textures/netease/common/image/default",
+ "type" : "image",
+ "visible" : true
+ },
+ "offset_ani": {
+ "anim_type" : "offset",
+ "duration" : 1.0,
+ "from" : [0, 0],
+ "to" : [0, 50]
+ },
+
+```
+
+**注**
+
+位移动画需要起始值和结束值的偏移类型相同，例如起始值为["50%", 0],结束值则需要为["100%", 50]，即变化的类型需保持一致。
+
+如果有需要调用接口动态修改该控件的尺寸，请避免使用SetSize，改为使用SetFullSize。
+
+如果有需要调用接口动态修改该控件的偏移属性，请避免使用SetPosition，改为使用SetFullPosition。
+
+### 尺寸动画
+
+控件尺寸动画，需要挂载在控件的"size"属性值上
+
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| anim_type | "size" |
+| from | 尺寸起始值，控件大小，详见[通用属性](./30-UI说明文档.md#通用属性) |
+| to | 尺寸结束值 |
+
+
+
+```json
+ "sizeImg" : {
+ "size" : "@size_ani",
+ "texture" : "textures/netease/common/image/default",
+ "type" : "image",
+ "visible" : true
+ },
+ "size_ani": {
+ "anim_type" : "size",
+ "duration" : 1.0,
+ "from" : [100, 100],
+ "to" : [150, 150]
+ },
+
+```
+
+**注**
+
+尺寸动画需要起始值和结束值的偏移类型相同，例如起始值为["50%", 0],结束值则需要为["100%", 50]，即变化的类型需保持一致。
+
+如果有需要调用接口动态修改该控件的尺寸，请避免使用SetSize，改为使用SetFullSize。
+
+如果有需要调用接口动态修改该控件的偏移属性，请避免使用SetPosition，改为使用SetFullPosition。
+
+### UV动画
+
+控件UV动画，需要挂载在图片控件的"uv"属性值上
+
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| anim_type | "uv" |
+| from | uv坐标初始值。uv坐标为[x,y]表示图片控件以所选图片左上角为原点，偏移(x,y)像素开始截取图片。 |
+| to | uv坐标结束值 |
+
+
+
+```json
+ "sizeImg" : {
+ "uv" : "@uv_ani",
+ "texture" : "textures/netease/common/image/default",
+ "type" : "image",
+ "visible" : true
+ },
+ "uv_ani": {
+ "anim_type" : "uv",
+ "duration" : 5,
+ "from" : [0, 0],
+ "to" : [2240, 0]
+ },
+
+```
+
+
+## 控制动画
+
+
+目前的SDK接口支持注册动画，给属性添加动画，移除属性的动画，暂停播放单一（或者全部）属性动画等等，开发者可以参考以下的接口：
+
+注册动画： RegisterUIAnimations
+
+取消注册动画： UnregisterUIAnimation
+
+
+暂停动画： PauseAnimation
+
+播放动画： PlayAnimation
+
+停止播放动画： StopAnimation
+
+
+给单一属性设置动画： SetAnimation
+
+
+给单一属性移除动画： RemoveAnimation
+
+
+设置动画播放结束后的回调： SetAnimEndCallback
+
+
+删除回调： RemoveAnimEndCallback
+
+
+这些接口在 UIDemoModUI 中部分使用（注册和添加动画请点击 "无动画按钮"）
+
+
\ No newline at end of file
diff --git a/mcguide/18-界面与交互/2-从零开始创建UI.md b/mcguide/18-界面与交互/2-从零开始创建UI.md
new file mode 100644
index 0000000..582892f
--- /dev/null
+++ b/mcguide/18-界面与交互/2-从零开始创建UI.md
@@ -0,0 +1,270 @@
+---
+front:
+hard: 入门
+time: 分钟
+selection: true
+---
+
+# 从零开始创建UI界面
+
+这篇教程会详细介绍如何通过工作台内嵌的UI编辑器，创建一个基础的FPS战斗界面。教程包括界面控件的创建（包含面板，图片和按钮）以及按钮相关的逻辑绑定。将按照以下步骤来进行介绍：
+* 如何根据自己的需要使用UI编辑器进行界面编辑和保存
+* 如何根据json中的内容进行按钮逻辑python的相关绑定
+
+## 使用UI编辑器
+
+我们的目的是制作一个简易射击模板。
+
+
+
+实现这个模板手机版界面的部分功能。
+
+
+
+### 进入UI编辑器
+
+打开MC 工作台，我们点击创建空白AddOn。
+
+
+
+选择空白附加包，在弹出的“新建空白附加包”弹窗中填写信息，并点击启动编辑以进入编辑器。
+
+
+
+进入编辑器后，你需要先通过顶部页签切换到“界面”，以打开界面编辑器，如下图：
+
+
+
+### 导入UI资源
+首先，我们把制作界面需要的图片通过UI编辑器的资源管理器窗口，选择图片文件导入。如下图。
+
+
+
+注意，目前我们仅支持png格式的图片文件，此外，图片名称仅支持以数字、字母、下划线组成的名称，该命名规则也是整个UI编辑器通用的命名规则，若不满足以上规则，资源导入会失败。
+
+界面需要的图片资源可以点击这里下载：[简易射击模板界面贴图资源](https://g79.gdl.netease.com/awesome_ui_textures.zip)。
+
+成功导入图片后的资源管理窗口如下图所示，在资源管理器的精简模式中切换到贴图，可以看到所有的贴图。
+
+
+
+如果你使用完整模式的话，UI的贴图在这个目录（根目录\resourcepack（资源包）\textures\ui）。关于资源管理的更多内容请参考[文件结构](../15-资源管理/2-文件结构.md)。
+
+
+
+> 精简模式的贴图没有区分具体用处，展示的是所有作品目录中的贴图。你可以使用其他目录中的贴图，如果他不在ui文件夹下，编辑器会自动帮你复制一份到ui文件夹。
+
+### 新建UI文件
+
+现在让我们来创建一个界面文件：
+
+1. 使用资源管理器的新建按钮
+2. 在弹出的新建文件向导弹窗中选择界面文件，点击下一步
+3. 填写文件命名，这里我们命名为fpsBattle，并点击创建
+
+
+
+新建UI文件成功后，UI编辑器会自动载入该UI文件的编辑模式，并自带main画布，整体界面如下图所示。你可以将资源管理器（精简模式）切换到界面，这里将显示所有的界面文件。
+
+
+
+如果你喜欢完整模式，界面文件的路径（根目录\resourcepack（资源包）\ui）如下图。
+
+
+
+如你所见，预览窗正中间的巨大的黄色像素块是艾利克斯的可爱的后脑勺。如果你想专注于界面编辑，不想被游戏干扰，你可以关闭“显示游戏画面”这个选项。
+
+
+
+### 创建panel面板控件
+
+首先，我们先创建两个面板（panel）。面板是所有控件中最基础的一个，除去通用属性外，没有任何专属属性，主要用于控件归纳，就如同文件夹一样。创建面板和创建所有其他控件一样，我们鼠标左键单击选中main，然后右键点击弹出菜单，选择"添加对象"-"面板"，如下图。
+
+
+
+或者将控件库中的面板控件直接拖拽到控件结构的main控件上，完成创建，如下图。
+
+
+
+还可以先选中控件结构中的main，然后直接将面板拖拽到预览窗中，如下图。
+
+
+
+### 重命名控件
+创建完毕后对两个面板进行重命名操作，点击选中需要重命名的面板，在右侧的属性面板中修改它的名称，如下图。将其重命名为aimPanel，buttonPanel分别用来存放准心图片控件和所有按钮控件。
+
+
+
+
+
+### 创建准心图片控件
+面板创建成功后，我们来创建准心，准心通常是一张图片，和新建面板一样我们选中aimPanel并新建一个图片控件，这样新建的控件将会将aimPanel作为父节点。然后将其重命名为aimImage，如下图。
+
+
+
+创建完成之后，选中该图片控件，我们要替换它的图片，往下滑动属性窗口至"图片"这一栏，我们将先前导入图片资源拖拽到贴图设置处进行赋值，完成后场景中的图片就会由默认图片显示变为我们导入的图片显示，如下图。
+
+
+
+图片设置后，我们就可以通过调整锚点、尺寸和位移调整该控件相对于父节点的位置。这三个属性描述如下：
+
+锚点：每个控件有9个定位点，包括四个角、四边的中点、中心点，锚点可以设定子控件的哪个定位点和父控件的哪个定位点重合，下图中左侧对应父控件、右侧对应子控件。
+
+位移：位移用于控制该控件相对于锚点位置的偏移。位移的形式为%+Px。%表示父控件尺寸的百分比，Px表示像素。
+
+尺寸：尺寸为控件的宽（X）和高（Y）。也是%+Px的形式，其意义同位移。
+
+一般来说，控件的偏移和尺寸均用Px配置即可，比较复杂的情况才需要用到%。这里我们只是简要概括一下控件属性的作用和用法，详情请前往阅读[控件和控件属性](./10-控件和控件属性.md)。
+
+我们分别如下调整aimPanel和aimImage，设置后的界面如下图所示：
+
+
+
++ + + +
+
+其中画布一般和屏幕大小相同，少数情况会小于屏幕，由系统和玩家设置决定。
+
+前面我们已经知道，控件的尺寸为百分比加一个固定像素值的形式。系统在计算控件实际的显示尺寸时，会对所有固定像素乘以一个比例a。举例如下：
+
+| | **画布尺寸** | **父控件尺寸** | **子控件设定尺寸** | **子控件实际显示尺寸** |
+| ------ | ------------ | -------------- | ------------------ | ---------------------- |
+| **宽** | 900Px | 800Px | 10%+50Px | 80Px+50Px\*a |
+| **高** | 750Px | 750Px | 20%+100Px | 150Px+100Px\*a |
+
+那么比例a是怎么确定的呢？系统会按如下步骤计算这个比例：
+
+1. **计算画布的宽除以320、画布的高除以210的值**。上面的例子中，这两个值为900/320=2.81,750/210=3.57。
+2. **计算a的最大值**。在1)中计算的两个比例分别取整，然后再取最小值，作为a的最大值。在上面的例子两个比例取整后分别为2和3，最小值就是2。
+3. **计算a的最终值**。根据某些的规则得到一个比2)中小的值，作为a最终的值。这个规则开发者无需关心。一般来说最终值和2)里计算的最大值是一样的。
+
+在上面的例子中，a的值为2，那么控件显示的宽为80Px+50Px\*a=180Px，高为150Px+100Px\*a=350Px。
+
+通俗一点来说，游戏里有一个320Px\*210Px的适配区域（下图中紫色实线部分），游戏把这个适配区域按整数倍膨胀，直到再膨胀就会超出画布为止。然后将这个整数比例乘以控件尺寸中的固定像素，再加上比例部分计算得到的像素，作为最终的控件显示尺寸。
+
+
+
+因此，如果我们想UI在各种分辨率的屏幕下都不会超出屏幕边界，可以把决定显示范围的父控件（比如顶层的面板控件）的尺寸设为固定尺寸，且数值在320\*210以下。需要注意的是，贴图并不需要受限于这个尺寸，可以适当扩大贴图尺寸，以在大分辨率的屏幕里获得更好的效果。
+
+此外，在PC基岩版中，适配的基准值为376x250，略大于手机适配的320x210，如果想一份界面资源同时适配手机和PC基岩版，那么需要以手机的标准来制作。
+
+## 异形屏适配和基类画布
+
+如果你制作的是手机模组，可能会遇到玩家的屏幕是异形屏的情况，例如挖孔屏，刘海屏等。
+
+有一个简单的方法来进行适配，就是使用基类画布。如果你打算对异形屏进行适配，最好一开始就使用基类画布，如果你已经做了一半，那你可以这样做（我们以界面模板这个邮件界面为例）：
+
+1. 在main画布下新建一个panel（面板），并且将panel的尺寸XY的适应勾上。
+2. 将原来main画布下的其他控件拖拽到panel（面
+
+
+
+1. 右键panel添加到控件库，这里我们命名为mailContent，结果如下图
+
+
+
+> 这个操作是为了让main画布下的所有内容可以塞到同一个自定义控件中。如果你的main画布下面本来就是只有一个自定义控件的实例，那么你可以跳过这一步，或者main画布下面本来就只有一个直接的子节点（不关注孙节点等），那么直接把这个唯一的子节点创建为自定义控件即可。
+
+1. 创建一个基类画布，在画布的属性面板的变量区里选择刚刚创建的mailContent，这样就完成了基类画布的使用。
+
+
+
+> 如果你之前在画布上创建了变量，很遗憾，你必须再手动创建一次。
+
+你可能注意到了，如果你使用基类画布的话，你不能直接在基类画布下对控件进行编辑，而是需要编辑这个自定义控件。
+
+
+
+基类画布实际上使用了[控件引用](./15-变量引用和万用控件.md#控件引用和万用控件)。
+
+展开screen画布，然后继续按照下图的方式展开，你可以看到这个root_screen_panel实际上是一个万用控件。
+
+继续展开，就是我们熟悉的mailContent控件的内容。
+
+
+
+你可以在这里很方便的复制路径，复制到的路径可以直接使用在模组的SDK代码中。
+
+
+
+可以看到，启用基类画布之后，路径发生了较大的变化，所以我们强烈建议你在制作UI之前先想要是否要使用基类画布。
+
diff --git a/mcguide/18-界面与交互/21-操作安全性说明.md b/mcguide/18-界面与交互/21-操作安全性说明.md
new file mode 100644
index 0000000..f8b6b4c
--- /dev/null
+++ b/mcguide/18-界面与交互/21-操作安全性说明.md
@@ -0,0 +1,47 @@
+---
+front:
+hard: 入门
+time: 分钟
+---
+
+# 操作安全性
+
+## 加载自定义控件失败
+
+如果自定义控控件所在的文件中不存在该自定义控件，或者该文件不合法（不符合json格式，缺少根节点下缺少"namespace"节点）就会导致该报错的产生。
+
+## 无法删除当前编辑的自定义控件
+
+当前正在编辑的自定义控件是不允许进行删除的。
+
+## UI名字已经被系统或原生使用
+
+在MC中已经存在了部分原生控件，并且占用了一定的命名空间，用户应当用其他名称命名UI文件
+
+## 继承循环错误
+
+当前正在编辑自定义控件的时候，当控件继承关系比较复杂的时候，比较难察觉到继承导致的循环错误，比如三个控件 A，B，C，如果继承关系为 B继承自A，C继承自B，那么在编辑A的时候，如果将在A中实例化C并且保存到A中，那么就会间接导致自定义控件C所继承的对象中包含自己，从而导致在实例化C的时候，会出现循环错误。
+
+## 包含循环错误
+
+当前正在编辑自定义控件的时候，当控件继承关系以及包含关系比较复杂的时候，容易导致这个包含循环错误，比如三个 A，B，C，如果继承关系为B继承自C，如果C中包含了一个继承自A的子节点，在B不改写自身子节点的情况时，相当于B也包含了一个继承自A的子节点，如果此时用户编辑的是自定义控件A，对B实例化在A中的时候，就会间接导致自定义控件A中包含了继承自自定义控件A的节点，从而导致循环错误。
+
+## 添加变量失败
+
+用户尝试更新的变量为全局变量或者是UI编辑器暂时不支持的变量类型，比如 "\$variable_1": "\$variable_2" 这类变量引用变量的情况，则会导致该报错
+
+## 更新变量失败
+
+报错原因见[添加变量失败](#AddVariable)。
+
+## 丢失引用导致的变量无法解析
+
+比如一个image类型的控件，基础属性 "alpha" 引用了变量 "\$myAlpha"，并且该变量是声明在他的父组件，那么在将该image控件创建为自定义控件的时候，"\$myAlpha"变量是不存在于该自定义控件上的（假设该控件身上也没有声明 "\$myAlpha|default"变量），因此在实例该自定义控件的时候，他的实例一开始也是不包含该变量的，如果将这个实例挂载到一个不含有"\$myAlpha"变量的父节点树下，那么将会导致该实例在解析属性 "alpha" 的时候搜索不到 "\$myAlpha"变量而报解析错误。
+
+同样，如果一个控件为万用控件，它继承的控件是由变量解析的，如果搜索不到变量则解析不了它所继承的对象，从而导致它变为一个破损控件。
+
+因此，用户在删除变量以及创建自定义控件过程中，都会提示用户该潜在的风险。
+
+## 变量循环
+
+在更改万用控件所继承的变量值的时候，会对变量值所对应的自定义控件进行解析生成，假设一种情况，万用控件A继承自变量 "\$myCustomControl"，并且值为 "myNamespace.myCustomControl"，也就是A继承了自定义控件 myCustomControl，如果这个自定义控件恰好里面也包含一个继承自变量 "\$myCustomControl"的万用控件，并且该万用控件的这个变量也被解析为 "myNamespace.myCustomControl"，那么此时就会造成变量循环，在解析继承控件的时候会不断进行循环变量的解析。
\ No newline at end of file
diff --git a/mcguide/18-界面与交互/30-UI说明文档.md b/mcguide/18-界面与交互/30-UI说明文档.md
new file mode 100644
index 0000000..2144611
--- /dev/null
+++ b/mcguide/18-界面与交互/30-UI说明文档.md
@@ -0,0 +1,2301 @@
+---
+front:
+hard: 入门
+time: 分钟
+---
+
+# UI说明文档
+
+## 文件命名说明
+
+* json文件名 json中的namespace python文件名 三者需要一致
+
+* 示例中为"myUIName"
+
+```json
+ myUIName.json
+
+ "namespace" : "myUIName"
+
+ myUIName.py
+
+```
+
+## JSON编写说明
+
+Json是UI界面的显示内容和绑定的集合，UI是一种树状的组织结构，界面和界面中的控件都是一个UI Node节点，后续的很多方法的调用也需要这个树状结构的路径来标识。
+
+* 注：目前MCStudio已提供UI编辑器，开发者可以在UI编辑器内对界面进行可视化编辑，并导出可以使用的json文件。各个控件在UI编辑器中的使用介绍将在下文中详细介绍。
+
+### 命名空间
+
+命名空间是这个界面的名称，我们规定json文件名和namespace一致。
+
+```json
+ "namespace" : "myUIName"
+```
+
+### Main Screen
+
+main是这个界面名称，我们规定使用main，即一个json文件是一个界面。
+
+controls中的内容是该界面下的树状节点，即子节点。
+
+```json
+ "main@common.base_screen" : {
+ "controls" : [
+ ]
+ }
+```
+
+| 变量 | 解释 |
+| :---------------------: | :-------------------------------------------- |
+| main@common.base_screen | 表示main screen是common.base_screen的一个子类 |
+
+```
+my_namespace
+|____main
+ |test_image
+ |test_panel
+ |test_label
+```
+
+* 关于控件的适配问题，固定大小像素能在屏幕像素发生变化时保持形状大小不变，而百分比则能够保持与屏幕分辨率一致的比例，可能导致控件变形。
+
+
+### 特殊情况下的根节点路径变化
+
+一般地，在使用UI API时，对某控件进行操作时我们需要通过传入该控件相对于展示screen的相对路径来对控件实例进行操作，例如如下UI界面结构
+
+```
+my_namespace
+| main
+ | panel0
+ | text0
+```
+
+text0的路径为
+
+```
+path = "/panel0/text0"
+```
+
+但是当展示screen为了使用原生的功能而继承了common.base_screen时，部分功能的生效会伴随着根节点路径的修改，因此在使用UI API时控件的路径都发生了变化。
+
+#### 适配异形屏
+
+为了适配异形屏，我们可以展示screen中的内容通过引用的形式写在screen的$screen_content属性中。
+
+```json
+ "main@common.base_screen" : {
+ "$screen_content":"myUIName.panel0"
+ },
+ "panel0":{
+ "controls" : [
+ {
+ "text0@myUIName.text0" : {}
+ }
+ ],
+ "type" : "panel"
+ },
+ "text0" : {
+ "text" : "Hello World!",
+ "type" : "label",
+ "visible" : true
+ }
+```
+
+被$screen_content引用的内容，其显示内容的范围不会被异形屏遮挡。此时text0的路径为
+
+```
+base_path = "/variables_button_mappings_and_controls/safezone_screen_matrix/inner_matrix/safezone_screen_panel/root_screen_panel"
+path = base_path + "/text0"
+```
+
+可见控件的路径相对于展示screen的相对路径前还需要加上base_path路径才能正确拿到对应text0控件的路径，有关text0的api才会生效。
+
+## 控件介绍
+
+### screen
+
+screen，即画布控件，是游戏中一个UI界面的根节点，所有其他控件只有挂在画布下才能被正确显示出来。
+
+```json
+"main1" : {
+ "absorbs_input" : true,
+ "always_accepts_input" : false,
+ "controls" : [
+ {
+ "label0@test.label0" : {}
+ }
+ ],
+ "force_render_below" : false,
+ "is_showing_menu" : true,
+ "render_game_behind" : true,
+ "render_only_when_topmost" : true,
+ "should_steal_mouse" : false,
+ "type" : "screen"
+ },
+ "main2@common.base_screen" : {
+ "$screen_content" : "test.netease_editor_root_panel_base_screen0",
+ "absorbs_input" : true,
+ "always_accepts_input" : false,
+ "force_render_below" : false,
+ "is_showing_menu" : true,
+ "render_game_behind" : true,
+ "render_only_when_topmost" : true,
+ "should_steal_mouse" : false
+ },
+ "netease_editor_root_panel_base_screen0" : {
+ "anchor_from" : "top_left",
+ "anchor_to" : "top_left",
+ "controls" : [
+ {
+ "label1@test.label1" : {}
+ }
+ ],
+ "layer" : 1,
+ "offset" : [ 0, 0 ],
+ "size" : [ "100%", "100%" ],
+ "type" : "panel",
+ "visible" : true
+ }
+```
+
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| type | 当前控件类型 |
+| absorbs_input | 是否阻挡输入，默认值为true，置false时方向键生效 |
+| always_accepts_input | 是否始终接受鼠标事件，默认值为false，置true时该界面不在堆栈顶部也可以接受事件 |
+| force_render_below | 是否渲染下方的界面，默认值为false，置true时被该界面覆盖的界面也会被渲染 |
+| is_showing_menu | 是否是非常驻UI界面，默认为true，置false时该界面不会影响hud_screen的渲染 |
+| render_game_behind | 是否在该界面创建时依然渲染游戏，默认值为true，置false时该界面创建时游戏界面定格 |
+| render_only_when_topmost | 是否仅在堆栈顶部时渲染，默认值为true，置false时即使该界面被其他界面覆盖也会被渲染 |
+| should_steal_mouse | 是否隐藏鼠标，默认值为false，置true时该界面被创建时将不会出现鼠标 |
+|gamepad_cursor_deflection_mode| 是否开启手柄光标偏转模式，默认值为false，主要用于手柄适配[轮盘控件](#selectionwheel)
+| $screen_content | 当该画布继承自common.base_screen时生效，会将该属性对应的控件作为该画布的内容显示，该内容将会适配异形屏 |
+
+* 注
+
+always_accepts_input，force_render_below， render_game_behind， render_only_when_topmost属性仅在调用PushScreen接口创建UI时才会正常生效。
+
+absorbs_input暂时无法生效，等待后续修复。
+
+下图为UI编辑器中画布属性编辑面板
+
+
+
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| 始终支持按键 | 对应always_accepts_input字段 |
+| 创建时运行游戏 | 对应render_game_behind字段 |
+| 强制持续渲染 | 对应force_render_below字段 |
+| 仅在顶层渲染 | 对应render_only_when_topmost字段 |
+| 继承基类画布 | 是否继承基类控件，若勾选，UI编辑器会自动创建一个不可见的，以netease_editor_root_panel开头的panel，并将该画布的内容放置在该panel下，并将$screen_content属性代表的控件指向该panel。继承基类控件后，画布内容将会适配异形屏。 |
+
+### 通用属性
+
+通用属性是每个控件都支持编辑的属性，对每个控件的位置、大小等基本属性进行设置。
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| anchor_from | 挂接在父节点锚点的位置，取值范围["top_left", "top_middle", "top_right", "left_middle", "center", "right_middle", "bottom_left", "bottom_middle", "bottom_right"] |
+| anchor_to | 自身挂接锚点的位置，取值同anchor_from |
+| layer | 当前控件相对父节点的层级，最终显示层级取决于父节点到该节点的layer之和 |
+| offset | 自身相对父节点的偏移，值为百分比+像素(1个像素等于屏幕上3个像素) |
+| size | 相对父节点的大小，取值同offset |
+| max_size | 最大尺寸，取值同offset。当该控件尺寸可变时，最大不能超过该属性配置的尺寸 |
+| min_size | 最小尺寸，取值同offset。当该控件尺寸可变时，最小不能小于该属性配置的尺寸 |
+| clips_children | 裁剪子控件，取值bool值，开启后该控件范围外的子控件将不会被渲染 |
+| clip_offset | 裁剪偏移，取值[x,y]。当开启裁剪子控件后，用来调整裁剪范围的偏移 |
+| alpha | 透明度，取值0-1.0。调整控件的透明度 |
+| propagate_alpha | 透明度传递，取值bool。该控件的透明度是否会影响子控件 |
+| enable | 是否可交互，取值bool。关闭该属性后按钮等控件变得不可交互 |
+| type | 当前控件类型 |
+| visible | 默认是否显示，true为显示，false为不显示 |
+
+下图为UI编辑器中控件的通用属性编辑面板
+
+
+
+| 变量
| 解释 |
+| :-----------------: | ----------------------------------------------------------- |
+| 锚点 | 左右两侧的按钮组分别代表anchor_from字段和anchor_to字段的值，从左到右从上到下依次代表取值范围中["top_left", "top_middle", "top_right", "left_middle", "center", "right_middle", "bottom_left", "bottom_middle", "bottom_right"]的其中一个 |
+| 名称 | 改变控件的名称，只接受字母、数字、下划线的组合|
+| 隐藏控件 | 对应visible字段，设置visible属性会实时的反映在UI编辑器左侧的控件结构窗口里 |
+| 层级 | 对应layer字段， 当UI编辑器关闭自动层级调整功能时，该属性会在属性窗口中出现。该属性仅支持正整数。 |
+| 位移X |对应offset字段的第一个数据，用于控制该控件相对于锚点位置的偏移。位移的形式为%+Px，Px表示像素，%表示百分比跟随，以位移X为例，跟随有["无", "父控件尺寸X", "最大兄弟控件尺寸X", "子控件尺寸X", "最大子控件尺寸X", "尺寸Y"]选项。详情见**注**。点击"PX"和"%"按钮将实现百分比跟随和像素的相互转换。|
+| 位移Y |对应offset字段的第二个数据，用于控制该控件相对于锚点位置的偏移，和位移X组成该控件的offset属性|
+| 尺寸X | 对应size字段的第一个数据，配置形式同位移，界面和位移属性基本相同，不同在“适应”属性勾选框。勾选后尺寸的宽度将适应该控件的内容，如Label控件的文本内容或图片控件的图片宽度，生成的json中尺寸样式为"default"|
+| 最大尺寸 | 对应max_size字段。|
+| 最小尺寸 | 对应min_size字段。|
+| 裁剪内容 | 对应clips_children字段。|
+| 裁剪偏移 | 对应clip_offset字段。|
+| 透明度 | 对应alpha字段。若勾选影响子控件，则会将该控件的propagate_alpha属性置True，繁殖则置False|
+| 交互 | 对应enable字段。|
+| 可被继承 | 若勾选可被继承，则该控件可以被继承控件继承使用，反之则不能被继承。勾选后，该控件会生成在json文件的最外层，和main处在同一层级，即一个命名空间下唯一，不勾选则生成在该控件父节点的controls字段中 |
+
+**注 以位移X为例的跟随选项解释**
+
+| 选项
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| 无 | 无跟随，仅Px生效，生成json中位移样式类似"100px"或100 |
+| 父控件尺寸X | 跟随父控件的宽度，生成json中位移样式类似"100%+100px" |
+| 最大兄弟控件尺寸X | 跟随其兄弟控件中控件宽度最大控件的宽度,选中后百分比将锁定为100，生成json中位移样式类似"100%sm+100px" |
+| 子控件尺寸X | 跟随子控件的宽度之和，生成json中位移样式类似"100%c+100px" |
+| 最大子控件尺寸X | 跟随其子控件中控件宽度最大控件的宽度,选中后百分比将锁定为100，生成json中位移样式类似"100%cm+100px" |
+| 尺寸Y | 跟随自身控件的高度，生成json中位移样式类似"100%y+100px" |
+
+位移Y，尺寸X， 尺寸Y类似
+
+### Label
+
+Label 是文本框控件，用来显示文本信息，默认的字体是MC字体，如果有中文会变成中文字体格式，暂时不支持换字体，可以通过接口统一设置字体，如果需要设置后续有介绍。
+```json
+ "label0" : {
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "color" : [ 1, 1, 1 ],
+ "font_scale_factor" : 1.0,
+ "font_size" : "normal",
+ "font_type" : "smooth",
+ "layer" : 1,
+ "offset" : [ 0, 0 ],
+ "shadow" : false,
+ "size" : [ 100, 100 ],
+ "text" : "Hello World!",
+ "text_alignment" : "center",
+ "line_padding" : 0.0,
+ "type" : "label",
+ "visible" : true
+ },
+```
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| color | 字体颜色（r , g, b, a）取值范围[0 , 1] |
+| font_size | 字体大小，取值["large", "normal", "small"]|
+| font_scale_factor | 字体缩放比例 |
+| shadow | MC自带的字体阴影，true为显示，false则不显示 |
+| text | 该Label显示的内容，可以通过后续的API在代码中设置该值 |
+| text_alignment | Label中文字的对齐方式，取值为["left", "center", "right"] |
+| line_padding | 行间距，可以设置每行文字之间的间距 |
+| font_type | 字体，取值["smooth", "unicode", "default", "rune"] |
+
+下图为UI编辑器中文本控件的属性编辑面板
+
+
+
+
+
+| 变量
| 解释 |
+| :------------: | ----------------------------------------------------------- |
+| 内容 | 对应text字段，支持任何形式的文本 |
+| 显示投影 | 对应shadow字段 |
+| 字体 | 对应font_type字段，可以修改文本的字体。需要注意的是当文本中出现中文时，该字体显示将强制转为unicode，该属性将不会生效。 |
+| 对齐 | 对应text_alignment字段，左中右对应["left", "center", "right"]数据 |
+| 文本颜色 | 对应color字段，点击按钮弹出颜色选择窗口，可以在调色板上取色或者使用吸管吸取界面上的颜色|
+| 字号 | 对应font_size和font_scale_factor字段，以一定的规则同时设置两个字段达到字号的效果 |
+| 行间距 | 对应line_padding字段 |
+
+**注**
+
+由于游戏的UI框架遵循[整数倍缩放](./1-界面编辑器使用说明.md#《我的世界》界面适配方法), 不同分辨率的机型，其缩放倍率和表现存在些微区别，其中文本控件受影响较大，当字体大小较小时会出现部分机型文字显示模糊的情况。经过测试，在UI编辑器中字体大小定为8及以上
+
+
+
+即属性font_size为normal，font_scale_factor为1.0及以上时
+
+
+
+该文字在任何机型上都不会模糊。当字体大小小于这个标准时，将不保证该文字在任意机型下都能清晰显示。
+
+由于格式控制符的存在，文本中尽量不要使用“%”。若一定需要显示“%”，应当在代码中输入"%%%%"方可生效。
+
+### Image
+
+Image是指图片控件，具有图片裁剪，图片九宫格，颜色叠加，uv偏移，旋转显示的额外属性。
+
+```json
+ "image0" : {
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "is_new_nine_slice" : false,
+ "layer" : 2,
+ "nine_slice_buttom" : 0,
+ "nine_slice_left" : 0,
+ "nine_slice_right" : 0,
+ "nine_slice_top" : 0,
+ "offset" : [ 0, 0 ],
+ "size" : [ 100, 100 ],
+ "texture" : "textures/netease/common/image/default",
+ "nineslice_size" : [ 0, 0, 0, 0 ],
+ "grayscale" : false,
+ "keep_ratio" : true,
+ "clip_direction" : "left",
+ "clip_ratio" : 0.0,
+ "type" : "image",
+ "uv" : [ 0, 0 ],
+ "uv_size" : [ 107, 107 ],
+ "rotate_pivot": [0.5, 0.5],
+ "rotate_angle": 0,
+ "visible" : true
+ },
+```
+
+| 变量
| 解释 |
+| :-----------------: | -------------------------------------------- |
+| texture | 贴图的路径，该路径从resouce_pack中的textures目录开始 |
+| uv | uv坐标的初始值为[0, 0]。uv坐标为[x,y]表示图片控件以所选图片左上角为原点，偏移(x,y)像素开始截取图片。 |
+| uv_size | uv尺寸表示需要显示的尺寸，默认值为图片的宽高。uv尺寸为[x,y]表示图片控件将截图x*y像素的图片范围显示在控件中。 |
+| keep_ratio | 保持宽高比。取值bool。 |
+| grayscale | 是否去色，取值bool。勾选后该图片变为黑白图片。 |
+| clip_direction | 裁剪方向，取值范围["left", "right", "up", "down", "center"] |
+| clip_ratio | 裁剪尺寸,取值范围0-1.0。0表示不裁剪，1表示完全裁剪，即该控件不渲染 |
+| is_new_nine_slice | 设置为true标记该图片开启九宫格显示的功能，与下方的nine_slice_bottom,nine_slice_left,nine_slice_right,nine_slice_top共同设置旧版九宫属性|
+| nine_slice_bottom | 切片距离下边的距离，默认值为0 |
+| nine_slice_left | 切片距离左边的距离，默认值为0 |
+| nine_slice_right | 切片距离右边的距离，默认值为0 |
+| nine_slice_top | 切片距离上边的距离，默认值为0 |
+| nineslice_size | 设置原版九宫属性，相比于旧版九宫属性更符合像素风格。当设置了旧版九宫属性时优先旧版属性。该值支持数组和单个数字，数组代表[left,top,right,down]九宫属性，单个数值代表上下左右均采用该数值作为九宫属性，当四个方向的数值均为0时表示不开启原版九宫 |
+| rotate_pivot | 旋转锚点，数值类型为[float, float]，默认值为[0.5, 0.5]，具体见下文旋转说明|
+| rotate_angle | 旋转角度，数值类型为float，默认值为0，具体见下文旋转说明|
+
+
+
+当Image控件进行旋转操作时，它是以旋转锚点为基准进行变换，而rotate_pivot是用来计算控件旋转锚点坐标的属性。旋转锚点坐标系的原点位于控件的左上角，X轴正方向向右，Y轴正方向向下（和图像坐标系一样）。rotate_pivot属性的值是一个二维向量，取值范围不限，实际的 **旋转锚点的坐标 =（控件的x坐标 + rotate_pivot[0] * 控件的宽度， 控件的y坐标 + rotate_pivot[1] * 控件的高度)**，比如(0,0)表示控件的左上角，(1,1)表示控件的右下角。
+
+这是以左上角作为旋转锚点的旋转，rotate_pivot = (0, 0)
+
+
+
+这是以右上角作为旋转锚点的旋转，rotate_pivot = (1, 0)
+
+
+
+旋转锚点不仅仅是在图片内，也可以去到图片外，需要注意的是，旋转这个变换是最后作用的变换，图片控件先是算出当前的位置大小，再根据当前的位置大小算出旋转锚点，然后再应用旋转，并且这个旋转也只是视觉上的旋转，并不是控件真实的位置发生了改变（红框才是控件本身的位置信息和大小信息）。明白这点后，我们可以用一些常见例子来完成一些复杂的效果，比如给一张旋转的图添加水平运动动画。
+
+
+
+json如下：
+
+```json
+{
+ "main" : {
+ "controls" : [
+ {
+ "panel":
+ {
+ "size": [200, 200],
+ "controls": [
+ {
+ "testImage@UIDemo.image": {}
+ }
+ ],
+ "type": "panel"
+ }
+ }
+ ],
+ "type" : "screen"
+ },
+ "image" : {
+ "layer": 3,
+ "size": [ 100, 100 ],
+ "offset": "@UIDemo.animation_in",
+ "texture": "textures/netease/common/image/default",
+ "is_new_nine_slice": false,
+ "nine_slice_buttom" : 0,
+ "nine_slice_left" : 0,
+ "nine_slice_right" : 0,
+ "nine_slice_top" : 0,
+ "nineslice_size" : [0, 0, 0, 0],
+ "type": "image"
+ },
+ "animation_in": {
+ "anim_type": "offset",
+ "duration": 1.5,
+ "from": [ -100, 0 ],
+ "to": [ 100, 0 ],
+ "next": "@UIDemo.animation_out"
+ },
+ "animation_out": {
+ "anim_type": "offset",
+ "duration": 1.5,
+ "from": [ 100, 0 ],
+ "to": [ -100, 0 ],
+ "next": "@UIDemo.animation_in"
+ },
+ "namespace" : "UIDemo"
+}
+```
+
+可以从上面看出来，根据旋转锚点做的旋转，本质上是一种自转，对应于接口 Rotate ，如果想进行的是绕着某个固定点旋转，则需要用到接口 RotateAround（和公转的概念是一致的），这两种旋转是能复合到一起的，具体如何一起使用做出稍微复杂的效果可以参考 [Demo](../20-玩法开发/13-模组SDK编程/60-Demo示例.md#UIDemoMod)，需要注意无论是哪种旋转，本质上都只是视觉上的效果，并不是实际的坐标和大小。
+
+
+下图为UI编辑器中图片控件的属性编辑面板
+
+
+
+
+
+| 变量
| 解释 |
+| :------------: | ---------------------------------------------------- |
+| 使用贴图 | 对应texture字段，将资源管理窗口中的图片资源拖曳到该图片小窗内赋值，可以在上方的下拉选项栏中重新选回默认图片 |
+| 图片适配 | 普通表示不开启九宫并保持宽高比，填充表示填满当前控件，选中旧版九宫则is_new_nine_slice置true，开启旧版九宫设置，选中原版九宫则开启原版九宫。 |
+| 去色 | 对应grayscale字段。 |
+| 裁剪方向 | 对应clip_direction字段。分别对应["从右向左裁剪","从左向右裁剪","从下向上裁剪","从上向下裁剪","从四周向中心裁剪"] |
+| 裁剪尺寸 | 对应clip_ratio字段。 |
+| uv起点 | 对应uv字段，默认为0，0 |
+| uv尺寸 | 对应uv_size字段，默认值为该texture的宽高 |
+| 旋转角度 | 对应rotate_angle字段，默认为 0|
+| 旋转锚点 | 对应rotate_pivot字段，默认为 0.5，0.5 |
+
+### Image Button
+
+Button 是按钮控件，同时含有Image和Label。按钮有三种状态，分别为default/hover/pressed，可以分别对应不同的贴图。
+
+* 注 $符号表示定义变量
+* controls表示控制的子节点，
+
+```json
+ "button0@common.button" : {
+ "$default_texture" : "textures/netease/common/button/default",
+ "$hover_texture" : "textures/netease/common/button/hover",
+ "$is_new_nine_slice" : false,
+ "$label_color" : [ 1, 1, 1 ],
+ "$label_font_scale_factor" : 1.0,
+ "$label_font_size" : "large",
+ "$label_layer" : 3,
+ "$label_offset" : [ 0, 0 ],
+ "$label_text" : "Button",
+ "$nine_slice_buttom" : 0,
+ "$nine_slice_left" : 0,
+ "$nine_slice_right" : 0,
+ "$nine_slice_top" : 0,
+ "$nineslice_size" : [ 0, 0, 0, 0 ],
+ "$pressed_button_name" : "%fpsBattle.click",
+ "$pressed_texture" : "textures/netease/common/button/pressed",
+ "$texture_layer" : 2,
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "is_handle_button_move_event" : true,
+ "button_mappings" : [],
+ "bindings" : [
+ {
+ "binding_collection_name" : "",
+ "binding_condition" : "always_when_visible",
+ "binding_type" : "collection_details"
+ }
+ ],
+ "controls" : [
+ {
+ "default@fpsBattle.default" : {}
+ },
+ {
+ "hover@fpsBattle.hover" : {}
+ },
+ {
+ "pressed@fpsBattle.pressed" : {}
+ },
+ {
+ "button_label@fpsBattle.button_label" : {}
+ }
+ ],
+ "default_control" : "default",
+ "hover_control" : "hover",
+ "layer" : 3,
+ "offset" : [ 0, 0 ],
+ "pressed_control" : "pressed",
+ "size" : [ 100, 50 ],
+ "type" : "button",
+ "visible" : true
+ },
+ "button_label" : {
+ "color" : "$label_color",
+ "font_scale_factor" : "$label_font_scale_factor",
+ "font_size" : "$label_font_size",
+ "font_type" : "smooth",
+ "layer" : "$label_layer",
+ "max_size" : [ "100%", "100%" ],
+ "offset" : [ 0, 0 ],
+ "shadow" : false,
+ "text" : "$label_text",
+ "text_alignment" : "center",
+ "type" : "label"
+ },
+ "default" : {
+ "is_new_nine_slice" : "$is_new_nine_slice",
+ "layer" : "$texture_layer",
+ "nine_slice_buttom" : "$nine_slice_buttom",
+ "nine_slice_left" : "$nine_slice_left",
+ "nine_slice_right" : "$nine_slice_right",
+ "nine_slice_top" : "$nine_slice_top",
+ "texture" : "$default_texture",
+ "type" : "image"
+ },
+ "hover" : {
+ "is_new_nine_slice" : "$is_new_nine_slice",
+ "layer" : "$texture_layer",
+ "nine_slice_buttom" : "$nine_slice_buttom",
+ "nine_slice_left" : "$nine_slice_left",
+ "nine_slice_right" : "$nine_slice_right",
+ "nine_slice_top" : "$nine_slice_top",
+ "texture" : "$hover_texture",
+ "type" : "image"
+ },
+ "pressed" : {
+ "is_new_nine_slice" : "$is_new_nine_slice",
+ "layer" : "$texture_layer",
+ "nine_slice_buttom" : "$nine_slice_buttom",
+ "nine_slice_left" : "$nine_slice_left",
+ "nine_slice_right" : "$nine_slice_right",
+ "nine_slice_top" : "$nine_slice_top",
+ "texture" : "$pressed_texture",
+ "type" : "image"
+ },
+```
+
+| 变量
| 解释 |
+| :------------------: | ---------------------------------- |
+| default | 表示按钮默认状态下的显示的图片内容 |
+| hover | 表示按钮处于悬浮状态下的图片内容 |
+| pressed | 表示按钮处于按下状态下的图片内容 |
+| $is_new_nine_slice | 设置为true标记该图片开启九宫格显示的功能,从Json结构里可以看出三张图片的九宫设置用的是同一个 |
+| $nine_slice_bottom | 切片距离下边的距离，默认值为0 |
+| $nine_slice_left | 切片距离左边的距离，默认值为0 |
+| $nine_slice_right | 切片距离右边的距离，默认值为0 |
+| $nine_slice_top | 切片距离上边的距离，默认值为0 |
+| $nineslice_size | 设置原版九宫属性，相比于旧版九宫属性更符合像素风格。当设置了旧版九宫属性时优先旧版属性。该值支持数组和单个数字，数组代表[left,top,right,down]九宫属性，单个数值代表上下左右均采用该数值作为九宫属性，当四个方向的数值均为0时表示不开启原版九宫 |
+| $pressed_button_name | fpsBattle代表编写UI逻辑的python类名，click代表按钮按下时会执行该python类的click函数。也可以使用API AddTouchEventHandler 动态注册按钮回调|
+| is_handle_button_move_event | 表示按钮是否可以响应按钮移动事件，需置true配合API AddTouchEventHandler使用 |
+| button_mappings | 表示按钮事件响应映射网，需置[]配合API AddTouchEventHandler使用 |
+
+下图为UI编辑器中按钮控件的属性编辑面板。
+
+
+
+
+
+| 变量
| 解释 |
+| :------------: | ---------------------------------------------------- |
+| 文本 | 对应button_label/text字段所引用的值，支持任何形式的文本 |
+| 文本颜色 | 对应button_label/color字段所引用的值，点击按钮弹出颜色选择窗口，可以在调色板上取色或者使用吸管吸取界面上的颜色 |
+| 字号 | 对应button_label/font_size和button_label/font_scale_factor字段，以一定的规则同时设置两个字段达到字号的效果 |
+| 文本偏移 | 对应button_label/offset字段所引用的值，设置按钮上的文字相对中心点的偏移 |
+| 使用贴图 | 分别对应default/texture,pressed/texture,hover/texture字段所引用的值，将资源管理窗口中的图片资源拖曳到该图片小窗内赋值，可以在上方的下拉选项栏中重新选回默认图 |
+| 图片适配 | 普通表示不开启九宫，选中旧版九宫则is_new_nine_slice置true，开启旧版九宫设置，选中原版九宫则开启原版九宫。 |
+### Panel
+
+panel为面板控件，主要是用来将控件进行分类和管理，类似文件夹。
+
+```json
+ "panel" : {
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "layer" : 0,
+ "offset" : [ 0, 0 ],
+ "size" : [ "50.000000%+0 px", "50.000000%+0px" ],
+ "type" : "panel",
+ "visible" : true
+ }
+```
+
+| 变量 | 解释 |
+| :--: | ---------- |
+| type | 类型为panel |
+
+面板控件暂时没有专属的属性，如有，后续在此处添加。
+
+### InputPanel
+
+input_panel与panel类似，可以用来放置其他控件，但除此之外还可以用来拖动，或实现“模态框”功能。
+
+```json
+"InputPanel" : {
+ "anchor_from" : "top_left",
+ "anchor_to" : "top_left",
+ "button_mappings": [
+ {
+ "from_button_id": "button.menu_select",
+ "to_button_id": "#netease_to_button_id",
+ "mapping_type": "pressed"
+ }
+ ],
+ "layer" : 10,
+ "modal" : true,
+ "is_swallow": true,
+ "contained": true,
+ "draggable": "both",
+ "offset" : [ 0.0, 0.0 ],
+ "size" : [ 198.0, 137.0 ],
+ "type" : "input_panel",
+ "visible" : true
+}
+```
+
+| 变量 | 默认值 | 解释 |
+| :-------------: | ------------- | ------------------------------------------------------------ |
+| modal | false | 设为true时，该InputPanel视为模态框，见**注2** |
+| is_swallow | false | 设为true时，该InputPanel的输入会吞噬事件，见**注3** |
+| draggable | not_draggable | 当前控件可拖拽方式，默认为not_draggable不可拖拽，"horizontal"代表水平拖拽，"vertical"代表垂直拖拽，"both"代表自由拖拽 |
+| contained | false | 该控件可拖动时，是否会被父控件的大小范围所限制，默认值为false，见**注4** |
+| button_mappings | [] | 该值为开启拖拽功能所必须的属性，可以理解成开启接受屏幕点击事件 |
+
+* 注1
+
+```
+该控件的拖动功能也遵循UI控件的碰撞规则，当InputPanel中有按钮、滚动列表等接受鼠标事件的控件时，点击在这些控件并不会触发InputPanel的拖动操作。
+```
+
+* 注2
+
+```
+“模态框”是指将用户的UI点击操作限制在这个控件及其子控件，而其他的控件都不会响应用户操作。
+
+如果界面上同时存在多个模态框，其中层级最高的生效。
+
+可以用来处理ScrollView控件上显示其他控件时，点击会穿透到ScrollView的问题，可参考UIDemo示例的“InputPanel演示”
+
+界面编辑器暂不支持，可先用Panel搭建后手动在json中修改属性。
+
+```
+
+* 注3
+
+```
+吞噬事件是指点击该面板时，点击事件不会穿透到世界。如破坏方块、镜头转向不会被响应。
+
+```
+
+* 注4
+
+```
+InputPanel维护着一个拖拽偏移量，它代表着在整个拖拽过程中，InputPanel相对于控件出生点坐标的偏移量，**与控件自身的offset无关**。举个例子，InputPanel经过了5次手动拖拽后位置向右移动了5像素，则拖拽偏移量的值为(5, 0)。
+
+当contained为true时，拖拽偏移量存在限制，最小不能超过(0,0)，最大不能超过父控件的大小减去InputPanel控件的大小。
+
+这也就意味着无论InputPanel是否设置了offset，由于初始拖拽偏移量为(0,0), 使控件无法负方向移动，因此需要将InputPanel放置在其父控件的左上角，或调用SetOffsetDelta接口手动设置拖拽偏移量。
+
+```
+
+### StackPanel
+
+布局面板，用于自动布局该控件的子控件
+
+```json
+"stack_panel0": {
+ "layer": 1,
+ "orientation": "horizontal",
+ "size": [100, 100],
+ "type": "stack_panel",
+ "controls": [{
+ "panel_0": {
+ "type": "panel",
+ "size": [2, 2]
+ }
+ }, {
+ "fill_0": {
+ "type": "panel",
+ "size": ["fill", 1]
+ }
+ }]
+},
+```
+
+| 变量 | 解释 |
+| :-------------: | ------------------------------------------------------------ |
+| orientation | 当前控件布局方式方式，"horizontal"代表水平排布，"vertical"代表垂直排布|
+| type | 类型为stack_panel |
+| size | 在stack_panel的子控件中，size属性支持使用"fill"字段来动态填充剩余空间。例如，若排列方式为"horizontal"，可以通过设置子控件"size":["fill",1]来让控件在横向上铺满剩余空间。 |
+
+下图为UI编辑器中布局面板控件的属性编辑面板。
+
+
+
+
+
+| 变量 | 解释 |
+| :-------------: | ------------------------------------------------------------ |
+| 排列方式 | 对应orientation字段|
+
+**注**
+
+排序的顺序和子控件的排序有关，需要手动调整。
+
+### TextEditBox
+
+TextEditBox是输入框控件，用来输入文字信息，可以获取输入内容，设置输入框内容，触发输入中和输入完成事件，设置最大输入值等。下面的示例展示了一个搜索框的信息。
+
+```json
+ "text_edit_box0@common.text_edit_box" : {
+ "$edit_box_default_texture" : "textures/ui/edit_box_indent",
+ "$edit_box_hover_texture" : "textures/ui/edit_box_indent_hover",
+ "$font_size" : "normal",
+ "$is_new_nine_slice" : false,
+ "$nine_slice_buttom" : 0,
+ "$nine_slice_left" : 0,
+ "$nine_slice_right" : 0,
+ "$nine_slice_top" : 0,
+ "$nineslice_size" : [ 0, 0, 0, 0 ],
+ "$place_holder_text" : "请输入内容",
+ "$place_holder_text_color" : [ 0.50, 0.50, 0.50 ],
+ "$text_background_default" : "fpsBattle.edit_box_background_default",
+ "$text_background_hover" : "fpsBattle.edit_box_background_hover",
+ "$text_box_name" : "%fpsBattle.message_text_box",
+ "$text_box_text_color" : [ 1, 1, 1 ],
+ "$text_edit_box_content_binding_name" : "#fpsBattle.message_text_box_content",
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "enabled_newline" : false,
+ "layer" : 5,
+ "max_length" : 512,
+ "offset" : [ 0, 0 ],
+ "size" : [ 300, 27 ],
+ "type" : "edit_box",
+ "visible" : true
+ },
+ "edit_box_background_default" : {
+ "is_new_nine_slice" : "$is_new_nine_slice",
+ "nine_slice_buttom" : "$nine_slice_buttom",
+ "nine_slice_left" : "$nine_slice_left",
+ "nine_slice_right" : "$nine_slice_right",
+ "nine_slice_top" : "$nine_slice_top",
+ "texture" : "$edit_box_default_texture",
+ "type" : "image"
+ },
+ "edit_box_background_hover" : {
+ "is_new_nine_slice" : "$is_new_nine_slice",
+ "nine_slice_buttom" : "$nine_slice_buttom",
+ "nine_slice_left" : "$nine_slice_left",
+ "nine_slice_right" : "$nine_slice_right",
+ "nine_slice_top" : "$nine_slice_top",
+ "texture" : "$edit_box_hover_texture",
+ "type" : "image"
+ },
+```
+
+| 变量
| 解释 |
+| :----------------------------------------------------------: | ----------------------------------------------------------- |
+|max_length | 初始最大输入长度，后续可代码设置 |
+| $text_box_name | 获取输入到的信息，监听了BF_EditChanged和BF_EditFinished的函数Textbox，会在输入框内容修改和输入完成时调到该函数，可参考下面的**注1** |
+|$text_edit_box_content_binding_name | 输入框显示ReturnTextString中返回的内容，这与上面形成了一个双向绑定，可参考下面的**注1** |
+| $place_holder_text | 输入框初始化没有输入时的提示语 |
+| $is_new_nine_slice | 设置为true标记该图片开启九宫格显示的功能,从Json结构里可以看出两张图片的九宫设置用的是同一个 |
+| $nine_slice_bottom | 切片距离下边的距离，默认值为0 |
+| $nine_slice_left | 切片距离左边的距离，默认值为0 |
+| $nine_slice_right | 切片距离右边的距离，默认值为0 |
+| $nine_slice_top | 切片距离上边的距离，默认值为0 |
+| $nineslice_size | 设置原版九宫属性，相比于旧版九宫属性更符合像素风格。当设置了旧版九宫属性时优先旧版属性。该值支持数组和单个数字，数组代表[left,top,right,down]九宫属性，单个数值代表上下左右均采用该数值作为九宫属性，当四个方向的数值均为0时表示不开启原版九宫 |
+
+* 注1
+
+```python
+class TestScreen(ScreenNode):
+ def __init__(self, namespace, name, param):
+ ScreenNode.__init__(self, namespace, name, param)
+ self.text = ""
+ self.holder = str("请输入姓名")
+
+ @ViewBinder.binding(ViewBinder.BF_EditChanged | ViewBinder.BF_EditFinished)
+ def TextBox(self, args):
+ print "SearchTextBox ", args
+ self.text = args["Text"]
+ return ViewRequest.Refresh
+
+ @ViewBinder.binding(ViewBinder.BF_BindString)
+ def ReturnTextString(self):
+ return self.text
+
+```
+
+* 注2
+
+max_length 可以通过接口SetEditTextMaxLength，接口详细调用可见下文。
+
+注意：输入框推荐在创建UI的isHud为0的情况下使用，如：
+
+clientApi.CreateUI("testMod", "testUI", {**"isHud":0**})
+
+因为在安卓机器上，当isHud为1时，选中文本输入框后单指无法取消选中，需要双指点击屏幕取消选中，如下图：
+
+
+
+PC和IOS平台没有这个问题
+
+下图为UI编辑器中文本输入框控件的属性编辑面板。
+
+
+
+
+
+| 变量
| 解释 |
+| :------------: | ---------------------------------------------------- |
+| 提示文字 | 对应$place_holder_text字段，代表没有文本输入时底部显示 |
+| 提示文字颜色 | 对应$place_holder_text_color字段，代表提示文字的颜色，点击按钮弹出颜色选择窗口，可以在调色板上取色或者使用吸管吸取界面上的颜色 |
+| 输入文本颜色 | 对应$text_box_text_color字段，代表输入文本的颜色 |
+| 绑定输入框交互 | 对应$text_box_name字段 |
+| 绑定输入框内容 | 对应$text_edit_box_content_binding_name字段 |
+| 提示文字字号 | 对应$font_size字段，可供选择的有["small","middle","large"],对应值[4，8，16]|
+| 文字最大长度 | 对应max_length字段，即代表可输入文本的最大长度 |
+| 使用贴图 | 分别对应$edit_box_default_texture控件默认状态,$edit_box_hover_texture控件鼠标悬浮状态字段所引用的值，将资源管理窗口中的图片资源拖曳到该图片小窗内赋值，可以在上方的下拉选项栏中重新选回默认 |
+| 图片适配 | 普通表示不开启九宫，选中旧版九宫则is_new_nine_slice置true，开启旧版九宫设置，选中原版九宫则开启原版九宫。 |
+
+### PaperDoll
+
+该控件可以用于在ui上显示骨骼模型
+
+```json
+"paper_doll0" : {
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "animation" : "",
+ "animation_looped": true,
+ "layer" : 7,
+ "modelname" : "",
+ "modelsize" : 1.0,
+ "offset" : [ 0, 0 ],
+ "renderer" : "paper_doll_renderer",
+ "size" : [ 100, 100 ],
+ "type" : "custom",
+ "visible" : true,
+ "enable_scissor_test" : false,
+ },
+```
+| 变量
| 解释 |
+| :----------: | ----------------------------------------------------------- |
+| modelname | 要显示的骨骼模型的名称，可通过API中的SetUiModel接口动态修改 |
+| animation | 骨骼模型播放的动作，可通过API中的SetUiModel接口动态修改 |
+| animation_looped | 骨骼模型播放动作是否循环播放，可通过API中的SetUiModel接口动态修改 |
+| modelsize | 骨骼模型的显示缩放 |
+| renderer | 对纸娃娃控件自定义的渲染模块，不建议改动该字段 |
+| enable_scissor_test | 超出父控件区域后是否裁剪，默认为false, 该属性需要父控件开启clips_children属性才能生效，[RenderPaperDoll](https://wiki.bedrock.dev/json-ui/json-ui-documentation.html)|
+
+下图为UI编辑器中纸娃娃控件的属性编辑面板。
+
+
+
+
+
+| 变量
| 解释 |
+| :------------: | ---------------------------------------------------- |
+| 模型类型 | 可选原版模型和FBX模型，FBX模型可通过资源管理器界面导入。选中FBX模型时显示模型名称选项，可选导入的FBX模型。选中原版模型时默认modelname使用steve |
+| 模型名称 | 对应modelname字段 |
+| 模型缩放 | 对应modelsize字段，支持0-100的正整数 |
+
+### NeteasePaperDoll
+
+该控件可以用于在ui上显示：
+
+1）生物，包括玩家与普通生物；
+
+2）骨骼模型展示；
+
+3）生物类型原版模型展示。
+
+```json
+"paper_doll0" : {
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "layer" : 22,
+ "offset" : [ 0.0, 0.0 ],
+ "renderer" : "netease_paper_doll_renderer",
+ "init_rot_y": 60.0,
+ "rotation": "gesture_x",
+ "screen_scale": 1.0,
+ "size" : [ 100, 100 ],
+ "type" : "custom",
+ "visible" : true,
+ "enable_scissor_test" : false,
+}
+```
+
+相关字段说明：
+
+| 变量
| 解释 |
+| :---------------------------------: | ------------------------------------------------------------ |
+| renderer | 不能改动该字段 |
+| rotation | 渲染模型的朝向，可选的值有：none：默认值，没有任何旋转角度
auto：随着时间而旋转
gesture_x：可以通过触控以Y轴旋转, 但需要InputPanel控件配合生效。详情请参考UIDemoMod中的纸娃娃演示示例
freedom_gesture：可以自主选择绕xyz轴旋转, 但需要InputPanel控件配合生效。详情请参考官网Mod 中的NeteasePaperDollDemoMod
| +| init_rot_y | 初始朝向（Y轴为旋转轴），单位：角度，[RenderPaperDoll](./40-UIAPI文档.md#renderpaperdoll)参数init_rot_y动态设置 | +| screen_scale | 放缩系数，默认为1，基于UI的size进行放缩，[RenderPaperDoll](./40-UIAPI文档.md#renderpaperdoll)参数scale动态设置 | +| skeleton_model_name | 骨骼模型名称，默认为空字符，[RenderPaperDoll](./40-UIAPI文档.md#renderpaperdoll)参数skeleton_model_name动态设置 | +| animation | 骨骼模型动画名称，默认为idle，[RenderPaperDoll](./40-UIAPI文档.md#renderpaperdoll)参数animation动态设置 | +| animation_looped | 骨骼动画是否循环播放，默认为true，[RenderPaperDoll](./40-UIAPI文档.md#renderpaperdoll)参数animation_looped动态设置 | +| entity_identifier | 生物标识，如minecraft:cat，默认为空字符，[RenderPaperDoll](./40-UIAPI文档.md#renderpaperdoll)参数entity_identifier动态设置 | +| enable_scissor_test | 超出父控件区域后是否裁剪，默认为false, 该属性需要父控件开启clips_children属性才能生效，[RenderPaperDoll](https://wiki.bedrock.dev/json-ui/json-ui-documentation.html)| + +**接口使用例子以及说明：** + +1）渲染玩家或者生物，包括玩家的装备等物品的渲染 + +```python +path = '/demoPanel/dollPanel/viewer_panel/paper_doll_panel/paper_doll' +param = { + "entity_id": "-8589934591", # 玩家或生物Id + "scale": 0.5, # 放缩系数 + "render_depth": -50, # 渲染深度，对于玩家默认-50，普通生物-15，该参数可解决UI遮挡剔除问题 + "init_rot_y": 60, # 初始朝向 + "molang_dict": {"variable.liedownamount": 1} # molang变量dict，其中key为字符串，value为float类型 +} +uiNode.RenderPaperDoll(path, param) +``` + +2）渲染骨骼模型 + +```python +path = '/demoPanel/dollPanel/viewer_panel/paper_doll_panel/paper_doll' +param = { + "skeleton_model_name": "datiangou", # 大天狗模型 + "scale": 1.0, + "animation": "fengxi", # 动画名称 + "animation_looped": False, # 是否循环播放 +} +uiNode.RenderPaperDoll(path, param) +``` + +3）渲染原版生物模型（不需要生物实例） + +```python +path = '/demoPanel/dollPanel/viewer_panel/paper_doll_panel/paper_doll' +param = { + "scale": 1.0, + "entity_identifier": "minecraft:cat", # 渲染猫的原版模型 + "init_rot_y": 60, + "molang_dict": {"variable.state": 2, "variable.liedownamount": 1} # 通过molang变量来调整渲染效果（坐下的猫） +} +uiNode.RenderPaperDoll(path, param) +``` + +使用注意事项： + +1）如果渲染位置不正确，请调整UI的位置； + +2）如果渲染模型过大或者过小，请调整UI的大小或者参数scale； + +3）如果生物模型被裁剪，请调整参数render_depth或者UI的layer； + +4）可以通过使用参数molang_dict来驱动原版模型的渲染，如果发生如下图的渲染错误，需要自行调整molang表达式； + +
+
+
+### ItemRenderer
+
+该控件可以用于在ui上显示物品
+
+```json
+"item_renderer0" : {
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "layer" : 1,
+ "offset" : [ 0, 0 ],
+ "property_bag" : {
+ "#item_id_aux" : 131072
+ },
+ "renderer" : "inventory_item_renderer",
+ "size" : [ 100, 100 ],
+ "type" : "custom",
+ "visible" : true
+ },
+```
+| 变量
| 解释 |
+| :----------: | ----------------------------------------------------------- |
+| renderer | 对显示物品自定义的渲染模块，不建议改动该字段 |
+| property_bag | 控件属性信息，#item_id_aux代表物品id，131072代表草方块在游戏内的值 |
+
+下图为ItemRenderer在UI编辑器中的控件表现
+
+
+
+
+
+
+
+| 变量
| 解释 |
+| :------------: | ---------------------------------------------------- |
+| 道具类型 | 可选原版道具和自定义道具，自定义道具可在关卡编辑器中设置。选中自定义道具时显示道具ID和附加值输入栏，可输入自定的道具ID和附加值。选中原版道具时隐藏道具ID和附加值输入栏，显示道具材质，点击弹出道具材质选择窗口 |
+| 道具材质 | 点击弹出道具材质选择窗口，展示所有原版道具图片，选中后编辑器自动设置该道具对应的道具ID和附加值 |
+| 道具ID和附加值 | 填写设置自定义道具时设置的道具ID和附加值 |
+| 附魔效果 | 勾选后道具表现出现附魔流光效果 |
+
+* 注
+
+道具在游戏中的物品id会根据游戏运行平台、加载Mod数量、游戏大版本等不同会发生变化，因此UI编辑器的ItemRenderer控件静态保存在json中的数据，在游戏中并不一定能正确显示，建议使用UIAPI-SetUiItem来对该控件进行动态设置，详见《UIAPI文档》。
+
+原版道具显示正常。
+
+### ScrollView
+
+该控件是可以滑动的窗口，需要有其他控件附属。
+
+```json
+ "scroll_view0@common.scrolling_panel" : {
+ "$background_nine_slice_buttom" : 0,
+ "$background_nine_slice_left" : 0,
+ "$background_nine_slice_right" : 0,
+ "$background_nine_slice_top" : 0,
+ "$background_nineslice_size" : [ 0, 0, 0, 0 ],
+ "$box_nine_slice_buttom" : 0,
+ "$box_nine_slice_left" : 0,
+ "$box_nine_slice_right" : 0,
+ "$box_nine_slice_top" : 0,
+ "$box_nineslice_size" : [ 0, 0, 0, 0 ],
+ "$is_background_nine_slice" : false,
+ "$is_box_nine_slice" : false,
+ "$is_track_nine_slice" : false,
+ "$scroll_background_image_control" : "fpsBattle.scroll_background_image",
+ "$scroll_background_texture" : "textures/ui/ScrollRail",
+ "$scroll_box_mouse_image_control" : "fpsBattle.scroll_box_image",
+ "$scroll_box_texture" : "textures/ui/newTouchScrollBox",
+ "$scroll_box_touch_image_control" : "fpsBattle.scroll_box_image",
+ "$scroll_track_image_control" : "fpsBattle.scroll_track_image",
+ "$scroll_track_texture" : "textures/ui/ScrollRail",
+ "$scrolling_content" : "fpsBattle.image",
+ "$show_background" : true,
+ "$track_nine_slice_buttom" : 0,
+ "$track_nine_slice_left" : 0,
+ "$track_nine_slice_right" : 0,
+ "$track_nine_slice_top" : 0,
+ "$track_nineslice_size" : [ 0, 0, 0, 0 ],
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "layer" : 9,
+ "offset" : [ 0, 0 ],
+ "size" : [ 100, 80 ],
+ "type" : "scroll_view",
+ "visible" : true
+ },
+```
+
+|变量
| 解释 |
+| ------------------------------ | ----------------------------------------------- |
+| scrolling_content | 这里保存了该滑动窗口的内容 |
+| show_background | 是否显示背景 |
+| $is_background_nine_slice | 设置为true标记背景图片开启九宫格显示的功能 |
+| $background_nine_slice_buttom | 切片距离下边的距离，默认值为0 |
+| $background_nine_slice_left | 切片距离左边的距离，默认值为0 |
+| $background_nine_slice_right | 切片距离右边的距离，默认值为0 |
+| $background_nine_slice_top | 切片距离上边的距离，默认值为0 |
+| $background_nineslice_size | 设置原版九宫属性，相比于旧版九宫属性更符合像素风格。当设置了旧版九宫属性时优先旧版属性。该值支持数组和单个数字，数组代表[left,top,right,down]九宫属性，单个数值代表上下左右均采用该数值作为九宫属性，当四个方向的数值均为0时表示不开启原版九宫 |
+| $is_box_nine_slice | 设置为true标记滑动块图片开启九宫格显示的功能 |
+| $box_nine_slice_buttom | 切片距离下边的距离，默认值为0 |
+| $box_nine_slice_left | 切片距离左边的距离，默认值为0 |
+| $box_nine_slice_right | 切片距离右边的距离，默认值为0 |
+| $box_nine_slice_top | 切片距离上边的距离，默认值为0 |
+| $box_nineslice_size | 设置原版九宫属性，相比于旧版九宫属性更符合像素风格。 |
+| $is_track_nine_slice | 设置为true标记滑轨图片开启九宫格显示的功能 |
+| $track_nine_slice_buttom | 切片距离下边的距离，默认值为0 |
+| $track_nine_slice_left | 切片距离左边的距离，默认值为0 |
+| $track_nine_slice_right | 切片距离右边的距离，默认值为0 |
+| $track_nine_slice_top | 切片距离上边的距离，默认值为0 |
+| $track_nineslice_size | 设置原版九宫属性，相比于旧版九宫属性更符合像素风格。 |
+| $scroll_background_texture | 滚动列表背景图片 |
+| $scroll_box_texture | 滑动块图片 |
+| $scroll_track_texture | 滑轨图片 |
+
+下图为UI编辑器中滚动列表控件的属性编辑面板。
+
+
+
+
+
+
+
+| 变量
| 解释 |
+| :------------: | ---------------------------------------------------- |
+| 滚动列表-内容 | 对应$scrolling_content字段，只接受其他screen画布中的控件，且被选中控件不可以是文本、图片、滚动列表控件，若被选中控件为panel，那么子节点中含有滚动列表的panel控件同样不可以被选中 |
+| 滚动列表-隐藏背景 | 对应show_background字段 |
+| 滚动列表-使用贴图 | 对应$scroll_background_texture字段，将资源管理窗口中的图片资源拖曳到该图片小窗内赋值，可以在上方的下拉选项栏中重新选回默认图片 |
+| 滚动列表-图片适配 | 普通表示不开启九宫，选中旧版九宫则is_new_nine_slice置true，开启旧版九宫设置，选中原版九宫则开启原版九宫。 |
+| 滚动条滑块-使用贴图 | 对应$scroll_box_texture字段，将资源管理窗口中的图片资源拖曳到该图片小窗内赋值，可以在上方的下拉选项栏中重新选回默认图片 |
+| 滚动条滑块-图片适配 | 普通表示不开启九宫，选中旧版九宫则is_new_nine_slice置true，开启旧版九宫设置，选中原版九宫则开启原版九宫。 |
+| 滚动条背景-使用贴图 | 对应$scroll_track_texture字段，将资源管理窗口中的图片资源拖曳到该图片小窗内赋值，可以在上方的下拉选项栏中重新选回默认图片 |
+| 滚动条背景-图片适配 | 普通表示不开启九宫，选中旧版九宫则is_new_nine_slice置true，开启旧版九宫设置，选中原版九宫则开启原版九宫。 |
+
+滚动列表的内容以scrolling_content为引用可以由我们自定义，但是承载scrolling_content的父控件scrolling_view_port的size如不经修改默认为["100%","100%"]，即与我们的滚动列表定的大小相同，而可滚动区域的判定会取scrolling_content的size和其父控件scrolling_view_port作比较，两者大小之差即为可拖动范围。而我们UI控件的size是不会根据其子控件的size做到动态完全覆盖，因此如果我们的scrolling_content的大小是动态变化的，需要我们在代码中手动设置scrolling_content的size,详见UI-API[SetSize](./40-UIAPI文档.md#SetSize)
+
+而对于scrolling_content的绝对路径，一共有以下两种，可以通过UI-API[GetAllChildrenPath](./40-UIAPI文档.md#GetAllChildrenPath)清楚的看到。
+
+```python
+scroll_view_path = "/scroll_view0"
+touch_path = scroll_view_path + "/scroll_touch/scroll_view/panel/background_and_viewport/scrolling_view_port/scrolling_content"
+mouse_path = scroll_view_path + "/scroll_mouse/scroll_view/stack_panel/background_and_viewport/scrolling_view_port/scrolling_content"
+```
+
+我们知道在PC端进行游戏时，按F11可以切换鼠标控制和遥感控制两种操作模式，而在手机端进行游戏时只有遥感控制这一种操作模式。不同的操作模式，scroll_view的scrolling_content会生成在不同的路径下，遥感模式使用touch_path获得scrolling_content的绝对路径，而鼠标控制使用mouse_path获得。
+
+### Grid
+
+Grid组件属于网格型的排列，可以依附在滚动条中，用来实现背包等功能。
+
+```json
+ "grid0" : {
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "collection_name" : "test_grid",
+ "grid_dimensions" : [ 2, 2 ],
+ "grid_item_template" : "fpsBattle.netease_editor_template_image",
+ "grid_rescaling_type" : "none",
+ "maximum_grid_items" : 0,
+ "layer" : 1,
+ "offset" : [ 0, 0 ],
+ "size" : [ 200, 200 ],
+ "type" : "grid",
+ "visible" : true
+ },
+ "netease_editor_template_image" : {
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "layer" : 1,
+ "offset" : [ 0, 0 ],
+ "size" : [ "50%", "50%" ],
+ "texture" : "textures/netease/common/image/default",
+ "type" : "image",
+ "uv" : [ 0, 0 ],
+ "uv_size" : [ 107, 107 ],
+ "visible" : true
+ },
+```
+
+| 变量
| 解释 |
+| ----------------------------------------------------------- | ---------------------- |
+|grid_rescaling_type | 网格调节方式，目前可取值范围["none","horizontal"]，当取值none是grid_dimensions生效，取值horizontal时maximum_grid_items生效|
+|maximum_grid_items | 最大格子数量|
+| grid_dimensions | 初始值大小2X2 |
+|grid_item_template | 被当作生成网格单元的控件模板|
+
+下图为UI编辑器中网格控件的属性编辑面板。
+
+
+
+
+
+
+
+|变量
| 解释 |
+| :------------: | ---------------------------------------------------- |
+| 集合名 | 对应collection_name字段 |
+| 内容 | 对应grid_item_template字段，只接受其他screen画布中的控件，且被选中控件不可以是滚动列表、网格控件，若被选中控件为panel，那么子节点中含有滚动列表、网格的panel控件同样不可以被选中 |
+| 网格调节方式 | 对应grid_rescaling_type字段,配置网格模式时，格子固定生成m * n个格子；配置水平模式时，格子按网格最大数量水平连续生成若干格子，一般搭配控件尺寸Y勾选"适应"使用 |
+| 网格规模 | 对应grid_dimensions字段 |
+| 网格最大数量 | 对应maximum_grid_items字段 |
+
+**注：**
+
+1. grid是在renderer渲染的时候才创建，所以只要没有显示过该界面，调用GetChildrenName和GetAllChildrenPath都无法获取到grid的子节点信息。如果要初始化grid的信息必须在UI渲染结束后一帧再来调用这两个接口获取子节点信息并初始化
+
+2. 当grid控件与ScrollView一起使用时，如果grid控件中设置单个UI元素（例如按钮）的数目值超过当前grid控件显示的最大数目时，需要配合scrollview一同使用。当scrollview拉动时，由于MC内置逻辑实现方式，grid控件会将没有渲染必要的格子剔除并缓存以节约渲染成本，并在其恢复渲染必要时添加回grid的子节点列表中。在这一过程中，每个UI元素都不一定会在其原本的位置，从而导致内容错位。此时需要开发者监听**GridComponentSizeChangedClientEvent**事件，当收到事件后，需要通过**GetAllChildrenPath**接口获取grid中返回的所有UI元素的路径值，这些路径值尾部包含该UI元素在grid中的索引数目。依据索引数目，mod开发者将物品背包或者类似的显示所需的UI信息值依次设置到grid中的子元素中。建议开发者采用MVC模式控制grid中的内容显示：M代表需要显示的数据信息容器，V代表grid容器和容器中包含的子UI控件，C代表控制组装的UI元素的函数或者模块，并由初始化和监听**GridComponentSizeChangedClientEvent**事件触发驱动。详情请参考UIDemoMod中的滚动列表演示示例。
+
+3. grid控件不建议使用其子控件路径对其动态生成的格子控件直接进行SetVisible等操作，因为在每次界面刷新时grid控件会对所有的格子做一次数据更新，更新的过程中会强制将格子可见性置True。如果有需要对格子进行操作，可以使用数据绑定的方式，如下代码和json。需要注意的是在数据绑定的回调函数中需要明确grid本身是否可见，否则会造成grid子节点控件的可见性数据异常，从而影响界面操作逻辑。
+
+```json
+ "grid1" : {
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "collection_name" : "gridDemo",
+ "grid_dimensions" : [ 2, 2 ],
+ "grid_item_template" : "UIDemo.scrollviewBtn0",
+ "layer" : 39,
+ "offset" : [ 0, 0 ],
+ "size" : [ 200, 200 ],
+ "type" : "grid",
+ "visible" : true
+ },
+ "scrollviewBtn0@UIDemo.scrollviewBtn": {
+ "bindings" : [
+ {
+ "binding_collection_name" : "gridDemo",
+ "binding_condition" : "always",
+ "binding_name" : "#UIDemo.visible",
+ "binding_name_override" : "#visible",
+ "binding_type" : "collection"
+ }
+ ],
+ "visible" : "#UIDemo.visible"
+ },
+```
+
+```python
+class UIDemoScreen(ScreenNode):
+ def __init__(self, namespace, name, param):
+ self.demoGridControl = None
+ ......
+
+ def Create(self):
+ self.demoGridControl = self.GetBaseUIControl("/grid1")
+ ......
+
+ @ViewBinder.binding_collection(ViewBinder.BF_BindBool, "gridDemo", "#UIDemo.visible")
+ def GridItemVisible(self, index):
+ return index < self.showNum and self.demoGridControl.GetVisible()
+```
+
+可以看到grid格子的visible属性我们以"#UIDemo.visible"设置，而该字段经由bindings字段的设置取代了系统变量#visible，再在python代码中绑定了"#UIDemo.visible"字段的函数更新回调。因此每个格子的visible属性就会读取python函数的返回值进行动态的设置。有关于数据绑定详情可见[UI绑定和返回](#UI绑定和返回)
+
+### ProgressBar
+
+ProgressBar进度条控件，用于百分比显示进度
+```json
+ "progress_bar0" : {
+ "$clip_direction" : "left",
+ "$clip_ratio" : 0.0,
+ "$is_new_nine_slice" : false,
+ "$nine_slice_buttom" : 0,
+ "$nine_slice_left" : 0,
+ "$nine_slice_right" : 0,
+ "$nine_slice_top" : 0,
+ "$nineslice_size" : [ 0, 0, 0, 0 ],
+ "$progress_bar_empty_texture" : "textures/ui/empty_progress_bar",
+ "$progress_bar_filled_texture" : "textures/ui/filled_progress_bar",
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "controls" : [
+ {
+ "empty_progress_bar@fpsBattle.empty_progress_bar" : {}
+ },
+ {
+ "filled_progress_bar@fpsBattle.filled_progress_bar" : {}
+ }
+ ],
+ "layer" : 8,
+ "offset" : [ 0, 0 ],
+ "size" : [ 100, 10 ],
+ "type" : "panel",
+ "visible" : true
+ },
+ "empty_progress_bar" : {
+ "is_new_nine_slice" : "$is_new_nine_slice",
+ "layer" : 1,
+ "nine_slice_buttom" : "$nine_slice_buttom",
+ "nine_slice_left" : "$nine_slice_left",
+ "nine_slice_right" : "$nine_slice_right",
+ "nine_slice_top" : "$nine_slice_top",
+ "texture" : "$progress_bar_empty_texture",
+ "type" : "image"
+ },
+ "filled_progress_bar" : {
+ "clip_direction" : "$clip_direction",
+ "clip_ratio" : "$clip_ratio",
+ "is_new_nine_slice" : "$is_new_nine_slice",
+ "layer" : 2,
+ "nine_slice_buttom" : "$nine_slice_buttom",
+ "nine_slice_left" : "$nine_slice_left",
+ "nine_slice_right" : "$nine_slice_right",
+ "nine_slice_top" : "$nine_slice_top",
+ "texture" : "$progress_bar_filled_texture",
+ "type" : "image"
+ },
+```
+
+| 变量
| 解释 |
+| :-----------------------------------------------------------: | ---------------------- |
+| $progress_bar_empty_texture | 进度条背景图片 |
+| $progress_bar_filled_texture | 进度条前景图片 |
+| $clip_direction | 进度条加载方向，目前支持["left", "right", "up", "down", "center"] |
+|grid_item_template | 被当作生成网格单元的控件模板|
+| $is_new_nine_slice | 设置为true标记该图片开启九宫格显示的功能,从Json结构里可以看出两张图片的九宫设置用的是同一个 |
+| $nine_slice_bottom | 切片距离下边的距离，默认值为0 |
+| $nine_slice_left | 切片距离左边的距离，默认值为0 |
+| $nine_slice_right | 切片距离右边的距离，默认值为0 |
+| $nine_slice_top | 切片距离上边的距离，默认值为0 |
+| $nineslice_size | 设置原版九宫属性，相比于旧版九宫属性更符合像素风格。当设置了旧版九宫属性时优先旧版属性。该值支持数组和单个数字，数组代表[left,top,right,down]九宫属性，单个数值代表上下左右均采用该数值作为九宫属性，当四个方向的数值均为0时表示不开启原版九宫 |
+
+下图为UI编辑器中进度条控件的属性编辑面板。
+
+
+
+
+
+| 变量
| 解释 |
+| :------------: | ---------------------------------------------------- |
+| 使用贴图 | 填充对应$progress_bar_filled_texture字段，空白对应$progress_bar_empty_texture,将资源管理窗口中的图片资源拖曳到该图片小窗内赋值，可以在上方的下拉选项栏中重新选回默认图片 |
+| 图片适配 | 普通表示不开启九宫，选中旧版九宫则is_new_nine_slice置true，开启旧版九宫设置，选中原版九宫则开启原版九宫。 |
+
+### SwitchToggle
+
+开关控件，用于两个状态之间的切换
+```json
+"switch_toggle0@common_toggles.switch_toggle_collection" : {
+ "$default_texture" : "textures/ui/toggle_off",
+ "$hover_texture" : "textures/ui/toggle_on",
+ "$pressed_no_hover_texture" : "textures/ui/toggle_on_hover",
+ "$pressed_texture" : "textures/ui/toggle_off_hover",
+ "$toggle_name" : "#fpsBattle.toggle_name",
+ "$toggle_state_binding_name" : "#fpsBattle.toggle_state",
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "bindings" : [
+ {
+ "binding_collection_name" : "",
+ "binding_condition" : "always_when_visible",
+ "binding_type" : "collection_details"
+ }
+ ],
+ "layer" : 6,
+ "offset" : [ 0, 0 ],
+ "size" : [ 100, 100 ],
+ "type" : "panel",
+ "visible" : true
+ },
+```
+
+| 变量
| 解释 |
+| :-----------------------------------------------------------: | ---------------------- |
+| $default_texture | 开关默认图片 |
+| $hover_texture | 开关鼠标悬浮状态图片 |
+| $pressed_texture | 开关按下图片 |
+| $pressed_no_hover_texture | 开关鼠标悬浮状态按下图片 |
+| $toggle_name | 获取输入到的信息，监听了BF_ToggleChanged的函数,类似文本输入框 |
+|$toggle_state_binding_name | 开关控件显示toggle_state中返回的内容，这与上面形成了一个双向绑定，类似文本输入框|
+
+* 注1
+
+```python
+class TestScreen(ScreenNode):
+ def __init__(self, namespace, name, param):
+ ScreenNode.__init__(self, namespace, name, param)
+ self.currentToggleShow = True
+
+ @ViewBinder.binding(ViewBinder.BF_ToggleChanged)
+ def OnDemoToggleChangeCallback(self,args):
+ self.currentToggleShow = args["state"]
+ return ViewRequest.Refresh
+
+ @ViewBinder.binding(ViewBinder.BF_BindBool)
+ def ReturnToggleState(self):
+ return self.currentToggleShow
+
+```
+
+下图为UI编辑器中开关控件的属性编辑面板。
+
+
+
+
+
+| 变量
| 解释 |
+| :------------: | ---------------------------------------------------- |
+| 使用贴图 | 滑轨开对应$hover_texture字段，滑轨关对应$default_texture,滑轨开时按下对应$pressed_no_hover_texture字段，滑轨关时按下对应$pressed_texture,将资源管理窗口中的图片资源拖曳到该图片小窗内赋值，可以在上方的下拉选项栏中重新选回默认图片 |
+| 绑定开关交互 | 对应$toggle_name字段 |
+| 绑定开关内容 | 对应$toggle_state_binding_name字段 |
+
+### Slider
+
+滑动条控件，用于拖动设置进度或百分比。
+
+```json
+"slider0@common.slider": {
+ "$slider_tts_text_value": "#netease_tts_text_value",
+ "$slider_name": "#UIDemoScreen.OnDemoSliderChange",
+ "$slider_value_binding_name":"#UIDemoScreen.ReturnSliderValue",
+ "$slider_steps_binding_name": "#UIDemoScreen.ReturnSliderStep",
+ "$background_default_control": "common.slider_background",
+ "$progress_default_control": "common.slider_progress",
+ "$progress_default_clip_direction": "left",
+ "$background_hover_control": "common.slider_background_hover",
+ "$progress_hover_control": "common.slider_progress_hover",
+ "$progress_hover_clip_direction": "left",
+ "$slider_direction": "horizontal",
+ "$slider_box_layout": "common.slider_button_layout",
+ "$slider_box_hover_layout": "common.slider_button_hover_layout",
+ "$slider_box_locked_layout": "common.slider_button_locked_layout",
+ "$slider_box_indent_layout": "common.slider_button_indent_layout",
+ "$slider_box_size": [ 10, 16 ],
+ "size": [ 100, 10 ],
+ "offset": [ 0, 0 ],
+ "$slider_step_factory_control_ids": {
+ "slider_step": "@common.slider_step",
+ "slider_step_hover": "@common.slider_step_hover",
+ "slider_step_progress": "@common.slider_step_progress",
+ "slider_step_progress_hover": "@common.slider_step_progress_hover"
+ },
+ }
+```
+
+| 变量
| 解释 |
+| :---------------------------------: | ------------------------------------------------------------ |
+| $slider_tts_text_value | 开发者无需关注，但为必填属性，建议值为 "#netease_tts_text_value"（只要是以"#"开头的字符串值即可） |
+| $slider_name | 获取滑动条的信息，监听了BF_SliderChanged的函数OnDemoSliderChange，会在滑动条值改变时调到该函数，可参考下面的**注1** |
+| $slider_value_binding_name | 滑动条显示ReturnSliderValue中返回的值，这与上面形成了一个双向绑定，该值必须是float类型，可参考下面的**注1** |
+| $slider_steps_binding_name | 滑动条总步长，由ReturnSliderStep函数中返回的值进行设置。当设置大于1时该滑动条为固定格类型，类似设置面板中能见度设置，滑动范围为0-总步长；当设置小于等于1时该滑动条为百分比类型，类似设置面板中音量设置，滑动范围为0-1。 |
+| $background_default_control | 滑动条背景默认情况下显示的控件，须为image |
+| $progress_default_control | 滑动条前景默认情况下显示的控件，会根据当前进度进行裁剪，须为image |
+| $progress_default_clip_direction | 滑动条前景默认情况下被裁剪方向, 可填"left", "right", "up", "down", "center" |
+| $background_hover_control | 滑动条背景在鼠标悬浮及按下情况下显示的控件，须为image |
+| $progress_hover_control | 滑动条前景在鼠标悬浮及按下情况下显示的控件，会根据当前进度进行裁剪，须为image |
+| $progress_hover_clip_direction | 滑动条前景在鼠标悬浮及按下情况下被裁剪方向, 可填"left", "right", "up", "down", "center" |
+| $slider_direction | 滑动条方向，可填"horizontal","vertical"和"none"，默认为"horizontal"。注意当滑动条方向改变时不会自动改变滑动条前景默认情况和悬浮及按下情况下被裁减的方向，如有需要请修改$progress_default_clip_direction和$progress_hover_clip_direction属性 |
+| $slider_box_layout | 滑动格默认情况下显示的控件 |
+| $slider_box_hover_layout | 滑动格鼠标悬浮情况下显示的控件 |
+| $slider_box_locked_layout | 滑动格鼠标不可用情况下显示的控件 |
+| $slider_box_indent_layout | 滑动格按下情况下显示的控件 |
+| $slider_box_size | 滑动格大小 |
+| $slider_step_factory_control_ids | 当滑动条为固定格类型滑动条时，滑动条会生成等距的分隔线来标明单步滑动的位置。而这一系列的分割线就是由$slider_step_factory_control_ids属性内的各个控件控制的。 |
+| slider_step | 背景分隔线默认情况下显示的控件 |
+| slider_step_hover | 背景分隔线鼠标悬浮情况下显示的控件 |
+| slider_step_progress | 前景分隔线默认情况下显示的控件 |
+| slider_step_progress_hover | 前景分隔线鼠标悬浮情况下显示的控件 |
+
+* 注1
+
+```python
+class UIDemoScreen(ScreenNode):
+ def __init__(self, namespace, name, param):
+ ScreenNode.__init__(self, namespace, name, param)
+ self.sliderPercentValue = 0.5 # 百分比值
+ # self.sliderAbsValue = 5.0 # 固定值
+
+ @ViewBinder.binding(ViewBinder.BF_SliderChanged | ViewBinder.BF_SliderFinished)
+ def OnDemoSliderChange(self, value, isFinish, _unused):
+ self.sliderPercentValue = value # 百分比类型滑动条保存值
+ # self.sliderAbsValue = value # 固定格类型滑动条保存值
+ return ViewRequest.Refresh
+
+ @ViewBinder.binding(ViewBinder.BF_BindFloat)
+ def ReturnSliderValue(self):
+ return self.sliderPercentValue # 百分比类型滑动条返回值
+ # return self.sliderAbsValue # 固定格类型滑动条返回值
+
+ @ViewBinder.binding(ViewBinder.BF_BindInt)
+ def ReturnSliderStep(self):
+ return 1 # 百分比类型滑动条
+ # return 10 # 固定格类型滑动条
+```
+
+下图为Slider在游戏中的控件表现
+
+
+
+
+
+### SelectionWheel
+
+该控件表现为一个轮盘选择UI，为了开发方便，可继承common_selection_wheels命名空间下的base_selection_wheel控件，[Demo](../20-玩法开发/13-模组SDK编程/60-Demo示例.md#UIDemoMod)中表现如下。
+
+
+
+该控件结构稍微复杂，本质上是一堆控件的组合，直接看json不够直观。总体是分为两部分，一部分控件是不管鼠标怎么移动，都不影响那部分控件的可见性（visible属性），比如这些ItemRenderer以及中间的Label。
+
+
+
+而另一部分控件根据鼠标不同的位置，确定显示哪个控件，比如这个轮盘本身，本质上是一堆带不同选中效果的图片控件。
+
+
+
+Demo中显示的轮盘控件是一个圆环形状，这是因为计算鼠标位置映射到哪个控件的时候是按照鼠标落在圆环的哪个扇区决定的，这是比较精确的显示，但实际上是可以用相似的形状去贴近这个圆环的，比如如果圆环切分的不够多，均分成6个，就可以用下面的形状去近似。
+
+这是轮盘控件近似的映射区域。
+
+
+
+这是轮盘控件实际的映射区域。
+
+
+
+了解了这个控件结构后，制作自己的轮盘控件需要确定的就是弄清楚鼠标移到哪个区域对应哪一个图片。实际上轮盘的映射规则并不明显，这里提供一个python函数，计算出 index == 0 的区域在极坐标系中的角度范围，下图是极坐标系示意图。
+
+
+
+
+index == 0 的区域在极坐标系中的坐标范围计算
+
+```python
+# 获取第一个item的角度范围
+def getFirstItemRange(itemNum):
+ perItemSize = 360 / itemNum
+ offset = 180 - perItemSize / 2
+ rangeStart = -(0 - offset)
+ rangeEnd = -(perItemSize - offset)
+ print(rangeStart, rangeEnd)
+ return rangeStart, perItemSize
+```
+
+
+为了方便开发者更快地确定不同数量叶片的情况，[UIDemoMod](../20-玩法开发/13-模组SDK编程/60-Demo示例.md#UIDemoMod) 中有3-10个叶片的图片示例（外直径400，内直径200，路径为 "UIDemoMod/uidemoResourcePack/textures/ui/SelectionWheel/samples"），后续UI编辑器中将会集成对应的工具生成这些图片。
+
+
+
+值得注意的是，生成的图片中，有一张图片是需要作为这个轮盘的默认状态（也就是鼠标还未移到控件上的时候控件显示的状态），这张图片所对应的控件，就是轮盘的默认状态（也叫默认索引）。
+
+有了上面的理解，json中的属性就比较清晰，我们以下面的json为例说明。
+
+```json
+{
+ "namespace": "custom_wheel_namespace",
+ "wheel_state" : {
+ "type" : "image"
+ },
+ "custom_selection_wheel_content":{
+ "type": "panel",
+ "controls": [
+ {
+ "state_default@custom_wheel_namespace.wheel_state": {
+ "texture" : "textures/ui/circle/custom_wheel_selection_default"
+ }
+ },
+ {
+ "state_0@custom_wheel_namespace.wheel_state": {
+ "texture" : "textures/ui/circle/custom_wheel_selection_0"
+ }
+ },
+ {
+ "state_1@custom_wheel_namespace.wheel_state": {
+ "texture" : "textures/ui/circle/custom_wheel_selection_1"
+ }
+ },
+ {
+ "state_2@custom_wheel_namespace.wheel_state": {
+ "texture" : "textures/ui/circle/custom_wheel_selection_2"
+ }
+ },
+ {
+ "state_3@custom_wheel_namespace.wheel_state": {
+ "texture" : "textures/ui/circle/custom_wheel_selection_3"
+ }
+ },
+ {
+ "state_4@custom_wheel_namespace.wheel_state": {
+ "texture" : "textures/ui/circle/custom_wheel_selection_4"
+ }
+ },
+ {
+ "state_5@custom_wheel_namespace.wheel_state": {
+ "texture" : "textures/ui/circle/custom_wheel_selection_5"
+ }
+ }
+ ]
+ },
+ "custom_selection_wheel@common_selection_wheels.base_selection_wheel" : {
+ "inner_radius" : 0.35,
+ "outer_radius" : 1.0,
+ "size" : [ 200, 200 ],
+ "slice_count" : 6,
+ "initial_button_slice": -1,
+ "$content": "custom_wheel_namespace.custom_selection_wheel_content",
+ "state_controls" : [
+ "state_default",
+ "state_0",
+ "state_1",
+ "state_2",
+ "state_3",
+ "state_4",
+ "state_5"
+ ]
+ }
+}
+
+```
+
+| 属性
| 解释 |
+| :------------: | ---------------------------------------------------- |
+| slice_count | 轮盘切片的数量，如上图显示，这个轮盘有6个选择，所以将圆环平均切成了6份|
+| outer_radius | 轮盘的外直径**系数**，该值是一个**比例值**，默认为1.0，**不建议修改该值**。 该比例值是用来计算轮盘响应的外直径的有多大，轮盘的外直径 = outer_radius * min(width, height)，其中 width，height分别轮盘控件的宽高（控件size属性值）|
+| inner_radius | 轮盘的内直径系数，默认为0.0。 |
+| state_controls | 上文所说的那一部分跟随鼠标位置变化的控件的名称， 这些控件必须是轮盘的子控件（不一定是直接子控件，可以是孙子或者更往下的子控件），在轮盘中，每个状态控件都有一个索引 index，默认状态控件的 index = -1，其他状态的index范围为 [0, slice_count - 1] ，需要注意的是，第一个控件必须是作为默认状态控件。|
+| initial_button_slice | 轮盘刚创建出来时所处的索引，默认值为-1|
+
+
+| 变量
| 解释 |
+| :------------: | ---------------------------------------------------- |
+| $content | 轮盘的内容控件，本质是一个[控件变量](15-变量引用和万用控件)，请将所有子控件都声明到该控件中|
+
+
+对于上面所出现的三种轮盘，[UIDemo](../20-玩法开发/13-模组SDK编程/60-Demo示例.md#UIDemoMod) 中都涵盖了。
+
+
+* 注1
+
+目前轮盘控件在SDK中支持的回调仅有两个：hover的回调（通过SetHoverCallback接口设置回调）以及SetTouchUpCallback接口设置回调），这些事件是在SelectionWheel控件的区域内发出（注意这个区域并不是可见的圆环区域，而是方形的区域，如下图所示）。
+
+hover事件的触发本质上是与鼠标悬浮相关，在PC模式中，当鼠标从控件方形区域外移动到方形区域内时，会触发一次hover事件，从方形区域内移到方形区域外也会触发一次hover事件，当选中轮盘并且轮盘的选中索引发生了改变（index值改变）也会触发一次hover事件。
+而在PE模式下，鼠标是模拟出来的，鼠标的悬浮是通过按着鼠标模拟点进行拖动或者点击某个位置来模拟的，因此hover事件触发逻辑其实和PC模式是一致的。
+
+鼠标按下后弹起的事件则无论是PC还是PE都是一致的，是在控件方形区域内检测到鼠标按下后弹起都会触发（无论index是否改变了）。
+
+
+
+
+
+
+
+* 注2
+
+推荐轮盘所在的Screen用PushScreen的方式创建，因为PushScreen加载的UI是会对该UI中存在的控件中的贴图资源进行强制加载（如果这个贴图从未显示过的话），考虑到轮盘的贴图资源比较多（6切片的轮盘如果用CreateUI的方式创建轮盘，并且这些轮盘贴图从未显示过，那么选择轮盘的时候就会产生闪烁现象，原因就是第一次显示的贴图资源会动态加载，而动态加载是需要一定时间的。如果想彻底解决这类加载问题，详见 贴图预加载 。
+
+
+
+
+
+* 注3
+
+
+如果希望用手柄对轮盘进行控制，需要在轮盘所在的Screen上声明属性 "gamepad_cursor_deflection_mode" 为 true，具体可见下方的类似json代码
+
+
+```json
+ "main" : {
+ "controls" : [],
+ "type" : "screen",
+ "gamepad_cursor_deflection_mode": true
+ },
+```
+
+
+
+### NeteaseComboBox
+
+网易版单选下拉框，可以在给定的选项中进行选择。
+
+```json
+"comboBoxPanel@combo_box.comboBoxPanel" : {
+ "$content_size":[ "100.0%+0.0px", 100 ],
+ "$item_size":[ "100.0%+0.0px", "10.0%x+0.0px" ],
+ "$title_label":"combo_box.titleLabel",
+ "$content_label":"combo_box.label",
+ "$title_down_image":"combo_box.dropdownImage",
+ "$title_up_image":"combo_box.dropupImage",
+ "$default_title_texture" : "textures/ui/button_borderless_light",
+ "$hover_title_texture" : "textures/ui/button_borderless_lighthover",
+ "$pressed_title_texture" : "textures/ui/button_borderless_lightpressed",
+ "$title_nineslice_size|default" : [ 0.0, 0.0, 0.0, 0.0 ],
+ "$default_item_texture" : "textures/ui/button_borderless_light",
+ "$hover_item_texture" : "textures/ui/button_borderless_lighthover",
+ "$pressed_item_texture" : "textures/ui/button_borderless_lightpressed",
+ "$item_nineslice_size|default" : [ 0.0, 0.0, 0.0, 0.0 ],
+ "$scroll_background_texture" : "textures/ui/ScrollRail",
+ "alpha" : 1.0,
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "clip_offset" : [ 0, 0 ],
+ "clips_children" : false,
+ "enabled" : true,
+ "layer" : 0,
+ "max_size" : [ 0, 0 ],
+ "min_size" : [ 0, 0 ],
+ "offset" : [ 0.0, 0.0 ],
+ "priority" : 0,
+ "propagate_alpha" : false,
+ "size" : [ 120, 20 ],
+ "type" : "panel",
+ "visible" : true
+ }
+```
+
+
+| 变量
| 解释 |
+| :---------------------------------: | ------------------------------------------------------------ |
+| $content_size | 下拉框整个弹出框的大小，默认值为[ "100.0%+0.0px", 100 ] |
+| $item_size | 下拉框单个下拉项相对于整个弹出框的大小，默认值为[ "100.0%+0.0px", "10.0%x+0.0px" ] |
+| $title_label | 下拉框标题文本控件引用，默认值为"combo_box.titleLabel" |
+| $content_label | 下拉框单个下拉项文本控件引用，默认值为"combo_box.label"。 |
+| $title_down_image | 下拉框未展开弹出框时标题右侧小图标控件引用，默认值为"combo_box.dropdownImage" |
+| $title_up_image | 下拉框展开弹出框时标题右侧小图标控件引用，默认值为"combo_box.dropupImage" |
+| $default_title_texture | 下拉框标题默认状态图片路径，默认值为"textures/ui/button_borderless_light" |
+| $hover_title_texture | 下拉框标题悬浮状态图片路径，默认值为"textures/ui/button_borderless_lighthover" |
+| $pressed_title_texture | 下拉框标题按下状态图片路径，默认值为"textures/ui/button_borderless_lightpressed" |
+| $default_item_texture | 下拉框单个下拉项默认状态图片路径，默认值为"textures/ui/button_borderless_light" |
+| $hover_item_texture | 下拉框单个下拉项悬浮状态图片路径，默认值为"textures/ui/button_borderless_lighthover" |
+| $pressed_item_texture | 下拉框单个下拉项按下状态图片路径，默认值为"textures/ui/button_borderless_lightpressed" |
+| $title_nineslice_size | 下拉框标题图片九宫切图，默认值为[ 0.0, 0.0, 0.0, 0.0 ] |
+| $item_nineslice_size | 下拉框单个下拉项图片九宫切图，默认值为[ 0.0, 0.0, 0.0, 0.0 ] |
+| $scroll_background_texture | 下拉框弹出框背景图片，默认值为"textures/ui/ScrollRail" |
+
+向该下拉框添加内容、注册选中回调等操作均需要调用UIAPI，详情请参考 NeteaseComboBoxUIControl
+
+下图为网易版单选下拉框在游戏中的控件表现
+
+
+
+UI编辑器暂时不支持编辑
+
+### MiniMap
+
+该控件可以在UI上画小地图，需要继承mini_map命名空间下的mini_map_wrapper控件。
+
+其中官方封装了地图界面基类 MiniMapBaseScreen 供开发者扩展。
+
+```json
+"mainPanel@mini_map.mini_map_wrapper" : {
+ "anchor_from" : "top_right",
+ "anchor_to" : "top_right",
+ "layer" : 1,
+ "offset" : [ -10.0, 10.0 ],
+ "$enable_live_update": false,
+ "$live_update_interval": 5,
+ "$use_default_face_icon": true,
+ "$face_icon_size": [4,4],
+ "$face_icon_bg_color": "white",
+ "$highest_y": 0
+ // 如果希望小地图能够被裁剪，请继承后修改controls如下:
+ "controls":[
+ {
+ "mini_map_bg@mini_map.mini_map_bg": {}
+ },
+ {
+ "netease_mini_map@mini_map.netease_mini_map": {
+ "allow_clipping":true,
+ "enable_scissor_test" : true
+ }
+ },
+ {
+ "icon@mini_map.icon": {}
+ },
+ {
+ "head_lbl@mini_map.head_label": {}
+ },
+ {
+ "text_lbl@mini_map.text_label": {}
+ }
+ ]
+}
+```
+
+相关字段说明：
+
+| 变量
| 解释 |
+| :---------------------------------: | ------------------------------------------------------------ |
+| $enable_live_update | 是否开启方块变化更新到小地图上（简称“热更”） |
+| $live_update_interval | “热更”的时间间隔，单位秒（s），不建议间隔太小，更新太频繁在低端机器可能有性能问题 |
+| $use_default_face_icon | 本地玩家是否使用默认的脸部作为标记icon |
+| $face_icon_size | 脸部icon的大小，默认为[4,4] |
+| $face_icon_bg_color | 标记icon底部背景颜色，默认为白色 |
+| $highest_y | 绘制的高度最大值，默认当前区块的最大值，当该值为-1时，表示最大高度值为玩家当前位置所在的高度 |
+| enable_scissor_test | 超出父控件区域后是否裁剪，默认为false, [enable_scissor_test](https://wiki.bedrock.dev/json-ui/json-ui-documentation.html)|
+
+### **颜色渐变控件（gradientRenderer）**
+
+该控件可以用于在ui上绘制渐变颜色
+
+```json
+"gradient": {
+ "color1": [1, 0, 1, 1],
+ "color2": [0, 0, 1, 1],
+ "gradient_direction": "vertical",
+ "renderer": "gradient_renderer",
+ "type": "custom"
+}
+```
+
+| 变量 | 解释 |
+| ------------------ | -------------------------------------- |
+| color1 | 渐变起始颜色的RGBA |
+| color2 | 渐变结束颜色的RGBA |
+| gradient_direction | 渐变方向，可选"vertical"或"horizontal" |
+| renderer | 需要指定为gradient_renderer |
+| type | 需要指定为custom |
+
+
+
+下图为UI编辑器中颜色渐变控件的属性编辑面板
+
+
+
+| 变量 | 解释 |
+| ------------ | ------------------------------------------------------ |
+| 渐变起始颜色 | 对应color1字段，支持调整不透明度（Alpha通道） |
+| 渐变结束颜色 | 对应color2字段，支持调整不透明度（Alpha通道） |
+| 渐变方向 | 对应gradient_direction字段，可选“垂直排布”或“水平排布” |
+
+### 继承控件
+
+继承控件允许开发者选择并继承目标控件，继承成功后该控件拥有目标控件的所有属性，并可以重写其中任何一个属性的数据。
+
+#### 继承写法简述
+
+在界面json文件所有的编写技巧中，最为好用和灵活的功能当属继承写法。当界面中有一个需求，需要将若干个相同的控件按序排列，除了可以通过复制粘贴出若干个控件副本外，继承模板控件并只修改我们所需要修改的属性，其他的属性依然沿用模板控件的数据才是最便捷，也是最漂亮的写法。下面我们从一个简单的例子入手熟悉继承的写法，从例子中我们可以快速熟悉继承技巧。
+
+```json
+{
+ "main" : {
+ "absorbs_input" : true,
+ "always_accepts_input" : false,
+ "controls" : [
+ {
+ "label0@myInherit.label0" : {}
+ },
+ {
+ "inheritor0@myInherit.label0" : {
+ "offset" : [ 10.0, 0.0 ]
+ }
+ },
+ {
+ "inheritor1@myInherit.label0" : {
+ "offset" : [ 20.0, 0.0 ]
+ }
+ }
+ ],
+ "force_render_below" : false,
+ "is_showing_menu" : true,
+ "render_game_behind" : true,
+ "render_only_when_topmost" : true,
+ "should_steal_mouse" : false,
+ "type" : "screen"
+ },
+ "label0" : {
+ "anchor_from" : "center",
+ "anchor_to" : "center",
+ "color" : [ 1, 1, 1 ],
+ "font_scale_factor" : 1.0,
+ "font_size" : "normal",
+ "font_type" : "smooth",
+ "layer" : 0,
+ "offset" : [ 0, 0 ],
+ "shadow" : false,
+ "size" : [ 100, 100 ],
+ "text" : "Hello World!",
+ "text_alignment" : "center",
+ "type" : "label",
+ "visible" : true
+ },
+ "namespace" : "myInherit"
+}
+```
+
+该段json描述了在main画布中创建了一个文本控件label0，并使继承控件inherit0和inherit1均继承了label0控件，并重写了offset属性，在场景中就得到了三个文本控件，这三个文本控件除了在场景中的位置因为重写而不同外，其他的属性一模一样。但是要注意的是，可以被继承的控件必须写在json文件的最外层，和main处在同一层级，即一个命名空间下有且仅有一个该名称的控件，满足该条件的控件才可以被继承。
+
+#### UI编辑器中的继承
+
+新版的UI编辑器对继承提供了更可视化的方法，请参考[继承和自定义控件](./13-继承和自定义控件.md)。
+
+## Python编写说明
+
+### 必要的属性
+
+```python
+import mod.client.extraClientApi as clientApi
+ViewBinder = clientApi.GetViewBinderCls()
+ViewRequest = clientApi.GetViewViewRequestCls()
+ScreenNode = clientApi.GetScreenNodeCls()
+```
+| 变量 | 解释 |
+| :------------: | :----------------------------------- |
+| extraClientApi | 我们开发的Client端Api接口文件 |
+| ViewBinder | 用于绑定回调函数的类型和响应的方法 |
+| ViewRequest | 用于返回绑定函数的返回值 |
+| ScreenNode | UI的基类，用于继承基类的方法和UI管理 |
+
+### UI界面初始化
+
+```python
+class TestScreen(ScreenNode):
+ def __init__(self, namespace, name, param):
+ ScreenNode.__init__(self, namespace, name, param)
+```
+
+ScreenNode是我们的UI节点基类，必须继承。
+
+```python
+# Bind Type
+class ViewBinder(object):
+ ButtonFilter = 0x10000000
+ BF_ButtonClickUp = 0 | ButtonFilter
+ BF_ButtonClickDown = 1 | ButtonFilter
+ BF_ButtonClick = 2 | ButtonFilter
+ BF_ButtonClickCancel= 3
+ BF_InteractButtonClick = 4
+ BindFilter = 0x01000000
+ BF_BindBool = 5 | BindFilter
+ BF_BindInt = 6 | BindFilter
+ BF_BindFloat = 7 | BindFilter
+ BF_BindString = 8 | BindFilter
+ BF_BindGridSize = 9 | BindFilter
+ BF_BindColor = 10 | BindFilter
+ EditFilter = 0x00100000
+ BF_EditChanged = 11 | EditFilter
+ BF_EditFinished = 12 | EditFilter
+ ToggleFilter = 0x00010000
+ BF_ToggleChanged = 13 | ToggleFilter
+# Return Type
+class ViewRequest(object):
+ Nothing = 0
+ Refresh = 1 << 0
+ PointerHeldEventsRequest = 1 << 1
+ PointerHeldEventsCancel = 1 << 2
+ Exit = 1 << 3
+
+```
+
+### UI绑定和返回
+
+UI的绑定分为binding单个绑定和binding_collection集合绑定，适合集合容器。
+
+| 绑定类型 | 绑定方式 | 解释 |
+| :--------------------- | :---------------------------: | :------------------------------------- |
+| BF_ButtonClickUp | binding | 绑定按钮的Up事件 |
+| BF_ButtonClickDown | binding | 绑定按钮的Down事件 |
+| BF_ButtonClick | binding | 同时绑定Up和Down事件 |
+| BF_ButtonClickCancel | binding | 绑定按钮的Cancel事件（按钮down其他up） |
+| BF_InteractButtonClick | binding | 绑定游戏原生的按钮点击事件 |
+| BF_BindBool | binding \| binding_collection | 绑定Bool变量 |
+| BF_BindInt | binding \| binding_collection | 绑定Int变量 |
+| BF_BindFloat | binding \| binding_collection | 绑定Float变量 |
+| BF_BindString | binding \| binding_collection | 绑定String变量 |
+| BF_BindGridSize | binding | 绑定GridSize变量 |
+| BF_BindColor | binding \| binding_collection | 绑定颜色变量 |
+| BF_EditChanged | binding | 绑定输入框输入改变事件 |
+| BF_EditFinished | binding | 绑定输入框输入完成事件 |
+| BF_ToggleChanged | binding | 开关状态改变事件 |
+
+**binding(bind_flag, binding_name = None)**
+
+bind_flag为上文中绑定类型，binding_name为绑定名称。
+
+binding_name为脚本绑定变量，binding_name_override为引擎变量，json格式如下
+
+```json
+ "bindings" : [
+ {
+ "binding_condition" : "always",
+ "binding_name" : "#scoreboard_grid.item_count",
+ "binding_name_override" : "#StackGridItemsCount"
+ }
+ ]
+```
+对应的Python代码如下
+```python
+ @ViewBinder.binding(ViewBinder.BF_BindInt, "#scoreboard_grid.item_count")
+ def OnStarkGridResize(self):
+ return len(self.scoreBoardList)
+```
+
+**binding_collection(bind_flag, collection_name, binding_name = None)**
+
+bind_flag为上文中的绑定类型，collection_name为集合名称，binding_name为绑定的变量名称。
+
+集合的json如下：
+
+```json
+"collection_name" : "scoreboard_stackgrid"
+```
+
+在集合的子控件中，binding_collection_name为集合名，binding_condition为绑定条件，binding_name为绑定名称，binding_type为collection绑定，property_bag设置他的初始值，text为它的绑定值。
+
+```json
+ "label_score_board" : {
+ "bindings" : [
+ {
+ "binding_collection_name" : "scoreboard_stackgrid",
+ "binding_condition" : "always",
+ "binding_name" : "#label_score_board.text",
+ "binding_type" : "collection"
+ }
+ ],
+ "offset" : [ "0%+0 px", "0%+0px" ],
+ "property_bag" : {
+ "#label_score_board.text" : "666666666666"
+ },
+ "text" : "#label_score_board.text",
+ "text_alignment" : "left",
+ "type" : "label",
+ "visible" : true
+ },
+```
+
+对应的Python代码如下，其中index表示在集合中的哪一元素。
+
+```python
+ @ViewBinder.binding_collection(ViewBinder.BF_BindString, "scoreboard_stackgrid", "#label_score_board.text")
+ def OnRefreshScoreBoardLabel(self, index):
+ return self.scoreBoardList[index] if len(self.scoreBoardList) > index else ""
+```
+
+## 接口调用说明
+
+### 参数命名说明
+
+@Mod.Binding(name = myModName, version = myModVersion)
+
+| 参数 | 类型 | 解释 |
+| :----------: | :--: | :------ |
+| myModName | str | Mod名称 |
+| myModVersion | str | Mod版本 |
+
+假设设置Mod名称为"myModName"，示例：
+```python
+ @Mod.Binding(name = "myModName", version = "0.1")
+ class MyModClass(object):
+ def __init__(self):
+ pass
+```
+
+### 界面创建流程及生命周期
+
+界面在 UiInitFinished 事件发送之后就可以开始创建
+
+创建UI的第一步是UI的注册，通过调用 RegisterUI 接口，将想开启UI的相关数据进行注册。同一UI只需要注册一次即可
+
+注册完成之后就可以在需要的时候实例化UI，可使用的接口有 CreateUI 和 PushScreen 两种。使用 CreateUI 生成的界面都生成在操作UI下，不同的生成参数UI层级不同，而使用 PushScreen 生成的界面以堆栈管理的方式生成，该界面生成时上一个 PushScreen 生成的界面就会被隐藏。值得注意的是，MC原生界面（比如暂停界面，背包界面等）也是类似 PushScreen 的方式加载进来，并以堆栈管理。
+
+在UI创建完成之后，可以调用 GetUI 接口拿到UI对应的ScreenNode实例。
+如果想获取MC原生界面的实例，则需要监听原生界面Push进来的事件 PushScreenEvent ，然后在事件回调中调用接口 GetTopPushedUI 。
+
+每个ScreenNode都有生命周期函数，生命周期函数会被自动在以下情况下调用，重写函数可以完成一些逻辑。
+
+| 函数 | 作用 |
+| :----------------------------------------------------------: | :----------------------- |
+| Create | UI创建成功时调用 |
+| OnActive | UI重新回到栈顶时调用 |
+| OnDeactive | 栈顶UI有其他UI入栈时调用 |
+| Destroy | UI销毁时调用 |
+
+最后，当UI需要销毁时，可以调用ScreenNode实例的 SetRemove 接口，此外使用 PushScreen 接口创建的界面还可以使用 PopScreen 接口进行销毁。
+
+### 手柄交互
+
+（1）使用 PushScreen生成出的界面，调出手柄光标，有两步一是需要将底层Screen继承自common.base_screen，二是将screen的"gamepad_cursor" 属性设置为 true，如下格式
+
+```json
+{
+ "main@common.base_screen" : {
+ ....
+ "gamepad_cursor" : true
+ },
+ "namespace" : "Test"
+}
+```
+
+（2）使用 CreateUI生成出的界面，只支持手柄与创建UI时isHud参数设置为0的Screen中的按钮进行交互。
+
+（3）使用 PushScreen生成出具有轮盘控件的UI时，需要将底层screen的"gamepad_cursor_deflection_mode" 属性设置true，否则将无法选中轮盘格子
+
+（4）[GamepadModDemo](../20-玩法开发/13-模组SDK编程/60-Demo示例.md#GamepadModDemo)展示了两种UI创建如何与手柄交互，以及一个基础的扳机使用方法。
+
+## UIDemoMod介绍
+
+为了让开发者更好的了解各个UI控件的使用方法以及控件在mod界面中的应用，我们开发了一个简单的[UIDemoMod](../20-玩法开发/13-模组SDK编程/60-Demo示例.md#UIDemoMod)，开发者可以在官网下载到它。该Demo包含了文本、文本输入框、滚动列表、网格、进度条、按钮、图片、开关、纸娃娃、道具渲染控件的操作与逻辑演示。下图为UIDemoMod菜单界面。
+
+
+
+例如我们想了解一下文本控件是如何使用的，点击“文本控件演示”按钮进入演示界面，如下图。
+
+
+
+由于功能相关以及方便演示，我们将文本和文本输入框控件做在一个界面中共同演示。控件的演示界面中有待演示的UI控件、操作方法和返回菜单界面按钮。如操作方法描述的，我们在文本输入框中输入文本，上方的文本控件会根据文本输入框输入的内容发生对应的变化，逻辑可以在UIDemoMod的脚本代码中查到，如下图。
+
+
+
+还想了解其他控件的用法，就下一个UIDemo看看吧！
+
+
+## 富文本控件介绍
+
+富文本控件提供了一个支持文本、图片、按钮、超链接、序列帧的复合文本控件，富文本控件接受按一定规则组成的字符串，除去常规文本外，定制化文本及非文本控件用html的标签写法隔开（如``）,中间填写json格式数据。开发者可以在UI中引用该控件，并将符合解析规则的字符串传入解析接口，富文本控件会根据传入的字符串顺序排列生成富文本。以下详细介绍用法。
+
+### 富文本支持定制化文本及非文本控件及写法
+
+#### 换行控件
+
+2.6新增换行控件\，可在非标签的内容、定制化文本控件\