|
本页面指导mod制作初学者制作游戏中的单位。
== 创建单位 ==
先请按步骤将这个名为“hello”的单位加入到游戏中。
1.打开游戏的mod文件路径，rustedWarfare/units或Rusted Warfare\mods\units。<br>
2.创建一个名为hello的文件夹。<br>
3.在hello文件夹中创建一个名为hello.ini的文件。<br>
4.用文本编辑器打开hello.ini文件。<br>
5.复制以下代码到文本编辑器中。
<pre>
[core]
name:hello
radius: 10
mass: 3000
maxHp: 800
price: 1000
[graphics]
image: SHARED:light_50.png
==== 单位的界定 ====
[attack]
游戏中，具有名称、生命值、半径、重量的单元。
canAttack: false
==== 游戏存储单位属性的方式 ====
[movement]
游戏使用传统意义上的.ini配置文件格式存储单位的属性信息。<br>
movementType: LAND
包含的.ini文件的特征：UTF-8文本文件、小节(Section)、键值对(Key-value)。
</pre>
6.启动游戏，在主界面点击mods(或模组)进入mod管理界面。<br>
7.勾选名为hello的项，点击Reload(或重新加载)按钮，完成后点击Save(或保存),回到主界面。<br>
8.点击单人游戏-沙盒模式-开始，进入沙盒模式的对局。<br>
9.通过侧边栏找到hello单位并放置在战场上。<br>
10.试着选中这个单位，并下达移动指令，观察单位是否会进行转向和移动。<br>
11.到这里你便成功在游戏中创建了一个新的单位。<br>
经过以上体验，我可以带点全知视角地帮你总结创建单位的思路：
*在放置mod的文件路径下创建新单位的文件夹。
*为这个单位写一个ini文件，这个文件将包含这个单位的所有属性信息。
*将单位加载进游戏中，选择沙盒模式进行调试。
这里关键环节是在ini文件中填入有效的属性信息。
==== 游戏如何将单位配置文件信息加载到游戏中 ====
具体地，单位是一堆参数的集合，你要做的是为每个属性填写具体的值。比如单位的名称是什么你要填写“单位的名称是‘重型坦克’”，单位的生命值是多少，你要填写“单位是生命值是‘600’”，只不过现实情况是你需要将这些信息格式化地记录在ini文件中，其变成“name: 重型坦克”“maxHp: 600”,这里游戏给出的书写规则是maxHp表示单位的生命值上限，你需要遵从这些规则。此外游戏规定ini里的每个属性代码需要从属于某个节，即表现为：
先将单位.ini文件置于指定目录，然后通过游戏内的mod管理界面对mod文件进行扫描和加载。
<pre>
[turret_2]
image:
[projectile_1]
image:
</pre>
这里节“turret_2”的“image”属性实际意义是炮塔2的贴图，节“projectile_1”的“image”属性的实际意义是炮弹1的贴图，两个“image”如果没有写在各自的节下面它是表达不出“这个贴图是谁的”这层意思的。
==== 单位中可用的属性API及配置文件语法在哪里 ====
这些属性和从属于哪个节官方文档（我们习惯称为代码表）都有给出。你应该大致读几遍代码表，了解每个代码什么功能，熟悉后，你就可以独自读ini文件增删单位的属性了。
见：[https://docs.google.com/spreadsheets/d/1aeP3pUic0IutZlgGix_cM8xR7LEH44gS4itAxETK954 Google 文档]<br>
上面表格文档记录了大多数属性API关键字和功能描述。但具体代码细节未能详尽，需要mod制作者留心在游戏中测试和记录。<br>
单位配置文件具有特殊语法，本文会在后面篇章进行介绍。
== 调试单位 ==
看了前面的理论，你可能完全无感，接下来我会引导你改进一下最开始的单位，来充实细节。
==== 单位的存在机制 ====
我们先来注释每行代码的作用。
<b>地图</b><br>
<pre>
单位活动在地图之上，
#在行首使用#使该行内容不会被游戏读取为有效内容
[core]
#单位的真名
name:hello
#单位的碰撞半径
radius: 10
#单位的重量
mass: 3000
#单位的生命值上限
maxHp: 800
#单位的造价
price: 1000
[graphics]
#单位的主体图像，这样的写的值表示使用游戏自带的shared文件夹里light_50.png文件作为单位主体贴图
image: SHARED:light_50.png
[attack]
#单位是否可攻击，false表示否，true表示是
canAttack: false
[movement]
#移动类型，陆地，这个移动类型的单位只能在无属性地块上移动，不能到达在水上岩浆上陡崖上
movementType: LAND
</pre>
我们观察到这个单位移动时转向过慢，移动过于僵硬，请在movement节下做如下修改（可以不抄注释）：
<pre>
[movement]
movementType: LAND
#设置了单位的移动速度为1
moveSpeed: 1
#下面两个分别是单位开始移动时的加速幅度和结束移动时的减速幅度，这样让其移动显得自然
moveAccelerationSpeed: 0.05
moveDecelerationSpeed: 0.05
#把转向速度设置成一个极端的值，让它看起来没有转向的过程
maxTurnSpeed: 360
#这是转向的加速度，设置成0也是为了让它看起来没有转向过程
turnAcceleration: 0
</pre>
ctrl + s保存修改后，直接在沙盒模式的操作栏点击重新加载按钮来改变游戏中的单位属性。（后面不再提示）
现在单位移动不那么卡顿了。接下来我们把单位想象成一个可以远程发射光球的进攻性兵种。根据以下代码在对应的节下修改。（后面不再提示）
<pre>
[attack]
#由不可攻击改成可以攻击
canAttack: true
#可对地
canAttackLandUnits: true
#可对空
canAttackFlyingUnits: true
#可反潜
canAttackUnderwaterUnits: false
#最大攻击范围
maxAttackRange: 210
[turret_1]
#炮塔的相对位置
x: 0
y: 0
#炮塔的贴图，用了透明的贴图替代
image: SHARED:blank.png
#炮塔旋转速度，我想让它很快
turnSpeed: 360
turnSpeedAcceleration: 0
#炮塔发射那种炮弹
projectile: 1
#炮弹出现的位置
size: 0
#发射间隔，这里是1秒
delay: 60
[projectile_1]
#炮弹的贴图
image: SHARED:beam1_start.png
#炮弹的最大存在时长，这里是4秒
life: 240
#炮弹的飞行速度
speed: 3
#炮弹的伤害
directDamage: 10
</pre>
现在单位具有对空对地的攻击能力了。再增加一些修饰性特效。
<pre>
</pre>
=== 重新加载单位 ===
通常情况下，每次进入铁锈时，模组会被自动加载。单击主界面中“模组”按钮后，找到“重载数据”按钮，单击即可重新加载模组数据。
如果你正在沙盒中进行模组调试，在actions、all和modded中可以找到“Reload units”，单击此按钮铁锈将会重新加载所有单位。如果你只是更改了单位的数据，也可以在modded中单击“Quick Reload”，此时铁锈会以很快的速度重新加载单位。
=== Debug按钮 ===
在沙盒的actions中，有一个“Debug”选项，默认为关闭，打开此选项后，单击任意单位的血量都会看到“--Debug--”字样和当前单位的信息。
{{折叠|Debug可以显示的信息|* 单位name
* 单位id
* x
* y
* 高度
* 角度
* 图层
* 自定义资源
* 自定义内存(memory数组中的值不能显示)
* 自定义目标(customTarget1)}}
如果你的单位使用了自动触发（AutoTrigger），在打开“Debug”选项后，还可以打开“Trigger Debug”选项，打开此选项后，选中任意单位将能够看到它们的自动触发，并且能够看到自动触发中单个条件的值。<references />
== 相关链接 ==
[[mod的坑]]
|