Merge commit '707e3a7b2b24bf84cb59143eeeaf73a167be4b33'

* feat: 添加Allay相关教程

* feat: 添加 3-NetAllay常用接口文档.md

* docs: 更新NetAllay支持说明，添加常用接口文档链接

.all-contributorsrc

@@ -0,0 +1,48 @@
+{
+  "projectName": "netease-bedrock-wiki",
+  "projectOwner": "MCNeteaseDevs",
+  "files": [
+    "README.md"
+  ],
+  "commitType": "docs",
+  "commitConvention": "angular",
+  "contributorsPerLine": 7,
+  "contributors": [
+    {
+      "login": "MCNeteaseDevs",
+      "name": "MCNeteaseDevs",
+      "avatar_url": "https://avatars.githubusercontent.com/u/186891705?v=4",
+      "profile": "https://github.com/MCNeteaseDevs",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "sevenstars0",
+      "name": "sevenstars",
+      "avatar_url": "https://avatars.githubusercontent.com/u/148792757?v=4",
+      "profile": "https://github.com/sevenstars0",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "LiangJi23333",
+      "name": "LiangJi23333",
+      "avatar_url": "https://avatars.githubusercontent.com/u/102958768?v=4",
+      "profile": "https://github.com/LiangJi23333",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "Nacalpha",
+      "name": "Nacalpha",
+      "avatar_url": "https://avatars.githubusercontent.com/u/128111367?v=4",
+      "profile": "https://github.com/Nacalpha",
+      "contributions": [
+        "doc"
+      ]
+    }
+  ]
+}

.github/ISSUE_TEMPLATE/issue-template-sdk.yml

@@ -0,0 +1,57 @@
+name: SDK文档修改
+description: 一条SDK修改对应一条Issue，可以修改参数描述、接口备注等
+title: "[sdk] "
+labels: [sdk]
+body:
+  - type: textarea
+    id: sdk_name
+    attributes:
+      label: 接口名称/链接
+      description: 请填写接口的名称或链接
+      placeholder: |
+        例如： CreateUI
+    validations:
+      required: true
+  
+  - type: dropdown
+    id: sdk_type
+    attributes:
+      label: 接口类型
+      description: 接口的类型
+      options:
+        - 服务端
+        - 客户端
+        - 双端
+    validations:
+      required: true
+
+  - type: textarea
+    id: modifications
+    attributes:
+      label: 修改内容
+      description: 详细描述修改后的内容
+      placeholder: |
+        例如：
+        # 以CreateUI为例
+        1、参数修改
+        createParams的说明修改为：创建UI的参数，会传到UI类的_init_函数中，详细请看下方备注说明
+        2、备注修改
+        createParams中的bindEntityId参数描述修改为：意为绑定实体的id。若不传入该键值对或值为None，则会以isHud = 0来处理该UI界面。血量显示模组可以使用该参数。
+    validations:
+      required: true
+
+  - type: textarea
+    id: other_content
+    attributes:
+      label: 其他补充信息
+      description: 如有其他补充信息请填写在这里
+    validations:
+      required: false
+    
+  - type: textarea
+    id: developer_info
+    attributes:
+      label: 开发者名称/联系方式
+      description: 请填写您的开发者名称或联系方式（QQ），将会用于奖励发放等
+    validations:
+      required: false

.github/workflows/sync.yml

