前言和准备工作#

• 本文使用了 Markdown 标记语言来优化阅读体验，所以我们首先需要准备一个代码查看器（作者使用的是 HBuilderX，VSCode 可能需要手动下载 Markdown 插件），或者用电脑自带的记事本，但不推荐（因为修改过程需要一个方便查看代码的环境），安装代码查看器后就可以用它来打开这个介绍文件了，打开后可以看到带有 “#”（井号）标题的前方有折叠按键，单击即可折叠/展开，看完了就能折叠隐藏起来，非常方便阅读。还可以到我的个人网站在线观看哦（还在施工中）

红色警戒2（简称 RA2）、尤里的复仇（简称 YR），由于游戏源码未公开，在大家 DIY（修改游戏数据或自定义内容）的时候或多或少会遇到游戏引擎中的硬编码限制。因此，许多红警爱好者在基于 YR 1.001 版本的基础上，开发了新的扩展引擎平台，来修复或扩充原版引擎的功能，这极大丰富了 DIY 的自由度，例如：Aers、Phobos、Kratos等。但考虑到许多新人并没有接触过这些引擎，所以本次将不使用扩展引擎的功能进行介绍，以尽量贴合新人从 “0” 开始接触 DIY 的情景，但还是建议新人预装 Aers 和 Phobos 这两个引擎，可以改善游戏体验，例如提升原版引擎的启动速度。

内容讲解可能比较冗长或者啰嗦，但是讲得很细，新手推荐按顺序阅读，我会尽量用简单的方式介绍一些本人认为常见的 DIY 内容，从基础开始（不包含覆盖物、污染物等杂项和一些可能比较复杂，或者会运用到扩展引擎的内容）希望能给初次接触红警 DIY 的小伙伴提供便利~
如果你想使用 YR 版本进行 DIY，这里推荐大家在 DIY 前预先安装 Ares 和 Phobos 引擎（下载链接放在 README.md），然后使用该修复版本：Yrstandard-ini（安装前注意备份），安装完毕后，咱们就可以进入下面的章节了。这边要提醒一下 RA2 版本的 DIY 玩家，由于 YR 版本的官方内容和功能是最多且最新的（官方最新版为 YR 1.001），以及 YR 有更多的软件支持，例如对 YR 有针对性优化的地图编辑器，而最新版的地图编辑器已经不支持 RA2 了，所以我推荐使用 YR 进行 DIY，而不是 RA2，除非你需要 DIY 旧版引擎的内容（例如基于旧版引擎的 RA2，或使用旧版引擎的其他版本），并接受旧版引擎的缺陷。

第一章：rules(md).ini（规则配置文件）#

这是包含了游戏基础规则的ini配置文件，简称规则文件，一般红色警戒 2对应的是 rules.ini 配置文件，而尤里的复仇则对应 rulesmd.ini 这个文件，两个文件的内容不同，为方便讲解，以 rulesmd.ini 为准。下面我们需要逐步理解这些配置文件中一些常用名词。

首先，让我们打开规则文件：rulesmd.ini（规则配置文件）

打开搜索（按 Ctrl + F 进行搜索），搜索 [AEGIS]，这是神盾巡洋舰的注册名，为确保搜索到正确内容，注意要带上[]括号，你会看到这样的代码：

1
[AEGIS]
2
UIName=Name:AEGIS
3
Name=Aegis Cruiser
4
Prerequisite=GAYARD,RADAR
5
Primary=Medusa
6
......中间省略一大段......
7
;BuildLimit=2
8
ElitePrimary=MedusaE
9
Size=30
10
TooBigToFitUnderBridge=true

没错，这一部分就是神盾巡洋舰的单位本体（特指这部分的代码），还可以简称单位（泛指所有相关的代码）。而在 [AEGIS] 注册名下方的代码可以被称为语句，而标签涵盖范围广（个人理解），示意代码：

1
[AEGIS]     注册名/标签/代码
2
UIName=     语句/标签/代码
3
Name=       语句/标签/代码
4
......=     语句/标签/代码

可以说是某个标签，或者某个语句，甚至统称为代码也是没问题的，请依据个人习惯来决定。
仔细看看，还会发现有的语句或标签会带有 “;” 这个符号，这表示在这符号之后的一行代码将无效化，即成为注释，我们可以直接无视它们，例如控制单位建造数量的是这个语句：;BuildLimit=2，可以看到已经被注释了，所以不会有任何作用，忽略即可。我们也可以手动取消注释（把 “;” 这个符号删除），或把注释保留下来，另起一行，添加语句BuildLimit=，例如：

