Mod语法：修订间差异

来自RustedWarfare Wiki
添加的内容 删除的内容
可视化wikitext
无编辑摘要
标签：移动版编辑 移动版网页编辑 高级移动版编辑
 
（未显示2个用户的25个中间版本）
第1行： 第1行：
{{欢迎编辑}}
{{欢迎编辑}}
== .ini文件 ==
== .ini文件 ==
纯文本文件。游戏通过读取以<code>.ini</code>为扩展名的文件来获取具体[[单位]]的属性。内容组成方面，由节(section)、键(key)、注释(comment)三个部分组成：
UTF-8纯文本文件。游戏通过读取以<code>.ini</code>为扩展名的文件来获得某个单位的参数信息。其内容主要由节(Section)和参数(Parameter)两部分组成。
=== 节(section) ===
=== 格式 ===
<pre style="white-space:pre;overflow:auto;margin:0;padding:0;width:100%;">
包含用两个半角英文方括号包围的节的名称([section])，单独占一行。用于声明相关的键从属于该节。其后的行直到另一个节前一行的键均归属于该节。名称不同的节视为不同类型的节。
#节由两个半角方括号包裹，单独占一行
[section]
#参数由它的名称和它的值构成，名称和值使用半角冒号分隔，通常单独占一行
name: value
</pre>
<p style="font-size:12px;color:#888;margin-top:0px;"><nowiki>*</nowiki>另有部分代码存在不同的书写格式，待到具体代码再作讲解。</p>