@@ -0,0 +1,63 @@
+# GitHub Actions 工作流
+# 检测到 sync-* 标签时自动推送代码到 main 分支
+
+name: Auto Push on Tag
+
+on:
+  push:
+    tags:
+      - 'sync-*'
+
+# 授予写入权限
+permissions:
+  contents: write
+
+jobs:
+  push-code:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+      
+      - name: Get tag info
+        id: tag_info
+        run: |
+          TAG_NAME=${GITHUB_REF#refs/tags/}
+          COMMIT_SHA=$(git rev-list -n 1 $TAG_NAME)
+          echo "tag_name=$TAG_NAME" >> $GITHUB_OUTPUT
+          echo "commit_sha=$COMMIT_SHA" >> $GITHUB_OUTPUT
+          echo "🏷️ Tag: $TAG_NAME"
+          echo "📝 Commit: $COMMIT_SHA"
+      
+      - name: Push commit to main
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          
+          # 获取标签指向的 commit
+          TAG_COMMIT=${{ steps.tag_info.outputs.commit_sha }}
+          
+          # 切换到 main 分支
+          git checkout main
+          
+          # 检查 main 是否已经包含这个 commit
+          if git merge-base --is-ancestor $TAG_COMMIT HEAD; then
+            echo "✓ main 分支已包含此 commit，无需推送"
+          else
+            # 将 commit 合并到 main
+            git merge $TAG_COMMIT --no-edit
+            git push origin main
+            echo "✓ 已推送到 main 分支"
+          fi
+      
+      - name: Summary
+        run: |
+          echo "## 同步完成 ✅" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- **标签**: ${{ steps.tag_info.outputs.tag_name }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Commit**: ${{ steps.tag_info.outputs.commit_sha }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **时间**: $(date)" >> $GITHUB_STEP_SUMMARY

.gitignore

@@ -3,3 +3,6 @@ package-lock.json
 package.json
 .DS_Store
 .idea
+mcguide/30-测试/video/airperf.mp4
+mcguide/30-测试/video/tracy.mp4
+.codemaker/ 

README.md

@@ -11,8 +11,29 @@
 如果你发现了一些错误，或者想要补充一些新的教程到我们的官网，那可以在本仓库提交pr，并在项目中留下你的大名！
 提交的文档会经过审核，最终以每两周一次的频率更新到我们的官网中
 
+## 注意事项
+
+- 因为**mcguide/12-入门教程/10-注册成为开发者**的文件名，是首页 https://mc.163.com/dev/guide.html 左侧目录生成抓取的依据，因此请开发者们勿修改**注册成为开发者**文件名。修改了文件名的Pull requests审核将不通过
+- 文档一般双周进行同步，如需要立即同步等需求，请开发者在自己的提交请求下@MCNeteaseDevs，并给出申请立即同步的原因（如我提交的文档有误导致目录错误等）
+
 ## 贡献指南
 
+**开发指南/教学课程文档**与**Mod SDK文档**修改流程不一致，接下来将会分别介绍
+
+### Mod SDK文档修改
+1. 点击仓库中**Issues** - 点击**New Issue** - 选择**SDK文档修改**
+
+2. 按照模版依次填写以下内容：
+  - 标题：为了方便其他开发者查找相同修改，请写明**接口名称与修改部分**。例如：StopCustomMusicById添加备注
+  - 接口名称：填写需要修改的接口名称或链接
+  - 接口类型：选择接口的类型，共有服务端、客户端、双端三种选项
+  - 修改内容：详细描述修改的接口文档内容
+  - 其他补充信息：如有其他信息可以补充在这里
+  - 开发者信息：将会用于贡献致谢展示与奖品发放
+
+3. 完成后点击Create。修改内容会由官方进行审核，审核通过后会在**两周之内**同步至官网
+   
+### 开发指南/教学课程修改
 1.	Fork 本项目。点击 Fork 按钮，创建一个新的派生项目到自己的工作区（Create a new fork）
 
 2.	克隆派生
@@ -48,7 +69,7 @@ git push --set-upstream origin your-branch-name
 
 ## 备注
 
-我们的官网文档是使用VuePress构建的，我们鼓励你使用VuePress的语法对文档进行美化。
+我们的官网文档是使用VuePress构建的，我们鼓励你使用VuePress的语法对文档进行美化
 
 ## 鸣谢
 
@@ -56,3 +77,25 @@ git push --set-upstream origin your-branch-name
 
 
 
+## 致谢
+
+在此感谢以下开发者作出的贡献（以下排名不分先后）
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/MCNeteaseDevs"><img src="https://avatars.githubusercontent.com/u/186891705?v=4?s=100" width="100px;" alt="MCNeteaseDevs"/><br /><sub><b>MCNeteaseDevs</b></sub></a><br /><a href="#doc-MCNeteaseDevs" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/sevenstars0"><img src="https://avatars.githubusercontent.com/u/148792757?v=4?s=100" width="100px;" alt="sevenstars"/><br /><sub><b>sevenstars</b></sub></a><br /><a href="#doc-sevenstars0" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/LiangJi23333"><img src="https://avatars.githubusercontent.com/u/102958768?v=4?s=100" width="100px;" alt="LiangJi23333"/><br /><sub><b>LiangJi23333</b></sub></a><br /><a href="#doc-LiangJi23333" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Nacalpha"><img src="https://avatars.githubusercontent.com/u/128111367?v=4?s=100" width="100px;" alt="Nacalpha"/><br /><sub><b>Nacalpha</b></sub></a><br /><a href="#doc-Nacalpha" title="Documentation">📖</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->

mcguide/10-新内容/1-开发工作台/932-1.1.48.md

@@ -0,0 +1,51 @@
+---
+front: 	https://nie.res.netease.com/r/pic/20251126/f99d0bfc-97b5-40fc-8157-394f2776d1d3.jpg
+hard: 入门
+time: 2分钟
+selection: 23
+---
+
+# 2025.11.26 版本1.1.48
+
+## 编辑器/Mod PC支持4D皮肤
+
+为方便开发者在 PC 端直接进行 4D 皮肤与模组的兼容性调试，MC Studio 在 3.6 版本起正式支持 4D 皮肤测试。开发者可以灵活选择手机端和MC Studio，进行模组与4D皮肤的兼容性测试
+
+### 使用方法
+
+1. 新建开发测试
+
+新建开发测试按钮，选择3.6（或以上）版本的Mod PC
+
+![图片](./images/251126/1.1.48_1.png)
+
+选择下方的皮肤选项，可以看到除了默认的史蒂夫和爱丽克丝以外新增4款4D皮肤皮肤，选择皮肤后即可开始测试
+
+![图片](./images/251126/1.1.48_2.png)
+
+2. 配置已有存档
+
+对于已有的3.6测试存档，可以点击配置
+
+![图片](./images/251126/1.1.48_3.png)
+
+在配置界面中可以切换下方的皮肤
+
+![图片](./images/251126/1.1.48_4.png)
+
+3. 局内切换
+
+进入游戏时，会触发一次UpdatePlayerSkinClient客户端事件
+点击右上角菜单，选择切换皮肤选项，即可选择其他4D皮肤
+
+![图片](./images/251126/1.1.48_5.png)
+
+注意：
+
+- 菜单切换4D皮肤是模拟玩家使用局内更衣室切换皮肤的情况
+
+- 菜单切换会触发UpdatePlayerSkinClientEvent事件，开发者可以使用IsHighLevelOfficialSkin、IsOfficialSkin、IsHighLevelMultiJointOfficialSkin、IsMultiJointOfficialSkin接口进行调试与兼容
+
+## 屏蔽我的伙伴功能
+
+- 自本3.6版本Mod PC和1.1.48版本MC Studio开始，Mod PC开发者包和地图编辑器中挖矿将不会出现我的伙伴

mcguide/10-新内容/1-开发工作台/964-1.0.27.md

@@ -24,7 +24,7 @@ selection: 23
 
 ![图片](./images/230323/contentlib2.png)
 
-2. 内容库**其他**分页上线3个spigot插件和一个SDK的示例模型包，详情参考[这篇文档](../../27-网络游戏/课程10：使用Spigot开服/99-下载内容.md)。
+2. 内容库**其他**分页上线3个spigot插件和一个SDK的示例模型包，详情参考[这篇文档](../../27-手机网络游戏/课程10：使用Spigot开服/99-下载内容.md)。
 
 ![图片](./images/230323/contentlib3.png)
 

mcguide/10-新内容/1-开发工作台/973-1.0.15.md

@@ -9,7 +9,7 @@ selection: 12
 
 ## 开服工具2.0正式外放
 
-1. 支持使用Spigot和模组SDK制作基岩版手游服务器，详情参考[开服工具2.0](../../27-网络游戏/课程10：使用Spigot开服/10-支持基岩版客户端的Java版网络游戏概述.md)
+1. 支持使用Spigot和模组SDK制作基岩版手游服务器，详情参考[开服工具2.0](../../27-手机网络游戏/课程10：使用Spigot开服/10-支持基岩版客户端的Java版网络游戏概述.md)
 
 ## 关卡编辑器支持放置生物
 

mcguide/10-新内容/1-开发工作台/983-1.0.5.md

@@ -21,7 +21,7 @@ selection:
 
 ### 新建服务器插件
 
-- 工作台新建基岩版服务器的弹窗中，新增了一个空白插件，可以用来新建插件，详情请见[使用工作台新建插件](../../27-网络游戏/课程5：插件教学/第0节：使用工作台新建插件.md)
+- 工作台新建基岩版服务器的弹窗中，新增了一个空白插件，可以用来新建插件，详情请见[使用工作台新建插件](../../27-手机网络游戏/课程5：插件教学/第0节：使用工作台新建插件.md)
 - 新建插件支持分开创建大厅服Mod和游戏服Mod
 - 插件导入的界面同样得到了更新
 
@@ -32,7 +32,7 @@ selection:
 - 可以在开发者平台赋予子账号更高权限
 - 如果子账号被赋予了开发及审核阶段的部署权限：那么子账号拥有除了删除之外的所有权限
 - 如果子账号被赋予了上线阶段的调试权限：那么子账号拥有调试和查看日志的权限
-- 详情请见[子账号部署和控制台调试功能](../../27-网络游戏/课程7：开发技巧/第4节：子账号部署和控制台调试功能.md)
+- 详情请见[子账号部署和控制台调试功能](../../27-手机网络游戏/课程7：开发技巧/第4节：子账号部署和控制台调试功能.md)
 
 ![image-20220411204613763](./images/image-20220411204613763.png)
 

mcguide/10-新内容/1-开发工作台/991-0.17.4.md

@@ -2,7 +2,7 @@
 
 ### Apollo性能优化工具
 
-我们为各位服务器开发者提供了脚本性能的监测工具，你可以选择要监测的服务器，并在监测一段时间后，获取到这段时间内的脚本函数调用的火焰图，并根据火焰图进行代码优化，详见[性能优化小贴士](../../27-网络游戏/课程8：性能优化/第6节：性能优化小贴士.md)。
+我们为各位服务器开发者提供了脚本性能的监测工具，你可以选择要监测的服务器，并在监测一段时间后，获取到这段时间内的脚本函数调用的火焰图，并根据火焰图进行代码优化，详见[性能优化小贴士](../../27-手机网络游戏/课程8：性能优化/第6节：性能优化小贴士.md)。
 
 ![image-20211208181043002](./images/image-20211208181043002.png)
 

mcguide/10-新内容/1-开发工作台/997-0.16.16.md

@@ -46,7 +46,7 @@ from mod.server import extraServerApi
 
 ### Apollo快速切服
 
-对于需要频繁切服的游戏类型（例如小游戏），我们提供了快速切服的功能，详情请参考[快速切服](../../27-网络游戏/课程8：性能优化/第3节：快速切服.md)文档。
+对于需要频繁切服的游戏类型（例如小游戏），我们提供了快速切服的功能，详情请参考[快速切服](../../27-手机网络游戏/课程8：性能优化/第3节：快速切服.md)文档。
 
 ![image-20210826105407118](./images/image-20210826105407118.png)
 

mcguide/10-新内容/2-模组SDK/85-新版本.md

@@ -12,6 +12,12 @@ selection: 14
 ![更新信息](./images/gxxx.png)
 
 或者点击下列链接进行跳转
+- <a href="../../../mcdocs/1-ModAPI/更新信息/3.8.html" rel="noopenner">3.8更新信息 </a>
+- <a href="../../../mcdocs/1-ModAPI/更新信息/3.7.html" rel="noopenner">3.7更新信息 </a>
+- <a href="../../../mcdocs/1-ModAPI/更新信息/3.6.html" rel="noopenner">3.6更新信息 </a>
+- <a href="../../../mcdocs/1-ModAPI/更新信息/3.5.html" rel="noopenner">3.5更新信息 </a>
+- <a href="../../../mcdocs/1-ModAPI/更新信息/3.4.html" rel="noopenner">3.4更新信息 </a>
+- <a href="../../../mcdocs/1-ModAPI/更新信息/3.3.html" rel="noopenner">3.3更新信息 </a>
 - <a href="../../../mcdocs/1-ModAPI/更新信息/3.2.html" rel="noopenner">3.2更新信息 </a>
 - <a href="../../../mcdocs/1-ModAPI/更新信息/3.1.html" rel="noopenner">3.1更新信息 </a>
 - <a href="../../../mcdocs/1-ModAPI/更新信息/3.0.html" rel="noopenner">3.0更新信息 </a>

mcguide/10-新内容/3-编辑器插件/1-编辑器插件总览.md

@@ -0,0 +1,14 @@
+---
+front: 	https://nie.res.netease.com/r/pic/20221108/151b6d0d-5ea5-43fc-a346-45c25572a2ca.gif
+hard: 入门
+time: 2分钟
+---
+
+# 编辑器插件总览
+
+编辑器插件是指开发者可以通过特定的API开发和定制MC Studio中编辑器内容的功能。
+您可以大幅度的定制自己常用的编辑器变成自己最顺手的工具链，还可以把这套工具链分享给其他开发者进行使用。
+
+## 公测时间
+
+目前编辑器插件还处于实验性阶段，我们无法保证是否会对编辑器产生不可预料的后果，所以目前我们仅邀请部分开发者进行使用，并逐步开放编辑器API给全体开发者。

mcguide/12-入门教程/10-注册成为开发者.md

@@ -5,9 +5,37 @@ time: 10分钟
 selection: true
 ---
 
-# 如何注册开发者
+# 从零开始注册成为开发者
+## 申请材料准备
+### 材料列表
+入驻全过程中，共需要下列材料：
+- 1个网易邮箱账号（推荐是163邮箱，126邮箱无法被添加为协作成员）
+- 1个手机号码
+- 本人身份证号和姓名
+- 1个自己的QQ号
+银行卡认证全过程中，共需要下列材料：
+- 本人有效身份证
+- 本人开户的银行卡
+> 如果想注册企业开发者，也需要先注册个人开发者再转企业开发者。
+### 材料准备攻略
+- 1.本人身份证号和姓名
+  如果您不知道您的身份证号，请您拿出自己的二代身份证卡片，翻到背面（人像面），下方有【公民身份号码】，请将这18位的号码输入到输入框中，若知晓则直接填写。
+- 2.有效身份证
+  如果您没有申领身份证，则请前往属地派出所申领您的身份证。若您的身份证已过期，则请前往属地派出所换领您的身份证。注册身份证必须在有效期内，若有则跳过。
+- 3.QQ号
+  前往QQ官网，下载客户端并注册QQ，将信息页面打开，复制自己的QQ号，若有则直接填写。
+- 4.网易邮箱账号
+  前往[网易邮箱注册](https://zc.reg.163.com/regInitialized#/)，注册一个账号，若有则跳过。
+- 5.手机号码
+  前往营业厅办理1张手机卡，未成年人需要监护人办理，若有则跳过。
+- 6.本人开户的银行卡
+  首先请先确定自己想要办哪家银行的银行卡，建议先在网上查询好哪家银行的网点比较近或比较好。
+按照政策规定，16岁以下的未成年人办理银行卡需要监护人陪同办理，16岁以上、18岁以下的未成年人可以自行办理，也可以监护人陪同办理，18岁以上的成年人可以自行办理。**具体以各地区各银行各网点规定为准**
+  然后，前往网点，说明是开户人是您，让工作人员帮您开户，开户成功给到卡片后，**请核实卡片是否为I类账户，开户人是否为您的名字**。（**若开户人不是本人，则会打款失败，若不是I类账户，则会有限额，收益过多时，会打款失败**）
+- 至此银行卡办理流程结束，若有则跳过。
+## 如何注册开发者
 
-首先，在 **官网** 中找到注册页面（[或点击此处直接进入网址](https://mcdev.webapp.163.com/#/login) ）
+首先，在 **官网** 中找到注册页面（[或点击此处直接进入开发者内容管理网址](https://mcdev.webapp.163.com/#/login) ）
 
 1 - 在搜索引擎中，搜索“我的世界”找到[官网](http://mc.163.com/)，点击右上角 **【进入官网】** 按钮
 
@@ -17,13 +45,27 @@ selection: true
 
 ![2](./images/0_2.png)
 
-3 - 跳转至新的页面，根据提示填入信息，并勾选同意《隐私协议》，点击 **【注册】** 按钮（注意：开发者昵称注册后不可修改）。
+3 - 跳转至新的页面，根据提示填入信息和**真实姓名、身份证号（新增）**，并勾选同意《隐私协议》，点击 **【注册】** 按钮（注意：开发者昵称注册后每90天可以修改1次）。
 
 ![4](./images/0_4.png)
+> 每个信息的用途：
+> 
+> 开发者邮箱：开发者账号的唯一标识符
+> 
+> 开发者昵称：资源中心、开发者平台、MCStudio显示的昵称
+> 
+> 手机号码：手机号码用于接收平台短信通知
+> 
+> QQ号码：目前没有实际用途
+> 
+> 真实姓名：实名认证
+> 
+> 身份证号：实名认证
+- 注：**1个身份证号只能实名1个开发者账号，请谨慎选择账号注册，注册后非特殊情况不支持修改，注销无法释放身份证信息。**
 
-4 - 成功入驻后，需要进行实名认证，填写真实姓名、身份证、银行卡等信息，点击 **【去完善】** 跳转至实名认证界面。
+4 - 成功入驻后，需要进行银行卡认证，填写身份证、银行卡等信息，点击 **【申请银行卡认证】** 跳转至银行卡认证界面。
 
-![5](./images/0_5.png)
+![5](./images/0_5.jpg)
 
 ![5.1](./images/0_6.png)
 
@@ -31,33 +73,16 @@ selection: true
 
 ![5.2](./images/0_7.png)
 
+## 如何个人开发者转企业开发者
+1. 点击开发者平台右上角的头像，点击“申请企业开发者认证”。
+2. 提交认证信息，等待审核通过，一般在10个工作日内给结果。
+## 如何企业开发者转个人开发者
+目前**不支持**手动转回个人开发者，需要等待年审提出转个人申请。
 ## 开发者注册常见问题答疑
 
 ### 账号审核时间
 
-开发者账号审核通过一般在 **7 天工作日。**
-
-开发者账号催审请通过发送邮件至 **minecraftstarter@163.com** 与官方取得联系。
-
-邮件标题为：【开发者信息审核催审】+ 开发者昵称 + 开发者账号
-
-邮件内容为：
-
-> 开发者账号：xxxx@xxx.com
->
-> 开发者昵称：xxx
->
-> 真实姓名：xxx
->
-> 手机号：xxx
->
-> 联系QQ：xxx
->
-> 身份证号：xxx
->
-> 提交时间：xxx
-
-
+开发者账号审核通过一般在 **7 个工作日** ，请耐心等待。
 
 ### 选择符合自身实际情况的结算方式
 
@@ -86,7 +111,7 @@ selection: true
 
 ### 若在规定期限内结算收益，但在打款时未拿到款项
 
-在通常情况下，在结算收益后会在30个工作日左右收到款项。如果超出正常结算周期仍然没收到款 项，请检查您的资料信息是否有误。
+在通常情况下，若点击结算的时间为工作日，在结算收益后会在当天或次日收到款项。如果超出正常结算周期仍然没收到款项，请检查您的资料信息是否有误。
 
 1. 若出现银行卡信息错误导致收益无法收到的，官方会为账号打开 **“更新结算信息”** 入口，请尽快点击开发者平台右上方头像，在个人信息窗口找到 **"更换结算信息"** 入口，上传正确的结算资料等待审核。打款失败的款目会在审核通过后的下一周到账。如无及时更改将会影响后续的正常结算的流程，敬请了解。
 2. 若出现过去可以正常收款，但在之后出现超出结算周期未收到款项。可以在  **【开发者平台】**  -  **【开发者常见问题答疑】**  -  **【反馈其他问题】**  与我们取得联系，填写表单时，请记得写好 **联系方式** 。在通常情况下，官方人员会通过留下的联系方式与您取得联系。
@@ -96,8 +121,8 @@ selection: true
 
 ### 想要注销开发者/UP主，请问要怎么做呢？
 
-进入开发者平台后，点击右上角的个人昵称呼出 **个人信息窗口** ，点击 **申请注销账号** 按钮，并等待审核通过即可。注销申请提出后不可撤回， **且同个身份证、银行卡信息和手机号只允许注册一个开发者或一个UP主账号。当开发者或UP主账号被注册或注销时，所使用过的个人信息将不再支持作为第二次注册开发者/UP主账号时的凭证资料，请慎重操作。**
+进入开发者平台后，点击右上角的个人昵称呼出 **个人信息窗口** ，点击 **申请注销账号** 按钮，并等待审核通过即可。注销申请提出后不可撤回， **且同个身份证、银行卡信息和手机号只允许注册一个开发者或一个UP主账号。当开发者或UP主账号被注册或注销时，所使用过的个人信息将不再支持作为第二次注册开发者/UP主账号时的凭证资料，请慎重操作。** 
 
 
 
-**温馨提示：由于平台系统功能优化，从2023年5月16日起，平台已对up主带货系统进行逐步关停处理，因此原平台不再开放up主身份进行注册。**
+**温馨提示：由于平台系统功能优化，从2023年5月16日起，平台已对up主带货系统进行逐步关停处理，因此原平台不再开放up主身份进行注册。**

mcguide/12-入门教程/5-学习路线导览.md

@@ -230,11 +230,11 @@ selection: true
 
 网络服开发者简称“服主”，服主在申请成为开发者之后，还需要申请测试机器，用于网络服的部署开发。开发完成后，需要进行提审，申请正式机器，用于最终上线。
 
-测试机器申请可查看教程：<a href="../../mcguide/27-网络游戏/课程1：成为Apollo服主及相关准备/第3节：入驻申请.html">入驻申请</a>。
+测试机器申请可查看教程：<a href="../../mcguide/27-手机网络游戏/课程1：成为Apollo服主及相关准备/第3节：入驻申请.html">入驻申请</a>。
 
-获得测试机器之后，需要连接开发机，可查看课程：<a href="../../mcguide/27-网络游戏/课程1：成为Apollo服主及相关准备/第5节：连接开发机.html">连接开发机</a>。
+获得测试机器之后，需要连接开发机，可查看课程：<a href="../../mcguide/27-手机网络游戏/课程1：成为Apollo服主及相关准备/第5节：连接开发机.html">连接开发机</a>。
 
-机器连接成功之后，可以按照指引视频，完成一系列的基本操作。可查看课程：<a href="../../mcguide/27-网络游戏/课程3：简易网络服模板部署与常见操作/第1节：简易网络服视频教程.html">简易网络服视频教程</a>。
+机器连接成功之后，可以按照指引视频，完成一系列的基本操作。可查看课程：<a href="../../mcguide/27-手机网络游戏/课程3：简易网络服模板部署与常见操作/第1节：简易网络服视频教程.html">简易网络服视频教程</a>。
 
 其余的教学内容简介详见官网——教学中心——网络游戏以及官网——在线课程——网络服插件教程。
 

mcguide/16-美术/6-模型和动作/6-模型规范指南.md

@@ -1,6 +1,8 @@
 ---
-front: 进阶
+front: https://nie.res.netease.com/r/pic/20220408/fd58eff7-ab4c-4f98-94b5-87912c6e8e4d.png
+hard: 入门
 time: 15分钟
+selection: true
 ---
 
 # 模型规范指南
@@ -11,9 +13,13 @@ time: 15分钟
 
 现已开放官方模型规范，开发者们请参考并遵循。新作品通过规范指南进行UV、动画等的制作。已有作品则可以通过SDK判断是否需要修改Blockbench模型，确保模组能够与官方皮肤良好配合，为玩家带来更加一致、流畅的游戏体验判断是否需要修改Blockbench模型，确保模组能够与官方皮肤良好配合，为玩家带来更加一致、流畅的游戏体验
 
-## 模型模板下载
+## 资源提供
 
-当前官方提供的“多关节”结构Blockbench模型已经能满足大部分的模组开发者，请开发者下载[官方规范player模型文件](https://g79.gdl.netease.com/official_steve_model.zip)
+当前官方提供的“多关节”结构Blockbench模型已经能满足大部分的模组开发者
+
+- 请开发者下载[官方规范player模型文件](https://g79.gdl.netease.com/official_steve_model.zip)
+
+- 手机端则可在开平下载**更新至3.5测试端**，在邮件**领取测试用4D皮肤**，测试模组与4D皮肤的兼容性
 
 ## 兼容分类
 
@@ -37,9 +43,10 @@ time: 15分钟
 - 开发者可以结合以下Mod SDK，判断是否需要更换模型
 - 建议穿戴史诗及以上多关节官方4d皮肤，在模组对皮肤兼容度较差的前提下，不进行玩家模型修改
 - 其余情况开发者也可以使用接口判断更换模型的必要性
-	- [IsOfficialSkin](../../../mcdocs/1-ModAPI-beta/接口/玩家/属性.md#isofficialskin) —— 获取玩家穿戴的皮肤是否为官方4d皮肤
-	- [IsHighLevelOfficialSkin](../../../mcdocs/1-ModAPI-beta/接口/玩家/属性.md#ishighlevelofficialskin) —— 获取玩家穿戴的皮肤是否为史诗及以上的官方4d皮肤
-	- [IsHighLevelMultiJointOfficialSkin](../../../mcdocs/1-ModAPI-beta/接口/玩家/属性.md#ishighlevelmultijointofficialskin) —— 获取玩家穿戴的皮肤是否为史诗及以上的多关节官方4d皮肤
+	- [IsOfficialSkin](../../../mcdocs/1-ModAPI/接口/玩家/属性.md#isofficialskin) —— 获取玩家穿戴的皮肤是否为官方4d皮肤
+	- [IsMultiJointOfficialSkin](../../../mcdocs/1-ModAPI/接口/玩家/属性.md#ismultijointofficialskin) —— 获取玩家穿戴的皮肤是否为多关节官方4d皮肤
+	- [IsHighLevelOfficialSkin](../../../mcdocs/1-ModAPI/接口/玩家/属性.md#ishighlevelofficialskin) —— 获取玩家穿戴的皮肤是否为史诗及以上的官方4d皮肤
+	- [IsHighLevelMultiJointOfficialSkin](../../../mcdocs/1-ModAPI/接口/玩家/属性.md#ishighlevelmultijointofficialskin) —— 获取玩家穿戴的皮肤是否为史诗及以上的多关节官方4d皮肤
 4. 动画制作：人形角色，必须修改bb模型的，建议使用官方模型并用其进行动画制作
 5. 其他：不建议直接修改 player.entity.json 和 player.render_controllers.json，如果改了请务必在官方的规范下进行拓展
 
@@ -144,7 +151,66 @@ def onUpdatePlayerSkinClient(self,args):
     comp.IsHighLevelMultiJointOfficialSkin(args['playerId']) # 返回bool：为官方史诗级以上的多关节皮肤
 ```
 
-### 测试服测试
-为方便开发者测试4D皮肤与模组本身的兼容性，官方在开发者测试服提供了测试用4D皮肤，可通过邮件领取
+### 测试皮肤
 
+#### 手机端测试
 
+为方便开发者测试4D皮肤与模组本身的兼容性，官方在**开发者测试服（手机自测）**提供了测试用4D皮肤，可通过邮件领取
+
+**注意：** 
+
+- 请各位开发者更新到3.5测试服，3.4该测试皮肤不会生效
+
+- 自3.7版本之后，渲染龙包体无法使用4D皮肤。开发者请勿在游戏内视频设置中切换为渲染龙，这将导致断言报错
+
+#### MC Studio
+
+为方便开发者在 PC 端直接进行 4D 皮肤与模组的兼容性调试，MC Studio 在 3.6 版本起正式支持 4D 皮肤测试。开发者可以灵活选择手机端和MC Studio，进行模组与4D皮肤的兼容性测试
+
+##### 新增皮肤介绍
+
+|  皮肤名      | 皮肤品质  | 是否为多关节  |  皮肤预览      | 
+|--------------|----------|--------------|--------------|
+| 4D测试皮肤   | 传说      |    是        |![](./resources/0_3.png)  |
+| 黑洞之心     | 传说      |    否        |![](./resources/0_4.png)  |
+| 云霄战姬     | 稀有      |    否        |![](./resources/0_5.png)  |
+| 4D学生晴音   | 稀有      |    否        |![](./resources/0_6.png)  |
+
+##### 使用教程
+
+更新MC Studio至1.1.48版本（发布日期：11月26日）
+
+1. 新建开发测试
+
+新建开发测试按钮，选择3.6（或以上）版本
+
+注意：4D皮肤仅支持3.6及以上版本使用
+
+![](./resources/0_7.png)
+
+选择下方的皮肤选项，可以看到除了默认的史蒂夫和爱丽克丝以外新增4款4D皮肤皮肤，选择皮肤后即可开始测试
+
+![](./resources/0_8.png)
+
+2. 配置已有存档
+
+对于已有的3.6测试存档，可以点击配置
+
+![](./resources/0_9.png)
+
+在配置界面中可以切换下方的皮肤
+
+![](./resources/0_10.png)
+
+3. 局内切换
+进入游戏时，会触发一次UpdatePlayerSkinClient客户端事件
+
+点击右上角菜单，选择切换皮肤选项，即可选择其他4D皮肤
+
+![](./resources/0_11.png)
+
+说明：
+
+1.菜单切换4D皮肤是模拟玩家使用局内更衣室切换皮肤的情况
+
+2.菜单切换会触发UpdatePlayerSkinClientEvent事件，开发者可以使用IsHighLevelOfficialSkin、IsOfficialSkin、IsHighLevelMultiJointOfficialSkin、IsMultiJointOfficialSkin接口进行调试与兼容

mcguide/16-美术/9-特效/21-原版特效属性详细说明.md

@@ -378,13 +378,16 @@ mc里的特效实例有两种承载方式，一种是在世界空间单独存在
         动画是否循环播放，如果设置为false，则会在每个发射器的生命周期开始时重新播放动画。
       - `size`
         设置发射出来的骨骼模型的大小，支持molang表达式。
+      - `ignore_lighting`
+        设置粒子模型是否受到环境光照影响，与实体json中ignore_lighting作用相同。该值设置为true时，粒子模型不受环境光影响，始终保持默认亮度。
 
     ```json
     "components": {
       "netease:particle_appearance_FBX": {
         "play_animation": "happy",
         "loop": true,
-        "size": [1, 1, 1]
+        "size": [1, 1, 1],
+        "ignore_lighting": false
       },
       ...
     }

mcguide/18-界面与交互/30-UI说明文档.md

@@ -1188,12 +1188,6 @@ JSON如下：
 		"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": {
@@ -1246,104 +1240,6 @@ button是按钮控件，按钮有四种状态，分别为default/hover/pressed/l
 下面是一个使用了三种状态的按钮，我们继承common.button里的属性，无需自己再定义default_control等属性。
 
 ```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"
-   }
-}
-```
 "button0@common.button": {
 	"size": [100, 50],
 	"button_mappings": [], //和$pressed_button_name只能二选一
@@ -1863,6 +1759,8 @@ PC和IOS平台没有这个问题
 
 而对于scrolling_content的绝对路径，一共有以下两种，可以通过UI-API<a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI界面.html#getallchildrenpath">GetAllChildrenPath</a>清楚的看到。
 
+#### 特别注意
+
 ```python
 scroll_view_path = "/scroll_view0"
 touch_path = scroll_view_path + "/scroll_touch/scroll_view/panel/background_and_viewport/scrolling_view_port/scrolling_content"
@@ -2372,7 +2270,7 @@ hover事件的触发本质上是与鼠标悬浮相关，在PC模式中，当鼠
 
 UI编辑器暂时不支持编辑
 
-### MiniMap
+### mini\_map
 
 该控件可以在UI上画小地图，需要继承mini_map命名空间下的mini_map_wrapper控件。
 
@@ -2423,290 +2321,19 @@ UI编辑器暂时不支持编辑
 |           $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                       |
-
-<img src="./picture/IntroduceUI/IntroduceUI-50.png" alt="图片描述" style="display: block; margin-left: 0;" />
-
-下图为UI编辑器中颜色渐变控件的属性编辑面板
-
-<img src="./picture/IntroduceUI/IntroduceUI-51.png" alt="图片描述" style="display: block; margin-left: 0;" />
-
-| 变量         | 解释                                                   |
-| ------------ | ------------------------------------------------------ |
-| 渐变起始颜色 | 对应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
-import mod.client.extraClientApi as clientApi
-
-ScreenNode = clientApi.GetScreenNodeCls()
-
-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
-import mod.client.extraClientApi as clientApi
-
-ViewBinder = clientApi.GetViewBinderCls()
-
-@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
-import mod.client.extraClientApi as clientApi
-
-ViewBinder = clientApi.GetViewBinderCls()
-
-@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
-from mod.common.mod import Mod
-@Mod.Binding(name = "myModName", version = "0.1")
-class MyModClass(object):
-    def __init__(self):
-        pass
-```
-
-### 界面创建流程及生命周期
+### 界面创建流程
 
 界面在<a href="../../mcdocs/1-ModAPI/事件/UI.html#uiinitfinished" rel="noopenner"> UiInitFinished </a>事件发送之后就可以开始创建
 
-创建UI的第一步是UI的注册，通过调用<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#registerui" rel="noopenner"> RegisterUI </a>接口，将想开启UI的相关数据进行注册。同一UI只需要注册一次即可
+创建UI的第一步是UI的注册，通过调用<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#registerui" rel="noopenner"> RegisterUI </a>接口，传入UI类路径和JSON控件路径注册UI，同一UI只需要注册一次即可。
 
 注册完成之后就可以在需要的时候实例化UI，可使用的接口有<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#createui" rel="noopenner"> CreateUI </a>和<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#pushscreen" rel="noopenner"> PushScreen </a>两种。使用<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#createui" rel="noopenner"> CreateUI </a>生成的界面都生成在操作UI下，不同的生成参数UI层级不同，而使用<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#pushscreen" rel="noopenner"> PushScreen </a>生成的界面以堆栈管理的方式生成，该界面生成时上一个<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#pushscreen" rel="noopenner"> PushScreen </a>生成的界面就会被隐藏。值得注意的是，MC原生界面（比如暂停界面，背包界面等）也是类似<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#pushscreen" rel="noopenner"> PushScreen </a>的方式加载进来，并以堆栈管理。
 
 在UI创建完成之后，可以调用<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#getui" rel="noopenner"> GetUI </a>接口拿到UI对应的ScreenNode实例。
+
 如果想获取MC原生界面的实例，则需要监听原生界面Push进来的事件<a href="../../mcdocs/1-ModAPI/事件/UI.html#pushscreenevent" rel="noopenner"> PushScreenEvent </a>，然后在事件回调中调用接口<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#gettoppushedui" rel="noopenner"> GetTopPushedUI </a>。
 
 每个ScreenNode都有生命周期函数，生命周期函数会被自动在以下情况下调用，重写函数可以完成一些逻辑。
@@ -2716,9 +2343,38 @@ class MyModClass(object):
 | <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI界面.html#create" rel="noopenner"> Create </a> | UI创建成功时调用         |
 | <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI界面.html#onactive" rel="noopenner"> OnActive </a> | UI重新回到栈顶时调用     |
 | <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI界面.html#ondeactive" rel="noopenner"> OnDeactive </a> | 栈顶UI有其他UI入栈时调用 |
+| <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI界面.html#update" rel="noopenner"> Update </a> | 客户端每帧调用，1秒有30帧 |
 | <a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI界面.html#destroy" rel="noopenner"> Destroy </a> | UI销毁时调用             |
 
 最后，当UI需要销毁时，可以调用ScreenNode实例的<a href="../../mcdocs/1-ModAPI/接口/自定义UI/UI界面.html#setremove" rel="noopenner"> SetRemove </a>接口，此外使用<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#pushscreen" rel="noopenner"> PushScreen </a>接口创建的界面还可以使用<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#popscreen" rel="noopenner"> PopScreen </a>接口进行销毁。
+
+### 编写UI类
+
+UI类用于编写界面逻辑，需要在<a href="../../mcdocs/1-ModAPI/接口/自定义UI/通用.html#registerui" rel="noopenner"> RegisterUI </a>时传入UI类的路径。一个客户端类可以对应多个UI类。UI类一般包含以下内容：
+
+```python
+import client.extraClientApi as clientApi
+ScreenNode = clientApi.GetScreenNodeCls()
+ViewBinder = clientApi.GetViewBinderCls()
+ViewRequest = clientApi.GetViewViewRequestCls()
+Client = clientApi.GetSystem('xxxxMod', 'xxxxClientSystem')
+CF = clientApi.GetEngineCompFactory()
+PID = clientApi.GetLocalPlayerId()
+
+class uiName(ScreenNode):
+    def __init__(self, namespace, name, param):
+        ScreenNode.__init__(self, namespace, name, param)
+
+    def Create(self):
+        pass
+
+    def Destroy(self):
+        pass
+
+    def Update(self):
+        pass
+```
+
 |      变量      | 解释                                 |
 | :------------: | :----------------------------------- |
 | extraClientApi | 我们开发的Client端Api接口文件        |
@@ -2858,11 +2514,9 @@ button_data: {
 在字符串中嵌入`<link>link_data</link>`样式会被解析成超链接，外观和普通文本无异但可以被点击，link_data为特殊化数据，开发者可以在其中添加符合JSON格式的自定义数据，在点击富文本中对应超链接时会将link_data通过回调函数整个返回，以下属性为必须属性，text表示显示文本，format_code表示该段显示文本的样式代码，注意，基岩版的文本控件不支持下划线和删除线。
 
 ```json
-{
-    "link_data":{
-        "text":"末影人",
-        "format_code":"§2"
-    }
+link_data: {
+	"text": "末影人",
+	"format_code": "§2"
 }
 ```
 

mcguide/20-玩法开发/13-模组SDK编程/2-Python脚本开发/0-脚本开发入门.md

@@ -206,7 +206,7 @@ python是一门很容易入门的编程语言，没有接触过python的开发
 | ----------------------- | ------------------------------------------------------------ |
 | tutorialScripts         | python脚本的根目录，该目录的脚本会被加到python运行环境下，可以从该路径开始import脚本文件，例如from tutorilaScripts import modMain |
 | \_\_init\_\_.py         | 是python module的标识，表示这是一个可以import的module，同时也可以做一些初始化的操作,内容可为空，但是文件必须有。 |
-| modMain.py              | 必须有该文件，用来初始化我们的Mod                            |
+| modMain.py              | 必须有该文件，用来初始化我们的Mod。**因为会基于该文件的层级进行打包，所以该文件必须放在Scripts（脚本）文件夹下，否则会导致Mod在手机端失效**            |
 | tutorialClientSystem.py | 执行客户端逻辑的system                                       |
 | tutorialServerSystem.py | 执行服务器逻辑的system                                       |
 

mcguide/20-玩法开发/13-模组SDK编程/2-Python脚本开发/103-3.7版本物品id变更.md

@@ -0,0 +1,257 @@
+# 3.7版本物品id变更
+
+## 简介
+
+微软在1.21.50继续修改了部分方块ID，取消了附加值，相关链接请参阅[基岩版扁平化](https://zh.minecraft.wiki/w/%E5%AE%98%E6%96%B9%E9%A1%B5%E9%9D%A2/%E5%9F%BA%E5%B2%A9%E7%89%88%E6%89%81%E5%B9%B3%E5%8C%96)，请开发者注意适配。
+
+## 处理方法
+
+在ModSDK的接口与事件中，我们针对上述情况做了以下处理：
+
+1. 对于返回物品信息字典的接口与事件：
+
+ newItemName及newAuxValue返回新版名称与附加值。
+
+ 原字段itemName及auxValue返回旧版名称与附加值。
+
+2. 对于接受物品信息字典的接口与事件：
+
+ 当字典存在newItemName及newAuxValue时，使用这两个字段。
+
+ 不存在时，使用旧字段itemName及auxValue。
+
+## 注意事项
+
+* 通过附加值获取获取方块状态接口没有做兼容，例如GetBlockAuxValueFromStates、GetBlockStatesFromAuxValue、GetBlockStates、SetBlockStates，如果您的组件对此有依赖，则需要对这次的改动自行做兼容处理。
+
+* **开发完成或正在开发的组件，建议统一采用newItemName及newAuxValue字段，也不要新旧字段混用。**
+
+* 某些写法可能会失效，例如
+
+  ```python
+  # 获取itemDict，然后在他基础上修改itemName或auxValue后再用来生成
+  itemdict = GetPlayerItem()
+  itemdict['itemName'] = 'xxx'
+  itemdict['auxValue'] = itemdict['auxValue']+1
+  SpawnItemToPlayerInv(itemdict)
+  ```
+
+  因为GetPlayerItem返回的itemDict含有新字段，再传入SpawnItemToPlayerInv时，会读取新字段生成物品，因此对原字段的修改无效。
+
+## 版本变更方块数据
+
+以下为3.7版本变更了id、名称等的物品列表，表格内的名称省略了minecraft命名空间。
+
+## 统计信息
+
+- 变更项数量: 89
+- 仅名称变更: 12
+- 新增项数量: 69
+- 移除项数量: 17
+
+### 变更项
+
+| 新中文名 | 旧中文名 | 旧命名 | 旧附加值 | 新命名 | 新附加值 |
+| :------ | ------ | ------ | ------ | ------ | ------ |
+| 蒲公英 | 蒲公英 | yellow_flower | 0 | dandelion | 0 
+| 虫蚀石头 | 虫蚀石头 | monster_egg | 0 | infested_stone | 0 
+| 石砖 | 石砖 | stonebrick | 0 | stone_bricks | 0 
+| 蘑菇柄 | 蘑菇柄 | brown_mushroom_block | 15 | mushroom_stem | 0 
+| 双红砂岩台阶 | 红砂岩双层台阶 | double_stone_block_slab2 | 0 | red_sandstone_double_slab | 0 
+| 红砂岩台阶 | 红砂岩台阶 | stone_block_slab2 | 0 | red_sandstone_slab | 0 
+| 末地石砖台阶 | 末地石砖台阶 | stone_block_slab3 | 0 | end_stone_brick_slab | 0 
+| 苔石砖台阶 | 苔石砖台阶 | stone_block_slab4 | 0 | mossy_stone_brick_slab | 0 
+| 光源方块-亮度0 | 光源方块 | light_block | 0 | light_block_0 | 0 
+| 虫蚀圆石 | 虫蚀圆石 | monster_egg | 1 | infested_cobblestone | 0 
+| 虫蚀石砖 | 虫蚀石砖 | monster_egg | 2 | infested_stone_bricks | 0 
+| 虫蚀苔石砖 | 虫蚀苔石砖 | monster_egg | 3 | infested_mossy_stone_bricks | 0 
+| 虫蚀裂纹石砖 | 虫蚀裂纹石砖 | monster_egg | 4 | infested_cracked_stone_bricks | 0 
+| 虫蚀雕纹石砖 | 虫蚀雕纹石砖 | monster_egg | 5 | infested_chiseled_stone_bricks | 0 
+| 苔石砖 | 苔石砖 | stonebrick | 1 | mossy_stone_bricks | 0 
+| 裂纹石砖 | 裂纹石砖 | stonebrick | 2 | cracked_stone_bricks | 0 
+| 雕纹石砖 | 雕纹石砖 | stonebrick | 3 | chiseled_stone_bricks | 0 
+| 双砂岩台阶 | 砂岩双层台阶 | double_stone_block_slab | 1 | sandstone_double_slab | 0 
+| 双圆石台阶 | 圆石双层台阶 | double_stone_block_slab | 3 | cobblestone_double_slab | 0 
+| 双红砖台阶 | 红砖双层台阶 | double_stone_block_slab | 4 | brick_double_slab | 0 
+| 双石砖台阶 | 石砖双层台阶 | double_stone_block_slab | 5 | stone_brick_double_slab | 0 
+| 双石英台阶 | 石英双层台阶 | double_stone_block_slab | 6 | quartz_double_slab | 0 
+| 双下界砖台阶 | 下界砖双层台阶 | double_stone_block_slab | 7 | nether_brick_double_slab | 0 
+| 紫珀台阶 | 紫珀台阶 | stone_block_slab2 | 1 | purpur_slab | 0 
+| 海晶石台阶 | 海晶石台阶 | stone_block_slab2 | 2 | prismarine_slab | 0 
+| 暗海晶石台阶 | 暗海晶石台阶 | stone_block_slab2 | 3 | dark_prismarine_slab | 0 
+| 海晶石砖台阶 | 海晶石砖台阶 | stone_block_slab2 | 4 | prismarine_brick_slab | 0 
+| 苔石台阶 | 苔石台阶 | stone_block_slab2 | 5 | mossy_cobblestone_slab | 0 
+| 平滑砂岩台阶 | 平滑砂岩台阶 | stone_block_slab2 | 6 | smooth_sandstone_slab | 0 
+| 红色下界砖台阶 | 红色下界砖台阶 | stone_block_slab2 | 7 | red_nether_brick_slab | 0 
+| 平滑红砂岩台阶 | 平滑红砂岩台阶 | stone_block_slab3 | 1 | smooth_red_sandstone_slab | 0 
+| 磨制安山岩台阶 | 磨制安山岩台阶 | stone_block_slab3 | 2 | polished_andesite_slab | 0 
+| 安山岩台阶 | 安山岩台阶 | stone_block_slab3 | 3 | andesite_slab | 0 
+| 闪长岩台阶 | 闪长岩台阶 | stone_block_slab3 | 4 | diorite_slab | 0 
+| 磨制闪长岩台阶 | 磨制闪长岩台阶 | stone_block_slab3 | 5 | polished_diorite_slab | 0 
+| 花岗岩台阶 | 花岗岩台阶 | stone_block_slab3 | 6 | granite_slab | 0 
+| 磨制花岗岩台阶 | 磨制花岗岩台阶 | stone_block_slab3 | 7 | polished_granite_slab | 0 
+| 平滑石英台阶 | 平滑石英台阶 | stone_block_slab4 | 1 | smooth_quartz_slab | 0 
+| 石头台阶 | 石头台阶 | stone_block_slab4 | 2 | normal_stone_slab | 0 
+| 切制砂岩台阶 | 切制砂岩台阶 | stone_block_slab4 | 3 | cut_sandstone_slab | 0 
+| 切制红砂岩台阶 | 切制红砂岩台阶 | stone_block_slab4 | 4 | cut_red_sandstone_slab | 0 
+| 双石化橡木台阶 | 石化橡木双层台阶 | double_stone_block_slab | 2 | petrified_oak_double_slab | 0 
+| 双紫珀台阶 | 双紫珀台阶 | double_stone_block_slab2 | 1 | purpur_double_slab | 0 
+| 双海晶石台阶 | 双海晶石台阶 | double_stone_block_slab2 | 2 | prismarine_double_slab | 0 
+| 双暗海晶石台阶 | 双暗海晶石台阶 | double_stone_block_slab2 | 3 | dark_prismarine_double_slab | 0 
+| 双海晶石砖台阶 | 双海晶石砖台阶 | double_stone_block_slab2 | 4 | prismarine_brick_double_slab | 0 
+| 双苔石台阶 | 双苔石台阶 | double_stone_block_slab2 | 5 | mossy_cobblestone_double_slab | 0 
+| 双平滑砂岩台阶 | 双平滑砂岩台阶 | double_stone_block_slab2 | 6 | smooth_sandstone_double_slab | 0 
+| 双红色下界砖台阶 | 双红色下界砖台阶 | double_stone_block_slab2 | 7 | red_nether_brick_double_slab | 0 
+| 双平滑红砂岩台阶 | 双平滑红砂岩台阶 | double_stone_block_slab3 | 1 | smooth_red_sandstone_double_slab | 0 
+| 双磨制安山岩台阶 | 双磨制安山岩台阶 | double_stone_block_slab3 | 2 | polished_andesite_double_slab | 0 
+| 双安山岩台阶 | 双安山岩台阶 | double_stone_block_slab3 | 3 | andesite_double_slab | 0 
+| 双闪长岩台阶 | 双闪长岩台阶 | double_stone_block_slab3 | 4 | diorite_double_slab | 0 
+| 双磨制闪长岩台阶 | 双磨制闪长岩台阶 | double_stone_block_slab3 | 5 | polished_diorite_double_slab | 0 
+| 双花岗岩台阶 | 双花岗岩台阶 | double_stone_block_slab3 | 6 | granite_double_slab | 0 
+| 双磨制花岗岩台阶 | 双磨制花岗岩台阶 | double_stone_block_slab3 | 7 | polished_granite_double_slab | 0 
+| 双平滑石英台阶 | 双平滑石英台阶 | double_stone_block_slab4 | 1 | smooth_quartz_double_slab | 0 
+| 双石台阶 | 双石台阶 | double_stone_block_slab4 | 2 | normal_stone_double_slab | 0 
+| 双切制砂岩台阶 | 双切制砂岩台阶 | double_stone_block_slab4 | 3 | cut_sandstone_double_slab | 0 
+| 双切制红砂岩台阶 | 双切制红砂岩台阶 | double_stone_block_slab4 | 4 | cut_red_sandstone_double_slab | 0 
+| 雕纹砂岩 | 雕纹砂岩 | sandstone | 1 | chiseled_sandstone | 0 
+| 切制砂岩 | 切制砂岩 | sandstone | 2 | cut_sandstone | 0 
+| 平滑砂岩 | 平滑砂岩 | sandstone | 3 | smooth_sandstone | 0 
+| 暗海晶石 | 暗海晶石 | prismarine | 1 | dark_prismarine | 0 
+| 海晶石砖 | 海晶石砖 | prismarine | 2 | prismarine_bricks | 0 
+| 红沙 | 红沙 | sand | 1 | red_sand | 0 
+| 雕纹石英块 | 雕纹石英块 | quartz_block | 1 | chiseled_quartz_block | 0 
+| 石英柱 | 石英柱 | quartz_block | 2 | quartz_pillar | 0 
+| 平滑石英块 | 平滑石英块 | quartz_block | 3 | smooth_quartz | 0 
+| 雕纹红砂岩 | 雕纹红砂岩 | red_sandstone | 1 | chiseled_red_sandstone | 0 
+| 切制红砂岩 | 切制红砂岩 | red_sandstone | 2 | cut_red_sandstone | 0 
+| 平滑红砂岩 | 平滑红砂岩 | red_sandstone | 3 | smooth_red_sandstone | 0 
+| 开裂的铁砧 | 开裂的铁砧 | anvil | 4 | chipped_anvil | 0 
+| 损坏的铁砧 | 损坏的铁砧 | anvil | 8 | damaged_anvil | 0 
+| 砂土 | 砂土 | dirt | 1 | coarse_dirt | 0 
+| 苔石墙 | 苔石墙 | cobblestone_wall | 1 | mossy_cobblestone_wall | 0 
+| 花岗岩墙 | 花岗岩墙 | cobblestone_wall | 2 | granite_wall | 0 
+| 闪长岩墙 | 闪长岩墙 | cobblestone_wall | 3 | diorite_wall | 0 
+| 安山岩墙 | 安山岩墙 | cobblestone_wall | 4 | andesite_wall | 0 
+| 砂岩墙 | 砂岩墙 | cobblestone_wall | 5 | sandstone_wall | 0 
+| 红砖墙 | 红砖墙 | cobblestone_wall | 6 | brick_wall | 0 
+| 石砖墙 | 石砖墙 | cobblestone_wall | 7 | stone_brick_wall | 0 
+| 苔石砖墙 | 苔石砖墙 | cobblestone_wall | 8 | mossy_stone_brick_wall | 0 
+| 下界砖墙 | 下界砖墙 | cobblestone_wall | 9 | nether_brick_wall | 0 
+| 末地石砖墙 | 末地石砖墙 | cobblestone_wall | 10 | end_stone_brick_wall | 0 
+| 海晶石墙 | 海晶石墙 | cobblestone_wall | 11 | prismarine_wall | 0 
+| 红砂岩墙 | 红砂岩墙 | cobblestone_wall | 12 | red_sandstone_wall | 0 
+| 红色下界砖墙 | 红色下界砖墙 | cobblestone_wall | 13 | red_nether_brick_wall | 0 
+| 湿海绵 | 湿海绵 | sponge | 1 | wet_sponge | 0 
+
+### 仅名称变更（内容不变）
+
+| 新中文名 | 旧中文名 | 英文命名 | 附加值 |
+| :------ | ------ | ------ | ------ |
+| 橡木门 | 木门 | wooden_door | 0 |
+| 双绯红木台阶 | 绯红木双层台阶 | crimson_double_slab | 0 |
+| 双诡异木台阶 | 诡异木双层台阶 | warped_double_slab | 0 |
+| 双深板岩圆石台阶 | 深板岩圆石双层台阶 | cobbled_deepslate_double_slab | 0 |
+| 双磨制深板岩台阶 | 磨制深板岩双层台阶 | polished_deepslate_double_slab | 0 |
+| 双深板岩瓦台阶 | 深板岩瓦双层台阶 | deepslate_tile_double_slab | 0 |
+| 双深板岩砖台阶 | 深板岩砖双层台阶 | deepslate_brick_double_slab | 0 |
+| 悬挂式云杉木告示牌 | 云杉木悬挂告示牌 | spruce_hanging_sign | 0 |
+| 悬挂式白桦木告示牌 | 白桦木悬挂告示牌 | birch_hanging_sign | 0 |
+| 悬挂式金合欢木告示牌 | 金合欢木悬挂告示牌 | acacia_hanging_sign | 0 |
+| 悬挂式深色橡木告示牌 | 深色橡木悬挂告示牌 | dark_oak_hanging_sign | 0 |
+| 双樱花木台阶 | 樱花木双层台阶 | cherry_double_slab | 0 |
+
+### 新增项
+
+| 中文名称 | 英文命名 | 附加值 |
+| :------ | ------ | ------ |
+| 双平滑石头台阶 | smooth_stone_double_slab | 0 |
+| 下界砖 | nether_brick | 0 |
+| 骷髅模型 | skeleton_skull | 0 |
+| 潜声感测器 | sculk_sensor | 0 |
+| 荧光物品展示框 | glow_frame | 0 |
+| 潜声 | sculk | 0 |
+| 红树木门 | mangrove_door | 0 |
+| 红树木告示牌 | mangrove_standing_sign | 0 |
+| 双红树木台阶 | mangrove_double_slab | 0 |
+| 悬挂式橡木告示牌 | oak_hanging_sign | 0 |
+| 悬挂式丛林木告示牌 | jungle_hanging_sign | 0 |
+| 悬挂式绯红木告示牌 | crimson_hanging_sign | 0 |
+| 悬挂式诡异木告示牌 | warped_hanging_sign | 0 |
+| 悬挂式红树木告示牌 | mangrove_hanging_sign | 0 |
+| 悬挂式竹告示牌 | bamboo_hanging_sign | 0 |
+| 悬挂式樱花木告示牌 | cherry_hanging_sign | 0 |
+| 光源方块-亮度1 | light_block_1 | 0 |
+| 光源方块-亮度2 | light_block_2 | 0 |
+| 光源方块-亮度3 | light_block_3 | 0 |
+| 光源方块-亮度4 | light_block_4 | 0 |
+| 光源方块-亮度5 | light_block_5 | 0 |
+| 光源方块-亮度6 | light_block_6 | 0 |
+| 光源方块-亮度7 | light_block_7 | 0 |
+| 光源方块-亮度8 | light_block_8 | 0 |
+| 光源方块-亮度9 | light_block_9 | 0 |
+| 光源方块-亮度10 | light_block_10 | 0 |
+| 光源方块-亮度11 | light_block_11 | 0 |
+| 光源方块-亮度12 | light_block_12 | 0 |
+| 光源方块-亮度13 | light_block_13 | 0 |
+| 光源方块-亮度14 | light_block_14 | 0 |
+| 光源方块-亮度15 | light_block_15 | 0 |
+| 紫珀柱 | purpur_pillar | 0 |
+| 凋灵骷髅模型 | wither_skeleton_skull | 0 |
+| 僵尸模型 | zombie_head | 0 |
+| 模型 | player_head | 0 |
+| 苦力怕模型 | creeper_head | 0 |
+| 龙的模型 | dragon_head | 0 |
+| 猪灵模型 | piglin_head | 0 |
+| 苍白橡木按钮 | pale_oak_button | 0 |
+| 苍白橡木门 | pale_oak_door | 0 |
+| 苍白橡木栅栏 | pale_oak_fence | 0 |
+| 苍白橡木栅栏大门 | pale_oak_fence_gate | 0 |
+| 苍白橡木悬挂告示牌 | pale_oak_hanging_sign | 0 |
+| 去皮苍白橡树原木 | stripped_pale_oak_log | 0 |
+| 苍白橡树原木 | pale_oak_log | 0 |
+| 苍白橡木木板 | pale_oak_planks | 0 |
+| 苍白橡木压力板 | pale_oak_pressure_plate | 0 |
+| 苍白橡木台阶 | pale_oak_slab | 0 |
+| 苍白橡木双台阶 | pale_oak_double_slab | 0 |
+| 苍白橡木楼梯 | pale_oak_stairs | 0 |
+| 苍白橡木活板门 | pale_oak_trapdoor | 0 |
+| 去皮苍白橡木 | stripped_pale_oak_wood | 0 |
+| 苍白橡木 | pale_oak_wood | 0 |
+| 苍白橡木树苗 | pale_oak_sapling | 0 |
+| 苍白橡木树叶 | pale_oak_leaves | 0 |
+| 苍白苔藓块 | pale_moss_block | 0 |
+| 苍白苔藓地毯 | pale_moss_carpet | 0 |
+| 苍白垂须 | pale_hanging_moss | 0 |
+| 嘎枝之心 | creaking_heart | 0 |
+| 树脂砖块 | resin_bricks | 0 |
+| 树脂砖台阶 | resin_brick_slab | 0 |
+| 双树脂砖台阶 | resin_brick_double_slab | 0 |
+| 树脂砖楼梯 | resin_brick_stairs | 0 |
+| 树脂砖墙 | resin_brick_wall | 0 |
+| 张开的眼眸花 | open_eyeblossom | 0 |
+| 闭合的眼眸花 | closed_eyeblossom | 0 |
+| 雕纹树脂砖块 | chiseled_resin_bricks | 0 |
+| 树脂块 | resin_block | 0 |
+| 树脂团 | resin_clump | 0 |
+
+### 移除项
+
+| 中文名称 | 英文命名 | 附加值 |
+| :------ | ------ | ------ |
+| 石头双层台阶 | double_stone_block_slab | 0 |
+| 蘑菇 | brown_mushroom_block | 0 |
+| 下界砖块 | nether_brick | 0 |
+| 生物头颅 | skull | 0 |
+| 紫珀柱子 | purpur_block | 2 |
+| 幽匿感测体 | sculk_sensor | 0 |
+| 幽匿块 | sculk | 0 |
+| 红树林门 | mangrove_door | 0 |
+| 红树林告示牌 | mangrove_standing_sign | 0 |
+| 双红树林台阶 | mangrove_double_slab | 0 |
+| 橡树悬挂告示牌 | oak_hanging_sign | 0 |
+| 丛林悬挂告示牌 | jungle_hanging_sign | 0 |
+| 绯红悬挂告示牌 | crimson_hanging_sign | 0 |
+| 翘曲悬挂告示牌 | warped_hanging_sign | 0 |
+| 红树林悬挂告示牌 | mangrove_hanging_sign | 0 |
+| 竹制悬挂告示牌 | bamboo_hanging_sign | 0 |
+| 樱花悬挂告示牌 | cherry_hanging_sign | 0 |

mcguide/20-玩法开发/13-模组SDK编程/60-Demo示例.md

@@ -10,7 +10,7 @@ time: 分钟
 
 ## 示例下载
 
-下载地址：[示例Demo](https://g79.gdl.netease.com/3.3Demo.zip)。
+下载地址：[示例Demo](https://g79.gdl.netease.com/3.6Demo.zip)。
 
 
 
@@ -175,7 +175,7 @@ time: 分钟
 
 - 自定义云成就-CloudAchievementMod
 
-  展示了[云成就](../../28-成就系统/云成就使用文档.md)的基本用法
+  展示了[云成就](../../29-成就系统/云成就使用文档.md)的基本用法
 
 - 微软粒子发射骨骼模型-NeteaseModelParticleDemo
 

mcguide/20-玩法开发/15-自定义游戏内容/1-自定义物品/9-自定义鱼竿.md

@@ -0,0 +1,94 @@
+---
+front:
+hard: 入门
+time: 分钟
+---
+
+# 自定义鱼竿
+
+## 概述
+
+属于特殊的自定义物品，在支持自定义物品所有特性的基础上，还具有原版鱼竿相关功能，可以自定义鱼线长、鱼线颜色，以及鱼漂，其中鱼漂支持自定义实体
+
+
+
+## 注册
+
+1. 与自定义基础物品的注册1-6步相同
+
+
+1. 在behavior/netease_items_beh的json中添加武器/工具相关的定义，包括：
+
+   custom_item_type为custom_item_type
+
+   一个netease:fishing_hook组件，选填。组件的参数见[json组件](#json组件)
+
+    ```json
+    {
+        "minecraft:item": {
+            "description": {
+                "category": "Custom",
+                "identifier": "customshield:test_fishing_rod",
+                "custom_item_type": "fishing_rod"
+            },
+            "components": {
+                "netease:fishing_hook":{
+                    "hook_entity":["minecraft:creeper"],//代表投掷出的将会是一个苦力怕实体作为鱼漂，苦力实体无AI。
+                    "line_max":50,//代表鱼线可以达到的最长长度（鱼漂与玩家实体的直线距离），超过这个长度后鱼线将会直接断开
+                    "line_color":[0.6, 0.5, 0.3, 1.0]//线的颜色和透明度
+                }
+            }
+        },
+        "format_version": "1.10"
+    }
+    ```
+
+## JSON组件
+
+### 网易components
+
+* netease:fishing_hook
+
+	| 键       | 类型 | 默认值    | 解释                                           |
+	| -------- | ---- | --------- | ---------------------------------------------- |
+	| hook_entity | str  |  | 实体的identify，填入的实体除了无AI以外，支持动画、动画控制器等实体一系列操控 |
+	| line_max | int  | 32 | 代表鱼线可以达到的最长长度（鱼漂与玩家实体的直线距离），超过这个长度后鱼线将会直接断开。如果不配置代表和原版鱼线一致为32米 |
+	| line_color | list(rgba)  |  | 代表鱼线的初始颜色与透明度，如果不配置默认为原版鱼竿黑色 |
+
+
+## 新增的事件和接口
+
+### 事件
+
+* <a href="../../../../mcdocs/1-ModAPI/事件/玩家.html#playerfishingserverevent">PlayerFishingServerEvent</a>
+
+	服务端，钓鱼成功收杆时触发事件
+
+* <a href="../../../../mcdocs/1-ModAPI/事件/玩家html#playerfishingafterserverevent">PlayerFishingAfterServerEvent</a>
+
+	服务端，钓鱼成功收杆后触发事件
+
+* <a href="../../../../mcdocs/1-ModAPI/事件/玩家html#playerstartfishingserverevent">PlayerStartFishingServerEvent</a>
+
+	服务端，玩家开始钓鱼事件
+
+
+### 接口
+* <a href="../../../../mcdocs/1-ModAPI/接口/玩家/背包.html#getplayerfishitem">GetPlayerFishItem</a>
+
+	服务端接口。获取玩家钓鱼时候的鱼竿物品字典
+
+
+* <a href="../../../../mcdocs/1-ModAPI/接口/玩家/行为.html#getplayerisfishing">GetPlayerIsFishing</a>
+
+	客户端接口。获取玩家是否在钓鱼
+
+
+* <a href="../../../../mcdocs/1-ModAPI/接口/玩家/背包.html#getplayerfishhookentity">GetPlayerFishHookEntity</a>
+
+	客户端接口。获取玩家钓鱼时候的鱼漂实体id
+
+
+## demo解释
+
+[自定义鱼竿](../../13-模组SDK编程/60-Demo示例.md#CustomFishHookItemMod)中定义了一个自定义鱼竿

mcguide/20-玩法开发/15-自定义游戏内容/2-自定义方块/1-JSON组件.md

@@ -168,6 +168,112 @@ time: 分钟
 
 指定语言文件键，用于映射鼠标悬停在物品栏和快捷栏中的方块物品上时显示的文本。如果给定的字符串无法解析为本地字符串，则将显示给定的原始字符串。使用需要方块行为的 `format_version`大于等于1.19.60。
 
+
+<span id="netease_portal"></span>
+
+### netease:portal
+
+| 键                   | 类型   | 默认值 | 解释                                                         |
+| -------------------- | ------ | ------ | ------------------------------------------------------------ |
+| particle_east_west   | string |        | 可选，对应于粒子json文件中的identifier，用于控制方块与Z轴同向时播放的粒子特效 |
+| particle_north_south | string |        | 可选，对应于粒子json文件中的identifier，用于控制方块与X轴同向时播放的粒子特效 |
+| target_dimension     | int    |        | 必须设置，用于控制进入传送门方块后到达的目标维度             |
+
+- **自定义传送门方块的base_block需要设为portal。**
+- 粒子特效应放置于`resource/particles`，粒子特效编写可参考[官方关于粒子组件的说明](https://learn.microsoft.com/en-us/minecraft/creator/reference/content/particlesreference/particlecomponentlist?view=minecraft-bedrock-stable)。
+- **目标维度为0或3-20的整数或者大于21的新版自定义维度的数值，1（下界）和2（末地）会被视作0来处理。**
+
+
+
+<span id="netease_mob_spawner"></span>
+
+### netease:mob_spawner
+
+可在netease:mob_spawner组件中设置刷怪的类型，目前支持原生生物、微软自定义生物。
+
+| 键   | 类型   | 默认值 | 解释                             |
+| ---- | ------ | ------ | -------------------------------- |
+| type | string |        | 必须设置，用于控制生成的生物类型 |
+
+- 原生生物type为"minecraft:Namespaced ID"，如"minecraft:parrot"，Namespaced ID可参考[官方wiki](https://zh.minecraft.wiki/w/%E5%9F%BA%E5%B2%A9%E7%89%88%E6%95%B0%E6%8D%AE%E5%80%BC/%E5%AE%9E%E4%BD%93ID)中各Mob的详细信息。
+- 微软自定义生物type为"minecraft:entity"中"description"的"identifier"项，可参考[自定义生物文档](../3-自定义生物/01-自定义基础生物.md)及[CustomBlocksMod](../../13-模组SDK编程/60-Demo示例.md#CustomBlocksMod)中的customblocks_test_mobspawner1.json。
+- 自定义刷怪箱方块的base_block需要设为mob_spawner。
+
+
+
+<span id="netease_water_destory"></span>
+
+### netease:water_destory
+
+可在netease:water_destory组件中设置是否无法摆放在水源和流水方块中，如果设置为true，会被流水摧毁。
+
+| 键    | 类型 | 默认值 | 解释                                         |
+| ----- | ---- | ------ | -------------------------------------------- |
+| value | bool |        | 必须设置，用于设置无法摆放在水源和流水方块中 |
+
+- 可以在方块的loottable中设置被水流摧毁后的掉落物
+
+
+
+<span id="netease_water_only"></span>
+
+### netease:water_only
+
+可在netease:water_only组件中设置是否必须放置在水中。
+
+| 键    | 类型 | 默认值 | 解释                                 |
+| ----- | ---- | ------ | ------------------------------------ |
+| value | bool |        | 必须设置，用于设置是否必须放在水中。 |
+
+
+
+<span id="netease_water_source"></span>
+
+### netease:water_source
+
+可在netease:water_source组件中设置是否在水源方块中表现为含水。
+
+| 键    | 类型 | 默认值 | 解释                                   |
+| ----- | ---- | ------ | -------------------------------------- |
+| value | bool |        | 必须设置，是否在水源方块中表现为含水。 |
+
+
+
+<span id="netease_water_flow_source"></span>
+
+### netease:water_flow_source
+
+可在netease:water_flow_source组件中设置是否在水源和流水方块中表现为含水。
+
+| 键    | 类型 | 默认值 | 解释                                         |
+| ----- | ---- | ------ | -------------------------------------------- |
+| value | bool |        | 必须设置，是否在水源和流水方块中表现为含水。 |
+
+
+
+<span id="netease_snow_recover_able"></span>
+
+### netease:snow_recover_able
+
+可在netease:snow_recover_able组件中设置方块是否能含雪。
+
+| 键    | 类型 | 默认值 | 解释                             |
+| ----- | ---- | ------ | -------------------------------- |
+| value | bool |        | 必须设置，用于设置方块是否能含雪 |
+
+- 目前自定义含雪方块和方块实体不兼容(包括自定义方块实体，自定义刷怪箱等)，请不要一起使用。
+
+
+<span id="netease_can_built_over"></span>
+
+### netease:can_built_over
+
+可在netease:can_built_over组件中设置在放置其他方块时，如果该位置已有含netease:can_built_over配置的方块，其他方块能否和放置在此方块中。
+
+| 键    | 类型 | 默认值 | 解释                                                         |
+| ----- | ---- | ------ | ------------------------------------------------------------ |
+| value | bool |        | 必须设置，用于设置在放置其他方块时，如果该位置已有含netease:can_built_over配置的方块，其他方块能否和放置在此方块中 |
+
 <span id="netease_tier"></span>
 
 ### netease:tier
@@ -303,7 +409,7 @@ time: 分钟
 
 ### netease:block_animate_random_tick
 
-频率更高的方块tick，用于实现类似樱花树叶的方块特效。给自定义方块配置该组件后，开发者可以在**客户端**监听<a href="../../../../mcdocs/1-ModAPI-beta/事件/方块.html#blockanimaterandomtickevent" rel="noopenner"> BlockAnimateRandomTickEvent </a>事件给方块附加逻辑。
+频率更高的方块tick，用于实现类似樱花树叶的方块特效。给自定义方块配置该组件后，开发者可以在**客户端**监听<a href="../../../../mcdocs/1-ModAPI/事件/方块.html#blockanimaterandomtickevent" rel="noopenner"> BlockAnimateRandomTickEvent </a>事件给方块附加逻辑。
 
 | 键           | 类型  | 默认值 | 解释   |
 | ------------ | ----- | ------ | ------ |

mcguide/20-玩法开发/15-自定义游戏内容/4-自定义维度/1-自定义维度.md

@@ -49,7 +49,7 @@ components中可以配置的组件如下：
 | netease:generator_noise                                    | 空object      |                                                              | 噪声生成器，用于生成随机凹凸的地面<br>如果没有配置任何生成器，则默认使用该生成器<br>（对三个原生维度无效） |
 | netease:generator_flat                                     | 空object      |                                                              | 超平坦生成器，仅主世界和下界类型可用<br>（对三个原生维度无效） |
 | netease:generator_legacy                                   | 空object      |                                                              | 旧世界/经典（有限地图）生成器，仅主世界类型可用<br>（对三个原生维度无效） |
-| netease:ban_vanilla_feature                                | 空object      |                                                              | 清除原版feature，可解决类似空岛玩法天空悬浮结构问题（仅主世界类型维度可用） |
+| netease:ban_vanilla_feature                                | 空object      |                                                              | 清除原版feature，可解决类似空岛玩法天空悬浮结构问题（任何维度可用） |
 | netease:spawn_biomes                                       | array(string) | 该维度下的forest, forest_hills, plains, taiga, taiga_hills, jungle, jungle_hills | 该维度下可供玩家出生的群系名称的列表<br>请确保列表的群系会生成在该维度 |
 | [netease:biome_source](./2-群系地貌.md#8-4.群系源节点类型) | array(dict)   |                                                              | 该维度下的群系源，仅主世界类型可用<br>（对三个原生维度无效） |
 | netease:ban_vanilla_structure                              | object        | 屏蔽所有原版结构                                             | 选择性屏蔽原版结构，示例见下方，支持主世界、下界、末地维度类型 |

mcguide/20-玩法开发/15-自定义游戏内容/5-自定义书本/01-自定义基础书本.md

@@ -324,12 +324,18 @@ sidebarDepth: 4
 | <div style="width:100px">属性</div> | 解释                                                         |
 | :---------------------------------: | ------------------------------------------------------------ |
 |              recipeId               | 合成配方的ID，一般为合成的物品的**identifier**，支持[自定义配方](../5-自定义配方.md) |
+|           recipeShapeId             | 配方Id，对应配方Json的identifier字段。 |
+|                 tag                 | 配方tag，对应配方Json的tags字段，可不配置，默认为crafing_table。仅支持工作台、自定义工作台、制图台、切石机配方 |
 |             recipeSize              | 合成表显示的大小，用二维浮点数组表示。<br/>该属性系统默认值为 [90.0, 48.0]，可以不写。 |
 |                 aux                 | 合成物品的附加值**AuxValue**，该属性可以不写，系统默认值为0（整型）。 |
 |                info                 | 合成物品的备注文本，显示在物品的下方。如果不写该属性，则无备注，内容文本会自动往上对齐。 |
 |               content               | 内容文本，默认值为""，支持格式化文本。文本框大小会自动适应页面，如果文本内容过多将不显示超出页面的文字。 |
 |           contentTextSize           | 内容文本的字体大小。<br>该属性系统默认值为**BookConfig.TextSize.content**，数值为**10**（整型），可以不写。 |
 
+注意：
+- **recipeId仍然需要配置**
+- 如果同时配置recipeId、recipeShapeId，则会优先使用recipeShapeId获取配方、如果获取失败，才使用recipeId
+
 #### 6.实体页
 
 实体页在json文件中的type属性值为 "**entityPage**"，展示的实体会**自动顺时针旋转**，示例在**behavior_pack/customBooks/entry/entityEntry.json**。

mcguide/20-玩法开发/15-自定义游戏内容/5-自定义配方.md

@@ -228,7 +228,7 @@ time: 分钟
 | 字段      | 名称     | 描述                                                                                                  |
 | --------- | -------- | ----------------------------------------------------------------------------------------------------- |
 | tags      | 配方标签 | 请填写“smithing_table” |
-| template  | 锻造模板 | 可不填，执行转换操作所需的锻造模板，物品需要具有minecraft:transform_materials标签才能放入对应槽位 |
+| template  | 锻造模板 | 可不填，执行转换操作所需的锻造模板，物品需要具有minecraft:transform_templates标签才能放入对应槽位 |
 | base      | 输入物品 | 要转换的物品。输入物品的属性将被复制到输出物品，物品需要具有minecraft:transformable_items标签才能放入对应槽位，例如原版盔甲和工具 |
 | addition  | 转换材料 | 转换所需的材料。目前只支持minecraft:netherite_ingot（下界合金锭） |
 | result    | 输出物品 | 转换后的结果物品 |

mcguide/20-玩法开发/15-自定义游戏内容/9-自定义指令.md

@@ -57,7 +57,7 @@ selection: true
 	|format_version|str||格式版本，请填写0.0.1|
 	|name|str||指令名称，例如gamemode|
 	|description|str||指令描述，也支持在语言文件（例如zh_CN.lang）中定义|
-	|permission_level|str|权限等级，可选game_directors、admin、host、owner、any，具体含义如下<br>game_directors：任何操作员都可以运行此命令，包括命令方块<br>admin：任何操作员都可以运行此命令，但命令方块不能<br>host：任何服务器主机都可以运行此命令<br>owner：只有专用服务器可以运行此命令<br>any：任何人都可以运行此命令|
+	|permission_level|str|game_directors|权限等级，可选game_directors、admin、host、owner、any，具体含义如下<br>game_directors：任何操作员都可以运行此命令，包括命令方块<br>admin：任何操作员都可以运行此命令，但命令方块不能<br>host：任何服务器主机都可以运行此命令<br>owner：只有专用服务器可以运行此命令<br>any：任何人都可以运行此命令|
 	
 - args是一个包含object的列表，定义指令的参数。每个object都代表一个参数，object的顺序决定指令参数的输入顺序，每个object的参数说明如下
 

mcguide/20-玩法开发/18-性能优化/Tick 事件优化.md

@@ -0,0 +1,232 @@
+---
+front: https://nie.res.netease.com/r/pic/20210728/5507b669-4c6f-4958-b5d0-b8556ab4cfb5.png
+hard: 进阶
+time: 20分钟
+---
+
+# Tick 事件优化指南
+
+Tick 事件是网易版组件开发中最为核心的机制之一，绝大多数重要的游戏逻辑都需要在 Tick 事件中实现。
+
+然而，由于事件系统的架构特性，多个逻辑模块集中在同一时间执行时，容易产生性能瓶颈。本文将分享几个经过实践验证的优化策略，帮助开发者提升游戏性能。
+
+在后续示例中，我们将以 `ServerBlockEntityTickEvent` 事件为例进行说明。该事件会在方块实体配置并启用 tick 组件后，以每秒 20 次的频率执行。
+
+## 一、设计原则
+
+### 原则一：优先执行开销最小、访问频率最高的运算
+
+由于 `ServerBlockEntityTickEvent` 事件会在所有启用了 tick 组件的方块实体上执行，通过在事件处理的最开始进行方块类型判断，可以有效避免不必要的性能开销：
+
+```python
+# -*- coding: utf-8 -*-
+
+# ServerBlockEntityTickEvent 事件
+def on_block_entity_tick(args):
+    block_name = args["blockName"]        
+    if block_name == "custom:some_tickable_block":
+        # tick 逻辑
+        pass
+```
+
+值得注意的是，网易版 API 中的 `serverApi.GetEngineCompFactory()` 等工厂方法在频繁调用时也会产生性能开销，在高频执行的 tick 事件中尤其需要注意这一点。
+
+推荐的做法是将 tick 事件中常用的接口组件预先缓存为全局变量，避免重复创建：
+
+```python
+# -*- coding: utf-8 -*-
+
+import mod.server.extraServerApi as serverApi
+
+# 将部分组件缓存，以便后续高频访问使用
+level_id = serverApi.GetLevelId()
+factory = serverApi.GetEngineCompFactory()
+block_info = factory.CreateBlockInfo(level_id)
+be_comp = factory.CreateBlockEntityData(level_id)
+
+
+# ServerBlockEntityTickEvent 事件
+def on_block_entity_tick(args):
+    block_name = args["blockName"]
+    x = args["posX"]
+    y = args["posY"]
+    z = args["posZ"]
+    dim_id = args["dimension"]
+
+    if block_name == "custom:some_tickable_block":
+        below_block = block_info.GetBlockNew((x, y - 1, z), dim_id)
+        # 其他逻辑部分...
+```
+
+### 原则二：采用间隔执行机制，降低计算频率
+
+并非所有游戏逻辑都需要在每个 tick 中执行。例如，在设计烤炉烤制食物的功能时，食物的烤制进度检查完全可以每隔 20 tick 或更长时间进行一次，而无需每 tick 都执行。
+
+最简单的实现方式是引入全局计数变量，通过取余运算实现间隔执行：
+
+```python
+# -*- coding: utf-8 -*-
+
+TICK_COUNT = 0
+
+
+# OnScriptTickServer 事件
+# 注意：OnScriptTickServer 每秒执行 30 次
+# 而 ServerBlockEntityTickEvent 每秒执行 20 次
+# 实际项目中需要考虑这一频率差异
+def on_script_tick():
+    # 每个 tick 计数变量递增
+    global TICK_COUNT
+    TICK_COUNT += 1
+
+
+# ServerBlockEntityTickEvent 事件
+def on_block_entity_tick(args):
+    block_name = args["blockName"]
+
+    if block_name == "custom:some_tickable_block" and TICK_COUNT % 20 == 0:
+        # 每 20 tick 执行一次特定操作
+        pass
+```
+
+## 二、Tick 计数的潜在问题与负载均衡策略
+
+上述原则二中的 tick 计数方法虽然简单有效，但存在一个重要缺陷。
+
+当玩家同时放置多个相同的可 tick 方块（如 20 个烤炉）时，由于它们共享同一个全局计数器 TICK_COUNT，所有方块的逻辑会在同一时刻集中触发，造成明显的间歇性卡顿现象。
+
+解决这个问题的关键在于实现 tick 负载均衡，让每个方块的执行时机分散到不同的 tick 中。
+
+### 加盐（Salt）机制
+
+这是借鉴自密码学的概念。
+
+通过在 tick 计数判断中加入特定的偏移值，使每个方块的执行时机产生差异：
+
+```python
+# -*- coding: utf-8 -*-
+
+TICK_COUNT = 0
+
+
+# OnScriptTickServer 事件
+def on_script_tick():
+    # 每 tick 时，此计数变量自增 1
+    global TICK_COUNT
+    TICK_COUNT += 1
+
+
+# ServerBlockEntityTickEvent 事件
+def on_block_entity_tick(args):
+    block_name = args["blockName"]
+    x = args["posX"]
+    y = args["posY"]
+    z = args["posZ"]
+    dim_id = args["dimension"]
+
+    if block_name == "custom:some_tickable_block":
+        # 使用坐标和维度 ID 作为偏移量，确保不同位置的方块错开执行时机
+        offset_tick_count = x + y + z + dim_id + TICK_COUNT
+        # 每 20 tick 执行一次，但各方块的执行时机已经分散
+        if offset_tick_count % 20 == 0:
+            pass
+```
+
+通过这种方式，可以有效确保不同位置的方块避开在同一 tick 中执行操作。
+
+### 逻辑模块化与分频执行
+
+当可 tick 方块包含复杂的游戏逻辑，且这些逻辑可以划分为多个独立模块时，可以根据各模块的性能开销和实时性要求，采用不同的执行频率：
+
+- 性能开销大、实时性要求低的模块：**低频执行**
+- 性能开销小、实时性要求高的模块：**高频执行**
+
+```python
+# -*- coding: utf-8 -*-
+
+TICK_COUNT = 0
+
+
+# OnScriptTickServer 事件
+def on_script_tick():
+    # 每 tick 时，此计数变量自增 1
+    global TICK_COUNT
+    TICK_COUNT += 1
+
+
+# ServerBlockEntityTickEvent 事件
+def on_block_entity_tick(args):
+    block_name = args["blockName"]
+    x = args["posX"]
+    y = args["posY"]
+    z = args["posZ"]
+    dim_id = args["dimension"]
+
+    if block_name == "custom:some_tickable_block":
+        # 使用坐标和维度 ID 作为偏移量，实现负载均衡
+        offset_tick_count = x + y + z + dim_id + TICK_COUNT
+
+        # 高频模块：每 5 tick 执行一次
+        if offset_tick_count % 5 == 0:
+            fast_logic(args)
+
+        # 低频模块：每 100 tick 执行一次
+        if offset_tick_count % 100 == 0:
+            slow_logic(args)
+
+
+def fast_logic(args):
+    # 低开销、高频率执行的游戏逻辑
+    pass
+
+
+def slow_logic(args):
+    # 高开销、低频率执行的游戏逻辑
+    pass
+```
+
+### 使用质数间隔，避免执行时机冲突
+
+当游戏逻辑足够复杂，需要拆分为多个不同执行频率的模块时
+
+```python3
+# 每 10 tick 执行一次特定操作
+if offset_tick_count % 10 == 0:
+    logic_a(args)
+
+# 每 20 tick 执行一次特定操作
+if offset_tick_count % 20 == 0:
+    logic_b(args)
+    
+# 每 40 tick 执行一次特定操作
+if offset_tick_count % 40 == 0:
+    logic_c(args)
+
+# 每 80 tick 执行一次特定操作
+if offset_tick_count % 80 == 0:
+    logic_d(args)
+```
+
+当游戏运行到 80 tick 的倍数时，会发现四个逻辑模块同时触发，导致性能峰值和卡顿现象。
+
+使用质数作为执行间隔可以有效避免这一问题。将原有的间隔替换为质数 `11, 19, 41, 79`：
+
+```python
+# 每 11 tick 执行一次特定操作
+if offset_tick_count % 11 == 0:
+    logic_a(args)
+
+# 每 19 tick 执行一次特定操作
+if offset_tick_count % 19 == 0:
+    logic_b(args)
+    
+# 每 41 tick 执行一次特定操作
+if offset_tick_count % 41 == 0:
+    logic_c(args)
+
+# 每 79 tick 执行一次特定操作
+if offset_tick_count % 79 == 0:
+    logic_d(args)
+```
+
+利用质数的数学特性，这些逻辑模块在任何 tick 时刻都不会同时执行，从而实现了更均匀的性能负载分布。

mcguide/20-玩法开发/18-性能优化/代码进阶优化.md

@@ -31,8 +31,8 @@ query.mod.ysm_is_elytra_flying      # 是否正在鞘翅飞行
 
 结合以下两个关键功能实现：
 
-1. [OnPlayerActionServerEvent](https://mc.163.com/dev/mcmanual/mc-dev/mcdocs/1-ModAPI-beta/事件/玩家.html#onplayeractionserverevent) - 用于监听玩家动作状态
-2. [实体自定义属性](https://mc.163.com/dev/mcmanual/mc-dev/mcdocs/1-ModAPI-beta/接口/实体/索引.html?catalog=1#自定义属性) - 实现Molang值的自动同步
+1. [OnPlayerActionServerEvent](https://mc.163.com/dev/mcmanual/mc-dev/mcdocs/1-ModAPI/事件/玩家.html#onplayeractionserverevent) - 用于监听玩家动作状态
+2. [实体自定义属性](https://mc.163.com/dev/mcmanual/mc-dev/mcdocs/1-ModAPI/接口/实体/索引.html?catalog=1#自定义属性) - 实现Molang值的自动同步
 
 ### 工作原理
 
@@ -92,32 +92,33 @@ playerId = clientApi.GetLocalPlayerId()
 ClientComp.CreateQueryVariable(levelId).Register("query.mod.ysm_is_create_flying", 0)
 ClientComp.CreateQueryVariable(levelId).Register("query.mod.ysm_is_elytra_flying", 0)
 
+# key为需要监听的attr名称,value为需要设置的对应Molang变量名称
+queryDict = {
+    "playerIsFlying": "query.mod.ysm_is_flying",
+    "playerIsElytraFlying": "query.mod.ysm_is_elytra_flying"
+}
+
+# 根据queryDict自动配置监听,简化代码
+def CreateAttrCallBack(bindQuery):
+    def _eventFuckCallBack(args):
+        ClientComp.CreateQueryVariable(args["entityId"]).Set(bindQuery, args["newValue"])
+    return _eventFuckCallBack
+
+
 class PlayerActionClientSystem(ClientSystem):
     def __init__(self, namespace, systemName):
         ClientSystem.__init__(self, namespace, systemName)
         # 注册本地玩家的属性值变化回调函数
         modAttr = ClientComp.CreateModAttr(playerId)
-        modAttr.RegisterUpdateFunc("playerIsCreateFlying", self.PlayerCreateFlyStateChanged)
-        modAttr.RegisterUpdateFunc("playerIsElytraFlying", self.PlayerElytraFlyStateChanged)
+        for attr, query in queryDict.items():
+            ClientComp.CreateModAttr(playerId).RegisterUpdateFunc(attr, CreateAttrCallBack(query))
     
     def OnAddPlayerAOIClient(self, args):
         """玩家加入游戏或进入视野时触发，注册属性值变化回调"""
         pId = args["playerId"]
         modAttr = ClientComp.CreateModAttr(pId)
-        modAttr.RegisterUpdateFunc("playerIsCreateFlying", self.PlayerCreateFlyStateChanged)
-        modAttr.RegisterUpdateFunc("playerIsElytraFlying", self.PlayerElytraFlyStateChanged)
-    
-    def PlayerCreateFlyStateChanged(self, args):
-        """创造飞行状态变化回调"""
-        molangVar = args["newValue"]  # 属性变化后的值
-        pId = args["entityId"]        # 属性变化对应的实体Id
-        ClientComp.CreateQueryVariable(pId).Set("query.mod.ysm_is_create_flying", molangVar)
-
-    def PlayerElytraFlyStateChanged(self, args):
-        """鞘翅飞行状态变化回调"""
-        molangVar = args["newValue"]  # 属性变化后的值
-        pId = args["entityId"]        # 属性变化对应的实体Id
-        ClientComp.CreateQueryVariable(pId).Set("query.mod.ysm_is_elytra_flying", molangVar)
+        for attr, query in queryDict.items():
+            ClientComp.CreateModAttr(pId).RegisterUpdateFunc(attr, CreateAttrCallBack(query))
 ```
 
 ### 工作流程说明

mcguide/20-玩法开发/20-物理玩法开发/1-物理的使用指南.md

@@ -0,0 +1,242 @@
+# 物理的使用指南
+
+## 使用准则与免责声明
+
+### 使用准则
+
+1. 仅限第三方用户生成内容（UGC）使用
+2. 只有创作者创建的自定义实体才能与物理刚体绑定，原版实体无法与PhysX创建的刚体绑定
+3. 物理身件可以与其他游戏物件（包括原生游戏物件）产生互动，但是原生游戏物件与其他原生游戏物件之间的互动方式及物理碰撞不会被改变
+4. 当两个碰撞同时发生时，核心游戏的物理引擎具有最高优先级  
+
+只有满足上述条件，您的模组才能符合要求进行上架
+
+### 免责声明
+
+物理相关api与特性，可能会在将来调整并且不向前兼容。请随时做好调整的准备
+
+但是，每次调整都会做出充分的预告和调整内容公告，方便你对您的模组进行最新内容的兼容。
+
+## 准备工作
+
+由于我们的物理引擎是用的 NVIDIA PhysX，您可以先前往NVIDIA官网下载PhysX Visual Debugger，方便后续调试。
+[https://developer.nvidia.com/physx-visual-debugger](https://developer.nvidia.com/physx-visual-debugger)
+![img.png](./picture/img_2.png)  
+## 全局配置
+
+在使用物理引擎之前，您需要在模组的 behavior_packs 行为包中新增 physx_setting.json 全局配置文件
+![img.png](./picture/img.png)  
+文件里面需要设置成
+```json
+{
+    "enable": true
+}
+```
+保存后，您的模组可以正常使用 PhysX 物理引擎了。
+
+## 开始创作
+
+现在我会通过demo，来向你介绍physx能做的内容
+
+### 创建自定义刚体
+
+使用物理内容的之前，您首先需要创建一个新的物理刚体，物理刚体**必须**绑定在`自定义实体`上，且创建刚体的方法只能在 `AddEntityServerEvent` 事件中使用
+
+```python
+# 创建一个自定义刚体
+comp = serverApi.GetEngineCompFactory().CreatePhysx(entityId)
+comp.CreatePxActor()
+```
+现在你已经为这个 entityId 的实体添加了一个物理刚体
+
+> 注意： 刚体创建数量不得大于 8192， 虽然Physx限制是31767，但是我们需要预留一些刚体阈值给到其他实体和客户端内容  
+> 注意：必须要在 AddEntityServerEvent 事件中创建刚体，否则会报错  
+> 注意：实体必须绑定在 自定义实体上，不得绑定在原版实体上
+
+### 添加包围盒
+
+目前这个刚体暂时没有任何功能和属性，为了让它能够正常工作，我们需要给刚体添加一些属性
+
+首先需要添加包围盒，包围盒是刚体的基本属性，你只有添加了包围盒，才能让刚体与世界实体进行交互
+
+添加包围盒的方法是 AddBoxGeometry ，参数方法如下
+```python
+# localTransform	tuple(float,float,float)	盒子中心相对实体原点的偏移
+# halfX	float	表示盒子长度的一半
+# halfY	float	表示盒子高度的一半
+# halfZ	float	表示盒子宽度的一半
+# staticFriction	float	静摩擦系数
+# dynamicFriction	float	动摩擦系数，默认为e 注意：此摩擦力设置为0，并不代表刚体与原生游戏交互也是 0 摩擦力
+# restitution	float	弹性恢复系数，默认为0
+# eventMask	int	PxEventMask枚举，用于监听碰撞事件，默认为PxRigidBodyFlag.Null，即不需要碰撞事件
+# userData	None或str	可记录自定义数据，长度不超过20，默认为None
+comp.AddBoxGeometry((0, 0.9, 0), 0.3, 0.9, 0.3, 0.05, 0.05, 0, PxEventMask.Server | PxEventMask.Found, None)
+```
+
+PxEventMask 枚举目前有六个
+1. PxEventMask.Server   服务端事件
+2. PxEventMask.Client   客户端事件
+3. PxEventMask.Lost   结束碰撞事件
+4. PxEventMask.Found   开始碰撞事件
+5. PxEventMask.Found_Detail    碰撞事件的详细信息
+6. PxEventMask.Null   该刚体不附加任何事件
+
+此时你已经成功为你的刚体创建好了包围盒
+
+当你启动游戏时，如果你此时提前打开了 PhysX Visual Debugger，那么刚体的包围盒就会显示出来了
+
+![img.png](./picture/img_3.png)  
+
+红色代表世界的原生方块、绿色和黄色代表刚体的包围盒
+![img.png](./picture/img_4.png)  
+
+### 添加约束和运动
+
+如果你想给刚体添加一些约束，比如刚体的运动锁定某个轴体，您需要添加动态约束
+
+```python
+# 下面的方法是规定此刚体只会沿着 X Y Z 轴运动
+comp.SetRigidDynamicLockFlags(PxRigidDynamicLockFlag.eLOCK_ANGULAR_X | PxRigidDynamicLockFlag.eLOCK_ANGULAR_Y | PxRigidDynamicLockFlag.eLOCK_ANGULAR_Z)
+``` 
+PxRigidDynamicLockFlag 枚举目前有六个
+1. PxRigidDynamicLockFlag.eLOCK_ANGULAR_X  锁定沿着 X 轴运动
+2. PxRigidDynamicLockFlag.eLOCK_ANGULAR_Y   锁定沿着 Y 轴运动
+3. PxRigidDynamicLockFlag.eLOCK_ANGULAR_Z   锁定沿着 Z 轴运动
+4. PxRigidDynamicLockFlag.eLOCK_LINEAR_X   锁定沿着 X 轴旋转
+5. PxRigidDynamicLockFlag.eLOCK_LINEAR_Y   锁定沿着 Y 轴旋转
+6. PxRigidDynamicLockFlag.eLOCK_LINEAR_Z   锁定沿着 Z 轴旋转
+
+
+如果你希望您的刚体具有运动的属性，你需要将刚体设置为运动学刚体
+
+那什么叫做有运动的属性？
+比如你想要手动控制刚体的运动，那么你需要将刚体设置为运动学刚体
+包括做成刚体风车、刚体传送带等行为
+
+```python
+# 目前PxRigdiBodyFlag 仅支持PxRigidBodyFlag.eKINEMATIC
+comp.SetRigidBodyFlag(PxRigidBodyFlag.eKINEMATIC, True)
+```
+
+### AI控制
+
+利用实体创建刚体，您需要对AI进行调整
+否则在客户端会出现悬空的情况
+
+```python
+comp = serverApi.GetEngineCompFactory().CreateControlAi(entityId)
+comp.SetBlockControlAi(False)
+```
+
+### 做一个简单的风车
+
+对此我们可以通过上述内容做一个简单的风车，我们计划是配合方块调色板 + 物理引擎来做一个简单的风车
+
+机械动力的风车是一个比较不错的参考对象
+
+我们仿照机械动力的风车，来做一个中国版物理引擎的风车
+
+首先根据上面介绍的内容，我们依次创建刚体，设置包围盒
+
+但是原版Java版机械动力的风车，可以自由组合方块，所以我们需要一个刚体对应一个方块。目前规划是创建一个长度5格的刚体
+
+可以做一个for循环
+
+```python
+for i in range(2):
+    for j in range(-2,3):
+        comp.AddBoxGeometry((j, 0.5 + i, 0), 0.5, 0.5, 0.5, 0.05, 0.05, 0, 
+                             PxEventMask.Server | PxEventMask.Client | PxEventMask.Found | PxEventMask.Found_Detail | PxEventMask.Lost, 
+                             %s,%s,0'%(j, i))
+```
+
+此时就会创建一个总长度 5 格的刚体包围盒，并且每个刚体对应一个方块
+
+因为这个刚体会有旋转的效果，所以我们需要给刚体添加一个运动属性
+
+```python
+# 目前PxRigdiBodyFlag 仅支持PxRigidBodyFlag.eKINEMATIC
+comp.SetRigidBodyFlag(PxRigidBodyFlag.eKINEMATIC, True)
+```
+
+因为刚体旋转是通过传入一个四元数并对四元数调整来达到目标的
+
+所以我们需要创建一个四元数组
+
+```python
+# 这里建议用一个成员变量来做存储，方便删除实体后对数据进行调整和删除
+self.mSkeletons[entityId] = Quaternion(0, 0, 0, 1)
+```
+
+因为旋转是一个连续的过程，所以我们需要重写Update方法，以达到每tick刷新我们的旋转数据
+
+```python
+# 这里我们对 self.mSkeletons 进行遍历，获取刚刚存储好的四元数，修改的同时传入刚体运动方法
+for entityId, v in self.mSkeletons.iteritems():
+    # 旋转
+    q = v * Quaternion.AngleAxis(1, Vector3.Up())
+    # 修改变量值
+    self.mSkeletons[entityId] = q
+    # 设置为运动学目标
+    comp = serverApi.GetEngineCompFactory().CreatePhysx(entityId)
+    # 运动
+    comp.SetKinematicTarget(None, q.ToTuple())
+```
+
+此时刚体就会每tick旋转角度
+
+但是目前做的内容仅仅只是对刚体进行了旋转，客户端没有表现，我们还需要用方块调色板对客户端进行调试
+
+首先创建一个调色板
+```python
+dataDict = {'extra': {}, 'void': False, 'actor': {}, 'volume': (1, 5, 2), 'common': {('minecraft:grass_block', 0): [4, 9], ('minecraft:glass', 0): [1, 6], ('minecraft:quartz_block', 0): [3, 8], ('minecraft:white_wool', 0): [0, 5], ('minecraft:oak_planks', 0): [2, 7]}, 'eliminateAir': True}
+comp = compFactory.CreateBlock(levelId)
+palette = comp.GetBlankBlockPalette()
+palette.DeserializeBlockPalette(dataDict)
+blockGeometryComp = compFactory.CreateBlockGeometry(levelId)
+geometryName = blockGeometryComp.CombineBlockPaletteToGeometry(palette,"my_block_geometry")
+```
+
+然后需要将调色板绑定在实体上，但是绑定刚体是欧拉角，也就是说我们还需要将四元数转成欧拉角
+
+好在，ModSDK提供了这个简单的方法，物理引擎也有获取客户端刚体的四元数数据
+
+```python
+actorRenderComp = compFactory.CreateActorRender(entityId)
+comp = compFactory.CreatePhysx(entityId)
+q = Quaternion(comp.GetQuaternion())
+# AddActorBlockGeometry 在 3.7 新增了一个参数， 会控制先旋转后偏移，还是先偏移后旋转。默认是False
+# 为了做风车，我们设置为 True，也就是先旋转再偏移
+actorRenderComp.AddActorBlockGeometry(geometryName, (-2, 0, 0), q.EulerAngles().ToTuple(), 0True)
+self.mSkeletons.add(entityId)
+```
+
+此时刚体的方块调色板就已经绑定在实体上了，但是这个我们查看 PhysX Visual Debugger 时，发现刚体变动了，但是调色板方块没有变化
+
+所以我们也要对客户端表现进行调整
+
+同样需要重写 Update 方法，每tick修改方块调色板的旋转角度
+
+```python
+def Update(self):
+    for entityId in self.mSkeletons:
+        comp = compFactory.CreatePhysx(entityId)
+        q = comp.GetQuaternion()
+        if q:
+            q = Quaternion(q)
+            actorRenderComp = compFactory.CreateActorRender(entityId)
+            actorRenderComp.SetActorBlockGeometryRotation("my_block_geometry", q.EulerAngles().ToTuple())
+```
+
+当全部完成后，就可以做到风车围绕着一个自定义实体进行旋转，然后推动实体进行移动了
+
+并且你也可以站在这个刚体上，但是站在刚体上，刚体并不会带着玩家一起移动，开发者们可以自行思考解决办法来处理这个问题！
+![img_5.png](./picture/img_5.png)
+
+### 思考
+
+虽然我们现在是在用 Update 的方式去动态的调整刚体旋转和外观旋转
+
+但是进入游戏后会发现，用此方法来旋转会有一点的顿挫感，虽然影响不是很大，但如果你需要追求细致，可能还不算太完美
+
+或许还可以通过 `GameRenderTickEvent` 来调整，但是这个方法笔者并没有使用过，所以需要开发者们自行思考研究

mcguide/27-手机网络游戏/课程10：使用Spigot开服/15-通过MCSM面板管理服务器.md

@@ -0,0 +1,239 @@
+---
+front:
+hard: 入门
+time: 60分钟
+---
+
+# 通过MCSM面板管理服务器
+
+![封面](./res/mcsmguide/10.png)
+
+## 准备阶段
+
+1. PE/PC网络服入驻通过，并且拿到网易开发机/正式机。
+2. 自备服务器（非网易机器），最低要求1c1g，建议安装宝塔
+3. 下载所需要的文件（相关文件已上传内容库）
+4. 完成上一章节《部署服务器》
+5. MCSM面板中文指南：<https://docs.mcsmanager.com/zh_cn/>
+
+## 特别提示
+
+本教程不会在网易机器部署web面板及自建服务。
+
+本教程将默认开发者已经熟悉MCSM面板，基础内容不再介绍。
+
+开始前请熟知并遵守《高危操作警告说明》：
+
+* 网易机器禁止私自开放附录名单内端口对外
+
+* 网易机器禁止私自把无任何认证校验服务直接对外
+
+* 网易机器禁止私自把机器交付时开放的业务端口用于其他用途，如数据库或自建服务等
+
+![《高危操作警告说明》文档](./res/mcsmguide/20.png)
+
+## 原理说明
+
+在网易机器部署mcsm daemon守护进程，通过自备机器协议转发SSH隧道与网易机器通信，从而达到使用mcsm面板管理网易机器。
+
+![原理图](./res/mcsmguide/30.png)
+
+## 操作步骤
+
+### （一）在网易机器
+
+#### 1. 无root安装node.js
+
+**强制要求安装node16+的版本，不然守护进程跑不起来**
+
+```bash
+# 下载nodejs
+cd ~/downloads
+wget https://nodejs.org/dist/v16.20.2/node-v16.20.2-linux-x64.tar.xz
+
+# 创建工作目录并解压
+mkdir -p ~/apps/node-v16.20.2
+tar -xJf node-v16.20.2-linux-x64.tar.xz --no-wildcards-match-slash --anchored --exclude */CHANGELOG.md --exclude */LICENSE --exclude */README.md  --strip 1 -C ~/apps/node-v16.20.2
+
+# 添加path变量
+export PATH=~/apps/node-v16.20.2/bin:$PATH
+source ~/.bashrc
+
+# 检查nodejs版本
+node -v
+npm -v
+
+# 至此安装完成
+```
+
+#### 2. 守护进程mcsm  daemon上传部署
+
+从github下载压缩包（内容库也已上传）
+
+<https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_daemon_only_release.tar.gz>
+
+```bash
+# 创建mcsm daemon工作目录
+cd ~
+mkdir -p ~/mcsm
+
+# 上传到这个目录（Xftp, FinalShell均可）
+
+# 解压
+cd ~/mcsm
+tar -zxvf mcsmanager_linux_daemon_only_release.tar.gz
+cd ~/mcsm/mcsmanager
+
+# 设置 npm 镜像源为国内淘宝源
+npm config set registry https://registry.npmmirror.com
+npm config get registry
+
+# 新增screen
+screen -S mcsm
+
+# 安装依赖后部署
+sh start-daemon.sh
+```
+
+#### 3. 检查24444端口和秘钥
+
+执行上一步骤后，服务将会启动成功，请使用**ctrl+a、d**来后台运行screen
+
+启动成功后，你会看到类似 \[INFO] Key: xxxxxxx 和 Port: 24444 的信息。
+
+（记录key秘钥，后续将用于自备机器节点配置。）
+
+```bash
+# 检查端口是否正常
+netstat -tulnp | grep 24444
+```
+
+### （二）在自备机器
+
+#### 1. 自动安装mcsm+开启守护进程
+
+```bash
+# 请确保root登录，有sudo权限
+sudo su -c "wget -qO- https://script.mcsmanager.com/setup_cn.sh | bash"
+
+# 先启动面板守护进程。
+# 这是用于进程控制，终端管理的服务进程。
+systemctl start mcsm-daemon.service
+# 再启动面板 Web 服务。
+# 这是用来实现支持网页访问和用户管理的服务。
+systemctl start mcsm-web.service
+
+# 以下命令已列出（如有需要请自取）
+# 重启面板命令
+systemctl restart mcsm-daemon.service
+systemctl restart mcsm-web.service
+
+# 停止面板命令
+systemctl stop mcsm-web.service
+systemctl stop mcsm-daemon.service
+```
+
+如果 systemctl 命令无法启动面板，可以参考手动安装（<https://docs.mcsmanager.com/zh_cn/>） 中的 启动方式 来启动 MCSManager。 但这需要你用其他后台运行程序来接管它，否则当你的 SSH 终端断开之时，手动启动的 MCSManager 面板也会随之被系统强制结束。
+
+面板 Web 服务是提供用户管理与网页访问功能的服务，守护进程是提供进程管理和容器管理的服务，两者缺一不可。如果某个功能不正常，可以只重启这一部分的服务来热修复问题。
+
+#### 2. 配置协议转发（autossh）
+
+下面将以宝塔面板进行操作：
+
+① 进入/root/.ssh/目录上传网易机器秘钥
+
+② 配置秘钥密码和隧道转发
+
+```bash
+# 设置秘钥权限（请自行替换）
+chmod 600 /root/.ssh/netease.key
+
+# 启动 ssh-agent
+eval `ssh-agent -s`
+
+# 添加密钥并输入一次密码（请自行替换）
+ssh-add /root/.ssh/netease.key
+
+# 如无autossh，请自行安装
+apt-get update
+apt-get install autossh -y
+
+# 执行隧道命令（请自行替换）
+# 将ssh隧道连接的网易机器24444端口转发到自备机器的24445端口
+# 注意 -L 后面的 0.0.0.0:24445
+autossh -M 0 -o "ServerAliveInterval 30" -o "ServerAliveCountMax 3" -p 32200 -i /root/.ssh/netease.key -CNf -L 0.0.0.0:24445:127.0.0.1:24444 fuzhu@<网易机器IP>
+
+# 验证是否成功
+netstat -tunlp | grep 24445
+
+# 如果你看到类似下面的输出：
+# tcp 0 0 127.0.0.1:24445 0.0.0.0:* LISTEN 1234/ssh
+# 那么就成功了
+
+# 至此隧道转发结束
+```
+
+③ 防火墙和安全组开放端口（仅在自备机器，网易机器禁止开放端口）
+
+| mcsm面板web端口（建议nginx转发改端口，安全一些） | 23333 |
+| ------------------------------ | ----- |
+| **ssh协议转发端口（设置端口白名单，否则有安全问题）** | 24445 |
+
+#### 3. 配置mcsm节点
+
+![节点位置](./res/mcsmguide/40.png)
+
+![节点配置](./res/mcsmguide/50.png)
+
+这里的“远程节点秘钥”请替换为网易机器守护进程输出的key秘钥。
+
+添加后，显示节点状态为正常，网页直连为正常，可以读取内存和处理器使用率后节点配置成功。
+
+#### 4. 检查实例创建和文件管理是否正常
+
+如需迁移网易机器的screen至mcsm，请使用“直接创建”，配置服务端目录、实例类型和启动命令后，即可迁移成功。
+
+![创建实例](./res/mcsmguide/60.png)
+![文件管理](./res/mcsmguide/70.png)
+
+#### 5. 常见的问题
+
+① 无法连接到远程节点
+
+检查自备机器端口/安全组是否开放，是否需要配置nginx反向代理。
+
+最简单的方法就是直接复制地址，浏览器访问，看是否有显示daemon状态。
+
+![无法连接到远程节点](./res/mcsmguide/80.png)
+![守护进程状态](./res/mcsmguide/90.png)
+
+② 多网易机器部署
+
+按照此方法，在不同机器上配置mcsm daemon守护进程，配置多个SSH隧道协议转发，然后新增节点即可。
+
+③ mcsm面板传输文件出现错误
+
+显示network error
+
+解决方法：升级daemon为最新版，不要使用3.x的版本
+
+## 特别鸣谢
+
+
+教程作者：初云
+
+灵感和帮助：Soldier
+
+全过程步骤指导：Gemini3 Pro
+
+教程参考指南：MCSManager团队
+
+MCSM常见问题解答：混合、封神、MuFeng、西瓜、星汉
+
+调试与测试：千阙云庭服务器团队、初云杯服务器团队、风之谷服务器团队
+
+
+如您在操作过程中有困难，欢迎您随时联系我们\~
+
+感谢帮助过我们的人，期待网络服环境蒸蒸日上！

mcguide/27-手机网络游戏/课程10：使用Spigot开服/90-常见问题合集.md

@@ -74,6 +74,20 @@ time: 60分钟
 
 - 请检查BC服与Spigot服配置以及日志，确定BC服能正常连接上Spigot服
 
+### (5) 排查 Apollo 版本兼容性问题
+
+- 当客户端与服务端的 Apollo 版本不一致（例如客户端为 3.1.0，而服务端为 3.0.0）时，玩家将无法进入游戏，界面会一直停留在“正在链接外部服务器”，同时 Geyser 日志中不会有任何输出。
+
+- 请确保客户端与服务端使用的是相同版本，以避免因版本不兼容导致连接失败的问题。
+
+- 可能您会疑惑：“我怎么知道什么时候需要更新 Apollo 版本呢？”
+
+  建议您在收到类似下图的 **开发包更新提醒短信或站内信** 时，**及时将开发环境中的服务器更新到最新的开发版本**，以确保当正式版本发布时能够顺利对接，避免出现严重兼容性问题，导致玩家无法连接或难以及时修复。
+  ![问题1-9](./res/quest11.png)
+  
+- 在正式版本发布后，通常也会通过类似短信或站内信的方式通知您进行更新。**此外，请务必前往“编辑更新”中的“上传网络游戏”界面，在“适用版本”选项中勾选对应的新版本**，以确保玩家可以正常进入服务器。
+- 同时，我们建议，为了防御可能的外挂破解和兼容性问题，建议只开放最新的2个版本（如目前最新为3.4版本，则只开放3.3和3.4版本）
+
 ## 6、SpigotMaster是否必须加载?
 目前Spigotmaster是强制要求加载，虽然不加载不会报错，但是会有部分功能无法支持。如皮肤防作弊、聊天插件控制、商城接口等。因此强烈要求必须加载SpigotMaster
 **另外目前SpigotMaster不支持reload指令，使用后会不正常，建议不使用Spigot等端的reload指令**

mcguide/27-手机网络游戏/课程11：使用Nukkit开服/0-Nukkit部署教程.md

@@ -0,0 +1,107 @@
+---
+front:
+hard: 入门
+time: 60分钟
+---
+
+# Nukkit部署教程
+
+## 前言
+本文默认认为你了解过Nukkit 或者 通过Waterdogpe + Nukkit搭建过第三方服务器。
+
+如果你没有了解过，请移步到 [2-Nukkit开服教程](2-Server.properties详解.md)
+
+特别鸣谢（排名不分先后）： LT_Name(NukkitMOT作者)、bbbroken(EaseCation服务器开发者)、亦染(社区支持者)
+
+## 准备阶段
+1. 准备Java版本，建议Java版本为Java17及以上版本
+2. 准备NukkitMOT分支，NukkitMOT原作者已将中国版打包到github主分支内 https://github.com/MemoriesOfTime/Nukkit-MOT
+> 目前仅支持接入Nukkit-MOT，其他分支可自行通过参考NukkitMOT源码进行对接
+3. 准备 WaterDogPE 代理服务端而。WaterdogPE 已兼容中国版，开源仓库是： https://github.com/MCNeteaseDevs/WaterdogPE_Netease/tree/netease。
+
+
+## WaterDogPE
+### config.yml 的配置
+
+需要修改以下参数，其他配置根据情况自行修改
+```yaml
+
+# ....
+
+netease_client: true   # 启用 netease 客户端的支持
+online_mode: true 
+# 开发测试阶段，需要改为false，否则会提示需要 minecraft验证
+# 发布阶段时，需要改为true，之后只能用网易手机客户端连接才能进入
+listener:
+  # .....
+
+  host: 0.0.0.0:19132  # waterdogpe 代理端的IP和端口   。官方提供的机器19132端口可能会被占用，根据实际情况更改
+  priorites:   # 按顺序配置，第一个是玩家进入时默认在的服务器。 一般为大厅服
+    - lobby1   
+    
+  # .....
+servers:   # 子服务器的连接ID配置，如大厅服、游戏服等等。如子服务器不在同一台机器，则需要写具体的ip。
+  lobby1:
+    address: 127.0.0.1:19133
+    public_address: play.myserver.com:19133
+    server_type: bedrock
+
+
+permissions:  # 权限配置，一般用于配置管理员的权限，用于测试、调试。仅通过名字识别，建议发布阶段去掉，改为用插件实现相关调试功能
+  玩家id:
+    - waterdog.player.transfer
+    - waterdog.player.list
+    - waterdog.command.server
+
+```
+
+### 装载客户端模组
+
+当通过waterdogpe代理后，需要将客户端模组存放在waterdogpe 根目录下的 packs 文件夹中，不要存放在NukkitMOT根目录
+> 除非你仅通过NukkitMOT单端开服 否则waterdogpe 会自动将nukkit模组加载数据包拦截
+
+> 但如果关闭waterdogpe的资源包功能，Nukkit数据包依然会被waterdogpe拦截而无法正常进入游戏
+
+确保 config.yml 已启用资源包
+```yaml
+enable_packs: true   # 必须打开
+overwrite_client_packs: true   # 按需
+force_server_packs: true   # 按需
+```
+
+### 模组打包格式
+
+waterdogpe 仅支持 zip和mcpack包，不支持文件夹。  
+可以将行为包、资源包都存放在packs目录中。  
+目前仅支持 manifest.json ，不支持 pack_manifest.json
+
+zip打包格式为： 压缩包一级目录下就是 manifest.json，不要额外套一层文件夹
+![图](./images/img.png)
+
+## Nukkit-MOT
+
+nukkit社区的插件  
+https://cloudburstmc.org/resources/categories/nukkit-plugins.1/
+
+### server.properties 配置
+
+为了确保Nukkit-MOT正常接入中国版，您需要调整一些配置
+```properties
+xbox-auth=off
+netease-client-support=on
+only-allow-netease-client=on
+```
+
+### 模组装载
+
+如果使用 waterdogpe 代理，则需要将模组放在 waterdogpe 目录，而非Nukkit目录  
+如果仅适用Nukkit，则将行为包合资源包都放在Nukkit目录下有关 netease的文件里
+ 
+### NukkitMaster插件
+
+NukkitMaster相当于Spigot服的SpigotMaster，内置封装了PyRPC、订单接口、消息收发等功能，API和使用方法和SpigotMaster一样。
+
+
+### 自定义物品、方块和实体
+
+Nukkit-MOT本身已经支持自定义物品、方块、实体的功能，可以参考[官方文档](https://www.nukkit-mot.com/zh/docs/tutorial-extras/custom/custom_item)

mcguide/27-手机网络游戏/课程11：使用Nukkit开服/1-NukkitMasterAPI文档.md

@@ -0,0 +1,278 @@
+---
+front:
+hard: 入门
+time: 60分钟
+---
+
+# NukkitMaster文档
+
+## 准备阶段
+
+在部署Nukkit服务器之前，您需要阅读一下NukkitMaster的API来进行基本的ModSDK通信与商业化内容接入。  
+NukkitMaster需要安装在Nukkit-MOT服务端中。  
+
+> 需要注意: NukkitMaster是基于Nukkit-MOT分支进行开发的。Nukkit官方服务端版本无法兼容。
+
+> 如果您需要使用其他分支的Nukkit，您可以参考NukkitMOT源码仓库修改的内容而自行修改服务端以兼容中国版的协议。  
+> 通信内容方面，您可以自行反编译NukkitMaster来兼容您的其他分支的Nukkit服务端。
+
+> NukkitMOT分支开源地址： https://github.com/MemoriesOfTime/Nukkit-MOT
+
+## 插件配置
+
+```yaml
+# 服务器id（开发者平台中的资源数字id）
+game_id: ""
+# 正式服务器key（开发者平台中的签名信息）
+game_key: ""
+# 测试服务器key（开发者平台中的签名信息）
+test_game_key: ""
+
+# 是否是测试服
+test_server: false
+
+# 是否使用自定义商城（false表示使用官方提供的商城功能）
+custom_shop: false
+
+
+# 订单服务器地址（一般不用填，保持""即可）
+shop_server_url: ""
+# web服务器地址（一般不用填，保持""即可）
+web_server_url: ""
+```
+
+NukkitMaster插件会在 `plugins/NukkitMaster` 下生成 `config.yml` ，需要将服务器的相关数据进行配置，订单API才能生效。  
+其中`gameid`、`rawkey`、`test rawkey`是必须要填写的。  
+`test_server`需要根据服务器部署情况进行修改，这个值会影响NukkitMaster插件使用的是正式服url还是测试服url  
+`custom_shop` 和 [商业化流程](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/27-%E6%89%8B%E6%9C%BA%E7%BD%91%E7%BB%9C%E6%B8%B8%E6%88%8F/%E8%AF%BE%E7%A8%8B9%EF%BC%9A%E6%9C%8D%E5%8A%A1%E5%99%A8%E4%B8%8A%E7%BA%BF/%E7%AC%AC3%E8%8A%82%EF%BC%9A%E5%95%86%E4%B8%9A%E5%8C%96%E6%93%8D%E4%BD%9C.html?key=use_custom_shop&docindex=1&type=0) 中 use custom shop 功能同理  
+`shop_server_url`、`web_server_url`为预留配置，目前不需要修改，默认即可
+
+## API
+
+### `public void enableCustomShopEntry(boolean useCustomShop)`
+开启商城插件的入口，该功能已经在NukkitMaster中集成，可修改NukkitMaster的`config.yml`文件。   
+参数： `useCustomShop` —— 是否使用自定义商城入口，为false时，则使用官方商城入口
+
+### `public void openShop(Player player)`
+打开指定玩家商城界面 注意：该接口需要使用商城插件，并修改config.yml的`custom_shop`为true。  
+参数： `player` —— 玩家
+
+### `public void closeShop(Player player)`
+关闭指定玩家商城界面 注意：该接口需要使用商城插件，并修改config.yml的`custom_shop`为true。  
+参数： `player` —— 玩家
+
+### `public void getPlayerOrderList(Player player, FutureCallback<Map<String, Object>> callback)`
+获取玩家未发货订单列表
+参数：   
+`player` —— 玩家  
+`callback` —— FutureCallBack 回调函数
+
+例子：   
+回调参数为Map<String,Object>, 目前值为  
+
+| Key         | Value      |
+|-------------|------------|
+| json_result | 订单json数据对象 |
+| player      | Player玩家对象 |
+
+### `public void finPlayerOrder(Player player, List<String> orderList, FutureCallback<Map<String, Object>> callback)`
+获取玩家未发货订单列表
+参数：   
+`player` —— 玩家  
+`orderList` —— 订单id列表  
+`callback` —— FutureCallBack 回调函数
+
+### `public void listenForNukkitMasterEvent(SpigotMasterEvent event, PyRpcHandler handler)`
+
+监听spigot master的自定义事件
+参数：   
+`event` — SpigotMasterEvent的枚举值
+`handler` — 回调函数
+
+
+### `public void listenForEvent(String namespace, String system, String event, PyRpcHandler handler)`
+
+注册客户端事件
+参数：   
+`namespace` — 来源客户端系统的namespace
+`system` — 来源客户端系统的systemName
+`event` — 事件名
+`handler` — 回调函数
+
+
+### `public void notifyToClient(Player player, String namespace, String system, String event, Map<String, Object> data)`
+
+给指定玩家发送服务端事件
+参数：   
+`player` — 接收事件的玩家
+`namespace` — 在客户端系统使用ListenForEvent监听的namespace
+`system` — 在客户端系统使用ListenForEvent监听的systemName
+`event` — 事件名
+`data` — 事件参数。注意，要使用-2指代本地玩家的entityId。
+
+
+### `public void notifyToMultiClients(List<Player> players, String namespace, String system, String event, Map<String, Object> data)`
+
+给多个玩家发送服务端事件。 因为-2的entityId对于不同玩家来说都指代本机玩家，而非某个固定的实体，所以不要在多播中发送这种信息。
+参数：   
+`players` — 接收事件的玩家列表
+`namespace` — 在客户端系统使用ListenForEvent监听的namespace
+`system` — 在客户端系统使用ListenForEvent监听的systemName
+`event` — 事件名
+`data` — 事件参数
+
+
+### `public void notifyToClientsNearby(@Nullable Player except, Location loc, double dist, String namespace, String system, String event, Map<String, Object> data)`
+
+给某个位置附近一定半径内的所有玩家发送服务端事件。 因为-2的entityId对于不同玩家来说都指代本机玩家，而非某个固定的实体，所以不要在多播中发送这种信息。
+参数：   
+`except` — 发送事件时排除掉这个玩家，可以为null表示不排除
+`loc` — 圆心位置
+`dist` — 半径
+`namespace` — 在客户端系统使用ListenForEvent监听的namespace
+`system` — 在客户端系统使用ListenForEvent监听的systemName
+`event` — 事件名
+`data` — 事件参数
+
+
+### `public void broadcastToAllClient(@Nullable Player except, World world, String namespace, String system, String event, Map<String, Object> data)`
+
+给某个world内的所有玩家发送服务端事件。 因为-2的entityId对于不同玩家来说都指代本机玩家，而非某个固定的实体，所以不要在多播中发送这种信息。
+参数：   
+`except` — 发送事件时排除掉这个玩家，可以为null表示不排除
+`world` — 所在world
+`namespace` — 在客户端系统使用ListenForEvent监听的namespace
+`system` — 在客户端系统使用ListenForEvent监听的systemName
+`event` — 事件名
+`data` — 事件参数
+
+
+### `public void broadcastToAllClient(@Nullable Player except, String namespace, String system, String event, Map<String, Object> data)`
+
+给服务器内的所有玩家发送服务端事件。 因为-2的entityId对于不同玩家来说都指代本机玩家，而非某个固定的实体，所以不要在多播中发送这种信息。
+参数：  
+`except` — 发送事件时排除掉这个玩家，可以为null表示不排除
+`namespace` — 在客户端系统使用ListenForEvent监听的namespace
+`system` — 在客户端系统使用ListenForEvent监听的systemName
+`event` — 事件名
+`data` — 事件参数
+
+
+## API的使用例子
+
+可以参考Spigot开服的商店DEMO： [商城Demo详解](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/27-%E6%89%8B%E6%9C%BA%E7%BD%91%E7%BB%9C%E6%B8%B8%E6%88%8F/%E8%AF%BE%E7%A8%8B10%EF%BC%9A%E4%BD%BF%E7%94%A8Spigot%E5%BC%80%E6%9C%8D/30-Spigot%E6%9C%8DDemo%E8%AF%A6%E8%A7%A3/3-%E5%95%86%E5%9F%8EDemo%E8%AF%A6%E8%A7%A3.html)  
+仅仅只是将其中spigotMaster更换为nukkitMaster，其他逻辑基本相同
+
+### 获取nukkitMaster对象
+```java
+import com.neteasemc.nukkitmaster.NukkitMaster;
+public final class App extends PluginBase {
+    NukkitMaster nukkitMaster;
+
+    @Override
+    public void onEnable() {
+		// 可以直接获取instance
+        nukkitMaster = NukkitMaster.getInstance();
+		// 或者通过插件名字获取
+		nukkitMaster = (NukkitMaster)getServer().getPluginManager().getPlugin("NukkitMaster");
+    }
+}
+```
+
+### 监听玩家购买商品事件、玩家催发货事件和发货逻辑
+```java
+    public void ListenShop() {
+        PyRpcHandler shipItemHandler = new PyRpcHandler() {
+            @Override
+            public void onEvent(Player player, Map<String, Object> data) {
+                tryShipItem(player);
+            }
+        };
+        // 玩家催发货或者玩家购买物品成功事件进行发货检查
+        nukkitMaster.listenForNukkitMasterEvent(NukkitMasterEvent.PLAYER_BUY_ITEM_SUCCESS, shipItemHandler);
+        nukkitMaster.listenForNukkitMasterEvent(NukkitMasterEvent.PLAYER_URGE_SHIP, shipItemHandler);
+    }
+
+    // 获取玩家订单，并且尝试发货
+    public void tryShipItem(Player player){
+        FutureCallback<Map<String, Object>> cbHandler = new FutureCallback<Map<String, Object>>() {
+            @Override
+            public void completed(Map<String, Object> result) {
+                JSONObject jsonRes = (JSONObject)result.get("json_result");
+                Player requestPlayer = (Player)result.get("player");
+
+                JSONArray entities = (JSONArray)jsonRes.get("entities");
+                // 这里进行entites的订单内容发放
+                List<String> finOrderIds = new ArrayList<>();
+                for(int i = 0; i < entities.size(); ++i){
+                    JSONObject order = (JSONObject)entities.get(i);
+                    // 取出订单id，判断是否已经发放过，比如说通过本地的数据库等 
+                    String orderId = order.getAsString("orderid");
+
+                    // 对于还未发放的订单, 根据order的cmd字段进行对应的奖励逻辑发放
+                    // 如：shipItemToPlayer(requestPlayer);
+                    // 发放完之后记录数据库
+                    // 如：saveOrder(requestPlayer, orderId);
+
+                    // 最后通知网易服务器订单已完成
+                    finOrderIds.add(orderId);
+                }
+                finPlayerOrder(requestPlayer, finOrderIds);
+            }
+
+            @Override
+            public void failed(Exception ex) {
+                // 失败原因
+                getLogger().info(ex.toString());
+            }
+
+            @Override
+            public void cancelled() {
+                getLogger().info("取消请求玩家订单");
+            }
+        };
+        nukkitMaster.getPlayerOrderList(player, cbHandler);
+    }
+    
+
+    // 通知网易服务器订单完成 
+    public void finPlayerOrder(Player player, List<String> finOrderList){
+        FutureCallback<Map<String, Object>> cbHandler = new FutureCallback<Map<String, Object>>() {
+
+            @Override
+            public void completed(Map<String, Object> result) {
+                JSONObject jsonRes = (JSONObject)result.get("json_result");
+                Player requestPlayer = (Player)result.get("player");
+                getLogger().info("玩家:" + requestPlayer.getDisplayName() + " 订单已完成:" + jsonRes);
+            }
+
+            @Override
+            public void failed(Exception ex) {
+                getLogger().info(ex.toString());
+            }
+
+            @Override
+            public void cancelled() {
+                getLogger().info("取消通知玩家订单完成");
+            }
+            
+        };
+        nukkitMaster.finPlayerOrder(player, finOrderList, cbHandler);
+    }
+
+
+```
+
+
+## NukkitMaster Event事件
+### `PLAYER_URGE_SHIP("player_urge_ship")`
+
+玩家催发货事件
+
+### `PLAYER_BUY_ITEM_SUCCESS("player_buy_item_success")`
+
+玩家购买成功事件
+
+### `CLIENT_LOAD_ADDON_FINISH("client_load_addon_finish")`
+
+玩家客户端加载Mod完成事件

mcguide/27-手机网络游戏/课程11：使用Nukkit开服/2-Server.properties详解.md

@@ -0,0 +1,974 @@
+---
+front:
+hard: 入门
+time: 60分钟
+---
+
+# server.properties参数解释
+
+## 前言
+
+作者：LT_Name  
+原文： [server.properties](https://www.nukkit-mot.com/zh/docs/server-config/server-properties)
+
+修改服务器的运行配置，以此来定制一些基本功能。
+
+## `server-ip`
+| 数据类型   | 默认值     |
+|--------|---------|
+| String | 0.0.0.0 |
+
+服务器的IP
+
+## `server-port`
+| 数据类型    | 默认值   |
+|---------|-------|
+| Integer | 19132 |
+
+服务器的端口
+
+> 同一端口不能运行多个服务器  
+如果不能访问请检查防火墙  
+基岩版使用 UDP  
+
+## `enable-query`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用 Query 查询  
+详见：https://wiki.vg/Query
+
+## `motd`
+| 数据类型   | 默认值              |
+|--------|------------------|
+| String | Minecraft Server |
+
+服务器名称/显示在服务器列表上的文本
+
+## `sub-motd`
+| 数据类型   | 默认值                   |
+|--------|-----------------------|
+| String | Powered by Nukkit-MOT |
+
+motd 的第二行
+
+> 只有当在游戏中的好友列表中查看服务器时，才会显示给本地网络中的玩家  
+自 1.16.210 以来不能为空
+
+## `view-distance`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 8   |
+
+最大视距（以区块为单位）  
+更大的值 = 加载更多区块 = 更多的内存和 CPU 使用
+
+## `achievements`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用玩家成就
+
+## `announce-player-achievements`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+向所有玩家广播获得成就的消息
+
+## `spawn-protection`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 10  |
+
+非管理员(OP)玩家无法在区块内建造或破坏方块的生成保护区域大小（以方块为单位）
+
+## `max-players`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 50  |
+
+服务器允许的最大玩家人数
+
+## `drop-spawners`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+刷怪笼被挖掘后掉落
+
+## `spawn-animals`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+启用动物生成
+
+## `spawn-mobs`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+启用怪物生成
+
+## `gamemode`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 2   |
+
+服务器的默认游戏模式  
+0 = 生存, 1 = 创造, 2 = 冒险, 3 = 旁观
+
+## `force-gamemode`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+每次加入时将玩家游戏模式设置为默认游戏模式
+
+## `difficulty`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 2   |
+
+服务器的默认难度（0-3）
+
+## `hardcore`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+玩家死亡后将其封禁
+
+## `pvp`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+是否启用玩家对战
+
+## `white-list`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+仅允许白名单中的玩家加入服务器  
+使用`/whitelist`命令或修改 `white-list.txt` 来添加玩家到白名单
+
+## `whitelist-reason`
+| 数据类型   | 默认值                    |
+|--------|------------------------|
+| String | Server is white-listed |
+
+启用白名单的原因，显示给被阻挡在外的玩家
+
+## `generator-settings`
+| 数据类型   | 默认值 |
+|--------|-----|
+| String |     |
+
+默认级别的特殊世界生成器设置
+
+## `level-name`
+| 数据类型   | 默认值   |
+|--------|-------|
+| String | world |
+
+默认世界的名称
+
+## `level-seed`
+| 数据类型   | 默认值 |
+|--------|-----|
+| String |     |
+
+默认世界的种子
+
+## `level-type`
+| 数据类型   | 默认值  |
+|--------|------|
+| String | void |
+
+如果默认世界不存在，则使用的生成器  
+默认支持：default, normal, flat, nether, the_end或void
+
+## `enable-rcon`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+启用远程控制台访问
+
+> RCON 不是一个非常安全的远程控制服务器的方式  
+RCON 可以使用与服务器相同的端口（TCP 协议）  
+详见：https://developer.valvesoftware.com/wiki/Source_RCON_Protocol
+
+## `rcon.password`
+| 数据类型   | 默认值     |
+|--------|---------|
+| String | 随机10位字符 |
+
+RCON 连接的密码
+
+## `rcon.port`
+| 数据类型    | 默认值   |
+|---------|-------|
+| Integer | 25575 |
+
+RCON 连接的端口
+
+## `auto-save`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+自动保存世界、玩家数据
+
+> 如果禁用，则对世界的更改不会自动保存，即使在卸载时也是如此，如果需要可以使用插件手动保存
+
+您可以使用 `worlds-level-auto-save-disabled` 仅禁用自动保存世界
+
+## `force-resources`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+强制玩家下载服务器的资源包后才能加入  
+还请参阅 `force-resources-allow-client-packs`
+
+## `force-resources-allow-client-packs`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+在启用 `force-resources` 时不要禁用客户端自己的资源包
+
+## `xbox-auth`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+需要经过 Xbox 帐户验证后才能加入
+
+> 不会绕过客户端的限制条件。  
+如果您选择禁用此功能（不推荐这样做），请在玩家名称和 UUIDs 传递给权限管理器或管理员之后，以确保它们已经得到了验证。
+
+## `encryption`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用网络加密  
+如果不使用代理软件，则建议启用此功能
+
+## `bed-spawnpoints`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+允许玩家使用床和重生锚设置重生点
+
+## `explosion-break-blocks`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用爆炸对方块造成的破坏  
+影响所有爆炸，如 TNT、苦力怕和末影水晶
+
+## `stop-in-game`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+允许 OP 在游戏中使用 `/stop` 命令
+
+## `op-in-game`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+允许 OP 在游戏中使用 `/op` 命令对其他玩家进行操作
+
+## `space-name-mode`
+| 数据类型   | 默认值    |
+|--------|--------|
+| String | ignore |
+
+玩家名称中带有空格的处理方式  
+"disabled" - 禁止带有空格名称的玩家进入服务器  
+"ignore" - 忽略空格名称 （默认）  
+"replacing" - 用"_"替换玩家名称中的空格
+
+## `xp-bottles-on-creative`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+允许创造模式下玩家扔经验瓶
+
+## `spawn-eggs`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+启用刷怪蛋，允许通过刷怪蛋生成实体
+
+## `mob-ai`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用 MobPlugin 的生物 AI
+
+## `entity-auto-spawn-task`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+启用自动生成怪物和动物的任务  
+生成功能依据服务器的游戏难度来工作  
+注意：如果您希望生成任何生物，必须启用`spawn-animals`、`spawn-mobs`其一，或者两者都启用。
+
+## `entity-despawn-task`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+若启用，则没有使用命名牌命名的生物的会自动消失
+
+> 末影龙、凋灵和村民不会消失
+
+## `language`
+| 数据类型   | 默认值 |
+|--------|-----|
+| String | eng |
+
+Nukkit 使用的默认语言
+
+## `force-language`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+强制使用服务器端翻译  
+只有在你有插件来实现这些翻译时才启用
+
+## `shutdown-message`
+| 数据类型   | 默认值           |
+|--------|---------------|
+| String | Server closed |
+
+当您停止服务器时向玩家显示的消息  
+可以使用颜色符号`§`，换行请使用 `§n`。
+
+## `save-player-data`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+如果启用，则以其UUID保存玩家数据的格式，并自动将旧格式的玩家数据转换为新格式  
+如果使用旧版Waterdog代理，请禁用此功能  
+如果存在新的玩家数据，请勿禁用
+
+## `query-plugins`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+若启用则 Query 查询可以获取插件列表（enable-query=on）
+
+## `debug-level`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 1   |
+
+如果您想要更多的调试日志记录，请设置较高的值（1-3）
+
+## `async-workers`
+| 数据类型   | 默认值  |
+|--------|------|
+| String | auto |
+
+异步工作线程数  
+如果设置为 auto，则会尝试自动检测核心数进行调整
+
+## `zlib-provider`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 2   |
+
+选择 zlib 提供程序  
+0 = ZlibOriginal，1 = ZlibSingleThreadLowMem，2 = ZlibThreadLocal  
+默认：2  
+其他提供程序可能会对服务器的性能产生负面影响
+
+## `compression-level`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 4   |
+
+发送数据包的 Zlib 压缩级别（0-9）  
+更高的值 = 更多的 CPU 占用 + 更少的网络占用
+
+## `compression-threshold`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 256 |
+
+不要压缩小于此值的批处理数据包（仅限Zlib）
+
+## `use-snappy-compression`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+使用 Snappy 压缩数据包
+
+## ~~min-mtu~~
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 576 |
+
+~~设置最小 MTU 大小~~  
+~~默认值：576~~
+
+## ~~max-mtu~~
+| 数据类型    | 默认值  |
+|---------|------|
+| Integer | 1492 |
+
+~~设置最大 MTU 大小（576 - 1492）~~  
+~~值越大网络发包越高效，但较小的值或许可以解决某些连接上的问题。~~
+
+## `rak-packet-limit`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 120 |
+
+每个ip可以在一个 RakNet 周期（10ms）内发送的数据包数量  
+超过此限制的ip将被暂时封禁
+
+## `enable-rak-send-cookie`
+| Data Type | Default Value |
+|-----------|---------------|
+| Boolean   | on            |
+
+启用此选项后，服务器会在客户端连接时发送一个 Cookie，用于验证客户端的合法性。  
+这将增强连接的安全性，防止潜在的恶意连接或攻击。
+
+## `timeout-milliseconds`
+| 数据类型    | 默认值   |
+|---------|-------|
+| Integer | 25000 |
+
+如果客户端没有响应，服务器应该等待多长时间后踢出玩家  
+单位为毫秒，1000 毫秒 = 1 秒
+
+## `auto-tick-rate`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+允许服务器自动调整世界游戏刻以维持每秒 20 个游戏刻
+
+## `auto-tick-rate-limit`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 20  |
+
+服务器可以临时降低游戏刻速率到多少
+
+## `base-tick-rate`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 1   |
+
+基础游戏刻速率  
+1 = 每秒 20 个刻度，2 = 每秒 10 个刻度，以此类推。  
+建议保持默认值（1）。
+
+## `always-tick-players`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+始终对玩家进行游戏刻更新
+
+## `light-updates`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+光照更新
+
+## `clear-chunk-tick-list`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+允许服务器在完成每个游戏刻的逻辑更新后，清空用于追踪哪些区块需要进行逻辑更新的列表 `chunkTickList`。  
+这可以帮助优化服务器性能，防止不必要的计算，特别是在大型服务器或有大量区块需要管理的情况下。
+
+## `spawn-threshold`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 56  |
+
+在生成玩家之前需要加载多少个区块
+
+## `chunk-sending-per-tick`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 4   |
+
+每游戏刻发送的区块数
+
+## `chunk-ticking-per-tick`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 40  |
+
+每游戏刻 `chunkTickList` 存储的区块数
+
+## `chunk-ticking-radius`
+| Data Type | Default Value |
+|-----------|---------------|
+| Integer   | 3             |
+
+玩家周围需要进行刻算的区块半径
+
+## `chunk-generation-queue-size`
+| Data Type | Default Value |
+|-----------|---------------|
+| Integer   | 8             |
+
+等待生成的区块数量
+
+## `chunk-generation-population-queue-size`
+| Data Type | Default Value |
+|-----------|---------------|
+| Integer   | 8             |
+
+等待填充的区块数量
+
+## `ticks-per-autosave`
+| Data Type | Default Value |
+|-----------|---------------|
+| Integer   | 6000          |
+
+世界自动保存任务运行的频率  
+以刻为单位，20刻 = 1秒
+
+## `ticks-per-entity-spawns`
+| Data Type | Default Value |
+|-----------|---------------|
+| Integer   | 200           |
+
+实体自动生成任务运行的频率  
+以刻为单位，20刻 = 1秒
+
+## `ticks-per-entity-despawns`
+| Data Type | Default Value |
+|-----------|---------------|
+| Integer   | 12000         |
+
+实体存活的时间  
+以刻为单位，20刻 = 1秒
+
+## `thread-watchdog`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用线程看门狗
+
+## `thread-watchdog-tick`
+| 数据类型    | 默认值   |
+|---------|-------|
+| Integer | 60000 |
+
+如果 Nukkit-MOT 主线程暂停超过 60000 毫秒，会抛出致命错误并终止执行的毫秒数
+
+## `nether`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+生成地狱世界
+
+## `end`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+生成末地世界
+
+## `vanilla-portals`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+原版传送门
+
+## `portal-ticks`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 80  |
+
+玩家触发传送门所需Tick
+
+## `multi-nether-worlds`
+| 数据类型   | 默认值 |
+|--------|-----|
+| String |     |
+
+如果你需要多个地狱世界，在这里列出应该有自己地狱的世界，否则使用默认的地狱世界
+
+## `anti-xray-worlds`
+| 数据类型   | 默认值 |
+|--------|-----|
+| String |     |
+
+启用内置反矿透的世界列表
+
+示例：`world, survival, factions`
+
+## `do-not-tick-worlds`
+| 数据类型   | 默认值 |
+|--------|-----|
+| String |     |
+
+禁用随机方块刻度的世界列表  
+这将禁用植物生长、树叶腐烂、草方块蔓延、方块掉落等。  
+你可能想在这里添加你的大堂和迷你游戏世界
+
+## `worlds-entity-spawning-disabled`
+| 数据类型   | 默认值 |
+|--------|-----|
+| String |     |
+
+不允许实体自动生成的世界列表
+
+示例：`lobby, pvp, creative`
+
+## `load-all-worlds`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+加载所有世界
+
+## `ansi-title`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+启用在 Windows CMD 标题中显示服务器占用信息  
+<Image img={require('@site/static/images/server-config/windows_cmd_title.png')} alt="Windows 命令行标题" />
+
+## `block-listener`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用用于雪块、铁傀儡、怪物蛋石等的检查
+
+## `allow-flight`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+启用/禁用飞行反作弊
+
+## `multiversion-min-protocol`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 0   |
+
+多版本的最低协议
+
+## `multiversion-max-protocol`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | -1  |
+
+多版本的最高协议
+
+## `vanilla-bossbars`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+显示凋零和末影龙的Boss血条（实验性）
+
+## `strong-ip-bans`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+强制 IP 封禁
+
+## `worlds-level-auto-save-disabled`
+| 数据类型   | 默认值 |
+|--------|-----|
+| String |     |
+
+禁用自动保存  
+等级的世界
+
+## `temp-ip-ban-failed-xbox-auth`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+临时封禁 Xbox 身份验证失败的玩家
+
+## `call-data-pk-send-event`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+如果没有插件使用它，可以禁用 `DataPacketSendEvent` 以获得更好的性能
+
+## `call-batch-pk-send-event`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+如果没有插件使用它，可以禁用 `BatchPacketsEvent` 以获得更好的性能
+
+## `do-level-gc`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+在游戏刻之间进行世界垃圾收集
+
+## `skin-change-cooldown`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 15  |
+
+玩家皮肤更换冷却时间（秒）
+
+## ~~check-op-movement~~
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+~~为管理员(OP)启用移动检查~~
+
+## `do-not-limit-interactions`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+禁用用于限制客户端右键交互垃圾数据包的黑客技术
+
+## `do-not-limit-skin-geometry`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+禁用最大皮肤几何大小检查  
+可能对某些玩家，皮肤的可用性是必需的
+
+## `automatic-bug-report`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用自动报告错误
+
+## ~~anvils-enabled~~
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+~~启用铁砧~~  
+~~在 Nukkit 上，铁砧属于实验性功能方块，普遍存在物品重命名、物品数据丢失等问题~~
+
+## `save-player-data-by-uuid`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+如果启用，则以 NukkitX 使用的格式保存玩家数据，并自动将旧格式的玩家数据转换为新格式  
+如果使用旧版 WaterdogPE 代理，请禁用此功能
+
+> 如果存在新的玩家数据，请勿禁用
+
+## `persona-skins`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+允许玩家自己的皮肤
+
+> 如果禁用，将显示默认的史蒂夫皮肤  
+某些玩家的皮肤可能需要启用 `do-not-limit-skin-geometry` 才能使用
+
+## ~~call-entity-motion-event~~
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+~~您可以禁用 EntityMotionEvent 以获得更好的性能，如果您的插件没有使用它~~
+
+## `update-notifications`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+有新的 Nukkit-MOT 版本发布时通知刚加入游戏的管理员(OP)
+
+## `bstats-metrics`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用 bStats 统计  
+https://bstats.org/plugin/server-implementation/Nukkit/  
+匿名收集数据：Nukkit 版本（Nukkit-MOT）、玩家数量、玩家游戏版本、是否开启 Xbox 身份验证、Java 版本、操作系统、CPU 架构及数量、服务器地理位置（粗略）
+
+## `cache-chunks`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+将区块保存到内存中以加快发送速度
+
+> 多版本支持的效果不佳
+
+## `async-chunks`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用异步区块发送  
+当向不同版本的玩家发送大量区块时，这可以极大地提高性能  
+建议保持此选项开启
+
+## `deprecated-verbose`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+当插件使用不推荐 API 时在控制台显示警告。
+
+## `server-authoritative-movement`
+| 数据类型   | 默认值         |
+|--------|-------------|
+| String | server-auth |
+
+服务器移动验证方式
+可选：`client-auth / server-auth-with-rewind / server-auth`
+
+## `server-authoritative-block-breaking`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+服务器权威方块破坏
+
+## `use-client-spectator`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+使用客户端侧的旁观者模式
+
+## `enable-experiment-mode`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用实验模式
+
+## `use-waterdog`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+尝试获取 WaterdogPE 提供的客户端真实 IP  
+详见：https://waterdog.dev/
+
+## `enable-spark`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+启用 Spark 用于性能分析  
+详见：https://spark.lucko.me/docs
+
+## `hastebin-token`
+| 数据类型   | 默认值 |
+|--------|-----|
+| String |     |
+
+Hastebin 令牌，方便生成 debug 链接  
+详见：https://www.toptal.com/developers/hastebin/documentation
+
+## `use-native-leveldb`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | off |
+
+使用原生的 LevelDB 实现
+
+## `enable-raw-ores`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Boolean | on  |
+
+启用粗矿石；若启用则对高版本玩家掉落粗铜、粗铁、粗金  
+版本自 [BE 1.17.0](https://minecraft.wiki/w/Bedrock_Edition_1.17.0) 起
+
+## `enable-new-paintings`
+| Data Type | Default Value |
+|-----------|---------------|
+| Boolean   | on            |
+
+启用在1.21版本新加入的画
+
+## `enable-new-chicken-eggs-laying`
+| Data Type | Default Value |
+|-----------|---------------|
+| Boolean   | on            |
+
+启用鸡产出新类型鸡蛋
+（蓝色鸡蛋&棕色鸡蛋）
+
+## `leveldb-cache-mb`
+| 数据类型    | 默认值 |
+|---------|-----|
+| Integer | 80  |
+
+与 `use-native-leveldb` 一同使用  
+用于减少每个世界硬盘读写操作的区块数据最大缓存大小  
+如果你拥有大量内存并且仅有几个大型世界，可以调高此缓存大小
+
+## `forced-safety-enchant`
+| Data Type | Default Value |
+|-----------|---------------|
+| Boolean   | on            |
+
+启用强制安全附魔（限制附魔最大等级）
+
+## `netease-client-support`
+| Data Type | Default Value |
+|-----------|---------------|
+| Boolean   | off           |
+
+启用网易客户端支持，启用后将允许网易玩家进入服务器
+
+## `only-allow-netease-client`
+| Data Type | Default Value |
+|-----------|---------------|
+| Boolean   | off           |
+
+仅允许网易玩家进入服务器，开启后将禁止微软版玩家进入服务器，仅允许网易玩家加入服务器
+
+

mcguide/27-手机网络游戏/课程11：使用Nukkit开服/3-客户端打包教程.md

@@ -0,0 +1,30 @@
+---
+front:
+hard: 入门
+time: 60分钟
+---
+
+# 客户端打包教程
+
+## 前言
+
+为了能够让MC Server识别到开发者在客户端的模组，除了将资源文件放在服务端/代理端相应位置以外，还需要将行为包和资源包打包成可被解析的包体
+
+## 打包与上传
+
+客户端的包体您可以将他视作一个地图Addons去看待
+
+里面的内容都与地图addons相似
+
+![](./images/img_1.png)
+
+获取到这些文件后，用压缩软件压缩成7z格式的压缩包
+
+目录格式如下
+
+![](./images/img_3.png)
+![](./images/img_2.png)
+
+打包完后，上传客户端即可
+
+> 入驻上传的客户端没有做机审验证，上架期间上传的客户端是有机审验证的，从而确保格式正确

mcguide/27-手机网络游戏/课程12：使用Allay开服/0-Allay部署教程.md

@@ -0,0 +1,79 @@
+---
+front:
+hard: 入门
+time: 15分钟
+---
+
+# Allay部署教程
+
+本系列教程将指导您使用Allay搭建一个服务器，安装NetAllay以使用网易独有接口，以及使用WaterdogPE搭建群组服。
+
+本系列教程主要侧重于网易版相关内容。有关Allay的更多文档，请移步至[AllayMC官方文档站](https://docs.allaymc.org)。
+
+相关链接：
+- AllayMC交流群（QQ）：1072132791
+- AllayMC官方文档站：https://docs.allaymc.org
+- AllayMC插件市场：https://hub.allaymc.org
+- AllayMC代码仓库：https://github.com/AllayMC/Allay
+
+## 安装Java
+
+Allay 需要**Java 21**才能运行。市面上有多种 Java 发行版，但我们推荐以下版本：
+
+- [**GraalVM**](https://www.graalvm.org/) – 提供更好的性能
+- [**OpenJDK**](https://adoptium.net/) – 提供更佳的稳定性
+
+安装后，通过运行以下程序验证 Java 是否正确安装：
+
+```shell
+java --version
+```
+
+如果 Java 安装正确，您应该能看到没有错误提示的版本输出。
+
+## 使用AllayLauncher
+
+[AllayLauncher](https://github.com/AllayMC/AllayLauncher)是一个轻量级、快速的工具（用C++编写），能帮您轻松下载、更新和管理您的Allay实例。
+
+安装它只需执行一个命令：
+
+Windows (PowerShell):
+```powershell
+Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/AllayMC/AllayLauncher/refs/heads/main/scripts/install_windows.ps1").Content
+```
+
+Linux:
+```bash
+wget -qO- https://raw.githubusercontent.com/AllayMC/AllayLauncher/refs/heads/main/scripts/install_linux.sh | bash
+```
+
+## 手动安装Allay
+
+### 获取Allay核心文件
+
+请从[GitHub Releases](https://github.com/AllayMC/Allay/releases/latest)页面获取最新稳定版本。您也可以尝试[Nightly Build](https://github.com/AllayMC/Allay/releases/tag/nightly)。
+
+您应该会得到一个文件，名称如下：
+```
+allay-server-<version>-<commit-hash>[-dev]-shaded.jar
+```
+
+示例:
+```
+allay-server-0.1.0-dev-shaded.jar
+```
+
+> `-dev`后缀表示开发版本。
+
+### 运行服务器
+
+如果您的系统有图形界面（GUI），只需双击jar文件即可。如果正确安装了Java，会出现类似这样的窗口：
+
+![installation-p1.png](images/installation-p1.png)
+
+如果您在无头服务器（无图形界面）上，使用以下命令启动服务器：
+```bash
+java -jar allay-server-*-shaded.jar
+```
+
+您会在终端看到同样的启动输出。

mcguide/27-手机网络游戏/课程12：使用Allay开服/1-启用网易支持.md

@@ -0,0 +1,51 @@
+---
+front:
+hard: 入门
+time: 20分钟
+---
+
+# 启用网易支持
+
+本文将指导您调整服务器设置以允许网易客户端进服，如果您并不了解如何部署一个Allay服务器，请移步至[Allay部署教程](0-Allay部署教程.md)。
+
+## 调整`server-settings.yml`
+
+Allay默认不允许网易客户端进服，需要修改服务器根目录下`server-settings.yml`中的如下配置项：
+
+```yaml
+network-settings:
+  # Enable support for NetEase (China) Minecraft clients
+  netease-client-support: true
+  # If set to true, only NetEase clients can join the server
+  # This option only takes effect when netease-client-support is enabled
+  only-allow-netease-client: false
+```
+
+您还可以将`only-allow-netease-client`设置为`true`，以阻止国际版客户端进服。
+
+## 安装NetAllay（可选）
+
+Allay的API模块默认不提供网易版独有接口，例如PyRpc，商城接口等。如需使用，您需要在服务器上安装[NetAllay](https://github.com/AllayMC/NetAllay)。
+您需要从Release页面下载NetAllay的jar包并将其放入服务器的`plugins`文件夹内。
+
+如果您的插件需要调用NetAllay的接口，需要在项目中引入NetAllay作为依赖：
+```kotlin
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    compileOnly("org.allaymc:net-allay:<version>")
+}
+
+allay {
+    plugin {
+        dependency("NetAllay")
+    }
+}
+```
+
+有关NetAllay的更多内容：
+
+- 常用接口文档请见[NetAllay常用接口文档](3-NetAllay常用接口文档.md)
+- 源码与项目仓库请见：https://github.com/AllayMC/NetAllay

mcguide/27-手机网络游戏/课程12：使用Allay开服/2-使用WaterdogPE搭建群组服.md

@@ -0,0 +1,85 @@
+---
+front:
+hard: 进阶
+time: 30分钟
+---
+
+# 使用WaterdogPE搭建群组服
+
+本文将指导您使用WaterdogPE搭建群组服务器，您需要具有群组服部署相关经验。WaterdogPE是一款适用于MCBE的群组服（反代）软件，类似MCJE的BungeeCord以及Velocity。
+有关更多WaterdogPE的相关文档，您可以移步至其[官方文档站](https://docs.waterdog.dev/books/waterdogpe-setup)，本文将侧重于网易相关内容。
+
+## 构建WaterdogPE
+
+由于WaterdogPE官方仓库并未提供网易客户端支持，您需要使用[AllayMC的分叉版本](https://github.com/AllayMC/WaterdogPE)，请自行构建jar包。
+
+## 启用网易支持
+
+WaterdogPE启动后会生成一个`config.yml`配置文件，您需要修改以下配置项以启用网易客户端支持：
+
+```yaml
+netease_client_support: true
+# Optional: only allow NetEase clients to connect
+only_allow_netease_client: false
+```
+
+> 启用网易客户端支持后，所有RakNet v8客户端都将被视为网易客户端。
+
+## 配置下游服务器
+
+在`config.yml`中，您需要配置WaterdogPE所代理的下游Allay服务器。以下是一个示例配置：
+
+```yaml
+# 下游服务器列表
+servers:
+  lobby:
+    address: 127.0.0.1:19133
+    public_address: play.myserver.com:19133
+  survival:
+    address: 127.0.0.1:19134
+
+# 玩家连接时的服务器优先级（玩家进服后默认进入列表中的第一个服务器）
+priorities:
+  - lobby
+  - survival
+
+# 强制域名映射（可选）
+forced_hosts:
+  lobby.myserver.com: lobby
+```
+
+其中：
+- `address`：下游服务器的实际地址和端口
+- `public_address`：（可选）公开地址，用于玩家直连该子服
+- `priorities`：玩家进入代理后默认连接的服务器顺序
+
+## 其他常用配置
+
+以下是`config.yml`中一些值得关注的配置项：
+
+```yaml
+# 代理监听地址与端口
+host: 0.0.0.0:19132
+# 最大玩家数
+max_players: 20
+
+# 传递玩家真实信息到下游服务器（推荐启用）
+use_login_extras: true
+
+# 启用快速转服（玩家在子服之间转移时不会断开连接）
+fast_transfer: true
+
+# 压缩等级设置
+# 上行（代理→客户端），值越高带宽越省但CPU占用越高
+upstream_compression_level: 7
+# 下行（代理→子服），本地网络可设为较低值
+downstream_compression_level: -1
+```
+
+> `use_login_extras`启用后，代理会在LoginPacket中附加`Waterdog_IP`（玩家真实IP）和`Waterdog_XUID`（玩家XUID）等信息，方便下游服务器获取玩家的真实连接信息。
+
+## 配置下游Allay服务器
+
+下游Allay服务器同样需要启用网易客户端支持，请参考[启用网易支持](1-启用网易支持.md)。
+
+此外，请确保每个下游Allay服务器监听的端口与WaterdogPE中配置的`address`端口一致。例如，若WaterdogPE中配置了`lobby`服务器地址为`127.0.0.1:19133`，则对应Allay服务器的端口应设置为`19133`。

mcguide/27-手机网络游戏/课程12：使用Allay开服/3-NetAllay常用接口文档.md

@@ -0,0 +1,399 @@
+---
+front:
+hard: 进阶
+time: 30分钟
+---
+
+# NetAllay常用接口文档
+
+本文整理了`NetAllay`项目中最常用、最适合插件开发直接使用的接口，方便您在Allay服务器中调用网易版独有能力，例如PyRpc通信与商城能力。
+
+如果您尚未安装NetAllay，请先阅读[启用网易支持](1-启用网易支持.md)。
+
+## 获取NetAllay实例
+
+调用接口前，先拿到`NetAllay`插件实例：
+
+```java
+import org.allaymc.api.server.Server;
+import org.allaymc.netallay.NetAllay;
+
+// 方式一：直接获取静态实例
+NetAllay netAllay = NetAllay.getInstance();
+
+// 方式二：通过插件管理器获取
+NetAllay netAllay = (NetAllay) Server.getInstance()
+        .getPluginManager()
+        .getPlugin("NetAllay");
+```
+
+## PyRpc事件监听
+
+### 监听客户端发来的事件
+
+最常用的入口是`listenForEvent`，用于监听网易客户端发送到服务端的PyRpc事件。
+
+```java
+netAllay.listenForEvent(
+        "MyMod",
+        "MySystemCS",
+        "OnButtonClick",
+        (player, data) -> {
+            String buttonId = (String) data.get("buttonId");
+            plugin.getPluginLogger().info("玩家点击了按钮: {}", buttonId);
+        }
+);
+```
+
+参数说明：
+
+- `namespace`：命名空间，一般对应客户端Mod命名空间
+- `systemName`：客户端系统名
+- `eventName`：事件名
+- `handler`：回调函数，参数为`Player`和`Map<String, Object>`
+
+### 取消事件监听
+
+如果您不再需要某个监听器，可以调用以下接口：
+
+```java
+boolean removed = netAllay.unlistenForEvent(namespace, systemName, eventName, handler);
+
+netAllay.unlistenAllForEvent(namespace, systemName, eventName);
+```
+
+其中：
+
+- `unlistenForEvent`：取消一个具体处理器
+- `unlistenAllForEvent`：取消某个事件下的全部处理器
+
+## 向客户端发送PyRpc事件
+
+### 发送给单个玩家
+
+```java
+Map<String, Object> data = new LinkedHashMap<>();
+data.put("message", "Hello from server!");
+data.put("timestamp", System.currentTimeMillis());
+
+boolean success = netAllay.notifyToClient(
+        player,
+        "MyMod",
+        "MySystemSS",
+        "ServerMessage",
+        data
+);
+```
+
+该方法返回`boolean`，表示是否发送成功。若玩家不是网易客户端，则会返回`false`。
+
+### 立即发送
+
+若您希望不经过缓冲立即下发，可以使用：
+
+```java
+boolean success = netAllay.notifyToClientImmediately(
+        player,
+        "MyMod",
+        "MySystemSS",
+        "ServerMessage",
+        data
+);
+```
+
+### 发送给多个玩家
+
+```java
+int successCount = netAllay.notifyToMultiClients(
+        players,
+        "MyMod",
+        "MySystemSS",
+        "Announcement",
+        Map.of("content", "服务器公告")
+);
+```
+
+返回值为成功发送的玩家数量。
+
+### 发送给附近玩家
+
+```java
+var center = player.getControlledEntity().getLocation();
+
+int count = netAllay.notifyToClientsNearby(
+        null,
+        center,
+        50.0,
+        "MyMod",
+        "MySystemSS",
+        "NearbyEvent",
+        Map.of("type", "explosion")
+);
+```
+
+参数中的`except`可用于排除某个玩家；若不需要排除，传`null`即可。
+
+### 广播到世界、维度或全服
+
+广播接口统一为`broadcastToAllClient`，但有三个重载版本：
+
+```java
+// 广播到指定世界
+int worldCount = netAllay.broadcastToAllClient(
+        null,
+        world,
+        "MyMod",
+        "MySystemSS",
+        "WorldEvent",
+        data
+);
+
+// 广播到指定维度
+int dimensionCount = netAllay.broadcastToAllClient(
+        null,
+        dimension,
+        "MyMod",
+        "MySystemSS",
+        "DimensionEvent",
+        data
+);
+
+// 广播到整个服务器
+int serverCount = netAllay.broadcastToAllClient(
+        null,
+        "MyMod",
+        "MySystemSS",
+        "GlobalEvent",
+        data
+);
+```
+
+## 工具接口
+
+### 判断玩家是否为网易客户端
+
+```java
+boolean netease = netAllay.isNetEasePlayer(player);
+```
+
+### 获取当前注册的事件数量
+
+```java
+int count = netAllay.getRegisteredEventCount();
+```
+
+## 特殊常量
+
+### `LOCAL_PLAYER_ENTITY_ID`
+
+```java
+int entityId = NetAllay.LOCAL_PLAYER_ENTITY_ID; // -2
+```
+
+这个常量表示“接收消息的玩家自己”。常见用法是把实体ID传给客户端时，使用`-2`代表当前玩家自身实体。
+
+```java
+netAllay.notifyToClient(
+        player,
+        "MyMod",
+        "MySystemSS",
+        "Welcome",
+        Map.of("entityId", NetAllay.LOCAL_PLAYER_ENTITY_ID)
+);
+```
+
+注意：`-2`只能在单播接口`notifyToClient`或`notifyToClientImmediately`中使用，不要在多播或广播接口中使用。
+
+## 事件数据支持的类型
+
+`NetAllay`的事件数据类型为`Map<String, Object>`，其中值通常支持以下类型：
+
+- `null`
+- `Boolean`
+- `Integer`、`Long`
+- `Float`、`Double`
+- `String`
+- `byte[]`
+- `Map<String, Object>`
+- `List<?>`、`Iterable<?>`
+
+一个常见示例：
+
+```java
+Map<String, Object> data = new LinkedHashMap<>();
+data.put("title", "测试标题");
+data.put("count", 1);
+data.put("extra", Map.of("flag", true));
+data.put("list", List.of("a", "b", "c"));
+```
+
+## 商城接口
+
+`NetAllay`内置了商城管理器`ShopManager`，用于控制网易商城界面与监听商城事件。
+
+### 获取商城管理器
+
+```java
+var shopManager = netAllay.getShopManager();
+```
+
+### 控制商城入口与界面
+
+```java
+// 是否启用自定义商城入口
+netAllay.enableCustomShopEntry(true);
+
+// 打开商城
+netAllay.openShop(player);
+
+// 关闭商城
+netAllay.closeShop(player);
+
+// 显示一行提示
+netAllay.showHint(player, "购买成功");
+
+// 显示两行提示
+netAllay.showHint(player, "购买成功", "奖励已发放");
+```
+
+这些方法本质上是对`ShopManager`的便捷封装。
+
+### 监听商城事件
+
+商城常见事件定义在`ShopEvent`中：
+
+- `ShopEvent.PLAYER_BUY_ITEM_SUCCESS`：玩家购买成功
+- `ShopEvent.PLAYER_URGE_SHIP`：玩家催发货
+- `ShopEvent.CLIENT_LOAD_ADDON_FINISH`：客户端加载Addon完成
+
+注册示例：
+
+```java
+shopManager.listenForShopEvent(ShopEvent.PLAYER_BUY_ITEM_SUCCESS, (player, data) -> {
+    plugin.getPluginLogger().info("玩家 {} 完成了一笔购买", player.getOriginName());
+});
+
+shopManager.listenForShopEvent(ShopEvent.PLAYER_URGE_SHIP, (player, data) -> {
+    plugin.getPluginLogger().info("玩家 {} 请求催发货", player.getOriginName());
+});
+```
+
+取消监听：
+
+```java
+boolean removed = shopManager.unlistenForShopEvent(ShopEvent.PLAYER_BUY_ITEM_SUCCESS, handler);
+```
+
+### 按玩家覆盖商城配置
+
+如果您希望不同玩家拿到不同的商城参数，可以为玩家设置单独配置：
+
+```java
+ShopManager.PlayerShopConfig config = new ShopManager.PlayerShopConfig();
+config.setGameId("123456");
+config.setUseCustomShop(true);
+config.setTestServer(false);
+config.setCacheTime(1);
+config.setUid(0L);
+config.setPlatformUid("");
+
+shopManager.setPlayerConfig(player, config);
+```
+
+获取和移除配置：
+
+```java
+ShopManager.PlayerShopConfig config = shopManager.getPlayerConfig(player);
+shopManager.removePlayerConfig(player);
+```
+
+## 配置文件
+
+NetAllay会在插件目录生成`config.json`。当前源码中的默认配置如下：
+
+```json
+{
+  "shop": {
+    "gameId": "",
+    "gameKey": "",
+    "testGameKey": "",
+    "testServer": false,
+    "useCustomShop": false,
+    "cacheTime": 1,
+    "shopServerUrl": "",
+    "webServerUrl": ""
+  }
+}
+```
+
+其中商城相关字段含义如下：
+
+- `gameId`：资源数字ID
+- `gameKey`：正式服签名密钥
+- `testGameKey`：测试服签名密钥
+- `testServer`：是否使用测试服模式
+- `useCustomShop`：是否隐藏默认商城按钮并改为自定义入口
+- `cacheTime`：商城配置缓存时间，单位为秒
+- `shopServerUrl`：自定义订单服务地址，可留空
+- `webServerUrl`：自定义Web服务地址，可留空
+
+如果您在运行中修改了配置，也可以调用以下接口：
+
+```java
+netAllay.reloadConfig();
+netAllay.saveConfig();
+```
+
+## 完整示例
+
+```java
+import org.allaymc.api.player.Player;
+import org.allaymc.netallay.NetAllay;
+import org.allaymc.netallay.shop.ShopEvent;
+
+import java.util.Map;
+
+public final class DemoService {
+
+    public void register() {
+        NetAllay netAllay = NetAllay.getInstance();
+
+        netAllay.listenForEvent("MyMod", "MySystemCS", "RequestData", (player, data) -> {
+            netAllay.notifyToClient(
+                    player,
+                    "MyMod",
+                    "MySystemSS",
+                    "ResponseData",
+                    Map.of(
+                            "success", true,
+                            "playerName", player.getOriginName()
+                    )
+            );
+        });
+
+        netAllay.getShopManager().listenForShopEvent(ShopEvent.PLAYER_BUY_ITEM_SUCCESS, (player, data) -> {
+            netAllay.showHint(player, "购买成功", "请及时发货");
+        });
+    }
+
+    public void welcome(Player player) {
+        NetAllay.getInstance().notifyToClient(
+                player,
+                "MyMod",
+                "MySystemSS",
+                "Welcome",
+                Map.of(
+                        "entityId", NetAllay.LOCAL_PLAYER_ENTITY_ID,
+                        "message", "欢迎来到服务器"
+                )
+        );
+    }
+}
+```
+
+## 注意事项
+
+- `NetAllay`只会向网易客户端发送数据，非网易玩家会被自动跳过
+- 广播、多播、附近广播时不要使用`NetAllay.LOCAL_PLAYER_ENTITY_ID`
+- 插件禁用时，建议取消自己注册的事件监听
+- 单次发送的数据不宜过大，避免发送过大的PyRpc包

mcguide/30-测试/3-组件打包发布.md

@@ -6,33 +6,63 @@ time: 5分钟
 
 # 组件打包发布
 
+## 前言
+
+本文将从MC Studio工具快捷打包 和 手动打包 两个方面介绍组件的打包发布
+
 ## 组件配置
 
-在组件的右键菜单，选择配置，可以对作品的UUID与版本号进行修改
+### 配置介绍
+
+UUID: 代表模组的内容的全局唯一标识符，如果有相同的UUID的组件，会在组件上传审核机审时候报错
+
+版本号：对应模组内容的迭代版本
+
+### UUID更新
+
+在组件的右键菜单，选择配置。可以对作品的UUID与版本号进行修改
 
 ![image-20220523212424951](./images/image-20220523212424951.png)
 
-点击随机UUID，将会自动对所有资源包和行为包的UUID进行随机
-
+**点击随机UUID，将会自动对所有资源包和行为包的UUID进行随机**
 选中对应的资源包，右键可以复制其UUID
 
 ![image-20220523212517202](./images/image-20220523212517202.png)
 
-在开发测试阶段，并不需要关注版本号，而当你的组件需要发布到平台，为了让组件上线后能顺利更新，每次发布前需要提升组件版本号，这里你既可以单独升级个别资源包，也可以全选升级所有资源包。
+### 版本号
 
-## 组件发布
+![升级版本号](./new_images/zujiandabao/0_1.png)
 
-当你的组件一切准备就绪，就可以在组件的右键菜单里，点击进行发布。
+在开发测试阶段，并不需要关注版本号，其不会影响你的开发
 
-发布时会自动选中平台已有的同名组件，并自动勾选更新已有作品，因此请尽量保持作品与平台名称一致。
+当你的组件需要发布到平台，如果你是第一次发布组件时，会以资源包与行为包**默认的0.0.1版本**进行发布。而之后的每次更新发布前，需要提升组件版本号，根据你更新的内容决定，这里你可以单独升级个别资源包，也可以全选升级所有资源包。
 
-![image-20220523213006425](./images/image-20220523213006425.png)
+## MC Studio进行快捷打包发布
 
-点击确定后，我们会对作品进行自检，然后导出必要的文件，并压缩成<名称_时间.zip>的命名格式，上传到开发者平台，并打开浏览器对应链接，你可以在这个页面进一步编辑器组件的详情，最后点击保存。
-
-##  组件转换
-
-同时我们还提供了组件间的转换功能，你可以在右键菜单里找到它，将AddOn方便的转换为地图或服务器Mod
+1. MC Studio提供了组件间的转换功能，你可以在右键菜单里找到它，将AddOn方便的转换为地图或服务器Mod
 
 ![image-20220523213431590](./images/image-20220523213431590.png)
 
+
+2. 当你的组件一切准备就绪，就可以在组件的右键菜单里，点击进行发布，随后会有一个选择界面。
+
+![image-20220523213006425](./images/image-20220523213006425.png)
+
+- 新建作品：你的开发者平台中没有该作品，这时会创建一个全新的组件
+
+- 更新已有作品：此时会自动选中平台已有的同名组件，并自动勾选更新已有作品。**当然也可以手动选择其他组件，但是这代表着其他组件的内容将会被本次发布的组件内容覆盖，因此请尽量保持作品与平台中作品名称一致，避免组件上传错误** (可以看到上图中和首页第一张图的组件名称都是叫lobbyGoodsMod2.0)
+
+3. 点击确定后，MC Studio会对作品进行自检，然后导出必要的文件，并压缩成<名称_时间.zip>的命名格式，上传到开发者平台，并打开浏览器对应链接，你可以在这个页面进一步编辑器组件的详情，最后点击保存。
+
+## 手动打包发布
+
+### 检查包体的文件结构与导出
+
+[课程01.包体的结构和导入](https://mc.163.com/dev/mcmanual/mc-dev/mconline/10-addon%E6%95%99%E7%A8%8B/%E7%AC%AC18%E7%AB%A0%EF%BC%9A%E6%89%93%E5%8C%85%E5%AF%BC%E5%87%BA%E4%BD%A0%E7%9A%84%E4%BD%9C%E5%93%81/%E8%AF%BE%E7%A8%8B01.%E5%8C%85%E4%BD%93%E7%9A%84%E7%BB%93%E6%9E%84%E5%92%8C%E5%AF%BC%E5%85%A5.html?catalog=1)介绍了PC PE中所有组件类型的文件结构与打包，开发者可以进行参考检查自己的文件
+
+### 发布
+
+[课程03-组件上架的规范及过审攻略](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/35-%E4%B8%8A%E6%9E%B6%E4%B8%8E%E5%85%A5%E9%A9%BB/%E8%AF%BE%E7%A8%8B04-%E8%AE%A4%E8%AF%86%E4%BD%9C%E5%93%81%E7%AE%A1%E7%90%86%E6%A8%A1%E5%9D%97.html?catalog=1)介绍了如何将打包后组件上传发布，开发者可以进行流程参考
+
+
+

mcguide/30-测试/5-性能监测与调试工具.md

@@ -11,6 +11,10 @@ selection: true
 
 ## 1.方块探针
 
+### 教学视频
+
+<video src="./video/tracy.mp4" controls></video>
+
 ### 准备工作
 
 首先您需要登陆到您的MCStudio，如果您还没有账号，可以点击[**开发者平台链接**](https://mcdev.webapp.163.com/#/login)进行注册：
@@ -425,6 +429,10 @@ MC\_SERVER:
 
 ![图片](./images/airperf01.png)
 
+### 教学视频
+
+<video src="./video/airperf.mp4" controls></video>
+
 ### 了解界面
 
 启动客户端后我们可以先看一下布局，主要包括菜单栏、用户信息栏、功能栏、多功能面板（设备、场景）以及最重要的性能曲线面板。

mcguide/30-测试/6-我的山头模组测试教程.md

@@ -0,0 +1,86 @@
+---
+front:
+hard: 入门
+time: 20分钟
+selection: true
+---
+
+# MCS支持我的山头模组兼容测试
+
+## 准备工作
+
+1. 最新版MC Studio
+2. 最新版 3.6 及以后版本的 安卓手机测试包 （目前暂时不支持IOS）
+
+MCS我的山头容器管理页面位于 【基岩版组件-联机测试】
+
+![](./images/img.png)
+
+## 如何创建一个测试山头
+
+首先需要说明的是，MCS仅支持查阅日志和邀请玩家进入山头服，山头服的创建仍然需要前往测试审核服进行创建
+
+创建完以后MCS会自动同步山头服实例
+
+为了避免资源的浪费，目前只允许创建山腰服务器。其他档位会置灰
+
+![](./images/img_1.png)
+
+打开购买弹窗，点击确认即可
+
+![](./images/img_3.png)
+
+现在，你已经完成了在审核服创建山头的方法，此时当你创建好以后就可以在MCS管理成员和查阅日志
+
+## 添加模组
+
+您现在创建的山头，目前是没有模组的，但是山头容器可以获取到你上传到审核服的所有自测中的模组，但是前提是这个模组必须勾选上架 我的山头 专区
+
+山头专区的模组，可以直接选择安装
+
+![](./images/img_4.png)
+
+这可能有些麻烦，这是因为山头容器只能拉取模组的itemid，这就代表无法本地进行山头服模组兼容测试，你只能上传模组到开平，然后在审核服测试
+
+日志通过MCS进行查阅
+
+## 日志
+
+日志是山头测试的一个重要内容，关系到开发者能否查阅到模组在山头当中的报错从而追踪定位问题所在的代码
+
+所以当你在测试服创建好山头以后，您可以直接在MCS山头测试页面，打开日志
+
+第一次打开日志会出现有一定的时间的卡顿，这是正常现象
+
+打开日志会一次性打开服务端日志和客户端日志，服务端日志会直接链接这个山头实例
+
+但是客户端日志则需要开发者自行连接到手机端  
+
+连接手机端的方式可以查阅 [使用调试工具进行手机和电脑端调试](1-使用调试工具进行手机和电脑端调试.md)
+
+![](./images/img_5.png)
+
+## 成员管理
+
+为了保证数据安全，成员管理请在MC Studio进行
+
+![](./images/img_6.png)
+
+您可以直接在这个页面输入对方的UID进行添加，添加以后点击确定即可
+
+备注： 每次添加UID，只能一个一个的添加， 也就是输入UID以后点添加，就直接点击确认，不能一次性添加两个人及以上。这是为了防止恶意通过此入口来对山头服服务端进行多次请求
+
+添加以后，开发者在审核服山头页面就会收到邀请，点击同意即可加入
+
+![](./images/img_7.png)
+
+如果对方没有同意，下一次再打开成员管理页面，仍然不会显示那名玩家的名称和UID，你不必重新添加
+
+## 山头服自动回收
+
+为了避免资源的浪费，每位开发者测试完毕后，应该主动在MCS删除实例，恶意占用资源的我们会严肃处理
+
+当山头服 30 分钟内没有任何人时，山头服会自动进行回收，下次重新购买山腰档的山头服即可
+
+
+

mcguide/32-开发者账号与团队/课程15-使用成员管理模块实现多账号协作.md

@@ -23,15 +23,15 @@ selection: true
 - 设为核心成员：在游戏的开发者主页中显示为核心成员。
 - 测试版启动器登录权限：设置成员是否可以使用手机版测试工具。开发者有内容通过审核后，最多可以设置10个子账号登录手机版测试启动器。未曾有过过审内容者，最多只能设置2个名额。 **注意：未经过实名认证的开发者主账号无法使用手机版测试启动器。**
 - 协作开发权限设置：可以登录我的世界开发者工作台看到主账号的云端组件、网络服等，也可以通过手机测试段与主账号联机测试。若开发者有网络游戏作品，还可以对成员额外设置是否在 **【开发阶段允许配置、部署与热更】** 、 **【上线阶段允许控制台调试】** 等功能。
-  - 开发阶段允许配置、部署与热更：允许成员使用我的世界基岩版网络游戏开服工具对主账号的开发中服务器进行配置、部署与热更。有关网络游戏开服工具的配置、部署与热更功能，[详细教程可查看此处](../27-网络游戏/课程2：Apollo基础知识/第4节：部署.html#部署)。
-  - 上线阶段允许控制台调试：允许成员使用我的世界基岩版网络游戏开服工具对主账号的上线阶段服务器进行控制台调试。有关网络游戏开服工具控制台调试功能，[详细教程可查看此处](../27-网络游戏/课程7：开发技巧/第3节：控制台调试.html)。
+  - 开发阶段允许配置、部署与热更：允许成员使用我的世界基岩版网络游戏开服工具对主账号的开发中服务器进行配置、部署与热更。有关网络游戏开服工具的配置、部署与热更功能，[详细教程可查看此处](../27-手机网络游戏/课程2：Apollo基础知识/第4节：部署.html#部署)。
+  - 上线阶段允许控制台调试：允许成员使用我的世界基岩版网络游戏开服工具对主账号的上线阶段服务器进行控制台调试。有关网络游戏开服工具控制台调试功能，[详细教程可查看此处](../27-手机网络游戏/课程7：开发技巧/第3节：控制台调试.html)。
 
 ![63](./images/15_3.jpg)
 
 成员管理模块不仅仅用于管理团队，对于开发也起着很重要的作用：
 
 - 联机测试：可使用我的世界基岩版手机版开发启动器在外网网域下远程联机作品，<a href="../../mconline/10-addon教程/第18章：打包导出你的作品/课程03.在手机和电脑上测试你的作品.html#使用开发者子母账号在手机测试端上联机" rel="noopenner">详细教程可查看</a>；
-- 多账号协作：可在网络游戏开服工具下实现多账号协作，[详细教程可查看此处](../27-网络游戏/课程1：成为Apollo服主及相关准备/第7节：McStudio多账号协作.md)；
+- 多账号协作：可在网络游戏开服工具下实现多账号协作，[详细教程可查看此处](../27-手机网络游戏/课程1：成为Apollo服主及相关准备/第7节：McStudio多账号协作.md)；