本帖最后由 大大的咸鱼 于 2020-2-18 22:35 编辑

· 前言

       Flan's mod(Flan)是一款历史悠久的Minecraft(MC)枪械/载具模组，也是MC战圈里最著名的两个枪械模组之一。不过与维克多的枪械模组追求更高的武器操作还原度不同，Flan模组著名在百花齐放的内容包。玩家可以通过修改枪械/载具的数据文本来满足自己的客制化需求，或使用官方提供的内容包开发软件ToolBox来制作自己的内容包。鉴于Flan模组本身源自外国，国内相关教程相对稀少，我自己在入坑时也走了不少弯路，故在此制作相关配置数据的解析以帮助有需要的国内Flan内容包制作者以及想要入坑Flan内容制作的新人。

注1：本贴仅包含基于Flan's mod 4.1.10以及Flan's mod Ultimate 1.1的枪械/载具配置数据注解，不包含TB建模转码教程。(PS: 这方面我过段时间应该会开坑)
注2：由于Flan's mod的可用参数基本上是Flan's mod Ultimate的子集，在讲解时先展示Flan的可用参数，然后再补充Flan plus的额外可用参数。
注3：代码中被/**和*/括住的内容为Flan模组作者对该项数据的解释，并非参数的组成部分。
注4：用<>括住的内容为扩展选读内容，包括一些参数的巧用、有可能出现的错误以及简单的运作原理介绍。该部分内容通常被隐藏。
注5：本人不保证内容的全部准确，如你在使用本贴内容的过程中出现了任何问题本人概不负责。
注6：如果你发现了任何错误，欢迎指出，我会尽快更新修正并将您添加至创作鸣谢列表。

特别注意：不推荐直接在压缩包内修改数据，这样做可能会导致修改了数据的武器/载具直接在游戏内消失，是否会出现这样的问题取决于你的压缩软件。推荐先解压后修改数据，如有需要再重新打包。顺便安利一个好用的压缩软件：bandizip

· 目录

章节1：有关Flan数据配置文件的简单介绍
章节2：枪械配置文件参数解析(正在更新)
章节3：弹药配置文件参数解析(计划更新)
章节4：武器配件配置文件参数解析(计划更新)
章节5：投掷武器配置文件参数解析(计划更新)
章节6：头盔/护甲配置文件参数解析(计划更新)
章节7：陆地载具配置文件参数解析(不定日期)
章节8：飞行器配置文件参数解析(不定日期)
章节9：泰坦机甲配置文件参数解析(不定日期)
章节10：.lang配置文件参数解析(对内容包有进行汉化工作意向者看)(计划更新)
章节11：sounds.json文件参数解析(计划更新)
章节12：在Flan's mod/Flan's mod Ultimate源码文件中查找全部可用参数(计划更新)
章节13：其他附属内容

· 正文

章节1：有关Flan数据配置文件的简单介绍
注：该章节为新人科普向，有相关基础的人可自行略过。

1.1什么是Flan数据配置文件
       Flan数据配置文件就是内容包作者为自己的武器/载具写的数据文件，其中一般包含了武器/载具的数据特征，包括武器伤害、使用弹药、载具血量等，一般为储存在内容包特定路径下的txt文本文件。通过修改配置文件内的数据我们就可以直接改变武器/载具在游戏中的相关表现，从而达到客制化数据的目的。

1.2Flan数据配置文件路径
        枪械：内容包包名\guns
        弹药：内容包包名\bullets
        武器配件：内容包包名\attachments
        投掷武器：内容包包名\grenades
        头盔/护甲：内容包包名\armorFiles
        陆地载具：内容包包名\vehicles
        飞行载具：内容包包名\planes

1.3参数的基本形式
       参数在数据文件中的基本形式为：参数名 参数
其中参数名不可修改，包括大小写，用于向程序指明参数含义。而参数名后面跟的参数是可以修改的，它指明了该参数的输入值。参数不一定是数字，也可以是提前设置好的字符串或需要引用的文件名。
例1：Damage 8
其中"Damage"为参数名，'8'为参数。
有些参数可能有复数个输入值，这些输入值之间需要用空格隔开。
例2：paintjob Icon_HK416 Skin_HK416 yellow 3
其中"paintjob"为参数名，"Icon_HK416","Skin_HK416","yellow",'3'分别为4个输入参数。

特别注意：由于空格是分隔不同参数用的判断符，因而如果一个参数里面包含了空格字符，那么它就会被程序识别为两个独立的参数从而导致错误。这种情况通常出现在需要引用模型、贴图或声音文件之时，要注意被引用的文件名中不能含有空格，否则就可能会出现上述错误。如果有需要，可以将文件名中的所有的空格删除或者用'_'符来替换所有'空格'，就像上面的例2一样。

1.4如何获得指定版本的Flan's mod/Flan's mod Ultimate的全部可用参数
       获得一个版本的Flan/FlanPlus mod可用参数的方法一般有两种。一种方法是上网搜索配合对应版本的Flan/FlanPlus mod使用的内容包，然後拆包查看里面对应类型的物品的配置文件所包含的参数代码。这种方法操作难度小，但往往只能获得一个版本的Flan/FlanPlus mod的部分可用参数，这取决于该内容包作者究竟使用了多少种参数代码。另一种方法是去网上下载对应版本的Flan/FlanPlus mod源代码文件，其支持的所有参数就储存在 源码文件夹\src\main\java\com\flansmod\common下的对应文件夹中。关于如何在源代码中辨别这些可用参数，我会在第十二章中讲解。