1
[AEGIS]
2
......省略一大段......
3
;BuildLimit=2  ←这是保留的注释，取消注释前要注意不能有重复的语句！
4
BuildLimit=数字  ←另起一行，可以填写阿拉伯数字，例如谭雅的建造数量限制为一个，填 1 即可。
5
ElitePrimary=MedusaE  ; ←像这样把注释放到后面也是可以的哦~
6
Size=30  ; ←注意是英文的 “;”、而不是中文的 “；”！
7
TooBigToFitUnderBridge=true

其实被注释的整段代码都可以删除，毕竟已经 “没有用” 了，但我们有时候可能会忘记一些代码上的改动，这时注释还可以起到备忘的作用，所以我们可以适当保留一些注释。

在 [AEGIS] 标签的下方可以看到这个语句Primary=Medusa，我们可以把Primary和Medusa分成两部分来看，Primary可以看作是武器类型，Medusa则是武器（不难看出，这行代码给单位指定了 [Medusa] 作为它的武器），下面先来认识一下武器类型：

• 主武器Primary=：单位的主要武器，以及单位的三星主武器ElitePrimary=，单位升级至三星后会立即换用ElitePrimary=所指定的武器，需要注意的是，有的单位是没有这种语句的，或者出现没有指定武器、ElitePrimary=被注释等情况，一般常见于平民单位，以及遥控坦克、工程师等，即便升级到三星，也会因为没有ElitePrimary=语句，而继续使用Primary=。

• 副武器Secondary=：单位的次要武器，以及三星副武器EliteSecondary=。例如天启坦克攻击飞行单位所使用的副武器Secondary=MammothTusk，但天启坦克没有三星副武器，所以无论有没有升级，都始终使用Secondary=所指定的武器。

• 死亡武器DeathWeapon=：单位被摧毁后所释放的武器，例如核子反应堆、自爆卡车和恐怖分子等。

• 多种武器逻辑：上述几种类型的武器可同时存在于一个单位中，若要实现一个单位使用更多的武器通常需要配合 “多武器逻辑”。例如多功能步兵车（IFV逻辑）和盖特机炮（盖特逻辑），其中盖特逻辑的启用语句是：IsGattling=yes（你可以看到盖特机炮分阶段开火，那是因为它有多种武器），单位本体拥有这种语句时，才能够做进一步的设置（例如添加相关武器语句：Weapon1=、EliteWeapon1=）。有的逻辑（例如分裂、空爆逻辑）只在武器本体中添加启用语句，具体的咱们就不深入了，只需要了解这些情况是存在的即可。有兴趣可查阅词典，以下是常见的多武器逻辑：

1. 盖特逻辑
2. IFV逻辑
3. 分裂逻辑
4. 空爆逻辑

以上即为武器类型的介绍，下面让我们回到Primary=Medusa这个语句，我们同样带上括号搜索Medusa这个武器，像这样：[Medusa]，搜索出来的结果如下：

1
[Medusa]
2
Damage=100
3
ROF=15
4
Range=12
5
Speed=120
6
Projectile=MedusaProjectile
7
Warhead=SAMWH
8
Report=AegisAttack
9
TurboBoost=yes
10
OmniFire=yes

现在你看到的部分就是武器本体（特指部分代码），简称武器（泛指相关代码），这些语句是武器的基本属性，例如修改单位的伤害（攻击力）Damage=、攻击范围Range=等，都是在该部分修改的。

可以看到武器中的语句并不多，其中最主要的就是Projectile=MedusaProjectile和Warhead=SAMWH这两个语句，所以我们再次用同样的方法搜索[MedusaProjectile]和[SAMWH]，可以分别看到以下内容：

1
[MedusaProjectile]  （抛射体）
2
Arm=1
3
High=yes
4
Shadow=no
5
......中间省略......
6
SubjectToCliffs=no
7
SubjectToElevation=no
8
SubjectToWalls=no
9

10
[SAMWH]  （弹头）
11
CellSpread=.3
12
PercentAtMax=1
13
Verses=100%,100%,100%,100%,100%,100%,0%,0%,0%,100%,100%
14
InfDeath=3
15
AnimList=XGRYSML1,XGRYSML2,EXPLOSML
16
ProneDamage=100%

这些内容便是武器的中的抛射体和弹头，武器的具体属性都要通过它们设置，例如用抛射体决定武器是否隔着围墙也能打到对面SubjectToWalls=，以及在弹头的设置中对某种车辆或建筑的装甲造成特定的伤害比例Verses=，这些我们在之后都会讲到。

