LUACN论坛

 找回密码
 加入我们

QQ登录

只需一步,快速开始

搜索
热搜: YJWOW MagicStone BoL
查看: 158|回复: 2

[教程] 魔兽世界插件开发-Table Of Contents(TOC)文件

[复制链接]
发表于 2023-9-30 14:16:44 | 显示全部楼层 |阅读模式
Table Of Contents
        Table Of Contents.TOC文件插件的清单文件。它包含了关于插件的特定信息,如名称,描述,存储,环境,插件文件的加载顺序。

        TOC 文件必须存在,否则魔兽客户端不能识别。

        TOC 文件名称必须和插件目录名称一致。

TOC 文件格式
TOC文件内容以行为执行单元
以“#”开头的行: 注释行 加载时会被忽略
以“##”开头的行:标记行 提供有关 AddOn 的元数据
非# 和 ## 的行: 文件行 提供顺序加载的文件的名称
每行最多读取前 1024 个字符。其他字符将被忽略,不会导致错误。
文件行中的文件可使用相对路径,相对路径起始值是TOC文件的路径。
文件行引用的是 Lua 文件和 XML 文件。
LUA和XML文件的编写顺序也是加载的加载顺序,靠前的文件先加载。
示例

#注释行,提供解释和说明
## Interface: 20504
fn.lua
fn.xml
fd.lua
Table Of Contents标签
Interface 接口号
指定插件的客户端接口版本。必须与客户端版本匹配,否者提示“加载过期插件”。

## Interface: 20504
Title 标题
指定插件显示的名称。可以使用本地化依据客户端进行改变。同时支持 UI转义。

#如果不定义 直接使用插件名称进行显示
#正常设置
## Title: 空插件
#国际化设置
## Title-zhCN: 国际化空插件
#文本支持UI转义改变颜色
## Title: |cFFFF0000空|cFF00FF00插|cFF0000FF件|r|r|r
Notes 描述
        鼠标悬停于插件列表的项目上时,显示的插件描述。同TITLE 的设置内容相同。

#正常设置
## Notes: 空插件
#国际化设置
## Notes-zhCN: 国际化空插件
#文本支持UI转义改变颜色
## Notes: |cFFFF0000空|cFF00FF00插|cFF0000FF件|r|r|r
RequiredDeps 或者 "Dep"开头的
        依赖插件,依赖插件加载成功才加载本插件,如果有一个依赖未加载本插件也不会加载,依赖的插件可以为多个并且以英文逗号为分隔。

#RequiredDeps
## RequiredDeps: EmAddOns,EmpAddOns
#Dep...开头的任何名字
#Dep 代表 Dependencies
## DepEmap: EmAddOns
OptionalDeps
        可选依赖插件,在本插件之前加载,没有加载的情况下本插件也能正常运行。写法同依赖插件

## OptionalDeps : EmAddOns
LoadOnDemand
        延时加载、动态加载、按需加载,命令加载都可以叫。如果为0表示直接加载。

        如果为1,用户首次登陆时不加载本插件,但是登陆后可由其他插件加载。默认为0直接加载。

## LoadOnDemand: 1
LoadWith
        值为插件名称列表,以逗号分割, 当LoadOnDemand=1时列表中的任意一个插件加载完成之后,本插件也会进行加载。

## LoadWith: EmAddOns,Em1AddOns
LoadManagers
        值为插件名称列表,以逗号分割。配置的插件都不存在,用户第一次登陆时会加载本插件。如果有一个存在,那么本插件将按照LoadOnDemand设置为1的情况处理。

## LoadWith: EmAddOns,Em1AddOns
SavedVariables
        以逗号分割的变量名称列表,变量的值对同一战网账户是通用的。在ADDON_LOADED事件触发之前不可用。

#存储路径:安装目录\_classic_\WTF\Account\战网名称\SavedVariables
## SavedVariables: emptyGVar
SavedVariablesPerCharacter
        类似SavedVariables,以每个角色保存各自的变量值,也就是说SavedVariables适合保存通用配置,SavedVariablesPerCharacter适合保存个人配置。

#存储路径:安装目录\_classic_\WTF\Account\战网名称\服务器\角色\SavedVariables
## SavedVariablesPerCharacter: emptyLVar
DefaultState
        插件首次安装默认是否开启,如果设置成 “disabled”,那么只有在插件列表中勾选本插件后,才会被加载。默认值 “enabled”。

        World of Warcraft\_classic_\WTF\Account\战网账号\服务器\角色名\AddOns.txt

        这个文件会保存手动操作插件列表后的状态,如果有值就会忽略DefaultState的配置

## DefaultState: enabled
Secure
        如果此标签的值为 1,并且插件由暴雪进行了数字签名,则其代码被认为是安全的。

Author
        插件作者名字

Version
        插件自身的版本号

元数据标签
        插件允许在TOC 文件里增加带有“X-”前缀的元数据。他可以在查询运行时(通过 GetAddOnMetadata 函数)得到

##X-x : 1
##X-y : 10
##X-itme : item


y = GetAddOnMetadata("EmptyAddOns","X-y")
print(y)


回复

使用道具 举报

发表于 2023-9-30 17:55:01 | 显示全部楼层
夭寿啊,管理员都在灌水
回复 支持 反对

使用道具 举报

发表于 2024-1-4 23:48:13 | 显示全部楼层

夭寿啊,管理员都在灌水
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 加入我们

本版积分规则

小黑屋|手机版|Archiver|LUACN论坛

GMT+8, 2024-4-29 12:43 PM , Processed in 0.060829 second(s), 18 queries , Gzip On, Redis On.

Powered by Discuz! X3.4

© 2001-2017 Comsenz Inc.

快速回复 返回顶部 返回列表