魔兽世界插件开发 插件教程 插件编写 Table Of Contents TOC文件介绍
更多信息请：鸿石散人
TOC : Table Of Contents . 插件的清单文件。它包含了关于插件的特定信息，如名称，描述，存储，环境，插件文件的加载顺序。
TOC 文件必须存在，否则魔兽客户端不能识别。
TOC 文件名称必须和插件目录名称一致。
TOC 文件格式
TOC文件内容以行为执行单元以“#”开头的行： 注释行 加载时会被忽略以“##”开头的行：标记行 提供有关 AddOn 的元数据非# 和 ## 的行： 文件行 提供顺序加载的文件的名称每行最多读取前 1024 个字符。其他字符将被忽略，不会导致错误。文件行中的文件可使用相对路径，相对路径起始值是TOC文件的路径。文件行引用的是 Lua 文件和 XML 文件。LUA和XML文件的编写顺序也是加载的加载顺序，靠前的文件先加载。示例
#注释行，提供解释和说明## Interface: 20504fn.luafn.xmlfd.lua标签
Interface 接口号
指定插件的客户端接口版本。必须与客户端版本匹配，否则提示“加载过期插件”。
## Interface: 20504Title 标题
指定插件显示的名称。可以使用本地化依据客户端进行改变。同时 UI转义。
#如果不定义 直接使用插件名称进行显示#正常设置## Title: 空插件#国际化设置## Title-zhCN: 国际化空插件#文本UI转义改变颜色## Title:
cFFFF0000空
cFF00FF00插
cFF0000FF件
r
r
rNotes 描述
鼠标悬停于插件列表的项目上时，显示的插件描述。同TITLE 的设置内容相同。
#正常设置## Notes: 空插件#国际化设置## Notes-zhCN: 国际化空插件#文本UI转义改变颜色## Notes:
cFFFF0000空
cFF00FF00插
cFF0000FF件
r
r
rRequiredDeps 或者 "Dep"开头的
依赖插件，依赖插件加载成功才加载本插件，如果有一个依赖未加载本插件也不会加载，依赖的插件可以为多个并且以英文逗号为分隔。
#RequiredDeps## RequiredDeps: EmAddOns,EmpAddOns#Dep...开头的任何名字#Dep 代表 Depencies## DepEmap: EmAddOnsOptionalDeps
可选依赖插件，在本插件之前加载，没有加载的情况下本插件也能正常运行。写法同依赖插件一样
## OptionalDeps : EmAddOnsLoadOnDemand
延时加载、动态加载、按需加载，命令加载都可以叫。如果为0则表示直接加载。
如果为1，用户首次登陆时不加载本插件，但是登陆后可由其他插件加载。默认为0直接加载。
## LoadOnDemand: 1LoadWith
值为插件名称列表，以逗号分割， 当LoadOnDemand=1时列表中的任意一个插件加载完成之后，本插件也会进行加载。
## LoadWith: EmAddOns,Em1AddOnsLoadManagers
值为插件名称列表，以逗号分割。配置的插件都不存在，用户第一次登陆时会加载本插件。如果有一个存在，那么本插件将按照LoadOnDemand设置为1的情况处理。
## LoadWith: EmAddOns,Em1AddOnsSavedVariables
以逗号分割的变量名称列表，变量的值对同一战网账户是通用的。在ADDON_LOADED事件触发之前不可用。
#存储路径：安装目录\_classic_\WTF\Account\战网名称\SavedVariables## SavedVariables: emptyGVarSavedVariablesPerCharacter
类似SavedVariables，以每个角色保存各自的变量值，也就是说SavedVariables适合保存通用配置，SavedVariablesPerCharacter适合保存个人配置。
#存储路径:安装目录\_classic_\WTF\Account\战网名称\服务器\角色\SavedVariables## SavedVariablesPerCharacter: emptyLVarDefaultState
插件首次安装默认是否开启，如果设置成 “disabled”，那么只有在插件列表中勾选本插件后，才会被加载。默认值 “enabled”。
World of Warcraft\_classic_\WTF\Account\战网账号\服务器\角色名\AddOns.txt
这个文件会保存手动操作插件列表后的状态，如果有值就会忽略DefaultState的配置
## DefaultState: enabledSecure
如果此标签的值为 1，并且插件由暴雪进行了数字签名，其代码被认为是安全的。
Author
作者名字
Version
插件自身的版本号
元数据标签
插件允许在TOC 文件里增加带有“X-”前缀的元数据。他可以在查询运行时（通过 GetAddOnMetadata 函数）得到
##X-x : 1##X-y : 10##X-itme : itemy = GetAddOnMetadata("EmptyAddOns","X-y")print(y)#魔兽世界# #魔兽世界插件# #魔兽世界插件开发#
