Colour Override Tutorial

Colour overrides can be changed very easily, and this can be done in one of two ways. The recommended way is to use QuickEntity Editor, although a code editor or even a text editor can work as well. In either case, though, you will need to locate the entity.json file that corresponds to the option you're changing.

WHERE TO FIND THE ENTITY.JSON FILE
1. Navigate to your SMF mod folder: [YourGameLocation]\HITMAN 3\Simple Mod Framework\Mods\
2. Navigate to the mod folder for the mod you want to edit (in this case, it would be either GloveMod_AddGloves_Unlockable or NoMoreDrivingGloves)
3. For Glove Mod - Add Gloves, the folder structure is [SuitFolder]\[OptionFolder]\chunk0\Option.entity.json. For No More Driving Gloves, it's [SuitCategoryFolder]\[SuitFolder]\[OptionFolder]\chunk0\Option.entity.json. For example, if you wanted to change the colour of the black leather gloves on the Arkian Tuxedo, you would navigate to: HITMAN 3\Simple Mod Framework\Mods\GloveMod_AddGloves_Unlockable\ArkianTuxedo\ArkianTuxedo_BlackLeather\chunk0 and open the ArkianTuxedo_BlackLeather.entity.json file located there. This is where the steps diverge slightly.

EDITING THE ENTITY.JSON FILE WITH QUICKENTITY EDITOR
1. Open QuickEntity Editor
2. Click "Load" at the top, then "Load entity from file"
3. Navigate to the entity.json file you located in the previous section and select it.
4. Here you will see a tree view of all the components that make up the suit. You can either click the white arrow next to the "OUTFIT_Agent47_*****" string, then find the glove entity in this list and click on it. Or, you can search for it using the search box next to the word "Tree." If you are editing leather gloves, you can type "Gloves_Leather" into the search box and press enter. If you are editing driving gloves, you can type in "Agent47_Gloves_Driving" and press enter. In either case, you should see the glove entity highlighted in red. Click on it. In some cases, the glove entity will use a different name, such as "Mesh Gloves", but the process is the same. Find the glove entity in the tree view or via the search box, and left click on it.
5. If you look in the box on the right, you should see a "Diffuse_Color_01_Value" section. Most black leather gloves and all coloured gloves will have this section, while black driving gloves will not. If you want to edit colour overrides for driving gloves and there isn't already a coloured option to edit, I will provide the required code you can paste in at the end of this tutorial.
6A. In the Diffuse_Color_01_Value section, you'll see it says "value" followed by a hash symbol (#) and six letters/numbers. This is the hex colour code. To change the colour of the gloves, all you need to do is change this code and then save the file. For example, if you wanted to make the gloves white, you would change this value to #FFFFFF. If you wanted to make them red, you could try #FF0000.
6B. If you look at the bottom of the right box, you'll see it says "Visual editors". If you click the coloured square next to Diffuse_Color_01_Value, it will open up the visual editor, which you can use to set the colour without knowing its specific code.
7. Once you've changed the value to your preferred colour, simply click "Save entity" at the top. But please keep in mind that this will overwrite the original option you're editing, so you may want to make a backup. While it's of course possible to create an entirely new option instead, that's a bit beyond the scope of this tutorial, although you might be able to figure it out by examining the folder structure and the mod's manifest.json, or by reading the Manifest.md document included in SMF's Info folder.
8. Select the option in SMF and deploy. That's it!

EDITING THE ENTITY.JSON FILE WITH VS CODE/NOTEPAD++
1. Open VS Code/Notepad++
2. Navigate to the entity.json file you located in the previous section and select it.
3. You will see a big block of text. What you need to find is the glove entity, and from there, its Diffuse_Color_01_Value section. If you are editing leather gloves, you can search for "Gloves_Leather", and if you are editing driving gloves, you can search for "Agent47_Gloves_Driving". In either case, it should bring you to the section for the glove entity. In some cases the glove entity will use a different name, such as "Mesh Gloves", but the process is the same. Find the glove entity somewhere in the document.
4. Once you've found the glove entity, you should see a section that starts with "Diffuse_Color_01_Value". Most black leather gloves and all coloured gloves will have this section, while black driving gloves will not. If you want to edit colour overrides for driving gloves and there isn't already a coloured option to edit, I will provide the required code you can paste in at the end of this tutorial, but I would strongly recommend doing this with QuickEntity Editor instead.
5. In the Diffuse_Color_01_Value section, you'll see it says "value" followed by a hash symbol (#) and six letters/numbers. This is the hex colour code. To change the colour of the gloves, all you need to do is change this code and then save the file. For example, if you wanted to make the gloves white, you would change this value to #FFFFFF. If you wanted to make them red, you could try #FF0000.
6. Once you've changed the value to your preferred colour, simply save the JSON, overwriting the original. But as this will overwrite the original, you may want to make backup first. While it's of course possible to create an entirely new option instead, that's a bit beyond the scope of this tutorial, although you might be able to figure it out by examining the folder structure and the mod's manifest.json, or by reading the Manifest.md document included in SMF's Info folder.
7. Select the option in SMF and deploy. That's it!

THE DRIVING GLOVE SECTION TO PASTE (FOR GLOVE MOD)
Simply select the "Agent47_Gloves_Driving" entity in QNE, then replace EVERYTHING under the "parent": "....", line with the section below. Finally, change the #ffffff value in Diffuse_Color_01_Value to whatever colour you'd like, and save the file.

    "name": "Agent47_Gloves_Driving",
    "factory": "008897FB54E3DB82",
    "blueprint": "00F716010CB776C3",
    "properties": {
        "m_pMeshResource": {
            "type": "ZRuntimeResourceID",
            "value": {
                "resource": "00FBF04263964123",
                "flag": "5F"
            }
        },
        "Diffuse_Color_01_Value": {
            "type": "SColorRGB",
            "value": "#ffffff"
        },
        "Texture2D_03": {
            "type": "ZRuntimeResourceID",
            "value": {
                "resource": "[assembly:/_pro/characters/assets/hero/agent47/textures/agent47_gloves.texture?/specular_b.tex](ascolormap).pc_tex",
                "flag": "5F"
            }
        },
        "ConstantVector1D_01_Value": {
            "type": "float32",
            "value": 20
        }
    }
}

THE DRIVING GLOVE SECTION TO PASTE (FOR OTHER MODS)
If you're not using an entity.json file from Glove Mod or are creating one on your own, the "m_pMeshResource" section is not needed as that refers to a custom mesh. Instead, you can use this, changing #ffffff to whatever colour you'd prefer:

    "name": "Agent47_Gloves_Driving",
    "factory": "008897FB54E3DB82",
    "blueprint": "00F716010CB776C3",
    "properties": {
        "Diffuse_Color_01_Value": {
            "type": "SColorRGB",
            "value": "#ffffff"
        },
        "Texture2D_03": {
            "type": "ZRuntimeResourceID",
            "value": {
                "resource": "[assembly:/_pro/characters/assets/hero/agent47/textures/agent47_gloves.texture?/specular_b.tex](ascolormap).pc_tex",
                "flag": "5F"
            }
        },
        "ConstantVector1D_01_Value": {
            "type": "float32",
            "value": 20
        }
    }
}