章节2：枪械配置文件参数解析
1.1Flan's mod所有可用参数
前置：Flan's mod所有可用参数速查：
1. Colour
2. Name
3. ShortName
4. ItemID
5. Model
6. ModelScale
7. Texture
8. Icon
9. paintjob
10. Damage
11. Recoil
12. ShootDelay
13. Mode
14. NumBrustRounds
15. Ammo
16. NumAmmoSlots/NumAmmoItemsInGun/LoadIntoGun
17. CanForceReload
18. ReloadTime
19. ReloadSound
20. ShootSound
21. SoundLength
22. DistortSound
23. IdleSound
24. IdleSoundLength
25. WarmupSound
26. WarmupSoundLength
27. MinigunStartSpeed
28. LoopedSound/SpinSound
29. LoopedSoundLength/SpinSoundLength
30. CooldownSound
31. AllowBarrelAttachments & AllowScopeAttachments & AllowStockAttachments & AllowGripAttachments
32. NumGenericAttachmentSlots
33. AllowAttachments
34. AllowAllAttachments
35. NumBullets
36. Accuracy/Spread
37. BulletSpeed
38. OneHanded
39. CanShootUnderwater
40. UsableByPlayers & UsableByMechas
41. ConsumeGunOnUse
42. DropItemOnShoot
43. FOVZoomLevel
44. ZoomLevel
45. Scope
46. Knockback
47. KnockbackReduction/KnockbackModifier
48. MoveSpeedModifier/Slowness
49. Deployable
50. DeployedModel
51. DeployedTexture
52. StandBackDistance
53. PivotHeight
54. TopViewLimit & BottomViewLimit & SodeViewLimit
55. SecondaryFunction
56. MeleeDamage
57. MeleeTime
58. AddNode
59. MeleeDamagePoint/MeleeDamageOffset
60. shield
61. Description

Flan's mod(基于Flan's mod 4.1.10)所有可用参数：
1. Colour参数，参数的表达形式为：
  1. Colour 整数 整数 整数
复制代码
注解：该参数用于指示显示模型时模型贴图的最大RGB颜色显示范围，默认值为255 255 255，不建议修改

2. Name参数，参数的表达形式为：
  1. Name 枪械名称
复制代码
注解：该参数指明了枪械的名称，但却并非枪械在游戏中实际显示的名称，可以认为是一个没有任何实际意义的参数。如果有修改枪械在游戏中显示的名字的需要，请参考→章节10：.lang配置文件参数解析(计划更新)。


3. ShortName参数，参数的表达形式为：
  1. ShortName 枪械短名称
复制代码
注解：该参数指明了游戏系统用于区别枪械的名称，并非枪械在游戏中的显示名称。如果需要修改枪械在游戏中的显示名称请参考→章节10：.lang配置文件参数解析(计划更新)。但如果内容包里的.lang文件中并不含该ShortName的命名转化式或内容包中根本没有.lang文件，那么该枪械在游戏中显示的名字将变为 item.枪械的ShortName.name 的格式，这种请况通常出现在玩家自改ShortName却没有相应地修改.lang文件时。

特别注意：如果ShortName有重名现象可能会导致两个物品在游戏中被显示成一个<因为游戏程序分辨不出来这两个东西，所有东西相互重ShortName名都有可能会导致这种情况>或其他致命错误，一定要注意。

4. ItemID参数，参数的表达形式为：
  1. ItemID 整数
复制代码
注解：该参数用于指示枪械在系统中的ID，其主要功能为用于使用游戏内的give指令和调整物品在创造模式物品栏中显示时的顺序。该参数为非必要参数，可以不写参数及参数名，或写成ItemID Your ID，此时游戏系统会自动为该枪械分配ID。

5. Model参数，参数的表达形式为：
  1. /** For guns with 3D models */
  2. Model 3D模型文件所在母文件夹名.3D模型文件名
复制代码
注解：该参数指明了该枪所引用的模型文件地址以及模型文件名称。存放模型文件的文件夹地址为.minecraft\Flan\内容包包名\com\flansmod\client\model\模型文件所在文件夹名。

注意1：Flan's mod仅支持.class模型文件(编译后的模型文件)。
注意2：如果两个不同的包中存在名称完全相同的模型母文件夹和模型文件可能会导致引用该模型文件的物品在实际游戏中3D模型无法正常显示。


6. ModelScale参数，参数的表达形式为：
  1. /** For making detailed models and scaling down */
  2. ModelScale 浮点数
复制代码
注解：该参数用于指示3D模型在游戏中显示时的缩放倍数，其默认值为1.0，即没有缩放。


7. Texture参数，参数的表达形式为：
  1. Texture 贴图文件名
复制代码
注解：该参数指明了该枪所引用的贴图文件名称。存放贴图文件的文件夹地址为.minecraft\Flan\内容包包名\assets\flansmod\skins。

注意：Flan's mod仅支持PNG格式的图片文件。


8.Icon参数，参数的表达形式为：
  1. Icon 图标文件名
复制代码
注解：该参数指明了该枪在物品栏显示时的图标文件名称。存放图标文件的文件夹地址为.minecraft\Flan\内容包包名\assets\flansmod\textures\items。


9.paintjob参数，参数的表达形式为：
  1. /** The list of all available paintjobs for this gun */
  2. paintjob 该武器皮肤使用的Icon文件名 该武器皮肤使用的贴图文件名 在生存模式下切换为该皮肤所需要的颜料类型 整数(需要的颜料数量)
复制代码
注解：该参数指明了武器皮肤所引用的Icon、贴图文件名。颜料类型包括："black", "red", "green", "brown", "blue", "purple", "cyan", "silver", "gray", "pink", "lime", "yellow", "lightBlue", "magenta", "orange", "white"，每个分别对应一种游戏内的颜料。如果该枪械皮肤需要复数种颜料来兑换，不同颜料名+数量之间用空格隔开即可，例如：
  1. Paintjob Icon_HK416_Desert_Yellow Skin_HK416_Desert_Yellow Yellow 3 red 1 brown 2
复制代码


10. Damage参数，参数的表达形式为：
  1. /** Damage inflicted by this gun. Multiplied by the bullet damage. */
  2. Damage 浮点数
复制代码
注解：该参数用于指示武器子弹的直接击中伤害，单位为半颗心(Steve一共拥有20个半颗心的血量呢！)，该参数的默认值为0.0。

11. Recoil参数，参数的表达形式为：
  1. /** The amount to recoil the player's view by when firing a single shot from this gun */
  2. Recoil 整数
复制代码
注解：该参数用于指示枪械在垂直方向上的后坐力，该值越大单发后坐力越大。

12. ShootDelay参数，参数的表达形式为：
  1. /** The delay between shots in ticks (1/20ths of seconds) */
  2. ShootDelay 整数
