2.6

docs/mconline/30-网络服插件教程/3-插件知识进阶/3-插件文件夹结构.md

@@ -0,0 +1,106 @@
+# 插件文件夹结构
+
+基于之前的了解，插件一共有4种类型，分别是lobbyMod、gameMod、serviceMod、masterMod。
+
+它们的文件夹结构不完全相同，本节将会就文件夹的内容和功能进行介绍。
+
+## lobbyMod/gameMod
+
+```
+xxxMod
+	developer_mods  ——服务器mod，不会被传输到客户端
+		xxxModDev  ——服务器mod根目录
+	    	mod.json  ——插件的配置文件和基本信息
+	    	netease_require.json  ——插件所用的依赖(可缺省)
+			scripts  ——服务端脚本
+	behavior_packs
+		xxxModBeh  ——客户端mod根目录
+			scripts  ——客户端脚本
+			manifest.json  ——资源版本信息
+	resource_packs
+		xxxModRes  ——资源根目录
+			manifest.json  ——资源版本信息
+			ui  —— ui文件
+			...  ——其他资源文件
+	worlds
+		level
+			db
+			level.dat  ——地图全局数据
+			levelname.txt  ——地图名
+			world_behavior_packs.json  ——配置客户端需要下载的behavior mods
+			world_resource_packs.json  ——配置客户端需要下载的resource mods
+	mod.sql  ——数据表创建的SQL语句(可缺省)
+	readme.txt  ——插件介绍
+```
+
+developer_mods和behavior_packs区别：
+
+- developer_mods控制服务端行为，behavior_packs控制客户端行为。
+- behavior_packs会下载给客户端，developer_mods不会。
+- developer_mods可以使用Apollo SDK全部接口和MOD SDK中服务端相关接口，behavior_packs使用MOD SDK中客户端相关接口。
+- behavior_packs必须包含manifest.json文件，且需要在地图目录下world_behavior_packs.json文件中配置pack id和version。
+
+world_behavior_packs.json和world_resource_packs.json文件可以不需要自己配置，使用MCS部署插件时，如果文件不合法，将会自动进行修复。
+
+### neteaseDaily举例
+
+```
+neteaseDaily
+	developer_mods  ——服务器mod，不会被传输到客户端
+		neteaseDailyDev  ——服务器mod根目录
+	    	mod.json  ——插件的配置文件和基本信息
+			neteaseDailyScript  ——服务端脚本根目录
+	behavior_packs
+		neteaseDailyBehavior  ——客户端mod根目录
+			neteaseDailyScript  ——客户端脚本根目录
+	resource_packs
+		neteaseDailyRes
+			manifest.json  ——资源版本信息
+			ui  ——ui文件
+			textures  ——材质文件
+	worlds
+		level
+			world_behavior_packs.json  ——配置客户端需要下载的behavior mods
+			world_resource_packs.json  ——配置客户端需要下载的resource mods
+	readme.txt  ——插件介绍
+```
+
+
+
+## serviceMod/masterMod
+
+```
+xxxMod
+	developer_mods  ——服务器mod
+		xxxModDev  ——服务器mod根目录
+	    	mod.json  ——插件的配置文件和基本信息
+	    	netease_require.json  ——插件所用的依赖(可缺省)
+			scripts  ——服务端脚本
+	mod.sql  ——数据表创建的SQL语句(可缺省)
+	readme.txt  ——插件介绍
+```
+
+serviceMod/masterMod和lobbyMod/gameMod相比，少了behavior_packs,resource_packs和worlds。该插件只能被运行在服务端上。
+
+### neteaseDailyService举例
+
+```
+neteaseDailyService
+	developer_mods  ——服务器mod，不会被传输到客户端
+		neteaseDailyDev  ——服务器mod根目录
+	    	mod.json  ——插件的配置文件和基本信息
+			neteaseDailyScript  ——服务端脚本
+	mod.sql  ——数据表创建的SQL语句
+	readme.txt  ——插件介绍
+```
+
+
+
+### 插件目录生成工具
+
+​		按照实际需求，插件由若干个服务器mod组成，可包含lobby/game（大厅/游戏）服mod、service（功能）服mod以及master（控制）服mod。
+
+​		各类服务器mod的目录结构，已在<a href="../../../mcguide/27-手机网络游戏/课程2：Apollo基础知识/第3节：服务器Mod.html" rel="noopenner"> 第3节：服务器Mod </a>中说明。
+
+​		开发者可下载[生成插件模板工具](https://g79.gdl.netease.com/template.zip)，在实际应用中快捷生成插件目录。
+