现在我们来具体了解一下什么是单位，单位的类型有很多，例如：车辆、步兵、建筑、海军，还有空军等等都可以被称作单位。其中，车辆、直升机、飞艇、飞碟及海军被分类为载具 ← 重点，具体分类在下面介绍。
我们先来了解一下单位的基本运动方式：（这部分还没弄好…）
※运动方式
Locomotor=运动模式
MovementZone=寻路方式
额外：
SpeedType=速度类型
配合Locomotor= MovementZone=
常见速度类型：
不常见速度类型：（选择性了解）

部分其他特殊移动例：
当配合额外语句Teleporter=yes时，单位运动模式会进行切换（例如超时空矿车传送回矿场再开回矿区）。
当配合额外语句IsLocomotor=yes时，Locomotor=一般要设置为{92612C46-F71F-11d1-AC9F-006008055BB5}（例如磁电坦克把单位举高高）
（待完善）

两栖

※全局标签/语句

全局标签在规则文件中一般是指[General]标签下方的所有语句代码，例如控制困难、中等、简单的AI行为，以及各个阵营的建筑会出来哪些步兵（例如盟军建筑被摧毁时逃出来的是美国大兵、苏军是动员兵），等等。

※注册表及注册内容

上面有提到过注册名，例如[AEGIS]是神盾巡洋舰的注册名，现在来细讲一下什么是注册（待完善）

如何注册？（待完善）

常用注册表：
[InfantryTypes] ;注册步兵单位(Infantry)

[AircraftTypes] ;注册空军单位(Aircraft)

[VehicleTypes] ;注册载具(Vehicle)

需要注意，夜莺直升机、基洛夫空艇和磁悬幽浮（飞碟）这类单位的运动方式实际上为 Hover 悬浮速度类型，Hover 一般是归类为载具（即 Vehicle，而非 Aircraft）

[BuildingTypes] ;注册建筑单位(Building)

[Animations] ;注册动画

关于修改动画的具体内容我们会在第二章详细讲解

[Warheads] ;注册弹头

[WeaponTypes] ;Ares引擎的注册表，选择性了解

※超级武器 ;有Ares引擎内容，选择性了解

（待完善）

[SuperWeaponTypes]

※粒子系统

[Particles] ;注册粒子 [ParticleSystems] ;注册粒子系统

（待完善）

你应该会在游戏根目录下看到 ra2.csf 或者 ra2md.csf 这两个文件，这是游戏语言文件（CSF文件），规则文件中的所有单位名字都通过该文件指定。我们可以进行自定义，例如将美国大兵的名字改为美国队长，或者制作新单位的时候添加新名字等等。

让我们来试着修改一下：
这里推荐使用 Ra2CsfToolsGUI 来修改 CSF 文件。

以v1.5.0版本为例：
直接将 csf 文件拖入，然后点击 保存为.ini文件 （程序会自动询问是否跳转到刚刚保存的位置）。

好的，我们打开刚刚保存的 ini 文件来实践一下：

首先我们要知道，在单位本体中指定单位名字的语句是：UIName=Name:E1（美国大兵），显然，我们只需在该文件中搜索[Name:E1]即可，你会发现Value=美国大兵，那么我们只需将美国大兵修改成你喜欢的名字就好~

修改完成后再将该文件拖回到程序窗口，点击保存为.csf文件（注意要将保存的 CSF 文件命名为 ra2 或者 ra2md），这样就算修改完成啦！

其他一些手法：”:“冒号[TEST2]:[TEST] 就是复制[TEST2]的所有代码的前提下，再往[TEST2]中加入新代码或语句，意为“继承”（不知道要不要放在介绍内容里细讲…先预留）

1
[AEGIS] ;单位本体
2

3
UIName=Name:AEGIS  ;配合CSF文件指定的单位名字
4

5
Name=Aegis Cruiser  ;名字全称，可随便填写，实际游戏中无作用
6

7
Prerequisite=GAYARD,RADAR  ;建造前提（例如造V3火箭需要雷达）
8

9
Primary=Medusa  ;主武器（神盾巡洋舰是没有副武器的，当然，你也可以手动在单位本体中添加副武器语句）
10

11
;Secondary=  ;副武器（示例）
12

13
;EliteSecondary=  ;三星副武器（示例）
14

15
NavalTargeting=6  ;6
16

17
LandTargeting=1  ;1
18

19
ToProtect=yes  ;重点保护对象（对AI有用，当这个单位被攻击时，AI会调用闲置单位过来保护（只保护已方单位，不包括盟友）
20

21
Category=AFV
22

23
Strength=800
24

25
Naval=yes
26

27
Armor=light
28

29
TechLevel=7
30

31
Sight=8
32

33
Speed=4
34