复制代码
注解：该参数用于指示全自动或多连发点射模式下武器发射两颗子弹之间的时间间隔以及半自动武器的最高射速上限，单位为1/20秒。例如该参数填2，那么武器的全自动射速就为20/2发每秒，即600rpm。该参数的默认值为0。

13. Mode参数，参数的表达形式为：
  1. /** The firing mode of the gun. One of semi-auto, full-auto, minigun or burst */
  2. Mode FULLAUTO/SEMIAUTO/BURST/Minigun
复制代码

注解：该参数指明了枪械的射击模式，分别为FULLAUTO(全自动模式)、SEMIAUTO(半自动模式)、BURST(多连发点射模式)以及Minigun(加特林模式)，参数只能填其中一个，该参数的默认值为FULLAUTO。

14. NumBrustRounds参数，参数的表达形式为：
  1. /** The number of bullets to fire per burst in burst mode */
  2. NumBurstRounds 整数
复制代码
注解：该参数用于指示枪械在多连发点射模式下一次射出的子弹数，比如M16A4的多连发点射模式是三连发，那么这个参数就填3，KRISS Vector的多连发点射模式为两连发，这个参数就填2。该参数的默认值为3。

15.Ammo参数，参数的表达形式为：
  1. /** The list of bullet types that can be used in this gun */
  2. Ammo 弹药的ShortName
复制代码
注解：这个参数指明了武器可以使用的弹药，参数为所用弹药的ShortName。不过要注意该参数不支持复数个参数输入，如果武器需要支持复数种弹药的使用，那么应该写成如下形式：
  1. Ammo 弹药1ShortName
  2. Ammo 弹药2ShortName
  3. ...
复制代码

而不应该是这种形式：
  1. Ammo 弹药1ShortName 弹药2ShortName ...
复制代码


16.NumAmmoSlots/NumAmmoItemsInGun/LoadIntoGun参数，参数的表达形式为：
  1. /** Number of ammo items that the gun may hold. Most guns will hold one magazine.
  2. * Some may hold more, such as Nerf pistols, revolvers or shotguns */
  3. NumAmmoSlots 整数
  4. NumAmmoItemsInGun 整数
  5. LoadIntoGun 整数
复制代码
注解：这三种参数名其实指向的是同一个参数，所以你只需要挑选其中一种使用即可，它表示一把武器的最大可插弹夹数。如果你在配置文件中使用了多个该参数，那么最终游戏中武器的最大可插弹夹数取决于这些参数中的最后一个，例如：
  1. NumAmmoItemsInGun 7
  2. NumAmmoSlots 5
复制代码
那么最后在游戏中该枪的最大可插弹夹数为5。
如果武器可以挂载复数个弹夹，那么武器将会按照顺序依次消耗每个弹夹中的子弹。该功能一般用于模拟霰弹枪/左轮手枪/转轮榴弹发射器的填装效果。该参数默认值为1。


17.CanForceReload参数，参数的表达形式为：
  1. /** Whether the player can press the reload key (default R) to reload this gun */
  2. CanForceReload True/False
复制代码
注解：该参数指明了是否允许玩家在武器在仍有弹药剩余的情况下按R换弹，该参数默认值为True。

18.ReloadTime参数，参数的表达形式为：
  1. /** The time (in ticks) it takes to reload this gun */
  2. ReloadTime 整数
复制代码
注解：该参数用于指示枪械在游戏中的换弹时长，单位为1/20秒。如果该枪械使用了自定义的换弹动画，那么其换弹动画时长可能是不会随ReloadTime参数而改变的，但是从按下R键到可以进行下次发射的最短时间一定是ReloadTime。

19.ReloadSound参数，参数的表达形式为：
  1. /** The sound to play upon reloading */
  2. ReloadSound 换弹声音文件名
复制代码
注解：该参数指明了武器在换弹时所播放的声音文件的名称。Flan's mod内容包的声音文件统一都在内容包包名\assets\flansmod\sounds路径下。如果需要修改声音文件，直接将想要替换的文件名改成要被替换的文件名，然后拖入声音文件夹下覆盖即可。如果需要改变原来的声音文件名称或添加新的声音文件，记得去修改内容包包名\assets\flansmod文件夹下的sounds.json文件来进行注册，否则该声音文件并不会被游戏系统识别引用。关于如果修改sounds.json文件，请参考→章节11：sounds.json文件参数解析(计划更新)。

注意：Flan's mod仅支持.ogg格式的声音文件。

20.ShootSound参数，参数的表达形式为：
  1. /** The sound played upon shooting */
  2. ShootSound 射击声音文件名
复制代码
注解：该参数指明了武器在射击时所播放的声音文件的名称。相关注意事项同上。

21.SoundLength参数，参数的表达形式为：
  1. /** The length of the sound for looping sounds */
  2. SoundLength 整数
复制代码
注解：该参数用于指示播放射击声音文件时的播放时长，单位为1/20秒。

22.DistortSound参数，参数的表达形式为：
  1. /** Whether to distort the sound or not. Generally only set to false for looping sounds */
  2. DistortSound True/False
复制代码
注解：该参数指明了是否使游戏内的声音文件产生小幅不同(每次播放时)，比如射击时的声音音调时高时低(小幅的)，以模拟现实情况。该参数默认值为True，一般只有当该武器的类型为Minigun(加特林)时才将此参数设置为False。

23.IdleSound参数，参数的表达形式为：
  1. /** The sound to play while holding the weapon in the hand*/
  2. IdleSound 需要引用的声音文件名
复制代码
注解：该参数指明了当武器被拿在手上时会被自动播放的音效文件，有些类似传说级武器自带背景音效的感觉。

24.IdleSoundLength参数，参数的表达形式为：
  1. IdleSoundLength 整数
复制代码
注解：该参数用于指示播放IdleSound的长度，单位为1/20秒。目前不清楚声音文件在播放到指定长度后是否会循环播放(没有测试过，因为这个功能基本都用不上)。

25.WarmupSound参数，参数的表达形式为：
  1. /** Played when the player starts to hold shoot */
  2. WarmupSound
