Mod语法
 |
Rusted Wiki欢迎您参与完善本条目 |
.ini文件
纯文本文件。游戏通过读取以.ini为扩展名的文件来获取具体单位的属性。内容组成方面，由节(section)、键(key)、注释(comment)三个部分组成：
节(section)
包含用两个半角英文方括号包围的节的名称([section])，单独占一行。用于声明相关的键从属于该节。其后的行直到另一个节前一行的键均归属于该节。名称不同的节视为不同类型的节。
节的类型：
[core] [canBuild_NAME] [graphics] [attack] [turret_NAME] [projectile_NAME] [movement] [ai] [leg_#] [arm_#] [attachment_NAME] [action_NAME] [hiddenAction_NAME] [effect_NAME] [animation_NAME] [placementRule_NAME] [global_resource_NAME] [resource_NAME] [template_NAME] [comment_NAME] [decal_NAME]
属性(property)
在 Rusted Warfare 中，属性包含一组键值对。键(key)的名称与其对应的值(value)用半角冒号或等号隔开，单独占一行。用于规定单位的具体属性。名称不同的键视为不同类型的键，名称相同的键从属于不同类型的节视为不同类型的键。值的类型不同填写的内容和格式会有不同。
注释
注释即为对代码的解释和说明。清晰的注释有利于帮助理解代码的含义。铁锈战争的.ini文件语法在注释方面提供了三种方式：
(1)用#进行单行的注释
在行的开头加上符号#后，游戏程序会忽略这一行的内容，不将其作为代码解析。但编写这些的人类可以注意到这些。
[projectile_1] #directDamage: 20 #经由反馈，伤害应该提高至30 directDamage: 30 …
(2)用"""和"""的组合进行多行注释
在行头使用"""作为起始，在之后的行尾使用"""作为结束。在其之间的内容均会被游戏忽略。注意：三个引号的组合还被游戏用于忽略 值 的换行符，有可能两个功能发生冲突。
""" 这是三个英文引号 实际上这个组合还有个功能，就是用它引住key: VALUE的value，使value允许换行输入如： builtFrom_1_name: airFactory 可以是 builtFrom_1_name: """airF actory""" 可是有一种情况，你用多行注释注释掉了有换行输入的内容它显然就会混乱，也就是目前的情况 """
(3)用[comment_NAME]进行成节的注释
该节之后的行直到下一个节前一行均不会被加载。
[comment_hiddenAction_1] autoTriggerOnEvent: created addGlobalTeamTags: 计时 [comment_1] maxHp: 2000 [core] #[comment_NAME]节下的东西是不会被加载的，去引用它会提示找不到任何key @copyFromSection: comment_1 …
mod-info.txt文件
纯文本文件。游戏通过在mod文件夹的根目录读取mod-info.txt这样命名的文件来获得mod作者提供的mod描述信息。
相关参数解释：
#(必填) [mod] #(选填)告诉游戏能够支持该mod运行的最低游戏版本。若不满足要求的最低版本，提示后仍可加载，但除地图外不可用，同时不提供代码错误的报错提醒。注意：在mod使用1.15p9及以上版本的代码(如decal节)时，游戏会强制要求填写 "minVersion: v1.15p9" minVersion: v1.15p7 #(必填)该mod在游戏中显示的标题 title: Mega Builders #(选填)该mod在游戏中显示的描述。使用"\n"使其在游戏中换行显示（pc版并不会换行显示） description: Example mod which replaces builders with Mega Builders. #(选填)在游戏中播放mod里的.ogg或.wav音频文件作为背景音乐 [music] #填音乐文件夹的路径 sourceFolder: soundtrack #当使用该mod的单位时播放该mod的音乐，填"true"或"false" whenUsingUnitsFromThisMod_playExclusively: true #加入音乐播放列表，填"true"或"false" addToNormalPlaylist: false #该文件支持单行注释 """和 多行 注释"""
all-units.template文件
纯文本文件。游戏程序会识别all-units.template这样命名的文件，将其内容自动应用到同级及以下级的所有.ini文件中(效果与使用core节下的copyFrom一致)。若存在代码错误，报错不会指向其本身，而是其所应用的.ini文件。
下级的all-units.template会替换上级的all-units.template