35
CrateGoodie=no
36

37
Owner=British,French,Germans,Americans,Alliance
38

39
AllowedToStartInMultiplayer=no
40

41
Cost=1200
42

43
Soylent=1200
44

45
Points=35
46

47
ROT=1
48

49
Crusher=no
50

51
Crewed=no
52

53
IsSelectableCombatant=yes
54

55
Weight=4
56

57
RadialFireSegments=10
58

59
OpportunityFire=yes
60

61
DistributedFire=yes
62

63
Explosion=TWLT070,S_BANG48,S_BRNL58,S_CLSN58,S_TUMU60
64

65
VoiceSelect=AegisSelect  ;单位被玩家选中时的语音
66

67
VoiceMove=AegisMove  ;玩家命令其移动时的语音
68

69
VoiceAttack=AegisAttackCommand  ;玩家命令其攻击时语音
70

71
VoiceFeedback=  ;单位害怕时的语音（一般步兵才有害怕语音，例如动员兵低血量时会害怕地叫妈咪...可自行添加）
72

73
DieSound=  ;单位被摧毁的声音（单位被摧毁时的声音，而步兵一般是指死亡语音，例如各种惨叫声，可自行添加）
74

75
SinkingSound=GenLargeWaterDie  ;船被击毁后沉入水底的声音
76

77
MoveSound=AegisMoveStart  ;移动的声音，例如坦克的轮子移动时发出的声音
78

79
Locomotor={2BEA74E1-7CCA-11d3-BE14-00104B62A16C}
80

81
SpeedType=Float
82

83
MovementZone=Water
84

85
ThreatPosed=25
86

87
DamAGeParticleSystems=SparkSys,SmallGreySSys
88

89
VeteranAbilities=STRONGER,FIREPOWER,ROF,SIGHT,FASTER ;单位一星时赋予的额外增益属性，STRONGER 表示单位护甲获得额外加成（可以理解成更 “抗揍” 了，但单位总血量是不变的），还有 FIREPOWER 代表攻击力加成、ROF 代表攻击速度提升、SIGHT 视野变广、FASTER 移动速度变快。具体增益数值在全局代码中统一定义。
90

91
EliteAbilities=SELF_HEAL,STRONGER,FIREPOWER,ROF ;单位三星时赋予的额外增益属性，其中 SELF_HEAL 表示单位获得自动治愈能力（自动回血）。
92

93
ElitePrimary=MedusaE
94

95
Size=30
96

97
TooBigToFitUnderBridge=true

1
[Medusa] ;武器本体
2

3
Damage=100
4

5
ROF=15
6

7
Range=12
8

9
Speed=120
10

11
Projectile=MedusaProjectile
12

13
Warhead=SAMWH
14

15
Report=AegisAttack
16

17
TurboBoost=yes
18

19
OmniFire=yes
20

21

22

23
[MedusaE] ;武器本体（三星武器）
24

25
可以对比未升级三星的武器，你会发现只多出了一个语句：
26

27
Burst=2 ;例如三星灰熊坦克开一次火会连发两个炮弹
28
（没有这个语句将默认 Burst=1）

1
[MedusaProjectile] ;抛射体
2

3
Arm=1
4

5
High=yes
6

7
Shadow=no
8

9
AA=yes
10

11
AG=no
12

13
ImAGe=MEDUSA
14

15
CourseLockDuration=15
16

17
ROT=20
18

19
Scalable=yes
20

21
SubjectToCliffs=no
22

23
SubjectToElevation=no
24

25
SubjectToWalls=no
26

27

28

29
[SAMWH];弹头
30

31
CellSpread=.3
32

33
PercentAtMax=1
34

35
Verses=100%,100%,100%,100%,100%,100%,0%,0%,0%,100%,100%
36

37
InfDeath=3
38

39
AnimList=XGRYSML1,XGRYSML2,EXPLOSML
40

41
ProneDamAGe=100%

1
[Medusa]
2

3
Damage=100  ;伤害
4

5
ROF=15  ;攻速
6

7
Range=12  ;范围
8

9
Speed=120  ;弹体飞行速度
10

11
Projectile=MedusaProjectile  ;抛射体
12

13
Warhead=SAMWH  ;弹头
14

15
Report=AegisAttack  ;开火声音
16

17
TurboBoost=yes  ;导弹攻击飞行物是否有速度加成（攻击飞行物时导弹速度是否获得倍数加成，全局语句中默认`1.5`倍）
18

19
OmniFire=yes  ;是否可以360°无死角开火，用于无旋转炮塔单位（若没有这个语句默认为`no`，例如坦克杀手必须使自身朝向攻击目标才能开火）