复制代码
注解：这个参数主要是为Minigun(加特林)服务的，就是开始长按鼠标时播放的声音，主要用来模拟Minigun的启动声音(枪管刚开始旋转那会儿的声音)，同时也决定了Minigun的启动时间，即按下鼠标到真正开始发射弹药所需要的时间。

26.WarmupSoundLength参数，参数的表达形式为：
  1. WarmupSoundLength 整数
复制代码
注解：该参数用于指示WarmupSound的播放长度，单位为1/20秒。该参数默认值为20。

27.MinigunStartSpeed参数，参数的表达形式为：
  1. /** The required speed for minigun mode guns to start firing */MinigunStartSpeed 浮点数
复制代码
注解：该参数用于指示当Minigun(加特林)开始发射弹药时枪管将会达到的旋转速度，在按住射击键且武器的射击模式被设置为minigun的情况枪管转速从0开始每秒+2直到其大小大于等于该参数的参数值。

28.LoopedSound/SpinSound参数，参数的表达形式为：
  1. /** Played in a loop until player stops holding shoot */
  2. LoopedSound 旋转音效文件名
  3. SpinSound 旋转音效文件名
复制代码
注解：这个参数也是主要是为Minigun(加特林)服务的，指明了Minigun枪管旋转的声音文件名。该声音文件将在WarmupSound播放完毕后开始循环播放，直至玩家松开射击键为止。
注意：Flan作者的建议如果需要使用LoopedSound/SpinSound的话最好将DistortSound设定为False。


29.LoopedSoundLength/SpinSoundLength参数，参数的表达形式为：
  1. LoopedSoundLength 整数
  2. SpinSoundLength 整数
复制代码
注解：该参数用于指示LoopedSound声音文件的长度，单位为1/20秒。该参数默认值为20。

30.CooldownSound参数，参数的表达形式为：
  1. /** Played when the player stops holding shoot */
  2. CooldownSound 冷却音效文件名
复制代码
注解：该参数同样是为Minigun(加特林)服务的，它指明了当玩家松开鼠标时将会播放的声音文件的名称，用于模仿Minigun枪管逐渐停止旋转的声音。不过该参数同样可以用于模拟枪管/发射器冷却以及弹壳落地的声音。


31.AllowBarrelAttachments & AllowScopeAttachments & AllowStockAttachments & AllowGripAttachments参数，参数的表达形式为：
  1. /** Whether each attachment slot is available */
  2. AllowBarrelAttachments True/False
  3. AllowScopeAttachments True/False
  4. AllowStockAttachments True/False
  5. AllowGripAttachments True/False
复制代码
注解：这4个参数分别指明了该武器是否允许安装BarrelAttachments(枪管/枪口配件)、AllowScopeAttachments(瞄准镜)、AllowStockAttachments(枪托)、AllowGripAttachments(握把)，默认值都为False。如果这些参数的值为True，那么将该武器放到枪械改装台上时就能看到相应的配件槽了。不过该参数并不决定配件在武器上的安装坐标，安装坐标在武器3D模型文件中，是在建模时就设置好的。如果3D模型文件中没有设置某种配件的安装坐标，那么安装坐标就是默认值(0,0,0)。所以如果你单纯地将一把原本没有某种配件槽的武器通过修改该参数来打开相应的配件槽，相关配件可能并不能显示在正确的位置上。

32.NumGenericAttachmentSlots参数，参数的表达形式为：
  1. /** The number of generic attachment slots there are on this gun */
  2. NumGenericAttachmentSlots 整数
复制代码
注解：该参数用于指示武器的可用Generic类型配件(通用型配件)槽数(就是将武器放到枪械改造台后在最左边显示的槽数)。Generic类型配件一般没有3D模型，但是可以像上面的4种配件一样影响武器的性能数据。

33.AllowAttachments参数，参数的表达形式为：
  1. /** The list of allowed attachments for this gun */
  2. AllowAttachments 允许安装的配件1的ShortName 允许安装的配件2的ShortName ...
复制代码
注解：该参数指明了所有可以被安装在该枪上的配件的ShortName，支持复数个参数输入，常用于阻止一种武器专用的配件被安装到另一种武器上。比如你给手枪做了个消音器，但是不想让这个消音器被装到步枪上，那么就可以在手枪的该参数后面添加这个消音器的ShortName而步枪的则不添加。

34.AllowAllAttachments参数，参数的表达形式为：
  1. /** If this is true, then all attachments are allowed. Otherwise the list is checked */
  2. AllowAllAttachments True/False
复制代码
注解：该参数与AllowAttachments相对，如果该参数的参数值为True，那么任何ShortName的配件都可以被安装。不过注意，如果该参数的参数值为True，那么其他内容包里的配件也会被允许安装到该武器上，如果你不想自己包里的枪被装上其他包里的配件，那么你可以把该参数的参数值设置为False并将你的包里的所有配件的ShortName在AllowAttachments参数后列出。

35.NumBullets参数，参数的表达形式为：
  1. /** The number of bullet entities created by each shot */
  2. NumBullets 整数
复制代码
注解：该参数用于指示枪械在射击时一次射出的子弹数，默认值为1，通常用于霰弹枪的配置文件。

36.Accuracy/Spread参数，参数的表达形式为：
  1. /** The amount that bullets spread out when fired from this gun */
  2. Accuracy 浮点数
  3. Spread 浮点数
复制代码
注解：该参数用于指示枪械发射的子弹在游戏中的散布程度，该参数参数值越大子弹的散射程度就越大，0.0就是没有散射，不过注意，子弹的散布不会受是否瞄准而改变。该参数通常配合NumBullets参数来使用以制造霰弹枪的射击效果，也可用于平衡一些短枪的属性效果，比如手枪或者冲锋枪。该参数的默认值为5.0。

37.BulletSpeed参数，参数的表达形式为：
  1. /** The speed of bullets upon leaving this gun */
  2. BulletSpeed 浮点数
复制代码
注解：该参数用于指示子弹在离开武器时的速度，默认值为5.0。目前尚不清楚该参数的单位。

38.OneHanded参数，参数的表达形式为：
  1. /** If true, then this gun can be dual wielded */
  2. OneHanded True/False
