# 武器配置 ## 介绍 The so called weapon config files are in a text file format, so they can easily be read and edited. The format of the content is known as [Source **KeyValues**](https://noskill.gitbook.io/titanfall2/chinese/information/programming/keyvalues). Beside being a general source of information, this page will be used as a reference point of documentation for the different aspects and uses of the weapon config files. Either by modding guides or other documentation pages. ### 文件位置 Weapon config files can be found in this folder relative to your VPK. ``` \scripts\weapons ``` The VPK of your choice will depend of the context of your modding. If it is for multiplayer or for single player. For multiplayer purpose it will be the "Common" VPK and for other than multiplayer you will need to modify each VPK archives for their respective levels. ## 主页-变量(关键值) Down below is embedded a table used as an index. All (known) variables are split in different tabs (Models, Effects, Sounds, etc.) with categories per tab.\ Each tab will have its own header so it can easily be browsed in the contents table. The different categories will also have their own sub headers. {% embed url="" %} ## 模型和动画 ## 特效(FX) 特效是粒子系统在起源引擎中的最终应用之一。 作为一种基础方法，FX是纹理（2D图形元素）和不同类型参数的结合，用以创建拥有3D视觉效果的产物，如爆炸、云、轨迹等。 {% hint style="info" %} At this time, there isn't an in depth reference page for the Particle System and their pcf files. The page will be included here and hyperlinked on keywords. If you would like to help, please contact us. {% endhint %} A different sub header will be made for the different category of variables used in the purpose of FX. The complete list of variables can be viewed from the [index table](https://noskill.gitbook.io/titanfall2/chinese/information/programming/keyvalues/broken-reference) in the **Effect (FX)** tab. By the very nature of config files, the usage of FX can be restrictive, as they are easier to edit (the config files) but at the cost of possibilities. With that said, for anything that cannot be done from the config file, vscript files open more possibilities. While looking at pre-existing files, the FX variables will often be around the comment: ``` // Effects ``` In KeyValues format, a comment is defined by a double forward slash, everything after will not be interpreted by the engine (Source Engine). This method is very useful to leave annotations, default values, etc. Thus making your file easier to read and / or easier to modify over time. Note that the variables do not need to be after the `// Effect` comment.\ You can learn more about the KeyValues format here {% content-ref url="" %} [](https://noskill.gitbook.io/titanfall2/chinese/information/programming/keyvalues) {% endcontent-ref %} {% hint style="warning" %} Weapons can have different FX when they are amped. To modify this aspect, your FX variables will need to be included inside the `Mods` braces. Most of the time this part is already implemented, at the bottom of the weapon config file. {% endhint %} The following code block is what you should look for in the weapon config file. While it won't be exactly the same, it should look similar. **It should include `is_burn_mod` in the braces** ``` { "is_burn_mod" "1" //FX "tracer_effect" "P_wpn_tracer_BC" "tracer_effect_first_person" "P_wpn_tracer_BC" "fx_muzzle_flash_view" "wpn_muzzleflash_smg_elec_FP" "fx_muzzle_flash_world" "wpn_muzzleflash_smg_elec" } ``` FX values are indexed, which you can refer to while reading the sub-headers. {% content-ref url="../../../game-values/effect-fx" %} [effect-fx](https://noskill.gitbook.io/titanfall2/chinese/game-values/effect-fx) {% endcontent-ref %} #### \ **The expected value \ is the name of an effect from the Particle System as a string.** Those names are set from pcf files (particle files) The FX can be found in the reference index in the page down bellow. {% content-ref url="../../../game-values/effect-fx" %} [effect-fx](https://noskill.gitbook.io/titanfall2/chinese/game-values/effect-fx) {% endcontent-ref %} #### \ Even if the effect of this variable are not known with certainties. Here is a the list of the known values that can be used. ``` FX_GLOW center exhaust fx_center fx_top muzzle_flash muzzle_flash_scoped muzzle_flash_suppressor_sq muzzle_flash_l shell shell_l shell_scoped MissileAirBurst ``` #### \ / \ The **Boolean** data type is a [data type](https://en.wikipedia.org/wiki/Data_type) that has one of two possible values (usually denoted true and false) which is intended to represent the two [truth values](https://en.wikipedia.org/wiki/Truth_value) of [logic](https://en.wikipedia.org/wiki/Logic) and [Boolean algebra](https://en.wikipedia.org/wiki/Boolean_algebra). A boolean as an integer (int) will differ from a boolean as a string (str), they are used depending on the syntax of the language. Its use varies in different areas of the engine but for the most part, in weapon config files boolean values are used in a form of intergers. Howhever there are some exeptions, those will be differenciated by either `` or ``. {% tabs %} {% tab title="Boolean int" %} ``` 0 1 ``` {% endtab %} {% tab title="Boolean str" %} ``` false true ``` {% endtab %} {% endtabs %} ### ### 弹药-直线弹道追踪 The FX for hitscan bullets are known as tracer effects. They will behave as intended for hitscan based weapons but will not work properly on projectile based weapons. {% embed url="" %} An example of tracer FX {% endembed %} The tracers FX will change the aesthetics of your bullets, either for the bullet itself or the trail it leaves behind (the bullet itself being the leading graphical element as it moves in one direction)\ Combination are of course possible, but not from the weapon config file. *(refer to the mentions under the main* [*FX header*](https://noskill.gitbook.io/titanfall2/chinese/information/programming/keyvalues/broken-reference)*)*\ Different "kinds" of bullets can be achieved (energy, electric, fire, high velocity, etc.) * **tracer\_effect** will set an FX to the given weapon from other entities (players & NPC's) * **tracer\_effect\_first\_person** will set an FX only from your uses of the weapon While modding with large quantities of FX, it is recommended to primarily focus on first person variables, thus having a lower impact on performance and being less confusing. {% tabs %} {% tab title="格式" %} ``` "tracer_effect_first_person" "tracer_effect" ``` {% endtab %} {% tab title="例子" %} ``` "tracer_effect_first_person" "P_wpn_tracer" "tracer_effect" "P_wpn_tracer" ``` {% endtab %} {% endtabs %} {% hint style="warning" %} Tracer variables are known to not work very well with FX that are used for projectiles originally. However this is not a golden rule. Trying different kind of FX values can lead to very interesting results. Feel free to play around with them. {% endhint %} ### 弹药-抛物线弹道追踪 The FX for projectile bullets are known as projectile trail effects. They will behave as intended for projectile based weapons but will not work properly on hitscan based weapons. {% embed url="" %} An example of projectile FX {% endembed %} The projectile trail FX will change the aesthetics of your projectiles, either for the projectile itself or the trail it leaves behind (the projectile itself being the leading graphical element as it moves in one direction).\ Combination are of course possible, but not from the weapon config file. *(refer to the mentions under the main* [*FX header*](https://noskill.gitbook.io/titanfall2/chinese/information/programming/keyvalues/broken-reference)*)*\ Different "kinds" of bullets can be achieved (energy, electric, fire, high velocity, etc.) * **projectile\_trail\_effect\_0** will set an FX to the given weapon from other entities (players & NPC's) * **projectile\_trail\_attachment** the effect of this variable are unknown for now. {% hint style="info" %} Note that some weapons can have the use of. Very few of them can use it, if you don't find them already in the weapon config file, it will likely have no effect * **projectile\_trail\_effect\_1** * **projectile\_trail\_effect\_2** {% endhint %} {% tabs %} {% tab title="格式" %} ``` "projectile_trail_effect_0" "projectile_trail_effect_1" "projectile_trail_effect_2" "projectile_trail_attachment" ``` {% endtab %} {% tab title="例子" %} ``` "projectile_trail_effect_0" "weapon_kraber_projectile" "projectile_trail_effect_1" "P_titan_sniper1" "projectile_trail_effect_2" "P_titan_sniper2" "projectile_trail_attachment" "FX_GLOW" ``` {% endtab %} {% endtabs %} ### 弹药-镭射核心 The FX for lasers are known as sustained laser effects. With the weapon config file, this category is used only for Ion's laser core. It is unlikely to get those variables to work on other weapons, to achieve similar / equivalent effects on other weapons this will have to be done from weapon script files. {% embed url="" %} {% hint style="danger" %} ^ REFERENCE GIF REQUIRED HERE ^\ \&#xNAN;*using this one waiting for a better one to be made* {% endhint %} The sustained laser FX will change the aesthetics of your laser, either for the laser itself or the impact itself.\ Combination are of course possible, but not from the weapon config file. *(refer to the mentions under the main* [*FX header*](https://noskill.gitbook.io/titanfall2/chinese/information/programming/keyvalues/broken-reference)*)* * **sustained\_laser\_effect\_1p** will set an FX only from your uses of the weapon * **sustained\_laser\_effect\_3p** will set an FX to the given weapon from other entities (players & NPC's) * **sustained\_laser\_attachment** the effect of this variable are unknown for now. * **sustained\_laser\_effect\_loops** the effect of this variable are unknown for now. * **sustained\_laser\_impact\_effect** will set an FX for the laser impact. {% tabs %} {% tab title="格式" %} ``` "sustained_laser_attachment" "sustained_laser_effect_1p" "sustained_laser_effect_3p" "sustained_laser_effect_loops" "sustained_laser_impact_effect" ``` {% endtab %} {% tab title="例子" %} ``` "sustained_laser_attachment" "muzzle_flash" "sustained_laser_effect_1p" "P_wpn_lasercannon_FP" "sustained_laser_effect_3p" "P_wpn_lasercannon" "sustained_laser_effect_loops" "false" "sustained_laser_impact_effect" "P_lasercannon_endglow" ``` {% endtab %} {% endtabs %} ### 弹药-冲击效果 Those variables defines the impact animation when the bullet, laser, projectile, etc. hit a surface or an entity (player, titans, NPC's, etc.) {% embed url="" %} The variables can be added to weapons that do not have it originally. It should be noted that impact FX cannot be combined (using more than one) from the weapon config file. However this is possible with weapon script files. Reference pages will be linked from the main [FX header](https://noskill.gitbook.io/titanfall2/chinese/information/programming/keyvalues/broken-reference). You also can have different values between normal and amped modes on each weapon config files. {% tabs %} {% tab title="格式" %} ``` "impact_effect_table" ``` {% endtab %} {% tab title="例子" %} ``` "impact_effect_table" "exp_defender" ``` {% endtab %} {% endtabs %} ### 蓄能效果 {% tabs %} {% tab title="格式" %} ``` "charge_effect_1p" "charge_effect_3p" "charge_effect_attachment" "charge_effect_show_during_drain" "charge_effect2_1p" "charge_effect2_3p" "charge_effect2_attachment" ``` {% endtab %} {% tab title="例子" %} ``` "charge_effect_1p" "P_wpn_defender_charge_FP" "charge_effect_3p" "P_wpn_defender_charge" "charge_effect_attachment" "muzzle_flash" "charge_effect_show_during_drain" "0" "charge_effect2_1p" "P_wpn_lasercannon_FP" "charge_effect2_3p" "defender_charge_CH_dlight" "charge_effect2_attachment" "muzzle_flash" ``` {% endtab %} {% endtabs %} ### Ignition {% tabs %} {% tab title="格式" %} ``` "ignition_effect" "pre_ignition_impact_effect_table" "pre_ignition_trail_effect" ``` {% endtab %} {% tab title="例子" %} ``` "ignition_effect" "MissileAirBurst" "pre_ignition_impact_effect_table" "exp_smr" "pre_ignition_trail_effect" "Rocket_Smoke_SMR" ``` {% endtab %} {% endtabs %} ### 枪焰 {% embed url="" %} {% tabs %} {% tab title="格式" %} ``` "fx_muzzle_flash_attach" "fx_muzzle_flash_attach_scoped" "fx_muzzle_flash_view" "fx_muzzle_flash_world" "fx_muzzle_flash2_attach" "fx_muzzle_flash2_view" "fx_muzzle_flash2_world" ``` {% endtab %} {% tab title="例子" %} ``` "fx_muzzle_flash_attach" "muzzle_flash_suppressor_sq" "fx_muzzle_flash_attach_scoped" "muzzle_flash_scoped" "fx_muzzle_flash_view" "wpn_muzzleflash_smg_elec_FP" "fx_muzzle_flash_world" "wpn_muzzleflash_smg_elec" "fx_muzzle_flash2_attach" "muzzle_flash_l" "fx_muzzle_flash2_view" "wpn_mflash_xo_rocket_shoulder_FP" "fx_muzzle_flash2_world" "P_muzzleflash_predator" ``` {% endtab %} {% endtabs %} ### Shell {% tabs %} {% tab title="格式" %} ``` "fx_shell_eject_attach" "fx_shell_eject_attach_scoped" "fx_shell_eject_view" "fx_shell_eject_world" "fx_shell_eject2_attach" "fx_shell_eject2_view" "fx_shell_eject2_world" ``` {% endtab %} {% tab title="例子" %} ``` "fx_shell_eject_attach" "shell" "fx_shell_eject_attach_scoped" "shell_scoped" "fx_shell_eject_view" "wpn_shelleject_rifle_large_FP" "fx_shell_eject_world" "wpn_shelleject_rifle_large" "fx_shell_eject2_attach" "shell_l" "fx_shell_eject2_view" "wpn_shelleject_rifle_assault_FP" "fx_shell_eject2_world" "wpn_shelleject_rifle_assault" ``` {% endtab %} {% endtabs %} ### 涡流护盾 {% tabs %} {% tab title="格式" %} ``` "vortex_absorb_effect" "vortex_absorb_effect_third_person" "vortex_impact_effect" ``` {% endtab %} {% tab title="例子" %} ``` "vortex_absorb_effect" "wpn_vortex_projectile_SuperSpec_FP" "vortex_absorb_effect_third_person" "wpn_vortex_projectile_SuperSpec" "vortex_impact_effect" "P_impact_xo_shield_cp" ``` {% endtab %} {% endtabs %} ### ## 图标和菜单 UI elements (basically graphical elements) are indexed in this page {% content-ref url="../../../game-values/ig-icon" %} [ig-icon](https://noskill.gitbook.io/titanfall2/chinese/game-values/ig-icon) {% endcontent-ref %} #### \ Variables used to change the icon. **The expected value is a path to** [**material** ](https://noskill.gitbook.io/titanfall2/chinese/information/textures/valve-material-type-vmt)**as a string.** If your desired weapon already has an icon RUI location allocated on your screen then it becomes fairly easy to modify. This will be the case most of the time. {% hint style="info" %} Custom icons, using icons that aren't shipped with the game files is possible. A modding guide on this topic might be added in the future. If so, it will also be linked in this section of the page. {% endhint %} However if you would like to add an icon that does not have an RUI location allocated (basically a new location on your screen) you will have to code it. {% hint style="info" %} This topic is not yet covered in the wiki. This might be added in the future. If you would like to contribute, please contact us. {% endhint %} In the table down bellow you will find an index with previews (partially) of the different icons. This list is not complete, there is a lot of unused icons left in the game files. {% embed url="" %} Icons index {% endembed %} ### 准星 {% hint style="danger" %} 施工中 {% endhint %} ### HUD {% tabs %} {% tab title="格式" %} ``` "enable_hud_alert" "grenade_arc_impact_indicator_effect" TODO "grenade_arc_indicator_bounce_count" "grenade_arc_indicator_effect" TODO "grenade_arc_indicator_effect_first" TODO "grenade_arc_indicator_show_from_hip" "grenade_indicator_icon_enemy" TODO "grenade_indicator_icon_friendly" TODO "grenade_show_indicator_to_owner" "hud_grapple_indicator" "hud_icon" "smart_ammo_hud_lock_style" TODO "smart_ammo_hud_type" TODO ``` {% endtab %} {% tab title="例子" %} ``` "enable_hud_alert" "0" "grenade_arc_impact_indicator_effect" "grenade_arc_impact_proto_orange" "grenade_arc_indicator_bounce_count" "2" "grenade_arc_indicator_effect" "P_grenade_arc_proto" "grenade_arc_indicator_effect_first" "P_grenade_arc_proto_first" "grenade_arc_indicator_show_from_hip" "0" "grenade_indicator_icon_enemy" "P_wpn_grenade_frag_blue_icon" "grenade_indicator_icon_friendly" "P_wpn_grenade_frag_blue_icon" "grenade_show_indicator_to_owner" "0" "hud_grapple_indicator" "1" "hud_icon" "rui/pilot_loadout/ordnance/gravity_grenade" "smart_ammo_hud_lock_style" "pilot_launcher" "smart_ammo_hud_type" "predator_cannon" ``` {% endtab %} {% endtabs %} {% hint style="danger" %} 施工中 {% endhint %} ### 菜单 {% tabs %} {% tab title="格式" %} ``` "menu_anim_class" "menu_category" "menu_icon" "stat_accuracy" "stat_damage" "stat_range" "stat_rof" ``` {% endtab %} {% tab title="例子" %} ``` "menu_anim_class" "custom" "menu_category" "special" "menu_icon" "r2_ui/menus/loadout_icons/primary_weapon/primary_r102" "stat_accuracy" "100" "stat_damage" "68" "stat_range" "80" "stat_rof" "12" ``` {% endtab %} {% endtabs %} {% hint style="danger" %} 施工中 {% endhint %} ### 文本 {% hint style="danger" %} 施工中 {% endhint %} ## 参考资料及来源 {% hint style="info" %} * * * * * {% endhint %}