第二章：art(md).ini（图像配置文件）#

巴拉巴拉（单位制作打算放这里讲，不过作者更新速度非常慢…等啥时候有大把空闲时间再来做这个…B站还有许多UP主在视频中比我讲的还好又专业，可以去看看，像我这种纯文字的表述不一定适合所有人…）

常用名词介绍：

※SHP（图像素材文件）：
例如步兵单位动画、建筑和图像等素材文件。

※VXL（模型素材文件）、HAV（模型坐标文件）：
例如坦克单位的模型文件，以及坦克旋转的炮塔等模型文件，一般VXL会附带一个模型坐标文件，即HAV，如果设置不对，会导致坦克模型在游戏里看起来像浮空一样，或者出现遁地和斜着开等等显示位置上的问题。

※序列

※帧

第三章：sound(md).ini、eva(md).ini（语音配置文件）#

巴拉巴拉

第四章：ai(md).ini（电脑AI配置文件）#

这个配置文件中的内容对于新手来说可能比较难懂，我会尝试用简单的方式来介绍：rerorero

第五章：地图文件和其他零碎知识#

常见的地图文件类型可以分为 .map、.yrm、.mpr这三种，在我们玩一些其他玩家制作的地图的时，你会发现一些单位的数值和遭遇战中的正规作战地图是不一样的，那是因为这些地图文件可以作为 “外置” 的规则文件，游戏首先读取的是地图文件内的单位规则，然后才是规则文件（如果规则文件中有相同规则代码，则会首先使用地图内的规则代码），这样就可以在不同的地图中放入不同的规则了，是不是很方便？当然，如果正规作战地图被修改了，比如把动员兵的 Cost 改为 Cost=0，把美国大兵的 Cost 改为 Cost=123456789 那就不叫正规作战地图了，应该叫不公平地图。

其他零碎知识：由于考虑到新人获取参考资料的难度，以后我会贡献出目前正在制作的地图，里面有一些比较有参考意义的代码，都会作为给新人讲解的材料（因为除非作者允许，一般不提倡解包其他 MOD 的内容），目前咱们只需粗略了解一下什么是地图文件就好…

完事儿了#

※如果你能完整看完这整篇 DIY 介绍，相信你是一位对红警 DIY 充满热情的新人~
※好的，到此为止你已经是一名小有能力的 Modder 了，现在可以开始做你的 MOD 了（笑），当然，为了证明自己的学习成果，可以挑战一下章节里的随堂测试和结尾的期末测试，证明自己是不是位 “合格” 的 Modder 哦~

看到这里，有兴趣继续学习的小伙伴可以在红警DIY论坛的wiki百科上学习基础语句代码，英语基础好的同学还可以去modenc，如需文件版的代码手册，可以下载Tomny大佬的手册（文件版有参考价值，但文件版有过时的内容，且不会更新，还是推荐查看wiki在线版，内容更准确和完整）
其他一些可能不怎么用到的配置文件，例如ui(md).ini，就没有介绍了，大家可以自行查阅代码解释。

（如果有真的难以亲自解决的问题，可直接移步论坛 bbs.ra2diy.com，大多数问题都可以通过搜索或者询问解决，建议先搜索再询问，直接搜索关键词，例如 “动画”、“攻击” 等，多个关键词用空格分开，推荐使用高级搜索→高级搜索入口）

期末测试#

（PS：这人真的好喜欢出题！对于新手来说可能有“超纲”，请别在意…）

1
备注：-NOLOGO(关闭EA商标的LOGO动画) -LOG(实时输出debug.log)，实时输出的 debug.log 日志文件在 debug 文件夹。

1
[Test]
2
UIName=NOSTR:TEST        ;CSF 文件内对应的名称
3
IsPowered=false          ;false 表示无需供电
4
RechargeTime=-1          ;-1 表示无等待时间
5
Type=UnitDelivery        ;超级武器类型，这个不用修改
6
Cursor=Move              ;显示的鼠标指针图标
7
NoCursor=NoMove          ;不能投放时显示的鼠标指针图标
8
Range=4                  ;生效范围圆圈
9
LineMultiplier=2         ;圆圈的密度
10
Deliver.Types=AMCV,TESLA ;投放盟军基地车和磁暴线圈，可往后添加更多单位
11
Deliver.Owner=Invoker    ;投放出的单位归谁拥有
12
SW.Deferment=0           ;生效前等待的帧数
13
SW.AllowAI=no            ;AI电脑是否拥有这个武器
14
SW.AlwaysGranted=yes     ;无需建筑，直接使用（例如闪电风暴需要天气控制器这个建筑）