# 插件文件夹结构

基于之前的了解,插件一共有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的目录结构,已在 第3节:服务器Mod 中说明。

​ 开发者可下载生成插件模板工具 (opens new window),在实际应用中快捷生成插件目录。