参数从属于节，要想具体参数从属于具体节，需将节写在参数行的上方；不同参数的值有不同类型，且规定有取值区间。
节的类型：
=== 节的类型 ===
<pre style="white-space:pre;overflow:auto;">
截至<u>1.15</u>版本，节的类型有：
[core]
<pre style="white-space:pre;overflow:auto;margin:0;padding:0;width:100%;">
[canBuild_NAME]
[core]--基础节，涉及单位的名称、生命值、体积大小、是建筑与否等基本设置。
[graphics]
[canBuild_NAME]--可建造节，涉及单位能建造生产那些单位，建造方式和条件等设置。
[attack]
[graphics]--图像节，涉及单位主体贴图等设置。
[turret_NAME]
[attack]--攻击节，涉及单位能攻击与否、最大攻击范围等设置。
[projectile_NAME]
[turret_NAME]--炮塔节，涉及单位炮塔的贴图、旋转速度、攻击间隔等设置。
[movement]
[projectile_NAME]--炮弹节，涉及单位炮塔发射的弹丸的贴图、寿命、飞行速度、伤害等设置。
[ai]
[movement]--移动节，涉及单位的移动类型、速度、转向速度等设置。
[leg_#]
[ai]--AI节，涉及AI玩家对该单位的建造、升级概率以及部分单位特性等设置。
[arm_#]
[arm_#]--臂节，涉及单位臂装饰物的位置、贴图等设置。
[attachment_NAME]
[leg_#]--腿节，同上。
[action_NAME]
[attachment_NAME]--附属节，涉及单位的子附属单位的位置、能攻击与否等设置。
[hiddenAction_NAME]
[action_NAME]--操作节，涉及单位的资源手动添加、手动升级按钮、添加路径点等设置。
[effect_NAME]
[hiddenAction_NAME]--隐藏的操作节，同上。
[animation_NAME]
[effect_NAME]--特效节，涉及单位炮塔开火，弹丸飞行、爆炸等生成的特效的设置。
[placementRule_NAME]
[animation_NAME]--动画节，涉及单位移动、部署、攻击等时机播放的帧动画的设置。
[global_resource_NAME]
[placementRule_NAME]--放置规则节，单位建造时放置的规则的设置。
[resource_NAME]
[global_resource_NAME]--全局资源节，队伍内单位通用的自定义资源的名称、样式设置。
[template_NAME]
[resource_NAME]--资源节，具体单位自用的自定义资源的名称样式设置
[comment_NAME]
[template_NAME]--模板节，节之间复制参数时选用。
[comment_NAME]--注释节，用于大篇幅注释。
[decal_NAME]--贴花节，单位身上的贴花、伪3D等设置。
</pre>
</pre>
部分节可以自行添加名称或序号，如上面的"NAME"要求填写名称，"#"要求填写序号(1-20)，这样得到的同类型不同名称的节，在应用时是各自独立的；允许重复书写一个节使其分布在文档的不同位置。
=== 属性(property) ===
在 Rusted Warfare 中，属性包含一组键值对。键(key)的名称与其对应的值(value)用半角冒号隔开，单独占一行。用于规定单位的具体属性。名称不同的键视为不同类型的键，名称相同的键从属于不同类型的节视为不同类型的键。值的类型不同填写的内容和格式会有不同。


=== 注释 ===
=== 参数的类型 ===
参数是文档中真正起作用的部分，每行参数必然关联者一个功能；参数（行）必须跟随在某个节的后面,以从属该节；节会因缺少必要参数而报错；部分参数有默认值，即使不写出也会起作用。<br />
注释即为对代码的解释和说明。清晰的注释有利于帮助理解代码的含义。铁锈战争的<code>.ini</code>文件语法在注释方面提供了三种方式：
有关具体参数的参考请移步至[[mod参数]]。


=== 书写建议 ===
(1)用<code>#</code>进行单行的注释
规范书写是为了方便阅读，在你使用眼睛查找某个参数时心中越多的筛选条件你找的就会越快，而我们直觉上会对写过的代码进行功能上的归类，所以你节之间插入两个以上的空行，几行参数组合形成的功能块你也可以在它们上下各空一行与其他参数进行分隔；而参数名称和值之间只有冒号未免拥挤，你可以在冒号后加入一个空格。


在行的开头加上符号<code>#</code>后，游戏程序会忽略这一行的内容，不将其作为代码解析。但编写这些的人类可以注意到这些。
<pre style="white-space:pre;overflow:auto;">
[projectile_1]
#directDamage: 20
#有人反映单发伤害太低，这里改成了30
directDamage: 30
…
</pre>
(2)用<code>"""</code>和<code>"""</code>的组合进行多行注释

在行头使用<code>"""</code>作为起始，在之后的行尾使用<code>"""</code>作为结束。在其之间的内容均会被游戏忽略。
<pre style="white-space:pre;overflow:auto;">
"""
这是三个英文引号
实际上这个组合还有个功能，就是用它引住key: value的value使value可以换行输入如：
builtFrom_1_name: airFactory
可以是
builtFrom_1_name: """airF
actory"""
可是有一种情况，你用多行注释注释掉了有换行输入的内容它显然就会混乱，也就是目前的情况
"""
</pre>
(3)用<code>[comment_NAME]</code>进行成节的注释

该节之后的行直到下一个节前一行均不会被加载。
<pre style="white-space:pre;overflow:auto;">
[comment_hiddenAction_1]
autoTriggerOnEvent: created
addGlobalTeamTags: 计时
[comment_1]
maxHp: 2000
[core]
#[comment_NAME]节下的东西是不会被加载的，去引用它会提示找不到任何key
@copyFromSection: comment_1
…
</pre>
== mod-info.txt文件 ==
== mod-info.txt文件 ==
纯文本文件。游戏通过在mod文件夹根目录读取<code>mod-info.txt</code>这样命名的文件来获得mod作者提供的mod描述信息。
UTF-8纯文本文件。游戏通过读取位于mod文件夹根目录下<code>mod-info.txt</code>这样命名的文件来获得由mod作者提供的mod的描述信息。


格式：
相关参数解释：
<pre style="white-space:pre;overflow:auto;">
<pre style="white-space:pre;overflow:auto;margin:0;padding:0;width:100%;">
#(必填)
[mod]
[mod]
#(选填)告诉游戏能够支持该mod运行的最低游戏版本。若不满足最低版本，提示后仍可加载，但除地图外不可用，同时不提供代码错误的报错提醒。
#告诉游戏能够支持该mod运行的最低游戏版本。若不满足要求的最低版本，提示后仍可加载，但除地图外不可用，同时不提供代码错误的报错提醒。
minVersion: v1.14
minVersion: 1.15p7
#(必填)该mod在游戏中显示的标题。
#该mod在游戏中显示的标题
title: Mega Builders
title: Mega Builders
#(选填)该mod在游戏中显示的描述。使用"\n"使其在游戏中换行显示（pc版并不会换行显示）。
#该mod在游戏中显示的描述。使用"\n"使其在显示时换行（pc版尚不能换行显示）
description: Example mod which replaces builders with Mega Builders.
description: Example mod which replaces builders with Mega Builders.


#(选填，在游戏中播放mod中的.ogg文件作为背景音乐)#关于.ogg文件的说明仍待补充
#在游戏中播放mod里的.ogg或.wav音频文件作为背景音乐
[music]
[music]
#填音乐文件夹路径。
#填音乐文件夹的路径
sourceFolder: soundtrack
sourceFolder: soundtrack
#当使用该mod的单位时仅播放该mod的音乐，填"true"或"false"。
#当使用该mod的单位时特别播放该mod的音乐，填"true"或"false"
whenUsingUnitsFromThisMod_playExclusively: true
whenUsingUnitsFromThisMod_playExclusively: true
#加入音乐播放列表，填"true"或"false"
addToNormalPlaylist: false


#该文件支持单行注释
#该文件支持单行注释
"""和
"""
和
多行
多行
注释"""
注释
"""
</pre>
</pre>

== all-units.template文件 ==
== all-units.template文件 ==
<code>all-units.template</code>也是INI格式的文件。文件中的代码会自动应用到模组内的所有单位中(效果与使用<code>core</code>节下的<code>copyFrom</code>一致)到同级及以下级文件夹的所有<code>.ini</code>文件中。若存在代码错误，报错不会指向其本身，而是其所应用的<code>.ini</code>文件。
UTF-8纯文本文件。内容格式与<code>.ini</code>文件一致。游戏程序会识别<code>all-units.template</code>这样命名的文件，将其内容自动应用到同级及以下级的所有<code>.ini</code>文件中(效果与使用<code>core</code>节下的<code>copyFrom</code>一致)。若存在代码错误，报错不会指向其本身，而是其所应用的<code>.ini</code>文件。另外，若两文件同一参数的值存在冲突，下级的<code>all-units.template</code>会覆盖上级的<code>all-units.template</code>。

2023年8月5日 (六) 15:39的最新版本

Rusted Wiki欢迎您参与完善本条目
欢迎正在阅读这个条目的您协助编辑本条目。编辑前请阅读Wiki入门，并查找相关资料。
Rusted Wiki祝您在本站度过愉快的时光。

.ini文件

UTF-8纯文本文件。游戏通过读取以.ini为扩展名的文件来获得某个单位的参数信息。其内容主要由节(Section)和参数(Parameter)两部分组成。

格式

#节由两个半角方括号包裹，单独占一行
[section]
#参数由它的名称和它的值构成，名称和值使用半角冒号分隔，通常单独占一行
name: value

*另有部分代码存在不同的书写格式，待到具体代码再作讲解。

参数从属于节，要想具体参数从属于具体节，需将节写在参数行的上方；不同参数的值有不同类型，且规定有取值区间。

节的类型

截至1.15版本，节的类型有： 

[core]--基础节，涉及单位的名称、生命值、体积大小、是建筑与否等基本设置。
[canBuild_NAME]--可建造节，涉及单位能建造生产那些单位，建造方式和条件等设置。
[graphics]--图像节，涉及单位主体贴图等设置。
[attack]--攻击节，涉及单位能攻击与否、最大攻击范围等设置。
[turret_NAME]--炮塔节，涉及单位炮塔的贴图、旋转速度、攻击间隔等设置。
[projectile_NAME]--炮弹节，涉及单位炮塔发射的弹丸的贴图、寿命、飞行速度、伤害等设置。
[movement]--移动节，涉及单位的移动类型、速度、转向速度等设置。
[ai]--AI节，涉及AI玩家对该单位的建造、升级概率以及部分单位特性等设置。
[arm_#]--臂节，涉及单位臂装饰物的位置、贴图等设置。
[leg_#]--腿节，同上。
[attachment_NAME]--附属节，涉及单位的子附属单位的位置、能攻击与否等设置。
[action_NAME]--操作节，涉及单位的资源手动添加、手动升级按钮、添加路径点等设置。
[hiddenAction_NAME]--隐藏的操作节，同上。
[effect_NAME]--特效节，涉及单位炮塔开火，弹丸飞行、爆炸等生成的特效的设置。
[animation_NAME]--动画节，涉及单位移动、部署、攻击等时机播放的帧动画的设置。
[placementRule_NAME]--放置规则节，单位建造时放置的规则的设置。
[global_resource_NAME]--全局资源节，队伍内单位通用的自定义资源的名称、样式设置。
[resource_NAME]--资源节，具体单位自用的自定义资源的名称样式设置
[template_NAME]--模板节，节之间复制参数时选用。
[comment_NAME]--注释节，用于大篇幅注释。
[decal_NAME]--贴花节，单位身上的贴花、伪3D等设置。

部分节可以自行添加名称或序号，如上面的"NAME"要求填写名称，"#"要求填写序号(1-20)，这样得到的同类型不同名称的节，在应用时是各自独立的；允许重复书写一个节使其分布在文档的不同位置。

参数的类型

参数是文档中真正起作用的部分，每行参数必然关联者一个功能；参数（行）必须跟随在某个节的后面,以从属该节；节会因缺少必要参数而报错；部分参数有默认值，即使不写出也会起作用。
有关具体参数的参考请移步至mod参数。

书写建议

规范书写是为了方便阅读，在你使用眼睛查找某个参数时心中越多的筛选条件你找的就会越快，而我们直觉上会对写过的代码进行功能上的归类，所以你节之间插入两个以上的空行，几行参数组合形成的功能块你也可以在它们上下各空一行与其他参数进行分隔；而参数名称和值之间只有冒号未免拥挤，你可以在冒号后加入一个空格。

mod-info.txt文件

UTF-8纯文本文件。游戏通过读取位于mod文件夹根目录下mod-info.txt这样命名的文件来获得由mod作者提供的mod的描述信息。

格式： 

[mod]
#告诉游戏能够支持该mod运行的最低游戏版本。若不满足要求的最低版本，提示后仍可加载，但除地图外不可用，同时不提供代码错误的报错提醒。
minVersion: 1.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文件

UTF-8纯文本文件。内容格式与.ini文件一致。游戏程序会识别all-units.template这样命名的文件，将其内容自动应用到同级及以下级的所有.ini文件中(效果与使用core节下的copyFrom一致)。若存在代码错误，报错不会指向其本身，而是其所应用的.ini文件。另外，若两文件同一参数的值存在冲突，下级的all-units.template会覆盖上级的all-units.template。

取自“https://rustedwarfare.org/index.php?title=Mod语法&oldid=2837”