Weapon Skin

Updated for version 3.38.

This page is missing some information, such as explaining what is skin_folder and how to load the skins themselves.

Module Definition

The module is inherited from ItemModuleBase. So base parameters can be found there.

Module Name

The name of the module you use as the meta of the module definition is 'WeaponSkin' or 'WeaponSkinModule' if _force_search is set to true in the module definition.

XML Structure

<WeaponSkin id weapon_id name desc rarity skin_folder locked unique_name>
    <skin_attachments>
        <value_node value="weapon_mod_id"/>
    </skin_attachments>
</WeaponSkin>
ParameterTypeDescription

id

String

The id of your skin, which will be added in the tweak data table. It must be unique and not used by another skin

weapon_id

String

The weapon id that the skin will be attached to. For a full list check here: https://modworkshop.net/wiki.php?action=view&id=7

weapon_ids

Table

Like weapon_id but allows to set multiple weapons

name

String

The string id that the skin will use as a name

desc

String

(Optional) If used, it will show a description below the skin name in the inventory

rarity

String

The skin rarity. Can be one of the following : common, uncommon, rare, epic, legendary

locked

Boolean

(Optional) If set to true, it will act like the old legendary skins and won't allow the weapon modification if the skin is applied

unique_name

String

(Optional) If set to true, it will make the current weapon name the same as the skin name in the player's inventory. They cannot modify it afterwards

texture_bundle_folder

String

(Optional) The folder that contains the textures

skin_folder

String

...

skin_attachments

Table

The attachments that should be added to the weapon if the skin is applied

And any value that appears in the tweak_data should merge

For Idstrings you need to write them like param="@ID0d8ea9bdcebaaf64@". Sadly there's no way to write it using a raw string. Use Bundle Modder to get the hashes.

Skin Attachments

Another optional option, you can setup attachments for your skin, working the same as most of rare/epic/legendary skins in the game.

ParameterTypeDescription

weapon_mod_id

String

The weapon mod id that will be automatically added when the player use your skin

Note You must include the 'base' parts as well, otherwise, the weapon will have no body or barrel. For a list of attachments, check the tweak data tables or here: https://modworkshop.net/wiki.php?action=view&id=2 and https://modworkshop.net/wiki.php?action=view&id=3

Examples

These examples are what you would put inside your main node within your mod config

<WeaponSkin id="colt_infinite_red" weapon_id="new_raging_bull" name="bm_wskn_infinite_red" rarity="uncommon" skin_folder="InfiniteRed" />
<WeaponSkin id="colt_infinite_red" weapon_id="new_raging_bull" name="bm_wskn_infinite_red" rarity="uncommon" skin_folder="InfiniteRed">
    <skin_attachments>
        <value_node value="wpn_fps_pis_rage_g_ergo" />
        <value_node value="wpn_fps_pis_rage_b_long" />
        <value_node value="wpn_fps_pis_rage_body_smooth" />
    </skin_attachments>
</WeaponSkin>

This will add a uncommon skin named "bm_wskn_infinite_red" to the weapon "new_raging_bull".

Last updated