复制代码
注解：该参数指明了武器是否可以被双持，默认值为False。双持的办法是拿起一把可以双持的武器，然后按住蹲下键滑动鼠标滑轮，游戏系统会自动遍历当前物品栏内的所有物品(不包括背包中的物品)，并将找到的第一个另一把可双持武器添加到你的左手上。防爆盾也可以被设置成可双持武器。

39.CanShootUnderwater参数，该参数的表达形式为：
  1. /** Whether this gun can be used underwater */
  2. CanShootUnderwater True/False
复制代码
注解：该参数指明了该武器是否可以在水下射击。该参数的默认值为True。

40.UsableByPlayers & UsableByMechas参数，参数的表达形式为：
  1. /** Set these to make guns only usable by a certain type of entity */
  2. UsableByPlayers True/False
  3. UsableByMechas True/False
复制代码
注解：该参数指明了该武器是否可以被玩家/机甲使用。这两个参数的默认值均为True。

41.ConsumeGunOnUse参数，参数的表达形式为：
  1. /** For one shot items like a panzerfaust */
  2. ConsumeGunOnUse True/False
复制代码
注解：该参数指明了武器在发射后是否会消失，通常用于类似Panzerfaust一类的一次性发射器，默认值为False。

42.DropItemOnShoot
  1. /** Item to drop on shooting */
  2. DropItemOnShoot
复制代码
注解：该参数用于指示武器在射击后会掉落的物品的ShortName，而该物品为凭空产生的，并不需要玩家背包中拥有，不过该参数似乎并不支持复数个参数的输入。

43.FOVZoomLevel参数，参数的表达形式为：
  1. /** The FOV zoom level of the default scope */
  2. FOVZoomLevel 浮点数
复制代码
注解：该参数用于指示武器在瞄准时的放大倍数，默认值为1.5。其实该参数的运作原理就是在瞄准时将MC的“视角”设置变小从而达到放大的效果。不过比较狗的地方是缩小玩家的“视角”并不会将手里的物品放大，所以在瞄准时枪的模型是不会放大的；另外一点就是利用FOVZoomLevel放大时并不会降低玩家的鼠标速度，所以如果你把这个参数设置的比较大，那么放大后你会感到快乐(不过我已经找到了这个bug的修复方法，相关具体操作我会在第13章中讲解)。

44.ZoomLevel参数，参数的表达形式为：
  1. /** The zoom level of the default scope */
  2. ZoomLevel 浮点数
复制代码
注解：该参数用于指示武器在瞄准时的放大倍数，默认值为1.0。不过不同于FOVZoomLevel参数，该参数的放大效果没有过场动画，即点下瞄准键经过瞄准所需要的时间后会突然跳到设定好的放大倍数，且当该参数不为1.0时等瞄准所需要的时间结束后武器模型就会被隐藏。该参数在使用时会降低鼠标的移动速度，且该参数可以和FOVZoomLevel参数一起使用，效果就是会先过渡到FOVZoomLevel设定好的放大倍数，然后再突然跳到FOVZoomLevel*ZoomLevel的放大倍数，武器模型同样会被隐藏。该参数一般会配合下面的Scope参数一起使用来达到类似狙击枪瞄准镜的效果。

45.Scope参数，参数的表达形式为：
  1. /** Default scope overlay texture */
  2. Scope 需要显示的瞄准镜图片文件的名称
复制代码
注解：该参数指明了当武器进入瞄准模式时会显示在屏幕上的图片的文件名，一般会配合ZoomLevel参数使用以达到类似狙击枪瞄准镜的效果。Scope图片文件的储存路径为：内容包包名\assets\flansmod\gui，将想要使用的瞄准镜图片文件放在该文件夹下即可。

46.Knockback参数，参数的表达形式为：
  1. /** The amount of knockback to impact upon the player per shot */
  2. Knockback 浮点数
复制代码
注解：该参数用于指示当武器发射时作用在使用者身上的击退效果的大小，默认值为0.0，可以用来模拟大口径武器的后坐力，比如炮狙，开一枪自己被后坐力震得后退几格这样的。(也可以用来模拟超电磁炮发射不是么？[手动狗头])

47.KnockbackReduction/KnockbackModifier参数，参数的表达形式为：
  1. /** Gives knockback resistance to the player */
  2. KnockbackReduction 浮点数
  3. KnockbackModifier 浮点数
复制代码
注解：该参数用于指明当玩家将该武器拿在手上时会获得的击退抗性效果的强度，默认值为0.0，即没有击退抗性。如果填1.0就是完全击退抗性，填0.5就是击退效果减少一半。

48. MoveSpeedModifier/Slowness参数，参数的表达形式为：
  1. /** Speeds up or slows down player movement when this item is held */
  2. MoveSpeedModifier 浮点数
  3. Slowness 浮点数
复制代码
注解：该参数用于指示当玩家将该武器拿在手上时的会获得的移速加成/减成，其默认值为1.0，即不影响玩家当前的速度。其计算公式为：玩家当前的速度=玩家原来的速度*该参数的参数值。

49. Deployable参数，参数的表达形式为：
  1. /** If true, then the bullet does not shoot when right clicked, but must instead be placed on the ground */
  2. Deployable True/False
复制代码
注解：该参数指明了武器是否可以被放置，比如架在掩体上的机枪等。

50. DeployedModel参数，参数的表达形式为：
  1. /** The deployable model */
  2. DeployedModel 3D模型文件所在母文件夹名.3D模型文件名
复制代码
注解：该参数指明了该可放置武器所引用的模型文件地址以及模型文件名称。
51. DeployedTexture参数，参数的表达形式为：
  1. /** The deployable model's texture*/
  2. DeployedTexture 贴图文件名
复制代码
注解：该参数指明了该可放置武器所引用的贴图文件名称。

52. StandBackDistance参数，参数的表达形式为：
  1. /** Various deployable settings controlling the player view limits and standing position */
  2. StandBackDistance 浮点数
复制代码
注解：该参数用于指示当玩家使用可放置武器时所站的位置距可放置武器被放置的方块的中心点的距离，其默认值为1.5。

