QCGen

How to Format Your ZIP Folder

To ensure the best results, please follow these guidelines when preparing your ZIP folder:

1. Place your main model file (.smd) in the root of the ZIP folder or in a subdirectory.
2. Name your main model file "model.smd" or "[model_name].smd" (case-sensitive).
3. Put your animation files (.smd) in an "anims" folder within the ZIP.
4. Name your animation files descriptively (e.g., "idle.smd", "walk.smd", "attack.smd").
5. Include any texture files (.vtf, .vmt) in a subfolder named "textures".
6. If you have physics models, name them "physics.smd" or "physics_1.smd", "physics_2.smd", etc.
7. Optionally, include a "config.json" file in the root to specify additional parameters.

Example config.json File

You can include a config.json file in the root of your ZIP to specify additional parameters for your model. Here's an example of how to structure this file:

{
    "modelname": "example_model",
    "scale": 1.0,
    "eyeposition": [0, 0, 65],
    "surfaceprop": "flesh",
    "staticprop": true,
    "cdmaterials": ["models/example_model", "models/shared"],
    "bodygroups": [
        {
            "name": "hat",
            "models": [
                "hat_model1.smd",
                "hat_model2.smd",
                "hat_model3.smd"
            ]
        },
        {
            "name": "accessories",
            "models": [
                "glasses.smd",
                "necklace.smd"
            ]
        }
    ],
    "texturegroup": {
        "skinfamilies": [
            ["main_texture", "skin1"],
            ["alt_texture", "skin2"]
        ]
    },
    "animations": [
        {
            "name": "idle",
            "fps": 30,
            "loop": true
        },
        {
            "name": "walk",
            "fps": 60,
            "loop": true,
            "blend": {
                "delta": true,
                "type": "poseparameter",
                "range": [0, 1],
                "poseparameter": "move_x"
            }
        }
    ],
    "collisionmodel": {
        "mass": 85,
        "inertia": 10,
        "damping": 0.01,
        "rotdamping": 1.5,
        "rootbone": "pelvis"
    }
}

This config.json file allows you to specify various model parameters, animation details, and physics properties. The generator will use these values to create a more detailed and customized .qc file.