Skip to content

Loadout ​

Description ​

Equips new characters with server-defined kits. Administrators can make kits available to everyone or assign different equipment by SteamID, with randomized items, condition and quantities.

Configuration ​

Default configuration ​

Loadout.json
json
{
    "m_Enable": 0,
    "m_Groups": [
        {
            "m_Name": "KIT",
            "m_Steam": [
                "00000000000000000"
            ],
            "m_Kits": [
                "clothesblack;clothesgreen;clothesblue",
                "foods",
                "items",
                "weapon"
            ]
        }
    ],
    "m_Everyone": [
        "clothes",
        "foods",
        "items"
    ],
    "m_Kits": [
        {
            "m_Name": "clothes",
            "m_HealthMin": 75,
            "m_HealthMax": 100,
            "m_Items": [
                {
                    "m_Class": "TShirt_Beige;TShirt_Black;TShirt_Blue;TShirt_Green;TShirt_OrangeWhiteStripes;TShirt_Red;TShirt_RedBlackStripes;TShirt_White;TShirt_Grey",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Jeans_Black;Jeans_Blue;Jeans_Brown;Jeans_Green;Jeans_Grey;Jeans_BlueDark",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "BeanieHat_Beige;BeanieHat_Black;BeanieHat_Blue;BeanieHat_Brown;BeanieHat_Green;BeanieHat_Grey;BeanieHat_Pink;BeanieHat_Red",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "AthleticShoes_Blue;AthleticShoes_Black;AthleticShoes_Brown;AthleticShoes_Green;AthleticShoes_Grey",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                }
            ]
        },
        {
            "m_Name": "clothesblack",
            "m_HealthMin": 75,
            "m_HealthMax": 100,
            "m_Items": [
                {
                    "m_Class": "TShirt_Black",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Jeans_Black",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "BeanieHat_Black",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "AthleticShoes_Black",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                }
            ]
        },
        {
            "m_Name": "clothesgreen",
            "m_HealthMin": 75,
            "m_HealthMax": 100,
            "m_Items": [
                {
                    "m_Class": "TShirt_Green",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Jeans_Green",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "BeanieHat_Green",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "AthleticShoes_Green",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                }
            ]
        },
        {
            "m_Name": "clothesblue",
            "m_HealthMin": 75,
            "m_HealthMax": 100,
            "m_Items": [
                {
                    "m_Class": "TShirt_Blue",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Jeans_Blue",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "BeanieHat_Blue",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "AthleticShoes_Blue",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                }
            ]
        },
        {
            "m_Name": "foods",
            "m_HealthMin": 75,
            "m_HealthMax": 100,
            "m_Items": [
                {
                    "m_Class": "Apple;Pear;Plum",
                    "m_QuickBar": 4,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "SodaCan_Pipsi;SodaCan_Cola;SodaCan_Spite;SodaCan_Kvass",
                    "m_QuickBar": 0,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                }
            ]
        },
        {
            "m_Name": "items",
            "m_HealthMin": 75,
            "m_HealthMax": 100,
            "m_Items": [
                {
                    "m_Class": "KitchenKnife",
                    "m_QuickBar": 1,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Rag",
                    "m_QuickBar": 2,
                    "m_StackMin": 50,
                    "m_StackMax": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Flashlight",
                    "m_QuickBar": 3,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": [
                        {
                            "m_Class": "Battery9V",
                            "m_QuickBar": 0,
                            "m_StackMin": 50,
                            "m_StackMax": 100,
                            "m_Attachments": []
                        }
                    ]
                }
            ]
        },
        {
            "m_Name": "weapon",
            "m_HealthMin": 100,
            "m_HealthMax": 100,
            "m_Items": [
                {
                    "m_Class": "M4A1",
                    "m_QuickBar": 1,
                    "m_StackMin": 0,
                    "m_StackMax": 100,
                    "m_Attachments": [
                        {
                            "m_Class": "M4_OEBttstck;M4_MPBttstck;M4_CQBBttstck",
                            "m_QuickBar": 0,
                            "m_StackMin": 50,
                            "m_StackMax": 100,
                            "m_Attachments": []
                        },
                        {
                            "m_Class": "M4_PlasticHndgrd;M4_RISHndgrd;M4_MPHndgrd",
                            "m_QuickBar": 0,
                            "m_StackMin": 50,
                            "m_StackMax": 100,
                            "m_Attachments": []
                        },
                        {
                            "m_Class": "Mag_STANAG_30Rnd",
                            "m_QuickBar": 0,
                            "m_StackMin": 50,
                            "m_StackMax": 100,
                            "m_Attachments": []
                        },
                        {
                            "m_Class": "M4_Suppressor;ImprovisedSuppressor",
                            "m_QuickBar": 0,
                            "m_StackMin": 50,
                            "m_StackMax": 100,
                            "m_Attachments": []
                        },
                        {
                            "m_Class": "ACOGOptic_6x;M68Optic;ReflexOptic",
                            "m_QuickBar": 0,
                            "m_StackMin": 50,
                            "m_StackMax": 100,
                            "m_Attachments": []
                        }
                    ]
                },
                {
                    "m_Class": "Mag_STANAG_30Rnd",
                    "m_QuickBar": 4,
                    "m_StackMin": 50,
                    "m_StackMax": 100,
                    "m_Attachments": []
                }
            ]
        }
    ],
    "m_MoveWeaponToHands": 0
}

Options ​

OptionTypeDescription
m_EnableboolEnables the module with 1 and disables it with 0.
m_Groupsarray<object>SteamID-based kit groups. The first matching group is used.
m_Everyonearray<string>Kit names used when the player has no group kit entries. Separate alternatives within one entry with ;.
m_Kitsarray<object>Catalog of kit definitions.
m_MoveWeaponToHandsboolWith 1, moves a loadout weapon to the player's hands after equipping the kit. With 0, keeps this behavior disabled.

m_Groups[] ​

OptionTypeDescription
m_NamestringLabel for identifying the group in the file.
m_Steamarray<string>SteamIDs in the group.
m_Kitsarray<string>Kit names or alternatives separated by ; within an entry.

m_Kits[] ​

OptionTypeDescription
m_NamestringKit identifier referenced by groups or m_Everyone.
m_HealthMinintLower bound for item condition as a percent of maximum health.
m_HealthMaxintUpper bound for item condition as a percent of maximum health.
m_Itemsarray<object>Equipment entries included in the kit.

m_Kits[].m_Items[], m_Kits[].m_Items[].m_Attachments[] ​

OptionTypeDescription
m_ClassstringExact item class or alternatives separated by ;.
m_QuickBarintQuickbar slot starting at 1. Use 0 to skip assignment.
m_StackMinintMinimum quantity as a percentage of the item's capacity, when a quantity applies.
m_StackMaxintMaximum quantity as a percentage of the item's capacity, when a quantity applies.
m_Attachmentsarray<object>Item entries to attach to the parent item. Entries can contain further attachments.

Commands ​

/loadout ​

Clears the current character's entire inventory and applies the kits selected for that player. Run it only when you intend to replace the current equipment.

  • Syntax /loadout.
  • Permission command.loadout or root.
  • Example /loadout.

Permissions ​

Add command.loadout to the group's m_Permissions in Permissions to clear and reapply your own equipment through chat. The root permission also grants access.

Released under the MIT License.