53. PivotHeight参数，参数的表达形式为：
  1. /** Various deployable settings controlling the player view limits and standing position */
  2. PivotHeight 浮点数
复制代码
注解：该参数用于指示可放置武器的旋转中心点的高度，其默认值为0.375。

54. TopViewLimit & BottomViewLimit & SideViewLimit参数的表达形式为：
  1. /** Various deployable settings controlling the player view limits and standing position */
  2. TopViewLimit 浮点数
  3. BottomViewLimit 浮点数
  4. SideViewLimit 浮点数
复制代码
注解：这3个参数分别决定了可放置武器的最大射角上限、最大射角下限、最大左右射角，其中最大射角上限的参数值应为负数。这3个参数的默认值分别为-60.0、30.0、45.0。

55. SecondaryFunction参数，参数的表达形式为：
  1. /** The secondary function of this gun. By default, the left mouse button triggers this */
  2. SecondaryFunction zoom/melee/custommelee
复制代码
注解：该参数指明了该物品的功能，如果不添加该参数则该物品被判定为“枪械”；如果添加该参数并填写参数值为zoom，则该物品被判定为“望远镜”，不具有射击功能，左键放大；如果添加该参数并填写参数值为melee，则该物品被判定为“近战武器”，左键进行近战攻击；如果添加该参数并填写参数值为custommelee，则该物品被判定为“近战武器”并启用相关的自定义攻击动作参数。

56. MeleeDamage参数，参数的表达形式为：
  1. /** The damage inflicted upon punching someone with this gun */
  2. MeleeDamage 浮点数
复制代码
注解：该参数用于指示当武器类型为“近战武器”时的攻击威力，其默认值为1.0。

57. MeleeTime参数，参数的表达形式为：
  1. /** The time delay between custom melee attacks */
  2. MeleeTime 整数
复制代码
注解：该参数用于指示近战武器进行两次攻击的相隔时间，以上为代码作者注解的直接翻译，我个人理解的话更像是完成近战攻击动作所需要的时间，近战攻击的伤害应该是在完成近战攻击动作后施加的。不过鉴于我并没有用过这个参数，所以我也不敢确定其具体效果，如果有人测试过了可以通知我相关结果，我会尽快更新该参数的相关解释并将您添加至创作鸣谢列表。

58. AddNode参数，参数的表达形式为：
  1. /** The path the melee weapon takes */
  2. AddNode 浮点数1 浮点数2 浮点数3 浮点数4 浮点数5 浮点数6
复制代码
注解：该参数用于指示近战武器攻击时的路径，其中前3个参数为路径起始点的x、y、z轴坐标，后3个参数为路径朝向的x、y、z轴角度坐标。从源代码获参的形式来看该参数似乎支持通过类似Ammo(参数讲解中的第15项)参数的形式进行复参数输入，但具体情况不清楚，因为我没用过该参数，同上如果有人知道真实情况可以通知我，我会尽快更新该参数的相关解释并将您添加至创作鸣谢列表。

59. MeleeDamagePoint/MeleeDamageOffset参数，参数的表达形式为：
  1. /** The points on the melee weapon that damage is actually done from. */
  2. MeleeDamagePoint 浮点数1 浮点数2 浮点数3
  3. MeleeDamageOffset 浮点数1 浮点数2 浮点数3
复制代码
注解：该参数用于指示自定义近战武器的伤害判定点，3个参数分别为伤害判定点的x、y、z轴坐标。同上没用过，具体情况不清楚，但是估计是在自订的近战动作时间结束后这些点上会被施加设定好的近战伤害，应该和上面一样支持类似Ammo参数形式的复参数输入。当然依旧同上如果有人知道真实情况可以通知我，我会尽快更新该参数的相关解释并将您添加至创作鸣谢列表。

60. shield参数，参数的表达形式为：
  1. /** Whether or not this gun has a shield piece */
  2. shield 浮点数1 浮点数2 浮点数3 浮点数4 浮点数5 浮点数6 浮点数7
复制代码
注解：该参数用于指示有关盾牌的所有参数，当该参数存在时该物品即被判定为“盾牌”，其中浮点数1为盾牌阻挡的伤害的比值，其默认值为0.0，即不阻挡伤害，玩家收到的伤害=应该造成的伤害*浮点数1；浮点数2、3、4为盾牌中心点的x、y、z轴坐标；浮点数5、6、7为盾牌实体的x、y、z轴长，但具体是边长还是边长的一般就不清楚了，同上知道的可以通知我，我会尽快更新该参数的相关解释并将您添加至创作鸣谢列表。

61. Description参数，参数的表达形式为：
  1. Description 对该物品的描述
复制代码
注解：该参数用于指示当玩家将鼠标移动到该物品上时会在出现的显示框中显示的解释文字，通常在物品名下方。

       以上即为Flan's mod所支持的所有有关枪械的参数了(如您发现有任何疏漏可以向我反馈，我会尽快更新相关参数并将您添加到创作鸣谢列表。)，下面的部分则为Flan's mod plus所支持的所有额外可用参数以及和Flan中的参数形式相同但实际内容有所变化的参数。

首先是Flan's mod Plus(基于Flan's mod Ultimate 1.1)中和Flan中的参数形式相同但实际内容有所变化的参数：
Flan's mod Plus中参数形式相同但实际内容有所变化的参数：
1. Recoil参数，参数的表达形式为：
  1. /** Base value for Upwards cursor/view recoil */
  2. Recoil 浮点数
复制代码
注解：该参数用于指示武器的垂直后坐力，具体解释见Flan's mod可用参数解释第11项。
区别：该参数在Flan中该参数仅支持整数输入，但在Flan Plus中该参数允许浮点数输入。

2. ShootDelay参数，参数的表达形式为：
  1. /** The delay between shots in ticks (1/20ths of seconds) OUTDATED, USE RPM */
  2. ShootDelay 浮点数
复制代码
注解：该参数用于指示武器进行两次射击时的射击时间间隔，单位为1/20秒，具体解释见Flan's mod可用参数解释第12项。
区别：该参数在Flan中该参数仅支持整数输入，但在Flan Plus中该参数允许浮点数输入。不过注意Flan's mod Plus的作者在这里给的标注中说到“ShootDelay参数已经落伍，使用RPM参数替代之”，其中的RPM参数即为新加的RoundsPerMin参数，将在后面Flan's mod Plus的额外可用参数部分中介绍。


3. NumAmmoSlots/NumAmmoItemsInGun/LoadIntoGun参数，参数的表达形式为：
  1. /** Number of ammo items that the gun may hold. Most guns will hold one magazine.
  2. * Some may hold more, such as Nerf pistols, revolvers or shotguns */
  3. NumAmmoSlots 整数
  4. NumAmmoItemsInGun 整数
  5. LoadIntoGun 整数
复制代码
注解：该参数用于指示武器最大可以装载几个弹夹，具体解释见Flan's mod可用参数解释第16项。
区别：其实这个参数在Flan's mod和Flan's mod Ultimate中在功能用法上没有什么区别，单拎出来讲是因为该参数游戏中的其他表现在两者中略有不同。在Flan中，不管武器的最大可挂载弹夹数(该参数的参数值)和进行换弹操作时武器内剩余的弹夹数为几，换弹时间都是一定的；但在Flan Plus中，可挂载复数个弹夹的武器的 换弹时间=设定好的换弹时间/武器最大可挂载弹夹数*(武器最大可挂载弹夹数-换弹时武器内剩余的弹夹数) ，也就是说在Flan Plus中可挂载复数个弹夹的武器的换弹时间与武器所需填装的弹夹数成正比。Flan Plus作者之所以做出这样的改动应该是想要更好地模拟泵动式散弹枪的填装效果，因为如果在换弹时一把8发容量的散弹枪只需填装4发子弹，那么玩家不应该需要填装8发的时间来填装它。不过此举也造成了很多bug，比如任何最大可挂载弹夹数超过1的武器在使用R键换弹时都无法正常播放换弹声音；同时如果你采用了我在<Flan's mod可用参数解释>的选读部分中提到的“用弹夹模拟子弹”的武器弹药策略的话，也会导致武器在Flan Plus中的换弹时间不正常。

之后是Flan's mod Ultimate(基于Flan's mod Ultimate 1.1)的全部额外可用参数：

Flan's mod Ultimate额外可用参数：
1. RandomRecoilRange参数，参数的表达形式为：
  1. /** Modifier for setting the maximum pitch divergence when randomizing recoil (Recoil 2 + rndRecoil 0.5 == 1.5-2.5 Recoil range) */
  2. RandomRecoilRange 浮点数
复制代码
注解：该参数用于指示武器的垂直后坐力的随机范围，例如如果Recoil参数的参数值为2.0，该参数的参数值为0.3，那么武器实际的垂直后座力范围会在1.7-2.3之间。该参数的默认值为0.5。

2. DecreaseRecoil参数，参数的表达形式为：
  1. /** Modifier for decreasing the final pitch recoil while crouching (Recoil 2 + rndRecoil 0.5 + decreaseRecoil 0.5 == 1.0-2.0 Recoil range) */
  2. DecreaseRecoil 浮点数
复制代码
注解：该参数用于指示武器使用者在蹲下时会获得的垂直后坐力减小的效果大小，例如如果Recoil参数的参数值为2.0，RandomRecoilRange的参数值为0.3，该参数的参数值为0.4，那么当玩家蹲下使用该武器时的垂直后坐力范围为1.7-1.9。

3. RecoilYaw参数，参数的表达形式为：
  1. /** Base value for Left/Right cursor/view recoil */
  2. RecoilYaw 浮点数
复制代码
注解：该参数用于指示武器的水平后坐力大小。由于该参数的默认值为0.5且Flan's mod本身并不支持该参数，因而如果直接将一个Flan's mod的原生内容包拖到Flan's mod Plus中可能会导致所有武器都有统一大小的水平后坐力且通过将枪械数据文本中的Recoil参数修改为0后仍然不会消失。

注意：虽然这个参数直译是水平后坐力，但是经实测发现这个参数其实应该叫做“向左的后坐力”，因为在我自己的测试中，该参数填写了正值(RandomRecoilYawRange为0.0)的武器后坐力统一向左，填写了负值的武器后坐力统一向右，所以如果你想要的是“水平后坐力”，那么我推荐你把该参数的参数值填写为0.0然后使用下面的RandomRecoilYawRange参数。

4. RandomRecoilYawRange参数，参数的表达形式为：
  1. /** Modifier for setting the maximum yaw divergence when randomizing recoil (Recoil 2 + rndRecoil 0.5 == 1.5-2.5 Recoil range) */
  2. RandomRecoilYawRange 浮点数
复制代码
注解：该参数与RandomRecoilRange的功能相同，只不过作用对象是武器的水平后坐力罢了。该参数的参数值为0.5。
5. DecreaseRecoilYaw参数，参数的表达形式为：
  1. /** Modifier for decreasing the final yaw recoil while crouching (Recoil 2 + rndRecoil 0.5 + decreaseRecoil 0.5 == 1.0-2.0 Recoil range) */
  2. //This must never be set to 0, will cause massive issues
  3. DecreaseRecoilYaw 浮点数
复制代码
注解：该参数与DecreaseRecoil的功能相同，只不过作用对象是武器的水平后坐力罢了。不过需要注意的是Flan's mod Plus的作者在该参数上方额外添加了一小段注释说到“该参数的参数值永远不能设定为0，否者会造成大量的问题”，至于这个问题是什么我自闲的蛋疼去试了试，结果发现是蹲下时的水平后坐力变得奇大。在好奇心的驱使下我又去源码里查了查有关这个参数的功能代码，结果发现缘由是DecreaseRecoil和DecreaseRecoilYaw参数的作用原理是不同的，DecreaseRecoil是蹲下后坐力=原来的后坐力-DecreaseRecoil参数值，而DecreaseRecoilYaw的作用原理则是蹲下后坐力=原来的后坐力/DecreaseRecoilYaw参数值，所以注释里解释的作用原理是错误的[我又想骂人了]！顺带一提该参数的默认值为0.5(所以如果你不调该参数的话武器的默认蹲下水平后坐力将是原来后坐力的两倍！)。

6. ShowCrosshair参数，参数的表达形式为：
  1. /** Show the crosshair when holding this weapon */
  2. ShowCrosshair True/False
复制代码
注解：该参数用于指示当玩家持握该武器时是否显示瞄准十字，其默认值为False，即不显示瞄准十字。

8. FlashModel参数，参数的表达形式为：
  1. /** For adding a muzzle flash model to render */
  2. FlashModel 枪口火焰3D模型文件所在母文件夹名.枪口火焰3D模型文件名
复制代码
注解：该参数指明了当武器射击时的枪口火焰的3D模型的存放路径以及名称。至于3D模型的存放路径位置可参考Flan's mod参数讲解中的第5项。

9. FlashTexture参数，参数的表达形式为：
  1. /** Set a muzzle flash texture */
  2. FlashTexture 枪口火焰模型的贴图的文件名
复制代码
注解：该参数指明了枪口火焰模型的贴图文件名。至于贴图文件的存放路径位置可参考Flan's mod参数讲解中的第7项。

10. CasingModel参数，参数的表达形式为：
  1. /** For adding a bullet casing model to render */
  2. CasingModel 弹壳3D模型文件所在母文件夹名.弹壳3D模型文件名
复制代码
注解：该参数指明了当武器射击时的抛出去的弹壳的模型的存放路径以及名称。至于3D模型的存放路径位置可参考Flan's mod参数讲解中的第5项。

11. CasingTexture参数，参数的表达形式为：
  1. /** Set a bullet casing texture */
  2. CasingTexture 弹壳模型的贴图的文件名
复制代码
注解：该参数指明了弹壳模型的贴图文件名。至于贴图文件的存放路径位置可参考Flan's mod参数讲解中的第7项。

12. HitTexture参数，参数的表达形式为：
  1. /** Set a hit marker texture */
  2. HitTexture 命中贴图的文件名
复制代码
注解：该参数指明了名中效果贴图的名称。默认命中贴图就是你击中目标时出现的那个45°倾斜的十字叉，用于命中提示。修改该参数即可指定特定的命中提示图案。

13. AllowRearm参数，参数的表达形式为：
  1. /** Whether the player can receive ammo for this gun from an ammo mag */
  2. AllowRearm True/False
复制代码
注解：该参数指明了进行换弹时玩家是否会收到武器中未打完的弹夹，其默认值为True。


14. AllowNumBulletsByBulletType参数，参数的表达形式为：
  1. /** Allows you to set how many bullet entities are fired per shot via the ammo used */
  2. AllowNumBulletsByBulletType True/False
复制代码
注解：该参数指明了是否允许弹药决定武器每次发射射出的弹药数，其默认值为False。该参数可以配合下面的AllowSpreadByBullet参数为霰弹枪做出独头弹的效果。

15. AllowSpreadByBullet参数，参数的表达形式为：
  1. /** If true, spread determined by loaded ammo type */
  2. AllowSpreadByBullet True/False
复制代码
注解：该参数指明了是否允许弹药决定武器的散射程度，其默认值为False。

16. CanLockAngle参数，参数的表达形式为：
  1. //Launcher variables
  2. CanLockAngle 整数
复制代码
注解：该参数用于指明类似发射器一类的武器的最大可锁定角度，可以用于制作类似毒刺一类的制导单兵发射器。该参数的默认值为5。

17. MaxRangeLockOn参数，参数的表达形式为：
  1. //Launcher variables
  2. MaxRangeLockOn 整数
复制代码
注解：该参数用于指示发射器一类的武器的最大可锁定距离，其默认值为80。

18. LockOnToDriveables & LockOnToVehicles & LockOnToPlanes & LockOnToMechas & LockOnToPlayers & LockOnToLivings参数，参数的表达形式为：
  1. /** Determines what the launcher can lock on to */
  2. LockOnToDriveables True/False
  3. LockOnToVehicles True/False
  4. LockOnToPlanes True/False
  5. LockOnToMechas True/False
  6. LockOnToPlayers True/False
  7. LockOnToLivings True/False
复制代码
注解：该参数决定了可锁定武器可以锁定的目标，它们分别为Driveables(可驾驶的)、Vehicles(陆地载具)、Planes(飞行载具)、Mechas(机甲)、Players(玩家)以及Livings(活的)。它们的默认值均为False。

19. LockOnSound参数，参数的表达形式为：
  1. //Launcher variables
  2. LockOnSound 锁定音效文件名称
复制代码
注解：该参数指明了当可锁定武器锁定了目标时会播放的提示音的音效文件的名称。至于音效文件的存放路径位置可参考Flan's mod参数讲解中的第19项。

20. lockOnSoundTime参数，参数的表达形式为：
  1. lockOnSoundTime 整数
复制代码
注解：该参数指明了锁定音效的播放时长，其默认值为0。

21. ItemUseAction参数，参数的表达形式为：
  1. /** Whether Gun makes players to be EnumAction.bow */
  2. ItemUseAction bow
复制代码
注解：该参数的注释直译是“枪械是否会让玩家进行鞠躬(蹲下)动作”，但根据Flan's mod Ultimate制作者在Forge上的注释来看其功能是指定你在使用该物品时游戏系统认为你正在进行的动作。此项对枪械本身的属性似乎没什么影响，所以也没有必要进行改动。
待更

本章鸣谢列表：
       - cybmp3
       <第一个评论并表达支持的小伙伴>

       - Char12138
       <因为这个小伙伴我更新了近战武器相关参数[笑]>

PS：如果你不希望出现在鸣谢名单或希望以其他昵称出现在鸣谢名单的话可以联系我，我会尽快做出修改。


待更(越发觉得自己开的是天坑)。
PS：我自己做的枪包这两天应该会发布预览版，不过搞这些东西完全是兴趣使然，所以可能不会像MCBBS里的那些大佬的包那么流批，不要抱太高的期待。[手动狗头]
预览版帖子传送门→[1.7.10][Flan —— Octagon Weapons/八边形武器包]兴趣使然的枪包[预览版]

最近忙于更新自己的枪包，该教程贴的更新可能会出现延后。